# 数据更新

Source: https://onexray.com/zh/docs/advanced/data-updates/
Description: 分别配置订阅与 GeoData 的全局自动更新周期，理解到期检查与 App 版本更新的区别。


入口：高级 → Xray → 数据更新，不在“设置”页面。

订阅与 GeoData 各有独立的自动更新开关和周期：

- 1 天
- 3 天
- 1 周

订阅设置对所有订阅生效，没有单条订阅的自动更新开关。默认 GeoSite/GeoIP 作为一组更新，自定义数据独立检查。

## 何时检查

App 在启动、回到前台、运行中的周期检查以及连接成功后检查是否到期。**订阅自动更新不要求 VPN 已连接；GeoData 自动更新仅在 VPN 已连接时执行。**

未连接时不下载 GeoData；连接成功后延迟约 3 秒检查。期间断开会取消延迟任务，更新过程中断开后不再启动后续数据源。启动 VPN 本身不触发 GeoData 下载或更新，缺少必要本地文件时明确报错。

手动更新和导入配置所需的依赖下载保持独立，不受“自动更新必须已连接”的限制。

这是 App 管理的到期检查，不保证 App 关闭后仍按固定时刻后台运行；下次检查可补做过期更新。

## 更新结果

订阅只有返回有效节点时才替换。失败保留原数据，成功汇报导入数量并进入测速队列，不静默切换正在运行的节点。

GeoData 校验后才发布，失败保留旧文件，不修改 VPN 状态，也不触发重连。默认组更新成功不代表全部自定义来源都成功，应查看各自结果。

App 版本检查是另一项功能，新版本信息通过“设置 → 关于 OneXray”查看。

连接配置自动备份在[设置 → 备份与恢复](https://onexray.com/zh/docs/backup/)中单独配置。它使用相同的 1／3／7 天选项，但周期和开关独立保存；修改或关闭 GeoData 自动更新不影响备份周期，备份也不要求 VPN 已连接。