iOS 和 Android

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

操作	功能
启动 VPN	使用已保存的配置连接；缺少设置或授权时仍需补齐。
停止 VPN	停止当前连接。
切换配置	常规模式打开服务器页；专家模式打开连接页的 Raw JSON 选择界面。
更新订阅	按照已保存的设置更新订阅。

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

Android Widget 与通知

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

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

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

桌面托盘菜单

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

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

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

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

退出行为

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

连接 · Windows 渠道

iOS／iPadOS 连接组件

从系统组件库添加 OneXray。主屏幕小号和中号组件支持 iOS／iPadOS 15 及以上；圆形与矩形 accessory 组件要求 16 及以上，具体添加位置由设备和系统决定。

iOS 15–16 点击打开连接页。iOS 17 起，主屏幕组件另有明确的启动 VPN和停止 VPN动作：打开 OneXray，使用 App 当前选择并执行正常权限检查。accessory 组件仅打开连接页。启停由前台 App 执行，组件扩展不在后台直接启动 VPN，也不开放通用命令 URL。

组件跟随 App 语言与系统明暗外观，展示最近一次原生连接状态与观测时间，不展示实时流量、服务器或订阅信息。快照缺失或超过 15 分钟显示未知，刷新时机由 WidgetKit 管理。公开链接 onexray://widget/connect 仅打开连接页，不启停 VPN。

最后更新于十月 31, 2026