Si tras actualizar Caddy la portada responde File not found., tu sitio usa php_fastcgi y no tiene index.php en la raíz: desde la 2.11.8, esas peticiones van a PHP-FPM en lugar de a file_server. Añade try_files {path} {path}/index.php {path}/ dentro de php_fastcgi. Si lo que falla es /wp-admin/ con un 404 vacío, estás en la 2.11.8 y se arregla subiendo a la 2.11.9. Lo he reproducido el 7 de noviembre de 2026 en Docker con las tres versiones y el mismo Caddyfile. La guía también está en inglés.

Puntos clave

  • El 7 de noviembre de 2026, caddy:2 y caddy:latest apuntan a la 2.11.9. La definición oficial de la imagen pasó a la 2.11.8 el 4 de noviembre y a la 2.11.9 el 5.
  • Un sitio estático con php_fastcgi y sin index.php cambió en 5 de las 9 rutas que probé entre la 2.11.7 y la 2.11.9, portada incluida.
  • WordPress 7.1.3 perdió /wp-admin/ solo en la 2.11.8. En la 2.11.9 las 16 URL que probé responden igual que en la 2.11.7.
  • El 400 por Host afectó a 3 de los 18 valores probados por HTTP/1.1, todos formados solo por puntos. my_service y app..test siguen pasando.
  • El 413 temprano solo cambia algo cuando nada lee el cuerpo. Con reverse_proxy, las tres versiones ya respondían 413 a un cuerpo de 2 MB con un límite de 1 MB.
  • El arreglo de fondo, el PR 8372, se fusionó el 8 de noviembre, pero a 16 de noviembre no ha salido en ninguna versión. La 2.11.7 no es refugio: la 2.11.8 trae 9 correcciones de seguridad y la 2.11.9, otras 6.

¿Por qué Caddy 2.11 responde File not found en un sitio estático?

Este es el fallo que más se nota, porque deja sin portada a un sitio que antes funcionaba. La directiva php_fastcgi prueba tres candidatos: {path}, {path}/index.php e index.php, con la política first_exist_fallback. En la 2.11.7, si ese último index.php no existía, la petición seguía hasta file_server.

Desde la 2.11.8, ese último candidato coincide aunque el archivo no exista, y la petición acaba en PHP-FPM. Kévin Dunglas lo resume en el PR 8372[1]: "Since v2.11.8, the final entry of first_exist_fallback matches even when the file doesn't exist." Esto es lo que recibe el cliente en la 2.11.9, con index.html en la raíz:

HTTP/1.1 404 Not Found
Content-Type: text/html; charset=UTF-8
Status: 404 Not Found
Via: 0.0 Caddy
X-Powered-By: PHP/8.4.27
Content-Length: 16

File not found.

Las notas de la 2.11.8 solo avisan de las rutas que no existen. En mi prueba también cayó la portada, que sí existe como index.html, y la 2.11.9 añadió /docs/ a la lista. Las páginas de error de handle_errors tampoco se activan, porque ese 404 es una respuesta de PHP, no un error de Caddy.

Qué cambió en Caddy 2.11.8 y 2.11.9, versión por versión

La tabla resume lo que observé con el mismo Caddyfile en las tres versiones. Monté Caddy delante de un servidor de eco en Python, PHP-FPM 8.4.27 y un WordPress 7.1.3 real con enlaces permanentes activos. Las celdas de la 2.11.9 son también las que obtienes hoy con caddy:2.

Caso 2.11.7 2.11.8 2.11.9
WordPress /wp-admin/ 302 al login 404 vacío 302 al login
Sitio sin index.php, / 200 404 File not found. 404 File not found.
Sitio sin index.php, /docs/ 200 200 404 File not found.
Sitio sin index.php, /docs 308 404 File not found. 404 File not found.
Sitio sin index.php, ruta inexistente Tu 404 404 File not found. 404 File not found.
Host: .. 200 400 vacío 400 vacío
POST de 2 MB a respond con max_size 1MB 200 413 413
POST de 2 MB a reverse_proxy con max_size 1MB 413 413 413
Dos líneas expression en un matcher Arranca Sale con código 1 Sale con código 1
client_auth distinto para el mismo host Arranca Arranca Sale con código 1
Cabecera del cliente contra env HTTP_X_AUTH_USER Gana el cliente Gana el cliente Gana el Caddyfile
encode gzip con Cache-Control: no-transform Sin comprimir Gzip Gzip

La advertencia de las notas de la 2.11.8 resultó optimista para los sitios PHP: "Most of them reject configs or requests that never did what they looked like they did, so most setups won't notice." La 2.11.9 sí corrige el fallo de WordPress, y sus notas[2] lo reconocen como regresión de la 2.11.8.

Cómo saber cuál de los cambios te afecta

Empieza por la versión real, no por la etiqueta de tu compose.yml. Una imagen caddy:2 puede ser cualquiera de las últimas, según cuándo la descargaste:

docker compose exec caddy caddy version
curl -si http://127.0.0.1:33290/

Después, compara la respuesta con estos cuatro síntomas:

  • Cuerpo File not found. y cabecera X-Powered-By: la respuesta viene de PHP-FPM. Es el cambio de php_fastcgi, en la 2.11.8 o posterior
  • 404 con Content-Length: 0 y Server: Caddy en una URL terminada en /: es la regresión de la 2.11.8, y PHP no llega a recibir la petición
  • 400 vacío: el Host solo contiene puntos, o lleva / o \ por HTTP/2
  • El contenedor sale con código 1: es la validación más estricta, y el registro indica la causa y a veces la línea

El registro de PHP-FPM confirma el primer caso. Cada visita a la portada deja una línea que pide un index.php que no tienes:

172.23.0.2 -  07/Nov/2026:19:09:38 +0000 "GET /index.php" 404

Cómo arreglar File not found en un sitio sin index.php

El arreglo es declarar try_files a mano, porque un try_files propio deja de usar first_exist_fallback. Lo propusieron en la issue 8367[3] y lo he probado en Caddy 2.11.9 con este sitio: index.html, docs/index.html, contact.php y shop/index.php.

http://:80 {
    root * /srv
    php_fastcgi php:9000 {
        try_files {path} {path}/index.php {path}/
    }
    file_server
    handle_errors {
        rewrite * /404.html
        file_server
    }
}

Aplícalo sin reiniciar con docker compose exec caddy caddy reload --config /etc/caddy/Caddyfile --adapter caddyfile. Este script recorre las rutas que suelen romperse y sirve también para probar cualquier actualización futura:

#!/bin/sh
base=${1:-http://127.0.0.1:33290}
for path in / /docs/ /contact.php /shop/ /no-such-page; do
  printf '%-16s ' "$path"
  curl -s -o /dev/null -w '%{http_code}\n' "$base$path"
done

Antes del cambio, / y /docs/ devolvían 404. Después, las cinco rutas responden lo esperado, y /no-such-page vuelve a mostrar tu página de error:

/                200
/docs/           200
/contact.php     200
/shop/           200
/no-such-page    404

Probé otras dos variantes, index off y php_fastcgi con un matcher @php path *.php. Las dos recuperan la portada, pero pierden /shop/ y /contact.php/extra, así que me quedo con try_files.

No apliques este arreglo a WordPress

try_files sin la alternativa final elimina justo lo que necesita un controlador frontal como WordPress: enviar a index.php las URL que no son archivos. Con este bloque en mi WordPress 7.1.3, sobre la 2.11.9, /sample-page/ y /hello-world/ pasaron de 200 a 404. Si tu aplicación tiene index.php en la raíz, no toques el Caddyfile: usa la 2.11.9. Allí, las 16 URL probadas devolvieron lo mismo que en la 2.11.7, con sesión iniciada incluida en el caso del escritorio.

Si proteges un script con path, revisa la regla

Este arreglo vuelve a dejar visible un fallo que también tenía la 2.11.7. Con una regla path /secret.php /secret.php/*, las peticiones a /secret.php.php y /secret.phpx/y.php ejecutaron secret.php en las tres versiones. El PR 8372 también lo describe y lo corrige.

Mientras no se publique, bloquea por prefijo. Con esta regla, las tres versiones respondieron 403 en esas dos rutas y en /secret.php:

@denied path /secret.php*
respond @denied "denied" 403

Lo más seguro para un script privado es sacarlo del directorio público.

Los otros cambios: 400, 413 y Caddyfiles que ya no arrancan

Ninguno de estos tres cambios afectó a una configuración corriente en mis pruebas, salvo que ya tuvieras uno de estos casos. La distinción importa, porque un 413 o un 400 de Caddy no siempre tienen que ver con la actualización.

400 con Host inválido

La 2.11.8 rechaza con un 400 vacío los hosts que solo contienen puntos: ., .. y ... en mi prueba. Por HTTP/2, también foo/bar y foo\bar. Por HTTP/1.1, esos dos ya daban 400 Bad Request: malformed Host header en la 2.11.7.

Probé 18 valores y los otros 15 no cambiaron, incluidos my_service, app..test, app.lab.test. y [::1]:8080. Si ves este 400 en tus registros, lo más probable es que sean sondeos, no clientes reales, y no hay nada que arreglar.

413 temprano con request_body

La 2.11.8 responde 413 en cuanto Content-Length supera max_size, aunque nada vaya a leer el cuerpo. Solo cambió el caso de respond, que antes daba 200. Con reverse_proxy ya había 413 y ahora se ahorra leer el cuerpo: bytes_read pasó de 1 000 001 a 0 en el registro.

Un cuerpo por bloques (chunked) de 2 MB dio lo mismo en las tres versiones: 413 con reverse_proxy y 200 con respond. Si un 413 te sorprende, sube max_size para esa ruta.

Caddyfiles que ya no arrancan

Aquí el contenedor sale con código 1, y con restart: unless-stopped entra en bucle. Estos son los tres errores que reproduje:

repeated expression matchers are not supported, combine them
into one expression with &&, at /etc/caddy/Caddyfile:4

invalid IPv4 mask: 33 (must be between 0 and 32)

two policies with same match criteria have conflicting
client auth configuration

El primero se arregla uniendo las condiciones, como pide el mensaje: @m expression `{method} == "GET" && {path}.startsWith("/a")`. El segundo, con una máscara válida.

El tercero solo aparece en la 2.11.9: lo provoqué con dos bloques del mismo host y modos request y require. Un solo bloque con client_auth y las rutas en handle pasa la validación. Comprueba además el resultado en la práctica, porque el cambio exige decidir qué modo querías de verdad.

Cómo fijar la versión de Caddy en Docker

Estas actualizaciones llegaron solas porque caddy:2 y latest se mueven con cada parche, y la 2.11.9 salió un día después de la 2.11.8. Fija la versión exacta y, si quieres que la imagen sea inmutable, añade también el digest:

services:
  caddy:
    image: caddy:2.11.9@sha256:4e2425f6009577e7c651010f16679c28f7d12df3e7b1914f941a7a3370746b3c

Obtén el digest de tu copia con docker inspect --format '{{index .RepoDigests 0}}' caddy:2.11.9. Las etiquetas se recompilan sin cambiar de versión: el 13 de noviembre, caddy:2 y caddy:2.11.9 pasaron a apuntar las dos a sha256:4e2425f6…, y caddy version sigue imprimiendo v2.11.9.

Antes de subir de versión, ejecuta caddy validate con la imagen nueva. Detecta los Caddyfiles que no arrancan, pero no los cambios de comportamiento: mi Caddyfile roto imprimía Valid configuration en la 2.11.9 mientras la portada daba 404. Por eso conviene pasar también el script de arriba.

Si actualizas con Watchtower, excluye Caddy. Con Renovate o Dependabot, el digest te llega como un cambio que puedes revisar antes de aplicarlo.

Preguntas frecuentes

¿Vuelvo a la 2.11.7 hasta que se arregle?

Solo como medida de horas. image: caddy:2.11.7 restauró todo en mi prueba, pero deja fuera las 9 correcciones de seguridad de la 2.11.8 y las 6 de la 2.11.9, 6 de esas 15 en FastCGI. Con try_files, un sitio sin index.php funciona en la 2.11.9, así que no necesitas quedarte atrás.

¿Cuándo podré quitar el try_files?

Cuando una versión publicada incluya el PR 8372, que hace que un index.php ausente deje de coincidir. El PR se fusionó el 8 de noviembre de 2026 y cerró la issue 8367, pero a 16 de noviembre la 2.11.9 sigue siendo la última versión, y la imagen caddy:2 recompilada el 13 de noviembre todavía responde «File not found.» sin el try_files. Comprueba las notas de versiones de Caddy[4] antes de retirarlo y pasa el script de comprobación.

¿Tiene que ver con el error 431 de Caddy?

No. El 431 Request Header Fields Too Large viene del límite de cabeceras de la 2.11.6 y sigue igual. Si vienes de una versión anterior a la 2.11.6 con un caddy:2 antiguo, puedes tener los dos problemas a la vez, y cada uno tiene su arreglo.

¿Qué no he podido reproducir?

Las notas de la 2.11.9 dicen que FastCGI responde 400 cuando la ruta escapada y la decodificada eligen scripts distintos. Con un matcher @pub path /public/*%2f* y su ejemplo de ruta, obtuve 200 vacío en las tres versiones, así que no puedo confirmar ese 400. Tampoco vi diferencias en PATH_INFO con mis rutas de prueba, y no probé HTTP/3 ni Windows.

Conclusión

Dos parches de Caddy cambiaron el comportamiento de php_fastcgi, y el arreglo depende de tu sitio. Si tienes index.php en la raíz, como WordPress, usa la 2.11.9 sin tocar el Caddyfile. Si es un sitio estático con PHP suelto, añade try_files {path} {path}/index.php {path}/ y bloquea los scripts privados por prefijo. En ambos casos, fija la versión exacta en tu compose.yml y pasa un script de comprobación antes de cambiarla.

Fuentes: [1] Caddy, notas de la versión v2.11.8[5], [2] Caddy, notas de la versión v2.11.9[2], [3] Caddy, PR 8372 sobre first_exist_fallback[1], [4] Caddy, issue 8367 sobre file_server en la 2.11.9[3], [5] Caddy, issue 8353 sobre el 404 en directorios[6], [6] Documentación de Caddy, directiva php_fastcgi[7], [7] Docker Hub, imagen oficial de Caddy[8], [8] Docker official-images, definición de library/caddy[9].

Fuentes

  1. PR 8372
  2. sus notas
  3. issue 8367
  4. notas de versiones de Caddy
  5. Caddy, notas de la versión v2.11.8
  6. Caddy, issue 8353 sobre el 404 en directorios
  7. Documentación de Caddy, directiva php_fastcgi
  8. Docker Hub, imagen oficial de Caddy
  9. Docker official-images, definición de library/caddy