综合 curl 8.17 发布:%header{} 能输出重复响应头,wolfSSH 后端被移除

2026-11-20 21:05:59

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 解析更贴近 WHATWG
  • CURLOPT_MAXLIFETIME_CONN 默认 24 小时;CURLOPT_MAXREDIRS 重新接受 -1
  • 失败的部分下载会保留,供重试时自动续传
  • 没有实际传输时不保存 cookie 文件
  • OpenSSL 后端在证书数量超过 MAX_ALLOWED_CERT_AMOUNT 时报错;schannel 最大阻塞时间降到 7 秒

下一个版本 8.18.0 计划于 2026 年 1 月初发布。

复制全文 生成海报 Shell curl 运维 接口调试

推荐文章

程序员茄子在线接单