Skip to content

Relay 隧道 ​

Relay 在 Agent 之间建立加密通道。流量经过中继节点再到后端,适合入口节点无法直连后端、需要利用中继节点线路优势的场景。

前置条件 ​

  • 控制面已部署并正常运行
  • 至少有两个 Agent 节点(一个做入口,一个做中继)
  • 中继节点的监听端口在防火墙中放行

创建 Relay 监听器 ​

进入 基础设施 → Relay 监听器,选中继节点,点击 新建监听器。

字段示例说明
名称relay-fast-vps给中继起个名字
监听证书来源自动签发(Relay CA)维护升级前由系统管理;内部 PKI 激活后由 tunnel identity 接管
绑定地址0.0.0.0监听所有网卡
监听端口7443中继节点实际监听的端口
公网入口relay.example.com:7443其他节点连接中继时用的地址
传输方式TLS/TCP新手用默认值,熟悉后可试 QUIC

创建 Relay 监听器

保存后在列表中确认监听器已启用。

生产环境应先完成内部 PKI 升级与激活。激活后的 TLS/TCP 与 QUIC Relay 都使用双向 TLS,双方证书必须属于当前 PKI domain,并匹配 Agent/listener identity、用途、有效期和撤销状态。界面中仍可见的旧 Relay CA/Pin 字段只服务维护升级前的兼容状态,不是故障时的安全回退。

Relay 监听器列表

在规则中使用 Relay ​

创建 HTTP 或 L4 规则时,在 Relay 配置 标签页点击 添加 Relay 层,选择刚创建的 Relay 监听器。

text
客户端 → 入口 Agent → Relay 隧道 → 出站 Agent → 后端

每层可以放多个 Relay 监听器作为并行候选,多层表示按顺序逐跳转发。新手先配一层一个节点,跑通后再扩展。

L4 Relay 配置

验证 ​

保存规则后回到列表,规则卡片带 Relay 标记说明已关联隧道。测试入口端口或域名确认连通。

还应验证无证书、错误 CA/EKU/identity/domain、过期或已撤销证书均被拒绝;同时 Agent 的 heartbeat/revision 等控制请求仍通过原 URL 和 X-Agent-Token 成功。PKI degraded 时 Relay 数据面会 fail closed,但不会把控制协议切换成 mTLS。

Relay vs 直接转发 ​

场景用 Relay直接转发
入口节点能直连后端不需要✓
入口节点无法直连后端✓不通
想利用中继节点线路✓不需要
需要多跳(A→B→C→后端)✓不支持

深入了解 Relay 的协议细节,见 Relay 协议内幕。

基于 GNU General Public License v3.0 发布。