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

一条连接如何复用多个协议流

一条连接如何复用多个协议流

建立 libp2p 对等连接后,消息回声与状态查询不必分别建立 TCP 连接。本篇使用 Go 在本机运行两个 Host,注册两种协议处理器,并通过连接计数验证:多个 Stream 可以共用一条安全连接,而关闭 Stream 与断开对等连接是两件事。

学习目标

  • 区分底层连接、流复用器、Stream 与协议标识。
  • 为两个协议 ID 注册处理器,在同一连接上收发独立消息。
  • 验证关闭单条流、关闭所有业务流及关闭 Peer 连接后的行为。

连接和协议流是什么关系

本例采用 TCP 传输,Host A 与 Host B 先建立经过 Noise 或 TLS 1.3 保护的连接,再由默认的 yamux 复用器承载多条逻辑流。/demo/echo/1.0.0 与 /demo/status/1.0.0 是应用层协议标识,用于把新 Stream 分发到对应处理器;它们不是新端口,也不是两次独立的安全握手。

每条 network.Stream 都能独立读写和关闭。同一连接上的不同流有各自的数据与生命周期,但共享底层传输:一条流正常结束不要求关闭连接,底层连接断开却会影响其上的所有流。

一条安全连接同时承载两种协议流及关闭行为

注册处理器并打开两条流

环境采用 Go 1.26 或更新版本、github.com/libp2p/go-libp2p v0.50.0。实验仅监听回环地址,端口号 0 表示由操作系统分配空闲端口,因此无需公网 IP 或 NAT 配置。先建立模块:

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

预期结果:生成 go.mod 和 go.sum,依赖解析成功;下载过程的版本和进度日志随环境变化。把下面完整程序保存为 main.go:

go
package main

import (
    "bufio"
    "context"
    "fmt"
    "strings"
    "time"

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

const (
    echoID   protocol.ID = "/demo/echo/1.0.0"
    statusID protocol.ID = "/demo/status/1.0.0"
)

func serve(name string) network.StreamHandler {
    return func(s network.Stream) {
        defer s.Close()
        line, err := bufio.NewReader(s).ReadString('\n')
        if err != nil {
            _ = s.Reset()
            return
        }
        // 每种协议各自处理消息,不共享业务数据缓冲区。
        if _, err := fmt.Fprintln(s, name+":"+strings.TrimSpace(line)); err != nil {
            _ = s.Reset()
        }
    }
}

func exchange(s network.Stream, request string) (string, error) {
    // 限定请求的读写等待,避免测试在异常连接上无限阻塞。
    if err := s.SetDeadline(time.Now().Add(5 * time.Second)); err != nil {
        return "", err
    }
    if _, err := fmt.Fprintln(s, request); err != nil {
        return "", err
    }
    return bufio.NewReader(s).ReadString('\n')
}

func must(err error) {
    if err != nil {
        panic(err)
    }
}

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"))
    must(err)
    defer a.Close()
    b, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
    must(err)
    defer b.Close()

    b.SetStreamHandler(echoID, serve("echo"))
    b.SetStreamHandler(statusID, serve("status"))
    must(a.Connect(ctx, peer.AddrInfo{ID: b.ID(), Addrs: b.Addrs()}))
    count := func() int { return len(a.Network().ConnsToPeer(b.ID())) }
    fmt.Println("建连后连接数:", count())

    // 两条流均已打开,随后分别请求和关闭。
    echo, err := a.NewStream(ctx, b.ID(), echoID)
    must(err)
    status, err := a.NewStream(ctx, b.ID(), statusID)
    must(err)

    result, err := exchange(echo, "ping")
    must(err)
    fmt.Println("回声流:", strings.TrimSpace(result))
    must(echo.Close())
    fmt.Println("关闭回声流后连接数:", count())

    result, err = exchange(status, "check")
    must(err)
    fmt.Println("状态流:", strings.TrimSpace(result))
    must(status.Close())
    fmt.Println("关闭两条流后连接数:", count())

    // 同一 Peer 再开新流,不需要重新建立底层连接。
    again, err := a.NewStream(ctx, b.ID(), statusID)
    must(err)
    result, err = exchange(again, "again")
    must(err)
    fmt.Println("重开状态流:", strings.TrimSpace(result))
    must(again.Close())
    fmt.Println("再次复用后连接数:", count())

    must(a.Network().ClosePeer(b.ID()))
    fmt.Println("关闭对等连接后连接数:", count())
}

保存后执行:

bash
go run .

预期输出(首次获取依赖的下载日志不计入程序输出):

text
建连后连接数: 1
回声流: echo:ping
关闭回声流后连接数: 1
状态流: status:check
关闭两条流后连接数: 1
重开状态流: status:again
再次复用后连接数: 1
关闭对等连接后连接数: 0

读懂关闭行为并处理异常

echo.Close() 只结束回声流;已打开的状态流仍能返回 status:check。两条业务流都关闭后,底层连接在本次实验中仍为 1,因此第三次 NewStream 能复用它。Network().ClosePeer(b.ID()) 才会关闭 A 到 B 的现有连接,计数归零;若当时仍有活跃流,其读写也会受影响。

容易混淆的三个边界可以直接用这个程序检查:

  • 协议不匹配:把 A 的 statusID 换成 B 未注册的协议 ID,NewStream 在协议协商阶段返回错误;不是 TCP 必然断开。协议标识包含版本段,双方须约定匹配的标识。
  • 等待消息结束:处理器通过 ReadString('\n') 判断一条请求是否完整。发送方漏掉换行时会等待直到收到分隔符、EOF 或期限届满;生产环境应定义明确的帧格式和长度限制。
  • 正常关闭与异常中断:请求响应完成后用 Close() 释放流;只结束发送、还需继续读响应时用 CloseWrite();发生无法继续解析的数据错误时用 Reset()。这三个 API 不应互换。

如果只想停掉一个业务协议,关闭属于该协议的 Stream 即可;不要为了结束一次请求调用 ClosePeer,否则同一对等连接上其他协议的通信也会被切断。

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

目录与阅读设置

阅读设置

17

记录一个想法

一条连接如何复用多个协议流

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

登录哪都通