curl 8.17 发布:%header{} 能输出重复响应头,wolfSSH 后端被移除
curl 8.17.0 于 2025 年 11 月 5 日发布,是第 271 个版本,包含 11 项变更、448 条 bugfix、699 次提交,新增 2 个 libcurl 公开函数和 1 个命令行选项。
- 发布说明:https://curl.se/ch/8.17.0.html
- Daniel 的发布博客:https://daniel.haxx.se/blog/2025/11/05/curl-8-17-0/
-w '%header{...}' 现在输出某个头的全部出现
之前 %header{name} 只返回第一个匹配的响应头。8.17 起会输出该响应头的所有出现,排查重复头、多次 Set-Cookie、回调里重复的签名头都靠它。
先看原始响应头:
curl -sS -o /dev/null -D - https://example.com/callback
只提取某个头的全部值:
curl -sS -o /dev/null -w '%header{set-cookie}\n' https://example.com/login
配合 -D - 对照,能很快判断是服务端重复写了头,还是中间层加的。
新增 --knownhosts
tool_getparam 增加了 --knownhosts 参数,可以在命令行直接指定 known_hosts 文件,不必再依赖默认路径或环境变量。
multi 接口新增 notifications API
libcurl 的 multi 接口补了一套 notifications API,对应 2 个新的公开函数,用来在 multi 事件循环里通知调用方。
Apple SecTrust 配置支持
SSL 层支持 Apple SecTrust 配置,可以直接使用系统原生 CA 库,不再需要单独维护一份 CA bundle。
进度条每位 6 字符
进度条每个尺寸字段扩展到 6 个字符,大文件下载时数字不会再被截断。另外修了 max5data 的溢出问题。
删除的东西
- Heimdal 支持
- winbuild 构建系统
- Kerberos FTP
- wolfSSH 后端
- libssh2 最低要求提高到 1.9.0
如果构建脚本里还引用 winbuild 或 wolfSSH,升级前要先改。
安全修复
CVE-2025-10966:当 SFTP 使用 wolfSSH 后端时,curl 管理 SSH 连接的代码有缺陷,缺少主机校验。用 wolfSSH 构建的版本必须升级。详见 https://curl.se/docs/CVE-2025-10966.html
同版本还修复了 CVE-2025-11563(wcurl 通过百分号编码的斜杠造成的路径穿越)。
值得注意的 bugfix
--fail与--fail-with-body现在互相覆盖,不再叠加- 重试逻辑:支持 HTTP 522/524,修正指数退避延迟
- 传入的 header 看起来不合法时会给出警告;自定义 header 只接受
;作为分隔符 - 出现第二个
Location:头时直接返回错误 Content-Length解析更贴近 WHATWGCURLOPT_MAXLIFETIME_CONN默认 24 小时;CURLOPT_MAXREDIRS重新接受 -1- 失败的部分下载会保留,供重试时自动续传
- 没有实际传输时不保存 cookie 文件
- OpenSSL 后端在证书数量超过
MAX_ALLOWED_CERT_AMOUNT时报错;schannel 最大阻塞时间降到 7 秒
下一个版本 8.18.0 计划于 2026 年 1 月初发布。