外观与语言

首次安装时，主题和语言跟随系统，也可以手动选择明暗主题或：

不支持的系统语言回退为英语。JSON、URL、IP 和日志始终从左到右显示。Apple 平台在支持的版本上提供应用图标选择。

Linux ARM64 当前会将中文、日文或韩文语言选择显示为英语，以规避字体／渲染问题；保存的语言偏好不变。该回退不影响 Linux x86_64 或其他平台。

启动

“App 启动时连接”与桌面端“登录时启动”“启动时隐藏”相互独立，默认均关闭。

桌面关闭窗口只隐藏。macOS/MSIX 如需同时断开，应使用“退出并停止 VPN”；EXE/ZIP 和 Linux 的“退出”会先停止 VPN。

下载统一使用兼容默认值 v2rayN/<OneXray 版本> <完整 OneXray User-Agent>，包含版本与平台信息。每个订阅独立提供可选 User-Agent，自定义值只覆盖该来源，清空后使用默认值；没有全局 User-Agent 选择器。

“关于”展示 App 版本、更新信息和支持链接，关于区域还显示 Xray-core 版本。发现新版本后，“关于 OneXray”增加圆点，桌面导航也显示提醒。设置根页不再单独提供“检查 App 更新”。

订阅和 GeoData 的周期在高级 → Xray → 数据更新配置。

移动端应用图标操作和桌面托盘控制见快捷操作与系统菜单。

数据区域提供备份与恢复：Apple 使用 iCloud Drive 或所选文件，Android 使用系统选择的文件，Windows 使用 OneDrive 同步文件夹。App 只绑定一份可覆盖的连接配置文件，Linux 不显示此入口。

自动备份默认开启。绑定空文件或选择覆盖时，即使开关关闭也会写入首份备份；已有文件也可预览后恢复。后续自动写入使用独立的 1／3／7 天周期，默认 3 天，与 GeoData 无关。备份未加密，可能包含凭据和 Age 私钥，请妥善保管。

清理会先停止 VPN，再删除应用配置、订阅、自定义路由数据和偏好，并重建默认路由数据。停止失败不会继续删除；隐私与首次初始化完成标记不重置。

此操作会删除数据，请提前备份连接配置或导出需要的独立项目；备份不包含文件、系统权限和通用 App 偏好。清理 App 数据不会删除外部备份文件。清理也会删除本地订阅 HWID，但不会删除服务商的设备记录；重建有设备限制的订阅前，请阅读 HWID 说明。

macOS 可通过 App 菜单的**设置…**或 ⌘, 打开设置，并恢复已隐藏／最小化的主窗口；已有对话框只会被带到前台，不丢弃草稿。宽屏路由区利用可用列宽，常规规则列表与编辑区域左右等宽。

控件保留明确的无障碍名称和可操作触控范围。订阅、测速和隧道 DNS 字段在校验后于输入附近持续显示错误，保留草稿供修正。关闭已修改的节点 JSON 编辑器时可选择继续编辑或放弃，保存成功则正常关闭。备份与恢复包含匹配平台的可迁移 VPN 设置，物理网卡、权限和 App 偏好仍留在本机。

最后更新于十月 31, 2026