P2P 会员与 gossip 广播
分册导航:net.md | net-topology.md | net-transport.md | [net-raft.md](raft 接入) | net-identity-security.md | net-p2p.md | net-observability.md | 运行拓扑与一致性 | 传输配置与调参 | raft 共识接入 | 身份与安全档 | P2P 会员与 gossip 广播 | 可观测与故障注入
8. P2P 会员与 gossip 广播
无中心服务器的对等组网:HyParView 会员管理维护"我认识谁"(视图),gossip 广播 负责"通知所有人"(最终一致送达)。两者独立启用——只要会员、或只要广播皆可。
8.1 会员管理(HyParView)
await using var endpoint = await ClusterBuilder.Create(nodeId)
.WithP2P(seed: bootstrapNode) // null = 本节点是种子(只启动不加入)
.StartAsync(ct);
// 观测面
var p2p = endpoint.Mechanisms.OfType<PeerMechanism>().Single();
foreach (var peer in p2p.ActiveView) { } // 对称活跃邻居(有界 k)
p2p.ActiveCount;
| 概念 | 行为 |
|---|---|
| 活跃视图 | 在线对称邻居(双向确认),大小有界(缺省 ≤ 4)——消息扇出/转发的目标域 |
| 被动视图 | 备用池(缺省 ≤ 20)——活跃邻居断连时自动补位 |
| JOIN | 新节点从种子出发随机游走入组(应答丢失不阻塞——视图收敛交给周期维护) |
| 故障检测 | φ accrual 基于心跳到达间隔判定(缺省阈值 8——误判率可忽略),限时检出 |
常用参数(PeerOptions With 链):WithActiveViewSize(k)、WithPassiveViewSize(n)、
WithHeartbeatInterval、WithPhiThreshold、WithJoinWaitTimeout——缺省值适合小中型
对等组起步。
8.2 gossip 广播(最终一致性)
一条消息最终送达全体可达成员——不保证顺序、不保证送达。适合通知/通告/拓扑事件; 要可靠或要确认,走 raft(§6)或请求回调(§4.1)。
// 挂载时开启(缺省关)
await using var endpoint = await ClusterBuilder.Create(nodeId)
.WithP2P(seed, PeerOptions.Default.WithBroadcast())
.StartAsync(ct);
var broadcast = endpoint.Mechanisms.OfType<PeerMechanism>().Single().Broadcast!;
broadcast.MessageReceived += (origin, data) => { }; // 最初广播者 + 载荷(同消息至多投递一次)
await broadcast.BroadcastAsync(payload); // 沿活跃视图扇出,逐跳转发
| 语义 | 行为 |
|---|---|
| 去重 | 同一消息(MsgId)全网至多投递一次——多路径副本/转发环回自动归一 |
| TTL | 缺省 4 跳,每转发一跳减一,减尽即停(断链拓扑下终止转发) |
| 扇出 | 沿活跃视图转发,上限可调(WithFanout——缺省整个活跃视图) |
| 载荷上限 | 缺省 60KB,超限源头即抛(数据报尽力语义,不做分片) |
参数(BroadcastOptions With 链):WithTtl、WithFanout、WithDedupCapacity、
WithMaxPayloadBytes。