Vai al contenuto
Localtonet Localtonet Dashboard

Inviare un tunnel attraverso una rete specifica

Aiuto su questa pagina
In questa pagina 10 sezioni
  1. Prima di iniziare
  2. Passaggi
  3. Elenca le reti del dispositivo
  4. Apri l'impostazione Argomenti del tunnel
  5. Inserisci la rete
  6. Salva
  7. Gli argomenti in forma di testo
  8. A cosa serve la rete selezionata
  9. Quando la rete non è disponibile
  10. Seleziona una rete per l'intero client
  11. Esempio: due proxy su due modem
  12. La stessa impostazione tramite l'API
  13. Risoluzione dei problemi
  14. 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 sudo senza password. Il client aggiunge regole di instradamento per la rete selezionata con il comando ip; senza questo permesso il traffico potrebbe uscire dalla route predefinita.

Passaggi #

  1. Elenca le reti del dispositivo #

    Sul dispositivo, esegui:

    Terminale
    localtonet --network

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

    Output
    NetworkName: 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 con No internet access appartiene a un indirizzo per cui il controllo di internet non è riuscito. Dopo l'elenco, il comando stampa una breve spiegazione di --net e --ip.

  2. 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.

  3. Inserisci la rete #

    Attiva Usa una rete specifica e compila entrambi i campi:

    CampoCosa inserireEsempio
    Nome della reteIl nome esattamente come lo stampa localtonet --network dopo NetworkName:.Ethernet 2
    IP del dispositivo su quella reteL'indirizzo IPv4 o IPv6 del dispositivo su quella rete, da una riga --net di quella rete.192.168.8.100

    Inviato all'app mostra gli argomenti risultanti, ad esempio --net Ethernet 2 --ip 192.168.8.100.

  4. 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>
  • --net e --ip devono 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.5 e --net "Wi-Fi 2" --ip 192.168.1.5 hanno 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:

Output del client
[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:

Terminale
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.

Corpo della richiesta
{ "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.

Supporto