Installer VpnHood! SERVER avec Docker

Lancez le serveur sous forme de conteneur sur n'importe quelle machine Linux avec Docker. Une seule commande suffit pour l'installer, en mode géré ou autonome. Le conteneur assure son bon fonctionnement et le maintient à jour.

Avant de commencer

Une machine Linux avec une adresse IP publique, en x64 ou arm64. L'image est compatible avec les deux architectures. La page Configuration requise liste les systèmes sur lesquels le serveur fonctionne.
Un accès root.
Docker avec son plugin compose. Le programme d'installation peut s'en charger pour vous sur Ubuntu, Debian et leurs dérivés.
Le port TCP 443 ouvert, tant sur le pare-feu de la machine que chez votre hébergeur. Le conteneur partage le réseau de l'hôte, le serveur écoute donc directement sur le port de l'hôte.

Installer un serveur autonome

Exécutez cette commande. Elle vous proposera d'installer Docker si nécessaire, téléchargera le fichier compose et démarrera le conteneur du serveur.

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

Pour une installation automatisée par script (sans invite), consultez Options d'installation.

Le serveur conserve ses paramètres, ses clés et ses journaux dans /opt/VpnHoodServer/storage sur l'hôte, afin de ne rien perdre lors de la réinitialisation du conteneur.

Créer une clé d'accès

Exécutez ceci sur la machine. La clé est générée à l'intérieur du conteneur du serveur pour appliquer directement ses paramètres.

sudo docker exec VpnHoodServer /app/vhsupervisor gen

Exemple : une clé pour un seul téléphone

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

Le résultat et les options sont identiques à ceux d'un serveur autonome installé sans Docker : copiez la ligne sous --- AccessKey ---, et consultez Créer votre première clé d'accès pour découvrir les options permettant de restreindre une clé.

Connexion

Installez VpnHood! CLIENT sur chaque appareil, ajoutez la clé et connectez-vous.

Démarrer, arrêter et vérifier le serveur

Le conteneur se nomme VpnHoodServer. Docker le redémarre automatiquement après chaque redémarrage de la machine, et le serveur est également relancé à l'intérieur s'il s'arrête de manière inattendue.

sudo docker logs VpnHoodServer

sudo docker stop VpnHoodServer

sudo docker start VpnHoodServer

Le même journal est écrit dans /opt/VpnHoodServer/storage/logs/server.log sur l'hôte.

Modifier les paramètres

Le serveur lit sa configuration depuis /opt/VpnHoodServer/storage/appsettings.json. Modifiez ce fichier, puis redémarrez le conteneur à l'aide de sudo docker restart VpnHoodServer.

S'il vous est impossible de modifier un fichier, définissez plutôt tout le contenu d'un appsettings.json dans la variable d'environnement VH_APPSETTINGS. Le serveur l'utilisera alors à la place du fichier.

Consultez Définir les adresses IP de votre serveur et Utiliser un nom de domaine et un certificat de confiance pour découvrir les paramètres les plus courants.

Mises à jour

Le serveur se met à jour automatiquement dans le conteneur. Il vérifie la disponibilité d'une nouvelle version au démarrage ainsi que toutes les 12 heures, puis redémarre avec la mise à jour.

Pour conserver une version précise, définissez VH_AUTO_UPDATE=0 dans l'environnement du conteneur.

Certaines versions nécessitent parfois une image plus récente. Le serveur reste alors sur sa version actuelle et son journal indique Pull the latest image!. Relancez la commande d'installation : elle téléchargera la dernière image et recréera le conteneur, en conservant vos paramètres et vos clés.

Si vous aviez fait l'installation avec une ancienne version du script, relancez simplement la commande d'installation. Le serveur passera sur la nouvelle image et l'ancien conteneur VpnHoodUpdater sera supprimé.

Désinstaller

Pour désinstaller le serveur, supprimez son conteneur et son image. Ses paramètres, clés d'accès et certificats restent conservés dans /opt/VpnHoodServer/storage sur l'hôte en vue d'une réinstallation.

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

Supprimer aussi la configuration et les clés : les appareils utilisant ces clés ne pourront plus se connecter, même après une nouvelle installation

sudo rm -rf /opt/VpnHoodServer

Créer le conteneur manuellement

Si vous gérez vos conteneurs vous-même, voici celui généré par l'installateur. Lancez-le sur le réseau de l'hôte, tout comme le fait l'outil d'installation.

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

Pour migrer vers une image plus récente, téléchargez vpnhood/vpnhoodserver avec pull et recréez le conteneur.