sing-box 订阅怎么添加？Android、iOS、macOS、Windows 步骤
简答：sing-box 订阅添加的关键是使用能返回 sing-box JSON 配置的远程链接，而不是直接粘贴 Clash YAML。先在服务商面板复制 sing-box 或 JSON 订阅，再按设备进入 Remote 配置入口，保存后刷新、选择节点并启动 VPN 或系统代理。
定义：sing-box 订阅是一个指向远程配置文件的 URL，客户端通过该地址下载并定期更新 JSON 格式的 sing-box 配置。
先试这一步：确认订阅格式和客户端
本文是第三方使用指南，不代表 sing-box 或任何订阅服务商官方。本文按 2026-10-20 已核对的公开资料整理；客户端按钮名称可能随版本变化，下载入口和版本信息应以对应项目的公开页面为准。
sing-box 官方配置格式是 JSON。远程配置属于 Remote Profile，客户端应通过 URL 下载配置，并支持自动更新；官方通用说明给出的默认自动更新间隔是 60 分钟。查看 sing-box 配置格式说明 查看 Remote Profile 说明
| 你手里的链接或文件 | 能否直接添加为 sing-box Remote | 处理方式 |
|---|---|---|
| sing-box、JSON、SFA/SFI/SFM 专用订阅 | 通常可以 | 优先复制这类链接，在客户端的 Remote 或远程配置入口添加。 |
| 完整 sing-box JSON 文件 | 可以 | 保存为本地 JSON 文件，再使用 Local、本地配置或导入文件入口。 |
| Clash YAML 订阅 | 不能直接当作 sing-box JSON 配置使用 | 先向服务商确认是否提供 sing-box 专用链接；需要转换时，应使用可信且明确支持目标格式的工具。 |
| 只包含单个节点的分享链接 | 不一定 | 它可能不是完整配置，不能假定能直接作为 Remote Profile 使用。 |
如果你使用 X-Air，可登录自己的服务面板，在订阅或配置区域查找 sing-box、JSON 或远程配置链接；具体菜单名称和可用格式目前未核实，应以面板实际显示和服务商说明为准。不要把订阅 URL、token 或包含完整链接的截图公开，因为这类链接可能包含访问凭据。
Android：Profiles → New Profile → Remote
- 安装官方 sing-box for Android，简称 SFA。官方页面说明 SFA 可以管理并运行本地或远程 sing-box 配置，系统要求为 Android 5.0+。查看 Android 客户端说明
- 打开 SFA，进入 Profiles 或“配置”页面，点击 +、New Profile 或同义的新建配置按钮。
- 选择 Remote，填写一个便于识别的名称，例如“工作线路”，在 URL 栏粘贴服务商提供的 sing-box 或 JSON 订阅链接。
- 点击保存或确认。回到配置列表，点开该配置的更多操作，选择 Update、Refresh 或“更新”。第一次更新成功后，应能看到配置内容或节点组。
- 选中该配置，点击启动按钮。Android 首次启动 TUN 时会弹出 VPN 权限确认，阅读系统提示后允许；SFA 官方说明其 TUN 功能通过 Android VpnService 实现。查看 SFA 功能和 VpnService 说明
- 进入 Dashboard 或节点组，选择一个节点；如果配置包含 Selector 或 URLTest 分组，客户端可在图形界面中进行选择或测试，具体显示取决于订阅配置。
Android 验证方法：先看配置是否完成更新，再确认 VPN 图标或客户端运行状态出现，最后用浏览器访问一个普通网页。若只有节点列表却无法联网，先停止 SFA，再重新更新配置并重新授权 VPN，不要马上修改 DNS。
iOS：在 SFI 中添加 Remote 配置
- 安装官方 sing-box for Apple platforms 中的 iOS 客户端 SFI。官方页面列出的 iOS 要求是 iOS 15.0+；可用下载渠道和账号要求应以官方页面当前说明为准。查看 Apple 平台客户端说明
- 打开 SFI，进入 Profiles 或“配置”页面，点击右上角 +，选择 Remote。
- 在名称栏输入配置名称，在 URL 栏粘贴 sing-box 或 JSON 远程订阅地址，然后点击 Save、Add 或同义的保存按钮。
- 点开刚添加的配置，执行 Update 或“更新”。如果更新成功，配置详情中应出现可查看的配置内容或节点组。
- 返回配置列表，选中该配置并启动服务。iOS 首次启动 NetworkExtension 时会出现系统 VPN 添加或允许提示，按系统提示完成授权；官方说明 SFI 通过 NetworkExtension 提供 TUN 功能。查看 Apple 客户端功能说明
- 启动后打开节点组或 Dashboard，选择节点；若订阅没有 Selector、URLTest 等出站组，客户端可能只显示单一出站或不提供节点切换列表。
如果 SFI 中没有看到 Remote，先确认添加的是官方 Apple 客户端而不是命令行内核，也检查应用是否为当前版本。官方文档定义了 Remote Profile 和自动更新能力，但没有承诺所有版本使用完全相同的按钮文字，因此以当前界面为准。
macOS：区分 SFM 独立版与其他安装方式
- 先确认你使用的是 macOS 客户端 SFM。官方页面列出 macOS 13.0+ 要求，并提供 App Store、独立版等不同渠道；独立版可通过 Homebrew Cask 或 GitHub Releases 获取，下载入口以官方页面为准。查看 macOS 客户端下载说明
- 打开 SFM，进入 Profiles 或“配置”，点击 +，选择 Remote，填写名称和远程订阅 URL。
- 保存后选中该配置，点击 Update 或“更新”。确认配置内容能正常加载，再点击启动服务。
- 首次启动时，如果 macOS 要求允许 Network Extension、VPN 或系统扩展，打开系统设置中的网络或隐私与安全相关页面，按照系统弹窗完成允许。不同 macOS 版本的系统设置名称可能不同。
- 启动成功后，打开节点组或 Dashboard 选择节点，再用浏览器访问网页验证。
macOS 独立版迁移时不要默认认为旧配置会自动继承。sing-box 官方迁移说明指出，1.14.0 相关 Apple 平台开发者账号迁移后，新的 macOS 独立版应用不会自动继承旧应用的配置和设置；如果你正从旧版本迁移，应先阅读官方迁移说明，再决定是否重新添加 Remote 配置。查看官方迁移说明
Windows 和 Linux：优先区分官方 Desktop 与第三方 GUI
官方客户端列表目前将 Windows 和 Linux 列为 sing-box for Desktop，因此不能把第三方 GUI.for.SingBox 当成官方桌面客户端。查看官方图形客户端列表
方案 A：官方 sing-box for Desktop
- 从 sing-box 官方发布渠道获取对应系统版本；版本号和安装包以发布页为准。
- 打开 Desktop 客户端，寻找配置、Profiles、Remote 或远程配置相关入口。
- 添加名称和订阅 URL，保存后执行更新，再选中配置启动。
- 如果当前版本没有明显的 Remote 按钮，不要把 Clash YAML 强行粘贴进去；先确认订阅返回的是 sing-box JSON，并查看该版本随附的界面说明或发布页。
官方资料确认 Desktop 覆盖 Windows 和 Linux，也确认图形客户端支持本地或远程配置概念，但当前公开文档没有提供统一、稳定的 Windows/Linux 菜单截图路径。因此，为避免把其他客户端的按钮名称套用到官方 Desktop，下面给出一个有公开 Quick Start 路径的第三方方案。
方案 B：第三方 GUI.for.SingBox
- GUI.for.SingBox 是独立的第三方图形客户端，不等同于 sing-box 官方 Desktop。其项目文档提供 Windows、macOS 和 Ubuntu 等构建说明，下载时应优先使用项目 GitHub Releases。查看 GUI.for.SingBox 项目仓库 查看 GUI.for.Cores 使用手册
- 安装并打开 GUI.for.SingBox，进入 Overview 页面，点击 Quick Start。
- 填写配置名称，粘贴 sing-box 或 JSON 订阅 URL，点击 Save。
- 导入成功后点击 Start Core 或同义的启动按钮，再进入节点选择或控制页面选择节点。
- 如果需要让浏览器或其他遵循系统代理的程序使用连接，再打开 System Proxy；关闭客户端或停止使用时，检查系统代理是否已经关闭。
Linux 用户如果使用命令行内核而不是图形客户端，订阅 URL 不能自动变成配置文件。需要先下载内容保存为 JSON，然后使用 sing-box check 检查配置；官方文档还提供了 sing-box format 和 sing-box merge 等配置处理命令。查看配置检查和处理命令
导入后怎么更新、选节点和验证连接
- 先更新：在配置列表打开刚添加的 Remote Profile，点击 Update、Refresh 或“更新”。如果客户端有自动更新间隔设置，可先保留默认值；官方通用说明给出的 Remote Profile 默认更新间隔为 60 分钟。
- 再选节点：进入 Dashboard、Groups、Proxy Groups 或节点组。如果订阅只返回一个出站，没有 Selector 或 URLTest 组，就不会出现常见的多节点切换界面。
- 再启动：Android/iOS/macOS 通常需要系统 VPN 或 Network Extension 授权；Windows 的第三方 GUI 可能还需要单独开启 System Proxy。不要把“配置已选中”误认为“流量已经接管”。
- 最后验证：先访问普通网页，再测试实际要使用的应用。若浏览器可用但某个应用不可用，优先检查该应用是否使用系统代理、是否被配置中的分流规则排除。
| 现象 | 优先检查 | 处理顺序 |
|---|---|---|
| 更新失败或 URL 无法下载 | 链接是否复制完整、是否过期、当前网络能否打开该 URL | 重新复制链接；不要公开粘贴 token；再手动 Update。 |
| 格式解析错误 | 返回内容是不是 JSON，是否误用了 Clash YAML 或网页登录页 | 让服务商提供 sing-box 专用链接；用本地 JSON 做格式检查。 |
| 没有节点或节点组为空 | 配置是否下载完整，订阅是否包含 outbounds 或分组 | 重新更新；查看配置内容；联系服务商确认链接格式。 |
| 启动后无法联网 | VPN/TUN 权限、系统代理、节点选择和 DNS | 停止服务后重新授权；换一个节点；确认应用是否走系统代理；再检查 DNS 和分流。 |
如果你需要先核验订阅来源和链接是否完整，可参考站内的订阅来源核验与链接筛选方法，不要直接使用搜索结果中的未知下载包或他人公开的订阅 URL。
常见问题
sing-box 订阅怎么添加最简单？
最短路径是：服务商面板复制 sing-box 或 JSON 订阅 URL，客户端进入 Profiles 或配置页面，选择 Remote，粘贴 URL，保存并 Update，随后选中配置、授权 VPN 或启动系统代理。
Clash 订阅能直接导入 sing-box 吗？
通常不能直接当作 sing-box 配置使用，因为 sing-box 官方配置格式是 JSON。先确认服务商是否提供 sing-box 专用链接；如果只有 Clash YAML，应使用明确支持目标格式的转换方案，并检查转换后的 JSON 是否能通过 sing-box 配置校验。
添加订阅后为什么没有节点？
常见原因是链接返回了登录页、链接已失效、配置下载不完整，或者订阅本身没有包含 outbounds、Selector 或 URLTest 分组。先手动更新并查看配置内容，再确认服务商提供的格式是否与客户端匹配。
配置已经添加，为什么启动后还是不能联网？
检查顺序应是：是否完成 Android VPN、iOS Network Extension 或 macOS 网络扩展授权；是否真正启动了服务；是否选择了可用节点；Windows 第三方 GUI 是否打开了 System Proxy；最后再排查 DNS 和分流规则。
Windows 应该用官方 Desktop 还是 GUI.for.SingBox？
官方客户端列表包含 sing-box for Desktop，GUI.for.SingBox 则是独立的第三方图形客户端。若你需要公开文档中明确的 Quick Start 导入路径，可以按 GUI.for.SingBox 的 Overview → Quick Start 操作；若使用官方 Desktop，应以当前版本界面和发布说明为准。
订阅链接可以发给别人帮忙测试吗？
不建议。订阅 URL 可能包含账号标识或 token。请不要把完整 URL、二维码、配置文件或带有订阅参数的截图公开；如果怀疑已经泄露，应按服务商面板提供的方式轮换或重置链接，具体入口未核实。
常见问题
sing-box 订阅怎么添加最简单？
在服务商面板复制 sing-box 或 JSON 订阅 URL，打开客户端的 Profiles 或配置页面，选择 Remote，粘贴 URL，保存并 Update，然后选中配置、授权 VPN 或启动系统代理。
Clash 订阅能直接导入 sing-box 吗？
通常不能直接使用。sing-box 官方配置格式是 JSON，Clash YAML 需要先确认服务商是否提供 sing-box 专用链接，或使用可信的格式转换方案后再检查 JSON。
添加订阅后为什么没有节点？
可能是链接返回登录页、链接失效、配置下载不完整，或者订阅没有包含 outbounds、Selector 或 URLTest 分组。先手动更新并确认返回内容和格式。
配置已经添加，为什么启动后还是不能联网？
依次检查 VPN 或 Network Extension 权限、服务是否真正启动、节点是否选中、Windows 是否启用 System Proxy，以及 DNS 和分流规则。
Windows 应该用官方 Desktop 还是 GUI.for.SingBox？
官方列表中的 sing-box for Desktop 与 GUI.for.SingBox 不是同一个项目。需要明确 Quick Start 路径时，可按第三方 GUI.for.SingBox 的 Overview → Quick Start 操作；官方 Desktop 以当前版本界面为准。