Ir para o conteúdo
Localtonet Localtonet Painel

Cabeçalhos, reescrita de caminho e opções de HTTP

Ajuda com esta página
Nesta página 11 seções
  1. Antes de começar
  2. Cabeçalhos HTTP
  3. Adicionar um cabeçalho
  4. Escolha o tipo de cabeçalho
  5. Adicione o cabeçalho
  6. Salve
  7. Conjuntos prontos
  8. Cabeçalhos sugeridos
  9. Regras
  10. Cabeçalho Host
  11. Reescrever caminho
  12. Mude Reescrever caminho? para Sim
  13. Digite o caminho a adicionar
  14. Salve
  15. Tempo limite HTTP
  16. Somente HTTPS?
  17. HTTP/3 ativo?
  18. Exemplos
  19. Deixe um aplicativo web de outro site chamar a sua API
  20. Publique um aplicativo que fica em um subcaminho
  21. As mesmas configurações pela API
  22. Solução de problemas
  23. Páginas relacionadas

Altere como as requisições e respostas HTTP passam por um túnel: adicione cabeçalhos fixos, defina o cabeçalho Host que o seu serviço recebe, coloque um caminho na frente de toda requisição, defina o tempo limite da requisição e escolha somente HTTPS ou HTTP/3 para o endereço público.

Antes de começar #

  • Um túnel HTTP. Veja HTTP / HTTPS.
  • As configurações ficam no painel de configurações do túnel: abra Meus túneis › HTTP e selecione Configurações na linha do túnel.
ConfiguraçãoHTTPGateway MCP
CabeçalhosSim–
Reescrever caminho?Sim–
Tempo limite HTTPSimSim
Somente HTTPS?SimSim
HTTP/3 ativo?SimSim

Nenhuma dessas configurações reinicia o túnel. Uma alteração é aplicada ao túnel em execução assim que você a salva.

Cabeçalhos HTTP #

Cabeçalhos › Gerenciar abre a caixa de diálogo Cabeçalhos HTTP. Ela adiciona cabeçalhos fixos ao tráfego que passa pelo túnel:

  • Os Cabeçalhos de requisição chegam ao seu serviço local em toda requisição.
  • Os Cabeçalhos de resposta chegam ao visitante em toda resposta.

Os valores são enviados exatamente como você os digita.

Adicionar um cabeçalho #

  1. Escolha o tipo de cabeçalho #

    Selecione Cabeçalhos de requisição ou Cabeçalhos de resposta no alto da caixa de diálogo. Cada aba mostra quantos cabeçalhos ela contém.

  2. Adicione o cabeçalho #

    Selecione Adicionar cabeçalho e preencha Nome e Valor, ou selecione um nome em Sugestões para obter uma linha com um valor inicial adequado. Para um cabeçalho que a caixa de diálogo conhece, o ícone de informação na linha explica o que ele faz.

  3. Salve #

    Selecione Salvar. Para remover um cabeçalho, selecione o botão de remover da linha dele e depois Salvar.

Conjuntos prontos #

Na aba Cabeçalhos de resposta, os Conjuntos prontos adicionam um grupo de cabeçalhos de uma só vez. A caixa de diálogo então diz "NAME adicionado. Confira os valores e salve." Um conjunto só preenche um cabeçalho que já está na lista se o valor dele estiver vazio.

ConjuntoCabeçalhos que adicionaUse para
Permitir CORS
  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS
  • Access-Control-Allow-Headers: Content-Type, Authorization
Permite que aplicativos web de outros sites chamem este túnel.
Cabeçalhos de segurança
  • Strict-Transport-Security: max-age=31536000; includeSubDomains
  • X-Content-Type-Options: nosniff
  • X-Frame-Options: SAMEORIGIN
  • Referrer-Policy: strict-origin-when-cross-origin
HSTS, nosniff, proteção contra frames e política de referrer.
Desativar cacheCache-Control: no-storeImpede que navegadores e proxies façam cache das respostas.
Ocultar dos buscadoresX-Robots-Tag: noindex, nofollowPede aos mecanismos de busca que não listem este endereço.

Cabeçalhos sugeridos #

CabeçalhoTipoO que a caixa de diálogo diz sobre ele
HostRequisiçãoSeu serviço recebe este nome de host no lugar do endereço do túnel. Útil quando um servidor web local escolhe o site pelo nome do host.
AuthorizationRequisiçãoEnvia as mesmas credenciais ao seu serviço em toda requisição.
X-API-KeyRequisiçãoUma chave fixa para serviços que esperam uma em um cabeçalho.
X-Forwarded-ProtoRequisiçãoInforma ao seu aplicativo que os visitantes usam HTTPS, para que ele monte links e redirecionamentos https://.
OriginRequisiçãoAlguns serviços só aceitam requisições de uma origem conhecida.
Access-Control-Allow-OriginRespostaQuais sites podem chamar este túnel a partir de um navegador. * permite qualquer site.
Access-Control-Allow-CredentialsRespostaPermite que os navegadores enviem cookies. Não funciona junto com Access-Control-Allow-Origin: *.
Strict-Transport-SecurityRespostaDiz aos navegadores para sempre usar HTTPS neste endereço.
X-Frame-OptionsRespostaImpede que outros sites exibam suas páginas em um frame.
Content-Security-PolicyRespostaControla de onde as páginas podem carregar scripts, estilos e imagens. Uma política rígida pode quebrar páginas, então teste-a.
Cache-ControlRespostano-store impede que navegadores e proxies façam cache das respostas.
X-Robots-TagRespostaPede aos mecanismos de busca que não listem este endereço.

As sugestões também incluem User-Agent, Accept-Language e Cache-Control para requisições, e Access-Control-Allow-Methods, Access-Control-Allow-Headers, X-Content-Type-Options, Referrer-Policy e Permissions-Policy para respostas. Você também pode digitar qualquer outro nome de cabeçalho.

Regras #

  • Os nomes de cabeçalho podem usar letras, números e hifens, por exemplo X-Api-Key, e ter até 256 caracteres.
  • Um nome pode aparecer uma vez por aba. Uma segunda linha com o mesmo nome é recusada com "NAME já está nesta lista."
  • Uma linha precisa de um nome. Uma linha vazia é ignorada ao salvar.

Cabeçalho Host #

Por padrão, o seu serviço recebe o endereço do túnel como o nome do host de uma requisição. Para enviar outro nome de host, adicione o cabeçalho de requisição Host na caixa de diálogo Cabeçalhos HTTP e defina o valor dele como o nome que o seu serviço espera, por exemplo localhost ou shop.internal.

Use isto quando um servidor web local escolhe o site pelo nome do host, como um virtual host do Apache ou do nginx, o IIS com associações de host ou um servidor de desenvolvimento que só responde por localhost. Veja Hosts virtuais para um exemplo completo.

Reescrever caminho #

Uma reescrita de caminho adiciona um caminho na frente de toda requisição antes que ela chegue ao seu serviço local. Os visitantes continuam usando o endereço curto.

  1. Mude Reescrever caminho? para Sim #

    A caixa de diálogo Reescrever caminho abre.

  2. Digite o caminho a adicionar #

    Digite-o em Caminho a adicionar, por exemplo /api ou /app/v2, ou selecione um dos Caminhos comuns. O caminho começa com uma barra; se você omitir a barra, ela é adicionada para você. A caixa Exemplo mostra o resultado para uma requisição de amostra.

  3. Salve #

    Selecione Salvar.

Com /api como caminho:

O visitante abreSeu serviço recebe
https://<YOUR_TUNNEL_ADDRESS>/orders?id=7/api/orders?id=7

Um túnel tem um caminho, com até 200 caracteres. Ele não pode conter espaços e não pode ser apenas /. Para removê-lo, mude Reescrever caminho? para Não e confirme Desativar a reescrita de caminho?: o caminho salvo é removido e as requisições chegam ao seu serviço com o caminho original.

Tempo limite HTTP #

Tempo limite HTTP › Gerenciar abre a caixa de diálogo Tempo limite da requisição. O tempo limite é quanto tempo o túnel espera que o seu serviço responda a uma requisição. Depois disso, o visitante recebe um erro de tempo limite.

ItemValores
Tempo limiteUm número inteiro de 1 a 600 segundos. Deixe vazio para usar o padrão do servidor.
PredefiniçõesPadrão do servidor, 30 s, 1 min, 2 min, 5 min, 10 min

Aumente o tempo limite para relatórios lentos, uploads grandes ou long polling. Escolha Padrão do servidor para voltar ao valor padrão.

Somente HTTPS? #

Mude Somente HTTPS? para Sim e confirme Ativar somente HTTPS? para servir a URL pública apenas por HTTPS. Use isso para tudo que envolva logins ou dados pessoais, para que ninguém acesse o túnel por HTTP simples.

HTTP/3 ativo? #

Mude HTTP/3 ativo? para Sim para permitir que os clientes acessem a URL pública por HTTP/3. Os clientes que não oferecem suporte a HTTP/3 continuam usando as versões anteriores do HTTP.

Exemplos #

Deixe um aplicativo web de outro site chamar a sua API #

Seu front-end roda em https://app.example.com e chama uma API atrás de um túnel. Abra Cabeçalhos › Gerenciar, vá para Cabeçalhos de resposta e selecione Permitir CORS. Substitua o * de Access-Control-Allow-Origin por https://app.example.com se somente esse site puder chamar a API e depois selecione Salvar.

Publique um aplicativo que fica em um subcaminho #

Seu servidor de aplicativo serve o aplicativo em /app/v2 e você quer que os visitantes abram o endereço simples do túnel. Ative Reescrever caminho? e digite /app/v2. Um visitante que abre /login chega a /app/v2/login no seu serviço.

As mesmas configurações pela API #

Estas configurações também estão disponíveis em /api/v2/tunnels/<TUNNEL_ID>/: headers, host-header, path-rewrite, http-timeout, https-only e http3. Veja API.

Solução de problemas #

"Nomes de cabeçalho podem usar letras, números e hifens, por exemplo X-Api-Key."

O nome contém um caractere que não é permitido em um nome de cabeçalho, como um espaço ou dois-pontos. Digite apenas o nome em Nome e o restante em Valor.

"Dê um nome a este cabeçalho ou remova a linha."

Uma linha tem valor, mas não tem nome. Preencha o nome ou remova a linha.

"Informe apenas o caminho, sem http:// nem o nome do host."

Caminho a adicionar aceita um caminho como /api, não uma URL completa.

"Informe um número inteiro de 1 a 600 ou escolha Padrão do servidor."

O tempo limite deve ficar entre 1 e 600 segundos. Para uma tarefa mais longa, responda à requisição primeiro e deixe o cliente pedir o resultado depois.

Meu cabeçalho CORS não funciona com cookies

Access-Control-Allow-Credentials não funciona junto com Access-Control-Allow-Origin: *. Defina Access-Control-Allow-Origin como a origem exata do site que faz a chamada.

Meu serviço local usa HTTPS e o túnel mostra um erro

Isso não é um problema de cabeçalho. Ative HTTPS local?, que informa ao túnel que o seu próprio serviço local usa HTTPS. Veja Referência de configurações.

Suporte