VpnHood! SERVER mit Docker installieren

Führen Sie den Server als Container auf jedem Linux-System mit Docker aus. Ein einziger Befehl genügt zur Installation – ob verwaltet oder eigenständig. Der Container sorgt für einen stabilen Betrieb und automatische Updates.

Voraussetzungen

Ein Linux-System mit öffentlicher IP-Adresse (x64 oder arm64). Das Image unterstützt beide Architekturen. Die Systemanforderungen nennen die Systeme, auf denen der Server läuft.
Root-Zugriff.
Docker inklusive Compose-Plugin. Unter Ubuntu, Debian und darauf basierenden Distributionen kann das Installationsprogramm Docker automatisch einrichten.
Freigegebener TCP-Port 443 – sowohl in der Firewall des Systems als auch bei Ihrem Hosting-Anbieter. Der Container nutzt das Host-Netzwerk direkt, sodass der Server unmittelbar an diesem Port lauscht.

Eigenständigen Server installieren

Diesen Befehl ausführen. Er fragt nach der Docker-Installation, lädt die Compose-Datei herunter und startet den Server-Container.

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)'

Für eine automatisierte Installation per Skript (ohne Rückfragen) siehe Installer-Optionen.

Der Server speichert Einstellungen, Schlüssel und Protokolle unter /opt/VpnHoodServer/storage auf dem Host – so bleiben alle Daten auch bei Container-Updates erhalten.

Zugangsschlüssel erstellen

Führen Sie diesen Befehl auf dem System aus. Der Schlüssel wird direkt im Server-Container erzeugt und übernimmt automatisch dessen Einstellungen.

sudo docker exec VpnHoodServer /app/vhsupervisor gen

Beispiel: ein Schlüssel für ein Smartphone

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

Ausgabe und Optionen sind dieselben wie bei einem eigenständigen Server, der ohne Docker installiert wurde: Kopieren Sie die Zeile unter --- AccessKey ---. Die Optionen, mit denen Sie einen Schlüssel einschränken, finden Sie unter Ersten Zugangsschlüssel erstellen.

Verbinden

Installieren Sie VpnHood! CLIENT auf jedem Gerät, fügen Sie den Schlüssel hinzu und verbinden Sie sich.

Server starten, stoppen und prüfen

Der Container heißt VpnHoodServer. Docker startet ihn bei einem Systemneustart automatisch neu, und der Server im Container startet nach einem Absturz von selbst neu.

sudo docker logs VpnHoodServer

sudo docker stop VpnHoodServer

sudo docker start VpnHoodServer

Derselbe Log wird auf dem Host unter /opt/VpnHoodServer/storage/logs/server.log gespeichert.

Einstellungen anpassen

Der Server liest seine Einstellungen aus /opt/VpnHoodServer/storage/appsettings.json. Bearbeiten Sie die Datei und starten Sie den Container anschließend mit sudo docker restart VpnHoodServer neu.

Falls Sie keine Dateien bearbeiten können, tragen Sie den gesamten Inhalt einer appsettings.json stattdessen in die Umgebungsvariable VH_APPSETTINGS ein. Der Server nutzt dann diese anstelle der Datei.

IP-Adressen Ihres Servers festlegen und Domainnamen und vertrauenswürdiges Zertifikat nutzen führen durch die wichtigsten Einstellungen.

Updates

Der Server aktualisiert sich im Container automatisch. Er prüft beim Start sowie alle 12 Stunden auf neue Versionen und führt bei Bedarf einen Neustart durch.

Um eine bestimmte Version beizubehalten, setzen Sie VH_AUTO_UPDATE=0 in den Umgebungsvariablen des Containers.

Gelegentlich erfordert ein Update ein neueres Image. Der Server behält dann seine aktuelle Version bei und meldet im Log Pull the latest image!. Führen Sie den Installationsbefehl einfach erneut aus: Er lädt das neueste Image herunter und erstellt den Container mit denselben Einstellungen und Schlüsseln neu.

Falls die Installation mit einer älteren Skriptversion durchgeführt wurde, führen Sie den Installationsbefehl erneut aus. Er aktualisiert den Server auf das neue Image und entfernt den alten Container VpnHoodUpdater.

Deinstallieren

Um den Server zu entfernen, löschen Sie seinen Container und sein Image. Seine Einstellungen, Zugangsschlüssel und Zertifikate bleiben für eine spätere Installation in /opt/VpnHoodServer/storage auf dem Host erhalten.

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

Auch Einstellungen und Schlüssel löschen: Geräte mit diesen Schlüsseln können sich nicht mehr verbinden, auch nicht nach einer Neuinstallation

sudo rm -rf /opt/VpnHoodServer

Container manuell erstellen

Wenn Sie Container manuell verwalten, entspricht dies der Konfiguration des Installers. Führen Sie den Container wie der Installer im Host-Netzwerk aus.

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

Um auf ein neueres Image zu aktualisieren, laden Sie vpnhood/vpnhoodserver herunter und erstellen Sie den Container neu.