VpnHood! SERVER in Docker ausführen

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.
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.

Verwalteten Server installieren

Öffnen Sie in VpnHood! MANAGER Servers, wählen Sie Add, benennen Sie den Server und bestätigen Sie mit Create. Wählen Sie als Installationsmethode Install on Linux manually by running a command. Ersetzen Sie im angezeigten Befehl VpnHoodServer-linux.sh durch VpnHoodServer.docker.sh und führen Sie ihn auf dem System aus. Dadurch wird der Container mit der Anbindung an den MANAGER eingerichtet und die Abfrage der unten beschriebenen Standalone-Installation ausgeführt.

Für einen bereits erstellten Container wählen Sie stattdessen Install Manually by configuring appsettings. Speichern Sie die im MANAGER angezeigten Einstellungen als /opt/VpnHoodServer/storage/appsettings.json auf dem Host und starten Sie den Container mit sudo docker restart VpnHoodServer neu.

Erstellen Sie anschließend im MANAGER unter Access Tokens die Zugangsschlüssel für Ihre Geräte.

Eigenständigen Server installieren

Führen Sie diesen Befehl aus. Er lädt die Compose-Datei herunter, startet den Server-Container und stellt Ihnen eine kurze Frage.

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer.docker.sh)"

Antworten Sie bei der Abfrage Install Docker (y/n)? mit y, um Docker automatisch zu installieren, oder mit n, falls es bereits vorhanden ist.

Für Skripte: Automatisierte Installation ohne Abfrage. Lassen Sie -install-docker weg, falls Docker bereits eingerichtet ist.

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer.docker.sh) -install-docker -q"

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

Die Ausgabe und Optionen entsprechen denen eines eigenständigen Servers ohne Docker: Kopieren Sie die Zeile unter --- AccessKey ---. Unter Ersten Zugriffsschlüssel erstellen finden Sie Optionen zum Einschränken von Schlüsseln.

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.

Die Anleitungen IP-Adressen des Servers konfigurieren und Über eine Domain verbinden zeigen Ihnen 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.

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.