Installa VpnHood! SERVER con Docker

Avvia il server come container su qualsiasi macchina Linux con Docker. Un solo comando per installarlo, gestito o standalone; il container mantiene il server attivo e sempre aggiornato.

Prima di iniziare

Una macchina Linux con indirizzo IP pubblico, con architettura x64 o arm64. L'immagine supporta entrambe. Requisiti di sistema elenca i sistemi su cui funziona il server.
Accesso root.
Docker con il relativo plugin compose. Il programma di installazione può configurarlo automaticamente su Ubuntu, Debian e distribuzioni derivate.
Porta TCP 443 aperta, sia nel firewall della macchina sia in quello dell'hosting provider. Il container condivide la rete dell'host, quindi il server rimane in ascolto direttamente sulla porta dell'host.

Installa un server standalone

Esegui questo comando. Ti chiederà se installare Docker, quindi scaricherà il file compose e avvierà il container del server.

sudo bash -c 'u=https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer.docker.sh; bash <(wget -qO- $u 2>/dev/null || curl -fsSL $u)'

Per un'installazione tramite script senza richieste interattive, consulta le Opzioni del programma di installazione.

Il server memorizza impostazioni, chiavi e log in /opt/VpnHoodServer/storage sull'host, preservandoli anche in caso di rimozione o aggiornamento del container.

Crea una chiave di accesso

Esegui questo comando sulla macchina. La chiave viene generata all'interno del container del server, applicandone direttamente le impostazioni.

sudo docker exec VpnHoodServer /app/vhsupervisor gen

Ad esempio, una chiave per un unico telefono

sudo docker exec VpnHoodServer /app/vhsupervisor gen -name Phone -maxClient 1

L'output e le opzioni sono gli stessi di un server standalone installato senza Docker: copia la riga sotto --- AccessKey --- e consulta Crea la tua prima chiave di accesso per le opzioni che limitano una chiave.

Connettiti

Installa VpnHood! CLIENT su ogni dispositivo, inserisci la chiave e connettiti.

Avvia, arresta e controlla il server

Il container si chiama VpnHoodServer. Docker lo riavvia al riavvio della macchina e, al suo interno, il server viene riavviato automaticamente in caso di arresto anomalo.

sudo docker logs VpnHoodServer

sudo docker stop VpnHoodServer

sudo docker start VpnHoodServer

Lo stesso log viene salvato in /opt/VpnHoodServer/storage/logs/server.log sull'host.

Modifica le impostazioni

Il server legge la propria configurazione da /opt/VpnHoodServer/storage/appsettings.json. Modifica il file, quindi riavvia il container con sudo docker restart VpnHoodServer.

Se non puoi modificare un file, inserisci l'intero contenuto di appsettings.json nella variabile d'ambiente VH_APPSETTINGS. Il server la userà al posto del file.

Scopri le impostazioni più utilizzate nelle guide Imposta gli indirizzi IP del tuo server e Usa un nome di dominio e un certificato attendibile.

Aggiornamenti

Il server si aggiorna automaticamente all'interno del container. Verifica la presenza di nuove versioni all'avvio e ogni 12 ore, riavviandosi con la versione aggiornata.

Per mantenere una versione specifica, imposta VH_AUTO_UPDATE=0 nell'ambiente del container.

Talvolta una nuova versione richiede un'immagine aggiornata. In questo caso il server mantiene la versione corrente e registra nel log Pull the latest image!. Esegui nuovamente il comando di installazione per scaricare l'immagine più recente e ricreare il container, preservando impostazioni e chiavi.

Se hai eseguito l'installazione con una versione precedente dello script, esegui nuovamente il comando di installazione. Il server passerà alla nuova immagine e il vecchio container VpnHoodUpdater verrà rimosso.

Disinstalla

Per rimuovere il server, elimina il suo container e l'immagine. Impostazioni, chiavi di accesso e certificati rimarranno salvati in /opt/VpnHoodServer/storage sull'host per un'eventuale reinstallazione.

sudo docker rm -f VpnHoodServer && sudo docker rmi vpnhood/vpnhoodserver

Elimina anche impostazioni e chiavi: i dispositivi associati non potranno più connettersi, nemmeno dopo una nuova installazione

sudo rm -rf /opt/VpnHoodServer

Crea il container manualmente

Se gestisci i container manualmente, questo è quello generato dal programma di installazione. Eseguilo sulla rete dell'host, esattamente come fa l'installer.

sudo docker run -d --name VpnHoodServer --network host --restart always --stop-timeout 30 -v /opt/VpnHoodServer/storage:/app/storage vpnhood/vpnhoodserver

Per passare a un'immagine più recente, scarica vpnhood/vpnhoodserver e ricrea il container.