Referência de configurações do túnel
Nesta página 15 seções
- Abrir as configurações de um túnel
- Abra a página do tipo de túnel
- Selecione Configurações na linha do túnel
- Alterar uma configuração
- Como as alterações são aplicadas
- Qual tipo de túnel tem qual configuração
- O que cada configuração faz
- Detalhes do túnel
- Nota do túnel
- SSL/TLS local?
- Protocolo PROXY?
- Conexão legada?
- IP do servidor local
- IP do túnel
- Configurações na lista de túneis
- Trocar o servidor
- Trocar o AuthToken
- Firewall de aplicação web
- As mesmas configurações pela API
- Solução de problemas
- Páginas relacionadas
Todo túnel tem um painel de configurações no painel de controle. Esta página mostra onde abri-lo, lista cada configuração, informa quais tipos de túnel a têm e aponta para a página que a explica em detalhes.
Abrir as configurações de um túnel #
-
Abra a página do tipo de túnel #
No menu do painel, abra Meus túneis e escolha o tipo: Meus túneis › HTTP, TCP - UDP, TLS, Servidor de arquivos, Servidor proxy, Proxy rotativo ou Gateway MCP.
-
Selecione Configurações na linha do túnel #
Encontre o túnel em Seus túneis e selecione Configurações na coluna Ações. O painel Configurações do túnel abre na lateral da página.
-
Alterar uma configuração #
O painel tem estas partes:
- Detalhes do túnel: detalhes como o endereço do túnel, a data de criação e o nome do AuthToken, além dos valores que você pode editar ao selecioná-los: o título em todos os tipos de túnel e também o endereço local e a porta local em túneis HTTP, TCP - UDP e TLS.
- Os destinos de balanceamento de carga do túnel, nos tipos de túnel que os suportam. Veja Balanceamento de carga.
- Mostrar comando SSH, nos tipos de túnel que podem ser iniciados com SSH simples. Veja SSH sem instalação.
- Configurações: uma linha por configuração. Cada linha tem um interruptor Sim / Não ou um botão (Gerenciar, Alterar, Mostrar ou Limpar) que abre uma caixa de diálogo. O ícone de informação ao lado de um rótulo explica a configuração em uma frase.
A maioria dos interruptores pede confirmação antes de mudar qualquer coisa, por exemplo Ativar somente HTTPS? com os botões Ativar e Cancelar. Ativar Basic Auth? ou Reescrever caminho? abre uma caixa de diálogo, e ativar Porta reservada? em um túnel em execução reserva a porta sem perguntar nada.
Como as alterações são aplicadas #
Algumas configurações são aplicadas a um túnel em execução sem interrompê-lo. Outras param o túnel e o iniciam de novo com o novo valor, o que leva um instante e derruba as conexões abertas.
| Aplicadas sem reinicialização | Reiniciam um túnel em execução |
|---|---|
| Somente HTTPS?, Reescrever caminho?, HTTP/3 ativo?, Porta reservada?, Cabeçalhos, Tempo limite HTTP, Nota do túnel, Restrição de IP, Data de expiração, Porta de saída, Limite de banda, Uso de banda, o interruptor do WAF | O título, o endereço local e a porta local em Detalhes do túnel, Basic Auth?, SSL/TLS local?, Protocolo PROXY?, Conexão legada?, Porta do servidor, Argumentos, IP do servidor local, Limites de velocidade, a troca de servidor e a troca de AuthToken |
Uma configuração que reinicia o túnel só pode ser salva em um túnel em execução enquanto o app Localtonet do dispositivo dele estiver conectado. Caso contrário, o painel responde "Verifique a conexão do dispositivo." e mantém o valor antigo. Em um túnel parado, o valor é salvo e usado na próxima inicialização.
Qual tipo de túnel tem qual configuração #
Os rótulos são os que a seção Configurações mostra. "Sim" significa que o tipo de túnel tem a linha.
| Configuração | HTTP | TCP - UDP | TLS | Servidor de arquivos | Servidor proxy | Proxy rotativo | Gateway MCP |
|---|---|---|---|---|---|---|---|
| Somente HTTPS? | Sim | – | – | – | – | – | Sim |
| Reescrever caminho? | Sim | – | – | – | – | – | – |
| Basic Auth? | Sim | – | – | Sim, tipo Default | – | – | Sim |
| SSL/TLS local? | Sim | Sim, exceto para UDP | Sim | – | – | – | – |
| HTTP/3 ativo? | Sim | – | – | – | – | – | Sim |
| Porta reservada? | – | Sim | – | – | Sim | Sim | – |
| Protocolo PROXY? | – | Sim, exceto para UDP | – | – | – | – | – |
| Conexão legada? | Sim | Sim | Sim | Sim | Sim | – | Sim |
| Modo SSL | – | – | Sim | – | – | – | – |
| Provedores SSO | Sim, exceto em túneis de equipe | – | – | – | – | – | – |
| Token do gateway | – | – | – | – | – | – | Sim |
| Cabeçalhos | Sim | – | – | – | – | – | – |
| Tempo limite HTTP | Sim | – | – | – | – | – | Sim |
| Porta do servidor | – | Sim | – | – | Sim, exceto para VLESS | Sim | – |
| Nota do túnel | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| IP do servidor local | Somente servidor local | Somente servidor local | Somente servidor local | – | Somente servidor local | – | Somente servidor local |
| Argumentos | Sim | Sim | Sim | – | Sim | – | – |
| Restrição de IP | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| Data de expiração | Sim | Sim | Sim | Sim | Sim | – | Sim |
| Limites de velocidade | Sim | Sim | Sim | Sim | Sim | – | Sim |
| Porta de saída | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| Limite de banda | Sim | Sim | Sim | Sim | Sim | – | Sim |
| Tráfego de banda | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| Uso de banda | Sim | Sim | Sim | Sim | Sim | – | Sim |
| IP do túnel | – | Sim | Sim | – | Sim | Sim | – |
| Log de requisições | Sim | Sim | Sim | Sim | Sim | – | Sim |
| Log de atividades | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| Saúde do túnel | Sim | Sim | Sim | – | Sim | Sim | Sim |
As páginas Servidor proxy e Proxy rotativo têm mais linhas próprias, como Autenticação do proxy, Controle de acesso, Proxy upstream, Acesso VPN, Teste de velocidade, Token do túnel e Somente IPv4?. Elas são descritas em Servidor proxy e Proxy rotativo. Um túnel que usa o servidor Local não tem a linha Porta de saída. "Somente servidor local" também inclui um túnel cuja coluna Servidor mostra VPN.
O que cada configuração faz #
| Configuração | O que faz | Detalhes |
|---|---|---|
| Somente HTTPS? | Serve a URL pública somente por HTTPS. | Cabeçalhos e reescritas |
| Reescrever caminho? | Adiciona um caminho na frente de cada requisição antes que ela chegue ao seu serviço local. | Cabeçalhos e reescritas |
| Basic Auth? | Pede nome de usuário e senha aos visitantes. | Controle de acesso |
| SSL/TLS local? | Informa ao túnel que o seu próprio serviço local usa HTTPS ou TLS. | Esta página |
| HTTP/3 ativo? | Permite que os clientes acessem a URL pública por HTTP/3. | Cabeçalhos e reescritas |
| Porta reservada? | Mantém a mesma porta do servidor quando o túnel é reiniciado. | Portas |
| Protocolo PROXY? | Repassa o endereço original do cliente ao seu serviço em um cabeçalho do protocolo PROXY. | Esta página |
| Conexão legada? | Um método de conexão alternativo para tentar quando o túnel não consegue se conectar pelo método normal. | Esta página |
| Modo SSL | Define se o Localtonet cuida do HTTPS de um túnel TLS ou repassa o tráfego criptografado ao seu serviço. | TLS |
| Provedores SSO | Faz os visitantes entrarem com um dos seus provedores de identidade antes de poderem abrir o túnel. | Login único (SSO) |
| Token do gateway | Mostra o token que seus clientes MCP enviam para se conectar ao gateway. | Gateway MCP |
| Cabeçalhos | Adiciona cabeçalhos fixos de requisição e de resposta. | Cabeçalhos e reescritas |
| Tempo limite HTTP | Define por quanto tempo o túnel espera que o seu serviço responda a uma requisição. | Cabeçalhos e reescritas |
| Porta do servidor | Altera a porta à qual as pessoas se conectam no servidor do Localtonet. | Portas |
| Nota do túnel | Um lembrete privado do propósito do túnel. | Esta página |
| IP do servidor local | Os endereços pelos quais o seu servidor local pode ser acessado. | Esta página |
| Argumentos | Envia o túnel por uma rede específica do dispositivo. | Seleção de rede |
| Restrição de IP | Escolhe quais endereços IP podem se conectar ao túnel. | Controle de acesso |
| Data de expiração | Para o túnel em uma data definida. | Limites e expiração |
| Limites de velocidade | Limita a velocidade de upload e de download. | Limites e expiração |
| Porta de saída | Mantém fixas as portas pelas quais o app Localtonet faz conexões de saída, para firewalls restritivos. | Portas |
| Limite de banda | Para o túnel depois que ele movimentar uma quantidade definida de dados. | Limites e expiração |
| Tráfego de banda | Mostra em gráfico os dados que passaram pelo túnel. | Limites e expiração |
| Uso de banda | Zera o contador de dados do túnel. | Limites e expiração |
| IP do túnel | Mostra os endereços IP do servidor em que o túnel é executado. | Esta página |
| Log de requisições | Mostra as requisições ou conexões registradas para o túnel. | Logs e inspeção |
| Log de atividades | Lista inicializações, paradas e alterações de configuração. | Logs e inspeção |
| Saúde do túnel | Mostra os resultados das verificações de saúde periódicas. | Logs e inspeção |
Detalhes do túnel #
Selecione um valor em Detalhes do túnel para editá-lo. Salvar qualquer um dos três reinicia um túnel em execução. O endereço local e a porta local podem ser editados aqui em túneis HTTP, TCP - UDP e TLS; os outros tipos de túnel mostram apenas o título.
| Caixa de diálogo | O que informar | Regras |
|---|---|---|
| Renomear túnel | Um nome que você reconheça na sua lista de túneis, por exemplo "NAS do escritório". | Obrigatório. Até 30 caracteres: a caixa de diálogo conta até 100, mas um título com mais de 30 é recusado com "O título não pode ter mais de 30 caracteres." |
| Endereço local | Onde o app Localtonet encontra o seu serviço. Use 127.0.0.1 quando o serviço é executado no mesmo dispositivo que o app. Para acessar outro dispositivo da sua rede, informe o endereço dele, por exemplo 192.168.1.20. | Um endereço IPv4, um endereço IPv6 ou um nome de host. Sem http://, sem caminho, sem porta. |
| Porta local | A porta em que o seu serviço escuta, no dispositivo que o executa. | Um número de 1 a 65535. |
Nota do túnel #
Nota do túnel › Gerenciar abre a caixa de diálogo Nota. Uma nota é um lembrete do propósito do túnel, e somente a sua conta a vê.
- Uma nota pode ter até 499 caracteres. A caixa de diálogo os conta enquanto você digita.
- As opções em Rótulo colocam um rótulo na frente da nota: Produção, Homologação, Testes, Demo ou Temporário. A nota passa então a começar com, por exemplo,
Staging -. Escolher outro rótulo substitui o que já está lá.
SSL/TLS local? #
Ative SSL/TLS local? quando o seu próprio serviço local usa HTTPS ou TLS, por exemplo um servidor de desenvolvimento que só escuta em https://localhost. Deixe desativado para um serviço que fala HTTP simples ou TCP simples. Túneis HTTP, TCP e TLS têm o interruptor; um túnel UDP não tem.
Protocolo PROXY? #
Com Protocolo PROXY? ativado, o túnel repassa o endereço original do cliente ao seu serviço em um cabeçalho do protocolo PROXY. Ative-o somente quando o seu serviço estiver configurado para ler esse cabeçalho, pois um serviço que não o espera vê bytes desconhecidos no início de cada conexão. Túneis TCP têm o interruptor; um túnel UDP não tem.
Conexão legada? #
Conexão legada? muda o túnel para um método de conexão alternativo. Experimente se o túnel não conseguir se conectar pelo método normal e desative-o de novo se não ajudar.
IP do servidor local #
Esta linha aparece somente em túneis cuja coluna Servidor mostra Local ou VPN. A caixa de diálogo IP do servidor local contém os endereços pelos quais o seu servidor local pode ser acessado: um Endereço IPv4 e, opcionalmente, um Endereço IPv6. Deixe o IPv6 vazio se você não o usa. É obrigatório pelo menos um endereço. Um endereço que só funciona no próprio dispositivo, como 127.0.0.1, 0.0.0.0 ou ::1, é recusado com "O IP do servidor local precisa ser acessível de fora."
IP do túnel #
IP do túnel › Mostrar abre a caixa de diálogo IP do servidor com o endereço IPv4 e, quando o servidor tem um, o endereço IPv6 do servidor em que o túnel é executado. Os clientes podem se conectar ao túnel com esse endereço em vez do nome de domínio.
Os endereços IP do servidor podem mudar. Use o nome de domínio em apps e scripts sempre que puder.
Configurações na lista de túneis #
Duas configurações são alteradas pela lista de túneis, e não pelo painel.
Trocar o servidor #
Selecione o código do servidor na coluna Servidor, escolha outro servidor na caixa de diálogo Trocar servidor e selecione Enviar. Um túnel em execução é reiniciado no novo servidor.
- Trocar o servidor exige saldo. Sem ele, o painel responde "Você precisa comprar saldo para usar este recurso."
- Se a porta do servidor do túnel já estiver em uso no novo servidor, você recebe "A porta do seu túnel (PORT) não está disponível no servidor selecionado. Altere a porta primeiro." Altere a porta como descrito em Portas e tente de novo.
- Túneis cuja coluna Servidor mostra Local ou VPN não podem ser movidos.
Quando o servidor é trocado, as atualizações de DNS podem levar até 3 horas.
Trocar o AuthToken #
Selecione o nome do token na coluna AuthToken para abrir Trocar AuthToken, escolha outro AuthToken e selecione Enviar. Isso move o túnel para o dispositivo que executa o app Localtonet com esse token.
- Um túnel em execução para, espera 2 segundos e reinicia usando o AuthToken selecionado. Um túnel parado continua parado.
- Se o app com o novo token não estiver conectado, o token é trocado mesmo assim e você recebe "O AuthToken foi atualizado, mas não foi possível reiniciar o túnel. Conecte o app Localtonet com o token selecionado e inicie o túnel."
- Túneis de Proxy rotativo usam grupos de AuthTokens. Altere os grupos em vez disso.
Os AuthTokens são explicados em AuthTokens.
Firewall de aplicação web #
Túneis HTTP e de Gateway MCP também têm um botão de escudo na coluna Ações. Ele abre o firewall do túnel. Veja Firewall de aplicação web.
As mesmas configurações pela API #
A maioria das configurações também pode ser lida e alterada pela API, no caminho do túnel. A autenticação e a referência completa estão em API.
| Configuração | Caminho depois de /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| Restrição de IP | ip-restrictions |
| Cabeçalhos | headers, host-header |
| Basic Auth | authentication |
| Data de expiração | expiration |
| Porta do servidor | server-port |
| Tempo limite HTTP | http-timeout |
| Limites de velocidade | rate-limit |
| Limite e uso de banda | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Argumentos | arguments |
| Somente HTTPS?, HTTP/3 ativo?, Reescrever caminho? | https-only, http3, path-rewrite |
| SSL/TLS local?, Protocolo PROXY?, Modo SSL | ssl-stream, proxy-protocol, pass-through |
| Nota do túnel | note |
| Servidor | server |
Solução de problemas #
"Verifique a conexão do dispositivo."
A configuração reinicia o túnel, e o app Localtonet do dispositivo do túnel não está conectado. Inicie o app no dispositivo, espere até que a coluna Conexão mostre LIG e salve de novo. Você também pode parar o túnel primeiro: em um túnel parado, o valor é salvo sem reinicialização.
"Você precisa comprar saldo para usar este recurso."
A configuração exige saldo na conta. Isso vale para portas reservadas, uma porta de servidor personalizada, portas de saída fixas, restrições de IP e a troca de servidor. Veja Planos e saldo.
"Você não tem permissão para atualizar este túnel."
Você trabalha em uma equipe e a sua função não inclui alterar túneis. Peça ao proprietário da equipe que lhe dê essa permissão. Veja Gerenciamento de equipe.
Uma linha da tabela não aparece no meu painel
O painel mostra apenas as linhas do tipo do túnel, e algumas linhas dependem do próprio túnel: IP do servidor local exige o servidor Local ou VPN, Provedores SSO não aparece em túneis de equipe, e um túnel UDP não tem SSL/TLS local? nem Protocolo PROXY?.