Ir para o conteúdo
Localtonet Localtonet Painel

Como o Localtonet funciona

Ajuda com esta página
Nesta página 10 seções
  1. O caminho de uma requisição
  2. Sem redirecionamento de portas, sem IP público
  3. Dispositivos e AuthTokens
  4. Túneis
  5. De criado a ativo
  6. Regiões do servidor
  7. Endereços públicos e tipos de URL
  8. O endereço continua o mesmo?
  9. Criptografia de ponta a ponta
  10. Quando o cliente se desconecta
  11. Local como servidor
  12. 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 a um endereço público em um servidor Localtonet. O servidor encaminha o tráfego por um túnel criptografado, aberto pelo cliente Localtonet no seu dispositivo, até o seu serviço local. Seu dispositivo Visitante Internet Requisição Servidor Localtonet Endereço público Túnel criptografado saída Cliente Localtonet Seu AuthToken Serviço local 127.0.0.1:3000
Uma requisição viaja do visitante até o servidor Localtonet, passa pelo túnel até o cliente no seu dispositivo e segue para o seu serviço local.
  1. 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.
  2. O servidor Localtonet envia o tráfego para o túnel que o cliente no seu dispositivo já abriu.
  3. 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.
  4. 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çãoO que define
Tipo de túnelO protocolo: HTTP, TCP, UDP, TLS, Servidor de arquivos, Servidor proxy e outros. Veja Tipos de túnel.
Token do dispositivoO dispositivo que recebe o tráfego. É o token com o qual o cliente nesse dispositivo foi iniciado.
Região do servidorA localização do servidor Localtonet que hospeda o endereço público.
Tipo de URLComo o endereço público é escolhido.
Endereço IP local e Porta localPara 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 #

  1. Criar. Criar túnel apenas salva as configurações. Nada está online ainda.
  2. Iniciar. Selecione Iniciar. Se o cliente do token do túnel estiver conectado, o túnel entra no ar.
  3. 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.
  4. Parar. O endereço público deixa de responder. O túnel e as configurações dele são mantidos para depois.
  5. 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 URLO que você recebePlano
Subdomínio aleatórioO Localtonet gera um subdomínio para você. Você recebe um endereço imediatamente.Plano Grátis
Subdomínio personalizadoVocê digita o Subdomínio e escolhe o Domínio ao qual ele pertence.Exige Saldo
Domínio personalizadoVocê 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únelSubdomínio aleatórioSubdomínio personalizadoDomínio personalizado
HTTPSimSimSim
Servidor de arquivosSimSimSim
Gateway MCPSimSimSim
TLSSimSimNão
TCP, UDP, UDP / TCP mistoSimSimNão
Servidor proxySimSimNão
Proxy rotativoSimSimNã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.
MensagemO 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.

Próximos passos #

Suporte