P2P 与分布式存储 / 系统课时
主题订阅如何约束消息接收范围
主题订阅如何约束消息接收范围
当三个 P2P 节点已经互相连接时,连接关系并不意味着它们都应收到同一条业务消息。本课用新闻与游戏两个主题,搭建一个本机 GossipSub 实验,观察节点订阅、退订后的实际消息分发,并区分主题广播和点对点请求。
学习目标
- 解释主题订阅、连接关系与消息转发之间的区别。
- 运行三个本地节点,验证两个主题各自的消息接收范围。
- 判断退订的效果,以及何时应改用指定 Peer 的请求响应流。
用主题筛选接收者
发布订阅模型把消息归入一个名称明确的主题(Topic),如 demo/news 和 demo/game。发布方选择主题,接收方声明自己订阅哪些主题;双方不需要事先知道对方的 Peer ID。一个节点也可以同时订阅多个主题。
假设 A、B、C 都已建立 P2P 连接,本次配置如下:
| 节点 | 订阅 demo/news |
订阅 demo/game |
操作 |
|---|---|---|---|
| A | 否 | 否 | 向两个主题发布消息 |
| B | 是 | 否 | 接收新闻 |
| C | 否 | 是 | 接收游戏事件 |
A 发出 news-1 时,预期只有 B 把该消息交给新闻订阅者;发出 game-1 时,只有 C 的游戏订阅者接收。发布不要求先订阅,因此 A 可以只发布而不消费自己的消息。
GossipSub 如何使用订阅状态
libp2p 的 GossipSub 会向相邻的 PubSub 节点传播订阅变化,并按照主题维护消息传播关系。在更大的网络中,一条消息可能经过多个节点转发才抵达订阅者;某个中间节点是否负责中继,不等于它的应用层一定订阅该主题。

订阅通告和主题网格需要传播时间,所以不能在调用 Subscribe 后立即假定其他节点已获知。PubSub 也不负责发现和连接节点;测试时应先显式建立连接,再等待主题邻居出现。重复消息通常由消息去重机制过滤,但发布成功不等于每位订阅者已确认收到。
在本机运行双主题实验
下面使用 Go 1.25.7 或更新版本、go-libp2p v0.48.0 与 go-libp2p-pubsub v0.18.0。三个 Host 都绑定 127.0.0.1 上的随机 TCP 端口,不依赖公网或引导节点。先把完整程序保存为 main.go。
package main
import (
"context"
"fmt"
"log"
"time"
libp2p "github.com/libp2p/go-libp2p"
pubsub "github.com/libp2p/go-libp2p-pubsub"
"github.com/libp2p/go-libp2p/core/host"
"github.com/libp2p/go-libp2p/core/peer"
)
func check(err error) {
if err != nil {
log.Fatal(err)
}
}
func waitPeers(t *pubsub.Topic, want int) {
deadline := time.Now().Add(10 * time.Second)
for time.Now().Before(deadline) {
if len(t.ListPeers()) == want {
return
}
time.Sleep(100 * time.Millisecond)
}
log.Fatalf("主题 %s 的邻居数未变为 %d", t.String(), want)
}
func receive(ctx context.Context, s *pubsub.Subscription, label string) {
msg, err := s.Next(ctx)
check(err)
fmt.Printf("%s 收到 %s\n", label, string(msg.Data))
}
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
defer cancel()
newNode := func() (host.Host, *pubsub.PubSub) {
h, err := libp2p.New(libp2p.ListenAddrStrings("/ip4/127.0.0.1/tcp/0"))
check(err)
ps, err := pubsub.NewGossipSub(ctx, h)
check(err)
return h, ps
}
a, pa := newNode()
b, pb := newNode()
c, pc := newNode()
defer a.Close()
defer b.Close()
defer c.Close()
// 手动连接,排除节点发现对实验的干扰。
check(a.Connect(ctx, peer.AddrInfo{ID: b.ID(), Addrs: b.Addrs()}))
check(a.Connect(ctx, peer.AddrInfo{ID: c.ID(), Addrs: c.Addrs()}))
join := func(ps *pubsub.PubSub, name string) *pubsub.Topic {
topic, err := ps.Join(name)
check(err)
return topic
}
newsA := join(pa, "demo/news")
gameA := join(pa, "demo/game")
newsB := join(pb, "demo/news")
gameC := join(pc, "demo/game")
subB, err := newsB.Subscribe()
check(err)
subC, err := gameC.Subscribe()
check(err)
defer subC.Cancel()
// 等待两种订阅通知抵达 A,避免刚订阅就发送。
waitPeers(newsA, 1)
waitPeers(gameA, 1)
check(newsA.Publish(ctx, []byte("news-1")))
check(gameA.Publish(ctx, []byte("game-1")))
receive(ctx, subB, "B")
receive(ctx, subC, "C")
subB.Cancel()
waitPeers(newsA, 0)
check(newsA.Publish(ctx, []byte("news-2")))
fmt.Printf("A 可见 news 订阅邻居数:%d\n", len(newsA.ListPeers()))
check(gameA.Publish(ctx, []byte("game-2")))
receive(ctx, subC, "C")
}在保存 main.go 的目录打开终端执行:
go mod init example.com/p2p-topics
go get github.com/libp2p/go-libp2p@v0.48.0 github.com/libp2p/go-libp2p-pubsub@v0.18.0
go run .预期结果(以下为程序打印的关键业务行,依赖安装日志可能另有输出):
B 收到 news-1
C 收到 game-1
A 可见 news 订阅邻居数:0
C 收到 game-2其中 news-2 仍由 A 调用 Publish,但 B 已退订且没有其他新闻订阅邻居,所以不会再出现 B 的新闻接收输出。ListPeers 统计的是当前直连且声明该主题的邻居,并非全网订阅人数。
退订边界与直连请求
调用 subB.Cancel() 会取消 B 的这一个订阅;若 B 对该主题已没有其他有效订阅,PubSub 才向邻居通告退订。取消订阅不等于断开底层连接,也不会让之前的消息重新排队或被自动补发。消息不持久化,需要历史记录时应额外使用存储与补偿同步。
| 需求 | 应选方式 | 判断依据 |
|---|---|---|
| 把房间事件分发给多个感兴趣的节点 | GossipSub 主题 | 同一条事件可对应多个订阅者 |
| 向指定节点查询某个文件块并等待响应 | libp2p 协议流 | 必须明确目标 Peer ID 与请求响应语义 |
| 仅允许获授权用户读取私密消息 | 应用层鉴权与加密 | 主题名与订阅不是权限控制机制 |
排查“已连接却收不到主题消息”时,依次核对主题名称是否逐字一致、订阅是否仍有效、ListPeers() 是否已出现目标邻居,再检查消息校验和传播情况。把主题命名当作安全边界,或用广播消息模拟必须返回结果的单播请求,都会造成错误的行为预期。