sing-box使用教程：各平台安装与导入远程配置

读前说明

这篇是动手教程，默认你已经知道 sing-box 是什么、和 V2Ray / Clash 有何不同。如果还没了解过，建议先读 Sing-box 是什么，再回来跟着操作。

准备好以下几样东西：

• 机场提供的 sing-box 格式订阅链接（面板里通常和 Clash、通用格式并列在「一键订阅」下）；
• 需要安装客户端的设备；
• iPhone / Mac 用户还需要一个非中国大陆区的 Apple ID。

第一步：按平台安装官方客户端

平台	官方客户端	获取渠道
Android	sing-box for Android（SFA）	Google Play、F-Droid、GitHub Releases
iOS / iPadOS	sing-box for Apple platforms（SFI）	App Store（需非国区 Apple ID）
macOS	sing-box for Apple platforms（SFM）	App Store、Homebrew、GitHub Releases
Windows / Linux	sing-box for Desktop	见官网 Clients 页面

1. Android

   能用 Google Play 的直接搜索安装；没有 Play 商店的手机可以从 sing-box 官方仓库的 GitHub Releases 下载 APK，或通过 F-Droid 安装。官方要求 Android 5.0 及以上。

2. iPhone / iPad

   在 App Store 切换到外区账号后搜索 sing-box 安装，官方要求 iOS 15.0 及以上。切换账号的方法可参考 Shadowrocket 教程的购买部分。

3. Mac

   可以从 App Store 安装，也可以用 Homebrew 执行 brew install sfm，或从 GitHub Releases 下载独立版本。官方要求 macOS 13.0 及以上。

4. Windows / Linux

   官方桌面客户端的下载方式与当前状态以 sing-box 官网的 Clients 页面为准，请只从官网链接的项目页面下载。桌面端也可以直接运行 sing-box 命令行程序加载同一份配置，适合熟悉终端的用户。

第二步：导入远程配置

1. 复制 sing-box 订阅

   在机场面板中选择 sing-box 格式并复制链接。注意不要拿 Clash 或通用格式的链接来导入。

2. 新建 Profile

   打开客户端，进入 Profiles（配置）页面，点击「+」新建。类型选择 Remote，名称随意填写（例如机场名），URL 一栏粘贴订阅链接。

3. 设置自动更新

   新建页面里通常可以打开自动更新并设置更新间隔，建议开启，这样机场调整节点或升级配置模板后你能及时同步。具体选项以实际版本界面为准。

4. 保存并检查

   保存后客户端会立即下载配置。如果提示下载失败，先在浏览器里打开该链接确认能访问。

第三步：启动并选择节点

1. 选中配置并启动

   回到首页（Dashboard），确认当前选中的是刚导入的 Profile，点击启动按钮。

2. 允许 VPN 权限

   手机上第一次启动会请求添加 VPN 配置，这是 sing-box 用来接管流量的 TUN 机制，允许即可。桌面端如果配置里包含 tun 入站，可能需要管理员权限。

3. 在 Groups 中切换节点

   进入 Groups 页面，可以看到机场配置里定义的代理组，点进去选择节点或使用自动测速组。

4. 验证连接

   打开浏览器访问一个海外网站确认能正常加载。晚高峰拥堵时，可以优先试试 Hysteria2 等基于 UDP 的节点。

常见问题：配置版本不兼容

这是 sing-box 用户最容易遇到、也最让人困惑的问题。sing-box 迭代很快，配置格式会在新版本中调整：旧写法先被标记为弃用（deprecated），过几个版本后正式删除。官方迁移文档里列出过不少例子：

• 1.10 起，TUN 入站中分开的 IPv4 / IPv6 地址字段合并为 address；
• 1.11 起，block、dns 这类特殊出站改由路由规则动作（如 reject、hijack-dns）实现；
• 1.12 起，旧式 DNS 服务器写法被带 type 字段的新格式取代。

其他常见问题

下一步

跑通一台设备后，其他设备照着同样的方式导入同一个订阅链接，就能实现多端统一配置。安卓用户如果还在纠结用哪个客户端，可以看安卓代理客户端怎么选；想换一家支持 sing-box 订阅和新协议的机场，可以参考机场推荐。