Installer VpnHood! SERVER sur Linux

Hébergez votre propre serveur VPN sur n'importe quelle machine Linux avec une IP publique. VpnHood! MANAGER peut l'installer automatiquement, ou une seule commande suffit pour un serveur autonome.

Votre serveur

VpnHood! SERVER s'exécute sur votre propre machine, comme un VPS.
Une clé d'accès

Générée par MANAGER ou le serveur. Quiconque détient la clé peut se connecter.
Vos appareils

Ajoutez simplement la clé dans VpnHood! CLIENT sur votre téléphone ou ordinateur.

Avant de commencer

Une machine avec une adresse IP publique sous Linux (x64 ou arm64). La page Configuration requise liste les systèmes sur lesquels le serveur fonctionne.
Un accès root. L'installation utilisant sudo, celui-ci doit être présent même si vous êtes connecté en root.
Le port TCP 443 ouvert, tant sur le pare-feu de la machine que chez votre hébergeur. C'est le port d'écoute du serveur.

Installer un serveur autonome

Exécutez cette commande. Elle détecte l'architecture (x64 ou arm64) et installe le serveur dans /opt/VpnHoodServer.

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

Pour une installation via script sans invites interactives, consultez Options d'installation.

Créer votre première clé d'accès

Un serveur autonome autorise uniquement les appareils munis d'une clé d'accès qu'il a lui-même générée. Exécutez cette commande sur le serveur pour en créer une.

sudo /opt/VpnHoodServer/vhserver gen

La clé s'affiche sous --- AccessKey --- et commence par vh: ; copiez toute la ligne. Quelques lignes plus haut, HostEndPoints: doit indiquer l'adresse IP publique de votre serveur.

Pour restreindre une clé, ajoutez ces options à la commande.

Option	Description
`-name Phone`	Un nom pour distinguer vos clés.
`-maxClient 5`	Nombre d'appareils pouvant utiliser la clé en même temps. Par défaut : 2.
`-maxTraffic 50000`	Limite de données en mégaoctets. Par défaut : illimité.
`-maxSpeed 20`	Débit maximal en émission et réception, en mégabits par seconde. Par défaut : illimité.
`-expire 2030/01/25`	Date d'expiration de la clé. Par défaut : permanente.

Exemple : une clé pour un seul téléphone, valide jusqu'à fin 2030

sudo /opt/VpnHoodServer/vhserver gen -name Phone -maxClient 1 -expire 2031/01/01

Toute personne disposant de la clé peut se connecter via votre serveur. Partagez-la comme un mot de passe.

Se connecter

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

Démarrer et arrêter le serveur

Le serveur s'exécute en tant que service VpnHoodServer, qu'il soit géré ou autonome.

sudo systemctl status VpnHoodServer

sudo systemctl stop VpnHoodServer

sudo systemctl start VpnHoodServer

Son journal se trouve dans /opt/VpnHoodServer/storage/logs/server.log.

Si vous l'avez installé sans le service, lancez-le vous-même avec sudo /opt/VpnHoodServer/vhserver. Il reste actif jusqu'à ce que vous l'arrêtiez avec sudo /opt/VpnHoodServer/vhserver stop depuis un autre terminal.

Mises à jour

Sauf désactivation lors de l'installation, le serveur se met à jour automatiquement à chaque nouvelle version : le service VpnHoodServerUpdater effectue une vérification toutes les 12 heures.

Pour désactiver cette option, réexécutez la commande d'installation et répondez n à Keep the server up to date by itself (Y/n)?. Vos réglages sont conservés et le serveur restera sur cette version jusqu'à votre prochaine mise à jour manuelle.

Laissez les mises à jour activées dans la mesure du possible. Certaines versions corrigent des failles de sécurité. Une application mise à jour se connecte toujours à un serveur plus ancien, mais ne reçoit pas d'UDP d'un serveur antérieur à la v9.0.859, et les applications ne prennent en charge les serveurs antérieurs à VpnHood 9.1 que jusqu'en avril 2027.

Désinstaller

Pour supprimer le serveur, lancez son script de désinstallation. Il arrête le serveur et supprime les services ainsi que les fichiers, tout en conservant vos réglages, clés d'accès et certificats dans /opt/VpnHoodServer/storage pour une éventuelle réinstallation.

sudo /opt/VpnHoodServer/vhuninstall

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

sudo /opt/VpnHoodServer/vhuninstall -purge