Aller au contenu
Localtonet Localtonet Tableau de bord

Installer Localtonet depuis un paquet DEB ou RPM

Aide pour cette page
Sur cette page 9 sections
  1. Avant de commencer
  2. Ce que le paquet installe
  3. Étapes
  4. Télécharger et installer le paquet
  5. Définir votre AuthToken
  6. Vérifier la configuration
  7. Activer un service
  8. Démarrer un tunnel
  9. Service de tunnels ou service VPN
  10. Fonctionnement des services
  11. Lire le journal
  12. Mise à niveau
  13. Désinstaller
  14. Dépannage
  15. 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 #

CheminDescription
/usr/bin/localtonetLa commande localtonet.
/usr/lib/localtonet/Le client lui-même.
/usr/lib/systemd/system/localtonet.serviceLe service de tunnels.
/usr/lib/systemd/system/localtonet-vpn.serviceLe service VPN et de tunnels.
/etc/localtonet/auth-tokenLe 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 #

  1. 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) ou dnf (RPM). Instructions d'installation sous chaque paquet affiche les commandes exactes pour ce fichier.

  2. Définir votre AuthToken #

    Modifiez /etc/localtonet/auth-token en tant que root avec un éditeur de texte et remplacez DUMMY_AUTH_TOKEN par votre jeton, sur une seule ligne. Assurez-vous ensuite que seul root peut lire le fichier :

    Terminal
    sudo chmod 600 /etc/localtonet/auth-token
  3. Vérifier la configuration #

    Terminal
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    La 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.

  4. Activer un service #

    Pour les tunnels, activez le service de tunnels et lisez son journal :

    Terminal
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Si cet appareil rejoint aussi un réseau VPN, activez plutôt le service VPN. Voir Service de tunnels ou service VPN.

  5. 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.servicelocaltonet-vpn.service
À utiliser pourTunnelsVPN et tunnels
S'exécute en tant queUn utilisateur sans privilèges que systemd crée pour le serviceroot, limité aux capacités réseau CAP_NET_ADMIN et CAP_NET_RAW
Module TUNNon 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 :

Terminal
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

Pour 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 #

ComportementDétails
Mode headlessLes 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.
Jetonsystemd transmet /etc/localtonet/auth-token au service. Un service ne démarre pas tant que le fichier est absent.
Démarrage au bootUn service activé démarre une fois le réseau disponible.
Redémarragesystemd 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 :

Terminal
sudo journalctl -u localtonet.service -f
LigneSignification
Connection: ConnectedL'é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é.

Service de tunnels
sudo systemctl restart localtonet
Service VPN
sudo systemctl restart localtonet-vpn.service

Dans 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 #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

La 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.

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.deb

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par 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-config

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Pour 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.service

    Pour 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.deb

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par 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-config

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Pour 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.service

    Pour 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.rpm

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par 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-config

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Pour 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.service

    Pour 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.rpm

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par 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-config

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Pour 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.service

    Pour 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.

Support