Table of Contents

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。