OneBoxM sing-box
01 前置步骤 获取官方客户端 02 当前步骤 快速上手与配置导入 03 延伸参考 选择兼容订阅服务
支持 sing-box 1.14.2 配置体系 iOS 18.0+ · iOS Universal 通用流程说明

OneBoxM 使用教程与快速上手指南

OneBoxM 是由 OneOh Cloud LLC 开发、基于 sing-box 的 iOS 流量重路由工具，支持读取并兼容 sing-box 配置，用于网络流量重路由并通过加密隧道转发流量。本页为您提供从安装客户端、导入配置、建立连接到检查生效状态的四步通用上手流程。

文档说明：由于官方文档未给出可核实的详细界面步骤，以下快速上手内容采用通用操作流程阐述，不涉及未经核实的菜单名、按钮名或设置项；应用内具体名称与操作细节以官方文档及实际发布版本为准。
PHASE 01 · 获取与准备

下载安装

在满足系统版本要求的 iPhone 或 iPad 设备上，前往 Apple App Store 官方页面获取并安装 OneBoxM。App Store 将该应用标为免费获取（Free），兼容性为 iOS Universal，提供英文和中文语言支持。

开发者与包标识 OneOh Cloud LLC · cloud.oneoh.networktools
最低系统与版本信息 iOS 18.0 · 当前版本 2.0.0（以官方页面为准）
提示：OneBoxM 的 iOS 获取入口以其 App Store 页面为准；安装过程中的系统权限确认提示，具体名称以官方文档及 iOS 系统显示为准。
查看 iOS 官方下载详情（download.html）
PHASE 02 · 配置与规则

导入订阅或配置

打开应用后，通过应用内的配置管理入口导入兼容 sing-box 格式的配置文件或远程配置来源。OneBoxM 支持读取并兼容 sing-box 配置（当前版本说明注明支持最新的 sing-box 1.14.2），同时支持使用 Override 覆盖当前配置文件中的部分设置。

配置兼容性 读取并兼容 sing-box 配置文件
高级分流与覆写 支持 Rule Set 与 Override 参数覆盖
提示：导入配置、添加 Rule Set 或设置 Override 时涉及的应用内入口，具体名称以官方文档为准。
PHASE 03 · 启动与接管

连接

选定已导入的配置文件后启动连接。连接建立后，OneBoxM 可接管设备上的 TCP、UDP、ICMP 流量并通过加密隧道转发至指定服务器。您还可以根据使用场景配置按需连接（On-Demand Connections），令应用在满足特定网络条件时自动管理连接状态。

接管协议类型 TCP / UDP / ICMP 流量转发
自动化连接方式 支持按需连接（On-Demand Connections）
提示：首次启动流量接管或开启按需连接（On-Demand Connections）时的开关项与授权提示，具体名称以官方文档为准。
PHASE 04 · 状态确认

检查是否生效

开启连接后，确认系统的网络重路由状态及应用内的运行信息，测试目标网络访问是否已按配置文件中的域名、IP-CIDR 等路由条件分发至对应出口，并确认 DNS 解析（支持自动获取 DNS 服务器以及 DNS over TCP、DNS over TLS、DNS over HTTPS）工作正常。

路由分流依据 根据域名、IP-CIDR 等条件路由至不同出口
DNS 协议支持 自动获取 DNS · DoT / DoH / DNS over TCP
提示：查看连接状态、路由命中情况或 DNS 状态的界面区域，具体名称以官方文档为准。
NEXT STEP · 配置来源与订阅选择

还没有准备好兼容 sing-box 的配置或订阅服务？

OneBoxM 作为客户端工具本身需要配合有效的远程服务器与配置文件使用。前往“机场推荐”页面，了解如何评估与选择兼容 sing-box 格式、支持 TCP/UDP/ICMP 转发及分流规则的订阅服务。

前往机场推荐了解如何选择订阅服务（airport.html）