Envie um túnel por uma rede específica
Nesta página 10 seções
- Antes de começar
- Passos
- Liste as redes do dispositivo
- Abra a configuração Argumentos do túnel
- Informe a rede
- Salvar
- Os argumentos em forma de texto
- Para que a rede selecionada é usada
- Quando a rede não está disponível
- Selecione uma rede para o cliente inteiro
- Exemplo: dois proxies em dois modems
- A mesma configuração pela API
- Solução de problemas
- Páginas relacionadas
Quando um dispositivo tem mais de uma conexão com a internet, como uma segunda linha ou um modem USB, você pode enviar um túnel por uma rede específica. Os outros túneis continuam usando a conexão padrão. Você escolhe a rede com dois valores: o nome dela e o endereço IP do dispositivo nela.
Antes de começar #
- Um dispositivo com pelo menos duas redes ativas e o cliente Localtonet instalado nele. Veja Instalação.
- Um túnel de um tipo que tenha a configuração Argumentos: HTTP, TCP - UDP, TLS ou Servidor proxy.
- No Linux, execute o cliente como root ou com
sudosem senha. O cliente adiciona regras de roteamento para a rede selecionada com o comandoip; sem essa permissão, o tráfego pode sair pela rota padrão.
Passos #
-
Liste as redes do dispositivo #
No dispositivo, execute:
Terminallocaltonet --networkO comando não precisa de AuthToken. Ele lista todas as redes ativas com os endereços IP delas, verifica o acesso à internet de cada endereço IPv4 e encerra:
SaídaNetworkName: 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 --------------------------------------------------Cada linha que começa com
--neté um par pronto de nome de rede e endereço IP. Anote o par da rede que você quer. Uma linha que termina comNo internet accesspertence a um endereço cuja verificação de internet falhou. Depois da lista, o comando imprime uma breve explicação de--nete--ip. -
Abra a configuração Argumentos do túnel #
No painel, abra a página do tipo de túnel, selecione Configurações na linha do túnel e depois Argumentos › Gerenciar. A caixa de diálogo Seleção de rede é aberta.
-
Informe a rede #
Ative Usar uma rede específica e preencha os dois campos:
Campo O que informar Exemplo Nome da rede O nome exatamente como localtonet --networko imprime depois deNetworkName:.Ethernet 2IP do dispositivo nessa rede O endereço IPv4 ou IPv6 do dispositivo nessa rede, de uma linha --netdessa rede.192.168.8.100Enviado ao app mostra os argumentos resultantes, por exemplo
--net Ethernet 2 --ip 192.168.8.100. -
Salvar #
Selecione Salvar. Um túnel em execução é reiniciado e, a partir daí, usa a rede selecionada.
Os argumentos em forma de texto #
Editar como texto troca a caixa de diálogo para um único campo Argumentos, e Usar o formulário volta ao formulário. O texto tem esta forma:
--net <NETWORK_NAME> --ip <IP_ADDRESS>--nete--ipdevem ser informados juntos. Com apenas um deles, o túnel não tem uma rede própria: ele usa a rede padrão ou a rede selecionada para o cliente inteiro.- Um nome de rede com espaços pode ser escrito como está ou entre aspas:
--net Wi-Fi 2 --ip 192.168.1.5e--net "Wi-Fi 2" --ip 192.168.1.5significam o mesmo. - O nome é comparado primeiro de forma exata. Um nome que difere apenas em maiúsculas e minúsculas é aceito quando corresponde a exatamente uma rede.
- O endereço IP deve ser um que o dispositivo tenha atualmente nessa rede.
Para que a rede selecionada é usada #
- A conexão do túnel do dispositivo com o servidor Localtonet.
- Em um túnel de proxy, o tráfego que sai diretamente do dispositivo para a internet e as consultas DNS dele. Se o túnel de proxy tem um Proxy upstream, a conexão com o proxy upstream não é vinculada à rede selecionada.
- A conexão com o seu serviço local, quando esse serviço é acessado pela rede selecionada. Um serviço no próprio dispositivo (
127.0.0.1) ou em outra rede local é acessado da forma normal.
Quando a rede não está disponível #
Quando a rede selecionada está ausente, o túnel não volta para a conexão padrão: as conexões dele permanecem fechadas. Isso importa para proxies: o tráfego não deve sair por uma linha diferente da que você escolheu.
- Se a rede estiver ausente quando o túnel iniciar, o túnel espera por ela.
- Se a rede desaparecer depois, as conexões do túnel permanecem fechadas até que o par de nome de rede e endereço IP volte a estar disponível. O cliente verifica novamente a cada poucos segundos e quando as redes do dispositivo mudam, e o túnel retoma sozinho.
- Se o dispositivo receber um endereço IP diferente nessa rede, o par deixa de corresponder e o túnel permanece fechado. Dê ao dispositivo um endereço fixo nessa rede ou atualize a configuração.
Inicie o cliente com o seu token e --debug (localtonet --authtoken <YOUR_TOKEN> --debug) para ver o motivo na saída de erro dele. A linha começa com um carimbo de data e hora e [debug][proxy], depois cita o túnel pelo identificador interno, o problema e o par que ele espera:
[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.Outros problemas que ele pode citar incluem "'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."
Selecione uma rede para o cliente inteiro #
Para selecionar uma rede para a conexão do próprio cliente e para todos os túneis sem rede própria, passe as mesmas duas opções ao iniciá-lo:
localtonet --authtoken <YOUR_TOKEN> --net <NETWORK_NAME> --ip <IP_ADDRESS>- As duas opções são obrigatórias. Com apenas uma, o cliente imprime "--net and --ip must be given together; the default network is used." e continua na rede padrão.
- Se a rede não estiver disponível na inicialização, o cliente espera até 30 segundos por ela e depois para informando o motivo, em vez de funcionar em outra rede.
- Um túnel que tem a própria rede em Argumentos usa essa. As opções do cliente valem para os túneis que não têm uma.
Todas as opções de linha de comando estão listadas na Referência da CLI.
Exemplo: dois proxies em dois modems #
Um computador tem dois modems USB. localtonet --network imprime --net Modem A --ip 192.168.8.100 e --net Modem B --ip 192.168.9.100. Crie dois túneis Servidor proxy no AuthToken do dispositivo. No primeiro, abra Argumentos › Gerenciar e informe Modem A e 192.168.8.100; no segundo, informe Modem B e 192.168.9.100. Cada proxy agora sai pelo próprio modem, e um proxy deixa de passar tráfego quando o modem dele é desconectado.
A mesma configuração pela API #
Os argumentos de um túnel podem ser lidos (GET) e definidos (PATCH) em /api/v2/tunnels/<TUNNEL_ID>/arguments. Envie um valor vazio para removê-los. Um valor definido pela API é usado na próxima vez que o túnel iniciar. Veja API.
{ "arguments": "--net Ethernet 2 --ip 192.168.8.100" }Solução de problemas #
“Informe o nome da rede.” ou “Informe o endereço IP do dispositivo nessa rede.”
Os dois campos são obrigatórios enquanto Usar uma rede específica está ativado. Para deixar de usar uma rede específica, desative a opção e salve.
“Informe um endereço IP como 192.168.8.100.”
O segundo campo recebe o endereço IP do dispositivo nessa rede, não o nome da rede e não o endereço IP público.
"Verifique a conexão do dispositivo."
Salvar reinicia um túnel em execução, e o app Localtonet do dispositivo dele não está conectado. Inicie o app ou pare o túnel e salve novamente.
O túnel está iniciado, mas não passa tráfego
Provavelmente a rede selecionada não está disponível. Execute localtonet --network no dispositivo e compare o nome e o endereço IP com a configuração. Corrija a configuração ou reative a rede.
No Linux, o tráfego ainda sai pela rota padrão
Provavelmente o cliente não conseguiu adicionar as regras de roteamento. Execute-o como root ou permita sudo sem senha para o comando ip e reinicie o cliente. O cliente não adiciona regras para uma rede que não informa gateway.
localtonet --network imprime "No active network interface with an IP address was found."
O dispositivo não tem nenhuma rede ativa com um endereço. Conecte uma rede e execute o comando novamente.