Vai al contenuto
Localtonet Localtonet Dashboard

Riferimento della riga di comando

Aiuto su questa pagina
In questa pagina 14 sezioni
  1. Prima di iniziare
  2. Sintassi
  3. Panoramica rapida
  4. Autenticazione
  5. --authtoken
  6. --ephemeral-token
  7. Gestione del servizio
  8. Modalità headless
  9. --headless
  10. --authtoken-file
  11. --check-config
  12. Il log headless
  13. Selezione della rete
  14. --network
  15. --net e --ip
  16. Proxy in uscita
  17. --proxy
  18. --proxy-user
  19. Variabili d'ambiente del proxy
  20. --http-transport
  21. Terminale dispositivo
  22. --terminal
  23. --terminal-user
  24. --pairing-key
  25. localtonet ssh
  26. Diagnostica e informazioni
  27. --debug
  28. --version
  29. --help
  30. Variabili d'ambiente
  31. Codici di uscita
  32. Esempi
  33. Pagine correlate

Tutte le opzioni del client da console localtonet: accesso con un token, esecuzione come servizio, esecuzione senza richieste interattive, scelta di una rete o di un proxy in uscita e i comandi di Device Terminal.

Prima di iniziare #

Questa pagina riguarda il client da console per Windows, macOS e Linux, compreso il client nell'immagine Docker e nei pacchetti Linux. Installalo dalla panoramica dell'installazione. I tunnel non si creano dalla riga di comando: li crei, avvii e fermi nella dashboard, con l'API o con il server MCP. Il client collega un dispositivo al tuo account e trasporta il traffico.

Sintassi #

Bash
localtonet [options]
localtonet ssh <DEVICE> [--key <KEY>] [--stdio] [-- <COMMAND>]
  • Le opzioni possono essere indicate in qualsiasi ordine. I nomi delle opzioni non distinguono tra maiuscole e minuscole, tranne quelle di localtonet ssh.
  • Il valore segue la sua opzione dopo uno spazio o un segno di uguale: --authtoken <YOUR_TOKEN> e --authtoken=<YOUR_TOKEN> sono equivalenti.
  • Un'opzione che richiede un valore fallisce con <option> requires a value. quando il valore manca.
  • --proxy, --proxy-user e --http-transport possono essere indicate una sola volta.
  • I segnaposto come <YOUR_TOKEN> stanno al posto dei tuoi valori. Scrivili senza le parentesi angolari.

Senza opzioni, il client si avvia in modalità interattiva: usa il token salvato o te ne chiede uno, si connette e mostra una tabella di stato in tempo reale.

Bash
localtonet

Panoramica rapida #

OpzioneScopo
--authtoken <TOKEN>Accedi con un AuthToken.
--ephemeral-tokenNon salvare il token su questo dispositivo.
--install-service, --start-service, --stop-service, --status-service, --remove-serviceGestisci il servizio in background.
--headlessEsegui senza richieste interattive e con righe di log semplici.
--authtoken-file <PATH>Leggi il token da un file (modalità headless).
--check-configControlla l'origine del token ed esci (modalità headless).
--networkElenca le interfacce di rete del dispositivo.
--net <NAME> --ip <ADDRESS>Invia tutto il traffico del client attraverso una sola interfaccia di rete.
--proxy <none|env|URL>, --proxy-user <USER>Connettiti a Localtonet tramite un proxy in uscita.
--http-transport <auto|https|raw>Scegli come le connessioni al server vengono trasportate attraverso un proxy.
--terminal <enable|disable|status>, --terminal-user <ACCOUNT>, --pairing-key <KEY>Attiva o disattiva Device Terminal per questo dispositivo.
ssh <DEVICE>Apri una shell o esegui un comando su uno dei tuoi dispositivi.
--debugStampa la diagnostica della connessione.
--versionStampa la versione.
--help, -hStampa la guida integrata.

Autenticazione #

--authtoken #

Bash
localtonet --authtoken <YOUR_TOKEN>

Fa accedere il dispositivo con un AuthToken preso da I miei token. Un token è lungo 33 caratteri. Il client lo salva nel profilo dell'utente corrente, quindi la volta successiva basta un semplice localtonet.

  • Senza --authtoken e senza un token salvato, il client chiede Please Enter AuthToken or PIN. Puoi digitare il token oppure un PIN di sei cifre che la dashboard mostra per un token.
  • Un valore che non è un token valido riceve la risposta Wrong Token! e la domanda viene posta di nuovo.
  • Mentre il client è in esecuzione, F12 rimuove il token salvato ed esce. Ctrl + C esce e lo mantiene.
  • La vecchia forma senza trattini, authtoken <YOUR_TOKEN>, è ancora accettata.

Tieni privato il tuo token. Consente al client Localtonet di connettersi come questo dispositivo. Usa un token per dispositivo: un secondo client che si connette con lo stesso token disconnette il primo.

--ephemeral-token #

Bash
localtonet --authtoken <YOUR_TOKEN> --ephemeral-token

Usa il token solo per questa esecuzione. Il client non scrive il token nelle impostazioni salvate e non modifica un token già salvato. Usalo per l'automazione e per le sessioni temporanee.

Gestione del servizio #

Queste opzioni registrano il client tra i servizi di Windows, in launchd su macOS o in systemd su Linux. Richiedono i privilegi di amministratore (sudo su macOS e Linux) e ognuna richiede il token, perché il servizio prende il nome da esso. La guida completa è Esegui come servizio.

OpzioneCosa faEsempio
--install-serviceInstalla il client come servizio che parte all'avvio del sistema e lo avvia. Le altre opzioni della riga di comando vengono memorizzate nel servizio.localtonet --install-service --authtoken <YOUR_TOKEN>
--start-serviceAvvia il servizio installato.localtonet --start-service --authtoken <YOUR_TOKEN>
--stop-serviceFerma il servizio.localtonet --stop-service --authtoken <YOUR_TOKEN>
--status-serviceStampa lo stato del servizio, per esempio Running, Stopped o NotFound.localtonet --status-service --authtoken <YOUR_TOKEN>
--remove-serviceFerma il servizio e lo rimuove.localtonet --remove-service --authtoken <YOUR_TOKEN>

Le opzioni del servizio non si usano in modalità headless.

Modalità headless #

La modalità headless è pensata per container, sistemi di init e script. Il client non fa mai domande, non reagisce ai tasti, non salva il token e scrive una semplice riga di log per ogni cambiamento invece della tabella di stato. L'immagine Docker e i pacchetti per Linux e OpenWrt eseguono il client in questo modo.

--headless #

Bash
localtonet --headless --authtoken-file /etc/localtonet/auth-token

Avvia il client in modalità headless. Impostare la variabile d'ambiente LOCALTONET_HEADLESS=1 ha lo stesso effetto. Il client si ferma in modo pulito quando riceve un segnale di terminazione.

Il token proviene da una di queste origini:

OrigineNote
--authtoken-file <PATH>Un file che contiene solo il token. Spazi e interruzioni di riga intorno al token vengono ignorati.
LOCALTONET_AUTH_TOKEN_FILEVariabile d'ambiente con il percorso di un file di questo tipo. Viene usata quando --authtoken-file non è indicata.
--authtoken <TOKEN>Il token stesso sulla riga di comando.
LOCALTONET_AUTH_TOKENVariabile d'ambiente con il token. Viene usata quando --authtoken non è indicata.

Un file del token ha sempre la precedenza su un token passato direttamente. Se viene indicato un file del token ma non può essere letto, il client si ferma: non passa a un'altra origine.

Quando non trova un token utilizzabile, il client stampa Invalid Localtonet headless configuration. Check the token file or environment settings. ed esce con il codice 2. Un token utilizzabile è lungo 33 caratteri e non contiene spazi.

--authtoken-file #

Bash
localtonet --headless --authtoken-file <PATH>

Legge il token da un file invece che dalla riga di comando, così non compare nell'elenco dei processi né nella cronologia della shell. Proteggi il file, per esempio con chmod 600. Questa opzione viene letta solo in modalità headless.

--check-config #

Bash
localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

Controlla l'origine del token ed esce senza connettersi. Stampa Localtonet headless configuration OK. ed esce con il codice 0 quando è stato trovato un token ben formato, altrimenti stampa l'errore indicato sopra ed esce con il codice 2. Il controllo è locale: non ti dice se Localtonet accetta il token. Combinala sempre con --headless (oppure LOCALTONET_HEADLESS=1); da sola viene ignorata.

Il log headless #

RigaSignificato
Localtonet - headless logIl client è stato avviato.
Connection: …Lo stato della connessione è cambiato.
AuthTokenName: …Il nome del token con cui il dispositivo ha effettuato l'accesso.
OPEN …, ADDED …Un tunnel già esistente all'avvio o aggiunto in seguito.
STATUS …Un tunnel ha cambiato stato.
CLOSED …Un tunnel è stato rimosso da questo client.
Authentication failed: AuthToken was rejected.Localtonet non ha accettato il token.

Ogni riga dopo la prima inizia con un timestamp. Il token non viene mai scritto nel log.

Selezione della rete #

Su un dispositivo con più di una connessione a internet, per esempio Ethernet e un modem mobile, puoi scegliere quale usa il client. La pagina Selezione della rete spiega la funzione e l'impostazione per singolo tunnel.

--network #

Bash
localtonet --network

Elenca ogni interfaccia di rete attiva con i suoi indirizzi, verifica se ogni indirizzo IPv4 raggiunge internet ed esce. Ogni riga è già scritta come le opzioni che dovresti passare:

Output
NetworkName: Ethernet
--net Ethernet --ip 192.168.1.20   --> Internet available (public IP 203.0.113.10)
--------------------------------------------------
NetworkName: Mobile
--net Mobile --ip 10.20.30.40   --> No internet access
--------------------------------------------------

Gli indirizzi IPv6 sono elencati con IPv6, internet check not available.

--net e --ip #

Bash
localtonet --authtoken <YOUR_TOKEN> --net Ethernet --ip 192.168.1.20

Vincola l'intero client a una sola interfaccia di rete. --net è il nome dell'interfaccia e --ip è un indirizzo di quell'interfaccia, esattamente come li stampa --network. Vanno indicate insieme. Un nome di interfaccia con spazi può essere scritto così com'è o tra virgolette.

  • Se la coppia non può essere applicata, il client attende fino a 30 secondi che l'interfaccia si attivi, il che aiuta quando parte all'avvio del sistema, poi si ferma indicando il motivo e con il codice di uscita 2. Non continua su un'altra rete.
  • Se viene indicata solo una delle due opzioni, il client stampa --net and --ip must be given together; the default network is used. e continua senza vincolo.
  • Su Linux il client aggiunge regole di routing per l'indirizzo vincolato. Servono i privilegi di root, oppure sudo senza password per il comando ip.
MessaggioSignificato
Network interface '…' was not found. Run 'localtonet --network' to list the interfaces.Il nome dopo --net non corrisponde a nessuna interfaccia.
Network interface '…' is Down.L'interfaccia esiste ma non è attiva.
'…' is not an address of network interface '…'.L'indirizzo dopo --ip non appartiene a quell'interfaccia.
'…' is not an IP address.Il valore dopo --ip non è un indirizzo IP.

Per usare una connessione diversa per un solo tunnel invece che per l'intero client, imposta la stessa coppia nell'impostazione Argomenti di quel tunnel.

Proxy in uscita #

Usa queste opzioni quando il dispositivo può raggiungere internet solo tramite un proxy. Valgono per le connessioni del client verso Localtonet. Non cambiano il modo in cui il client raggiunge il tuo servizio locale.

--proxy #

ValoreCosa fa
Non indicato, oppure noneSi connette direttamente. Le variabili d'ambiente del proxy vengono ignorate.
envUsa le variabili d'ambiente del proxy descritte più sotto. Se nessuna è impostata, o una non è valida, il client si ferma con un errore invece di connettersi direttamente.
Un URL di proxyUsa quel proxy per tutto. Schemi supportati: http://, https://, socks5:// e socks5h://.
Bash
localtonet --authtoken <YOUR_TOKEN> --proxy http://proxy.example.com:3128
localtonet --authtoken <YOUR_TOKEN> --proxy socks5h://proxy.example.com:1080
localtonet --authtoken <YOUR_TOKEN> --proxy env
SchemaComportamentoPorta predefinitaAutenticazione
http://Proxy HTTP, tramite CONNECT.80Nessuna o Basic
https://Prima apre una connessione TLS verificata con il proxy, poi usa CONNECT.443Nessuna o Basic
socks5://SOCKS5, TCP e UDP. I nomi host vengono risolti sul tuo dispositivo.1080Nessuna oppure nome utente e password
socks5h://SOCKS5, TCP e UDP. I nomi host vengono risolti dal proxy.1080Nessuna oppure nome utente e password

L'host del proxy può essere un indirizzo IPv4, un nome host o un indirizzo IPv6 tra parentesi quadre. Le credenziali possono far parte dell'URL come user:password@host:port; codifica come URL i caratteri speciali al loro interno. L'output di debug non include mai le credenziali.

--proxy-user #

Bash
localtonet --authtoken <YOUR_TOKEN> --proxy socks5h://proxy.example.com:1080 --proxy-user <PROXY_USER>

Imposta il nome utente del proxy e chiede la password con un prompt nascosto (Proxy password:), così la password non resta sulla riga di comando. La password non viene salvata.

  • Richiede --proxy env o un URL di proxy e non può essere combinata con credenziali all'interno dell'URL.
  • Funziona solo in un terminale interattivo. La modalità headless e i servizi non chiedono mai nulla: inserisci le credenziali nell'URL del proxy, oppure usa --proxy env con un URL di proxy che le contenga.
  • --install-service rifiuta --proxy-user e gli URL di proxy con una password, perché un servizio non può memorizzarli. Installa il servizio con --proxy env e fornisci le variabili nell'ambiente del servizio.

Variabili d'ambiente del proxy #

Vengono lette solo con --proxy env. Per ogni tipo di connessione si usa la prima variabile impostata:

ConnessioneVariabili, in ordine
HTTP e WebSockethttp_proxy, HTTP_PROXY, all_proxy, ALL_PROXY
HTTPS e WebSocket sicurohttps_proxy, HTTPS_PROXY, all_proxy, ALL_PROXY
TCP e UDP grezziall_proxy, ALL_PROXY, https_proxy, HTTPS_PROXY, http_proxy, HTTP_PROXY

no_proxy (oppure NO_PROXY, se quella minuscola non è impostata) elenca gli host raggiunti direttamente:

  • Le voci sono separate da virgole. Un host o dominio corrisponde a sé stesso e ai suoi sottodomini. Il confronto ignora le maiuscole e un punto iniziale.
  • Gli indirizzi IP corrispondono esattamente; gli indirizzi IPv6 possono essere tra parentesi quadre. * esclude il proxy per ogni host.
  • Intervalli di indirizzi (CIDR), voci con una porta e caratteri jolly parziali non sono supportati e vengono segnalati come errore di configurazione.
  • no_proxy non ha alcun effetto quando passi un URL di proxy o ti connetti direttamente.

--http-transport #

Bash
localtonet --authtoken <YOUR_TOKEN> --proxy http://proxy.example.com:3128 --http-transport https

Controlla come il client trasporta le connessioni al server quando un proxy lascia passare solo il normale traffico web. Con il trasporto HTTPS il client invia quel traffico come normali richieste HTTPS a un gateway Localtonet, invece di aprire connessioni grezze di lunga durata attraverso il proxy.

ValoreCosa fa
auto (predefinito)Dietro un proxy HTTP o HTTPS, il client preferisce il trasporto HTTPS quando il server lo offre, altrimenti usa CONNECT. Dietro un proxy SOCKS5 usa prima TCP e UDP nativi e può ripiegare sul trasporto HTTPS attraverso lo stesso proxy.
httpsRichiede il trasporto HTTPS per le connessioni al server.
rawNon usa mai il trasporto HTTPS: solo CONNECT o SOCKS.

Qualsiasi altro valore ferma il client con LOCALTONET_HTTP_TRANSPORT_MODE must be auto, https or raw.

Terminale dispositivo #

Il Terminale dispositivo ti dà una shell sui tuoi dispositivi dalla dashboard o tramite SSH. Funziona su Windows, Linux e macOS e richiede Localtonet Desktop v8.6 o successiva. La pagina Terminale dispositivo descrive la funzione; queste sono le sue parti da riga di comando.

--terminal #

Bash
localtonet --terminal enable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>
localtonet --terminal disable --authtoken <YOUR_TOKEN>
ValoreCosa fa
enableAssocia questo dispositivo al tuo account. Il comando stampa un codice di approvazione e attende; apri I miei dispositivi, seleziona Aggiungi dispositivo e inserisci il codice. Il codice è valido per 15 minuti. Dopo l'approvazione il comando stampa Terminal enabled. Shells will run as <account>.
disableDisattiva il terminale su questo dispositivo e rimuove il dispositivo dal tuo account. Se la dashboard non è raggiungibile, il terminale viene comunque disattivato in locale e il comando ti chiede di rimuovere il dispositivo anche nella dashboard.
statusStampa se il terminale è attivo e con quale account vengono eseguite le shell.

Tutte e tre le forme richiedono un token, come un normale avvio: passa --authtoken, oppure omettilo per usare il token salvato. Se Localtonet è in esecuzione come servizio sul dispositivo, esegui il comando da un terminale Amministratore o con sudo. In un terminale interattivo, il client continua a funzionare come un normale client dopo enable, a meno che Localtonet non sia già in esecuzione sul dispositivo con questo token.

--terminal-user #

Bash
sudo localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT>

Sceglie l'account con cui vengono eseguite le shell, quando attivi il terminale come root o come amministratore. Senza questa opzione, un enable con privilegi elevati chiede Run shells as user:; in uno script, dove non si può chiedere nulla, si ferma con Choose the account for shells with --terminal-user. Senza --terminal-user, un comando senza privilegi elevati usa l'utente corrente.

--pairing-key #

Bash
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

Associa un dispositivo dove nessuno può leggere un codice di approvazione, per esempio un server configurato con uno script. Crea la chiave in I miei dispositivi sotto Aggiungi dispositivo con Crea chiave monouso. È valida per un'ora e può essere usata una sola volta. Con una chiave di associazione il comando non stampa un codice e non attende l'approvazione.

localtonet ssh #

Bash
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

Apre una shell su uno dei tuoi dispositivi, oppure esegue lì un solo comando e ne restituisce il codice di uscita. <DEVICE> è il nome del dispositivo mostrato in I miei dispositivi. ssh deve essere la prima parola dopo localtonet.

ParteCosa fa
-- <COMMAND>Esegue il comando invece di aprire una shell. Tutto ciò che segue -- è il comando.
--key <ACCESS_KEY>Una chiave di accesso del dispositivo, creata sotto Chiavi in I miei dispositivi. Con una chiave non serve alcuna approvazione nel browser.
--stdioNon apre una shell. Trasporta soltanto la connessione grezza verso il dispositivo tramite standard input e output, da usare come ProxyCommand di un client SSH.

Senza una chiave, il comando stampa Approve this connection in your browser: seguito da un link e attende fino a cinque minuti che tu approvi. Se la connessione non viene approvata, termina con The connection was not approved.

Diagnostica e informazioni #

--debug #

Bash
localtonet --debug --proxy env --authtoken <YOUR_TOKEN>

Attiva la diagnostica della connessione sullo standard error: le route del proxy in uso e da quale impostazione provengono, la modalità DNS, i risultati dell'handshake e lo stato UDP. Credenziali e corpi delle richieste sono omessi. --debug porta anche il client in modalità headless, quindi non fa richieste interattive. È un flag e non accetta alcun valore.

--version #

Bash
localtonet --version

Stampa la versione del client, per esempio v8.6, ed esce.

--help #

Bash
localtonet --help

Stampa la guida integrata ed esce. -h fa lo stesso.

Variabili d'ambiente #

VariabileEffetto
LOCALTONET_HEADLESS1 attiva la modalità headless.
LOCALTONET_AUTH_TOKENIl token, in modalità headless.
LOCALTONET_AUTH_TOKEN_FILEPercorso di un file del token, in modalità headless.
http_proxy, https_proxy, all_proxy, no_proxy e le loro forme maiuscoleImpostazioni del proxy, solo con --proxy env.

Codici di uscita #

CodiceSignificato
0Il comando è terminato normalmente.
1Un comando di Device Terminal è fallito, per esempio perché il codice di approvazione è scaduto o il dispositivo non era raggiungibile.
2Un'opzione è errata o manca del suo valore, il token headless non è utilizzabile oppure non è stato possibile applicare la coppia --net e --ip.

localtonet ssh <DEVICE> -- <COMMAND> restituisce il codice di uscita del comando remoto.

Esempi #

Primo avvio su un desktop
localtonet --authtoken <YOUR_TOKEN>
Servizio in background su Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>
sudo localtonet --status-service --authtoken <YOUR_TOKEN>
Docker, token dall'ambiente
docker run -d --restart unless-stopped -e LOCALTONET_AUTH_TOKEN=<YOUR_TOKEN> localtonet/localtonet
Usa il modem mobile per tutto
localtonet --network
localtonet --authtoken <YOUR_TOKEN> --net Mobile --ip 10.20.30.40
Dietro un proxy aziendale
export all_proxy=http://proxy.example.com:3128
localtonet --authtoken <YOUR_TOKEN> --proxy env
Supporto