# 版本更新与升级

Source: https://onexray.com/zh/docs/upgrading/
Description: 了解 OneXray 26.9.3 的连接配置备份、高级路由 JSON、FakeDNS，以及保留现有配置的升级方式。


## 从 26.9.2 升级至 26.9.3

- [连接配置备份](https://onexray.com/zh/docs/backup/)只保存一份可覆盖文件：Apple 使用 iCloud，Android 使用系统选择的文件，Windows EXE／ZIP／MSIX 使用 OneDrive 同步文件夹。自动备份周期独立配置，可选 1／3／7 天，默认 3 天；首次写入前必须确认保存位置。
- 备份文件可读取后，恢复配置不等待 GeoData 下载。缺失的自定义数据标记为待下载，只影响依赖它的配置；恢复的订阅需另行更新以获取节点。连接和服务器空页面提供恢复入口。
- [高级自定义路由 JSON](https://onexray.com/zh/docs/configuration/advanced-routing/)在复用 App 节点的同时，支持自定义范围内的 DNS、路由、嗅探、FakeDNS 地址池和附加入站。
- 智能路由和常规自定义路由支持可选 [FakeDNS](https://onexray.com/zh/docs/configuration/dns/)，常规规则增加协议和本机操作系统匹配。
- 完整 Raw JSON 已有的 `tunIn` 保留非托管设置，仅应用平台必需的托管设置，不再整体替换入站。
- [AI 配置指南](https://onexray.com/zh/docs/ai/)提供提示词和可导入示例。二级页面在当前 Tab 内打开，返回时回到来源页面。

数据库原位升级，保留现有配置和偏好。已有自定义路由仍为常规类型；FakeDNS 默认关闭。常规和高级自定义路由共用三条上限；Raw JSON 仍最多新增至三份，旧库超过三份的记录继续可用。正常从 26.9.2 升级无需重置或卸载重装。

备份未加密，可能包含凭据、Age 私钥和 HWID，不包含文件、订阅节点缓存、设备设置及 App 的最终出口选择。恢复是用户明确确认的替换操作，不是 App 升级时自动执行的步骤；存储提供程序写入成功也不等于云端同步完成。

[比较 v26.9.2 与 v26.9.3](https://github.com/OneXray/OneXray/compare/v26.9.2...v26.9.3)

## 从 26.9.1 升级至 26.9.2

26.9.2 在 26.9.1 重构后的界面上继续完善功能：

- 智能路由和自定义路由支持设置直连流量使用的[本地 DNS 地址](https://onexray.com/zh/docs/connect/smart-routing/)，并开放[隧道 DNS 的三项配置](https://onexray.com/zh/docs/advanced/vpn-tunnel/)。
- 订阅可按需发送随机生成、保持不变的 [HWID](https://onexray.com/zh/docs/servers/subscriptions/)，默认关闭，不读取硬件标识。
- 移动端提供四个应用图标快捷操作，桌面端扩展[托盘菜单](https://onexray.com/zh/docs/shortcuts/)。
- Apple 平台关闭“接管全部流量”后，可以配置[排除的网段](https://onexray.com/zh/docs/advanced/apple/)。
- 简化首次设置，进入主界面时完成必要的平台授权；连接失败时展示更具体的原因。
- Geodata 自动更新仅在 VPN 已连接时执行。更新失败保留旧文件，不断开或重启 VPN。
- Windows 安装包附带对应架构的 Microsoft Visual C++ 运行库；改进桌面 Core 生命周期、VPN 状态同步、窗口行为、系统分享和流量刷新。

数据库会原位升级，保留节点、订阅、Raw JSON、自定义路由、偏好设置和测速结果。新增的 HWID 开关默认关闭；未修改的路由继续使用默认本地 DNS。正常从 26.9.1 升级不需要卸载重装，也不需要重新完成首次设置。

[比较 v26.9.1 与 v26.9.2](https://github.com/OneXray/OneXray/compare/v26.9.1...v26.9.2)

## 从 v26.8.4 及更早版本升级

以下变化仅针对旧产品模型，不适用于从 26.9.1 或 26.9.2 进行的正常更新。26.9.1 用四个主页面和独立的服务器／路由选择，替代了旧版配置流程。

### 更新前

请独立保存需要重新配置的内容。新版本不支持导入旧备份 ZIP。尤其是 Windows 用户，应先确认当前安装渠道。

### 保留的数据

数据库升级会保留本地节点、订阅与 Raw JSON。旧库中超过三份的 Raw 配置仍会完整显示、正常选择和编辑，只隐藏新增入口。

旧 Profile 与 Full Config 不再参与新界面和连接流程，也不会自动转换成自定义路由。需要的规则请在“自定义路由”重建，或整理为兼容的完整 Raw JSON。

从旧产品模型升级时会重置运行偏好。连接前重新检查服务器选择、路由、授权和平台 VPN 设置；节点延迟信息也会重新检测。

### 功能迁移

| 旧操作 | 新操作 |
| --- | --- |
| Home 节点列表和独立订阅页 | 服务器：按订阅或节点位置分组 |
| 简易配置、独立 Xray Profile | 智能路由与统一的高级设置 |
| 结构化 Full Config | 自定义路由支持的规则与高级 JSON，或完整 Raw JSON |
| 规则／全局／直连 | 智能路由／所有流量经过 VPN／自定义路由 |
| 配置内的日志和隧道设置 | 高级 → VPN 隧道／Xray |
| 备份与恢复 | 单文件 JSON 连接配置备份，不支持旧 ZIP 备份 |
| 历史累计流量 | 已移除，仅显示本次连接流量和速率 |

旧的独立“直连”模式不再是流量方式选项；直连仍是智能路由和自定义规则中的一种动作。

## Windows 渠道

EXE/ZIP 使用原生 TUN 和 UAC，MSIX 使用 Windows 系统 VPN。两者的数据目录、登录启动和退出行为不同。安装另一渠道不会自动导入原渠道数据。

[Windows 详情](https://onexray.com/zh/docs/advanced/windows/) · [26.9.1 重构变化](https://github.com/OneXray/OneXray/compare/v26.8.4...v26.9.1)