sing-box 使用教程：Android / iOS 官方客户端导入订阅

sing-box 客户端怎么用：先认准订阅格式

sing-box 是由 SagerNet 维护的开源通用代理平台，官方为 Android、iOS、macOS 等平台提供了图形客户端，界面极简、耗电低、支持 VLESS、Hysteria2、AnyTLS 等新协议。它和其他客户端最大的不同是：官方客户端只认 sing-box 自己的 JSON 配置，不能直接导入 Clash 订阅或通用订阅。

所以使用 sing-box 的第一步不是下载，而是确认机场是否提供 sing-box 格式的订阅。确认之后，整个流程是：下载客户端 → 新建远程配置并粘贴订阅 → 启动 → 在分组里选节点。如果机场只提供 Clash 订阅，建议直接看安卓手机用什么代理客户端选择 Clash 系客户端，不要勉强使用。

官方客户端的按钮名称在不同版本中有所差异，中文界面与英文界面的叫法也不同，下文括号内给出常见的英文名称，均以实际版本为准。

准备工作

准备项	Android	iOS / iPadOS
获取渠道	SagerNet/sing-box 的 GitHub Releases（也可在 Google Play 获取）	App Store，需要非中国大陆地区 Apple ID
系统要求	以 Releases 说明为准，老旧系统可能需要 legacy 版本	以 App Store 页面标注为准
订阅	机场后台的 sing-box 订阅链接	同左
其他	允许“安装未知应用”	首次启动需允许添加 VPN 配置

iOS 下载涉及 Apple ID 地区问题，具体注意事项可以参考 Shadowrocket 下载与 Apple ID 注意事项，道理相通。订阅链接的格式区别见订阅链接是什么。

Android 如何选择 APK

在 Releases 页面中，Android 客户端的安装包通常以 SFA 开头，按架构区分：

文件名特征	适用设备
arm64-v8a	近几年的绝大多数手机和平板
armeabi-v7a	较老的 32 位设备
universal	不确定架构时使用，兼容所有架构
legacy 相关字样	系统版本较老的设备，是否提供以实际版本为准

查看手机架构的方法：在手机“设置 → 关于手机”中查看处理器信息；或者连接电脑，用 adb 读取：

# Windows PowerShell（已安装 Android 平台工具）
adb shell getprop ro.product.cpu.abi

# macOS / Linux
adb shell getprop ro.product.cpu.abi

输出 arm64-v8a 就下载对应的 APK。拿不准时直接选 universal。

分步操作

第一步：安装客户端

1. Android：在 GitHub 打开 SagerNet/sing-box 项目，进入 Releases，找到最新正式版本（不要选 Pre-release），下载对应架构的 APK，打开后按提示允许浏览器“安装未知应用”并完成安装；
2. iOS：用非中国大陆地区的 Apple ID 登录 App Store，搜索 sing-box，核对开发者信息与项目文档一致后安装。

第二步：新建远程配置并导入订阅

1. 在机场后台复制 sing-box 订阅 链接；
2. 打开 sing-box，进入底部的 配置（Profiles） 页面；
3. 点击 新建配置（New Profile），名称随意填写；
4. 类型选择 远程（Remote），在 URL 栏粘贴订阅链接；
5. 打开 自动更新（Auto Update），间隔可设为数小时到一天；
6. 点击 创建（Create），客户端会下载并校验配置。

创建成功后，配置列表里会出现这条配置。如果提示解析错误，多半是复制成了 Clash 或通用订阅，回到机场后台重新复制 sing-box 格式的链接。

第三步：启动

1. 回到 仪表盘（Dashboard） 页面，确认当前选中的就是刚才创建的配置；
2. 点击 启动（Start）；
3. Android 首次会弹出“连接请求”，允许 sing-box 建立 VPN 连接；iOS 首次会提示添加 VPN 配置，需要输入锁屏密码或验证面容确认。

启动后状态栏会出现钥匙或 VPN 图标。sing-box 在手机上是通过系统 VPN 接口接管流量的，效果相当于桌面端的 TUN 模式，所有 App 默认都会经过它，再由配置里的路由规则决定直连还是代理。

第四步：选择节点

进入 分组（Groups） 页面，可以看到订阅配置中的选择器分组，比如“节点选择”“自动选择”等：

1. 点开手动选择类的分组；
2. 点击测速图标检测延迟；
3. 选择一个延迟较低、显示正常的节点。

分组页能否显示、能否切换，取决于机场下发的配置是否包含相应的分组设置。配置文件本身的结构见 sing-box 配置文件结构详解。

第五步：更新配置与升级客户端

机场维护节点或更换入口后，需要更新配置：在“配置”页面点开对应的远程配置，手动点击更新即可；开启了自动更新的话，客户端会按设定的间隔自动拉取。客户端本身的升级方式是：Android 从 Releases 下载新版 APK 直接覆盖安装，已有配置会保留；iOS 通过 App Store 更新。升级大版本后如果配置报错，先更新一次订阅，让机场下发适配新版本的配置。

验证是否成功

1. 用手机浏览器打开 https://chatgpt.com/cdn-cgi/trace，页面中的 loc= 应与所选节点地区一致；
2. 再打开一个常用的国内 App 或网站，速度正常说明国内直连规则生效；
3. 回到 sing-box 仪表盘，查看实时流量是否在变化。

如果 loc= 显示本地地区，说明请求没有走代理：检查是否选对了分组节点、配置是否包含正确的路由规则。

常见错误

问题现象	可能原因	解决方法
创建配置时报解析错误	导入了 Clash 或通用订阅	改用机场的 sing-box 订阅
报错提示未知字段、字段已弃用	配置与客户端版本不匹配	升级客户端到最新正式版，联系机场确认适配版本
启动后立刻断开	另一个 VPN 应用占用了连接	关闭其他 VPN，检查“始终开启的 VPN”设置
连上了但网页打不开	节点不可用或 DNS 异常	换节点测试；Android 把“私人 DNS”改为关闭或自动
后台一段时间后断连	系统省电策略杀掉后台	在电池设置中把 sing-box 设为不受限制
iOS 上偶发自动断开	规则集过大导致扩展内存不足	联系机场精简规则，或使用规则更少的配置
订阅更新失败	订阅地址当前无法访问	先保持连接再更新，或参考订阅更新失败排查

订阅更新类问题可以参考订阅更新失败怎么办。

注意事项

• 只装官方渠道的版本：代理客户端能看到你的全部流量，不要安装来路不明的修改版 APK。
• 不要随手用在线订阅转换：把订阅链接交给第三方转换，等于把账号凭证交给了别人，优先使用机场原生提供的 sing-box 订阅。
• 一次只开一个代理应用：手机上同时装多个客户端没问题，但同时只能有一个处于连接状态。
• 截图时遮住订阅地址：配置页和日志中都可能包含订阅链接或节点地址。

请在遵守当地法律法规与服务条款的前提下使用 sing-box 等网络工具。