sing-box 怎么导入订阅配置？远程配置导入与连接验证步骤
简答：如果你拿到的是 sing-box JSON 远程配置，最快方法是在客户端新建 Remote Profile，粘贴订阅 URL，保存后更新配置，再在 Dashboard 启动服务并选择节点组。若导入失败，先检查返回内容是不是 JSON；Clash YAML、纯 Base64 或单节点链接不能直接当作 sing-box 配置使用。本文按平台给出可照做的路径，菜单名称以当前客户端页面为准。
定义：sing-box 订阅导入，是把可访问的 sing-box JSON 配置 URL 添加为 Remote Profile，随后由客户端拉取、更新并运行该配置。
先试这一步：确认订阅格式，再选择导入方式
本站是第三方使用指南站，不是 sing-box 官方站。根据 sing-box 当前配置文档，配置文件使用 JSON，并包含 inbounds、outbounds、route 等结构；官方还提供 sing-box check 用于检查配置。先不要把任何链接直接粘贴到公开解析器、群聊或截图中，订阅 URL 往往包含访问凭据。
| 你拿到的内容 | 能否直接按 Remote 导入 | 下一步 |
|---|---|---|
| 返回 sing-box JSON 的 HTTPS URL | 可以尝试 | 新建 Remote Profile，粘贴 URL，保存并更新。 |
Clash YAML，常见为 proxies、proxy-groups、rules | 不能直接当作 sing-box JSON | 向配置提供方索取 sing-box 格式，或使用明确支持的转换流程后再检查。 |
| 纯 Base64 文本 | 不能直接判断 | 先确认它实际解码后是 sing-box JSON、其他客户端格式还是单节点列表。 |
| 单节点链接 | 通常不是完整订阅配置 | 需要客户端支持对应节点链接，或手动生成完整 sing-box 配置。 |
最小判断方法是：在浏览器或命令行请求订阅 URL，查看返回正文的开头是否为 JSON 对象。不要只看文件扩展名；有些地址没有 .json 后缀，但返回内容仍可能是 JSON。若返回登录页、验证码页、HTML 错误页或空内容，问题优先属于链接、认证或网络拉取，而不是客户端菜单。
官方文档将 Remote Profile 定义为以 URL 为更新来源的远程 sing-box 配置，并要求图形客户端支持自动更新和 HTTP Basic Authorization；默认自动更新间隔在统一客户端说明中写为 60 分钟，具体界面和实际策略以当前客户端为准。参见 sing-box 图形客户端 Profile 说明 与 sing-box 配置结构与检查命令。
Android：用 sing-box for Android 添加 Remote Profile
- 先备份已有配置，打开 sing-box for Android。官方资料将它简称为 SFA，并说明它可以管理、运行本地或远程 sing-box 配置；当前官方资料列出的系统要求为 Android 5.0 及以上。
- 进入配置或 Profile 管理页面，选择新增远程配置。不同版本可能使用
Remote、远程配置或相近名称，识别关键词是 URL、Profile、Remote。 - 填写一个便于识别的名称，将完整订阅 URL 粘贴到 URL 字段。若服务端要求 HTTP Basic Auth，按提供方给出的用户名和密码填写，不要把密码写进公开示例。
- 保存后手动执行更新或刷新。先观察配置内容能否被读取，再处理启动问题；如果更新时显示 HTML、401、403 或证书错误，不要反复点击启动。
- 回到 Dashboard，启动服务并按 Android 系统提示授权 VPN。若配置包含 Selector 或 URLTest 等分组，启动后在 Groups 位置选择或查看当前组；官方统一客户端说明指出，图形客户端可在配置包含这些组出站时提供组选择。
- 打开一个普通网页或应用进行复测，再回到 Dashboard 查看连接、流量或状态变化。只以“网页能打开”作为初步结果，不要据此断定所有节点都可用。
官方客户端列表将 Android、Apple platforms 和 Desktop 分开维护，Android 对应 sing-box for Android。下载渠道、系统要求和客户端功能可能变化，发布前请以 sing-box for Android 官方页面为准。
iOS、macOS、Windows、Linux：导入路径怎么区分
| 平台 | 优先选择 | 导入与启动要点 |
|---|---|---|
| iOS | Apple platforms 图形客户端 | 新建 Remote Profile，粘贴 URL，保存并刷新；启动时按系统提示添加或启用 VPN 配置。具体按钮名称以当前版本页面为准。 |
| macOS | Apple platforms 图形客户端 | 可使用 Remote Profile；如果使用 iCloud Profile，则它属于以 iCloud 为更新来源的配置类型。首次启动前先确认配置已成功读取，再处理系统网络扩展或权限提示。 |
| Windows | sing-box for Desktop | 在配置管理中添加 Remote Profile，更新后从 Dashboard 启动。若需要 TUN，按客户端提示安装或启用其网络组件，并确认系统权限；不要把 Android 的 VPN 授权步骤套用到 Windows。 |
| Linux | sing-box for Desktop 或命令行核心 | 图形客户端按 Remote Profile 操作；命令行则先保存为 JSON 文件，再用 sing-box check 检查，确认无误后再启动。命令行不会自动替你完成图形客户端的订阅更新和节点选择。 |
官方图形客户端页面明确列出：Android 使用 sing-box for Android，iOS、macOS 和 Apple tvOS 使用 Apple platforms 客户端，Windows 与 Linux 使用 Desktop 客户端。它们不是同一个界面，不能把某个平台的菜单路径当作所有平台的固定步骤。参考 官方图形客户端列表。
对于本地 JSON 配置，先保存副本，再使用官方给出的检查命令：
sing-box check -c config.json如果检查通过，再根据你的运行方式启动。不要在没有实际运行环境、权限和配置文件路径的情况下复制一条未经核验的启动命令；Windows、macOS、Linux 的安装方式、服务管理器和文件路径可能不同。官方配置文档同时列出格式化命令 sing-box format，适合在修改后统一缩进，但格式化不能修复缺少字段或错误出站。
Remote、Local、手动 JSON：什么时候用哪一种
- Remote Profile：适合配置由远程 URL 提供、需要定期更新的场景。首次导入和每次更新都依赖 URL 可访问、返回内容正确，并可能依赖认证信息。
- Local Profile：适合你已经拥有完整 JSON，或者需要自己编辑规则、DNS、路由和出站的场景。修改前先复制备份，遇到启动失败时可快速回滚。
- 手动 JSON：适合只有节点参数、没有完整订阅配置，或需要自己组合入站、出站和路由的场景。它不是把单节点链接粘贴到 Remote URL，而是先形成符合 sing-box 结构的 JSON，再用检查命令验证。
官方统一客户端说明还支持通过特定 URL Scheme 导入远程 Profile，格式为 sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName。这类链接必须经过 URL 编码，且应只在可信来源和本机使用；如果页面没有提供该入口，直接在客户端手动新建 Remote Profile 通常更容易核对内容。
推荐的最短流程：备份旧配置 → 判断返回格式 → 新建 Remote → 粘贴 URL → 手动刷新 → 查看配置内容 → 启动服务 → 授权 VPN 或网络组件 → 选择分组 → 打开网页复测。
导入后失败：按格式、拉取、配置、启动四层排查
- 格式层：提示 JSON parse error、unexpected character 或配置为空时，先查看订阅实际返回内容。若是 YAML、HTML、登录页或 Base64，先回到提供方确认格式，不要盲目修改字段。
- 拉取层：提示 401、403、超时、DNS failure、证书错误时，分别检查订阅是否过期、是否需要 Basic Auth、本机能否解析域名、系统时间是否正确以及 HTTPS 证书链是否被拦截。浏览器能打开不一定代表客户端请求路径、认证方式和响应内容都正确。
- 配置层：提示字段不支持、未知出站或结构错误时，确认客户端核心版本与配置生成版本是否匹配。先删除最近手工改动，恢复上一次可用副本；不要同时改 DNS、TUN、路由和节点字段。
- 启动层：配置能更新但服务启动失败时，检查 VPN/TUN 权限、端口占用、网络扩展或系统防火墙。若服务已启动但无网络，先关闭 TUN 或全局接管做对照，再查看 Dashboard 状态和分组选择。
- 节点层：只有某个节点失败而其他节点可用时，不要把它判断为整个订阅失效；切换分组或节点复测，并记录失败节点、协议、网络环境和时间。
如果订阅 URL 已经泄露，优先在提供方后台重置或生成新链接；本文不建议把真实 token、用户名、密码、证书或私钥粘贴到在线校验工具。任何无法从当前客户端页面或官方文档确认的菜单名称，都应以当前版本界面为准。
如何确认导入真的成功：结果与回滚标准
- 配置结果：Remote Profile 能显示名称、更新时间或配置内容，而不是空白、HTML 或错误页。
- 运行结果：Dashboard 显示服务处于运行状态，并能看到连接或流量变化。
- 选择结果：如果配置包含分组，能够查看或切换 Selector、URLTest 等组；没有分组时，不要期待客户端自动出现节点选择器。
- 网络结果：至少用一个普通网页、一个需要 DNS 解析的域名和一个实际业务应用分别测试。测试失败时记录发生在哪一层。
- 回滚结果：停止服务，恢复导入前的 Local Profile 或旧配置，再重新启动确认本机网络恢复。不要在网络已经异常时继续叠加多个客户端的 TUN 或 VPN。
截至 2026 年 11 月 3 日，官方资料仍将图形客户端按 Android、Apple platforms、Desktop 分类展示；版本号、菜单名称、自动更新选项和系统权限提示应以你当前安装版本的官方页面为准。
常见问题
sing-box 可以直接导入 Clash 订阅吗？
不能把 Clash YAML 直接当作 sing-box JSON 使用。先确认订阅返回内容；如果是 YAML，应索取 sing-box 格式，或经过可靠转换后再用配置检查命令验证。
Remote Profile 和 Local Profile 有什么区别？
Remote Profile 以 URL 为更新来源，适合远程订阅；Local Profile 保存本机配置，适合手动编辑和回滚。远程配置更新依赖链接、认证和网络。
导入成功但 Groups 里没有节点怎么办？
先检查配置是否包含 Selector 或 URLTest 等分组出站。没有分组时，客户端可能不会显示节点选择器；有分组但为空，则继续检查配置内容、更新结果和出站字段。
订阅链接更新失败，应该先改客户端还是先换节点？
先查拉取层：确认 URL、认证、HTTP 状态、DNS、证书和返回正文。配置尚未成功更新前，直接切换节点通常不能解决订阅 URL 本身无法访问的问题。
Windows 和 Android 的 sing-box 导入步骤一样吗？
核心逻辑相同，都是添加远程配置、刷新、启动和复测，但系统权限不同。Android 通常涉及 VPN 授权，Windows 可能涉及桌面客户端权限、TUN 或网络组件，菜单以当前版本为准。