sing-box 官方客户端怎么用？导入配置与订阅的基本做法
梯子岛编辑部 · 更新于 官方客户端按设备分为安卓版、苹果版和桌面版。装好后把配置以本地文件、云盘文件或远程地址的方式导入，再启用并核对出口即可。苹果版需要非中国大陆区的 Apple 账户。
sing-boxv1.14.3
- 类型
- 代理内核
- 内核
- sing-box
- 支持系统
- Windows、macOS、Linux、安卓、iPhone / iPad、路由器
- 最新版本发布于
- 2026-10-09（核验时已发布 0 天）
- 版本核验时间
- 2026-10-09 09:07 UTC（来源：GitHub 官方接口）
- 官方地址
- github.com/SagerNet/sing-box/releases
sing-box 官方客户端的上手顺序是：先按设备找到对应的官方应用，再把配置导进去，最后启用并核对出口。sing-box 客户端使用的难点不在操作，而在“这个缩写到底是哪个应用”和“配置从哪来”。下面先把名字对上号，再分设备讲导入，最后给一套验证方法。
SFA、SFI、SFM、SFT：几个缩写各指哪个应用
官方的图形客户端是按设备拆开的几个应用，搜索时常见的缩写如下：
| 缩写 | 设备 | 官方仓库归属 |
|---|---|---|
| SFA | 安卓手机、平板 | sing-box for Android 仓库 |
| SFI | iPhone、iPad | sing-box for Apple 仓库 |
| SFM | Mac | sing-box for Apple 仓库 |
| SFT | Apple TV | sing-box for Apple 仓库 |
| 桌面版 | Windows、Linux | sing-box for Desktop 仓库 |
所以，当有人说 sfa sfi 时，指的是安卓和苹果手机上的两个应用，它们并不是同一个程序。还有一点要分清：内核本身是命令行程序，iPhone 上没有单独的内核可以装，只能用图形应用 SFI。
内核与客户端的关系、各平台入口汇总在 sing-box 客户端档案，不想翻档案的话，直接看下面按设备走的路径。
安卓：sing-box for android 去哪里装
官方文档列出的获取渠道有四种：应用商店、商店里的测试版、GitHub 发布页，以及 F-Droid。对大多数人来说，选“自己最熟悉、能持续收到更新”的那一种即可，原则是只认官方仓库或官方文档链出去的入口。
- 想直接拿安装包：去 sing-box for Android 官方仓库的发布页，也可以从GitHub 项目导航进入；
- 想自动更新：优先用商店或 F-Droid 渠道，更新由渠道负责；
- 系统要求以文档为准，较旧的安卓版本可能装不上。
不管选哪种，安装完成后都要在系统弹窗里允许创建 VPN 连接，这是客户端接管流量的必要授权。安卓整体的客户端选择思路，可以对照安卓翻墙客户端指南。
苹果设备：sing-box ios 版的特殊之处
苹果版有三点和别的平台不同，先看清再动手：
- 账户地区：官方说明需要非中国大陆区的 Apple 账户才能下载。账户地区怎么改、会有什么影响，请读 Apple 官方支持页。梯子岛不提供，也不引导任何共享账号。
- 渠道：商店版覆盖 iPhone 与 Apple TV；测试版的名额只给赞助者；越狱设备另有安装包，在发布页；Mac 的独立版可以走包管理器或发布页，文档没有提到 Mac 的应用商店。
- 功能差异：虚拟网卡由系统扩展提供，部分选项没有实现。
商店里的上架名称可能与你想的不一样，官方链接指向的那一个才是对的。iPhone 上翻墙的整体取舍见 iPhone 翻墙指南，那里也比较了其他 iOS 客户端。
配置从哪来：三种导入方式怎么选
官方客户端接受的配置载体，资料里写明的有三类：
| 方式 | 适合谁 | 注意 |
|---|---|---|
| 本地文件 | 自己手写或转换过配置的人 | 文件改了要重新导入 |
| 云盘文件（苹果设备） | 在多台设备间共用同一份配置 | 依赖云盘同步是否及时 |
| 以网址为更新源的远程配置 | 服务方提供了可更新的配置地址 | 地址等同于凭证，别发给别人 |
要留意：这里说的是 sing-box 自己格式的配置。如果你拿到的订阅链接返回的是别的格式，客户端未必认。可以先用订阅内容解码工具在浏览器里看一眼返回内容的样子，再决定要不要转换；需要转的话用节点转换工具出草稿。订阅这个概念本身，见订阅是什么。
sing-box 客户端使用的具体步骤：导入并启用
以下步骤在三个平台上大同小异，做完这一轮，sing-box 客户端使用的主线就走通了，界面名词以你装到的版本为准：
- 打开应用，找到管理配置的入口，选择新建；
- 起一个自己认得的名字，再选择来源是本地、云盘还是远程地址；
- 远程地址的话，填入地址并保存，等待它拉取完成；
- 回到主界面，选中刚建好的这份配置；
- 点击启动，系统弹出授权时选择允许；
- 状态显示已连接后，再去做下一节的验证。
如果保存时就报错，多半是配置本身有问题，而不是客户端坏了。这时候读一读sing-box 配置入门，先分清日志、入站、出站、路由几块。
连上以后怎么确认真的生效
“显示已连接”不等于流量走对了，建议做三项检查：
- 看出口：打开IP 与 DNS 检测导航里的检测站，对比开启前后地址是否变化；
- 看分流：访问一个你预期直连的站点和一个预期走代理的站点，确认各走各路；
- 看日志：客户端里一般有日志页，报错、被弃用字段的提示都在这里。
任何一项不符合预期，就回到配置：是不是节点过期、规则写反，还是平台不支持某个选项。排障思路可参考连不上排查。
下一步怎么走
- 还没选好应用：先读 sing-box 客户端档案，确认你的设备对应哪个版本；
- 只想要“导入就能用”，或想比较其他客户端的使用门槛：看 Hiddify 与 Karing 对比，对比另外两款基于同一内核的客户端；
- 想自己调配置：读 sing-box 配置入门；
- 下载官方包：统一从 GitHub 项目导航进入。
这篇没有覆盖的
- 界面文字与菜单位置会随版本调整，本文只描述每一步要完成什么，具体按钮以你装到的版本为准。
- 鸿蒙设备上的支持情况资料待核实，本文没有涉及。
- 配置文件的字段含义见另一篇结构讲解，这里不展开，也没有任何线路速度数据。
本文引用的官方来源
- sing-box 官方文档（sing-box.sagernet.org）
- sing-box for Android（SFA）（github.com）
- sing-box for Apple（SFI/SFM）（github.com）
- Apple 支持：更改 Apple 账户的国家或地区（support.apple.com）
以上链接均为官方页面，梯子岛在 2026-10-09 核对过；个别网站会拦截自动化访问，用浏览器直接打开即可。平台规则可能随时调整，以官方页面当前内容为准。
sing-box 客户端使用常见问题
SFA、SFI、SFM、SFT 分别是什么？
它们都是官方图形客户端的简称，对应不同设备。SFA 是安卓版，SFI 是 iPhone 与 iPad 版，SFM 是 Mac 版，SFT 是 Apple TV 版。名字不同，但管理配置、启停连接的思路是相通的。
sing-box ios 版在国内商店搜不到，是下架了吗？
按官方说明，苹果版需要使用非中国大陆区的 Apple 账户才能下载，所以在大陆区商店里搜不到是预期情况。账户地区的修改规则请看 Apple 官方支持页，梯子岛不提供也不引导任何共享账号。
安卓上从哪里装 sing-box for android？
官方列出的渠道有应用商店、商店测试版、GitHub 发布页和 F-Droid。其中 GitHub 发布页和仓库都在官方组织名下，入口可以从梯子岛的 GitHub 项目导航进去。不要从来路不明的网盘或论坛附件取安装包。
导入之后连接不上，先查什么？
先确认导入的是完整可用的配置，而不是只含部分字段的片段；再看日志里是否有字段报错；最后确认你的节点本身没有过期。配置结构的读法见梯子岛的 sing-box 配置入门。
电脑上有官方图形客户端吗？
有。官方文档列出了面向 Windows 和 Linux 的桌面客户端，通过 GitHub 发布页获取；Mac 则使用苹果版的独立安装方式。该桌面仓库的自述文字与文档页写法不完全一致，请以文档页和发布资产为准。
苹果版的 TUN 和桌面版一样吗？
不一样。苹果设备上的虚拟网卡由系统的网络扩展提供，auto_route、stack 等选项在那里没有实现，按进程分流也只在个别版本可用。照搬电脑上的配置时，要留意这些选项会被忽略。
接着读
- 客户端 · sing-box 是什么？内核、官方客户端与各平台入口
- 教程 · sing-box 配置文件入门：JSON 结构与最小可用配置
- 平台 · 苹果梯子怎么选？iPhone 客户端、Apple ID 地区与获取方式
- 平台 · 安卓梯子怎么选？安卓客户端、安装来源与分应用代理
- 教程 · Hiddify 使用教程：导入订阅与连接
- 教程 · Hysteria2 客户端配置：导入节点与常见填写项