HaloRelay
HALORELAY · 使用与维护

Veyra 协议与算法

面板 / Agent 0.7.19 · 授权站 0.3.7 · 更新于 2026-10-11

故障快速索引 · 授权站更新 · 面板更新

查看在线使用指南

适用 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 出口组 + Guard2–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 会话绑定原出口,不会迁移或重放已发送内容;故障后可能需要客户端重连。

配置一个带主备的公网场景

  1. 升级面板及参与节点至 0.7.15,先确认新版本、近期心跳和引擎能力。
  2. 准备广州入口、香港主出口、香港备用出口,分别核对证书及可达的 TCP 隧道端口。主备尽量避免共用同一上游故障点。
  3. 在“出口组”按主、备顺序加入节点;创建使用该组的 Rust 加密隧道规则,选择受支持的 TLS / Veyra Secure。Guard 在此类规则中工作,无需额外购买算法开关。
  4. 先验证主出口承载的真实业务,再在测试规则中停止主出口,观察新连接切到备用。已有连接中断符合当前设计。
  5. 恢复主出口,持续创建新的测试连接,等待冷却和成功恢复探测后确认重新选择主出口。核对规则状态、实际出口、用量及失败记录。

不要为了测试停掉全部生产出口。出口组改善的是可用路径间的选择,不能在所有候选均被阻断时凭空建立连接。

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 实现为准。下列标准解释底层协议,不代表实现了标准的每个可选特性。