Esegui Localtonet come servizio
In questa pagina 8 sezioni
Installa il client Localtonet come servizio in background, così parte con il dispositivo, continua a funzionare dopo la disconnessione e non richiede un terminale aperto. Un solo comando lo registra tra i servizi di Windows, in launchd su macOS o in systemd su Linux.
Prima di iniziare #
- Il client da console è installato sul dispositivo: Windows, macOS o Linux.
- Un AuthToken per questo dispositivo da I miei token.
- Privilegi di amministratore: un terminale aperto con Esegui come amministratore su Windows,
sudosu macOS e Linux. - Su Linux, una distribuzione che usa systemd. Termux non è supportato; lì usa l'app Android.
L'hai installato da un pacchetto DEB o RPM, su OpenWrt o in Docker? Hanno un proprio modo di partire all'avvio. Vedi Pacchetti DEB e RPM, OpenWrt e Docker invece di questa pagina.
Installa il servizio #
Esegui il client una volta con --install-service e il tuo token. Sostituisci <YOUR_TOKEN> con il tuo AuthToken. Metti sempre --authtoken in questo comando: il servizio si connette con il token con cui lo installi.
Windows #
Apri il Prompt dei comandi o PowerShell come amministratore nella cartella che contiene localtonet, poi esegui:
localtonet --install-service --authtoken <YOUR_TOKEN>Il client crea un servizio di Windows con avvio automatico e lo avvia. Il servizio è visibile in services.msc con la descrizione Localtonet Service. Se il servizio fallisce, Windows lo riavvia dopo un minuto.
macOS
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Il client scrive un job di launchd in /Library/LaunchDaemons/<SERVICE_NAME>.plist, lo carica e lo avvia. Il job parte all'avvio del sistema, e launchd lo riavvia se termina con un errore.
Linux
sudo localtonet --install-service --authtoken <YOUR_TOKEN>Il client scrive un'unit di systemd in /etc/systemd/system/<SERVICE_NAME>.service, la abilita e la avvia. L'unit parte all'avvio del sistema, e systemd la riavvia cinque secondi dopo un errore.
Se sudo non trova localtonet, eseguilo con il suo percorso, per esempio sudo ./localtonet dalla cartella che lo contiene.
In caso di successo il client stampa il nome del servizio:
[CLI] Installed service 'Localtonet_AbCdEfGhI'L'installazione avvia anche il servizio, quindi non serve un comando di avvio separato. Ora puoi creare e avviare i tunnel per questo token nella dashboard.
Il nome del servizio #
Il servizio si chiama Localtonet_ seguito dai primi nove caratteri del token, per esempio Localtonet_AbCdEfGhI. Questa pagina lo indica con <SERVICE_NAME>. Poiché il nome deriva dal token, puoi installare un servizio per ogni token sullo stesso dispositivo, e ogni comando di gestione ha bisogno dello stesso token per trovare il suo servizio.
Cosa esegue il servizio #
Il servizio avvia lo stesso file localtonet dalla stessa posizione, con le opzioni che hai indicato nel comando di installazione. Ne conseguono due cose:
- Non spostare né eliminare il file. La definizione del servizio contiene il suo percorso completo. Su Linux, se il file si trova dentro
/root, il programma di installazione lo copia in/usr/local/lib/<SERVICE_NAME>/e il servizio esegue quella copia. - Le altre opzioni vengono mantenute. Opzioni come
--nete--ipoppure--proxy envnel comando di installazione vengono memorizzate nel servizio e usate a ogni avvio. Vedi il Riferimento CLI.
Gestisci il servizio #
Usa lo stesso token con una di queste opzioni. Su macOS e Linux, metti sudo davanti. Su Windows, usa un terminale come amministratore per tutto tranne lo stato.
| Comando | Cosa fa | Output in caso di successo |
|---|---|---|
localtonet --status-service --authtoken <YOUR_TOKEN> | Mostra lo stato del servizio. | [CLI] Service '<SERVICE_NAME>' status: Running |
localtonet --stop-service --authtoken <YOUR_TOKEN> | Ferma il servizio. I suoi tunnel vanno offline. Riparte al successivo avvio del sistema. | [CLI] Stopped service '<SERVICE_NAME>'. |
localtonet --start-service --authtoken <YOUR_TOKEN> | Avvia un servizio fermo. | [CLI] Started service '<SERVICE_NAME>'. |
localtonet --remove-service --authtoken <YOUR_TOKEN> | Ferma il servizio e ne rimuove la registrazione. Il file localtonet in sé resta. | [CLI] Removed service '<SERVICE_NAME>'. |
Lo stato è uno di questi valori:
| Stato | Significato |
|---|---|
Running | Il servizio è in esecuzione. |
Stopped | Il servizio è installato ma non è in esecuzione. |
Installing | Il servizio si sta avviando. |
NotFound | Non è installato alcun servizio per questo token. |
Paused | Solo Windows: il servizio è stato messo in pausa. |
Error | Il servizio è fallito, oppure non è stato possibile leggerne lo stato. |
Unknown | Il gestore dei servizi ha restituito uno stato che il client non riconosce. |
Puoi anche usare gli strumenti del sistema operativo con il nome del servizio:
Windows #
Apri services.msc e trova <SERVICE_NAME>, oppure usa sc in un terminale come amministratore:
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>macOS
sudo launchctl print system/<SERVICE_NAME>Linux
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>Dove è registrato il servizio e dove si trovano i suoi log #
| Sistema | Registrazione | Log |
|---|---|---|
| Windows | Un servizio di Windows di nome <SERVICE_NAME>, tipo di avvio automatico, eseguito con l'account LocalSystem. | Il servizio non ha una finestra di console e il programma di installazione non configura alcun file di log. Controlla lo stato del servizio, il dispositivo e i suoi tunnel nella dashboard. |
| macOS | /Library/LaunchDaemons/<SERVICE_NAME>.plist, un job di launchd valido per tutto il sistema. | /var/log/<SERVICE_NAME>.out.log e /var/log/<SERVICE_NAME>.err.log |
| Linux | /etc/systemd/system/<SERVICE_NAME>.service, abilitato per multi-user.target. | Il journal di systemd: journalctl -u <SERVICE_NAME> -f |
Il servizio non stampa la tabella dei tunnel che il client mostra in un terminale. Per lo stato del tuo dispositivo e dei suoi tunnel, usa la dashboard.
Cambia il token #
Per cambiare il token di un dispositivo, rimuovi il servizio con il vecchio token e installalo di nuovo con quello nuovo:
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>Da sapere #
- Un client per token. Finché il servizio è in esecuzione, non avviare un altro client Localtonet con lo stesso token, su questo dispositivo o su un altro. Un secondo client che si connette con un token disconnette il primo.
- Aggiornare il client. Il servizio continua a eseguire il file a cui punta la sua definizione. Ferma il servizio, sostituisci quel file con la nuova versione e avvia di nuovo il servizio.
- Le password del proxy non vengono memorizzate. Il comando di installazione rifiuta un URL di proxy che contiene una password e l'opzione
--proxy-user. Installa con--proxy enve imposta le variabili del proxy nell'ambiente del servizio. - Terminale dispositivo. Se il dispositivo esegue Localtonet come servizio, esegui
localtonet --terminal enableda un terminale come amministratore o consudo, in modo che il servizio possa usarne il risultato. Vedi Terminale dispositivo.
Risoluzione dei problemi #
| Messaggio | Causa e soluzione |
|---|---|
[CLI] Install failed: '…' requires elevated (admin/root) privileges. | Il comando è stato eseguito senza privilegi di amministratore. Apri il terminale come amministratore su Windows, oppure usa sudo su macOS e Linux. Su Windows e Linux lo stesso messaggio compare per avvio, arresto e rimozione. |
[CLI] Install failed: seguito da Service '<SERVICE_NAME>' already exists. (Windows), Systemd unit already exists for … (Linux) o Plist already exists for … (macOS) | Un servizio per questo token è già installato. Usa --start-service per avviarlo, oppure prima --remove-service se vuoi installarlo di nuovo. |
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment. | Il comando di installazione conteneva --proxy-user o un URL di proxy con una password. Usa invece --proxy env. |
[CLI] Start failed: … su Windows subito dopo l'installazione | Il servizio è già in esecuzione, perché l'installazione lo avvia. Controlla con --status-service. |
Lo stato è NotFound | Non esiste alcun servizio per il token che hai passato. Controlla che sia il token con cui hai installato il servizio. |
Lo stato è Running ma il dispositivo risulta offline nella dashboard | Controlla il token: copialo di nuovo da I miei token, rimuovi il servizio e installalo di nuovo. Assicurati anche che nessun altro client usi lo stesso token. |