xnvgatebox v0.9.6

候选刷新与候选检测现在支持周期设置，并增加 Clash/Mihomo 专用订阅格式。

• 在「候选节点 → 周期任务」分别设置来源刷新和批量检测：默认 60 分钟，最低 30 分钟，可独立关闭。
• 自动任务按完成时间计时，重启保留；同时到期先刷新、再检测。刷新失败保留旧候选，手动检测沿用原并发与优先规则。
• 系统定时器与管理器共用刷新到期记录和构建锁，避免重复请求来源。获取与验证仍由自己的 VPS 执行。
• 在「我的订阅」选择 Clash Verge / Rev（Mihomo）格式后复制链接。原 v2rayN 格式继续保留，转换不经过第三方服务。
• Clash 配置保留来源选择、名称与顺序，不加入 DIRECT 故障回落，不跳过证书验证。

固定官方 Mihomo v1.19.33 验证了生成配置，以及实际 VLESS/REALITY 订阅的 HTTPS 出口、页面内容和故障阻断；未覆盖所有 Clash Verge GUI 版本。完整包在 Debian 12/13、Ubuntu 22.04/24.04、CentOS Stream 9/10 的隔离 systemd 环境验证安装、更新保留及卸载；不替代独立 VPS 内核、SELinux 和服务商防火墙验收。

已有用户可在「设置 → 版本与更新」升级。更新保留管理地址、密码、订阅身份及已保存的出口设置，连接会短暂中断。安装命令见 README，操作说明见 周期任务与 Clash 订阅。

xnvgatebox v0.9.5

首次取得候选后，自动创建默认 16 个 VPN Gate 出口，无需先点击数量设置。

• 内置模式未设置数量、没有旧 Slot 时，保存 16 个目标、创建并绑定接入入口，按当前建连并发尝试连接。
• 手动刷新、定时获取和重启读取已有池均可触发；重复刷新不重复创建。
• 已有数量（含 0）、旧 Slot、端口、凭据、策略和停止状态保留；删除最后一个旧出口会保存 0，避免自动重新创建。
• 没有候选时等待；候选不足或连接失败不强求补足可用数量，只有通过实际验活的出口进入订阅，不自动回落本机直出。
• 首页第一步改为“刷新候选”，数量表单默认 16，仍可自行调整。管理员容量不足时明确提示，不静默降低数量。
• 修复删除全部出口后，卸载器误将合法空列表 null 当作异常而退出；异常格式仍拒绝清理。

已有安装可在“设置 → 版本与更新”升级。已有保存的数量会继续保留；需要改为 16 时可手动调整一次。获取、建连和出口验证仍全部在自己的 VPS 执行。详见 默认出口说明。

xnvgatebox v0.9.4

默认开启第三方镜像后备，并增加 VPN Gate 官方备用来源，减少单一入口不可达时的空清单问题。全部获取、筛选、连接与真实出口验证仍由自己的 VPS 完成。

• 获取顺序：www.vpngate.net 主入口 → download.vpngate.jp 官方备用 → 第三方原始 CSV 镜像。保持 HTTPS 证书校验，不固定服务器 IP。
• 新安装和未设置镜像选项的旧配置默认开启后备；用户已经保存的关闭选择继续保留，可在候选页“来源设置”调整。
• 原内置来源的旧配置会在读取时补上官方备用地址，不改写私有文件；自定义来源和明确空列表保持原意。页面区分官方备用和第三方镜像。
• 控制台、登录页与接入管理的方块 × 改用几何交叉线居中，避免字体基线偏移。

用户 VPS 已在临时目录实测：主入口连接超时后，新版 Builder 从备用来源取得 98 条未检测候选。候选数不代表可用出口数，仍需由本 VPS 检测；unknown 不代表住宅。本轮没有修改用户 VPS 的配置或部署。

已有安装可在“设置 → 版本与更新”升级。安装与支持范围见 README，来源说明见 文档。

xnvgatebox v0.9.3

候选节点新增“来源设置”。当当前来源不可达时，可由用户开启第三方原始 CSV 镜像后备；默认关闭，原来源成功时不会请求镜像。

• 获取、筛选、节点连接和真实出口验证都在自己的 VPS 完成，不依赖 GitHub Actions 或 Cloudflare 提供运行中的出口。
• 校验固定提交、文件长度与摘要、镜像声明时间及快照回退；来源获取有等待上限，失败保留原清单。
• 镜像配置限制为数据指令，拒绝脚本、插件和外部文件；不采用镜像的检测结论，导入后仍需本 VPS 检测。
• 页面区分 VPS 获取时间和镜像声明抓取时间，保留现有配置、凭据、端口与直出开关。

安装命令见 README。已有安装在“设置 → 版本与更新”升级后，进入“候选节点 → 来源设置”，勾选镜像后备并保存，再刷新候选池。

第三方镜像不是官方认证来源，文件摘要只证明与镜像索引一致。候选数量与可用出口数量不同，unknown 不代表住宅。支持 Debian 12/13、Ubuntu 22.04/24.04、CentOS Stream 9/10；自动测试采用隔离容器，独立 CentOS VPS 的 SELinux/firewalld 和真实 VPN Gate 链路仍需各自验收。

xnvgatebox v0.9.2

首次安装默认开启本机直出，并完善候选刷新进度和结果提示。

• 全新安装自动创建独立的 VLESS/REALITY 直出入口，可直接复制订阅。已有安装保留原开关、端口和客户端身份；旧工作目录不套用新默认。
• 点击刷新后立即显示处理状态、不确定进度条和等待秒数，结束后显示成功/失败、完成时间和候选数量。
• 单独显示上次成功获取清单的时间；相同数量也可能是正常刷新结果。获取候选不代表节点已通过连通检测。
• 明确区分刷新超时、来源暂不可用、构建占用和配置异常，缺池提示不再覆盖本次失败。请求失败后可重试。
• 修复旧轮询覆盖刚提交任务的状态；日志仅记录固定原因码和数量，不输出私有配置或进程原文。

默认直出是独立出口，VPN Gate 或第三方 SOCKS5 故障不会自动回落到直出。安装和更新仍不等待 VPN Gate 来源请求。

支持 Debian 12/13、Ubuntu 22.04/24.04、CentOS Stream 9/10（Linux x86_64、root、systemd）。自动测试覆盖默认直出实际订阅 HTTPS、更新保留及关闭直出后更新不重新开启，另有刷新状态、私密性与并发回归。容器测试不替代独立 VPS 网络、SELinux/firewalld 和真实 VPN Gate 正向连接验收；本版不承诺改变上游来源的网络可达性。

安装说明 · 首次使用 · 正式包六系统测试

已安装者在网页「设置 → 版本与更新」升级，或运行 xnvgatebox update。已有安装若本机直出关闭，升级后需按需要手动启用一次。

xnvgatebox v0.9.1

修复首次安装因无法获取 VPN Gate 候选清单而退出的问题。安装程序与节点筛选独立，来源暂不可达时也可登录后台，按需启用本机直出或添加第三方 SOCKS5。

• 安装和更新不请求 VPN Gate 来源，保留已有候选清单；没有旧池时仍可安装，不生成假候选或更新时间。来源获取交给后台刷新和定时任务。
• 安装终端显示依赖、下载、校验、候选、备份及启动进度；后台明确提示未取得清单并可刷新，定时重试继续生效。
• 配置、文件系统及程序错误仍会阻止部署；保留完整包校验、锁、备份、健康检查与回滚。
• VPN Gate 出口无可用候选时等待并阻断，不自动回落到本机直出或第三方代理。本机直出需用户明确启用，第三方代理需自行配置。

支持 Debian 12/13、Ubuntu 22.04/24.04、CentOS Stream 9/10（Linux x86_64、root、systemd）。本版六系统自动测试增加受控来源断连下的安装、实际直出订阅 HTTPS、更新保留、受控 HTTPS 合成清单恢复、正常更新及卸载。恢复服务使用临时可信 CA，保持 TLS 验证；合成候选不代表真实 VPN 可用。自动容器测试不替代独立 VPS 的 SELinux/firewalld 和上游 VPN 正向连接验收。

安装命令 · 首次使用 · 六系统测试

旧版本安装失败者可直接运行新版安装命令，无需卸载已装系统依赖或重装系统。已安装者可在网页「设置 → 版本与更新」升级，或运行 xnvgatebox update。本修复不会改变 VPS 到 VPN Gate 的网络可达性。

xnvgatebox v0.9.0

统一安装入口，支持 Debian、Ubuntu 和 CentOS Stream，并修复仅使用本机直出或自定义代理时更新后接入未恢复的问题。

• 支持 Debian 12/13、Ubuntu 22.04/24.04、CentOS Stream 9/10，要求 Linux x86_64、root、systemd 和所需网络隔离能力。
• CentOS 自动安装 EPEL OpenVPN，并从固定版本、校验过 SHA256 的上游源码构建匹配本机 PPP 的 SSTP RPM。
• 修复首次直出安装的升级预检、零 VPN Gate 出口重启恢复、systemd 静态服务状态识别和跨发行版 SSTP 证书路径。
• 更新项目首页、首次安装命令、系统支持说明及开发测试文档。首次安装自动生成管理路径和密码；更新保留已有凭据。

六系统自动测试覆盖真实依赖、systemd 新装、实际 VLESS/REALITY 订阅 HTTPS 出网、同版本更新、配置保留、备份和卸载。CentOS 另检查原生 RPM 和 PPP 插件加载。自动测试使用特权容器，共享 runner 内核；独立 CentOS VPS 的 SELinux/firewalld、内核能力和真实 VPN Gate 正向连接仍待验收。

安装命令见 README，系统范围见 Linux 支持，正式包测试见 Actions。已有安装可在网页「设置 → 版本与更新」升级，或运行 xnvgatebox update。

CentOS 7、CentOS Linux 8、ARM64 及非 systemd 环境不在本版支持范围。安装器不关闭 SELinux 或防火墙。

xnvgatebox v0.8.1

修复 v0.8.0 卸载在 systemctl reset-failed 处中止的问题。正常停止的定时器可能已被 systemd 释放，新版跳过多余重置；真正 failed 的服务仍重置并核对结果，真实系统操作失败继续保留文件。

旧版本或上次卸载中断后，无需重新安装，可直接在 VPS 下载修复工具：

curl -fsSL https://raw.githubusercontent.com/hanhaoops/xnvgatebox/v0.8.1/vps/deploy/uninstall.py -o /tmp/xnvgatebox-uninstall.py &&
python3 /tmp/xnvgatebox-uninstall.py --purge --legacy

输入 yes 确认。--purge 会删除本项目备份；要保留备份可去掉此参数。卸载范围与保护边界见 卸载说明。

105 项本机 Python（含 20 项卸载回归）、GitHub Python 3.9/3.12、既有 Node、Linux Go 全套及 race、隔离网络清理、真实 systemd 定时器和失败服务验证通过。真实 systemd 测试复现旧版多余重置返回 1，新逻辑完成停用与失败状态清理；只操作 CI 临时单元。

本轮只发布 GitHub，未访问或执行用户 VPS 卸载；用户实际重试结果待确认。CF 暂停，3x-ui 不修改，unknown 不称家宽。

v0.8.0 · 正式卸载与旧版清理

正式卸载工具与旧版入口整理。

• 新增 xnvgatebox uninstall：只读预览、交互确认、默认保留已有备份；--purge 删除项目备份，--legacy 清理已确认归属的标准旧安装。
• 支持固定版本独立卸载脚本，v0.7.0 及更早版本无需先升级即可使用。
• 安装/更新共用部署锁，未完成恢复、服务/实例占用、残留进程、符号链接、挂载点及网络归属冲突时拒绝继续；不把中断称为卸载成功。
• 按实例标识、持久网段、状态/检测记录和实际接口清理具体网络资源；保留 3x-ui、其他实例、共享依赖、全局 IP 转发和系统运行日志。
• 移除过时的独立安装脚本、f 菜单和旧服务示例，组件 README 统一到本项目说明；保留 MIT 许可证、上游来源及运行兼容。
• 打包排除部署工具的 Python 缓存。

更新后可以使用：

xnvgatebox uninstall --dry-run --purge --legacy
xnvgatebox uninstall --purge --legacy

第二条会删除配置、订阅凭据和备份，需输入 yes 确认。只卸载当前项目并保留备份使用 xnvgatebox uninstall。旧版本独立工具与标准安装范围见 docs/UNINSTALL.md。

验证：99 项 Python 回归、Node、Linux 258 个顶层用例 / 317 个通过事件及 race 通过；7 个实测/辅助入口显式跳过。新增隔离 Linux 内核测试实际清理 3 个 namespace、接口和规则，保留对照资源，验证残留进程拒绝与重复执行。服务控制在该隔离测试中使用模型，不冒充用户 VPS 的 systemd 验收。本轮只发布 GitHub，没有在用户 VPS 部署或执行卸载；CF 保持暂停，3x-ui 不修改，unknown 不称家宽。

v0.7.0 · 首次使用与接入管理

新装后的使用流程与接入管理修复。

• 已测候选会优先参与选点，正式连接继续独立验活；观察按配置摘要和 15 分钟有效期失效。
• 候选诊断与正式 OpenVPN 建连共享用户设置的并发数，恢复优先，等待名额单独显示。
• 实测出口国家独立通过 HTTPS 查询并校验 IP，订阅显示国家与国旗；查询失败或过期如实显示地区未知，unknown 不会因此成为住宅。
• 接入管理统一展示自动与手动入口，新增时可选择稳定出口，包括等待中的出口；可配置、启停和删除手动入口，自动入口明确由出口数量维护。
• 首次未配置数量时预填 4，已保存的 0 和既有数量保留；修正接入详情的实际安全方式显示。
• 首页移除长说明，只留：设置出口 → 等待就绪 → 复制订阅 → 导入使用。

已有安装：设置 → 版本与更新 → 检查更新，选择 v0.7.0 执行。更新后重新登录并刷新客户端订阅。安装命令和详细步骤见 README 与 docs/FIRST_USE.md。

验证：85 项本机 Python、Node 回归、浏览器合成演示、GitHub Python 3.9/3.12、Linux 258 个顶层用例 / 317 个通过事件及并发 race 检查通过。7 个需要实测环境或辅助入口的用例显式跳过。公开测试 IP 的国家服务查询通过；本轮没有部署新装 VPS，后台实际升级与客户端代理链路仍需单独验收。CF 保持暂停，3x-ui 不修改，unknown 不称家宽。