P2P 与分布式存储 / 系统课时
比较 DHT 查询与委托路由
比较 DHT 查询与委托路由
当 IPFS 节点需要读取本地没有的内容时,必须先找到可能持有对应区块的节点。本课比较直接参与 Amino DHT 查询与使用 Delegated Routing HTTP API 两种发现方式,并通过实际请求观察返回的提供者信息,判断不同网络环境下该选哪一种。
学习目标
- 解释直接 DHT 查询与委托路由的参与节点、请求路径和依赖差异。
- 使用 HTTP API 查询指定 CID 的内容提供者,并识别返回记录。
- 根据节点运行环境、网络可达性和信任要求选择合适的路由方式。
两种方式分别由谁完成发现
IPFS 的内容寻址使用 CID 标识内容,但 CID 本身不包含服务器地址。获取远端区块之前,节点通常需要发现内容提供者,再建立连接并通过 Bitswap 等交换机制请求区块。
直接 DHT 查询时,Kubo 节点通过 libp2p 连接 DHT 对等节点,逐步查询与目标 CID 对应的提供者记录。Amino DHT 使用 Kademlia 风格的路由机制,查询可能经过多个节点,并不意味着每个中间节点都存储目标文件。
委托路由则把发现工作交给远端 HTTP 路由服务。客户端向服务发送 CID 查询,服务返回它知道的提供者记录。客户端不必亲自完成这次 DHT 查询,但仍需要根据返回的地址连接内容提供者并获取数据。

两种方式的关键区别是谁负责执行提供者发现,而不是 CID 是否变化。相同 CID 可以通过不同路由方式发现相同提供者,区块内容仍由 CID 对应的哈希校验。
用 HTTP API 查询提供者
Delegated Routing HTTP API 定义了通过 HTTP 查询提供者的接口。下面以公开路由服务 https://delegated-ipfs.dev 为示例。该服务属于外部依赖,实际可用性、速率限制和返回内容可能变化;生产环境应使用经过验证的服务端点。
准备一个已知 CID,在安装了 curl 的终端执行。示例 CID bafkreigh2akiscaildc6j3a3n6m7xw6r6nkb6s6m6a5m6bb6b7v7oy7fla 仅作为请求格式演示,不保证当前存在提供者;实际验证应替换为已经发布且有在线提供者的 CID。
CID='bafkreigh2akiscaildc6j3a3n6m7xw6r6nkb6s6m6a5m6bb6b7v7oy7fla'
curl --silent --show-error --max-time 15 \
-H 'Accept: application/x-ndjson' \
"https://delegated-ipfs.dev/routing/v1/providers/${CID}"预期结果:服务正常且找到提供者时,响应正文包含一条或多条 NDJSON 记录,每行是一个 JSON 对象。记录通常包含 Schema、ID、Addrs 等字段;下例只是字段结构示意,并非声称上述 CID 一定返回这些值。
{"Schema":"peer","ID":"<PEER_ID>","Addrs":["/ip4/203.0.113.10/tcp/4001"]}其中 Schema 表示记录类型,ID 是提供者的 Peer ID,Addrs 是可尝试连接的多地址。203.0.113.10 是文档示例地址,不是真实可连接的提供者。实际 Peer ID、地址和记录数量均以响应为准。
如果服务没有发现提供者,成功的查询也可能没有提供者记录。HTTP 200 不代表文件可下载;HTTP 错误、超时或空结果更不能直接证明内容不存在。
对照 Kubo 的直接发现结果
在已经安装并初始化 Kubo、且本地 daemon 正在运行的环境中,可以通过 CLI 查询提供者。下面的命令依赖节点具备可用的 DHT 路由连接;仅启动本地仓库而没有网络连接,通常无法完成公网发现。
ipfs routing findprovs --num-providers=5 <CID>执行时把 <CID> 替换为真实 CID,尖括号占位符不要原样输入。预期输出是零到五个提供者 Peer ID,每行一个;若查询未找到提供者,可能没有输出,网络故障则可能报告错误。输出内容由当前网络状态决定,不应预设固定 Peer ID。
<PEER_ID_1>
<PEER_ID_2>上面两行仅表示可能的输出形态。直接 DHT 查询与 HTTP 委托查询返回的提供者集合不一定完全一致,因为两侧的索引来源、记录传播状态、缓存和查询时间可能不同。
需要检查本地节点连接状态时,可以执行:
ipfs swarm peers预期结果:有连接时,每行显示一个已连接对等节点的多地址;没有连接时可能为空。该命令只能证明当前存在对等连接,不能证明节点已成功参与 DHT,也不能证明某个 CID 可被读取。
如果本地 Kubo 使用了其他路由配置,例如仅客户端模式或委托路由组合,CLI 的发现结果也不一定代表一次纯粹的直接 DHT 查询。严格对照实验应先检查当前路由配置,并保持两侧使用相同 CID 和接近的查询时间。
比较网络开销、依赖和适用环境
| 比较维度 | 直接 DHT 查询 | 委托路由 HTTP API |
|---|---|---|
| 发现执行者 | 本地 libp2p 节点 | 远端路由服务 |
| 网络要求 | 需要可用的 DHT 对等连接 | 需要可访问 HTTPS 服务 |
| 本地资源 | 维护连接、路由状态及查询 | 主要承担 HTTP 请求与响应处理 |
| 延迟来源 | DHT 查询跳数、连接质量、超时 | HTTP 往返、服务负载及后端查询 |
| 依赖风险 | DHT 网络可达性与节点状态 | 服务可用性、索引覆盖和服务策略 |
| 典型场景 | 长期在线的完整 IPFS 节点 | 浏览器、移动端、轻量客户端 |
例如,一个只允许 HTTPS 出站访问的浏览器应用,通常无法像完整 Kubo 节点那样直接建立任意 libp2p DHT 连接。它可以先请求委托路由服务获得提供者信息,再通过浏览器支持的传输方式或网关获取内容。但发现成功不保证浏览器能够连接返回的 TCP 多地址。
对于长期运行的服务器节点,直接参与 DHT 可以减少对单一 HTTP 路由服务的依赖,但需要承担连接维护和路由查询成本。实际部署也可以组合多种路由来源,并设置超时、重试与回退策略。
识别发现成功但下载失败的情况
排查时应将发现与传输分开验证,而不是看到提供者记录就判断文件可用。
- 确认 HTTP 查询返回了有效的
Schema、ID和Addrs,或者 Kubo 查询得到 Peer ID。 - 检查地址是否与当前客户端支持的传输协议兼容,以及 NAT、防火墙是否允许连接。
- 尝试建立对等连接,观察握手、身份验证及连接超时情况。
- 连接成功后再检查区块交换是否返回目标 CID 对应的有效区块。
- 若发现结果为空,检查内容是否仍被在线节点提供、提供者记录是否已发布,以及所用路由服务是否覆盖该记录来源。

一次可复现的比较实验应记录同一 CID 在两种路由方式下的查询耗时、提供者数量、连接成功数量和最终区块读取结果。查询耗时建议连续测量至少五次,分别记录而不是只取一次结果,因为缓存、网络抖动和服务负载会显著影响观测。
当客户端能够稳定参与 DHT 且需要自主路由能力时,可以优先使用直接发现;当运行环境限制 P2P 连接或需要轻量化查询接口时,委托路由更合适。无论选择哪一种,都必须单独验证提供者可达性与内容完整性。