Installer Localtonet depuis un paquet DEB ou RPM
Sur cette page 9 sections
- Avant de commencer
- Ce que le paquet installe
- Étapes
- Télécharger et installer le paquet
- Définir votre AuthToken
- Vérifier la configuration
- Activer un service
- Démarrer un tunnel
- Service de tunnels ou service VPN
- Fonctionnement des services
- Lire le journal
- Mise à niveau
- Désinstaller
- Dépannage
- Pages associées
Les paquets DEB et RPM installent le client Localtonet avec deux services systemd, un pour les tunnels et un pour les tunnels plus le VPN. Les services lisent votre AuthToken dans un fichier et s'exécutent sans terminal : le client démarre donc à chaque démarrage de la machine.
Avant de commencer #
- Un système Linux 64 bits : les paquets existent pour x64 et ARM64.
- systemd 247 ou plus récent et OpenSSL 3, comme Debian 12, Ubuntu 22.04+ ou RHEL 9.
- Un accès root (
sudo). - Votre AuthToken. Sélectionnez Copier sur la carte AuthToken du Tableau de bord, ou copiez un jeton depuis Mes jetons.
Sur d'autres distributions, sur ARM 32 bits, ou si vous ne voulez pas de paquet système, utilisez le script d'installation ou les archives décrits dans Linux.
Ce que le paquet installe #
| Chemin | Description |
|---|---|
/usr/bin/localtonet | La commande localtonet. |
/usr/lib/localtonet/ | Le client lui-même. |
/usr/lib/systemd/system/localtonet.service | Le service de tunnels. |
/usr/lib/systemd/system/localtonet-vpn.service | Le service VPN et de tunnels. |
/etc/localtonet/auth-token | Le fichier du jeton. Seul root peut le lire. Il est installé avec l'espace réservé DUMMY_AUTH_TOKEN. |
Le paquet s'appelle localtonet. Ses dépendances, notamment OpenSSL 3, iproute2 (iproute dans le RPM), iptables et kmod, sont installées par votre gestionnaire de paquets. L'installation du paquet n'active ni ne démarre aucun service : vous définissez d'abord le jeton, puis vous activez le service dont vous avez besoin.
Étapes #
-
Télécharger et installer le paquet #
Choisissez le paquet correspondant à votre distribution et à votre processeur dans la liste en fin de page, puis installez le fichier téléchargé avec
apt(DEB) oudnf(RPM). Instructions d'installation sous chaque paquet affiche les commandes exactes pour ce fichier. -
Définir votre AuthToken #
Modifiez
/etc/localtonet/auth-tokenen tant que root avec un éditeur de texte et remplacezDUMMY_AUTH_TOKENpar votre jeton, sur une seule ligne. Assurez-vous ensuite que seul root peut lire le fichier :Terminalsudo chmod 600 /etc/localtonet/auth-token -
Vérifier la configuration #
Terminalsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configLa vérification lit le fichier du jeton sans se connecter. Elle répond
Localtonet headless configuration OK.lorsque le fichier contient un jeton de 33 caractères sans espaces. Elle ne demande pas aux serveurs Localtonet si le jeton est valide pour votre compte. -
Activer un service #
Pour les tunnels, activez le service de tunnels et lisez son journal :
Terminalsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSi cet appareil rejoint aussi un réseau VPN, activez plutôt le service VPN. Voir Service de tunnels ou service VPN.
-
Démarrer un tunnel #
Le jeton apparaît maintenant En ligne dans Mes jetons. Créez et démarrez un tunnel pour lui dans le tableau de bord, voir Démarrage rapide.
Service de tunnels ou service VPN #
Les deux services exécutent le même client et servent tous deux vos tunnels. Ils diffèrent par les droits avec lesquels ils s'exécutent. Activez-en un seul : les deux services sont en conflit, et le démarrage de l'un arrête l'autre.
localtonet.service | localtonet-vpn.service | |
|---|---|---|
| À utiliser pour | Tunnels | VPN et tunnels |
| S'exécute en tant que | Un utilisateur sans privilèges que systemd crée pour le service | root, limité aux capacités réseau CAP_NET_ADMIN et CAP_NET_RAW |
| Module TUN | Non utilisé | Chargé avec modprobe tun avant le démarrage du client |
| Répertoire de travail | /var/lib/localtonet | /var/lib/localtonet-vpn |
Pour faire passer un appareil du service de tunnels au service VPN :
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.servicePour revenir en arrière, désactivez localtonet-vpn.service et activez localtonet.service de la même façon. Les réseaux VPN eux-mêmes se configurent dans le tableau de bord, voir Gestionnaire VPN.
Fonctionnement des services #
| Comportement | Détails |
|---|---|
| Mode headless | Les deux services lancent localtonet --headless. Dans ce mode, le client ne pose jamais de question et ne stocke pas le jeton dans ses propres paramètres. |
| Jeton | systemd transmet /etc/localtonet/auth-token au service. Un service ne démarre pas tant que le fichier est absent. |
| Démarrage au boot | Un service activé démarre une fois le réseau disponible. |
| Redémarrage | systemd redémarre le client dix secondes après un échec. Il ne le redémarre pas lorsque le client s'arrête à cause d'un fichier de jeton invalide. Corrigez le fichier et redémarrez vous-même le service. |
Lire le journal #
En mode headless, le client écrit des lignes simples dans le journal, une par changement :
sudo journalctl -u localtonet.service -f| Ligne | Signification |
|---|---|
Connection: Connected | L'état de la session. Les autres valeurs sont Connecting et Disconnected. |
AuthTokenName: … | Le nom du jeton avec lequel le client s'est connecté. |
OPEN …, ADDED … | Un tunnel qui s'exécute sur cet appareil, avec son adresse publique, son protocole et sa cible locale. |
STATUS … | Un tunnel a changé d'état. |
CLOSED … | Un tunnel a été arrêté ou supprimé. |
Authentication failed: AuthToken was rejected. | Le jeton du fichier n'est pas accepté. Copiez-le de nouveau depuis Mes jetons. |
Si l'une de ces lignes devait contenir le jeton, le client écrit [redacted] à sa place.
Mise à niveau #
Téléchargez le nouveau paquet et installez-le de la même façon que la première fois, puis redémarrez le service que vous utilisez. Votre fichier de jeton est conservé.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceDans Mes jetons, la colonne Client affiche la version signalée en dernier par l'appareil et un badge Mise à jour requise lorsqu'une version plus récente est disponible.
Désinstaller #
sudo apt remove localtonetsudo dnf remove localtonetLa désinstallation du paquet arrête et désactive les deux services. Le fichier du jeton est un fichier de configuration, et les gestionnaires de paquets les traitent avec précaution : après la désinstallation, vérifiez si /etc/localtonet/auth-token ou une copie sauvegardée s'y trouve encore, et supprimez-le si vous ne voulez pas que le jeton reste sur la machine.
Dépannage #
Invalid Localtonet headless configuration. Check the token file or environment settings.
Le fichier du jeton est inutilisable. Vérifiez que /etc/localtonet/auth-token existe, que l'espace réservé DUMMY_AUTH_TOKEN a disparu, et que le fichier ne contient que le jeton de 33 caractères, sans espaces et sur une seule ligne. Lancez la vérification avec sudo, car seul root peut lire le fichier.
Le service est activé mais ne s'exécute pas
Exécutez systemctl status localtonet.service. Un service ne démarre pas tant que /etc/localtonet/auth-token est absent, et il n'est pas redémarré après s'être arrêté à cause d'un fichier de jeton invalide. Corrigez le fichier, lancez la vérification de la configuration, puis exécutez sudo systemctl restart localtonet.service.
Le journal indique : Authentication failed: AuthToken was rejected.
Le fichier a le bon format mais le jeton n'est pas accepté. Copiez de nouveau le jeton depuis Mes jetons, enregistrez-le dans le fichier du jeton et redémarrez le service.
Le service de tunnels s'est arrêté quand j'ai démarré le service VPN
C'est voulu. Les deux services sont en conflit : systemd en arrête donc un lorsque l'autre démarre. Le service VPN sert aussi vos tunnels.
Le paquet ne s'installe pas sur ma distribution
Les paquets nécessitent systemd 247 ou plus récent et OpenSSL 3. Sur des versions plus anciennes, le gestionnaire de paquets ne peut pas satisfaire ces dépendances. Utilisez plutôt le script d'installation ou une archive de la page Linux.
Pages associées #
Les paquets sont listés ci-dessous. Sélectionnez Instructions d'installation sous un paquet pour obtenir les commandes avec son nom de fichier.
Paquets Linux
Paquets DEB et RPM installables pour x64 et ARM64. Nécessite systemd 247 ou plus récent et OpenSSL 3, par exemple Debian 12, Ubuntu 22.04+ ou RHEL 9.
-
Debian / Ubuntu · x64
Instructions d'installation
1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant
localtonet-linux-x64.deb.sudo apt install ./localtonet-linux-x64.deb2. Définissez votre AuthToken. Modifiez
/etc/localtonet/auth-tokenen tant que root et remplacezDUMMY_AUTH_TOKENpar votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Démarrez le service. Une fois la vérification de la configuration réussie :
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePour le VPN, passez au service VPN :
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePour mettre à jour, installez le nouveau paquet et exécutez
sudo systemctl restart localtonet. Votre configuration est conservée.Si vous utilisez le VPN, redémarrez plutôt
localtonet-vpn.service. -
Debian / Ubuntu · ARM64
Instructions d'installation
1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant
localtonet-linux-arm64.deb.sudo apt install ./localtonet-linux-arm64.deb2. Définissez votre AuthToken. Modifiez
/etc/localtonet/auth-tokenen tant que root et remplacezDUMMY_AUTH_TOKENpar votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Démarrez le service. Une fois la vérification de la configuration réussie :
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePour le VPN, passez au service VPN :
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePour mettre à jour, installez le nouveau paquet et exécutez
sudo systemctl restart localtonet. Votre configuration est conservée.Si vous utilisez le VPN, redémarrez plutôt
localtonet-vpn.service. -
Fedora / RHEL · x64
Instructions d'installation
1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant
localtonet-linux-x64.rpm.sudo dnf install ./localtonet-linux-x64.rpm2. Définissez votre AuthToken. Modifiez
/etc/localtonet/auth-tokenen tant que root et remplacezDUMMY_AUTH_TOKENpar votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Démarrez le service. Une fois la vérification de la configuration réussie :
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePour le VPN, passez au service VPN :
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePour mettre à jour, installez le nouveau paquet et exécutez
sudo systemctl restart localtonet. Votre configuration est conservée.Si vous utilisez le VPN, redémarrez plutôt
localtonet-vpn.service. -
Fedora / RHEL · ARM64
Instructions d'installation
1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant
localtonet-linux-arm64.rpm.sudo dnf install ./localtonet-linux-arm64.rpm2. Définissez votre AuthToken. Modifiez
/etc/localtonet/auth-tokenen tant que root et remplacezDUMMY_AUTH_TOKENpar votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :sudo chmod 600 /etc/localtonet/auth-token sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Démarrez le service. Une fois la vérification de la configuration réussie :
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePour le VPN, passez au service VPN :
sudo modprobe tun sudo systemctl disable --now localtonet.service sudo systemctl enable --now localtonet-vpn.service sudo journalctl -u localtonet-vpn.servicePour mettre à jour, installez le nouveau paquet et exécutez
sudo systemctl restart localtonet. Votre configuration est conservée.Si vous utilisez le VPN, redémarrez plutôt
localtonet-vpn.service.