CF _headers & _redirects
Cloudflare Pages e redes de borda

Gerador de _headers e _redirects para Cloudflare Pages e Workers

Referência técnica e guia de sintaxe para configurar regras de _headers e _redirects no Cloudflare Pages, políticas de segurança e reescritas no edge.

Privacidade 100% no cliente
Zero transmissão ao servidor
Predefinições:

Escopos de Cabeçalhos

3 Escopos
Padrão de caminho:
Injeção rápida:
:
:
:
:
:
:
:

Regras de Redirecionamento

3 Regras
→
Condition:
→
Condition:
→
Condition:
# Cloudflare Pages _headers configuration
# Generated with ToolsAA (https://toolsaa.com)
# Docs: https://developers.cloudflare.com/pages/configuration/headers/

# Global root security headers
/*
  Strict-Transport-Security: max-age=31536000; includeSubDomains; preload
  X-Frame-Options: DENY
  X-Content-Type-Options: nosniff
  Referrer-Policy: strict-origin-when-cross-origin
  Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=()
  Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline' https://challenges.cloudflare.com; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:; connect-src 'self' https:; frame-ancestors 'none'; base-uri 'self'; form-action 'self';
  Cross-Origin-Opener-Policy: same-origin

# Long-term immutable static caching
/assets/*
  Cache-Control: public, max-age=31536000, immutable

# REST API CORS policies
/api/*
  Access-Control-Allow-Origin: *
  Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
  Access-Control-Allow-Headers: Content-Type, Authorization, X-Requested-With
  Cache-Control: no-store, no-cache, must-revalidate
Rotas Mapeadas
3 Caminhos ativos

Corresponde a padrões curinga em pastas raiz e estáticas.

Diretivas Totais
12 Cabeçalhos + 3 Redirecionamentos

Sintetizado em arquivos de texto simples de configuração de borda.

Grau de Segurança
A+ (100/100)

Avalia HSTS, CSP, X-Frame-Options e redirecionamentos circulares.

Processamento 100% Seguro no Navegador

Toda a compilação de cabeçalhos, síntese de CSP e validação de redirecionamentos ocorrem localmente no navegador, sem telemetria.

Conformidade Total com Padrões Cloudflare

Adesão às especificações do Cloudflare Pages para _headers e _redirects, com suporte a splats (:splat) e sobrescritas forçadas (!).

Exportação Flexível Multi-Cloud

Exporte instantaneamente arquivos Pages, código TypeScript para Cloudflare Workers ou regras de roteamento para Next.js.

Referência técnica e guia de arquitetura

Referência de Desenvolvedor Cloudflare Headers e Redirects — Guia de referência

Referência técnica e guia de sintaxe para configurar regras de _headers e _redirects no Cloudflare Pages, políticas de segurança e reescritas no edge.

Parâmetros principais e controles

sourcestring

Padrão de rota da requisição de entrada para _redirects, com suporte a curingas (*), splats (:splat) e marcadores dinâmicos (:slug).

Padrão: /*
targetstring

URL de destino ou caminho relativo à raiz para reescrita ou redirecionamento, recebendo os valores capturados por splats ou tokens.

Padrão: /:splat
status301 | 302 | 307 | 308 | 200

Código de status HTTP emitido pelo edge da Cloudflare; 200 executa reescrita interna e 301/308 realizam redirecionamentos permanentes.

Padrão: 301
forceboolean

Quando ativado, força a execução da regra (formato 200! ou 301!) mesmo que exista um arquivo estático físico no caminho solicitado.

Padrão: false
pathstring

Prefixo de caminho URL ou padrão glob em _headers indicando quais requisições de clientes receberão as diretivas de cabeçalho HTTP.

Padrão: /*

Dicas profissionais e melhores práticas

Forçar Regras de Reescrita SPA

Ao configurar fallbacks para SPA (/* /index.html 200), anexe ! para gerar 200!, garantindo que a reescrita ocorra mesmo quando houver um arquivo estático correspondente na raiz.

Respeitar Limites do Pages

O Cloudflare Pages limita o arquivo _headers a 100 regras e o _redirects a 2.000 linhas. Consolide cabeçalhos estáticos sob /assets/* para evitar descartes silenciosos no edge.

Usar Tokens Splat para Destinos

A diretiva /* /novos/:splat 301 transfere dinamicamente o segmento capturado pelo curinga ao destino final sem necessidade de regras redundantes.

Problemas comuns e solução de problemas

Arquivos estáticos impedem a execução da reescrita 200

O Cloudflare Pages serve arquivos estáticos físicos antes de avaliar regras de redirecionamento. Defina force: true ou anexe uma exclamação ao código de status (ex: 200!) no arquivo _redirects para sobrescrever arquivos estáticos.

Cabeçalhos descartados ao exceder o limite de 100 regras

O Cloudflare Pages descarta silenciosamente declarações que ultrapassam 100 regras no arquivo _headers. Agrupe cabeçalhos de segurança globais (HSTS, CSP) sob /* e recursos estáticos sob /assets/*.

Perguntas frequentes (FAQ)

Onde os arquivos _headers e _redirects devem ser colocados na compilação do projeto?▼

Ambos os arquivos devem ser gerados dentro do diretório de saída do build (diretório de publicação) implantado no Cloudflare Pages (como dist/, out/ ou build/). Caso fiquem apenas na raiz do repositório, não serão incluídos no pacote de produção.

Qual é a diferença técnica entre um redirecionamento 301 e uma reescrita 200?▼

Um redirecionamento 301 retorna o status HTTP 301 instruindo o navegador a requisitar a nova URL, alterando a barra de endereços. Já o status 200 realiza uma reescrita interna no servidor em que a Cloudflare entrega o conteúdo do destino mantendo a URL original na barra de navegação, essencial para SPAs.

Como a Cloudflare resolve regras de cabeçalho conflitantes para a mesma rota?▼

O Cloudflare Pages avalia o arquivo _headers de cima para baixo. Regras correspondentes são mescladas; havendo duplicidade do mesmo cabeçalho em diferentes blocos coincidentes, prevalece a diretiva declarada por último no arquivo.

O Cloudflare Pages suporta expressões regulares (regex) no arquivo _redirects?▼

Não, o arquivo _redirects não suporta sintaxe completa de expressões regulares. São permitidos prefixos de caminho, curingas (*), splats (:splat) e placeholders nominais (:id). Para rotas complexas com regex, utilize Cloudflare Workers ou Pages Functions.

Ferramentas e utilitários relacionados

Todas as ferramentas →