swarm/peers怎么看连接健康？

IPFS节点显示几十个peer，看起来很健康；但用户仍可能取不到内容。原因在于开放连接只是网络栈的一层，它不保证对端支持所需协议、正在传输块、持久保存目标CID，或你的网关请求已经成功。swarm/peers应该被用作连接观察表，而不是总健康分。

把可选字段按需打开

swarm/peers列出当前开放连接，可按选项附加Streams、Latency、Direction与Identify信息。

基础结果适合低成本统计当前连接。排查具体peer时，再请求Streams、Latency、Direction与Identify，避免高频全量采集让管理接口和日志承受不必要负担。每条样本保存peer ID、地址、协议、采样时点与Kubo版本。

Latency是某次或某段观测，不应作为永久信誉分；Direction表达连接建立方向，也不能直接翻译成可信或恶意。Streams显示已协商的协议流，更适合回答该连接此刻承担什么功能。

Identify可含AgentVersion、Protocols和Addresses，但这些是连接对端声明或观测信息，不等于内容持久化证明。

AgentVersion帮助排查兼容问题，Protocols说明对端声明或协商的协议集合，Addresses给出可见地址。但它们都不能证明某个CID已被对端pin，也不能证明未来仍在线。监控报告要把“连接信息”与“内容持久化证据”分栏。

健康层	主要证据	合格问题	常见越界结论
连接	peer、address、direction、latency	是否存在稳定路径	peer多所以服务可用
协议	streams、protocols、agent	是否支持所需交换	声明协议即传过数据
传输	bitswap与带宽差值	是否真实交换块	有流量即目标CID成功
内容	pin、DAG检查、网关请求	目标内容是否可取得	连接对端必然长期保存

IPFS RPC拥有管理级权限并默认绑定localhost，不应为监控方便直接暴露公网。

Kubo RPC具备管理级能力，默认绑定localhost是一条重要安全边界。远程监控应通过受控代理、TLS与认证方案连接，并只开放必需路径。不要把整个API端口暴露给互联网，也不要将带凭据的请求样例写进公开文档。

采集账号应与运维账号分离，网络层限制来源，日志隐藏敏感多地址与令牌。若通过反向代理，验证请求体大小、超时和并发，避免监控本身拖慢节点。

连接数和单次延迟会受网络路径、NAT和采样时点影响，应连续采样并与Bitswap流量交叉判断。

NAT映射、移动网络、隐私传输和路径切换都可能制造短时波动。实用告警应比较同一peer的连续窗口、同协议peer的分布以及本机出口整体状况。只有异常持续且业务流也退化，才升级处置。

节点重启会重建连接集合，peer ID仍相同也可能换地址。时间序列应区分“连接实例”和“长期对端”，否则把正常重连误报成数十次掉线。

先检查目标节点是否有任何开放连接；再确认与目标用途相关的协议流；随后比较stats/bw与bitswap/stat的时间差值；最后对目标CID执行受控读取、DAG或pin核对。每层失败都保留原始结果，不用下一层的成功覆盖上一层异常。

例如连接存在、Bitswap收到数据但网关仍失败，问题可能位于DAG完整性、内容类型、网关限制或应用超时；连接不存在但本地内容仍能读取，也不代表网络恢复。把层次拆开，修复方向才不会跑偏。

快照包含节点版本、启动时间、连接总数、按传输类型和方向分组、延迟分位数、协议覆盖、异常peer列表以及同期带宽和Bitswap指标。涉及某个peer时，对外分享前脱敏地址。处置后用同一指标复测，而不是只看连接数回升。

swarm/peers最适合回答“当前连着谁、如何连接”。把协议、流量、取块结果和应用请求继续向下核对，才能形成可行动的IPFS节点结论。

本文的事实底稿来自Kubo RPC swarm/peers、Secure Kubo RPC、Measuring the IPFS network，定义和字段均可回到原文核对。

当前不能越过的事实边界是：Direction整数和Identify字段可能随Kubo/libp2p版本演进，解析器应保留未知值。

相关背景可继续查看bitswap/stat、getHealth、getnettotals。接口、客户端与网络状态会随时间变化，本文不构成投资、交易或收益建议。