Ir para o conteúdo
Localtonet Localtonet Painel

Criar um túnel HTTP

Ajuda com esta página
Nesta página 10 seções
  1. Antes de começar
  2. Passos
  3. Abra a página HTTP
  4. Escolha o tipo de URL
  5. Escolha o dispositivo e a região
  6. Informe o endereço local
  7. Inicie o túnel
  8. Seu endereço público
  9. HTTPS e certificados
  10. O cabeçalho Host
  11. Configurações de um túnel HTTP
  12. Exemplos
  13. Compartilhar um app web
  14. Receber webhooks
  15. A página de aviso no plano Free
  16. Solução de problemas
  17. Páginas relacionadas

Um túnel HTTP dá a um app web, a uma API ou a um receptor de webhook no seu dispositivo um endereço HTTPS público. A Localtonet fornece o certificado, então seu serviço local pode continuar em HTTP simples.

Antes de começar #

  • O cliente Localtonet está instalado no dispositivo e conectado com um AuthToken. Se não estiver, siga o Início rápido.
  • Seu serviço web está em execução e você sabe a porta dele, por exemplo 3000.
  • Para Subdomínio personalizado ou Domínio personalizado: saldo na sua conta. Para Domínio personalizado, também um domínio que você adicionou no Gerenciador de DNS. Veja Domínios personalizados.

Passos #

  1. Abra a página HTTP #

    Abra Meus túneis › HTTP e selecione Criar túnel HTTP para abrir o formulário.

  2. Escolha o tipo de URL #

    Tipo de URLEndereço que você recebeRequisitos
    Subdomínio aleatórioUm nome gerado no domínio selecionado, por exemplo https://<RANDOM_NAME>.localto.net.Nada além disso
    Subdomínio personalizadoO nome que você digita em Subdomínio, por exemplo https://myapp.localto.net. São permitidos letras, dígitos e hifens.Saldo
    Domínio personalizadoUm domínio seu, selecionado em Domínio.Saldo e um domínio no Gerenciador de DNS
  3. Escolha o dispositivo e a região #

    Em Token do dispositivo, selecione o token usado pelo app Localtonet no seu dispositivo. Em Região do servidor, escolha uma região próxima ao seu dispositivo para menor latência.

  4. Informe o endereço local #

    CampoO que informar
    Domíniolocalto.net ou um dos seus próprios domínios. Para Domínio personalizado, a lista contém apenas os seus domínios.
    SubdomínioSomente para Subdomínio personalizado: o nome antes do domínio.
    Endereço IP localEndereço do serviço no seu dispositivo. Use 127.0.0.1 para este dispositivo. O formulário aceita um endereço IPv4 ou IPv6 ou localhost.
    Porta localA porta em que o seu serviço local escuta, de 1 a 65535.

    Selecione Criar túnel. O túnel aparece em Seus túneis como Tunnel # seguido do ID dele.

  5. Inicie o túnel #

    Selecione o botão de iniciar na coluna Ações. Quando o túnel está em execução, o endereço dele na coluna URL vira um link. Abra-o em um navegador. As requisições a esse endereço agora chegam ao serviço no seu dispositivo.

    Se o app Localtonet desse token estiver offline, uma caixa de diálogo avisa. Inicie o app ou selecione Iniciar mesmo assim, e o túnel entra no ar quando o app se conectar.

Seu endereço público #

  • O endereço é https:// seguido do nome do host na coluna URL.
  • Um túnel HTTP mantém o subdomínio até você excluir o túnel. Parar e iniciar não o altera.
  • O endereço não tem número de porta. Os visitantes o abrem como qualquer outro site.
  • Conexões WebSocket passam por um túnel HTTP.

HTTPS e certificados #

Os visitantes acessam um túnel HTTP por HTTPS, com um certificado que a Localtonet fornece e renova. O TLS termina no servidor da Localtonet. De lá, a requisição segue pelo túnel até o seu dispositivo, e o app Localtonet a repassa ao seu serviço.

ConfiguraçãoO que fazQuando usar
Somente HTTPS?Serve a URL pública somente por HTTPS. Uma requisição a http:// é redirecionada para o mesmo endereço em https://. Enquanto está desativada, o endereço responde nos dois.Ative para qualquer coisa que transporte logins ou dados privados.
HTTP/3 ativo?Permite que os clientes acessem a URL pública por HTTP/3. Um túnel novo já vem com isso ativado.Desative somente se algum cliente tiver problemas com HTTP/3.
SSL/TLS local?Diz ao app Localtonet para se conectar ao seu serviço local com TLS. O app aceita o certificado do serviço local como ele é, então um certificado autoassinado funciona.Ative quando o seu próprio serviço local usa HTTPS, por exemplo um servidor de desenvolvimento em https://localhost:5001.
Conexão legada?Conecta o túnel com o método legado em vez do normal.Experimente se o túnel não conseguir se conectar com o método normal.

Você encontra essas chaves em Configurações, no painel Configurações do túnel. Alterar SSL/TLS local? ou Conexão legada? em um túnel em execução o reinicia, então o app Localtonet precisa estar conectado.

Precisa de criptografia até o seu próprio serviço? Com um túnel HTTP, a Localtonet descriptografa o tráfego no servidor dela. Use um túnel TLS quando o seu serviço precisar apresentar o próprio certificado.

O cabeçalho Host #

Seu serviço recebe o nome de host que o visitante usou, que é o endereço do túnel. Alguns servidores web locais escolhem o site pelo nome de host e respondem com o site errado ou com um erro. Nesse caso, abra Cabeçalhos nas configurações do túnel e adicione um cabeçalho de requisição chamado Host com o nome que o seu servidor espera. Seu serviço passa a receber esse nome de host em vez do endereço do túnel. Veja Cabeçalhos e reescritas e Hosts virtuais.

Configurações de um túnel HTTP #

Selecione o botão de configurações na coluna Ações para abrir o painel Configurações do túnel. Em Detalhes do túnel você pode renomear o túnel e alterar o endereço IP local e a porta local. A tabela lista o que mais um túnel HTTP oferece e onde isso é explicado.

ConfiguraçãoO que fazSaiba mais
Balanceamento de cargaDistribua o tráfego entre dispositivos ou use um destino de reserva.Balanceamento de carga
Mostrar comando SSHInicie este túnel com SSH simples, sem instalar o app Localtonet.SSH sem instalação
Somente HTTPS?, HTTP/3 ativo?, SSL/TLS local?, Conexão legada?Como os visitantes e o seu serviço se conectam.Esta página, acima
Reescrever caminho?Altere o caminho da requisição antes que ela chegue ao seu serviço local.Cabeçalhos e reescritas
CabeçalhosGerencie cabeçalhos HTTP personalizados de requisição e de resposta para este túnel.Cabeçalhos e reescritas
Tempo limite HTTPDefina por quanto tempo o servidor espera uma resposta do seu aplicativo local, de 1 a 600 segundos.Cabeçalhos e reescritas
Basic Auth?Peça nome de usuário e senha aos visitantes.Controle de acesso
Restrição de IPControle quais endereços IP de clientes podem acessar este túnel.Controle de acesso
Provedores SSOOs visitantes entram com um dos seus provedores de identidade antes de poderem abrir o túnel. O botão SSO no topo da página gerencia os provedores.Login único (SSO)
Botão WAF na coluna AçõesAbre Configuração do WAF. O botão mostra se o firewall de aplicação web não está configurado, está ativo ou está inativo.Web Application Firewall
Data de expiração, Limites de velocidade, Limite de banda, Uso de banda, Tráfego de bandaPare o túnel em uma data, limite a velocidade, limite os dados, zere o contador de dados e veja o tráfego ao longo do tempo.Limites e expiração
Log de requisições, Log de atividades, Saúde do túnelInspecione requisições, revise inícios, paradas e alterações de configuração e veja as verificações de integridade.Logs e inspeção
ArgumentosEnvie este túnel por uma rede específica do seu dispositivo.Seleção de rede
Porta de saídaUse portas de saída fixas para a conexão do app Localtonet com o servidor, para firewalls rígidos.Portas
Nota do túnelSalve uma nota privada para ajudar a identificar este túnel.Referência de configurações

Provedores SSO não é exibido para um túnel que pertence a uma equipe.

Exemplos #

Compartilhar um app web #

Seu app roda no mesmo computador que o cliente Localtonet e escuta na porta 3000.

CampoValor
Tipo de URLSubdomínio aleatório
Domíniolocalto.net
Endereço IP local127.0.0.1
Porta local3000

Crie o túnel, inicie-o e envie o endereço da coluna URL às pessoas que devem ver o app. Para pedir uma senha antes, ative Basic Auth?.

Se o app roda em outra máquina da sua rede, informe o endereço dessa máquina em Endereço IP local, por exemplo 192.168.1.20. O dispositivo que executa o cliente Localtonet precisa conseguir alcançá-la.

Receber webhooks #

Um provedor de webhook precisa de um endereço HTTPS público para enviar eventos. Crie um túnel HTTP para a porta do seu receptor, inicie-o e informe no provedor o endereço do túnel mais o caminho do seu endpoint:

URL do webhook
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Teste em qualquer computador:

Terminal
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
  -H "Content-Type: application/json" \
  -d '{"event":"test"}'

Para ver o que chegou, selecione o ícone na coluna Webhooks do túnel (Ver logs de requisição e resposta). O túnel precisa estar iniciado antes. Veja Logs e inspeção.

No plano Free, adicione saldo antes de depender de webhooks. As requisições a um túnel HTTP de uma conta Free recebem primeiro uma página de aviso, e um provedor de webhook não consegue passar por ela. Veja a próxima seção.

A página de aviso no plano Free #

Quando uma conta não tem saldo, um visitante de primeira viagem do túnel HTTP dela vê uma página da Localtonet intitulada "You are about to navigate to:" com os botões Cancel e Visit Site. A página existe para desencorajar o uso indevido. Visit Site grava um cookie no navegador do visitante e abre o seu site. Enquanto o navegador mantém esse cookie, a página não é exibida de novo.

A própria página indica as duas formas de removê-la:

  • Envie um cabeçalho de requisição chamado localtonet-skip-warning com qualquer valor. Isso serve para os seus próprios scripts e clientes de API.
  • Adicione saldo à sua conta. Veja Planos e saldo.
Terminal
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/

Solução de problemas #

A caixa de diálogo diz que o token está offline, ou recebo "O app Localtonet do AuthToken “…” não está conectado."

O cliente Localtonet que usa o token deste túnel não está em execução ou não consegue alcançar a Localtonet. Inicie o cliente no dispositivo com o mesmo token. A caixa de diálogo inicia o túnel sozinha assim que o app se conecta. Com Iniciar mesmo assim, o túnel é ligado e entra no ar mais tarde.

"Inicie ou atualize o app Localtonet."

Não foi possível iniciar o túnel no dispositivo. Verifique se o cliente está em execução e instale a versão atual pela página Downloads se ele estiver desatualizado.

O navegador mostra "Tunnel Recently Started or Stopped"

A requisição chegou à Localtonet, mas o túnel não está aceitando conexões. O túnel acabou de ser iniciado ou está parado. Verifique se ele está iniciado e se a coluna Conexão mostra LIG, depois recarregue a página.

O navegador mostra uma página de erro da Localtonet que cita o meu endereço local

A página diz que o tráfego foi encaminhado pelo túnel ao agente Localtonet, mas o agente falhou ao se conectar ao serviço de destino no seu IP local e porta. O título é o erro, por exemplo ConnectionRefused. Nada está escutando nesse endereço. Inicie o seu serviço e confira o endereço IP local e a porta local em Detalhes do túnel. Você pode testar o serviço no próprio dispositivo abrindo o endereço local em um navegador.

"Você precisa comprar saldo para usar este recurso."

Subdomínio personalizado e Domínio personalizado exigem saldo. Use Subdomínio aleatório ou adicione saldo em Saldo.

"Você precisa de um saldo total de … para criar outro túnel deste tipo."

Seu saldo não cobre outro túnel. No plano Free você pode criar apenas um túnel no total, qualquer que seja o tipo. Exclua o túnel existente antes de criar outro ou adicione saldo.

"… já existe." ou "… não é permitido."

Outro túnel usa esse subdomínio, ou o nome é reservado pela Localtonet. Escolha outro subdomínio.

"ATENÇÃO! Você não tem nenhum domínio!"

Você escolheu Domínio personalizado, mas ainda não adicionou um domínio. Adicione-o primeiro no Gerenciador de DNS. Se você vir "… já está sendo usado por outro túnel.", esse domínio já pertence a um dos seus túneis. Um domínio personalizado pode atender a um só túnel.

"Atualize o limite de banda ou zere o uso de banda." ou "Atualize a data de expiração."

O túnel atingiu o próprio limite de banda ou a data de expiração e não consegue iniciar. Altere o limite ou a data nas configurações do túnel, ou zere o contador com Uso de banda. Veja Limites e expiração.

"Verifique a conexão do dispositivo."

Você alterou uma configuração que reinicia um túnel em execução enquanto o app Localtonet estava offline. Conecte o app e salve a configuração de novo, ou pare o túnel antes.

Meu app responde com o site errado ou gera links e redirecionamentos http://

Seu app decide pelo nome de host ou pelo esquema que recebe. Em Cabeçalhos, adicione um cabeçalho de requisição Host se o app espera um nome de host fixo. Adicione um cabeçalho de requisição X-Forwarded-Proto com o valor https para informar ao app que os visitantes usam HTTPS, de modo que ele gere links e redirecionamentos https://.

Suporte