P2P 与分布式存储 / 系统课时

Identify 如何交换地址和协议清单

Identify 如何交换地址和协议清单

节点已经通过引导地址建连,却仍无法打开业务流时,应先检查 Identify 返回的地址、协议列表与观测地址。本篇用两个本机 libp2p 节点重现实验,并据此区分“节点可连接”和“应用协议可使用”。

学习目标

  • 说清 Identify 请求、响应与 Identify Push 的作用和触发时机。
  • 读取远端公示地址、协议清单和对本机的观测地址。
  • 根据协议协商结果判断业务流打不开的原因。

Identify 在建连之后交换什么

Identify 不负责在全网寻找节点。节点 A 必须先获得节点 B 的 Peer ID 和至少一个可拨号地址,并完成传输连接及安全握手;随后才通过 /ipfs/id/1.0.0 流取得 B 的信息。常见返回字段如下:

字段 从 A 的视角理解 排查时看什么
publicKey B 的公钥,与连接身份对应 身份能否一致
listenAddrs B 公示的监听 Multiaddr 列表 是否只有回环或私网地址
protocols B 声明可接收的流协议 ID 有无 /demo/chat/1.0.0
observedAddr B 在连接上观察到的 A 的来源地址 与 A 自己的监听地址是否不同
agentVersion、protocolVersion B 的实现信息和协议族版本 用于诊断,不能代替业务协议检查

Identify 请求响应与地址归属关系

远端地址是声明,不是可达性证明。B 可能公示 /ip4/192.168.1.20/tcp/4001,但公网 A 无法直连;同样,B 返回的 observedAddr 是 A 的连接来源地址,不能当作 B 的拨号地址。对于支持签名 Peer Record 的实现,地址簿还可能优先采用经过签名验证的记录。

在本机读取一次 Identify 结果

以下针对 Go 1.26 与 go-libp2p v0.50.0。先初始化模块并安装依赖,再保存 main.go。两台 Host 都监听随机 TCP 端口,不依赖公网引导节点。

bash
mkdir identify-lab
cd identify-lab
go mod init example.com/identify-lab
go get github.com/libp2p/go-libp2p@v0.50.0

预期结果:创建 go.mod,并成功加入所需依赖。下载日志随环境而异,命令退出码为 0 即完成初始化。

将下面的完整程序保存为 main.go:

go
package main

import (
    "context"
    "fmt"
    "log"
    "time"

    libp2p "github.com/libp2p/go-libp2p"
    "github.com/libp2p/go-libp2p/core/event"
    "github.com/libp2p/go-libp2p/core/peer"
    "github.com/libp2p/go-libp2p/core/protocol"
)

func main() {
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()

    a, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
    if err != nil { log.Fatal(err) }
    defer a.Close()
    b, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
    if err != nil { log.Fatal(err) }
    defer b.Close()

    // 先订阅,避免连接后错过 Identify 完成事件。
    sub, err := a.EventBus().Subscribe(new(event.EvtPeerIdentificationCompleted))
    if err != nil { log.Fatal(err) }
    defer sub.Close()

    if err := a.Connect(ctx, peer.AddrInfo{ID: b.ID(), Addrs: b.Addrs()}); err != nil {
        log.Fatal(err)
    }

    select {
    case raw := <-sub.Out():
        info := raw.(event.EvtPeerIdentificationCompleted)
        if info.Peer != b.ID() { log.Fatal("非目标节点") }
        if len(info.ListenAddrs) == 0 { log.Fatal("未收到公示地址") }
        fmt.Println("Identify成功:", true)
        fmt.Println("远端公示地址:", info.ListenAddrs[0])
        fmt.Println("远端支持Identify:", hasProtocol(info.Protocols, "/ipfs/id/1.0.0"))
        fmt.Println("本机观测地址:", info.ObservedAddr)

        // 未安装应用协议处理器,连接成功也不能打开该应用流。
        want := protocol.ID("/demo/chat/1.0.0")
        supported, err := a.Peerstore().SupportsProtocols(b.ID(), want)
        if err != nil { log.Fatal(err) }
        fmt.Println("目标协议已公告:", len(supported) > 0)
        stream, err := a.NewStream(ctx, b.ID(), want)
        if err == nil { _ = stream.Close() }
        fmt.Println("应用流打开成功:", err == nil)
    case <-ctx.Done():
        log.Fatal(ctx.Err())
    }
}

func hasProtocol(list []protocol.ID, want protocol.ID) bool {
    for _, p := range list {
        if p == want { return true }
    }
    return false
}

保存文件后运行:

bash
go run .

预期输出(两处 <PORT> 是每次运行动态分配的端口,实际值不同):

text
Identify成功: true
远端公示地址: /ip4/127.0.0.1/tcp/<PORT>
远端支持Identify: true
本机观测地址: /ip4/127.0.0.1/tcp/<PORT>
目标协议已公告: false
应用流打开成功: false

这里 EvtPeerIdentificationCompleted 表示 A 已收到 B 的 Identify 响应。ListenAddrs 和 Protocols 是这次响应的快照;SupportsProtocols 则查询 A 保存的远端协议清单。若使用不同 libp2p 实现或配置,地址数量、协议集合与输出顺序可能不同。

连接成功但业务流失败怎么查

首先检查 a.Connect 是否成功,再等待 Identify 完成。若只知道 Peer ID、未提供可拨号地址,则应先从引导节点、DHT 或其他发现机制取回地址;Identify 不能凭空发现陌生节点。

若握手和 Identify 均成功,但 SupportsProtocols 返回空列表,说明当前已知的 B 协议清单没有 /demo/chat/1.0.0。本例 B 没有调用 SetStreamHandler 注册该协议,因此 NewStream 的协议协商失败是符合预期的;修复方式是在接收端注册同一个协议 ID,且在双方启动业务流之前完成注册。

若清单包含目标协议却仍打不开流,则依次核对双方协议 ID 的版本字符串(例如 1.0.0 与 2.0.0 不相同)、接收端处理器是否仍存在、连接与流的资源限制,以及流协商的实际错误。协议清单只表示对方当时的声明,不保证任何一次业务操作都成功。

信息变化后怎样更新判断

远端监听地址或协议集合改变时,支持 /ipfs/id/push/1.0.0 的节点可以主动推送更新;接收端应刷新已缓存的地址及协议。没有收到 Push 时,不应假定缓存永远新鲜,可在重新连接后观察 Identify 的最新结果。

判断公网连通性还要单独验证:把 B 公示的 Multiaddr 放到另一个网络环境尝试拨号,检查中继或打洞需求。observedAddr 仅能为 A 的 NAT 判断提供线索,单个观测值既不能证明 A 可被公网拨入,也不能证明 B 的公示地址可达。进一步核对字段语义可查阅 libp2p Identify 协议规范。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Identify 如何交换地址和协议清单

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通