综合 Caddy 2.11.9:{host} 拼文件路径的请求直接 400,php_fastcgi 的 env 不再被请求头覆盖

2026-11-22 20:02:20

Caddy 2.11.9:{host} 拼文件路径的请求直接 400,php_fastcgi 的 env 不再被请求头覆盖

两个版本连着发:v2.11.8(2026-11-04)是一大批 bug 修复加安全加固,v2.11.9(2026-11-05)紧跟着补 2.11.8 引入的 PHP 目录索引回归和几个 FastCGI 问题。

跑 PHP 的直接上 2.11.9,别停在 2.11.8。升级前先过一遍校验:

caddy validate --config /etc/caddy/Caddyfile

这次配置校验明显变严,以前默认接受、不报错的写法现在会直接失败,validate 能提前把这些暴露出来。

2.11.8 的 breaking change

host 校验收紧。 无效 host 或只有点的 host(比如 ..)在所有协议上、任何路由执行之前就返回 400。此前 HTTP/2 和 HTTP/3 还会接受含 / 或 \ 的 host(#8328)。这条和安全修复是同一处:root /srv/sites/{host} 这类写法里,host 带点段或斜杠可以跳出预期目录,配合 php_fastcgi 甚至能执行目录外的文件(GHSA-r766-rf9f-588h)。凡是把 {host} 拼进 root、file_server root、日志路径的地方都会被这条影响。

request_body max_size 提前拒绝。 Content-Length 一超限就回 413,即使根本没有 handler 去读 body(#8337)。给上传接口挂了 max_size 的站点,客户端会更早收到 413。

php_fastcgi 的无 index.php 行为。 没有 index.php 时,不存在的路径现在按文档里的 first_exist_fallback 交给 PHP 处理,而不是落到 file_server 返回 404。PATH_INFO 和 DOCUMENT_URI 从归一化后的路径推导(合并重复斜杠、去掉 . 段),REQUEST_URI 不变。

try_files 尾斜杠。 file 候选以 / 结尾时只匹配目录,/foo.txt/ 不再匹配文件 /foo.txt(#8326)。这条和 2.11.9 修的目录索引回归是一对,写 try_files 时要留意。

encode 与 no-transform。 请求带 Cache-Control: no-transform 时 encode 仍然压缩(响应侧的 no-transform 依旧尊重),可能被压缩的响应总是带 Vary: Accept-Encoding。要恢复旧行为:

@transformable not header Cache-Control *no-transform*
encode @transformable

no-cache; no-transform 这种畸形写法不再关掉压缩(#8301、#8025)。

配置校验变严。 以下以前静默通过,现在是错误:同一 matcher set 里写多行表达式(要用 && 合并);未知的 TLS curve 或 protocol_min/protocol_max 名称,比如写成 TLS1.3 而不是 tls1.3;TLS policy match 块里重复的 sni_regexp;ip_mask 日志过滤器位数越界(IPv4 写 33);占位符展开后变成同名的 basic_auth 用户名;端口超过 11 个字符。

另外,带状态码的 handle_errors 和带非 path matcher 的 vars,求值顺序改为按 Caddyfile 走。

2.11.8 的其他安全修复

  • fastcgi:SCRIPT_FILENAME 改从 path matcher 看到的同一份归一化路径推导,/admin.php/../../other.php 不能再让受 path 规则保护的路由跑别的脚本(GHSA-f278-mgc7-46j3)。
  • fileserver:file matcher 不再把 /.env/./ 解析成普通文件,绕过 path *.env 这类规则(GHSA-25cw-38mq-q7m6,#8326)。
  • rewrite:{http.matchers.file.remainder} 先转义再 rewrite,双重编码的 ..%252f 不会在 path 规则跑完之后变成 ../(GHSA-69hv-5jfc-mvmv,#8325)。
  • fileserver:HOME 和 XDG_DATA_HOME 都没设时数据目录落到 ./caddy,file_server 服务工作目录会把证书和私钥暴露出去,现在该目录总是隐藏(GHSA-jf74-f69g-hcj9,#8327)。
  • fastcgi:带 index.php 的目录,php_fastcgi 的尾斜杠跳转不能被做成跳到其他站点的 open redirect(#8285)。
  • fileserver:hide 排除的文件不再出现在 browse 列表,隐藏的预压缩 sidecar 也不再被服务(#8155)。
  • reverseproxy:1xx 响应和 handle_response 里 copy_response_headers 的 hop-by-hop 头被剥掉,补齐 CVE-2026-55458(GHSA-8qx7-j2v2-x6q5)。
  • logging:query 日志过滤器按服务端的方式解析 URI,# 之后的参数也会被脱敏(#8255)。

2.11.8 还带了这些:idle timeout 第二轮(per-route 优先;handler 暂停读取时 HTTP/2 body 不再丢,之前会 502;handler deadline 作为上限);CAP_NET_BIND_SERVICE 有权限但未生效时也能绑特权端口,setcap cap_net_bind_service=+p 在 --cap-drop ALL 下可用(容器/内核行为需自行验证);新 log_level 指令,例如 log_level @healthchecks DEBUG;新占位符 {time.now.rfc3339};TLS connection policy 的 not matcher;CEL 表达式 matcher 里可以用 tls();反代修复(1xx 不再丢头、request trailer 转发、weighted_round_robin panic);PHP/FastCGI 下没有 Status 的 Location 响应现在按 CGI 规范回 302;caddy run 启动失败重新打印错误;发布构建用 Go 1.27(最低 Go 1.26)。

2.11.9 的内容

  • 修复 PHP 目录索引回归:带尾斜杠的目录请求(如 /wp-admin/)被目录本身匹配而不是它的 index.php,请求到不了 PHP,通常 404,WordPress 后台和其他用尾斜杠 URL 提供 index 的应用都受影响。try_files 的 pattern 现在只在以 / 结尾时才匹配目录(#8352)。
  • 带占位符的 path matcher:{env.FOO} 不再在查找前被小写成 {env.foo},值与请求路径的大小写不敏感比较,和静态 pattern 一致(#8343)。
  • file_server browse 新增 plain_time_format,设置纯文本目录列表(Accept: text/plain)的时间格式(#8084)。
  • path cleaning、header rewriting、weighted_round_robin 选择减少内存分配(#7842)。
  • 插件作者:新增 httpcaddyfile.Helper.IsNamedRoute()(#8354)。

2.11.9 的 breaking change:

  • 冲突的 client_auth 现在是 Caddyfile 错误。同一主机名的两个 site block 共享 TLS connection policy 但 client_auth 不同时,适配器以前保留第一个、静默丢掉另一个,可能悄悄去掉更严格的 mTLS 要求(#8306)。
  • FastCGI 脚本不明确时回 400:转义路径(含 % 的 path matcher 看到的)和解码路径会选中不同脚本,例如 /public/tool.php%2f..%2f..%2fadmin%2ftool.php(#8357);Windows 上脚本路径含 8.3 短名(如 ADMINI~1)或 :(NTFS 备用数据流)(#8356)。
  • FastCGI 的 env 值优先于请求头,客户端不能再覆盖你用 env 设的 HTTP_* 变量(#8358)。

2.11.9 的安全修复:

  • fastcgi:客户端只要发一个对应的请求头,就能覆盖 FastCGI transport 或 php_fastcgi 的 env 子指令设的任意 HTTP_* 变量,比如决定应用在 HTTP_X_AUTH_USER 里看到的用户。现在配置值优先(GHSA-q34h-28rj-5hjm,#8358)。
  • fastcgi:Windows 上 NTFS 8.3 短名和备用数据流能跑 path 规则本想拒绝的脚本,补齐 2.11.8 的修复(GHSA-9cr8-wmhh-39pm,#8356)。
  • fastcgi:编码斜杠和点段能让含 % 的 path matcher 批准一个脚本、实际跑另一个(#8357)。
  • fastcgi:HTTP/2 下在 :authority 旁边再发 host 字段,应用看到的 HTTP_HOST 会和 Caddy 路由用的 host 不一致(#8355)。
  • httpcaddyfile:合并 TLS connection policy 时,更严格的 client_auth 可能被静默丢弃(#8306)。
  • go-jose 升到 v4.1.6,对应 GHSA-mgcc-cww5-fp2q(#8299)。

这些安全补丁在应用依赖原有错误行为时可能算 breaking。插件维护者只在自己用到的导出 API 有变化时才需要升 Caddy 依赖。

复制全文 生成海报 Caddy PHP 运维 安全修复 FastCGI

推荐文章

程序员茄子在线接单