Installa Localtonet da un pacchetto DEB o RPM
In questa pagina 9 sezioni
- Prima di iniziare
- Cosa installa il pacchetto
- Procedura
- Scarica e installa il pacchetto
- Imposta il tuo AuthToken
- Controlla la configurazione
- Abilita un servizio
- Avvia un tunnel
- Servizio tunnel o servizio VPN
- Come girano i servizi
- Leggi il log
- Aggiornamento
- Rimozione
- Risoluzione dei problemi
- 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 #
| Percorso | Cos'è |
|---|---|
/usr/bin/localtonet | Il comando localtonet. |
/usr/lib/localtonet/ | Il client vero e proprio. |
/usr/lib/systemd/system/localtonet.service | Il servizio per i tunnel. |
/usr/lib/systemd/system/localtonet-vpn.service | Il servizio per VPN e tunnel. |
/etc/localtonet/auth-token | Il 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 #
-
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) odnf(RPM). Istruzioni di configurazione sotto ogni pacchetto mostra i comandi esatti per quel file. -
Imposta il tuo AuthToken #
Modifica
/etc/localtonet/auth-tokencome root con un editor di testo e sostituisciDUMMY_AUTH_TOKENcon il tuo token su un'unica riga. Poi assicurati che solo root possa leggere il file:Terminalesudo chmod 600 /etc/localtonet/auth-token -
Controlla la configurazione #
Terminalesudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configIl 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. -
Abilita un servizio #
Per i tunnel, abilita il servizio per i tunnel e leggi il suo log:
Terminalesudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceSe questo dispositivo fa parte anche di una rete VPN, abilita invece il servizio VPN. Vedi Servizio tunnel o servizio VPN.
-
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.service | localtonet-vpn.service | |
|---|---|---|
| Da usare per | Tunnel | VPN e tunnel |
| Eseguito come | Un utente senza privilegi che systemd crea per il servizio | root, limitato alle capacità di rete CAP_NET_ADMIN e CAP_NET_RAW |
| Modulo TUN | Non usato | Caricato 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:
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.servicePer 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 #
| Comportamento | Dettagli |
|---|---|
| Modalità headless | Entrambi i servizi avviano localtonet --headless. In questa modalità il client non chiede mai nulla e non salva il token nelle proprie impostazioni. |
| Token | systemd passa /etc/localtonet/auth-token al servizio. Un servizio non si avvia finché il file manca. |
| Avvio all'accensione | Un servizio abilitato si avvia dopo che la rete è attiva. |
| Riavvio | systemd 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:
sudo journalctl -u localtonet.service -f| Riga | Significato |
|---|---|
Connection: Connected | Lo 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.
sudo systemctl restart localtonetsudo systemctl restart localtonet-vpn.serviceIn 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 #
sudo apt remove localtonetsudo dnf remove localtonetRimuovere 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.
Pagine correlate #
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.deb2. Imposta il tuo AuthToken. Modifica
/etc/localtonet/auth-tokencome root e sostituisciDUMMY_AUTH_TOKENcon 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-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePer 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.servicePer 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.deb2. Imposta il tuo AuthToken. Modifica
/etc/localtonet/auth-tokencome root e sostituisciDUMMY_AUTH_TOKENcon 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-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePer 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.servicePer 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.rpm2. Imposta il tuo AuthToken. Modifica
/etc/localtonet/auth-tokencome root e sostituisciDUMMY_AUTH_TOKENcon 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-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePer 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.servicePer 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.rpm2. Imposta il tuo AuthToken. Modifica
/etc/localtonet/auth-tokencome root e sostituisciDUMMY_AUTH_TOKENcon 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-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
sudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.servicePer 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.servicePer 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.