Ir para o conteúdo
Localtonet Localtonet Painel

Referência de configurações do túnel

Ajuda com esta página
Nesta página 15 seções
  1. Abrir as configurações de um túnel
  2. Abra a página do tipo de túnel
  3. Selecione Configurações na linha do túnel
  4. Alterar uma configuração
  5. Como as alterações são aplicadas
  6. Qual tipo de túnel tem qual configuração
  7. O que cada configuração faz
  8. Detalhes do túnel
  9. Nota do túnel
  10. SSL/TLS local?
  11. Protocolo PROXY?
  12. Conexão legada?
  13. IP do servidor local
  14. IP do túnel
  15. Configurações na lista de túneis
  16. Trocar o servidor
  17. Trocar o AuthToken
  18. Firewall de aplicação web
  19. As mesmas configurações pela API
  20. Solução de problemas
  21. 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 #

  1. 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.

  2. 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.

  3. 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çãoReiniciam 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çãoHTTPTCP - UDPTLSServidor de arquivosServidor proxyProxy rotativoGateway MCP
Somente HTTPS?Sim–––––Sim
Reescrever caminho?Sim––––––
Basic Auth?Sim––Sim, tipo Default––Sim
SSL/TLS local?SimSim, exceto para UDPSim––––
HTTP/3 ativo?Sim–––––Sim
Porta reservada?–Sim––SimSim–
Protocolo PROXY?–Sim, exceto para UDP–––––
Conexão legada?SimSimSimSimSim–Sim
Modo SSL––Sim––––
Provedores SSOSim, exceto em túneis de equipe––––––
Token do gateway––––––Sim
CabeçalhosSim––––––
Tempo limite HTTPSim–––––Sim
Porta do servidor–Sim––Sim, exceto para VLESSSim–
Nota do túnelSimSimSimSimSimSimSim
IP do servidor localSomente servidor localSomente servidor localSomente servidor local–Somente servidor local–Somente servidor local
ArgumentosSimSimSim–Sim––
Restrição de IPSimSimSimSimSimSimSim
Data de expiraçãoSimSimSimSimSim–Sim
Limites de velocidadeSimSimSimSimSim–Sim
Porta de saídaSimSimSimSimSimSimSim
Limite de bandaSimSimSimSimSim–Sim
Tráfego de bandaSimSimSimSimSimSimSim
Uso de bandaSimSimSimSimSim–Sim
IP do túnel–SimSim–SimSim–
Log de requisiçõesSimSimSimSimSim–Sim
Log de atividadesSimSimSimSimSimSimSim
Saúde do túnelSimSimSim–SimSimSim

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çãoO que fazDetalhes
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 SSLDefine se o Localtonet cuida do HTTPS de um túnel TLS ou repassa o tráfego criptografado ao seu serviço.TLS
Provedores SSOFaz os visitantes entrarem com um dos seus provedores de identidade antes de poderem abrir o túnel.Login único (SSO)
Token do gatewayMostra o token que seus clientes MCP enviam para se conectar ao gateway.Gateway MCP
CabeçalhosAdiciona cabeçalhos fixos de requisição e de resposta.Cabeçalhos e reescritas
Tempo limite HTTPDefine por quanto tempo o túnel espera que o seu serviço responda a uma requisição.Cabeçalhos e reescritas
Porta do servidorAltera a porta à qual as pessoas se conectam no servidor do Localtonet.Portas
Nota do túnelUm lembrete privado do propósito do túnel.Esta página
IP do servidor localOs endereços pelos quais o seu servidor local pode ser acessado.Esta página
ArgumentosEnvia o túnel por uma rede específica do dispositivo.Seleção de rede
Restrição de IPEscolhe quais endereços IP podem se conectar ao túnel.Controle de acesso
Data de expiraçãoPara o túnel em uma data definida.Limites e expiração
Limites de velocidadeLimita a velocidade de upload e de download.Limites e expiração
Porta de saídaMantém fixas as portas pelas quais o app Localtonet faz conexões de saída, para firewalls restritivos.Portas
Limite de bandaPara o túnel depois que ele movimentar uma quantidade definida de dados.Limites e expiração
Tráfego de bandaMostra em gráfico os dados que passaram pelo túnel.Limites e expiração
Uso de bandaZera o contador de dados do túnel.Limites e expiração
IP do túnelMostra os endereços IP do servidor em que o túnel é executado.Esta página
Log de requisiçõesMostra as requisições ou conexões registradas para o túnel.Logs e inspeção
Log de atividadesLista inicializações, paradas e alterações de configuração.Logs e inspeção
Saúde do túnelMostra 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álogoO que informarRegras
Renomear túnelUm 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 localOnde 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 localA 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çãoCaminho depois de /api/v2/tunnels/<TUNNEL_ID>/
Restrição de IPip-restrictions
Cabeçalhosheaders, host-header
Basic Authauthentication
Data de expiraçãoexpiration
Porta do servidorserver-port
Tempo limite HTTPhttp-timeout
Limites de velocidaderate-limit
Limite e uso de bandabandwidth-limit, bandwidth-usage, bandwidth-usage/reset
Argumentosarguments
Somente HTTPS?, HTTP/3 ativo?, Reescrever caminho?https-only, http3, path-rewrite
SSL/TLS local?, Protocolo PROXY?, Modo SSLssl-stream, proxy-protocol, pass-through
Nota do túnelnote
Servidorserver

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?.

Suporte