Installer le client Localtonet
Sur cette page 5 sections
- Plateformes prises en charge
- Choisir le type d'installation
- Ce que toutes les installations ont en commun
- Le client se connecte avec un AuthToken
- Vous démarrez le client avec ce jeton
- Vous créez et démarrez les tunnels dans le tableau de bord
- Le client doit rester en cours d'exécution
- Garder le client à jour
- Guides d'installation
Le client Localtonet s'exécute sur l'appareil qui héberge votre service et garde ouvert le tunnel vers Localtonet. Cette page liste les plateformes prises en charge, vous aide à choisir le bon type d'installation et renvoie vers le guide de chacune.
Plateformes prises en charge #
Tous les téléchargements se trouvent sur la page Téléchargements.
| Plateforme | Ce que vous pouvez installer | Architectures |
|---|---|---|
| Windows | Application Microsoft Store, application de bureau portable, client console | 64 bits (x64), 32 bits (x86), ARM64 |
| macOS | Client console, avec Homebrew ou sous forme d'archive ZIP | Intel (x64), Apple Silicon (ARM64) |
| Linux | Client console, avec le script d'installation ou sous forme d'archive ZIP | x64, ARM et ARM64, chacune pour glibc et pour musl |
| Paquets Linux | Paquets DEB et RPM avec services systemd | x64, ARM64 |
| Android | Application Android depuis Google Play ou sous forme de fichier APK | La version minimale d'Android requise par l'application est la 5.0 |
| Termux | Client console sous forme de paquet Termux | ARM64 |
| Docker | Image officielle localtonet/localtonet | AMD64, ARM64 |
| OpenWrt | Paquets pour routeurs OpenWrt 24.10 et 25.12+ (expérimental) | x64, ARM64 |
| NAS et Home Assistant | Modèles d'installation Docker Compose et Home Assistant | AMD64, ARM64 |
| SSH sans installation | Rien. Vous utilisez le client SSH que vous avez déjà. | Tout appareil disposant d'un client SSH |
Choisir le type d'installation #
| Option | De quoi s'agit-il | À choisir lorsque |
|---|---|---|
| Client console | Le programme localtonet pour Windows, macOS et Linux. Vous le démarrez dans un terminal avec votre AuthToken. Il affiche vos tunnels dans un tableau en direct et peut s'installer lui-même comme service. | Vous travaillez dans un terminal, ou l'appareil est un serveur sans bureau. |
| Application de bureau | L'application Localtonet pour Windows avec une fenêtre de connexion, depuis le Microsoft Store ou sous forme de ZIP portable. | Vous préférez une fenêtre d'application à un terminal sous Windows. |
| Application mobile | L'application Localtonet pour Android. Vous vous connectez avec un QR code, un PIN ou le jeton. | L'appareil est un téléphone ou une tablette Android, par exemple pour un proxy mobile. |
| Paquet | Paquets DEB et RPM pour Linux, un paquet Termux pour Android et des paquets expérimentaux pour OpenWrt. Les paquets Linux et OpenWrt incluent un service qui lit le jeton depuis un fichier. | Vous voulez que le gestionnaire de paquets du système installe et supprime le client, avec un service qui démarre au boot. |
| Conteneur | L'image Docker officielle, et les modèles d'installation pour NAS et Home Assistant qui l'utilisent. | Vos services s'exécutent déjà dans des conteneurs, ou l'appareil est un NAS. |
| SSH sans installation | Le tableau de bord génère une commande ssh qui ouvre le tunnel. Aucun téléchargement n'est nécessaire. Elle est proposée pour les tunnels HTTP et TCP. | Vous ne pouvez pas ou ne voulez pas installer quoi que ce soit sur l'appareil. |
Ce que toutes les installations ont en commun #
-
Le client se connecte avec un AuthToken #
Un AuthToken connecte un appareil à votre compte. Copiez-le avec Copier sur la carte AuthToken du Tableau de bord, ou créez un jeton nommé pour chaque appareil sous Mes jetons. Les jetons sont expliqués dans AuthTokens.
Gardez votre jeton confidentiel. Toute personne qui possède le jeton peut s'en servir pour se connecter à l'application.
-
Vous démarrez le client avec ce jeton #
Remplacez
<YOUR_TOKEN>par votre jeton.Windows
Ouvrez l'application Localtonet et collez votre AuthToken, ou exécutez le client console dans l'Invite de commandes depuis le dossier qui contient
localtonet.exe:Invite de commandeslocaltonet --authtoken <YOUR_TOKEN>macOS
Bashbrew tap localtonet/tap brew install localtonet localtonet --authtoken <YOUR_TOKEN>Linux
Bashcurl -fsSL https://localtonet.com/install.sh | sh localtonet --authtoken <YOUR_TOKEN>Docker
Bashdocker pull localtonet/localtonet docker run localtonet/localtonet --authtoken <YOUR_TOKEN>Android
Ouvrez l'application Localtonet, puis scannez le QR code du jeton, saisissez son PIN ou collez le jeton, et sélectionnez Connect. Le QR code et le PIN se trouvent sous Mes jetons.
Le client console enregistre le jeton localement ; la fois suivante, vous pouvez donc le démarrer avec
localtonetseul. Lorsque vous le démarrez sans jeton enregistré, il demandePlease Enter AuthToken or PIN. -
Vous créez et démarrez les tunnels dans le tableau de bord #
Le client n'a pas besoin de connaître vos tunnels à l'avance. Vous créez un tunnel sous Mes tunnels, choisissez le jeton de l'appareil, et le client connecté avec ce jeton le sert. Le Démarrage rapide vous guide pas à pas pour le premier tunnel.
-
Le client doit rester en cours d'exécution #
Un tunnel passe en ligne une fois que le client s'exécute avec votre AuthToken et que le tunnel est démarré. Mes jetons affiche chaque appareil comme En ligne ou Hors ligne. Hors ligne signifie que l'appareil est déconnecté, même si ses tunnels sont toujours configurés.
Pour que le client continue de s'exécuter après la fermeture du terminal, une déconnexion ou un redémarrage de l'appareil, installez-le comme service :
Plateforme Comment Windows localtonet --install-service --authtoken <YOUR_TOKEN>dans un terminal exécuté en tant qu'administrateurmacOS, Linux sudo localtonet --install-service --authtoken <YOUR_TOKEN>Paquets DEB, RPM et OpenWrt Le paquet contient le service. Vous l'activez après avoir défini le jeton. Android L'application continue de s'exécuter en arrière-plan et se rouvre après le redémarrage du téléphone. Les détails se trouvent dans Exécuter en tant que service et sur la page de chaque plateforme.
Garder le client à jour #
La colonne Client sous Mes jetons affiche la dernière version transmise par chaque appareil. Un badge Mise à jour requise renvoie vers la page Téléchargements lorsqu'une version plus récente est disponible. Le client console affiche aussi New Version available sous son tableau de tunnels, et localtonet --version affiche la version installée.