HyPanel v0.5.23

Stop switch toggles from bouncing back during background refresh

HyPanel v0.5.22

Auto-refresh page data and surface Agent error details

HyPanel v0.5.21

修复失效上报阻塞 Agent 同步

• 已删除服务或用户的旧流量记录不再使整次同步失败；仅丢弃已不存在对象的记录，不计入流量，其他有效记录继续按权限和幂等规则处理。
• 删除服务或清理历史诊断后，迟到的日志命令结果不再阻塞心跳。仍存在的命令继续校验 Agent 所有权和命令类型。
• Agent 已认证、但同步内容未通过校验时返回 400，不再错误返回 401，避免误报“凭据被拒绝”并进入每 300 秒重试。

此修复在面板端，现有 Agent 无需先升级。若节点因失效上报卡住，更新面板后会在下一次重试恢复（凭据拒绝状态下最长约 5 分钟）。真正无效的凭据仍会被拒绝，需要独立处理。

验证：207 项服务端测试通过，覆盖删除服务后的旧流量/诊断结果、重复重试、外部服务所有权拒绝及未绑定用户拒绝。

HyPanel v0.5.20

面板一键收集出口两端网络诊断

• 服务日志页增加“收集日志与网络诊断”。使用出口转发的服务点击一次，即向入口和出口两个 Agent 下发请求，在同一页面显示两端结果。
• 诊断包含接口地址、WireGuard 公钥/监听端口/对端/握手/收发量、策略路由、双向隧道 ping、nftables 与 INPUT/FORWARD 规则、转发和 ICMP 内核设置。
• 所有采集命令只读，不修改网络配置，不读取 WireGuard 私钥或预共享密钥；采集受超时和输出大小限制。
• 即使出口节点没有该代理进程，也可按该服务的出口隧道收集诊断。无关节点不能收到该服务的采集请求。

请同时更新面板和两端 Agent 到 0.5.20。在入口节点“日志”页选中故障服务，点击“收集日志与网络诊断”，稍候查看两端结果，无需 SSH。

验证：399 项自动测试和前端构建通过，覆盖两端请求、无关节点拒绝、重复请求限制、命令参数隔离及输出大小限制。

HyPanel v0.5.19

出口切换与清理修复

• 修复清理旧 GRE 接口或孤立规则时，因路由表不存在而报 IPv4: FIB table does not exist / Flush terminated，导致配置中断的问题。不存在的表视为已清理，权限等其他错误仍正常报告。
• 出口能力上报独立于配置确认，Agent 重启后的初始状态不再阻止识别可用后端；不同配置的上报仍不能将出口标记为已就绪。
• 允许在 Agent 离线或尚未确认出口能力时停用无人使用的出口，避免旧 FOU 配置无法切换。使用中的出口仍需先迁移服务。

请更新面板和两端 Agent。若旧 FOU 不可用，在出口节点点击“停用出口转发”，选择 WireGuard、设置 UDP 端口，再点击“安装并启用出口转发”。

验证：397 项自动测试、前端构建通过；Linux 网络命名空间验证无路由表的旧接口及孤立规则可清理，WireGuard 出网、端口切换和断网保护正常。

HyPanel v0.5.18

WireGuard 工具按需安装

• Web 选择 WireGuard 后点击“安装并启用出口转发”，自动下载对应 Linux 平台的独立 wg 工具；入口节点的服务选用此出口时也会自动下载。
• 工具不随 Agent 安装包或 Docker 镜像下载，无需手动安装 wireguard-tools 系统包。
• 面板和 Agent 均验证文件大小与 SHA-256，使用 Agent 认证、GitHub 镜像和本地缓存；缓存损坏会重新下载。
• 继续支持 GRE、GRE over UDP（FOU）、WireGuard；FOU / WireGuard 可自定义 UDP 端口，所有代理服务均可选择出口。

请同时更新面板和两端 Agent。操作系统仍需提供 WireGuard 内核支持，以及 iproute2、nftables、ping。

验证：396 项自动测试、前端构建及无系统 wg 的 Linux 网络命名空间出网测试通过，覆盖共享出口、更换端口、删除服务和断网时停止出网。

独立工具基于 WireGuard 官方源码 1.0.20260223 构建；本发布附带对应源码归档。

HyPanel v0.5.17

新增 WireGuard 跨节点出口，并支持在面板中自定义 FOU / WireGuard 的 UDP 端口。

• WireGuard：同一出口共用一个监听端口，入口主动连接，面板自动生成并下发密钥、认证对端和路由。
• FOU 默认 UDP 47541，WireGuard 默认 UDP 51820；均可设置为 1–65535 中未被占用的端口。
• 保留出口断线停止出网，支持多个服务共享出口，并清理移除服务的地址、AllowedIPs、路由和旧 FOU 端口。
• 修复自定义端口出口停用后无法重新启用的状态问题，更新备份迁移和安装脚本。

升级面板和两端 Agent。已有 Debian / Ubuntu 节点若缺少 wg，需要在两端执行：

sudo apt-get update && sudo apt-get install -y wireguard-tools

新版 Agent Docker 镜像已包含工具；已有容器需更新镜像并重新创建。WireGuard 需要两端内核支持，通常只需在出口端放行所设入站 UDP 端口，入口端需允许 UDP 出站和会话回包。FOU 仍需两端内核 FOU 支持。

在出口节点的“设置 → 出口转发”选择后端和端口，启用并等待“已就绪”，然后在入口服务中选择该出口。更换已使用的后端或端口前，需要先解除服务引用并停用出口。

验证：395 项测试、前端及文档构建、NativeAOT 发布构建通过；Linux WireGuard 实际验证了多服务共享端口、出口 NAT、端口变更、握手保留、资源清理和断线停止出网。

HyPanel v0.5.16

Add kernel GRE over UDP exit transport

HyPanel v0.5.15

Show concrete exit failure reason in service status

HyPanel v0.5.14

Support cross-node exits for Xray services and fix exit selectors