Installer VpnHood! CLIENT sur Linux

Une seule commande installe l'application, avec une fenêtre sur un environnement de bureau et un ensemble de commandes partout : elle fonctionne donc aussi sur une machine sans écran.

Avant de commencer

Une clé d'accès fournie par l'administrateur du serveur, car VpnHood! CLIENT n'a pas de serveurs propres.
Vérifiez que votre machine respecte la configuration requise pour Linux.

Installer

Exécutez cette commande et répondez à son unique question : le service VPN doit-il se lancer au démarrage ? Elle choisit la version adaptée à votre processeur.

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood/releases/latest/download/VpnHoodClient-linux.sh)"

Elle installe le service VPN et la commande vhclient. Sur une machine dotée d'un environnement de bureau, elle ajoute aussi VpnHood! CLIENT au menu des applications.

Se connecter

Sur un environnement de bureau, ouvrez VpnHood! CLIENT depuis le menu des applications, ajoutez votre clé d'accès et connectez-vous.

Depuis un terminal, ou sur une machine sans environnement de bureau, ajoutez votre clé d'accès, connectez-vous et vérifiez la connexion :

vhclient profile add 'vh:...'

vhclient connect

vhclient status

vhclient profile add accepte aussi le chemin d'un fichier contenant la clé. Si vous avez plusieurs profils, choisissez celui avec lequel vous connecter : vhclient profile set-default.

Commandes

Elles fonctionnent depuis le terminal de tout administrateur, sans sudo. vhclient --help les liste toutes, et vhclient connect --help en explique une.

Commande	Action
`vhclient connect`	Se connecte et attend le résultat. `--location` choisit l'un des emplacements listés par `vhclient locations`.
`vhclient disconnect`	Se déconnecte. Le service continue de fonctionner.
`vhclient status`	Affiche la connexion et toute mise à jour à venir. `--watch` les affiche en continu.
`vhclient locations`	Liste les emplacements de serveurs auxquels vous pouvez vous connecter.
`vhclient profile list`	Liste vos profils et indique celui qui se connecte.
`vhclient profile add`	Ajoute un profil à partir d'une clé d'accès, ou d'un fichier qui en contient une.
`vhclient profile remove`	Supprime un profil.
`vhclient profile set-default`	Choisit le profil utilisé par `vhclient connect`.
`vhclient ui`	Ouvre la fenêtre de l'application.
`vhclient service status`	Indique si le service est en cours d'exécution.
`vhclient service log`	Affiche le journal du service. `-f` le suit en continu.
`vhclient service restart`	Redémarre le service, ce qui déconnecte le VPN. La commande demande votre mot de passe.

Se connecter au démarrage

Avec l'option Toujours actif, le VPN se connecte au démarrage de l'ordinateur, avant que quiconque ne s'identifie. Tant que le serveur est injoignable, il réessaie en attendant plus longtemps à chaque fois. Il s'arrête quand vous vous déconnectez, quand une autre application VPN prend le relais ou quand le serveur refuse la connexion. Activez-la dans les paramètres de l'application, ou avec cette commande :

vhclient always-on on

Kill Switch

Le Kill Switch ne laisse rien sortir en dehors du tunnel VPN, même en cas d'erreur, de plantage ou de redémarrage. Avec until-disconnect, le blocage prend fin quand vous vous déconnectez, et avec lockdown, il reste aussi en place après une déconnexion :

vhclient kill-switch until-disconnect

Pour lever le blocage, exécutez vhclient kill-switch off. Si le service est arrêté, exécutez cette commande avec sudo.

Mises à jour

L'application se met à jour toute seule : au démarrage et toutes les 12 heures, elle recherche une version plus récente, la télécharge et l'installe pendant que le VPN est déconnecté. L'option Mises à jour automatiques, dans les paramètres de l'application, désactive ce comportement. Cette commande installe aussitôt une version plus récente, même si les mises à jour sont désactivées, et le VPN se déconnecte pendant l'installation :

vhclient update

Options d'installation

Pour un script, ou une machine sans environnement de bureau, ajoutez ces options à la commande d'installation, après sa parenthèse fermante :

Option	Action
`-q`	Ne pose aucune question. Une nouvelle installation se lance au démarrage et se met à jour automatiquement ; une mise à jour conserve vos choix.
`-noautostart`	Ne lance pas le service au démarrage.
`-noautoupdate`	Ne met pas à jour l'application automatiquement.
`-autoupdate`	Réactive la mise à jour automatique de l'application, après `-noautoupdate`.
`-nodesktop`	Installe uniquement le service et les commandes : ni entrée de menu, ni bibliothèques pour la fenêtre.
`-desktop`	Installe l'entrée de menu et les bibliothèques de la fenêtre même si aucun environnement de bureau n'est détecté.
`-help`	Liste les options.

Par exemple, sans question et sans environnement de bureau :

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood/releases/latest/download/VpnHoodClient-linux.sh) -q -nodesktop"

Désinstaller

Faites un clic droit sur VpnHood! CLIENT dans le menu des applications et choisissez « Uninstall », ou exécutez cette commande :

sudo /opt/VpnHoodClient/vhuninstall

Elle conserve vos réglages dans /opt/VpnHoodClient/storage pour une installation ultérieure. Ajoutez -purge pour les supprimer aussi.

En cas de problème

Ce que vous voyez	Que faire
`The VpnHoodClient service is not running.`	Exécutez `sudo vhclient service start`, puis consultez `vhclient service log`.
L'entrée de menu ne fait rien	Exécutez `vhclient ui` dans un terminal pour en voir la raison. Il s'agit généralement d'une bibliothèque manquante après une installation avec `-nodesktop`.
La fenêtre indique que seul un administrateur peut utiliser l'application	Ajoutez votre compte au groupe `sudo`, ou à `wheel` si le système utilise celui-ci, puis identifiez-vous à nouveau.
L'application indique qu'une autre application VPN a pris le relais	Une seule application créée avec VpnHood! peut être connectée à la fois : en connecter une autre déconnecte donc celle-ci. Elle reste déconnectée, même avec l'option Toujours actif, jusqu'à ce que vous la reconnectiez.
`Could not set the VPN's DNS servers.`	Exécutez `sudo systemctl enable --now systemd-resolved`, puis liez `/etc/resolv.conf` à `/run/systemd/resolve/stub-resolv.conf`, comme l'indique le message.
`The kill switch needs nftables (nft), which is not installed.`	Installez le paquet `nftables` ou désactivez le Kill Switch.
Connecté, mais rien ne se charge	Consultez `vhclient service log -n 100`.
`The VPN cannot use its interface name`	Un autre VPN possède une interface nommée `VpnHoodClient`, et le message indique à qui elle appartient. Arrêtez ce VPN ou, s'il a disparu en laissant l'interface derrière lui, exécutez `sudo ip link delete VpnHoodClient`.

Étapes suivantes

Choisir ce qui passe par le VPN avec le Split tunneling