适用 HaloRelay 0.7.18 · 2026 年 10 月
先按业务目标选择
普通公网节点互联从 Rust + Veyra Secure 开始;需要多个出口主备时,在支持的出口组中使用 Veyra Guard v1;UDP 路径可用且允许试验时,再对照 Veyra QUIC。不要一次开启所有功能:QUIC、出口组、多跳与 TCP 融合存在组合限制。
Veyra 是 HaloRelay 的节点间传输与调度体系。自研部分包括连接身份认证、规则与权限协同、多通路重组和故障恢复调度;底层使用成熟 TLS、QUIC 和密码学实现。Veyra Guard 是调度算法,不是新加密算法,也不会把网络封锁变成可达路径。
| 你的目标 | 起点 | 使用前提 |
|---|---|---|
| 广州入口经公网到香港出口 | Rust + Veyra Secure | 出口 TCP 隧道端口可达,证书与名称匹配 |
| 主出口故障后改用香港备用出口 | Rust + Secure 出口组 + Guard | 2–4 个有效出口,同一传输类型,Agent 已升级 |
| 腾讯或阿里入口进入服务商 IX | 先确认服务商路由,再用 Secure | 入口属于允许网络,IX 地址与映射端口真实可达 |
| 可信专线且业务已端到端加密 | 可对照 Direct | 已确认隔离、权限、目标身份与业务加密范围 |
| 小包 UDP 实时业务 | 单独测试 Veyra QUIC | 两节点 Rust,出口 UDP 可达,符合数据报大小限制 |
| 探索单 TCP 流多通路吞吐 | 实验 TCP 带宽融合 | 2–4 条通路到同一出口,无链、出口组或 QUIC |
先区分四个层次
控制面连接是 Agent 向面板取配置、报心跳的 HTTPS 连接,例如面板的 24443 端口。业务隧道是入口 Agent 到出口 Agent 的连接。客户端协议决定客户端如何连接业务;执行引擎则负责落地规则。四者相关,但不能互相替代。
典型路径为“客户端 → 广州入口 → Veyra 隧道 → 香港出口 → 业务目标”。Veyra 的隧道加密保护节点之间的这一段;客户端到入口、出口到目标仍由业务自身负责。出口终止了代理或 TLS 时,要重新评估下一段是否仍是密文。
更换面板 HTTPS 证书只影响控制面入口配置,不应要求重建业务隧道证书。面板回连成功也不代表出口业务端口可达。
Veyra Secure 如何工作
Secure 使用 TLS 1.3 保护节点间连接,先校验证书与绑定名称,再进行绑定当前 TLS 会话的认证。规则身份、来源策略、软件授权、流量额度和控制租约继续生效。实现中的兼容名称为 halolink,界面显示 Veyra Secure。
适合先追求可验证、易维护的公网 TCP/UDP 转发。TCP 使用可靠字节流;UDP 在 Secure 中通过可靠流封装,保留消息边界,但底层丢包重传可能使后续数据报等待。实时业务是否合适要测延迟和抖动。
安装出口 Agent 后检查公开验证证书、证书绑定名称、隧道地址与端口。只上传公开证书,私钥留在出口。不要关闭证书验证,也不要把 HTTPS 面板证书直接当成隧道证书。
Veyra Guard v1 如何恢复故障
Guard 在新连接发送业务数据之前,按管理员排列的主备顺序选择出口。首个握手失败后进入冷却,其他新连接可以尝试备用;所有候选失败时返回失败,不擅自直连目标或降低加密要求。
| 连续失败阶段 | 冷却时间范围 | 恢复行为 |
|---|---|---|
| 第 1 次 | 2.5–5 秒 | 冷却期间跳过该候选 |
| 第 2 次 | 5–10 秒 | 避免持续密集请求故障出口 |
| 第 3 次 | 10–20 秒 | 继续使用可用的备用候选 |
| 第 4 次及以后 | 15–30 秒 | 保持有上限的恢复等待 |
随机抖动分散同时重试。冷却结束后,有新业务连接到来时,每条规则的每个故障候选只放行一次恢复探测;其他并发连接继续尝试备用。探测取消会释放资格。失败期间早已开始、后来才返回的旧握手结果不能覆盖新故障状态,避免出口状态反复误翻转。
成功握手耗时以“旧平滑值 × 7/8 + 新样本 × 1/8”更新,仅用于观测。它不是纯网络 RTT,也不会自动改变主备顺序。无新业务时不会为了恢复状态持续发起独立探测,因此冷却结束不等于恰好在该秒完成切换。
Guard v1 仅接入 Rust 的有序 TLS / Veyra Secure 主备出口组,候选数量为 2–4 个。它不适用于单出口、Direct、QUIC、中继链、TCP 融合或 Realm/nftables/iptables 后端。已有 TCP 连接和 UDP 会话绑定原出口,不会迁移或重放已发送内容;故障后可能需要客户端重连。
配置一个带主备的公网场景
- 升级面板及参与节点至 0.7.15,先确认新版本、近期心跳和引擎能力。
- 准备广州入口、香港主出口、香港备用出口,分别核对证书及可达的 TCP 隧道端口。主备尽量避免共用同一上游故障点。
- 在“出口组”按主、备顺序加入节点;创建使用该组的 Rust 加密隧道规则,选择受支持的 TLS / Veyra Secure。Guard 在此类规则中工作,无需额外购买算法开关。
- 先验证主出口承载的真实业务,再在测试规则中停止主出口,观察新连接切到备用。已有连接中断符合当前设计。
- 恢复主出口,持续创建新的测试连接,等待冷却和成功恢复探测后确认重新选择主出口。核对规则状态、实际出口、用量及失败记录。
不要为了测试停掉全部生产出口。出口组改善的是可用路径间的选择,不能在所有候选均被阻断时凭空建立连接。
Veyra QUIC 的适用场景
QUIC 是实验功能,适合在两节点 Rust 线路上比较 UDP 数据报承载与可靠流承载的表现。TCP 业务通过可靠 QUIC 流传输;UDP 业务通过 QUIC DATAGRAM 传输,丢失的业务数据报不会由此层重传。可靠传输也有超时和连接失败,不能承诺零丢包或零中断。
两端须上报 veyra_quic_v1 能力,出口隧道端口须放行 UDP。规则只选择一个入口与一个出口,不能与出口组、中继链、TCP 融合组合;UDP 不可达时不会静默切回 TLS 或 Direct。
每个业务 UDP 包须小于当前可发送数据报大小减 24 字节,并受 65507 字节上限约束;实际常远低于 64 KiB。过大包被明确丢弃,不分片或截断。查看 oversize_dropped、replay_dropped、queue_dropped 和 unknown_session_dropped,但这些本机计数不是端到端网络丢包率。
0.7.15 的实现禁用 0-RTT 与连接迁移,尚无跨业务会话的 QUIC 连接池。每个 Agent 进程入口与出口合计最多 64 个 QUIC 连接,同时最多 16 次握手;队列和内部窗口均有上限。达到上限会拒绝新会话,不能作为无限并发产品宣传。
TCP 带宽融合与多跳如何选择
实验 TCP 融合把一个 TCP 流拆成片段,经 2–4 条已认证通路发送,在同一个出口按序重组。它面向多条可利用通路的吞吐试验;若共享同一个瓶颈,或通路延迟相差很大,收益可能很小,甚至更慢。任何通路失败会结束该连接,不重放业务载荷。
有序链让业务依次经过中继,当前最多两个中继;主备出口组选择一个出口;多入口是多个独立入口。它们分别解决路径组织、出口可用性和接入部署,不能当作同一个连接的带宽叠加。
国内云 IX 和国际线路的判断
广州公网到香港先以 Secure 建立基线。PO0 等线路若限制 80/443,应先分别解决面板 HTTPS 回连端口与私有下载通道;换业务隧道协议无法修好面板 24443 被跳回 443 的配置。
腾讯、阿里等云入口到 IX 时,服务商允许的来源网络、路由和端口决定可达性。“内网 / 专线”表示指定接入用途,地址可以是公网格式。某个广州入口能通,不代表所有地区或所有云产品都能通。使用自己购买的线路与服务商允许的用途,避免用协议名称推断平台许可。
香港到日本等国际段仍按加密边界选择。业务密文贯穿且对端身份可信时可测试 Direct;业务为明文或需要 Agent 间身份认证时选择 Secure。没有一种传输能保证国内服务器永不封禁、反向阻断永不发生或国际 IP 永久可达。
同路径验收和回退
固定客户端、入口、出口、目标、时段与带宽限制,每次只改一种传输。分别记录上下行吞吐、握手耗时、业务延迟分位数、失败率、UDP 业务丢包、CPU、内存和重连耗时。测试小包、大包、空闲连接、持续负载、出口断开及恢复,不用单个测速峰值代替稳定性。
将 Guard 与原有主备逻辑对照时,重点记录故障出口握手请求量、切换成功率及恢复时间。将 QUIC 与 Secure 对照时,还要确认 UDP 可达和消息大小。先在隔离规则验收,再小批量交付;出现回归时手动切回已验证的规则并等待两端新配置回执。
0.7.15 已完成 Rust 回归与隔离多 Agent 故障恢复验证。真实广州、深圳、上海、香港及国际线路的长时间性能收益仍需客户现场测量。当前没有实现自研 FEC、无缝 TCP 跨出口迁移、通用防封锁或自动跨协议降级。
与节点自动重连的关系
Agent 0.7.15 对控制面连接失败继续有限退避重试;收到失效 Token 或许可拒绝时停止转发并继续检查。修好网络、证书或恢复有效凭据后可重新接入。管理员重置令牌后必须把对应新令牌安全写回该节点,自动重试不能恢复已经撤销的身份。
变更面板地址应先开通新 HTTPS 入口、保留旧入口,再让在线新节点收到已认证的地址清单并缓存。最多保留四个批准入口。旧版或已经完全失联的节点无法接收新地址,需要本机连接修复。完整步骤见官网“证书与节点恢复”专题。
标准和进一步阅读
自研机制的上述范围以 HaloRelay 0.7.15 实现为准。下列标准解释底层协议,不代表实现了标准的每个可选特性。