Jenkins Agent心跳调优需三层协同：应用层将keepAliveInterval设为60秒、Master端配置pingTimeoutSeconds=45与intervalSeconds=180、OS层调TCP keepalive为time=600/intvl=60/probes=3，避免误判闪退。
调优 Jenkins Agent 的心跳参数是解决因网络抖动导致节点频繁断连、闪退的关键手段。核心思路是延长连接容错窗口，避免短暂网络异常被误判为节点失联，同时确保真实故障仍能被及时发现。
调整 Agent 心跳检测间隔（keepAliveInterval）
Jenkins Master 通过定期向 Agent 发送 keep-alive 消息来确认其存活状态。默认值通常为 15 秒（部分版本为 60 秒），在网络延迟波动较大时容易触发误判。
- 建议将
keepAliveInterval提升至 45–90 秒，例如在启动 Agent 的命令中显式指定：java -jar agent.jar -jnlpUrl http://jenkins:8080/computer/agent-name/slave-agent.jnlp -secret xxx -workDir /var/jenkins/agent -keepAliveInterval 60 - 若使用 JNLP 启动脚本或 systemd 服务，需确保该参数持久化写入启动命令，而非仅临时执行。
- 注意：该参数仅对 JNLP 方式注册的 Agent 有效；SSH 或 WebSocket 连接方式不适用此配置。
放宽 Master 端心跳超时判定（agentTimeout）
Master 在未收到 Agent 响应后，会等待一段时间再标记为“离线”。这个等待阈值由系统属性 hudson.slaves.NodeProvisioner.MARGIN 和内部心跳逻辑共同影响，但更直接可控的是 hudson.slaves.ChannelPinger.pingTimeoutSeconds（默认 30 秒）和 hudson.slaves.ChannelPinger.intervalSeconds（默认 120 秒）。
- 在 Jenkins 启动时添加 JVM 参数：
-Dhudson.slaves.ChannelPinger.pingTimeoutSeconds=45 -Dhudson.slaves.ChannelPinger.intervalSeconds=180 - 上述设置让 Master 每 3 分钟发起一次探测，且单次等待响应上限为 45 秒，显著降低因瞬时丢包引发的误下线概率。
- 修改后需重启 Jenkins 主服务才能生效，建议配合监控观察节点离线事件频率变化。
启用 TCP 层保活（TCP Keepalive）并调优 OS 级参数
Jenkins Agent 基于 Java NIO 构建，底层依赖操作系统 TCP 连接状态。若中间网络设备（如 NAT 网关、防火墙）静默回收空闲连接，而 TCP 层未主动探测，就会出现“连接已断但双方无感知”的僵死状态。
- 在 Agent 启动命令中启用 Java TCP keepalive：
-Dsun.net.client.defaultConnectTimeout=30000 -Dsun.net.client.defaultReadTimeout=60000 -Djdk.net.keepAlive.time=600 -Djdk.net.keepAlive.interval=60 -Djdk.net.keepAlive.retry=3 - 同时建议在 Agent 所在宿主机上调整内核参数（以 Linux 为例）：
net.ipv4.tcp_keepalive_time = 600net.ipv4.tcp_keepalive_intvl = 60net.ipv4.tcp_keepalive_probes = 3 - 这些设置可确保每 10 分钟发起保活探测，连续 3 次失败（间隔 60 秒）才关闭连接，与 Jenkins 应用层心跳形成互补。
补充建议：避免高频重连与日志干扰
即使参数调优到位，若 Agent 因其他原因（如内存溢出、磁盘满）反复崩溃，也会表现为“闪退”。需同步排查非网络因素：
- 检查 Agent 日志中是否频繁出现
Connection reset、Broken pipe或OutOfMemoryError； - 限制 Agent JVM 内存（如
-Xmx1g），防止 GC 卡顿导致心跳响应超时； - 禁用 Jenkins UI 中“自动恢复离线节点”功能（Manage Jenkins → Configure Global Security → Agent → Enable automatic recovery），避免网络恢复瞬间大量重连冲击 Master。
不复杂但容易忽略——多数高频闪退并非源于 Jenkins 配置缺陷，而是网络保活机制与应用层心跳未对齐所致。从 JVM 参数、Jenkins 启动选项到系统内核，三层协同调优后，节点稳定性通常可提升一个数量级。
