Criar um túnel HTTP
Nesta página 10 seções
- Antes de começar
- Passos
- Abra a página HTTP
- Escolha o tipo de URL
- Escolha o dispositivo e a região
- Informe o endereço local
- Inicie o túnel
- Seu endereço público
- HTTPS e certificados
- O cabeçalho Host
- Configurações de um túnel HTTP
- Exemplos
- Compartilhar um app web
- Receber webhooks
- A página de aviso no plano Free
- Solução de problemas
- 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 #
-
Abra a página HTTP #
Abra Meus túneis › HTTP e selecione Criar túnel HTTP para abrir o formulário.
-
Escolha o tipo de URL #
Tipo de URL Endereço que você recebe Requisitos Subdomínio aleatório Um nome gerado no domínio selecionado, por exemplo https://<RANDOM_NAME>.localto.net.Nada além disso Subdomínio personalizado O nome que você digita em Subdomínio, por exemplo https://myapp.localto.net. São permitidos letras, dígitos e hifens.Saldo Domínio personalizado Um domínio seu, selecionado em Domínio. Saldo e um domínio no Gerenciador de DNS -
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.
-
Informe o endereço local #
Campo O que informar Domínio localto.netou um dos seus próprios domínios. Para Domínio personalizado, a lista contém apenas os seus domínios.Subdomínio Somente para Subdomínio personalizado: o nome antes do domínio. Endereço IP local Endereço do serviço no seu dispositivo. Use 127.0.0.1para este dispositivo. O formulário aceita um endereço IPv4 ou IPv6 oulocalhost.Porta local A 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. -
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ção | O que faz | Quando 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ção | O que faz | Saiba mais |
|---|---|---|
| Balanceamento de carga | Distribua o tráfego entre dispositivos ou use um destino de reserva. | Balanceamento de carga |
| Mostrar comando SSH | Inicie 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çalhos | Gerencie cabeçalhos HTTP personalizados de requisição e de resposta para este túnel. | Cabeçalhos e reescritas |
| Tempo limite HTTP | Defina 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 IP | Controle quais endereços IP de clientes podem acessar este túnel. | Controle de acesso |
| Provedores SSO | Os 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ções | Abre 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 banda | Pare 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únel | Inspecione requisições, revise inícios, paradas e alterações de configuração e veja as verificações de integridade. | Logs e inspeção |
| Argumentos | Envie este túnel por uma rede específica do seu dispositivo. | Seleção de rede |
| Porta de saída | Use portas de saída fixas para a conexão do app Localtonet com o servidor, para firewalls rígidos. | Portas |
| Nota do túnel | Salve 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.
| Campo | Valor |
|---|---|
| Tipo de URL | Subdomínio aleatório |
| Domínio | localto.net |
| Endereço IP local | 127.0.0.1 |
| Porta local | 3000 |
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:
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>Teste em qualquer computador:
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-warningcom qualquer valor. Isso serve para os seus próprios scripts e clientes de API. - Adicione saldo à sua conta. Veja Planos e saldo.
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://.