传输配置与调参
分册导航: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 广播 | 可观测与故障注入
5. 传输配置与调参
装配器方法覆盖常用项;全部运行参数经 WithTransport 调整,两种形态:
// 整份注入:自带一份配置(显式方法未触达的项以注入值为准)
var options = TransportOptions.Default(null, peers)
.WithHandshakeTimeout(TimeSpan.FromSeconds(5));
await using var a = await ClusterBuilder.Create(nodeId)
.WithTransport(options)
.Listen("0.0.0.0", 9400) // 显式方法仍裁决对应项
.StartAsync(ct);
// 管道改写:在装配结果上叠加(可多次调用,链尾依次执行——最终裁决)
await using var b = await ClusterBuilder.Create(nodeId)
.Listen("0.0.0.0", 9400)
.WithTransport(o => o.WithReconnect(
TimeSpan.FromMilliseconds(100), 2.0, TimeSpan.FromSeconds(1)))
.WithTransport(o => o.WithKeepalive(true))
.StartAsync(ct);
裁决顺序:显式方法(Listen/Peers/ClusterTag/WithUdp)> WithTransport 注入 > 缺省表;管道链尾执行 = 最终裁决(可覆盖前述全部——ConfigureTransport 语义)。
NetClientBuilder 同款(客户端拨入带标签集群记得 ClusterTag)。
5.1 常用调参示例
// 重连退避:raft 场景封顶建议 < 选举窗一半——选举节奏不被重连劫持
o => o.WithReconnect(initialDelay: TimeSpan.FromMilliseconds(100), backoffFactor: 2.0, maxDelay: TimeSpan.FromSeconds(1))
// 传输级保活(NAT/防火墙长连接;双方都开才生效)
o => o.WithKeepalive(enable: true, interval: TimeSpan.FromSeconds(10), maxUnanswered: 3)
// 请求回调:高并发在途 / 大响应去重预算
o => o.WithRequest(timeout: TimeSpan.FromSeconds(3), pendingCapacity: 8192,
dedupCapacity: 4096, dedupMaxBytes: 32 << 20)
5.2 旋钮速查表
| 你要调 | 旋钮(缺省) | 什么时候动它 |
|---|---|---|
| 握手超时 | HandshakeTimeout(3s) |
跨地域高延迟链路放宽 |
| 重连节奏 | ReconnectInitialDelay(100ms)/ ReconnectBackoffFactor(×2)/ ReconnectMaxDelay(2s) |
与选举窗/业务重试节奏对齐 |
| 传输保活 | EnableKeepalive(关)/ KeepaliveInterval(10s)/ KeepaliveMaxUnanswered(3) |
NAT/有状态防火墙环境 |
| 请求超时 | RequestTimeout(3s;per-call RequestOptions 覆盖) |
慢接口单独放宽走 per-call |
| 请求在途上限 | RequestPendingCapacity(4096,满抛 fail-fast) |
高并发 RPC |
| at-least-once 重放窗口 | RequestDedupCapacity(1024)/ RequestDedupMaxBytes(8MiB) |
大响应 + 重试语义 |
| 流式背压窗口 | StreamWindowFrames(16 帧) |
大块吞吐 vs 内存占用 |
| 写队列深度 | WriteQueueFrames(64 帧) |
写突发削峰 |
| UDP 单报预算 | UdpMaxDatagramBytes(1200B) |
适配链路 MTU |
| 慢回调观测阈值 | SlowDispatchThreshold(10ms) |
调低抓慢 handler |
5.3 UDP 数据报承载
builder.WithUdp(9401); // 端点绑定 + 握手通告对端;port 0 = 动态端口
- 数据报/请求回调可走 UDP 承载(尽力语义不变);单报预算缺省 1200B(不做 IP 分片 依赖)——超预算自动回落 TCP 承载,调用方无感。
- 加密场景:UDP 认证标签仅 KeyPair 档(会话派生 32B 标签,无键=丢弃计数);mTLS 档 UDP 报文不带认证标签(明文数据报——机密性/完整性需求走 TCP/流式通道,无自动回落实现)。
5.4 生效配置观测
endpoint.Options // 装配自证——全部裁决后的最终值(TransportOptions)
排查"配置没生效"先看这里(管道链尾执行结果即它)。