适用范围与准备
适用于用 curl 观察持续一段时间的 TCP 下载或响应,想判断 keepalive 参数能解决什么。本文针对 TCP 路径;HTTP/3 使用 QUIC,SSH ServerAlive 和 WireGuard PersistentKeepalive 也不是这组 curl 参数。
先区分原因
TCP keepalive 可以在连接空闲时探测对端和帮助维持部分中间设备状态,但不能强迫服务器发送业务内容,也不能阻止服务端主动结束响应。curl 默认使用 TCP keepalive;--keepalive-time 调整空闲探测时间和探测间隔,不是下载速度、登录会话或传输总时限。
按顺序操作
- 记录请求实际使用的协议、curl 版本、断开时间与错误原文。确认是在收到响应后空闲,还是根本未完成连接;如果设置的 --max-time 先到期,应先按总时限解释。
- 在受控、无副作用的测试资源上使用下面示例观察。--http1.1 把本次对照限定为 TCP 上的 HTTP/1.1;20秒只是演示值,不是所有网络的通用推荐。
- 记录实际错误与应用层内容是否继续产生。TCP探测获得响应不等于业务有进展;日志中出现 HTTP 200 也不能代替持续内容或完整下载的验收。
- 使用代理时确认 curl 的 TCP 对端是哪一层。客户端 keepalive 不能独自保证代理到目标的另一段连接不超时;应结合代理和服务器日志,不同时改所有层的空闲策略。
- 若需要改变探测次数,先核对 --keepalive-cnt 的版本要求,官方说明从curl 8.9.0加入。本例不使用它;--no-keepalive 会使 keepalive-time 无效,须检查是否存在相反设置。
curl.exe --disable --http1.1 --keepalive-time 20 --connect-timeout 10 --max-time 120 --output response.body "https://example.com/"| 机制 | 能说明什么 |
|---|---|
| TCP keepalive | 空闲TCP连接的探测,不提供业务数据 |
| 应用心跳 | 由具体协议和应用定义 |
| --max-time | 到时会结束本次传输,即使TCP仍活着 |
| --speed-limit/--speed-time | 独立的低速中止条件 |
怎样确认有效
原请求在需要的时间内完成预期业务,并能用日志解释断开或持续的原因。单次短请求成功只说明参数可用和短传输完成,不能证明真实空闲链路问题已经修复。
无效时恢复与下一步
无改善时撤回本次 keepalive 与协议对照参数,恢复原任务配置,保留有限的超时预算。向维护者提供协议、对端层级和脱敏错误;不要用不断缩短探测间隔或无限等待来替代故障定位。