Vai al contenuto
Localtonet Localtonet Dashboard

Installa Localtonet su macOS

Aiuto su questa pagina
In questa pagina 9 sezioni
  1. Prima di iniziare
  2. Installa con Homebrew
  3. Aggiungi il tap di Localtonet e installa
  4. Verifica l'installazione
  5. Installa manualmente
  6. Scarica ed estrai
  7. Facoltativo: spostalo nel PATH
  8. Avvia il client
  9. Avvialo con il tuo token
  10. Controlla la sessione
  11. Esegui come servizio launchd
  12. Installa il servizio
  13. Verifica che sia in esecuzione
  14. Cosa crea l'installazione
  15. Comandi del servizio
  16. Aggiornamento
  17. Disinstallazione
  18. Risoluzione dei problemi
  19. 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 #

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

    Terminale
    brew tap localtonet/tap
    brew install localtonet
  2. Verifica l'installazione #

    Terminale
    localtonet --version

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

MacArchivio
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. Scarica ed estrai #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -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
  2. Facoltativo: spostalo nel PATH #

    Senza questo passaggio avvii il client tramite il suo percorso, ~/localtonet/localtonet. Dopo di esso puoi digitare localtonet in qualsiasi cartella.

    Terminale
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

Avvia il client #

  1. Avvialo con il tuo token #

    Terminale
    localtonet --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, chiede Please Enter AuthToken or PIN.

  2. Controlla la sessione #

    Il terminale mostra Session Status: Connected sopra una tabella con una riga per ogni tunnel in esecuzione: IP/Url, Protocol, Client IP, Client Port, Ping e Status. 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.

  1. Installa il servizio #

    Terminale
    sudo 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 --authtoken per trovarlo.

  2. Verifica che sia in esecuzione #

    Terminale
    sudo 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 #

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

ComandoCosa fa
--install-serviceScrive la definizione del job, la carica e avvia il client.
--start-serviceAvvia il job. Se è già in esecuzione, launchd lo riavvia.
--stop-serviceFerma il client. Il job resta installato e riparte al prossimo avvio.
--status-serviceStampa lo stato, ad esempio Running, Stopped, NotFound o Error.
--remove-serviceFerma 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.

Terminale
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 #

  1. Se hai installato il servizio, rimuovilo: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. Per rimuovere il token memorizzato, avvia il client e premi F12.
  3. Rimuovi il client. Con Homebrew: brew uninstall localtonet, e brew untap localtonet/tap per rimuovere il tap. Dopo un'installazione manuale, elimina il file localtonet.

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:

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

Supporto