Installa Localtonet su OpenWrt
Sperimentale OpenWrt 24.10 e 25.12+ x64 e ARM64
In questa pagina 12 sezioni
- Prima di iniziare
- Versioni e architetture supportate
- Cosa non è supportato
- Controlla l'architettura
- OpenWrt 24.10 (opkg)
- Archiviazione e memoria
- Cosa installa il pacchetto
- File del token e configurazione
- Il file del token
- La configurazione UCI
- Il servizio
- Log
- Aggiornamento e rimozione
- OpenWrt 24.10 (opkg)
- VPN su OpenWrt
- Risoluzione dei problemi
- Pagine correlate
Esegui il client Localtonet direttamente su un router OpenWrt. Il pacchetto installa il client, un file del token, una configurazione UCI e un servizio che parte insieme al router.
I pacchetti OpenWrt sono sperimentali. Sono file non firmati che installi a mano, non pacchetti di un feed OpenWrt firmato. Verifica la compatibilità del firmware, i tuoi tunnel e la VPN sul tuo dispositivo prima di farci affidamento.
Prima di iniziare #
- Un router con una versione di OpenWrt e un'architettura CPU supportate (vedi la sezione successiva).
- Accesso root al router tramite SSH.
- Accesso a internet sul router durante l'installazione. Il gestore pacchetti scarica le dipendenze dai feed di pacchetti del tuo firmware.
- Spazio di archiviazione e memoria liberi a sufficienza (vedi Archiviazione e memoria).
- Un AuthToken di I miei token che nessun altro dispositivo usa.
Versioni e architetture supportate #
OpenWrt ha cambiato il proprio gestore pacchetti tra una release e l'altra, quindi esistono due formati di pacchetto. Scegli quello per il tuo firmware:
| Versione di OpenWrt | Formato del pacchetto | Gestore pacchetti | Architetture |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 e successive | APK v3 | apk | x64, ARM64 |
Qui APK indica un pacchetto OpenWrt. Questi file .apk non sono app Android e non si possono installare su un telefono. Per Android, vedi Android.
Cosa non è supportato #
- Router MIPS, MIPSEL e ARMv7. Per queste architetture non esistono pacchetti.
- L'installazione da un feed di pacchetti. I pacchetti sono file locali; il tuo router non li trova né li aggiorna tramite
opkg updateoapk update. - Forzare un pacchetto su un'architettura diversa. Non aggirare mai il controllo dell'architettura del gestore pacchetti.
Controlla l'architettura #
L'architettura del pacchetto deve corrispondere al tuo firmware. Chiedi al router quali architetture accetta:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archUn router x64 riporta x86_64. I router ARM64 riportano un nome che inizia con aarch64_, e quel nome cambia tra le build del firmware. Ogni pacchetto è accompagnato da un breve file di istruzioni che indica l'architettura esatta per cui è stato compilato, ad esempio x86_64 o aarch64_generic. Nella pagina Download scegli il tuo pacchetto sotto OpenWrt e apri Istruzioni di configurazione del pacchetto per leggerla. Confronta quell'architettura con quella riportata dal router. Se non corrispondono, non installare il pacchetto.
Archiviazione e memoria #
Il pacchetto contiene il client insieme al proprio runtime, quindi è molto più grande di un tipico pacchetto OpenWrt. Controlla il router prima di installare:
df -h
free- Flash (overlay). I file del programma vengono installati in
/usr/lib/localtonet. Un router con un chip flash piccolo può richiedere extroot (archiviazione esterna come overlay root) per contenerli. - RAM e
/tmp. All'avvio il client estrae le sue librerie native in/tmp/localtonet/bundle. Su OpenWrt/tmprisiede nella RAM, quindi questo spazio viene sottratto alla memoria del router.
Cosa installa il pacchetto #
| Percorso | Cos'è |
|---|---|
/usr/bin/localtonet | Il comando localtonet. |
/usr/lib/localtonet | I file del programma. |
/etc/localtonet/auth-token | Il file del token. Contiene il segnaposto DUMMY_AUTH_TOKEN finché non lo sostituisci. Leggibile solo da root. |
/etc/config/localtonet | La configurazione UCI del servizio. |
/etc/init.d/localtonet | Lo script del servizio (procd). |
Il pacchetto dipende da libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft e ip6tables-nft. Il gestore pacchetti installa quelli mancanti dai feed del tuo firmware, ed è per questo che le istruzioni di configurazione aggiornano prima gli elenchi dei pacchetti. kmod-tun deve corrispondere al kernel del firmware installato, quindi prendilo sempre dai feed di quel firmware.
File del token e configurazione #
Installare il pacchetto non connette nulla. Il servizio resta spento finché non hai fatto due cose: inserire il tuo token nel file del token e abilitare il servizio in UCI. I comandi esatti per il tuo pacchetto si trovano nelle sue Istruzioni di configurazione alla fine di questa pagina; questa sezione spiega cosa fanno.
Il file del token #
/etc/localtonet/auth-token contiene il tuo AuthToken su una sola riga e nient'altro. Sostituisci il segnaposto DUMMY_AUTH_TOKEN con il tuo token, ad esempio con vi. Mantieni il file leggibile solo da root (modalità 600).
Le istruzioni di configurazione eseguono poi il client una volta con --headless --authtoken-file /etc/localtonet/auth-token --check-config. Questo controlla il file senza connettersi a Localtonet:
| Output | Significato |
|---|---|
Localtonet headless configuration OK. | Il file contiene un token ben formato: 33 caratteri, senza spazi. Il controllo non dimostra che il token sia valido per il tuo account. |
Invalid Localtonet headless configuration. Check the token file or environment settings. | Il file manca, contiene ancora il segnaposto oppure il token non è lungo 33 caratteri. |
La configurazione UCI #
Il servizio legge le sue impostazioni da /etc/config/localtonet. Un'installazione nuova contiene:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Opzione | Cosa fa | Valori |
|---|---|---|
enabled | Indica se il servizio avvia il client. Finché vale 0, avviare il servizio non fa nulla. | 0 (predefinito) o 1 |
token_file | Percorso del file da cui il client legge il token. | Predefinito /etc/localtonet/auth-token |
Mostra i valori correnti in qualsiasi momento:
uci show localtonetIl servizio #
Il client viene eseguito come servizio procd chiamato localtonet. L'installazione del pacchetto lo registra per l'avvio al boot, ma avvia il client solo quando enabled vale 1 e il file del token non è vuoto. Dopo aver impostato enabled a 1 e confermato la modifica, riavvia il servizio una volta; da quel momento parte insieme al router.
| Comando | Cosa fa |
|---|---|
/etc/init.d/localtonet restart | Ferma e riavvia il client. Eseguilo dopo aver modificato il file del token o la configurazione. |
/etc/init.d/localtonet stop | Ferma il client fino al prossimo riavvio del servizio o del router. |
/etc/init.d/localtonet disable | Smette di avviare il servizio al boot. |
/etc/init.d/localtonet enable | Riprende ad avviare il servizio al boot. |
Per spegnere il client ma lasciare il pacchetto installato:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartSe il client si ferma in modo imprevisto, procd lo riavvia.
Quando il client è connesso, crea e avvia i tunnel nella dashboard con il token del router. L'Indirizzo IP locale di un tunnel può essere 127.0.0.1 per un servizio sul router stesso, oppure l'indirizzo LAN di qualsiasi dispositivo dietro il router, ad esempio 192.168.1.20.
Log #
Il client scrive nel log di sistema di OpenWrt. Mostra le sue righe, oppure seguile in tempo reale:
logread -e localtonet
logread -f -e localtonet| Riga | Significato |
|---|---|
Localtonet - headless log | Il client è stato avviato. |
Connection: … | Lo stato della connessione a Localtonet. |
AuthTokenName: … | Il nome del token con cui il router ha effettuato l'accesso. |
OPEN …, ADDED …, STATUS …, CLOSED … | Un tunnel di questo token è stato trovato, aggiunto, ha cambiato stato o è stato rimosso. |
Authentication failed: AuthToken was rejected. | Localtonet non ha accettato il token nel file del token. |
AuthToken file missing | Il servizio è abilitato, ma il file del token non esiste o è vuoto. |
Aggiornamento e rimozione #
Per aggiornare, installa il pacchetto più recente sopra quello vecchio e riavvia il servizio. Il file del token e la configurazione UCI vengono mantenuti. Entrambi i file sono anche nell'elenco dei file che OpenWrt conserva durante un aggiornamento del firmware, ma il pacchetto stesso va installato di nuovo dopo aver flashato il nuovo firmware.
Per rimuovere il client:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetRimuovere il pacchetto ferma il servizio e lo toglie dalla sequenza di avvio.
VPN su OpenWrt #
Il pacchetto installa ciò di cui la funzione VPN ha bisogno sul router: kmod-tun, ip-full, bash, iptables-nft e ip6tables-nft. Il comportamento di routing e firewall dipende dal tuo firmware e dalle tue regole firewall, quindi prova la VPN sul tuo dispositivo prima di farci affidamento. Per la funzione in sé vedi Gestore VPN.
Risoluzione dei problemi #
Il gestore pacchetti rifiuta il pacchetto a causa dell'architettura
Il pacchetto è stato compilato per un'architettura diversa da quella del tuo firmware. Confronta l'output di opkg print-architecture o apk --print-arch con l'architettura indicata nel file di istruzioni del pacchetto (Istruzioni di configurazione del pacchetto nella pagina Download). Non forzare l'installazione. I router MIPS, MIPSEL e ARMv7 non sono supportati.
apk rifiuta di installare il file perché non attendibile
I pacchetti APK sono file locali non firmati. Per installarne uno serve l'opzione --allow-untrusted, come mostrato nelle istruzioni di configurazione del pacchetto.
L'installazione fallisce perché non si trova una dipendenza
Aggiorna prima gli elenchi dei pacchetti (opkg update o apk update) e assicurati che il router abbia accesso a internet. Le dipendenze provengono dai feed del tuo firmware.
Il servizio è abilitato ma nel log non compare nulla
Controlla uci show localtonet. Se enabled vale ancora 0, impostalo a 1, conferma la modifica e riavvia il servizio. Se il log mostra AuthToken file missing, inserisci il tuo token nel file indicato da token_file.
Il client non parte oppure il router esaurisce la memoria
Controlla lo spazio flash libero e la memoria con df -h e free. Il client ha bisogno di spazio sotto /usr/lib/localtonet e in /tmp.
Pagine correlate #
OpenWrt
Sperimentale. Scegli IPK per OpenWrt 24.10 o APK v3 per 25.12+. Questi file APK sono pacchetti OpenWrt, non app Android.
Solo x64 e ARM64. L'architettura del pacchetto deve corrispondere al tuo firmware; consulta le istruzioni di configurazione del pacchetto e opkg print-architecture o apk --print-arch. MIPS, MIPSEL e ARMv7 non sono supportati da questi pacchetti. Verifica lo spazio di archiviazione e la RAM disponibili prima dell'installazione.
-
OpenWrt 24.10 · x64 · IPK
Istruzioni di configurazione
1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene
localtonet-openwrt-24.10-x64.ipk.Esegui questi comandi sul router come root. Prima dell'installazione, verifica che l'architettura del pacchetto corrisponda al tuo firmware.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPer gli aggiornamenti, installa il nuovo pacchetto ed esegui
/etc/init.d/localtonet restart. La tua configurazione viene mantenuta. -
OpenWrt 24.10 · ARM64 · IPK
Istruzioni di configurazione
1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene
localtonet-openwrt-24.10-arm64.ipk.Esegui questi comandi sul router come root. Prima dell'installazione, verifica che l'architettura del pacchetto corrisponda al tuo firmware.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPer gli aggiornamenti, installa il nuovo pacchetto ed esegui
/etc/init.d/localtonet restart. La tua configurazione viene mantenuta. -
OpenWrt 25.12+ · x64 · APK v3
Istruzioni di configurazione
1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene
localtonet-openwrt-25.12-x64.apk.Esegui questi comandi sul router come root. Prima dell'installazione, verifica che l'architettura del pacchetto corrisponda al tuo firmware.
Questo pacchetto APK locale non è firmato, quindi l'installazione richiede
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPer gli aggiornamenti, installa il nuovo pacchetto ed esegui
/etc/init.d/localtonet restart. La tua configurazione viene mantenuta. -
OpenWrt 25.12+ · ARM64 · APK v3
Istruzioni di configurazione
1. Installa il pacchetto scaricato. Apri un terminale nella cartella che contiene
localtonet-openwrt-25.12-arm64.apk.Esegui questi comandi sul router come root. Prima dell'installazione, verifica che l'architettura del pacchetto corrisponda al tuo firmware.
Questo pacchetto APK locale non è firmato, quindi l'installazione richiede
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. 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:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Avvia il servizio. Quando il controllo della configurazione riesce:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetPer gli aggiornamenti, installa il nuovo pacchetto ed esegui
/etc/init.d/localtonet restart. La tua configurazione viene mantenuta.
Leggi le istruzioni di configurazione del tuo pacchetto prima dell'installazione. I pacchetti non sono firmati; la compatibilità del firmware, i tunnel e la VPN vanno verificati sul dispositivo previsto. Non forzare mai un'architettura non corrispondente.