Installer Localtonet sur macOS
Sur cette page 9 sections
- Avant de commencer
- Installer avec Homebrew
- Ajouter le tap Localtonet et installer
- 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 launchd
- Installer le service
- Vérifier qu'il s'exécute
- Ce que l'installation crée
- Commandes de service
- Mise à niveau
- Désinstallation
- Dépannage
- Pages associées
Sur macOS, le client Localtonet est un programme console pour les Mac Intel et Apple Silicon. Installez-le avec Homebrew ou depuis une archive ZIP, démarrez-le avec votre AuthToken et installez-le comme service launchd s'il doit démarrer à chaque dé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.
- Pour l'installation avec Homebrew : Homebrew.
- Pour le service launchd : un compte qui peut utiliser
sudo.
Installer avec Homebrew #
-
Ajouter le tap Localtonet et installer #
Un tap ajoute un dépôt tiers à Homebrew, ce qui permet d'en installer et d'en mettre à jour les formules.
Terminalbrew tap localtonet/tap brew install localtonet -
Vérifier l'installation #
Terminallocaltonet --versionLa commande affiche la version du client.
Installer manuellement #
Si vous préférez un téléchargement direct, prenez l'archive correspondant à votre Mac. Le ZIP contient un seul fichier, localtonet.
| Mac | Archive |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Télécharger et extraire #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip unzip localtonet-osx-64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Facultatif : le placer dans votre PATH #
Sans cette étape, vous démarrez le client par son chemin,
~/localtonet/localtonet. Ensuite, vous pouvez taperlocaltonetdans 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. La fois suivante, vous pouvez le démarrer avec
localtonetseul. Si vous le démarrez sans jeton enregistré, il demandePlease Enter AuthToken or PIN. -
Vérifier la session #
Le terminal affiche
Session Status: Connectedau-dessus d'un tableau avec 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, voir Démarrage rapide.Appuyez sur Ctrl + C pour arrêter le client. Appuyez sur F12 pour supprimer le jeton enregistré et quitter.
Exécuter comme service launchd #
Un service démarre Localtonet à chaque démarrage, le maintient en fonctionnement après votre déconnexion et ne nécessite pas de terminal ouvert. Les commandes du service nécessitent root : exécutez-les donc avec sudo.
-
Installer le service #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>La commande enregistre une tâche launchd à l'échelle du système pour ce jeton et la démarre aussitôt. Elle répond avec le nom de la tâche :
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>correspond aux 9 premiers caractères de votre jeton. Chaque jeton a sa propre tâche : les autres commandes du service nécessitent donc le même--authtokenpour la trouver. -
Vérifier qu'il s'exécute #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Une tâche 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.
Ce que l'installation crée #
| Élément | Emplacement |
|---|---|
| Définition de la tâche launchd | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| Sortie standard du client | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| Sortie d'erreur du client | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
La tâche démarre au démarrage du Mac, et launchd relance le client lorsqu'il se termine sur une erreur. La tâche exécute le fichier localtonet depuis le chemin qu'il avait lors de l'installation du service, avec le jeton dans ses arguments.
Commandes de service #
Exécutez chaque commande avec sudo et ajoutez --authtoken <YOUR_TOKEN>.
| Commande | Fonction |
|---|---|
--install-service | Écrit la définition de la tâche, la charge et démarre le client. |
--start-service | Démarre la tâche. Si elle est déjà en cours d'exécution, launchd la redémarre. |
--stop-service | Arrête le client. La tâche reste installée et redémarre au prochain démarrage. |
--status-service | Affiche l'état, par exemple Running, Stopped, NotFound ou Error. |
--remove-service | Arrête la tâche, la décharge et supprime sa définition. |
Le service est installé avec les options que vous passez avec --install-service. Les options sont listées dans la Référence CLI.
Mise à niveau #
- Homebrew:
brew upgrade localtonet - Installation manuelle : téléchargez l'archive actuelle et remplacez le fichier
localtonet.
Si Localtonet s'exécute comme service, réinstallez le service après une mise à niveau Homebrew : supprimez-le, puis installez-le avec le même jeton. L'installation le démarre aussi.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>La tâche conserve le chemin du fichier à partir duquel elle a été installée. Après une mise à niveau manuelle qui laisse le client au même endroit, il suffit d'arrêter le service avec --stop-service, de remplacer le fichier et de démarrer le service avec --start-service. Exécuter comme service décrit ces commandes.
Désinstallation #
- Si vous avez installé le service, supprimez-le :
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Pour supprimer le jeton enregistré, démarrez le client et appuyez sur F12.
- Supprimez le client. Avec Homebrew :
brew uninstall localtonet, etbrew untap localtonet/tappour supprimer le tap. Après une installation manuelle, supprimez le fichierlocaltonet.
Dépannage #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
La commande a été exécutée sans root. Recommencez avec sudo.
sudo: localtonet: command not found
sudo ne trouve pas le client dans son propre chemin de recherche. Donnez plutôt le chemin complet. command -v localtonet l'affiche, par exemple :
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>Après une installation manuelle sans l'étape PATH, le chemin est ~/localtonet/localtonet.
Install failed: Plist already exists for 'Localtonet_…'
Un service pour ce jeton est déjà installé. Vérifiez-le avec --status-service. Pour l'installer à nouveau, exécutez d'abord --remove-service.
Le service est installé mais le jeton reste Hors ligne
Lisez le journal d'erreurs de la tâche, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, et vérifiez que le fichier localtonet existe toujours au chemin qu'il avait lors de l'installation du service.
Wrong Token!
Le client attend l'AuthToken de 33 caractères de Mes jetons, ou un PIN à 6 chiffres qui n'a pas expiré. Copiez à nouveau le jeton et saisissez-le à l'invite.
This token is used in another localtonet application!
Un autre client Localtonet de ce Mac s'exécute déjà avec le même jeton. Fermez-le, ou démarrez celui-ci avec un autre jeton. Utilisez un seul client en cours d'exécution par jeton.