如何理解本页版本
文档更新日期:2026-10-11。面板与 Agent 的文档基线为 0.7.19,授权站最新已发布修复版为 0.3.7。以下记录不代表所有服务器已经更新,也不代表下载站已提供每个架构的签名包。可安装目标以有效发行目录为准;官网和授权站独立部署。先看实际版本,再按 维护指南 操作。
面板 0.7.19:七种订阅格式与删除
订阅链接始终显示原始链接、Base64、Mihomo、sing-box、Surge、Loon、Quantumult X。混合订阅按格式导出兼容节点,显示包含与跳过数量;无兼容节点时明确提示。Snell 仍只进入 Surge。已有订阅无需重建。
客户端订阅支持确认删除,所有旧链接立即失效并保留审计。不会删除落地节点或转发规则,也不会清除客户端已保存的凭据。
在转发面板服务器更新:
sudo halorelay update panel 0.7.19
本次订阅修复在面板端生效,不需要为此卸载 Agent。
授权站 0.3.7:升级包修复与独立品牌
本版修复 0.3.6 发行包混入工作站附属文件,导致升级提示“源码包存在未列入清单的文件”的问题。文件清单、签名和摘要检查继续保留;发布前增加最终压缩包解压验收,原版 0.3.5、0.3.6 更新器已通过 Linux 兼容性验证。
- 使用原命令原地更新,不需要卸载、清空配置或更换授权签发身份。
- 默认站名调整为 HaloRelay License,与 HaloRelay 转发面板区分;已明确自定义的站名保持不变。
- 保留下载凭据撤销与删除、审计对象名称与编号、分页、系统设置和版本提醒等既有能力。
只在授权站服务器执行,输入运营者下载密码:
sudo halorelay-license update
看到 更新完成:0.3.7 后,检查 sudo halorelay-license status,重新登录核对版本与原记录。完整原因和后续检查见 升级包修复。面板和 Agent 的版本号不会因此变化。
本次官网补充了什么
新增授权站升级失败的原因与处理流程、不同组件 401 的凭据对照、主站与授权中心名称说明,以及 iOS 包导入和图标排查。补齐 0.7.18 订阅来源、转发入口绑定、Snell 参数、客户端格式与连通性检测说明;保留 PO0 / 宝塔、证书更换、重装卸载、套餐节点授权、流量周期和 Veyra 使用场景索引。
官网提供面向用户的配置步骤和能力范围,不公开生产凭据、签名私钥或内部实现。官网内容更新不需要客户重新安装节点。
授权站 0.3.6:下载凭据管理与更新提示
授权站管理器 0.3.6 与面板版本独立发布,登录后在侧栏和系统更新卡片显示当前版本;只有签名清单确认存在更高兼容版本时才显示更新提示。
- 下载凭据的改名、撤销、删除操作间距和分页控件重新整理,支持每页 10/20/30/50/100/200 条及跳页。
- 删除下载凭据会先撤销下载权限,再从正常列表归档;旧 Token 继续被拒绝,审计记录保留。
- 审计日志保留删除墓碑、关联对象名称与编号、来源 IP、访问设备、详情和时间,不写入完整 Token 或私钥。
- 商业软件授权与下载凭据保持独立,避免按名称误撤销其他客户的有效授权。
授权站升级与面板、Agent 分开执行;更新前先备份授权数据库、密码文件和部署配置。
0.7.18:统一订阅交付与节点检测
本版把协议节点、转发入口和已部署节点纳入同一套订阅来源管理,补齐无通用 URI 的 Snell 客户端交付,并增加面板发起的连通性检查。
- 创建订阅时可同时选择协议节点与已部署节点;绑定转发入口的节点会使用入口地址和监听端口,避免把源站地址交给客户。
- 新增转发入口绑定,可使用端口转发、转发链、隧道或出口组,复制与订阅跟随关联规则的端口。
- 增加 Surge、Loon 和 Quantumult X 文本格式;Snell 仅提供 Surge。没有标准 URI 的 Snell 节点不会被伪造为 URI,格式不兼容时会明确提示。
- 已部署 Snell v6 可保存
tfo、reuse、ecn和模式选项;面板只输出实际保存的配置。 - 协议节点与已部署节点支持本站 TCP 检测;HTTP / SOCKS5 支持通过代理访问公开测试 URL,其他协议的认证需在客户端验证。
- 邀请注册和长表单对话框改为可滚动布局,避免底部提示被遮挡。
面板服务器执行:
sudo halorelay update panel 0.7.18
标准原生节点执行:
sudo halorelay update agent 0.7.18
详细字段与验收步骤见 订阅与节点交付说明。
0.7.17:低内存 Agent 安装修复
本版修复小规格云节点在发行包完整下载、签名和 SHA256 校验通过后,仍因 Python gzip.py MemoryError 无法安装的问题。
- 压缩包 SHA256 改为分块计算,避免把整个压缩包复制到内存。
- tar 安全解析和写盘改为有界流式处理,单次只读取最多 1 MiB 文件块。
- 保留路径、类型、重复项、tar 校验、结束块、解压总量、签名、包大小、SHA256 和 Linux ELF 架构检查。
- 安装失败仍在写入系统前停止,不覆盖已有配置;更新后从面板重新复制当前命令即可。
面板服务器执行:
sudo halorelay update panel 0.7.17
标准原生节点执行:
sudo halorelay update agent 0.7.17
具体步骤见 低内存节点安装修复。
0.7.16:维护工具与安装流程
本版保留 Veyra Guard v1、节点持续重连和 HTTPS 地址迁移能力,新增旧版维护工具修复入口。
- 节点管理分为「状态与修复、首次安装、备份重装、升级与回退、完整卸载」,首次安装与
--reinstall重装命令分开展示。 - 管理员可复制固定摘要校验的维护工具修复命令;工具版本和 Agent 版本独立显示,不把升级 Agent 当成更新了全部主机工具。
- Agent 0.7.16 只读上报三项维护文件摘要;未知、缺失、不可读和匹配状态分别提示。普通客户看不到管理命令及维护报告。
- 官网增加适用范围、故障分类、检查顺序和验收说明。
面板服务器执行:
sudo halorelay update panel 0.7.16
标准原生节点执行:
sudo halorelay update agent 0.7.16
旧节点无需为取得修复工具先重装 Agent。先按维护工具修复指南修复,再决定升级、检查连接或完整卸载。Agent 0.7.16 配合维护工具 0.7.15 是本版正常组合。升级后核对真实心跳与转发;离线状态不会因点击复制命令自动消失。
官网故障排查知识库
已将历史上确认过的 Docker 更新 401、慢速下载、宝塔 24443 跳转、节点准入、证书重登记、完整卸载重装、引擎依赖、公网地址发现和 IX 接入等问题整理到 常见问题 → 历史故障快速索引。每条都包含处理顺序、验收标准和不能做的高风险操作;新版本出现同类问题时会优先在该索引补充。
0.7.15 · 节点持续重连与 Veyra Guard
本版 Linux x64 面板与 Agent 签名包已发布,标准 HTTPS 与 24443 下载通道均提供 0.7.15。其他架构以实际签名目录为准。官网迁移到新加坡,与客户面板独立部署;更新官网不会自动更新你的面板或节点。
- Agent 对网络中断、证书问题和鉴权失败持续有限退避重试;身份失效时立即停止转发,有效身份恢复后可重新连接。
- 在线新版节点接收并缓存面板批准的 HTTPS 入口,支持首选地址与备用入口。迁移需先开通新入口、保留旧入口直至确认节点已迁入。
- 完整卸载可处理已校验的本 Agent 失败切换记录;未知文件、其他组件及正在运行的维护仍受保护。
- 增加本机连接修复工具与宝塔独立 24443 入口工具。旧固定维护脚本须按 恢复专题 单独更新,普通 Agent 更新不等于主机工具更新。
- Veyra Guard v1 用于 Rust 的 2–4 个 TLS / Veyra Secure 主备出口,增加随机退避、单次恢复探测和并发结果保护。详见 算法与使用场景。
先备份,在面板服务器执行:
sudo halorelay update panel 0.7.15
然后在节点服务器分批执行,或在新版面板提交符合条件的在线任务:
sudo halorelay update agent 0.7.15
更新后核对实际版本、新心跳、规则和真实流量。下载报 401 先看 下载凭据修复;无法卸载或提示未知修复操作看 旧维护工具。本版不承诺已有 TCP 跨出口无缝迁移、不封禁或绝对零丢包。
0.7.14 · 套餐节点自动授权
- 已付款且有效的套餐自动授予订单快照中的节点,客户无需再由管理员逐个分配;未选节点的套餐沿用单独授权。
- 节点列表、规则、出口组、个人排序、只读 API 与 Agent 下发统一权限判断;到期撤权,续费恢复。
- 用户列表显示实际节点数量和授权来源;编辑用户不再误停用套餐授权规则。
- 此项修复只需升级面板,历史有效订单自动适用。账号与套餐的其他限制仍取更严格值。
0.7.13 · 节点与授权运营体验完善
- 主站导航按工作台、客户交付、工作空间和系统记录分组;授权管理支持改名、续期、额度调整和撤销。
- 授权站审计日志显示关联对象名称与 ID、来源 IP、访问设备、详情、记录类型、日期筛选和分页跳转。
- 节点诊断、流量方向、运行时长、月度额度周期和 IX/专线地址录入能力继续完善。
0.7.12 · 节点观测与额度默认修复
- 节点卡片和列表明确区分网卡下载(接收)与上传(发送),显示实时速率、累计收发和服务器开机时长;规则转发用量继续单独统计。
- 新建带到期日的节点默认按到期日的“日”建立月度额度周期;无到期日默认不重置,已存在的明确策略保持不变。
- 选择按到期日重置却未设置节点到期时间会被拒绝;IX/专线字段继续接受有效单播地址,不按某个厂商或单个 IP 特判。
0.7.10 · 授权站管理与分页
- 商业授权和下载凭据支持改名;删除按撤销处理,保留历史与审计。
- 管理员、客户、授权和下载凭据使用服务端分页与搜索;每页 10/20/50/100/200 条并支持跳转。
- 管理员删除保护,不能删除自己或最后一位启用的超级管理员。
- 客户账户支持启用/停用及删除处理,登录被撤销,订单、授权和工单历史保留。
- 远端下载管理桥接支持凭据改名,继续检查权限、会话和归属。
0.7.9 · 节点流量与地址
- 节点卡片分别展示网卡与转发上下行、开机时长、已计费额度。
- 节点支持单向/双向和不重置、固定月日或到期日重置策略。
- 手动内网/专线字段接受合适的单播接入地址,兼容公网格式 IX,不针对单个 IP 特判。
- IP、反向代理和证书提示增加数据来源与处理建议。
0.7.8–0.7.6 · 更新、界面和卸载
- 版本工作台区分当前版本、升级/回退方向、兼容条件和最终回执。
- 面板与 Agent 在线任务统一入口,不满足固定更新器或数据兼容要求时不强行执行。
- 侧边导航分组,操作记录的资源与变更摘要合理换行。
- 维护菜单 11 明确为完整卸载 Agent,防止误认旧保留配置行为。
0.7.5–0.7.3 · 受限网络与节点生命周期
- 面板回连地址与固定下载通道同时配置,增加无令牌诊断和宝塔 24443 指南。
- 出口保留配置重装复用匹配证书,完整清理后经管理员确认重新登记信任。
- 准入检查区分跳转、Token、证书、超时、角色等原因,避免盲目覆盖安装。
- 下载凭据在需要的安装阶段受保护保存,便于失败后的修复升级。
- 标准新节点准备 nftables、iptables 和签名包中 Realm,依赖检查先于重装停机。
- 更新恢复采用连续健康检查,固定 Docker 主机工具支持符合条件的恢复收尾。
较早能力:从转发到持续运营
已有端口转发、加密隧道、多入口、中继链、主备出口、来源限制、目标策略、客户套餐、订阅交付、工单、通知、审计与备份等能力。QUIC 与 TCP 带宽融合保持实验标记,真实线路性能仍需验收。
升级前与升级后
- 备份并明确恢复方法,查看本次说明和最低 Agent/主机工具要求。
- 检查下载权限、架构、磁盘与兼容目标,先在备用实例验证。
- 更新后核对实际版本、心跳、规则、真实连接和计费。
- 官网文案发布不修改客户数据库;授权站源码更新不代表 Agent 自动升级。