HaloRelay
HALORELAY · 使用与维护

用户手册

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

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

先确认你正在操作哪个系统

官网提供帮助;购买授权的客户中心保存软件订单;你自己部署的转发面板管理自己的服务器和客户;Agent 在节点机器执行规则。这几处账号、数据和 Token 各自独立。

主站是 HaloRelay,授权中心默认名为 HaloRelay License。授权站 0.3.7 更新使用 sudo halorelay-license update;主站使用自己的版本与更新入口,两者不能相互替代。授权站升级清单错误见 0.3.7 修复说明,移动管理与 IPA 导入问题见 iOS 使用说明。

本页操作名称按 0.7.18 源码整理。先在“版本与更新”查看实际面板与 Agent 版本,部分能力需要两者配套更新及新版固定主机工具。发行源码、已构建签名包、你正在运行的版本是三个不同状态。

接入服务器节点

  1. 管理员打开“服务器节点 → 添加服务器节点”,填写容易识别的名称,按实际用途选择入口、出口或双角色。
  2. 设置有效期、转发额度和需要手动补充的地址,保存后取得当前节点接入 Token。
  3. 打开该节点“安装 / 管理”,先确认面板公开访问地址和下载通道,复制专用安装指令到对应服务器执行。
  4. 下载令牌、Agent Token 分别在提示处输入。Token 重置或节点删除重建后,旧指令不能继续复用。
  5. 安装完成后确认“在线”、当前版本、最近心跳、引擎能力与角色;不要把仅出现“安装完成”当成业务验收。

节点列表可搜索、筛选、分页及切换卡片/列表,实际操作入口以当前版本为准。不要向客户公开管理员专用的节点间接入地址。

地址自动发现与专线填写

公网 IPv4、IPv6 和内网地址来自 Agent 本机接口、可用的云厂商元数据,以及配置了可信代理时面板获得的来源信息。NAT 机器的本机接口可能只有私网;云接口也可能超时或无此字段,因此自动发现不是公网可入站证明。

  1. 先看节点提示的数据来源、最近心跳和版本。若云厂商接口超时,核对服务商控制台的“可连入地址”。
  2. 在“编辑节点”补充公网 IPv4/IPv6,填写纯 IP,不加端口、协议或方括号。
  3. 在“内网 / 专线地址”填入入口实际可达的服务商接入 IP。新版允许公网格式的有效单播专线 IP,不依赖单个厂商或单个地址白名单。
  4. 仍会拒绝回环、组播等不适用于远端接入的地址;不能为了兼容 IX 而让所有特殊地址通过。
  5. 从入口服务器测试出口的实际隧道端口。云厂商白名单、端口映射、仅出网 IP 都会影响可达性。

“面板未取得可信公网来源”只表示缺少可信数据。核对真实反代链与可信 CIDR,或手动补地址,不要将所有来源设为可信。

出口证书自动登记与重装

正常安装时,出口自动生成节点证书并上传公开验证证书和绑定名称。私钥保存在节点,不需要复制到面板;修改线路连接 IP 也不应关闭证书验证。

场景应当怎么做
首次安装新出口使用当前节点专用命令,等公开证书登记和新心跳
保留配置重装使用“备份并重装”;有效且匹配的标准路径证书自动复用
完整卸载后的出口/双角色在“安装 / 管理”确认“完整卸载后重装:授权重新登记”,按提示重置 Token 并使用新 Token 安装
纯入口完整卸载后重装使用当前入口记录和 Token;无需出口证书重新登记步骤
删除节点后重建使用新记录、新编号、新 Token,重新检查规则关联

出现“节点上报的证书与已保存配置不同”时,系统保留旧信任是为了防止被冒充节点覆盖。确认是你操作的那台服务器后再授权新证书登记。单纯重置 Token 不代表仍可复用的证书一定需要更换。

跑通第一条端口转发

  1. 打开“转发规则 → 添加规则”,选择在线入口,设置监听地址、空闲端口和 TCP/UDP 协议。
  2. 先选择端口直转,填写真实目标地址及目标业务端口。默认从 Rust 引擎开始。
  3. 设置必要的来源与目标访问范围,避免开放给任意人使用;保持规则在账号和套餐授予范围内。
  4. 在入口安全组和本机防火墙放行该业务端口。目标服务器也要实际监听并允许入口连接。
  5. 保存并启用,查看配置是否已由 Agent 应用;再从真实客户端连接入口,确认拿到目标业务响应。

“已保存”“已下发”“Agent 已应用”“真实业务成功”是不同阶段。目标能 ping 通不能代替业务端口测试。

两节点加密隧道与 IX 接入

准备广州入口和一台香港/IXP 出口 Agent。出口的“出口加密连接设置”应有可连接的地址、端口、证书绑定名称和公开证书。

  1. 添加隧道规则,选择入口与出口、监听端口、目标地址和支持的传输方式。
  2. 如果入口应通过云厂前置、IX 或专线访问出口,启用出口的“内网 / 专线连接”,填写服务商交付的可连入 IP。该 IP 可以是普通公网格式。
  3. 只拥有两个 Agent 时使用两节点隧道;服务商给的国内接入 IP、海外出网 IP、机器内部 IP 不等于三台中继节点。
  4. 验证入口能连出口隧道端口,出口能连目标。使用 QUIC 还要放行对应 UDP。
  5. 保持证书检查开启。专线可达、线路隔离和通信加密是不同条件。

有序中继链、主备出口与多入口

有序链决定经过哪些独立服务器。例如“广州入口 → 香港中继 → 香港02 中继 → 香港03 出口 → 目标”。当前上限是两个中继,不能无限追加;同一节点不能重复担任链上的多个位置。

  1. 先接入所有参与节点,确认版本、角色、证书和相邻节点的地址可达。
  2. 在规则的转发链编辑器选择中继顺序和最终出口。传输按整条链统一选择,不能假设每段能任意混用 Direct/Secure/QUIC。
  3. 需要走内网/专线时,逐一核对下一跳配置,不能只看第一段。
  4. 从入口创建真实业务,检查每段配置与出口响应,先验证单规则再批量复制。

主备出口组用于选择可用出口,切换主要作用于新连接;存量连接可能需要客户端重连。多入口业务把多个独立入口组织到同一业务配置,各入口有各自监听与用量,和同一连接带宽融合不同。

转发引擎与实验传输

选择用途限制与检查
Rust默认转发及完整策略协同高级能力按当前 Agent 支持范围
Realm专用转发适配依赖程序与权限;由 Rust 前置协同
nftables / iptablesLinux IPv4 NAT 后端适配需要内核/网络管理权限;不等于纯 NAT 路径
Secure节点间加密与认证出口公开证书和绑定名称完整
Veyra QUICTCP 可靠流、UDP 数据报两节点实验功能,不兼容所有链/出口组/融合组合
TCP 多链路融合同一连接使用多条通路,出口重组实验功能,只处理受支持的 TCP 场景;不保证提速

新版标准安装会准备引擎依赖;系统缺包、包源不通、容器权限不足、内核模块缺失仍可能使某个引擎不可用。编辑器按节点实际能力给提示,不要只因为文件存在就强行选择。

上下行流量、开机时长与节点额度

节点有两种流量:网卡上行/下行表示整机收发,包含其他程序;转发用量表示面板规则相关的统计。带宽是速率,流量是累计量;GiB 额度不是 Mbps 带宽。开机时长是服务器运行时长,不是 Agent 启动时长。

  1. 编辑节点,设置转发流量额度。选择双向累计之和或单向累计上下行较大值的计费口径。
  2. 选择“不重置”“按到期日的日重置”或“每月固定日期”。新建带到期日的节点默认按到期日的日号重置;没有到期日的节点默认不重置。已有节点会保留原来的明确选择。
  3. 例如到期日期为 2027-02-24,选择“按到期日”时取日号 24;它不表示到期后自动续费。
  4. 保存后核对页面显示的下次重置时间、已用额度和到期时间。周期基于服务端计算,勿直接用浏览器当地零点推断。
  5. 节点额度和客户套餐账本分开处理,不能通过重置节点显示值当成已退还客户流量。

客户规则按原周期及原策略结算延迟上报,需配套支持的面板/Agent。该规则账本能力不意味着所有网卡计数都能恢复历史。升级后先核对一次账单和当前周期。

客户、权限与套餐

  1. 在“用户与权限”创建客户账号,设置初始强密码、可用节点、端口/目标范围和资源上限。
  2. 需要按套餐经营时创建套餐,设置期限、价格、用量口径、倍率和可用资源。价格配置不是实际收款。
  3. 客户创建订单后,管理员核实外部实际到账再“确认收款”,权益随后开通。
  4. 客户规则仍受账号、套餐和规则共同约束,实际有效上限取适用约束。把规则值改大不等于增加账号授权。
  5. 在客户视角验证能看到正确资源,不能访问他人节点、规则、订单或工单。

来源 IP 数量是入口实际看到的网络地址数,不等于设备数。多个设备共用 NAT 可能只有一个地址,同一设备切换网络也可能出现两个地址。

协议节点、订阅与交付

  1. Agent 在线后,在“授权与集成 → 协议节点”选择支持的协议、目标服务器及必要监听参数。
  2. 等待实际运行时就绪和服务回执。下载运行时、监听、客户端生成是不同阶段。
  3. 为指定客户创建配置或订阅,核对格式、可见节点、有效期与来源限制。
  4. 用兼容客户端导入并发起连接,确认连接经过你希望的入口;不要误用直连出口配置来测转发链。
  5. 泄露订阅链接或客户端凭据后应撤销/更换,不能仅从工单中删除文字。

外部代理、3X-UI 和 Agent 原生协议节点各自有适配范围。不要把一个导出格式支持某协议理解为所有客户端都支持该协议的全部扩展参数。

监控、日志、通知与工单

  • 先看心跳与资源,再看节点间可达性,最后看真实业务结果。TCP 探测失败率与 ICMP 丢包率不是同一个指标。
  • 规则启用连接日志后才会产生相应新记录。过滤条件、时间范围和保留策略会影响显示;日志不解密 HTTPS 正文。
  • 管理员配置邮件/Telegram 通道,接收人在自己的账号中选择通知事件和地址;查看投递记录,不将“已送达”等同于“已阅读”。
  • 客户服务提供公告、工单、回复和状态。提供故障时间、节点/规则名称、版本、步骤及脱敏错误,不提供密码或完整 Token。
  • 使用操作审计查看谁改了什么。列表支持的分页、搜索和页码跳转用于缩小范围,不应反复导出全量数据排一个节点的问题。

备份、迁移与恢复

  1. 在“系统设置 → 备份与恢复”导出业务备份,保存到另一台受保护设备。
  2. 使用定时加密备份时,配置间隔、保留份数并立即执行一次。需要异地副本时另配 SFTP,核对远端身份和回读校验结果。
  3. 分开保管备份密钥、集成密钥、安装配置、许可身份和 Agent 证书。仅有业务 JSON 或仅有密文不能代替完整恢复资料。
  4. 在隔离目标执行“恢复前检查”,确认格式、关联和版本,再按确认流程恢复。不要让两个控制面同时写同一业务数据库。
  5. 恢复后用原账号验证节点、规则、计费、通知、订阅与实际连接,再切换域名或业务。

备份包含敏感凭据,不放在网站公开目录。程序回退不会自动撤回数据迁移;没有恢复演练的备份只能算已保存,不能直接承诺可恢复。

面板和 Agent 在线更新、回退

  1. 打开“版本与更新”,核对当前面板与各 Agent 的真实版本,以及签名发行目录中的可选目标。
  2. 做备份并选择维护窗口。先用一台备用或测试 Agent 检查新功能,再分批升级其余节点。
  3. 界面允许时可在线更新面板、选定 Agent 或全部符合条件的 Agent;不允许时按提示配置固定更新器或复制对应服务器指令。
  4. 观察任务最终结果,核对实际版本、新心跳和业务流量。任务已提交不等于更新完成,失败恢复到旧版不等于升级成功。
  5. 回退只选择本机保留、可信且兼容的历史版本。某些持久策略/数据迁移会禁止降级,不能绕过兼容检查。

常用维护入口在对应服务器执行:

sudo halorelay

升级具体版本的完整命令请复制当前版本页生成的指令。Agent 程序版本和 root 固定主机工具版本不同;普通在线升级不能保证刷新安装器、卸载器和 Docker 主机管理脚本。

彻底卸载与重新安装

先迁移业务或安排中断,再在要卸载的节点机器执行预览:

sudo halorelay uninstall agent --complete --dry-run

确认计划只涉及该 Agent 后,再单独执行:

sudo halorelay uninstall agent --complete

新版维护菜单 11 明确为完整卸载 Agent。清理所属程序、配置、Token、自动生成证书、服务、历史版本与独占维护文件。安装前已有组件、共享系统包、其他服务、防火墙规则、外部证书和无法证明归属的内容不能随意删除;这不是恢复整台系统镜像。

旧主机工具不认识命令、或因失败切换状态拒绝卸载时,先按 旧工具恢复 校验并更新本机维护工具,再预览和卸载;无需为了刷新工具先覆盖安装。

本机卸载不会删除远程面板记录。重新安装同一纯入口可继续使用未重置的当前 Token;出口/双角色完整卸载后按 证书登记步骤 授权新证书。删除并重建节点后用新编号和 Token。

授权客户中心与运营者后台

普通购买者在官方客户中心查看软件订单、授权与下载交付、公告和工单,不需要初始化授权签发者。

运营者的授权后台与客户面板分开:可修改商业授权/下载凭据名称、撤销授权、续期、改绑和管理账户。商业授权“删除”按撤销处理,下载凭据删除同样撤销,历史记录保留用于审计。撤销软件授权受有效租约刷新机制影响,不应描述为远程抹除客户主机。

管理员和客户列表支持分页搜索、启用/停用;删除账户会撤销对应登录并保留关联历史。不能删除当前登录管理员或最后一位启用的超级管理员。下载 Token 撤销只影响后续获取包,不会抹去已经下载的程序。

授权站下载凭据与版本管理

授权站是运营者管理软件商业授权和私有发行下载权限的独立系统。下载凭据页面支持改名、查看受保护的元数据、撤销和删除;删除操作会先撤销下载权限,再归档记录并留下审计墓碑。商业软件授权不会按名称自动联动删除,需在商业授权页面单独撤销。

审计日志显示操作类型、关联对象名称与编号、来源 IP、访问设备、详情和时间,支持 10/20/30/50/100/200 条分页、日期筛选与跳页。只把它用于追踪管理动作,不把日志当作业务流量或客户连接日志。

授权站登录后的更新卡片显示当前版本及签名清单中的可用版本。更新前备份授权数据库、密码文件和部署配置;更新后检查登录、凭据列表、审计分页与下载桥接。授权站、转发面板和 Agent 分开更新,不能用其中一套系统的版本号代替另外两套。

订阅交付与节点检测

在“订阅链接 → 创建订阅链接”中,选择所属客户,再选择分配给该客户的协议节点、已部署节点或兼容的 3X-UI 落地。协议节点须由 Agent 确认运行;手工录入的已部署节点只表示资料已保存,需另外检测。不能把不同客户的凭据放到同一订阅。

如需转发,在节点卡片点击“设置转发入口”,创建新规则或选择目标一致、属于同一客户的已有 TCP 规则。新建时可选端口转发、隧道、按顺序添加中继的转发链或出口组。内网 / 专线地址须先在相应服务器节点配置;出口组沿用组内节点的地址设置。规则仍可在“转发规则”编辑。协议节点的服务配置也可从其对应规则的编辑入口修改。

绑定后,“复制配置”和订阅内容中的地址、端口替换为客户连接的入口,协议密码、PSK 等保持不变。转发入口改端口后,订阅下次拉取会跟随更新。首次绑定、更换入口服务器或改变凭据后,请重新保存已有订阅,以确认新的交付关系。停用、删除或改变规则目标后,系统停止交付,需修复或重新绑定。单纯复制一个改写后的字符串不会自动建立转发。

协议本版提供的文本格式
SS / SS2022、HTTP、SOCKS5Surge、Loon、Quantumult X,以及已有 URI、Mihomo、sing-box 格式
Snell(包括 v6)Surge;没有通用 URI,不生成伪造链接
VLESS Reality VisionURI、Mihomo、sing-box,以及参数兼容时的 Loon 文本
VLESS-ENC保留完整参数的原始 URI / Base64

0.7.19 起,界面始终列出七种格式,并显示包含及跳过的节点数量。混合订阅会按客户端能力导出兼容节点;Snell 仅进入 Surge,没有兼容节点时禁止复制并给出提示。Quantumult X 无法无损表达的特殊字段会明确拒绝。文本订阅是节点列表,请在客户端的节点订阅入口使用,不是完整的分流规则配置。客户端支持范围依据 Surge 文档、Loon 文档 和 Quantumult X 官方示例。

已部署 Snell v6 可明确保存 tfo、reuse、ecn 与 mode;默认模式为 default,也可按服务端配置选择 unshaped。这些选项须与实际服务及客户端版本匹配,不代表面板承诺加速或零丢包。PSK 在配置中加引号是字段引用形式,不表示密码增加了引号。

“检测连通性”默认从本站面板服务器检查 TCP 端口,只证明该路径的端口可连接。HTTP / SOCKS5 还可选择“通过此代理访问测试 URL”,默认值为 http://1.1.1.1/generate_204,可修改为公开 HTTP/HTTPS 地址;请求实际经过所选代理,认证失败、超时、TLS 错误会区分显示。其他协议本版只做 TCP 检测,认证和网页访问请使用对应客户端验证。检测拒绝内网、回环和保留地址,不跟随网页跳转,不读取网页正文。

检测结果不能代表客户所在地的网络、UDP、长连接和吞吐表现。转发规则自身与协议节点服务入口分别计量,请按业务的实际链路核对流量统计。

删除客户端订阅

“订阅链接 → 删除”需要确认。删除后记录移除,所有格式的旧链接立即失效,审计记录保留。不会删除落地节点、服务器或转发规则;也不会从客户设备中清除已经导入的节点凭据。仅需暂停时可以撤销或编辑停用。