Inviare un tunnel attraverso una rete specifica
In questa pagina 10 sezioni
- Prima di iniziare
- Passaggi
- Elenca le reti del dispositivo
- Apri l'impostazione Argomenti del tunnel
- Inserisci la rete
- Salva
- Gli argomenti in forma di testo
- A cosa serve la rete selezionata
- Quando la rete non è disponibile
- Seleziona una rete per l'intero client
- Esempio: due proxy su due modem
- La stessa impostazione tramite l'API
- Risoluzione dei problemi
- Pagine correlate
Quando un dispositivo ha più di una connessione a internet, ad esempio una seconda linea o un modem USB, puoi inviare un tunnel attraverso una rete specifica. Gli altri tunnel continuano a usare la connessione predefinita. Scegli la rete con due valori: il suo nome e l'indirizzo IP del dispositivo su di essa.
Prima di iniziare #
- Un dispositivo con almeno due reti attive e il client Localtonet installato su di esso. Vedi Installazione.
- Un tunnel di un tipo che ha l'impostazione Argomenti: HTTP, TCP - UDP, TLS o Server proxy.
- Su Linux, esegui il client come root o con
sudosenza password. Il client aggiunge regole di instradamento per la rete selezionata con il comandoip; senza questo permesso il traffico potrebbe uscire dalla route predefinita.
Passaggi #
-
Elenca le reti del dispositivo #
Sul dispositivo, esegui:
Terminalelocaltonet --networkIl comando non richiede alcun AuthToken. Elenca ogni rete attiva con i suoi indirizzi IP, verifica l'accesso a internet di ogni indirizzo IPv4 e termina:
OutputNetworkName: Ethernet 2 --net Ethernet 2 --ip 192.168.8.100 --> Internet available (public IP 203.0.113.25) -------------------------------------------------- NetworkName: Wi-Fi --net Wi-Fi --ip 192.168.1.20 --> Internet available (public IP 198.51.100.7) --net Wi-Fi --ip 2001:db8::20 --> IPv6, internet check not available --------------------------------------------------Ogni riga che inizia con
--netè una coppia già pronta di nome della rete e indirizzo IP. Annota la coppia della rete che vuoi. Una riga che termina conNo internet accessappartiene a un indirizzo per cui il controllo di internet non è riuscito. Dopo l'elenco, il comando stampa una breve spiegazione di--nete--ip. -
Apri l'impostazione Argomenti del tunnel #
Nella dashboard, apri la pagina del tipo di tunnel, seleziona Impostazioni nella riga del tunnel, poi Argomenti › Gestisci. Si apre la finestra Selezione della rete.
-
Inserisci la rete #
Attiva Usa una rete specifica e compila entrambi i campi:
Campo Cosa inserire Esempio Nome della rete Il nome esattamente come lo stampa localtonet --networkdopoNetworkName:.Ethernet 2IP del dispositivo su quella rete L'indirizzo IPv4 o IPv6 del dispositivo su quella rete, da una riga --netdi quella rete.192.168.8.100Inviato all'app mostra gli argomenti risultanti, ad esempio
--net Ethernet 2 --ip 192.168.8.100. -
Salva #
Seleziona Salva. Un tunnel in esecuzione viene riavviato e da quel momento usa la rete selezionata.
Gli argomenti in forma di testo #
Modifica come testo porta la finestra a un unico campo Argomenti, e Usa il modulo torna indietro. Il testo ha questa forma:
--net <NETWORK_NAME> --ip <IP_ADDRESS>--nete--ipdevono essere indicati insieme. Con uno solo dei due il tunnel non ha una rete propria: usa la rete predefinita, o la rete selezionata per l'intero client.- Un nome di rete con spazi può essere scritto così com'è, oppure tra virgolette:
--net Wi-Fi 2 --ip 192.168.1.5e--net "Wi-Fi 2" --ip 192.168.1.5hanno lo stesso significato. - Il nome viene confrontato prima in modo esatto. Un nome che differisce solo per maiuscole e minuscole viene accettato quando corrisponde esattamente a una sola rete.
- L'indirizzo IP deve essere uno che il dispositivo ha attualmente su quella rete.
A cosa serve la rete selezionata #
- La connessione del tunnel dal dispositivo al server Localtonet.
- Per un tunnel proxy, il traffico che lascia direttamente il dispositivo verso internet e le relative ricerche DNS. Se il tunnel proxy ha un'Impostazione upstream, la connessione al proxy upstream non è vincolata alla rete selezionata.
- La connessione al tuo servizio locale, quando quel servizio viene raggiunto attraverso la rete selezionata. Un servizio sul dispositivo stesso (
127.0.0.1) o su un'altra rete locale viene raggiunto nel modo normale.
Quando la rete non è disponibile #
Quando la rete selezionata manca, il tunnel non ripiega sulla connessione predefinita: le sue connessioni restano chiuse. Questo conta per i proxy: il traffico non deve uscire da una linea diversa da quella che hai scelto.
- Se la rete manca all'avvio del tunnel, il tunnel la attende.
- Se la rete scompare in seguito, le connessioni del tunnel restano chiuse finché la coppia di nome della rete e indirizzo IP non è di nuovo disponibile. Il client ricontrolla ogni pochi secondi e quando le reti del dispositivo cambiano, e il tunnel riprende da solo.
- Se il dispositivo ottiene un indirizzo IP diverso su quella rete, la coppia non corrisponde più e il tunnel resta chiuso. Assegna al dispositivo un indirizzo fisso su quella rete oppure aggiorna l'impostazione.
Avvia il client con il tuo token e --debug (localtonet --authtoken <YOUR_TOKEN> --debug) per vedere il motivo nel suo output degli errori. La riga inizia con un timestamp e [debug][proxy], poi indica il tunnel con il suo identificatore interno, il problema e la coppia che attende:
[2026-11-14 10:15:30.123 UTC][debug][proxy] Tunnel <TUNNEL_IDENTIFIER>: Network interface 'Ethernet 2' was not found. Run 'localtonet --network' to list the interfaces. Its connections stay closed until --net Ethernet 2 --ip 192.168.8.100 is available.Altri problemi che può indicare sono “'192.168.8.100' is not an address of network interface 'Ethernet 2'.”, “Network interface 'Ethernet 2' is Down.” e “The --ip value is not an IP address.”
Seleziona una rete per l'intero client #
Per selezionare una rete per la connessione del client stesso e per ogni tunnel senza una rete propria, passa le stesse due opzioni quando lo avvii:
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>- Entrambe le opzioni sono obbligatorie. Con una sola, il client stampa “--net and --ip must be given together; the default network is used.” e continua sulla rete predefinita.
- Se la rete non è disponibile all'avvio, il client la attende fino a 30 secondi e poi si ferma indicando il motivo, invece di funzionare su un'altra rete.
- Un tunnel che ha una propria rete in Argomenti usa quella. Le opzioni del client si applicano ai tunnel che non ne hanno una.
Tutte le opzioni della riga di comando sono elencate nel Riferimento CLI.
Esempio: due proxy su due modem #
Un computer ha due modem USB. localtonet --network stampa --net Modem A --ip 192.168.8.100 e --net Modem B --ip 192.168.9.100. Crea due tunnel Server proxy con l'AuthToken del dispositivo. Nel primo, apri Argomenti › Gestisci e inserisci Modem A e 192.168.8.100; nel secondo, inserisci Modem B e 192.168.9.100. Ogni proxy ora esce dal proprio modem e un proxy smette di far passare traffico quando il suo modem viene scollegato.
La stessa impostazione tramite l'API #
Gli argomenti di un tunnel possono essere letti (GET) e impostati (PATCH) in /api/v2/tunnels/<TUNNEL_ID>/arguments. Invia un valore vuoto per rimuoverli. Un valore impostato tramite l'API viene usato al successivo avvio del tunnel. Vedi API.
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }Risoluzione dei problemi #
“Inserisci il nome della rete.” oppure “Inserisci l'indirizzo IP del dispositivo su quella rete.”
Entrambi i campi sono obbligatori finché Usa una rete specifica è attivo. Per smettere di usare una rete specifica, disattiva l'interruttore e salva.
“Inserisci un indirizzo IP come 192.168.8.100.”
Il secondo campo richiede l'indirizzo IP del dispositivo su quella rete, non il nome della rete e non l'IP pubblico.
"Controlla la connessione del dispositivo."
Il salvataggio riavvia un tunnel in esecuzione e l'app Localtonet del suo dispositivo non è connessa. Avvia l'app, oppure ferma il tunnel e salva di nuovo.
Il tunnel è avviato ma non fa passare traffico
Probabilmente la rete selezionata non è disponibile. Esegui localtonet --network sul dispositivo e confronta il nome e l'indirizzo IP con l'impostazione. Correggi l'impostazione oppure riattiva la rete.
Su Linux il traffico esce ancora dalla route predefinita
Probabilmente il client non è riuscito ad aggiungere le regole di instradamento. Eseguilo come root o consenti sudo senza password per il comando ip, poi riavvia il client. Il client non aggiunge regole per una rete che non riporta alcun gateway.
localtonet --network stampa “No active network interface with an IP address was found.”
Il dispositivo non ha nessuna rete attiva con un indirizzo. Collega una rete ed esegui di nuovo il comando.