Formatos de Archivos de Redirect
Cada build escribe reglas de redirect en archivos en la raíz de la salida. Sus formatos dependen de qué servidor web o producto de hosting los lee, así que esta página describe ambos. La única línea que solo funciona en Caddy.
Los tres archivos
_redirects(raíz de la salida): reglas en formato Netlify, una por línea:old-path new-path status-code. Escritas desde tus ajustes de redirects (sky redirects con el código de estado que elegiste por regla)._redirects.caddy(raíz de la salida): los mismos redirects de slug expresados en la sintaxis nativa de la directivaredirde Caddy, con un comentario de encabezado que te dice que incluyas el snippet en el bloque de site de tu Caddyfile. Generado solo cuando tu Site URL está establecida.- El bloque de dominio canónico agregado a
_redirectscuando hay una Site URL configurada: una sola regla que hace 301 del host alternativo www/desnudo a tu host canónico, con la ruta intacta.
Qué son las reglas
- Redirects de slug: tus reglas de redirect (slug viejo/slug nuevo por idioma/tipo), emitidas solo cuando la URL vieja ya no resuelve a contenido vivo; un redirect que configures contra una dirección que sigue siendo una página/post vivo se suprime para que las URLs establecidas sigan alcanzables.
- Redirects por cambio de prefijo: un cambio automático del prefijo de posts (p. ej. el prefijo del blog) escribe las rutas viejas
blog/<slug>/ …a la estructura nueva. - Códigos de estado: 301, 302 o 307 según lo elegido por regla; 301 cuando no se establece.
Nota de sintaxis solo para Caddy
La línea de dominio canónico usa el marcador de fuerza externa redir de Caddy (301!). Un parser estrictamente compatible con Netlify trata ese carácter final como parte del destino; al publicar el árbol de salida en un host distinto de Caddy, revisa ese bloque. Las líneas de redirects de slug (formato Netlify) en sí son pares planos de rutas que el amplio soporte de hosts maneja.
Lo que deliberadamente no está en los archivos
Los pattern redirects (comodines * con sustituciones $1) nunca se escriben en estos archivos. Los formatos simples no pueden expresarlos de forma segura. Los pattern redirects requieren reglas implementadas en la configuración de tu proxy inverso.
Referenciar el snippet de Caddy
# in your Caddyfile site block:
import /var/www/chinaski1/output/_redirects.caddy (Ruta de inclusión según dirige el comentario de encabezado del propio archivo: el estilo exacto de inclusión es la nota de encabezado del propio snippet.)