Vai al contenuto
Localtonet Localtonet Dashboard

Esegui Localtonet come servizio

Aiuto su questa pagina
In questa pagina 8 sezioni
  1. Prima di iniziare
  2. Installa il servizio
  3. Windows
  4. Il nome del servizio
  5. Cosa esegue il servizio
  6. Gestisci il servizio
  7. Windows
  8. Dove è registrato il servizio e dove si trovano i suoi log
  9. Cambia il token
  10. Da sapere
  11. Risoluzione dei problemi
  12. Pagine correlate

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, sudo su 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:

Prompt dei comandi o PowerShell (amministratore)
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

Bash
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

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

Output
[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 --net e --ip oppure --proxy env nel 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.

ComandoCosa faOutput 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:

StatoSignificato
RunningIl servizio è in esecuzione.
StoppedIl servizio è installato ma non è in esecuzione.
InstallingIl servizio si sta avviando.
NotFoundNon è installato alcun servizio per questo token.
PausedSolo Windows: il servizio è stato messo in pausa.
ErrorIl servizio è fallito, oppure non è stato possibile leggerne lo stato.
UnknownIl 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:

Prompt dei comandi (amministratore)
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>

macOS

Bash
sudo launchctl print system/<SERVICE_NAME>

Linux

Bash
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>

Dove è registrato il servizio e dove si trovano i suoi log #

SistemaRegistrazioneLog
WindowsUn 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:

Bash
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 env e imposta le variabili del proxy nell'ambiente del servizio.
  • Terminale dispositivo. Se il dispositivo esegue Localtonet come servizio, esegui localtonet --terminal enable da un terminale come amministratore o con sudo, in modo che il servizio possa usarne il risultato. Vedi Terminale dispositivo.

Risoluzione dei problemi #

MessaggioCausa 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'installazioneIl servizio è già in esecuzione, perché l'installazione lo avvia. Controlla con --status-service.
Lo stato è NotFoundNon 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 dashboardControlla 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.
Supporto