Aller au contenu
Localtonet Localtonet Tableau de bord

Installer Localtonet sur Windows

Aide pour cette page
Sur cette page 9 sections
  1. Avant de commencer
  2. Choisir une version
  3. Utiliser l'application
  4. Installer et ouvrir l'application
  5. Se connecter avec votre jeton
  6. Démarrer un tunnel
  7. Utiliser le client console
  8. Télécharger et extraire
  9. Le démarrer avec votre jeton
  10. Vérifier la session
  11. Exécuter comme service Windows
  12. Installer le service
  13. Vérifier qu'il s'exécute
  14. Commandes de service
  15. Mettre à jour
  16. Désinstaller
  17. Dépannage
  18. Pages associées

Sous Windows, vous pouvez utiliser l'application Localtonet du Microsoft Store, une version portable de la même application, ou le client console. Le client console peut aussi s'installer lui-même comme service Windows qui démarre à chaque amorçage.

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.
  • Pour le service Windows : une fenêtre Invite de commandes ou PowerShell exécutée en tant qu'administrateur.

Choisir une version #

VersionTéléchargementRemarques
Application Microsoft StoreLocaltonet dans le Microsoft StoreUne fenêtre d'application avec un écran de connexion. Nécessite Windows 10 version 1809 (build 17763) ou ultérieure.
Application de bureau, ZIP portablex64, x86, ARM64La même application sans le Store. Extrayez le ZIP et lancez l'application depuis le dossier d'extraction.
Client console64 bits, 32 bits, ARM64Un ZIP qui contient un seul fichier, localtonet.exe. C'est la version qui propose les commandes de service.

La page Téléchargements propose l'application Microsoft Store et les trois versions console sous Binaires.

Utiliser l'application #

  1. Installer et ouvrir l'application #

    Installez Localtonet depuis le Microsoft Store, ou extrayez le ZIP portable et lancez l'application. L'application s'ouvre sur l'écran Sign in to Localtonet.

  2. Se connecter avec votre jeton #

    Collez votre AuthToken dans le champ Authtoken or PIN et sélectionnez Connect. Si le jeton se trouve dans le presse-papiers à l'ouverture de l'écran, l'application le renseigne pour vous. Au lieu du jeton, vous pouvez saisir le code PIN à 6 chiffres que Mes jetons affiche pour un jeton. Un PIN est valable une minute.

    Si l'application répond Pin or authtoken is not valid., copiez de nouveau le jeton et vérifiez que les 33 caractères sont bien présents.

  3. Démarrer un tunnel #

    Après la connexion, l'application liste les tunnels qui s'exécutent sur cet appareil. Tant que la liste indique No active tunnels, créez et démarrez un tunnel dans le tableau de bord, consultez le Démarrage rapide. Sign Out supprime le jeton de l'application, Quit Localtonet la ferme.

Utiliser le client console #

  1. Télécharger et extraire #

    Téléchargez le ZIP correspondant à votre processeur et extrayez-le dans un dossier qui reste en place, par exemple C:\Localtonet. Un service que vous installez plus tard lance localtonet.exe depuis ce dossier.

  2. Le démarrer avec votre jeton #

    Ouvrez Invite de commandes ou PowerShell dans ce dossier et exécutez :

    Invite de commandes
    localtonet --authtoken <YOUR_TOKEN>

    PowerShell n'exécute un programme du dossier courant que si vous écrivez le chemin ; la commande y est donc :

    PowerShell
    .\localtonet --authtoken <YOUR_TOKEN>

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

  3. Vérifier la session #

    La fenêtre 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. Le nom de votre jeton apparaît sous le tableau.

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

Exécuter comme service Windows #

Un service lance Localtonet à chaque amorçage, le maintient en cours d'exécution après votre déconnexion et ne nécessite pas de terminal ouvert. Exécutez ces commandes avec le client console, dans Invite de commandes ou PowerShell exécuté en tant qu'administrateur.

  1. Installer le service #

    Invite de commandes (administrateur)
    localtonet --install-service --authtoken <YOUR_TOKEN>

    La commande enregistre un service Windows pour ce jeton, définit son type de démarrage sur automatique et le démarre immédiatement. Elle répond avec le nom du service :

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

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

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

    Invite de commandes (administrateur)
    localtonet --status-service --authtoken <YOUR_TOKEN>

    Un service en cours d'exécution répond [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Le service est aussi visible dans services.msc sous le même nom, avec la description Localtonet Service. Dans le tableau de bord, le jeton affiche En ligne sous Mes jetons.

Commandes de service #

Ajoutez --authtoken <YOUR_TOKEN> à chaque commande.

CommandeFonctionNécessite les droits d'administrateur
--install-serviceCrée le service avec démarrage automatique et le démarre. Windows redémarre le service une minute après un échec.Oui
--start-serviceDémarre le service installé, par exemple après l'avoir arrêté.Oui
--stop-serviceArrête le service. Il redémarre au prochain amorçage.Oui
--status-serviceAffiche l'état : Running, Stopped, Installing pendant le démarrage du service, Paused, NotFound lorsqu'aucun service n'existe pour ce jeton, Error ou Unknown.Non
--remove-serviceArrête le service et le supprime.Oui

Le service est installé avec les options que vous passez avec --install-service : ajoutez donc à cette commande les options du client comme --net et --ip. Les options sont listées dans la Référence CLI.

Le service exécute localtonet.exe depuis le dossier où il se trouvait lors de l'installation du service, avec le jeton dans sa commande de démarrage. Ne déplacez pas et ne supprimez pas le fichier tant que le service est installé.

Mettre à jour #

  • Application Microsoft Store : le Microsoft Store met l'application à jour.
  • Client console et application portable : téléchargez le ZIP actuel depuis la page Téléchargements et remplacez les anciens fichiers. Windows ne permet pas de remplacer localtonet.exe pendant son exécution : fermez donc d'abord le client. S'il s'exécute comme service, exécutez --stop-service, remplacez le fichier, puis exécutez --start-service.

localtonet --version affiche la version installée. 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 : localtonet --remove-service --authtoken <YOUR_TOKEN> en tant qu'administrateur.
  2. Pour supprimer le jeton enregistré, lancez le client console et appuyez sur F12.
  3. Supprimez le dossier contenant localtonet.exe, ou désinstallez l'application du Store depuis les Paramètres Windows.

Dépannage #

'localtonet' n'est pas reconnu en tant que commande interne ou externe

Le terminal n'est pas dans le dossier qui contient localtonet.exe, ou vous êtes dans PowerShell. Placez-vous d'abord dans le dossier. Dans PowerShell, lancez le client avec .\localtonet.

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

Le terminal ne s'exécute pas en tant qu'administrateur. Ouvrez Invite de commandes ou PowerShell avec Exécuter en tant qu'administrateur et répétez la commande. --start-service, --stop-service et --remove-service répondent avec le même type de message.

Install failed: Service 'Localtonet_…' already exists.

Un service pour ce jeton est déjà installé. Vérifiez-le avec --status-service. Pour le réinstaller, par exemple avec d'autres options ou depuis un autre dossier, exécutez d'abord --remove-service.

Start failed: Service could not be started

Le message inclut la réponse de l'outil Windows sc. L'erreur 1056 signifie que le service est déjà en cours d'exécution. C'est normal lorsque vous exécutez --start-service juste après --install-service, car la commande d'installation démarre déjà le service. L'erreur 1060 signifie qu'aucun service n'existe pour ce jeton.

Le statut est NotFound, mais j'ai installé le service

Le nom du service est construit à partir du jeton. Si vous passez un jeton différent de celui avec lequel vous avez installé le service, le client cherche un autre service. Utilisez le même jeton, ou cherchez dans services.msc un service dont le nom commence par Localtonet_.

Service installation cannot persist proxy passwords.

Vous avez combiné --install-service avec --proxy-user ou avec une URL de proxy qui contient un mot de passe. Un service n'est pas installé avec des mots de passe de proxy. Utilisez --proxy env et fournissez les identifiants dans l'environnement du service. 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!

Une autre fenêtre Localtonet de cet ordinateur s'exécute déjà avec le même jeton. Fermez-la, ou lancez celle-ci avec un autre jeton. Utilisez un seul client en cours d'exécution par jeton.

Le jeton reste Hors ligne dans le tableau de bord

Hors ligne signifie que l'appareil est déconnecté. Vérifiez que la fenêtre du client est toujours ouverte ou que l'état du service est Running, et que le client a été démarré avec le jeton que vous consultez.

Support