Como o Localtonet funciona
Nesta página 10 seções
- O caminho de uma requisição
- Sem redirecionamento de portas, sem IP público
- Dispositivos e AuthTokens
- Túneis
- De criado a ativo
- Regiões do servidor
- Endereços públicos e tipos de URL
- O endereço continua o mesmo?
- Criptografia de ponta a ponta
- Quando o cliente se desconecta
- Local como servidor
- Próximos passos
O cliente Localtonet no seu dispositivo abre um túnel criptografado de saída para um servidor Localtonet. O servidor dá ao seu serviço um endereço público e encaminha o tráfego por esse túnel até o endereço IP local e a porta que você escolheu.
O caminho de uma requisição #
- Um visitante se conecta ao endereço público do seu túnel. Esse endereço pertence a um servidor Localtonet na região que você escolheu.
- O servidor Localtonet envia o tráfego para o túnel que o cliente no seu dispositivo já abriu.
- O cliente Localtonet recebe o tráfego e se conecta ao endereço IP local e à porta definidos no túnel, por exemplo
127.0.0.1:3000. - O seu serviço responde, e a resposta volta pelo mesmo caminho.
Sem redirecionamento de portas, sem IP público #
O seu dispositivo inicia a conexão, então nenhuma porta de entrada precisa ser aberta. Você não precisa de um endereço IP público nem de nenhuma alteração no roteador. Isso também funciona atrás de NAT e CGNAT, em conexões domésticas e móveis nas quais o redirecionamento de portas não é possível.
A sua rede ainda precisa permitir a conexão de saída. Um firewall ou um produto de segurança de endpoint pode bloqueá-la.
Para túneis HTTP e TCP, você também pode dispensar o cliente: as configurações do túnel mostram um comando SSH que abre o túnel a partir de qualquer máquina com um cliente SSH. Veja SSH sem instalação.
Dispositivos e AuthTokens #
Um AuthToken conecta um dispositivo à sua conta. Você inicia o cliente com ele e, a partir daí, pode escolher esse dispositivo ao criar um túnel.
- Um token por dispositivo. Crie um token para cada dispositivo em Meus tokens e dê a ele um nome que você reconheça, como
Office-PC. O nome é apenas um rótulo. O próprio Localtonet gera o token. - Uma conexão por token. Uma nova conexão que usa o mesmo token substitui a anterior, então não inicie dois dispositivos com o mesmo token.
- Online e Offline. Meus tokens mostra cada dispositivo como Online enquanto o app Localtonet está conectado e como Offline quando está desconectado, mesmo que os túneis dele ainda estejam configurados.
- Mantenha-o em sigilo. Qualquer pessoa que tenha o token pode usá-lo para fazer login no app como esse dispositivo.
Um AuthToken não protege um túnel. Ele identifica o seu dispositivo, não os seus visitantes. Um túnel novo é acessível por qualquer pessoa que tenha o endereço dele. Para restringir os visitantes, veja Controle de acesso.
Mais sobre tokens: AuthTokens.
Túneis #
Um túnel é um conjunto salvo de configurações que liga um endereço público a um serviço em um dispositivo. Todo túnel armazena:
| Configuração | O que define |
|---|---|
| Tipo de túnel | O protocolo: HTTP, TCP, UDP, TLS, Servidor de arquivos, Servidor proxy e outros. Veja Tipos de túnel. |
| Token do dispositivo | O dispositivo que recebe o tráfego. É o token com o qual o cliente nesse dispositivo foi iniciado. |
| Região do servidor | A localização do servidor Localtonet que hospeda o endereço público. |
| Tipo de URL | Como o endereço público é escolhido. |
| Endereço IP local e Porta local | Para onde o cliente envia o tráfego. Use 127.0.0.1 para um serviço no mesmo dispositivo do cliente. |
Um dispositivo pode atender vários túneis. Meus tokens mostra o número de túneis ativos e o total vinculados a cada token. Para mover um túnel para outro dispositivo, selecione o nome do token na lista de túneis e escolha outro token em Trocar AuthToken. Um túnel em execução é parado e reiniciado com o token selecionado. Os túneis de Proxy rotativo são a exceção: eles usam grupos de tokens em vez de um único token.
De criado a ativo #
- Criar. Criar túnel apenas salva as configurações. Nada está online ainda.
- Iniciar. Selecione Iniciar. Se o cliente do token do túnel estiver conectado, o túnel entra no ar.
- Iniciar com o dispositivo offline. O painel informa que o token está offline e espera o app se conectar. Iniciar mesmo assim liga o túnel agora. Ele conta como ativo e entra no ar quando o app se conecta.
- Parar. O endereço público deixa de responder. O túnel e as configurações dele são mantidos para depois.
- Excluir. O endpoint e as configurações do túnel são removidos.
Excluir um token exclui os túneis dele. Os túneis com esse token são parados e excluídos.
Regiões do servidor #
O campo Região do servidor define onde o endereço público de um túnel é hospedado. A dica do painel é: escolha uma região próxima ao seu dispositivo para ter menor latência.
A lista é montada para a sua conta. Ela contém:
- Regiões do Localtonet, uma entrada por país. O mapa da rede na página inicial mostra as localizações.
- Seus próprios servidores, se você adicionou algum com o Gerenciador de servidores. Apenas a sua conta os vê, e a lista seleciona o seu servidor por padrão.
- Local como servidor, nos tipos de túnel que o suportam. Veja abaixo.
Você pode mover um túnel existente: selecione o servidor do túnel na lista de túneis para abrir Trocar servidor. Isso exige Saldo e, quando ocorre uma troca de servidor, as atualizações de DNS podem levar até 3 horas.
Endereços públicos e tipos de URL #
Ao criar um túnel, o Tipo de URL define como o endereço público dele é escolhido.
| Tipo de URL | O que você recebe | Plano |
|---|---|---|
| Subdomínio aleatório | O Localtonet gera um subdomínio para você. Você recebe um endereço imediatamente. | Plano Grátis |
| Subdomínio personalizado | Você digita o Subdomínio e escolhe o Domínio ao qual ele pertence. | Exige Saldo |
| Domínio personalizado | Você usa um domínio próprio que adicionou no Gerenciador de DNS. Veja Domínios personalizados. | Exige Saldo |
Nem todo tipo de túnel oferece todos os tipos de URL:
| Tipo de túnel | Subdomínio aleatório | Subdomínio personalizado | Domínio personalizado |
|---|---|---|---|
| HTTP | Sim | Sim | Sim |
| Servidor de arquivos | Sim | Sim | Sim |
| Gateway MCP | Sim | Sim | Sim |
| TLS | Sim | Sim | Não |
| TCP, UDP, UDP / TCP misto | Sim | Sim | Não |
| Servidor proxy | Sim | Sim | Não |
| Proxy rotativo | Sim | Sim | Não |
Os túneis TCP, UDP e de proxy são acessados por um nome de host mais uma Porta do servidor.
O endereço continua o mesmo? #
- Um túnel HTTP mantém o subdomínio até você excluir o túnel.
- Nos túneis TCP, UDP e de proxy, um túnel criado em uma conta com Saldo começa com Porta reservada? ativado, o que mantém a mesma porta entre reinicializações. Você pode alterar isso por túnel; veja Portas.
- No plano Free, a porta é liberada quando o túnel para, então o endereço pode mudar.
Criptografia de ponta a ponta #
O túnel entre o seu dispositivo e os servidores Localtonet é criptografado. Isso não é o mesmo que criptografia de ponta a ponta entre um visitante e o seu serviço:
- Os visitantes acessam um túnel HTTP por HTTPS, com certificados que o Localtonet gerencia para você. Esse HTTPS termina no servidor Localtonet, não no seu serviço. Dali, o tráfego segue até o seu dispositivo pelo túnel criptografado.
- Para criptografia de ponta a ponta, use um túnel TLS no modo pass-through, no qual o seu serviço apresenta o próprio certificado, ou um protocolo que já seja criptografado, como o SSH.
Quando o cliente se desconecta #
Um túnel só funciona enquanto três coisas estão em execução: o seu dispositivo, o cliente Localtonet e o seu serviço local. Se o cliente perde a conexão ou você o fecha:
- Os visitantes não conseguem mais acessar o serviço pelo endereço público.
- O dispositivo aparece como Offline em Meus tokens. O túnel em si continua iniciado.
- O cliente tenta se reconectar sozinho. Um túnel iniciado entra no ar novamente assim que o app se conecta.
- Um túnel iniciado é cobrado enquanto está iniciado, mesmo que o dispositivo dele esteja offline. Pare o túnel para encerrar as cobranças. Veja Planos e saldo.
Para manter o cliente em execução após um logout ou uma reinicialização, instale-o como um serviço: Executar como serviço. Para ser avisado quando um túnel ou um token se desconectar, configure Webhooks.
Local como servidor #
Local como servidor é uma entrada na lista Região do servidor. Com ela, nenhum servidor Localtonet hospeda o endereço público. O cliente Localtonet no seu dispositivo abre o listener por conta própria, e os visitantes se conectam diretamente ao seu dispositivo. O painel também chama esses túneis de Client Relay.
- Ela é oferecida ao criar túneis HTTP, TCP, UDP, TLS, Servidor proxy e Gateway MCP. Servidor de arquivos e Proxy rotativo não a oferecem.
- Ao selecioná-la, o formulário pede um IP do servidor de relay: o endereço IP do seu dispositivo ao qual os visitantes se conectam.
- O dispositivo que hospeda o listener precisa permanecer conectado.
- Os túneis Client Relay têm um preço próprio, mais baixo. Veja Planos e saldo.
| Mensagem | O que fazer |
|---|---|
| Informe o IP do servidor local. | Preencha o IP do servidor de relay. |
| O IP do servidor local precisa ser acessível de fora. | Você informou um endereço de loopback ou outro endereço apenas local, como 127.0.0.1. Informe um endereço que os seus visitantes consigam acessar. |