Aller au contenu
Localtonet Localtonet Tableau de bord

Installer Localtonet sur Linux

Aide pour cette page
Sur cette page 9 sections
  1. Avant de commencer
  2. Installer avec le script
  3. Exécuter le script d'installation
  4. Vérifier l'installation
  5. Installer manuellement
  6. Télécharger et extraire
  7. Facultatif : le placer dans votre PATH
  8. Démarrer le client
  9. Le démarrer avec votre jeton
  10. Vérifier la session
  11. Exécuter comme service systemd
  12. Installer le service
  13. Vérifier qu'il s'exécute
  14. Commandes de service
  15. L'unité et ses journaux
  16. Mettre à niveau
  17. Remplacer le client
  18. Redémarrer le service
  19. Désinstaller
  20. Dépannage
  21. Pages associées

Sous Linux, le client Localtonet est un programme console unique. Installez-le avec le script d'installation ou à partir d'une archive ZIP, lancez-le avec votre AuthToken et installez-le comme service systemd s'il doit démarrer après chaque redémarrage.

Avant de commencer #

  • Un compte Localtonet. Créez-en un gratuitement si vous n'en avez pas.
  • Votre AuthToken. Sélectionnez Copier sur la carte AuthToken du Tableau de bord, ou copiez un jeton depuis Mes jetons.
  • curl ou wget, et unzip.
  • Pour le service systemd : un accès root et une distribution qui utilise systemd.

Autres façons d'exécuter Localtonet sous Linux. Sous Debian, Ubuntu, Fedora et RHEL, vous pouvez installer un paquet DEB ou RPM qui apporte ses propres services. Il existe des guides distincts pour Docker, les routeurs OpenWrt et Termux sur Android.

Installer avec le script #

  1. Exécuter le script d'installation #

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh

    Le script détecte votre processeur (x64, ARM64 ou ARM) et si le système utilise glibc ou musl, télécharge la version correspondante et l'installe dans /usr/local/bin/localtonet. Il crée aussi le lien /usr/bin/localtonet, afin que sudo localtonet fonctionne sur les distributions où sudo ne cherche pas dans /usr/local/bin.

    Le script utilise sudo lorsque votre utilisateur ne peut pas écrire dans le dossier d'installation, ce qui explique qu'il puisse demander votre mot de passe. Si unzip est absent, il tente de l'installer avec le gestionnaire de paquets de votre distribution.

  2. Vérifier l'installation #

    Le script se termine en affichant la version installée. Vous pouvez l'afficher de nouveau à tout moment :

    Terminal
    localtonet --version

Installer manuellement #

Si vous préférez un téléchargement direct, prenez l'archive correspondant à votre système. Chaque ZIP contient un seul fichier, localtonet.

Processeurglibc (Debian, Ubuntu, Fedora, RHEL et la plupart des autres)musl (Alpine)
x64localtonet-linux-x64.ziplocaltonet-linux-musl-x64.zip
ARM64localtonet-linux-arm64.ziplocaltonet-linux-musl-arm64.zip
ARM (32 bits)localtonet-linux-arm.ziplocaltonet-linux-musl-arm.zip

uname -m affiche le type de votre processeur : x86_64 correspond à x64, aarch64 à ARM64 et armv7l à ARM.

  1. Télécharger et extraire #

    L'exemple utilise la version x64 glibc. Remplacez le nom de fichier par l'archive correspondant à votre système.

    Terminal
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. Facultatif : le placer dans votre PATH #

    Sans cette étape, vous lancez le client avec son chemin, ~/localtonet/localtonet. Ensuite, vous pouvez saisir localtonet dans n'importe quel dossier.

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Démarrer le client #

  1. Le démarrer avec votre jeton #

    Terminal
    localtonet --authtoken <YOUR_TOKEN>

    Le client enregistre le jeton localement pour votre utilisateur. La prochaine fois, vous pouvez le lancer avec localtonet seul. Si vous le lancez sans jeton enregistré, il demande Please Enter AuthToken or PIN.

  2. Vérifier la session #

    Le terminal affiche Session Status: Connected au-dessus d'un tableau comportant une ligne par tunnel en cours d'exécution : IP/Url, Protocol, Client IP, Client Port, Ping et Status. Le tableau est vide tant que vous ne démarrez pas de tunnel dans le tableau de bord, consultez le Démarrage rapide.

    Appuyez sur Ctrl + C pour arrêter le client. Appuyez sur F12 pour supprimer le jeton enregistré et quitter.

Lorsque la sortie n'est pas un terminal, par exemple lorsque vous la redirigez vers un fichier, le client écrit une simple ligne par changement au lieu du tableau.

Le VPN nécessite root. Si l'appareil fait partie d'un réseau du Gestionnaire VPN et que le client s'exécute sans root, la ligne VPN du tableau affiche Admin rights required. Dans ce cas, lancez le client avec sudo ou comme service.

Exécuter comme service systemd #

Un service lance Localtonet après chaque redémarrage, le maintient en cours d'exécution après votre déconnexion et ne nécessite pas de terminal ouvert. Les commandes de service nécessitent root.

  1. Installer le service #

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    La commande écrit une unité systemd pour ce jeton, l'active et la démarre immédiatement. Elle répond avec le nom de l'unité :

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> correspond aux 9 premiers caractères de votre jeton. Chaque jeton a sa propre unité : les autres commandes de service ont donc besoin du même --authtoken pour la trouver.

  2. Vérifier qu'il s'exécute #

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    Un service en cours d'exécution répond [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Dans le tableau de bord, le jeton affiche En ligne sous Mes jetons.

Commandes de service #

Exécutez chaque commande avec sudo et ajoutez --authtoken <YOUR_TOKEN>.

CommandeFonction
--install-serviceÉcrit le fichier d'unité, active l'unité et la démarre.
--start-serviceDémarre l'unité, par exemple après l'avoir arrêtée.
--stop-serviceArrête l'unité. Elle reste activée et redémarre après un redémarrage de la machine.
--status-serviceAffiche l'état, par exemple Running, Stopped ou Error lorsque l'unité a échoué.
--remove-serviceArrête et désactive l'unité, puis supprime le fichier d'unité.

Le service est installé avec les options que vous passez avec --install-service. Les options sont listées dans la Référence CLI.

L'unité et ses journaux #

Le fichier d'unité est /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd redémarre le client cinq secondes après un échec. Comme il s'agit d'une unité systemd normale, vous pouvez aussi la gérer avec systemctl et lire sa sortie avec journalctl :

Terminal
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

L'unité lance le fichier localtonet depuis le chemin qu'il avait lors de l'installation du service. Une exception : si ce chemin se trouve sous /root/, la commande d'installation copie le fichier dans /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ et le service exécute la copie.

Mettre à niveau #

  1. Remplacer le client #

    Exécutez de nouveau le script d'installation. Il peut être relancé sans risque et écrase le client installé par la version actuelle. Après une installation manuelle, téléchargez l'archive actuelle et remplacez le fichier localtonet.

    Terminal
    curl -fsSL https://localtonet.com/install.sh | sh
  2. Redémarrer le service #

    Un service en cours d'exécution continue d'utiliser l'ancienne version jusqu'à son redémarrage.

    Terminal
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    Si le service exécute une copie sous /usr/local/lib/, supprimez le service et réinstallez-le avec le nouveau client.

Sous Mes jetons, la colonne Client indique la version que l'appareil a signalée en dernier et un badge Mise à jour requise lorsqu'une version plus récente est disponible.

Désinstaller #

  1. Si vous avez installé le service, supprimez-le : sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Pour supprimer le jeton enregistré, lancez le client et appuyez sur F12.
  3. Supprimez le client : sudo rm /usr/local/bin/localtonet /usr/bin/localtonet après l'installation par script, ou le dossier dans lequel vous avez extrait l'archive.

Dépannage #

Script d'installation : Unsupported architecture

Le script propose des versions pour x64 (x86_64), ARM64 (aarch64) et ARM 32 bits (armv7l). Les autres types de processeur ne sont pas pris en charge par les versions Linux.

Script d'installation : Neither curl nor wget found

Installez curl ou wget avec votre gestionnaire de paquets et relancez le script.

Script d'installation : Failed to install 'unzip'

Le script n'a pas pu installer unzip par lui-même. Installez-le avec votre gestionnaire de paquets et relancez le script.

Installed but not found in PATH

Ouvrez un nouveau shell, ou lancez le client avec son chemin complet, /usr/local/bin/localtonet.

sudo: localtonet: command not found

Après une installation manuelle, le client ne se trouve pas dans le chemin de recherche de sudo. Utilisez le chemin complet, par exemple sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, ou déplacez d'abord le fichier vers /usr/local/bin.

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

La commande a été exécutée sans root. Répétez-la avec sudo. Il en va de même pour --start-service, --stop-service et --remove-service.

Install failed: Systemd unit already exists for 'Localtonet_…'

Un service pour ce jeton est déjà installé. Vérifiez-le avec --status-service. Pour le réinstaller, exécutez d'abord --remove-service.

Les commandes de service échouent sur un système sans systemd

Le mode service utilise systemd. Sur les systèmes qui n'en disposent pas, lancez le client autrement, par exemple dans un conteneur Docker. Le client console dispose pour cela d'un mode sans interface : --headless s'exécute sans invites et lit le jeton dans un fichier indiqué avec --authtoken-file. Consultez la Référence CLI.

Wrong Token!

Le client attend l'AuthToken à 33 caractères provenant de Mes jetons, ou un PIN à 6 chiffres non expiré. Copiez de nouveau le jeton et saisissez-le à l'invite.

This token is used in another localtonet application!

Un autre client Localtonet de cette machine s'exécute déjà avec le même jeton. Fermez-le, ou lancez celui-ci avec un autre jeton. Utilisez un seul client en cours d'exécution par jeton.

Support