设置
设置管理 App 偏好;VPN 隧道与 Xray 运行设置使用各自的独立主导航。
外观与语言
首次安装时,主题和语言跟随系统,也可以手动选择明暗主题或:
- 简体中文
- 繁体中文
- 英语
- 俄语
- 波斯语,支持从右到左布局
不支持的系统语言回退为英语。JSON、URL、IP 和日志始终从左到右显示。Apple 平台在支持的版本上提供应用图标选择。
Linux ARM64 当前会将中文、日文或韩文语言选择显示为英语,以规避字体/渲染问题;保存的语言偏好不变。该回退不影响 Linux x86_64 或其他平台。
OneXray 跟随系统的减少动效偏好。减少动效时,开关、选择反馈和 JSON 辅助滚动直接到位;连接准备仍保留状态文字、静态加载图标和取消入口。App 没有独立的动画开关。
启动
“App 启动时连接”与桌面端“登录时启动”“启动时隐藏”相互独立,默认均关闭。
桌面关闭窗口只隐藏。macOS/MSIX 如需同时断开,应使用“退出并停止 VPN”;EXE/ZIP 和 Linux 的“退出”会先停止 VPN。
macOS 原生标题栏支持拖动及系统设置的双击操作,包括缩放/恢复。重新打开已最小化的桌面窗口时会先恢复再聚焦,关闭窗口仍为隐藏。Linux 在 Wayland 与 X11 使用系统标题栏和窗口按钮,移动、缩放与最大化遵循桌面环境;托盘菜单由桌面面板打开。App 保持 Skia 渲染,以兼容 Mesa SVGA3D 显示驱动。
下载标识
下载统一使用兼容默认值 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 私钥,请妥善保管。
清理数据
设置提供两个独立动作:
- 清除连接资源删除节点、个人 Raw、订阅、手动分组、自定义路由与自定义 GeoData,以及连接选择和旧运行文件/日志;保留 App 偏好、平台 VPN/拨号/网卡设置、备份绑定及外部访问授权。
- 清除全部 App 数据进一步重置连接、启动、更新和备份设置,解绑备份并撤销本地 API/Android 自动化授权,重建默认路由数据;主题、语言、App 图标、Dock 显示、隐私/首次设置标记和系统权限保留。
两者都先确认并停止 VPN,再替换数据;停止失败不继续删除。完成后不重新进入 Setup,也不自动连接。外部备份文件及服务商保存的 HWID 记录不会删除。需要的连接资产请提前备份;备份范围并不包含全部偏好或文件。
导航与编辑
页面优先使用图标和明确的主标签,精简重复提示并统一卡片与行的间距。当前值、订阅套餐、流量、延迟与运行状态仍显示;输入错误,以及删除或重连的后果,仍会在需要时说明。
macOS 可通过 App 菜单的**设置…**或 ⌘, 打开设置,并恢复已隐藏/最小化的主窗口;已有对话框只会被带到前台,不丢弃草稿。宽屏保留左侧主导航,内容使用单栏;规则列表、详情与编辑器均为完整页面。顶部导航显示页面标题与当前操作,主题在设置中选择。
控件保留明确的无障碍名称和可操作触控范围。订阅、测速和隧道 DNS 字段在校验后于输入附近持续显示错误,保留草稿供修正。关闭已修改的节点 JSON 编辑器时可选择继续编辑或放弃,保存成功则正常关闭。备份与恢复包含匹配平台的可迁移 VPN 设置,物理网卡、权限和 App 偏好仍留在本机。