Installer Localtonet sur Linux
Sur cette page 9 sections
- Avant de commencer
- Installer avec le script
- Exécuter le script d'installation
- Vérifier l'installation
- Installer manuellement
- Télécharger et extraire
- Facultatif : le placer dans votre PATH
- Démarrer le client
- Le démarrer avec votre jeton
- Vérifier la session
- Exécuter comme service systemd
- Installer le service
- Vérifier qu'il s'exécute
- Commandes de service
- L'unité et ses journaux
- Mettre à niveau
- Remplacer le client
- Redémarrer le service
- Désinstaller
- Dépannage
- 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.
curlouwget, etunzip.- 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 #
-
Exécuter le script d'installation #
Terminalcurl -fsSL https://localtonet.com/install.sh | shLe 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 quesudo localtonetfonctionne sur les distributions oùsudone cherche pas dans/usr/local/bin.Le script utilise
sudolorsque votre utilisateur ne peut pas écrire dans le dossier d'installation, ce qui explique qu'il puisse demander votre mot de passe. Siunzipest absent, il tente de l'installer avec le gestionnaire de paquets de votre distribution. -
Vérifier l'installation #
Le script se termine en affichant la version installée. Vous pouvez l'afficher de nouveau à tout moment :
Terminallocaltonet --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.
| Processeur | glibc (Debian, Ubuntu, Fedora, RHEL et la plupart des autres) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32 bits) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m affiche le type de votre processeur : x86_64 correspond à x64, aarch64 à ARM64 et armv7l à ARM.
-
Télécharger et extraire #
L'exemple utilise la version x64 glibc. Remplacez le nom de fichier par l'archive correspondant à votre système.
Terminalwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Facultatif : le placer dans votre PATH #
Sans cette étape, vous lancez le client avec son chemin,
~/localtonet/localtonet. Ensuite, vous pouvez saisirlocaltonetdans n'importe quel dossier.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Démarrer le client #
-
Le démarrer avec votre jeton #
Terminallocaltonet --authtoken <YOUR_TOKEN>Le client enregistre le jeton localement pour votre utilisateur. La prochaine fois, vous pouvez le lancer avec
localtonetseul. Si vous le lancez sans jeton enregistré, il demandePlease Enter AuthToken or PIN. -
Vérifier la session #
Le terminal affiche
Session Status: Connectedau-dessus d'un tableau comportant une ligne par tunnel en cours d'exécution :IP/Url,Protocol,Client IP,Client Port,PingetStatus. 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.
-
Installer le service #
Terminalsudo 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--authtokenpour la trouver. -
Vérifier qu'il s'exécute #
Terminalsudo 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>.
| Commande | Fonction |
|---|---|
--install-service | Écrit le fichier d'unité, active l'unité et la démarre. |
--start-service | Démarre l'unité, par exemple après l'avoir arrêtée. |
--stop-service | Arrête l'unité. Elle reste activée et redémarre après un redémarrage de la machine. |
--status-service | Affiche l'état, par exemple Running, Stopped ou Error lorsque l'unité a échoué. |
--remove-service | Arrê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 :
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fL'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 #
-
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.Terminalcurl -fsSL https://localtonet.com/install.sh | sh -
Redémarrer le service #
Un service en cours d'exécution continue d'utiliser l'ancienne version jusqu'à son redémarrage.
Terminalsudo 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 #
- Si vous avez installé le service, supprimez-le :
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Pour supprimer le jeton enregistré, lancez le client et appuyez sur F12.
- Supprimez le client :
sudo rm /usr/local/bin/localtonet /usr/bin/localtonetaprè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.