跳至内容
快捷操作与系统菜单

快捷操作与系统菜单

移动端快捷操作和桌面托盘分别设计,但连接、切换和更新行为与主界面保持一致。

iOS 和 Android

长按 OneXray 应用图标,可以使用四个快捷操作:

操作 功能
启动 VPN 使用已保存的配置连接;缺少设置或授权时仍需补齐。
停止 VPN 停止当前连接。
切换配置 按当前计划打开既有服务器或完整配置选择页面。
更新订阅 按照已保存的设置更新订阅。

这里指应用图标的快捷操作,不是 Siri 快捷指令。Android 另提供默认关闭的 带 Token 的广播自动化,用于第三方工具后台启停;它与图标快捷菜单独立。

Android Widget 与通知

在设置页或桌面的小组件列表中添加流量 Widget。紧凑布局以 4×2 占格为目标,实际占格由桌面决定。它展示应用图标、连接状态、上下行速率、本次连接流量和启动/停止按钮;VPN 通知展示同一连接的统计。

已有完整启动配置且授权满足时,Widget 与快捷设置 Tile 直接在后台启动 VPN 服务;否则打开 App 补齐配置。停止无需打开 App,点击 Widget 标题或统计区域则打开 OneXray。强制停止 App 后,小组件可能保留旧画面,直到 Android 后续刷新。长按快捷设置 Tile 只打开已有 App Activity,不额外提交 VPN 命令。

macOS 菜单栏不展示网速;请在连接页查看本次连接统计。

桌面托盘菜单

通过菜单栏或系统托盘中的图标,可以:

  • 启动、停止或重新连接 VPN。
  • 选择自动、订阅、全部手动服务器、提供方配置或单个节点;选择个人 Raw JSON 配置。
  • 切换流量方式。
  • 更新全部订阅或单个订阅。
  • 更新路由数据,包括默认数据对或单个自定义数据源。
  • 显示主窗口或退出 App。

每个动态数据列表最多显示十项。这只是菜单展示上限,不限制保存的数据数量,完整列表请在 App 中查看。自动选择、手动添加、更新全部等固定入口不占这十项;“更新全部”仍处理完整集合。

未连接时,切换只保存选择,不会自动启动 VPN。已连接时,影响当前连接的修改沿用 App 的确认与重连流程。更新结果和失败原因通过系统通知提示。没有服务器等托盘启动失败不会仅为展示错误而强制打开主窗口;需要交互的设置或授权可以打开窗口。

退出行为

macOS 和 Windows MSIX 的“退出”会保留 VPN 连接;如需同时停止,选择“退出并停止 VPN”。Windows EXE/ZIP 和 Linux 退出时会停止 VPN。

连接 · Windows 渠道

iOS/iPadOS 连接组件与控制中心

OneXray 最低支持 iOS/iPadOS 16。可从系统组件库添加小号或中号主屏幕 Widget,以及系统允许位置的圆形/矩形 accessory。16 上点击打开连接页;accessory 组件始终只打开连接页。

17 起,主屏幕 Widget 使用一个电源按钮;18 起,控制中心提供同一个单按钮。点击时重新读取原生状态:已连接或正在连接时停止,已断开时启动,正在断开时不排队再次启动。可能过期的展示状态不决定实际动作。

系统支持时,动作在主 App 进程后台执行。启动复用最近生成的运行配置与已有系统 VPN 配置,不按后来修改的选择重新编译,也不等待测速。缺少运行输入或必须授权时才打开连接页供用户继续,不自动改用其它计划连接;停止不依赖启动文件。

Widget 跟随 App 语言与系统明暗外观,只展示状态与单一电源操作,不展示观测时间、流量、服务器或订阅详情。快照缺失或超过 15 分钟显示未知,刷新时机由 WidgetKit 管理。状态摘要与 onexray://widget/connect 链接仅打开连接页。当前不发布通用命令 URL、可发现的 Siri/App Shortcut 或 Live Activity。

最后更新于