Formatos de Arquivo de Redirecionamentos

Cada build escreve regras de redirecionamento em arquivos na raiz da saída. Seus formatos dependem de qual servidor web ou produto de hospedagem os lê, então esta página descreve ambos, e a única linha que só funciona no Caddy.

Os três arquivos

_redirects (raiz da saída), regras em formato Netlify, uma por linha: caminho-antigo caminho-novo codigo-status. Escritas a partir das suas configurações de redirecionamentos (redirecionamentos de slug com o código de status que você escolher por regra).
_redirects.caddy (raiz da saída), os mesmos redirecionamentos de slug expressos na sintaxe nativa da diretiva redir do Caddy, com um comentário de cabeçalho orientando a incluir o snippet no bloco de site do seu Caddyfile. Gerado apenas quando a sua URL de Site está definida.
O bloco de domínio canônico anexado ao _redirects quando uma URL de Site está configurada: uma única regra que aplica 301 ao host alternativo www/nu para o seu host canônico, com o caminho intacto.

O que são as regras

Redirecionamentos de slug, suas regras de redirecionamento (slug antigo/slug novo por idioma/tipo), emitidas apenas quando a URL antiga não resolve mais para conteúdo vivo; um redirecionamento que você configure contra um endereço que ainda é uma página/post vivo é suprimido para que URLs estabelecidas permaneçam alcançáveis.
Redirecionamentos de mudança de prefixo, uma mudança automática de prefixo de post (por exemplo, o prefixo do blog) escreve os caminhos antigos blog/<slug>/ … para a nova estrutura.
Códigos de status, 301, 302 ou 307 conforme escolhido por regra; 301 quando não definido.

Nota de sintaxe exclusiva do Caddy

A linha de domínio canônico usa o marcador de força externa do redir do Caddy (301!). Um parser estritamente compatível com Netlify trata aquele caractere final como parte do alvo; ao publicar a árvore de saída em um host que não seja o Caddy, revise esse bloco. As linhas de redirecionamento de slug (formato Netlify) em si são pares simples de caminhos que o amplo suporte de hosts trata.

O que deliberadamente não está nos arquivos

Redirecionamentos com padrão (curingas * com substituições $1) nunca são escritos nesses arquivos, os formatos simples não os podem expressar com segurança. Redirecionamentos com padrão exigem regras implementadas na configuração do seu reverse proxy.

Referenciando o snippet Caddy

# no seu bloco de site do Caddyfile:
import /var/www/chinaski1/output/_redirects.caddy

(Caminho de include conforme o próprio comentário de cabeçalho do arquivo orientar, o estilo exato de include é a nota do cabeçalho do próprio snippet.)