Installa Localtonet su macOS
In questa pagina 9 sezioni
- Prima di iniziare
- Installa con Homebrew
- Aggiungi il tap di Localtonet e installa
- Verifica l'installazione
- Installa manualmente
- Scarica ed estrai
- Facoltativo: spostalo nel PATH
- Avvia il client
- Avvialo con il tuo token
- Controlla la sessione
- Esegui come servizio launchd
- Installa il servizio
- Verifica che sia in esecuzione
- Cosa crea l'installazione
- Comandi del servizio
- Aggiornamento
- Disinstallazione
- Risoluzione dei problemi
- Pagine correlate
Su macOS il client Localtonet è un programma da console per Mac Intel e Apple Silicon. Installalo con Homebrew o da un archivio ZIP, avvialo con il tuo AuthToken e installalo come servizio launchd se deve partire a ogni avvio.
Prima di iniziare #
- Un account Localtonet. Creane uno gratuitamente se non ce l'hai.
- Il tuo AuthToken. Seleziona Copia sulla scheda AuthToken della Dashboard, oppure copia un token da I miei token.
- Per l'installazione con Homebrew: Homebrew.
- Per il servizio launchd: un account che può usare
sudo.
Installa con Homebrew #
-
Aggiungi il tap di Localtonet e installa #
Un tap aggiunge a Homebrew un repository di terze parti, così puoi installare e aggiornare le formule che contiene.
Terminalebrew tap localtonet/tap brew install localtonet -
Verifica l'installazione #
Terminalelocaltonet --versionIl comando stampa la versione del client.
Installa manualmente #
Se preferisci un download diretto, prendi l'archivio per il tuo Mac. Lo ZIP contiene un solo file, localtonet.
| Mac | Archivio |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
Scarica ed estrai #
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 -
Facoltativo: spostalo nel PATH #
Senza questo passaggio avvii il client tramite il suo percorso,
~/localtonet/localtonet. Dopo di esso puoi digitarelocaltonetin qualsiasi cartella.Terminalesudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Avvia il client #
-
Avvialo con il tuo token #
Terminalelocaltonet --authtoken <YOUR_TOKEN>Il client memorizza il token in locale. La volta successiva puoi avviarlo con il solo
localtonet. Se lo avvii senza un token memorizzato, chiedePlease Enter AuthToken or PIN. -
Controlla la sessione #
Il terminale mostra
Session Status: Connectedsopra una tabella con una riga per ogni tunnel in esecuzione:IP/Url,Protocol,Client IP,Client Port,PingeStatus. La tabella resta vuota finché non avvii un tunnel nella dashboard, vedi Guida rapida.Premi Ctrl + C per fermare il client. Premi F12 per rimuovere il token memorizzato e uscire.
Esegui come servizio launchd #
Un servizio avvia Localtonet a ogni avvio, lo mantiene in esecuzione anche dopo il logout e non richiede un terminale aperto. I comandi del servizio richiedono i privilegi di root, quindi eseguili con sudo.
-
Installa il servizio #
Terminalesudo localtonet --install-service --authtoken <YOUR_TOKEN>Il comando registra un job launchd a livello di sistema per questo token e lo avvia subito. Risponde con il nome del job:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>sono i primi 9 caratteri del tuo token. Ogni token ha il proprio job, quindi gli altri comandi del servizio richiedono lo stesso--authtokenper trovarlo. -
Verifica che sia in esecuzione #
Terminalesudo localtonet --status-service --authtoken <YOUR_TOKEN>Un job in esecuzione risponde
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Nella dashboard il token mostra Online in I miei token.
Cosa crea l'installazione #
| Voce | Posizione |
|---|---|
| Definizione del job launchd | /Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist |
| Standard output del client | /var/log/Localtonet_<TOKEN_PREFIX>.out.log |
| Output degli errori del client | /var/log/Localtonet_<TOKEN_PREFIX>.err.log |
Il job parte all'avvio del Mac e launchd riavvia il client quando termina con un errore. Il job esegue il file localtonet dal percorso che aveva quando hai installato il servizio, con il token tra i suoi argomenti.
Comandi del servizio #
Esegui ogni comando con sudo e aggiungi --authtoken <YOUR_TOKEN>.
| Comando | Cosa fa |
|---|---|
--install-service | Scrive la definizione del job, la carica e avvia il client. |
--start-service | Avvia il job. Se è già in esecuzione, launchd lo riavvia. |
--stop-service | Ferma il client. Il job resta installato e riparte al prossimo avvio. |
--status-service | Stampa lo stato, ad esempio Running, Stopped, NotFound o Error. |
--remove-service | Ferma il job, lo scarica e cancella la definizione del job. |
Il servizio viene installato con le opzioni che passi insieme a --install-service. Le opzioni sono elencate nel Riferimento CLI.
Aggiornamento #
- Homebrew:
brew upgrade localtonet - Installazione manuale: scarica l'archivio più recente e sostituisci il file
localtonet.
Se Localtonet è in esecuzione come servizio, dopo un aggiornamento di Homebrew installa di nuovo il servizio: rimuovilo, poi installalo con lo stesso token. L'installazione lo avvia anche.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Il job conserva il percorso del file da cui è stato installato. Dopo un aggiornamento manuale che lascia il client nello stesso posto, basta fermare il servizio con --stop-service, sostituire il file e avviare il servizio con --start-service. Esegui come servizio descrive questi comandi.
Disinstallazione #
- Se hai installato il servizio, rimuovilo:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Per rimuovere il token memorizzato, avvia il client e premi F12.
- Rimuovi il client. Con Homebrew:
brew uninstall localtonet, ebrew untap localtonet/tapper rimuovere il tap. Dopo un'installazione manuale, elimina il filelocaltonet.
Risoluzione dei problemi #
Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.
Il comando è stato eseguito senza root. Ripetilo con sudo.
sudo: localtonet: command not found
sudo non trova il client nel proprio percorso di ricerca. Indica invece il percorso completo. command -v localtonet lo stampa, ad esempio:
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>Dopo un'installazione manuale senza il passaggio del PATH, il percorso è ~/localtonet/localtonet.
Install failed: Plist already exists for 'Localtonet_…'
Un servizio per questo token è già installato. Controllalo con --status-service. Per installarlo di nuovo, esegui prima --remove-service.
Il servizio è installato ma il token resta Offline
Leggi il log degli errori del job, /var/log/Localtonet_<TOKEN_PREFIX>.err.log, e verifica che il file localtonet esista ancora nel percorso che aveva quando hai installato il servizio.
Wrong Token!
Il client si aspetta l'AuthToken di 33 caratteri da I miei token, oppure un PIN di 6 cifre non ancora scaduto. Copia di nuovo il token e inseriscilo al prompt.
This token is used in another localtonet application!
Un altro client Localtonet su questo Mac è già in esecuzione con lo stesso token. Chiudilo, oppure avvia questo con un token diverso. Usa un solo client in esecuzione per token.