Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Formação DevOps

    O que é X-Forwarded-Host?

    O X-Forwarded-Host preserva o host solicitado pelo cliente ao atravessar um proxy. Seu uso depende da configuração de confiança e do tratamento do cabeçalho.

    Também chamado de: XFH

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    O nome público depois do encaminhamento

    O X-Forwarded-Host é um cabeçalho HTTP usado por proxies para informar o host originalmente solicitado pelo cliente. Ele permite recuperar o nome público quando o intermediário modifica o cabeçalho Host ao encaminhar a requisição para a aplicação.

    Um proxy reverso recebe a conexão externa e faz outra requisição ao serviço interno. Esses dois trechos podem usar nomes diferentes. A aplicação consegue gerar um link com o domínio público ao interpretar a informação encaminhada, desde que ela venha de um proxy configurado como confiável.

    Dois nomes na requisição interna

    Este exemplo didático mostra os cabeçalhos que um proxy poderia enviar à aplicação depois de receber uma requisição para portal.example.com:

    Host: app-interna:3000
    X-Forwarded-Host: portal.example.com

    Os cabeçalhos identificam dois destinos relacionados: app-interna:3000 é o serviço interno que recebe a requisição e portal.example.com é o nome público preservado pelo proxy. Ao interpretar X-Forwarded-Host, a aplicação pode gerar links com esse domínio público.

    Esse par de cabeçalhos ilustra uma configuração possível. O proxy também pode preservar o Host original, por isso você precisa conferir os valores recebidos pela aplicação e o tratamento configurado para eles.

    Confiança no proxy e suporte da aplicação

    No Express, a opção trust proxy afeta a origem do valor de req.hostname, que pode ser derivado de X-Forwarded-Host. O próprio cliente pode enviar esse cabeçalho. Ao configurar a confiança, confira se o último proxy confiável remove ou sobrescreve valores externos que a aplicação não deve aceitar.

    O X-Forwarded-Host é uma convenção difundida. O parâmetro host do cabeçalho padronizado Forwarded tem função relacionada, mas o suporte depende da implementação. Nenhum dos dois autentica o cliente ou concede permissão de acesso ao site.

    Dúvidas frequentes

    Perguntas frequentes sobre X-Forwarded-Host

    O X-Forwarded-Host também informa o protocolo externo?
    Esse cabeçalho identifica o host original. A indicação de HTTP ou HTTPS costuma usar X-Forwarded-Proto, que precisa do mesmo cuidado com a confiança no proxy.
    Ativar trust proxy no Express torna o valor confiável?
    A opção faz o Express usar informações encaminhadas conforme a configuração. O último proxy confiável precisa remover ou sobrescrever cabeçalhos externos indevidos, pois o cliente também pode enviar esses valores.
    O Forwarded substitui esse cabeçalho automaticamente?
    O parâmetro host do Forwarded oferece uma forma padronizada de transportar o host original. A aplicação e o proxy precisam oferecer suporte a ele. A presença de Forwarded não converte automaticamente os campos X-Forwarded-*.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Formação DevOps

    Uma aplicação atrás de um proxy precisa interpretar o domínio público sem confundi-lo com o endereço interno do serviço.

    Conhecer a formação
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano