Ping — ICMP 连通性测试

Ping 使用 ICMP Echo 请求探测目标主机的可达性，并测量往返延迟。

参数说明

参数	类型	必填	默认值	说明
目标 (target)	string	是	—	IP 地址或域名
次数 (count)	integer	否	4	发送的探测包数量（最大受 PING_MAX_COUNT 限制）
超时 (timeout)	integer	否	3	每次探测的超时时间（秒）

结果解读

每个探测包输出一行 JSON：

{"type":"ping","seq":0,"ip":"8.8.8.8","rtt_ms":2.34,"success":true}

• success: true — 目标回复了 ICMP Echo Reply；rtt_ms 为往返时间
• success: false — 超时未收到回复（目标可能关机、防火墙丢弃 ICMP 或网络中断）

最终输出统计摘要：

{"type":"summary","target":"8.8.8.8","sent":4,"received":4,"loss_pct":0,"min_ms":1.2,"avg_ms":2.1,"max_ms":3.5,"duration_ms":3000}

指标	含义
loss_pct	丢包率，0% 为理想
min/avg/max_ms	最小/平均/最大延迟
duration_ms	总耗时

判断标准

• 0% 丢包 → 网络连通性正常
• 部分丢包 → 网络拥塞、链路不稳定或目标限流
• 100% 丢包 → 目标不可达、DNS 解析失败、防火墙拦截 ICMP 或目标已关机
• 高延迟 → 物理距离远、带宽瓶颈或中间链路问题

注意事项

• 容器环境需要 CAP_NET_RAW 权限
• 部分云服务器默认屏蔽 ICMP，此时 Ping 会显示全部超时，这是正常现象