#Caddy
共 26 篇文章
Caddy 按需 TLS 报 non-2xx status code 403,先查 ask 请求
新域名TLS握手因ask端点403被拒绝,核对服务实际GET、domain参数与授权端点路径,保留域名准入。
Caddy 手动启动正常,systemd 读取证书报 permission denied
root手动启动正常而systemd加载手动证书失败,核对实际服务身份、证书私钥路径与更新后的读取条件。
Caddy IPv6 的 HTTP/3 超时,核对 UDP 回包地址与 AAAA
IPv4 HTTP/3正常而IPv6超时时,用强制协议对照UDP路径、DNS AAAA及实际回包地址,保留TLS验证。
Caddy 配置重载就断开 WebSocket,检查 stream_close_delay
WebSocket 正常建立,却在管理API更新配置时断开;核对重载时间与 stream_close_delay 的保留窗口。
Caddy try_files 读错含 ? 或 % 的文件名
含问号或百分号的文件直读正确,经过try_files却读错时,核对URI重写和路径解码。采用正式转义处理版本,保留应用回退并验证文件内容身份。
Caddy 开启 gzip 后 SSE 迟迟没有响应,检查压缩层
SSE直连正常而开启Caddy编码后响应头或事件迟到时,分开检查编码器和代理刷新。核对历史版本、正式处理路径及受控端点时序,必要时只排除已知流路径。
Caddy 2.11.6 的 POST 流 60 秒断开
Caddy 2.11.6 代理 HTTP/1.1 非空 POST 流时,请求体 deadline 可能在读完后残留,令持续有心跳的响应约 60 秒中断。2.11.7 已修复。
FastCGI 没有跳转
Caddy 2.11.7 处理缺少 Status 的 FastCGI Location 响应时会返回 200。显式输出 CGI 重定向状态,核对响应入口与后续正式版本边界。
Caddy forward_auth 刷新了会话,浏览器却没收到 Set-Cookie
鉴权子请求返回的刷新Cookie未到浏览器时,区分copy_headers请求方向与响应头复制,保留有序鉴权、全部Set-Cookie及身份头防伪。
Caddy 子路径代理跳回根路径:应用还需要配置 base URL
Caddy 子路径代理后登录和资源跑到站点根路径,核对请求前缀、应用 base URL 与生成链接;不支持子路径时改独立域名。
Caddy 第二行 expression 没生效
Caddy 2.11.7 的命名匹配器重复写 expression 时可能只保留第一行。将条件放入一份 CEL 表达式,检查适配 JSON 和应拒绝的请求。
Caddy 配置 versions h2 后报 malformed HTTP response
Caddy反代DoH出现malformed HTTP response时,核对TLS ALPN与versions枚举。修正h2为受支持的2,保留证书验证,区分旧版请求错误与新版加载拒绝。
Caddy forward_auth 登录循环:Cookie 是否只属于认证域名
认证和应用拆成兄弟域名后登录循环时,核对浏览器的Cookie范围与真实请求。同公开主机路径布局需同步回调契约,父域SSO不能默认扩大。
Caddy JSON 配了多个域名却串站:检查 match 数组的 OR 关系
Caddy 原生 JSON 的多域名站点返回同一内容,检查 match 数组的 OR 条件、同集合 AND 关系和 terminal 的位置,再核对实际入口与生效配置。
Caddy 反向代理报 first record does not look like a TLS handshake
Caddy 返回 502,日志提示 first record does not look like a TLS handshake。核对上游端口的 HTTP 与 HTTPS 协议,修正错误启用的 TLS 传输,并检查重载、负载均衡后端和配置回退。
WebSocket 经 Caddy 从 ws 换成 wss 后失败:检查 Spring 允许的 Origin
HTTP WebSocket 正常、HTTPS 页面连接失败时,核对握手的 Origin 与 Spring 允许来源。区分后端 403、TLS 和代理连接故障,保留认证及消息权限。
Cloudflare 525 与 526:按域名、握手和证书分开排查
从网友误访旧子域名的 525 案例出发,区分握手失败与证书验证失败,保留 SNI、证书链、签发日志及配置恢复的检查路径。
Caddy 设置 auto_https off 后仍无法通过 HTTP 访问
auto_https off 关闭证书自动化与跳转,不改变站点地址推断的 HTTPS 协议。本地 HTTP 服务须明确协议、监听地址和请求 Host。


