Aller au contenu
Localtonet Localtonet Tableau de bord

Installer le client Localtonet

Aide pour cette page
Sur cette page 5 sections
  1. Plateformes prises en charge
  2. Choisir le type d'installation
  3. Ce que toutes les installations ont en commun
  4. Le client se connecte avec un AuthToken
  5. Vous démarrez le client avec ce jeton
  6. Vous créez et démarrez les tunnels dans le tableau de bord
  7. Le client doit rester en cours d'exécution
  8. Garder le client à jour
  9. 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.

PlateformeCe que vous pouvez installerArchitectures
WindowsApplication Microsoft Store, application de bureau portable, client console64 bits (x64), 32 bits (x86), ARM64
macOSClient console, avec Homebrew ou sous forme d'archive ZIPIntel (x64), Apple Silicon (ARM64)
LinuxClient console, avec le script d'installation ou sous forme d'archive ZIPx64, ARM et ARM64, chacune pour glibc et pour musl
Paquets LinuxPaquets DEB et RPM avec services systemdx64, ARM64
AndroidApplication Android depuis Google Play ou sous forme de fichier APKLa version minimale d'Android requise par l'application est la 5.0
TermuxClient console sous forme de paquet TermuxARM64
DockerImage officielle localtonet/localtonetAMD64, ARM64
OpenWrtPaquets pour routeurs OpenWrt 24.10 et 25.12+ (expérimental)x64, ARM64
NAS et Home AssistantModèles d'installation Docker Compose et Home AssistantAMD64, ARM64
SSH sans installationRien. Vous utilisez le client SSH que vous avez déjà.Tout appareil disposant d'un client SSH

Choisir le type d'installation #

OptionDe quoi s'agit-ilÀ choisir lorsque
Client consoleLe 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 bureauL'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 mobileL'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.
PaquetPaquets 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.
ConteneurL'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 installationLe 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 #

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

  2. 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 commandes
    localtonet --authtoken <YOUR_TOKEN>

    macOS

    Bash
    brew tap localtonet/tap
    brew install localtonet
    localtonet --authtoken <YOUR_TOKEN>

    Linux

    Bash
    curl -fsSL https://localtonet.com/install.sh | sh
    localtonet --authtoken <YOUR_TOKEN>

    Docker

    Bash
    docker 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 localtonet seul. Lorsque vous le démarrez sans jeton enregistré, il demande Please Enter AuthToken or PIN.

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

  4. 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 :

    PlateformeComment
    Windowslocaltonet --install-service --authtoken <YOUR_TOKEN> dans un terminal exécuté en tant qu'administrateur
    macOS, Linuxsudo localtonet --install-service --authtoken <YOUR_TOKEN>
    Paquets DEB, RPM et OpenWrtLe paquet contient le service. Vous l'activez après avoir défini le jeton.
    AndroidL'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.

Guides d'installation #

Support