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

在本机启动双节点并验证连通

在本机启动双节点并验证连通

在同一台电脑上启动两个身份独立、端口不同的 libp2p Host,由 A 按 B 的节点身份和地址拨号,再执行双向协议 Ping 并观察连接事件。最终应看到不同 Peer ID、两端已连接、两个方向都有 RTT,以及主动断开后的通知。

学习目标

  • 创建使用不同 Peer ID 与动态监听端口的两个 Host。
  • 使用 peer.AddrInfo 建立连接,并用 libp2p Ping 验证双向通信。
  • 识别连接、断开事件,区分协议 Ping 与操作系统 ICMP Ping。

准备 Go 项目与监听地址

下面使用 Go 1.26 及 go-libp2p v0.50.0。在已安装 Go 1.26 的终端执行:

bash
go version
mkdir p2p-two-hosts
cd p2p-two-hosts
go mod init example.com/p2p-two-hosts
go get github.com/libp2p/go-libp2p@v0.50.0

预期结果:go version 显示 go1.26 或更高兼容版本,目录中生成 go.mod、go.sum,且 go.mod 中包含 github.com/libp2p/go-libp2p v0.50.0;依赖下载日志因环境而异。

监听地址选 /ip4/127.0.0.1/tcp/0:127.0.0.1 将连接限制在本机,端口 0 让操作系统为每个 Host 分配空闲 TCP 端口。Host 创建成功后读取 Addrs(),不要把端口 0 当成实际拨号端口。

创建两个 Host 并执行双向 Ping

将下面的完整程序保存为 main.go。libp2p.New 每调用一次便创建独立 Host;未传入固定私钥时,两个 Host 会各自生成节点身份。peer.AddrInfo 把 B 的 Peer ID 与监听地址绑定,A 依此拨号。

本机双 Host 连接、事件与双向 Ping 时序

go
package main

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

    libp2p "github.com/libp2p/go-libp2p"
    "github.com/libp2p/go-libp2p/core/host"
    "github.com/libp2p/go-libp2p/core/network"
    "github.com/libp2p/go-libp2p/core/peer"
    "github.com/libp2p/go-libp2p/p2p/protocol/ping"
)

func newHost(name string) (host.Host, error) {
    // 端口 0 由系统分配,两个 Host 不争用固定端口。
    h, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
    if err != nil {
        return nil, err
    }
    h.Network().Notify(&network.NotifyBundle{
        ConnectedF: func(_ network.Network, c network.Conn) {
            fmt.Printf("[%s] connected %s\n", name, c.RemotePeer())
        },
        DisconnectedF: func(_ network.Network, c network.Conn) {
            fmt.Printf("[%s] disconnected %s\n", name, c.RemotePeer())
        },
    })
    fmt.Printf("%s ID=%s\n", name, h.ID())
    fmt.Printf("%s Addr=%s/p2p/%s\n", name, h.Addrs()[0], h.ID())
    return h, nil
}

func pingOnce(label string, from host.Host, to peer.ID) error {
    ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
    defer cancel()
    // 只读取一次结果;取消上下文以终止持续 Ping。
    select {
    case result, ok := <-ping.Ping(ctx, from, to):
        if !ok {
            return fmt.Errorf("%s: ping channel closed", label)
        }
        if result.Error != nil {
            return result.Error
        }
        fmt.Printf("%s RTT=%s\n", label, result.RTT)
        return nil
    case <-ctx.Done():
        return ctx.Err()
    }
}

func main() {
    a, err := newHost("A")
    if err != nil {
        log.Fatal(err)
    }
    defer a.Close()
    b, err := newHost("B")
    if err != nil {
        log.Fatal(err)
    }
    defer b.Close()

    if a.ID() == b.ID() {
        log.Fatal("duplicate Peer ID")
    }
    ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
    defer cancel()
    // A 用 B 的真实地址和身份建立连接。
    if err := a.Connect(ctx, peer.AddrInfo{ID: b.ID(), Addrs: b.Addrs()}); err != nil {
        log.Fatal(err)
    }
    fmt.Printf("links: A=%d B=%d\n",
        len(a.Network().ConnsToPeer(b.ID())),
        len(b.Network().ConnsToPeer(a.ID())))

    if err := pingOnce("A->B", a, b.ID()); err != nil {
        log.Fatal(err)
    }
    if err := pingOnce("B->A", b, a.ID()); err != nil {
        log.Fatal(err)
    }
    if err := a.Network().ClosePeer(b.ID()); err != nil {
        log.Fatal(err)
    }
    time.Sleep(200 * time.Millisecond) // 仅让教学示例中的异步事件有机会打印。
}

预期结果:运行程序后打印两个不同 Peer ID、两个可拨号地址、连接事件、两次 Ping RTT 和断开事件,具体格式见下节。

程序中的 ping.Ping 使用 libp2p 默认启用的 Ping 协议处理器,不会调用系统 ping 命令。A 与 B 的 Ping 可以复用已有底层连接上的不同协议流,双向成功不代表创建了两条 TCP 连接。

运行并核对事件与结果

在包含 main.go 的项目目录执行:

bash
go run .

预期输出示意:

text
A ID=<ID_A>
A Addr=/ip4/127.0.0.1/tcp/<PORT_A>/p2p/<ID_A>
B ID=<ID_B>
B Addr=/ip4/127.0.0.1/tcp/<PORT_B>/p2p/<ID_B>
[A] connected <ID_B>
[B] connected <ID_A>
links: A=1 B=1
A->B RTT=<TIME>
B->A RTT=<TIME>
[A] disconnected <ID_B>
[B] disconnected <ID_A>

<ID_A>、<ID_B>、<PORT_A>、<PORT_B> 和 <TIME> 都是动态值,事件行的先后可能变化。验收时重点检查两个 ID 不同、两个 TCP 端口有效、links 两侧均大于零、两个方向均取得 RTT;关闭连接后应看到断开事件。

按失败阶段定位问题

现象 检查与修复
go get 失败或提示 Go 版本过低 运行 go version,确保 Go 1.26;检查模块代理与网络连接。
监听失败 检查本机回环接口是否可用;保留 tcp/0 避免固定端口冲突。
Connect 失败 检查 AddrInfo.ID 是否属于目标 B,Addrs 是否来自 B 当前进程;不要用上一次运行的动态端口。
已连接但 Ping 失败 检查两端是否启用 libp2p Ping 协议、上下文是否过期;连接成功不保证应用协议成功。
没看到部分事件行 NotifyBundle 回调可能异步执行,不应以固定日志顺序断言;以 ConnsToPeer 和双向 RTT 为主要验收依据。

将示例扩展为两个独立进程时,应让 B 输出当前 /ip4/.../tcp/.../p2p/... 完整地址,再由 A 解析其中的 Peer ID 和监听地址;不能沿用上一次运行随机生成的端口和身份。

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

目录与阅读设置

阅读设置

17

记录一个想法

在本机启动双节点并验证连通

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

登录哪都通