Vai al contenuto
Localtonet Localtonet Dashboard

Installa Localtonet da un pacchetto DEB o RPM

Aiuto su questa pagina
In questa pagina 9 sezioni
  1. Prima di iniziare
  2. Cosa installa il pacchetto
  3. Procedura
  4. Scarica e installa il pacchetto
  5. Imposta il tuo AuthToken
  6. Controlla la configurazione
  7. Abilita un servizio
  8. Avvia un tunnel
  9. Servizio tunnel o servizio VPN
  10. Come girano i servizi
  11. Leggi il log
  12. Aggiornamento
  13. Rimozione
  14. Risoluzione dei problemi
  15. Pagine correlate

I pacchetti DEB e RPM installano il client Localtonet insieme a due servizi systemd, uno per i tunnel e uno per tunnel più VPN. I servizi leggono il tuo AuthToken da un file e funzionano senza terminale, quindi il client si avvia a ogni avvio del sistema.

Prima di iniziare #

  • Un sistema Linux a 64 bit: i pacchetti esistono per x64 e ARM64.
  • systemd 247 o successivo e OpenSSL 3, come in Debian 12, Ubuntu 22.04+ o RHEL 9.
  • Accesso root (sudo).
  • Il tuo AuthToken. Seleziona Copia sulla scheda AuthToken della Dashboard, oppure copia un token da I miei token.

Su altre distribuzioni, su ARM a 32 bit, o quando non vuoi un pacchetto di sistema, usa lo script di installazione o gli archivi descritti in Linux.

Cosa installa il pacchetto #

PercorsoCos'è
/usr/bin/localtonetIl comando localtonet.
/usr/lib/localtonet/Il client vero e proprio.
/usr/lib/systemd/system/localtonet.serviceIl servizio per i tunnel.
/usr/lib/systemd/system/localtonet-vpn.serviceIl servizio per VPN e tunnel.
/etc/localtonet/auth-tokenIl file del token. Solo root può leggerlo. Viene installato con il segnaposto DUMMY_AUTH_TOKEN.

Il pacchetto si chiama localtonet. Le sue dipendenze, tra cui OpenSSL 3, iproute2 (iproute nell'RPM), iptables e kmod, vengono installate dal tuo gestore di pacchetti. L'installazione del pacchetto non abilita né avvia nessun servizio: prima imposti il token, poi abiliti il servizio che ti serve.

Procedura #

  1. Scarica e installa il pacchetto #

    Scegli il pacchetto per la tua distribuzione e la tua CPU dall'elenco in fondo a questa pagina, poi installa il file scaricato con apt (DEB) o dnf (RPM). Istruzioni di configurazione sotto ogni pacchetto mostra i comandi esatti per quel file.

  2. Imposta il tuo AuthToken #

    Modifica /etc/localtonet/auth-token come root con un editor di testo e sostituisci DUMMY_AUTH_TOKEN con il tuo token su un'unica riga. Poi assicurati che solo root possa leggere il file:

    Terminale
    sudo chmod 600 /etc/localtonet/auth-token
  3. Controlla la configurazione #

    Terminale
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    Il controllo legge il file del token senza connettersi. Risponde Localtonet headless configuration OK. quando il file contiene un token di 33 caratteri senza spazi. Non chiede ai server Localtonet se il token è valido per il tuo account.

  4. Abilita un servizio #

    Per i tunnel, abilita il servizio per i tunnel e leggi il suo log:

    Terminale
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Se questo dispositivo fa parte anche di una rete VPN, abilita invece il servizio VPN. Vedi Servizio tunnel o servizio VPN.

  5. Avvia un tunnel #

    Il token ora risulta Online in I miei token. Crea e avvia un tunnel per esso nella dashboard, vedi Guida rapida.

Servizio tunnel o servizio VPN #

Entrambi i servizi eseguono lo stesso client ed entrambi servono i tuoi tunnel. Si differenziano per i diritti con cui girano. Abilitane uno solo: i due servizi sono in conflitto e avviarne uno ferma l'altro.

localtonet.servicelocaltonet-vpn.service
Da usare perTunnelVPN e tunnel
Eseguito comeUn utente senza privilegi che systemd crea per il servizioroot, limitato alle capacità di rete CAP_NET_ADMIN e CAP_NET_RAW
Modulo TUNNon usatoCaricato con modprobe tun prima dell'avvio del client
Directory di lavoro/var/lib/localtonet/var/lib/localtonet-vpn

Per far passare un dispositivo dal servizio tunnel al servizio VPN:

Terminale
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

Per tornare indietro, disabilita localtonet-vpn.service e abilita localtonet.service allo stesso modo. Le reti VPN si configurano nella dashboard, vedi Gestore VPN.

Come girano i servizi #

ComportamentoDettagli
Modalità headlessEntrambi i servizi avviano localtonet --headless. In questa modalità il client non chiede mai nulla e non salva il token nelle proprie impostazioni.
Tokensystemd passa /etc/localtonet/auth-token al servizio. Un servizio non si avvia finché il file manca.
Avvio all'accensioneUn servizio abilitato si avvia dopo che la rete è attiva.
Riavviosystemd riavvia il client dieci secondi dopo un errore. Non lo riavvia quando il client si ferma a causa di un file del token non valido. Correggi il file e riavvia tu il servizio.

Leggi il log #

In modalità headless il client scrive nel journal righe semplici, una per ogni cambiamento:

Terminale
sudo journalctl -u localtonet.service -f
RigaSignificato
Connection: ConnectedLo stato della sessione. Gli altri valori sono Connecting e Disconnected.
AuthTokenName: …Il nome del token con cui il client ha effettuato l'accesso.
OPEN …, ADDED …Un tunnel in esecuzione su questo dispositivo, con il suo indirizzo pubblico, il protocollo e la destinazione locale.
STATUS …Un tunnel ha cambiato stato.
CLOSED …Un tunnel è stato fermato o rimosso.
Authentication failed: AuthToken was rejected.Il token nel file non è accettato. Copialo di nuovo da I miei token.

Se una di queste righe dovesse contenere il token, il client scrive al suo posto [redacted].

Aggiornamento #

Scarica il nuovo pacchetto e installalo come la prima volta, poi riavvia il servizio che usi. Il tuo file del token viene conservato.

Servizio tunnel
sudo systemctl restart localtonet
Servizio VPN
sudo systemctl restart localtonet-vpn.service

In I miei token, la colonna Client mostra la versione che il dispositivo ha segnalato per ultima e un badge Aggiornamento necessario quando ne è disponibile una più recente.

Rimozione #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

Rimuovere il pacchetto ferma e disabilita entrambi i servizi. Il file del token è un file di configurazione e i gestori di pacchetti li trattano con cautela: dopo la rimozione, controlla se /etc/localtonet/auth-token o una sua copia salvata è ancora presente e cancellalo se non vuoi che il token resti sulla macchina.

Risoluzione dei problemi #

Invalid Localtonet headless configuration. Check the token file or environment settings.

Il file del token non è utilizzabile. Controlla che /etc/localtonet/auth-token esista, che il segnaposto DUMMY_AUTH_TOKEN non ci sia più e che il file contenga solo il token di 33 caratteri, senza spazi e su un'unica riga. Esegui il controllo con sudo, perché solo root può leggere il file.

Il servizio è abilitato ma non è in esecuzione

Esegui systemctl status localtonet.service. Un servizio non si avvia finché /etc/localtonet/auth-token manca e non viene riavviato dopo che si è fermato per un file del token non valido. Correggi il file, esegui il controllo della configurazione, poi esegui sudo systemctl restart localtonet.service.

Il log riporta: Authentication failed: AuthToken was rejected.

Il file ha il formato corretto ma il token non è accettato. Copia di nuovo il token da I miei token, salvalo nel file del token e riavvia il servizio.

Il servizio tunnel si è fermato quando ho avviato il servizio VPN

È previsto. I due servizi sono in conflitto, quindi systemd ferma uno quando l'altro si avvia. Il servizio VPN serve anche i tuoi tunnel.

Il pacchetto non si installa sulla mia distribuzione

I pacchetti richiedono systemd 247 o successivo e OpenSSL 3. Sulle versioni più vecchie il gestore di pacchetti non riesce a soddisfare queste dipendenze. Usa invece lo script di installazione o un archivio dalla pagina Linux.

I pacchetti sono elencati qui sotto. Seleziona Istruzioni di configurazione sotto un pacchetto per i comandi con il suo nome file.

Pacchetti Linux

Pacchetti DEB e RPM installabili per x64 e ARM64. Richiedono systemd 247 o successivo e OpenSSL 3, come Debian 12, Ubuntu 22.04+ o RHEL 9.

  • Debian / Ubuntu · x64
    Istruzioni di configurazione

    1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene localtonet-linux-x64.deb.

    sudo apt install ./localtonet-linux-x64.deb

    2. Imposta il tuo AuthToken. Modifica /etc/localtonet/auth-token come root e sostituisci DUMMY_AUTH_TOKEN con il tuo token su una sola riga. Poi proteggi il file e controlla la configurazione:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Avvia il servizio. Quando il controllo della configurazione riesce:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Per la VPN, passa al servizio VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Per gli aggiornamenti, installa il nuovo pacchetto ed esegui sudo systemctl restart localtonet. La tua configurazione viene mantenuta.

    Se usi la VPN, riavvia invece localtonet-vpn.service.

  • Debian / Ubuntu · ARM64
    Istruzioni di configurazione

    1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene localtonet-linux-arm64.deb.

    sudo apt install ./localtonet-linux-arm64.deb

    2. Imposta il tuo AuthToken. Modifica /etc/localtonet/auth-token come root e sostituisci DUMMY_AUTH_TOKEN con il tuo token su una sola riga. Poi proteggi il file e controlla la configurazione:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Avvia il servizio. Quando il controllo della configurazione riesce:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Per la VPN, passa al servizio VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Per gli aggiornamenti, installa il nuovo pacchetto ed esegui sudo systemctl restart localtonet. La tua configurazione viene mantenuta.

    Se usi la VPN, riavvia invece localtonet-vpn.service.

  • Fedora / RHEL · x64
    Istruzioni di configurazione

    1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene localtonet-linux-x64.rpm.

    sudo dnf install ./localtonet-linux-x64.rpm

    2. Imposta il tuo AuthToken. Modifica /etc/localtonet/auth-token come root e sostituisci DUMMY_AUTH_TOKEN con il tuo token su una sola riga. Poi proteggi il file e controlla la configurazione:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Avvia il servizio. Quando il controllo della configurazione riesce:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Per la VPN, passa al servizio VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Per gli aggiornamenti, installa il nuovo pacchetto ed esegui sudo systemctl restart localtonet. La tua configurazione viene mantenuta.

    Se usi la VPN, riavvia invece localtonet-vpn.service.

  • Fedora / RHEL · ARM64
    Istruzioni di configurazione

    1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene localtonet-linux-arm64.rpm.

    sudo dnf install ./localtonet-linux-arm64.rpm

    2. Imposta il tuo AuthToken. Modifica /etc/localtonet/auth-token come root e sostituisci DUMMY_AUTH_TOKEN con il tuo token su una sola riga. Poi proteggi il file e controlla la configurazione:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Avvia il servizio. Quando il controllo della configurazione riesce:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    Per la VPN, passa al servizio VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    Per gli aggiornamenti, installa il nuovo pacchetto ed esegui sudo systemctl restart localtonet. La tua configurazione viene mantenuta.

    Se usi la VPN, riavvia invece localtonet-vpn.service.

Supporto