Dispositivos USB
Beta
Nesta página 7 seções
- Como funciona
- Antes de começar
- Configurar um dispositivo USB
- Adicione o dispositivo com o assistente
- Ative o modo de dispositivo USB para o token
- Crie um proxy que usa o dispositivo
- Inicie o túnel
- Detalhes da conexão
- Etapas de troca de IP
- Escrevendo suas próprias etapas
- Importar, copiar e ajuda de IA
- Templates de etapas
- Configurações do dispositivo
- Links de troca de IP
- Excluir um dispositivo
- Solução de problemas
- Páginas relacionadas
Use um modem USB ou um celular Android como a conexão de internet de um túnel de proxy e troque o IP dele em um intervalo programado ou por meio de um link. Você adiciona o dispositivo em Meus dispositivos USB; o app Localtonet no computador em que ele está conectado faz o resto.
Como funciona #
Um computador executa o app Localtonet e tem um ou mais modems USB ou celulares Android conectados. Cada um deles é um dispositivo USB no seu painel. Um túnel de Servidor proxy que você vincula a um dispositivo USB usa esse dispositivo como conexão de internet.
Para dar um novo IP ao dispositivo, o app executa as Etapas de troca de IP do dispositivo. Quais são essas etapas depende do tipo de dispositivo:
| Tipo | Como o app chega até ele | Como o IP muda |
|---|---|---|
| Modems com página de administração web | O app abre a página de administração do modem a partir do computador em que o modem está conectado. | O app faz login na página de administração e desliga e liga os dados móveis do modem. |
| Modems controlados pela porta serial | Para pendrives USB em modo stick (NCM/PPP): o app conversa com o modem pela porta serial dele. | O app envia comandos AT para a porta COM do modem. |
| Celulares Android | Conectado com tethering USB. O app encontra o celular pelo ID do dispositivo ADB. | O app liga e desliga o modo avião por ADB. |
| Não listado | Qualquer outro modem com página de administração web. | Você mesmo escreve as etapas para a página de administração dele. |
Meus dispositivos USB lista estes como dispositivos compatíveis: Huawei HiLink, ZTE, Alcatel / LinkZone, modems com comandos AT e celulares Android (ADB). O suporte a Tenda MF e D-Link DWM é experimental: a troca de IP pode não funcionar em todos os firmwares.
Antes de começar #
- O app Localtonet precisa estar em execução no computador em que o dispositivo está conectado. Baixe-o na página Downloads.
- Um AuthToken para esse computador. Você ativa o Modo de dispositivo USB para ele no passo 2 abaixo.
- Para um modem com página de administração web: o endereço da página de administração, que costuma estar impresso na etiqueta do modem, e o nome de usuário e a senha dele, se tiver.
- Para um modem serial: a porta COM dele. No Windows, veja no Gerenciador de Dispositivos, em Portas (COM e LPT). No Linux, geralmente é
/dev/ttyUSB0ou/dev/ttyACM0. - Para um celular Android: tethering USB e depuração USB ativados, e o comando
adbdisponível nesse computador. O app executa oadbpara controlar o celular.
Meus dispositivos USB está no menu do seu painel pessoal. Ele não aparece enquanto uma equipe está selecionada.
Configurar um dispositivo USB #
-
Adicione o dispositivo com o assistente #
Abra Meus dispositivos USB e selecione Iniciar assistente de configuração. O assistente tem três etapas:
Etapa O que você faz Modelo Escolha o modelo que corresponde ao seu. Você pode pesquisar na lista. Não está listado? Escolha Outro dispositivo e escreva as etapas você mesmo. Conexão Informe como o app chega ao dispositivo. Os campos dependem do tipo de dispositivo, veja Detalhes da conexão. Etapas de troca de IP Revise o que o app executa para trocar o IP. Um modelo listado já vem com etapas integradas ou pede que você escreva as suas. Não é necessário para Android. Selecione Adicionar dispositivo. O assistente confirma que o dispositivo foi adicionado e mostra os próximos três passos.
-
Ative o modo de dispositivo USB para o token #
Em Meus tokens, abra as Configurações do token do token que você usa no computador em que o dispositivo está conectado e ative o Modo de dispositivo USB.
-
Crie um proxy que usa o dispositivo #
Em Servidor proxy, crie um proxy com esse token e escolha o dispositivo em Dispositivo USB. O campo aparece quando o token selecionado está no modo de dispositivo USB.
-
Inicie o túnel #
Inicie o túnel. Para trocar o IP em um intervalo programado ou por meio de um link, abra as configurações do dispositivo em Meus dispositivos USB.
Detalhes da conexão #
| Campo | Usado para | O que informar |
|---|---|---|
| Nome do dispositivo | Todos os dispositivos | Exibido na sua lista de dispositivos e na configuração de dispositivo USB do túnel. No máximo 100 caracteres. |
| Endereço da página de administração | Modems com página de administração web | O endereço que você abre em um navegador para chegar à página de administração do modem, como http://192.168.8.1. |
| Usuário, Senha | Modems com página de administração web | Com o que o app faz login na página de administração. Obrigatório quando as etapas do modelo fazem login com eles; caso contrário, apenas se a página de administração pedir. |
| Porta COM | Modems seriais | COM3 no Windows ou /dev/ttyUSB0 no Linux. |
| Taxa de baud | Modems seriais | Mantenha 115200, a menos que o manual do modem diga outra coisa. |
| ID do dispositivo ADB | Celulares Android | Conecte o celular, ative a depuração USB, execute adb devices nesse computador e copie o ID da primeira coluna, por exemplo R58M12ABCDE ou 192.168.1.20:5555. |
Etapas de troca de IP #
Um dispositivo usa as etapas integradas do modelo dele ou as próprias etapas.
- Usar as etapas integradas é a opção recomendada. As correções nas etapas do modelo chegam ao dispositivo automaticamente.
- Escrever minhas próprias etapas substitui as etapas integradas somente para este dispositivo.
- Celulares Android trocam o IP ligando e desligando o modo avião, então não têm etapas para editar.
Para alterar as etapas de um dispositivo existente, selecione Editar etapas de troca de IP na linha dele. O app carrega as etapas quando um túnel inicia, então reinicie os túneis que usam o dispositivo depois de salvar.
Escrevendo suas próprias etapas #
O app executa as etapas em ordem e espera depois de cada uma. Um dispositivo pode ter no máximo 30 etapas. Cada etapa é uma Requisição HTTP ou um AT command.
| Campo | Tipo de etapa | O que faz |
|---|---|---|
| Método | Requisição HTTP | GET, POST, PUT, PATCH ou DELETE. |
| Caminho da URL | Requisição HTTP | Somente o caminho, começando com /, como /api/dialup/mobile-dataswitch. O app coloca o endereço da página de administração na frente dele. |
| Corpo | Requisição HTTP | O corpo da requisição ou os campos do formulário. Escreva _username_localtonet_ e _password_localtonet_ onde entram o usuário e a senha do modem. O app os preenche a partir dos detalhes da conexão, então uma etapa nunca contém a própria senha. |
| AT command | Comando AT | O comando que o app envia à porta serial. |
| Resposta esperada | Comando AT | A resposta que o app espera, OK por padrão. |
| Esperar depois (ms) | Ambos | Quanto tempo o app espera depois da etapa, de 0 a 600000 ms. |
O botão de configurações de uma etapa abre Configurações da etapa com as opções menos comuns:
| Seção | Opções |
|---|---|
| Requisição | Tipo de conteúdo, Enviar o corpo como query string e Cabeçalhos extras como um objeto JSON com nomes e valores de cabeçalhos. |
| Login | Esta etapa faz login, Manter os cookies para as próximas etapas, Formato da senha e Formato do usuário: como os marcadores são escritos no corpo. |
| Tokens das respostas | Guardar de uma resposta JSON, Guardar de uma resposta XML e Enviar tokens guardados como cabeçalhos: guarde um valor de uma resposta e envie-o como cabeçalho em uma etapa posterior. |
| Novas tentativas | Tentativas, de 1 a 10, e Espera entre tentativas (ms), de 0 a 60000. |
Defina o formato da senha de uma etapa de login. Quando uma etapa faz login sem formato definido, o app tenta logins em Base64, MD5 e texto simples, um após o outro. Isso pode bloquear a página de administração.
Importar, copiar e ajuda de IA #
- Copiar JSON copia as etapas como JSON. Importar JSON substitui a lista pelo JSON colado. Nada é salvo até você salvar.
- Deixe um assistente de IA escrever as etapas: o Claude Code ou o Codex, executando no computador em que o modem está conectado, pode descobrir as requisições ou os comandos AT que dão um novo IP ao modem e testá-los. Selecione Copiar prompt, cole-o no assistente nesse computador, depois importe o JSON que ele fornecer, confira e salve. Para um modem serial, feche o app Localtonet ali quando o assistente pedir: o app mantém a porta serial aberta.
Templates de etapas #
A página de configuração tem mais duas abas para quem tem muitos modems do mesmo modelo:
- Templates de etapas: salve um conjunto de etapas de troca de IP uma só vez, com um nome. Feito para é apenas um rótulo para ajudar você a encontrá-lo.
- Aplicar um template: copie as etapas de um template para vários dispositivos de uma vez. As etapas do template substituem as etapas dos dispositivos selecionados. Dispositivos que usam as etapas integradas do modelo passam a usar as etapas do template.
Excluir um template não altera os dispositivos aos quais você já o aplicou. Eles mantêm as etapas.
Configurações do dispositivo #
Seus dispositivos USB lista cada dispositivo com o Modelo, o intervalo de Troca automática de IP, os Túneis (túneis ativos / todos os túneis que usam o dispositivo), o ID do dispositivo e a data em que foi adicionado. Selecione Configurações em uma linha para abrir Configurações do dispositivo USB.
| Configuração | O que faz | Valores |
|---|---|---|
| Trocar IP automaticamente | Enquanto um túnel que usa este dispositivo está em execução, o app Localtonet troca o IP dele neste intervalo. | Ligado ou desligado. |
| Trocar a cada | Com que frequência o IP muda. O intervalo recomeça depois de cada troca. | Segundos, no mínimo 10. Predefinições: 5 min, 15 min, 30 min, 1 hora. |
| Modo avião ativo por | Somente celulares Android. Por quanto tempo o celular fica em modo avião em cada troca. | De 1 a 100 segundos. |
| Interface web do modem | O Endereço web, o Usuário e a Senha com que o app faz login para trocar o IP. | Um endereço como http://192.168.8.1. |
| Gateway | O endereço do próprio modem no seu computador. Alterar move o modem para um novo endereço e atualiza também o endereço web. | Somente o terceiro número pode mudar, de 0 a 255. Exige um túnel de proxy que use este dispositivo: a alteração é enviada ao modem por meio dele. Nem todo dispositivo oferece suporte. |
Links de troca de IP #
A aba Links de troca de IP cria links que trocam o IP do dispositivo. Abrir um link troca o IP uma vez, então você pode chamá-lo de um navegador, de um script ou de um agendador.
- Selecione Criar link e depois Copiar link. Um dispositivo pode ter até 10 links.
- Qualquer pessoa com o link pode usá-lo, então compartilhe-o somente com ferramentas em que você confia.
- Excluir link revoga um link.
Os links normalmente usam localtonet.com como host: https://localtonet.com/device/changeip?u=<LINK_ID>. Se um dos seus domínios no Gerenciador de DNS tiver um registro do tipo Android, o painel monta os links com esse nome, por exemplo https://link.example.com/device/changeip?u=<LINK_ID>. Veja Registros Android.
Excluir um dispositivo #
Excluir um dispositivo USB para e exclui os túneis que o usam, e os links de troca de IP dele deixam de funcionar. Isso não pode ser desfeito.
Solução de problemas #
O campo Dispositivo USB não aparece no formulário de Servidor proxy
O token selecionado não está no modo de dispositivo USB. Ative o Modo de dispositivo USB nas configurações do token em Meus tokens e depois selecione o token de novo.
As etapas integradas não trocam o IP
Nos modelos experimentais (Tenda MF, D-Link DWM), a troca de IP pode não funcionar em todos os firmwares, e em algumas operadoras desligar e ligar os dados móveis devolve o mesmo IP. Escreva etapas próprias para o dispositivo ou peça a um assistente de IA que as descubra no computador em que o modem está conectado.
Salvei novas etapas, mas nada mudou
O app carrega as etapas quando um túnel inicia. Reinicie os túneis que usam o dispositivo.
Crie primeiro um túnel de proxy que use este dispositivo
Uma alteração de gateway é enviada ao modem por um túnel de proxy. Crie um túnel de Servidor proxy com este dispositivo e depois altere o gateway.
Informe o ID do dispositivo ADB exatamente como "adb devices" o mostra
Copie somente a primeira coluna da saída de adb devices. O ID não tem espaços.
Você não pode ter mais de 10 links
Exclua um link de troca de IP que você não usa mais e depois crie o novo.