Installer VpnHood! CONNECT sur Linux

Une seule commande installe l'application, avec sa fenêtre et un ensemble de commandes. Identifiez-vous une fois depuis la fenêtre, puis connectez-vous au choix depuis la fenêtre ou les commandes.

Avant de commencer

Une offre Premium, car la version Linux ne propose aucun serveur gratuit : passer au Premium.
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.App.Connect/releases/latest/download/VpnHoodConnect-linux.sh)"

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

Se connecter

Ouvrez VpnHood! CONNECT depuis le menu des applications, identifiez-vous avec votre compte Premium et connectez-vous.

Une fois identifié, vous pouvez aussi vous connecter depuis un terminal et vérifier la connexion :

vhconnect connect

vhconnect status

L'identification passe par la fenêtre de l'application : une machine sans environnement de bureau ne peut donc pas encore utiliser VpnHood! CONNECT. Vous pouvez y utiliser VpnHood! CLIENT avec votre propre serveur.

Commandes

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

Commande	Action
`vhconnect connect`	Se connecte et attend le résultat. `--location` choisit l'un des emplacements listés par `vhconnect locations`.
`vhconnect disconnect`	Se déconnecte. Le service continue de fonctionner.
`vhconnect status`	Affiche la connexion et toute mise à jour à venir. `--watch` les affiche en continu.
`vhconnect locations`	Liste les emplacements de serveurs auxquels vous pouvez vous connecter.
`vhconnect ui`	Ouvre la fenêtre de l'application.
`vhconnect service status`	Indique si le service est en cours d'exécution.
`vhconnect service log`	Affiche le journal du service. `-f` le suit en continu.
`vhconnect 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 :

vhconnect always-on on

L'option Toujours actif nécessite Premium.

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 :

vhconnect kill-switch until-disconnect

Pour lever le blocage, exécutez vhconnect 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 :

vhconnect 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.App.Connect/releases/latest/download/VpnHoodConnect-linux.sh) -q -nodesktop"

Désinstaller

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

sudo /opt/VpnHoodConnect/vhuninstall

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

En cas de problème

Ce que vous voyez	Que faire
`The VpnHoodConnect service is not running.`	Exécutez `sudo vhconnect service start`, puis consultez `vhconnect service log`.
L'entrée de menu ne fait rien	Exécutez `vhconnect 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 `vhconnect service log -n 100`.
`The VPN cannot use its interface name`	Un autre VPN possède une interface nommée `VpnHoodConnect`, 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 VpnHoodConnect`.

Étapes suivantes

Choisir ce qui passe par le VPN avec le Split tunneling