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 的终端执行:
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 依此拨号。

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 的项目目录执行:
go run .预期输出示意:
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 和监听地址;不能沿用上一次运行随机生成的端口和身份。