糖果云 sing-box 订阅导入失败？先确认格式再排查
简答：糖果云订阅能否直接导入 sing-box，关键不在名称，而在链接是否返回 sing-box 可读取的远程 JSON 配置。先核对后台是否标注 sing-box 格式；没有专用链接时，不要把 Clash 或 Base64 链接直接当作 sing-box 配置导入。
定义：sing-box 订阅导入，是把服务面板提供的远程配置 URL 添加为 sing-box 的 Remote Profile，并由客户端按链接更新配置，而不是把任意订阅链接自动转换成 sing-box 配置。
先做格式判断：不要把所有订阅链接都当成 sing-box 配置
本文是独立使用指南，与 Candytally（糖果云）及其开发者无隶属关系。本文没有核实该服务后台是否提供原生 sing-box 专用链接，因此不能把“糖果云订阅”直接判断为兼容。应以你实际登录后看到的格式名称、返回内容和客户端提示为准。
| 你拿到的内容 | 能否直接作为 sing-box Remote Profile | 先检查什么 |
|---|---|---|
| 后台明确标注 sing-box、sing-box JSON 或远程配置 | 可能可以 | 用浏览器打开链接，确认返回内容是 JSON，而不是登录页或错误页。 |
| Clash YAML、Clash Meta 或类似 YAML 配置 | 不能默认直接导入 | 查看文件开头是否出现 YAML 字段；不要仅因链接能在其他客户端使用就判断兼容。 |
| Base64、V2Ray、单节点 URI 或二维码 | 不能默认作为远程 JSON 配置 | 先确认客户端或转换工具支持的输入格式；转换前不要公开粘贴含 Token 的链接。 |
| 打开后是 HTML、403、404、429 或空白内容 | 不能导入 | 先处理权限、链接失效、访问频率或复制不完整问题。 |
sing-box 官方文档把远程配置定义为以 URL 作为更新来源的 Remote Profile，并说明图形客户端应支持远程配置查看、自动更新和 HTTP Basic 授权。可参考 sing-box 图形客户端通用配置说明。
导入前的最短核验路径
- 登录你实际购买或获取订阅的面板。寻找“订阅链接”“远程配置”“sing-box”“JSON”或类似名称。若只有 Clash、通用订阅或 Base64 选项，先不要把它们当作原生 sing-box 配置。
- 复制完整 URL。从协议头开始复制到末尾，检查是否包含 Token、参数和必要的大小写。不要把订阅 URL、Token 或带完整链接的截图发到公开群组、Issue 或在线转换站。
- 在浏览器中检查返回内容。将“替换为你的订阅 URL”替换为真实链接后执行：
curl -L -sS -D headers.txt -o response.txt "替换为你的订阅 URL"。该命令只用于查看 HTTP 响应和保存返回内容，不要把真实 URL 写入公开脚本。打开headers.txt，状态码应是成功响应；打开response.txt，内容应是 JSON 配置，而不是 HTML 登录页、错误提示或 YAML。 - 判断结果。如果返回内容以
{或[等 JSON 结构开头，并包含 sing-box 配置所需字段，才进入客户端导入；如果返回 HTML、YAML、Base64 文本或错误页，先回到面板选择正确格式或联系服务提供方核对。 - 若链接已经公开。不要继续在多个客户端反复测试；应在面板中查找重置、重新生成或更换订阅 Token 的功能。具体按钮名称未核实，以面板实际显示为准。
这里的判断只能说明“返回内容看起来像目标格式”，不能证明节点一定可用。导入成功后仍要分别检查配置解析、节点列表、VPN/TUN 权限和实际连接。
Android：用 SFA 添加远程配置
官方资料将 sing-box for Android（SFA）描述为可管理并运行本地或远程 sing-box 配置文件的 Android 客户端，最低要求为 Android 5.0。可查看 sing-box for Android 官方说明。
- 安装来源应以项目官方发布渠道为准，打开 SFA 后进入配置或 Profiles 页面。
- 选择新建远程配置、Remote Profile 或含义相近的入口；不同版本的按钮名称可能不同。
- 把已核对过的 sing-box 配置 URL 粘贴到地址栏，填写一个便于识别的名称后保存。
- 打开该配置的详情或预览，确认能看到配置内容或节点/出站信息；如果直接显示 JSON parse error，回到前面的返回内容检查。
- 启动服务并接受 Android VPN 权限请求。若只导入但没有启动，系统流量不会自动经过该配置。
- 先访问一个普通网页或执行一次应用内连接测试，再观察日志。能看到配置已加载、服务处于运行状态且没有连续 DNS 或握手错误，才算完成初步验证。
远程配置的自动更新并不等于每次都立即刷新。官方通用说明给出的默认更新间隔是 60 分钟；如果客户端显示上次更新时间没有变化，可先手动刷新，再检查链接是否仍能返回有效内容。参考 Remote Profile 官方说明。另有公开 Issue 记录过 SFA 远程配置更新不稳定的报告，因此更新异常时应以手动刷新和响应检查为准，而不是只等待后台更新。可查看 SFA 远程配置更新 Issue。
Windows、macOS 与 iOS：按客户端类型选择入口
不要把“能运行 sing-box 核心”与“有完整图形导入界面”混为一谈。官方仓库的项目列表显示，SFA 面向 Android，SFI/SFM 面向 Apple 平台，另有 sing-box for Desktop 项目；当前版本与发布渠道会变化，应以官方仓库和发行说明为准。可查看 SagerNet 官方项目列表 与 sing-box 官方发行说明。
| 平台 | 建议核对的客户端路径 | 完成标准 |
|---|---|---|
| Windows | 优先确认你安装的是带图形配置管理能力的 sing-box Desktop 或其他明确支持 sing-box 配置的客户端；不要把命令行核心误认为订阅导入器。 | 远程配置被保存，能查看或加载 JSON，启动后系统代理或 TUN 状态符合你的设置。 |
| macOS | 确认使用的是 Apple 平台图形客户端或独立版，并在 Profiles 中添加 Remote Profile。 | 配置可更新，服务启动，无持续权限或 Network Extension 错误。 |
| iOS | 使用支持 sing-box 远程配置的 Apple 客户端，添加远程配置 URL 后开启系统 VPN 权限。 | 配置显示已加载，VPN 状态已连接，再测试具体应用。 |
官方通用客户端说明还给出了远程配置导入 URL Scheme：sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName。只有在客户端和系统允许调用该 Scheme 时才适用；手动添加 URL 通常更容易发现复制错误。不要把未编码的 Token 直接拼进公开链接或网页。
导入后常见错误：按现象定位，不要反复更换客户端
- 没有节点或配置为空：先在浏览器重新打开订阅 URL，确认返回不是空 JSON、登录页或过期页面；再检查是否选错了 Clash、Base64 或单节点格式。
- JSON parse error：返回内容可能是 HTML、YAML、被截断的 JSON，或服务端输出了不兼容字段。保存返回内容后检查第一行和末尾是否完整，不要先修改大量字段。
- 403 或 404：403 通常表示权限、Token 或访问条件未满足，404 可能表示链接路径失效；重新从面板复制，不要手动猜测 URL。
- 更新超时：先在同一网络用浏览器检查 URL，再切换一次网络测试；如果浏览器也超时，问题更可能在链接可达性或服务端，而不是客户端解析。
- 导入成功但无法联网：分别确认配置已启动、系统 VPN/TUN 权限已授权、系统代理开关与客户端模式一致，并查看日志中是否有 DNS、TLS、握手或路由错误。
- 能打开网页但某些应用不通：系统代理只覆盖使用代理设置的应用，TUN 才可能接管更多类型流量；sing-box 官方客户端文档也区分了系统代理、重定向和虚拟接口三种方式，可参考 sing-box 客户端代理模式说明。
Clash 或其他格式不能直接导入时怎么办
如果后台没有 sing-box 专用链接，最稳妥的顺序是：先询问服务提供方是否能生成 sing-box JSON；如果只能提供 Clash 或其他格式，再确认你使用的客户端是否明确支持该格式转换。不要把含 Token 的订阅 URL 粘贴到公共在线转换服务，也不要把转换后的配置当成原始配置长期保存到公开仓库。
转换后仍要做三项检查：第一，输出是否为合法 JSON；第二，是否存在可用的出站或节点；第三，客户端版本是否支持配置中使用的字段和协议。sing-box 官方发行说明会记录版本变化，旧配置字段可能在升级后被弃用或移除，因此出现解析错误时应先核对版本和迁移说明，而不是直接删除全部配置。可从 官方发行页面 查看对应版本信息。
截至 2026 年 10 月 24 日，本文未核实糖果云后台是否提供原生 sing-box 链接、具体按钮名称、兼容协议列表或 Token 重置入口；这些信息以你实际看到的面板和相关服务方说明为准。
常见问题
糖果云订阅能直接导入 sing-box 吗？
未核实该服务是否提供原生 sing-box 专用链接。只有后台明确标注 sing-box 或远程 JSON，且链接返回可解析的 sing-box 配置时，才可能直接导入；Clash、Base64 或单节点链接不能默认直接使用。
SFA 添加远程配置后没有节点，应该先查什么？
先在浏览器重新打开订阅 URL，确认返回的不是 HTML、登录页、空内容或错误状态；再检查是否复制完整、Token 是否有效，以及是否选择了正确的配置格式。
为什么订阅链接在其他客户端能用，sing-box 却提示 JSON parse error？
不同客户端需要的配置格式可能不同。其他客户端能读取，不代表它就是 sing-box JSON；先查看返回内容是 YAML、Base64、URI 还是 HTML，再选择 sing-box 格式或经过可信且安全的转换方案。
Windows 上没有远程配置入口怎么办？
先确认安装的是带图形配置管理能力的客户端，而不是只有命令行核心。官方项目和发行渠道会变化，应以 sing-box 官方仓库的客户端说明为准；也可以先用本地 JSON 配置验证核心是否能正常加载。
公开分享订阅 URL 会有什么问题？
订阅 URL 往往包含可识别账户或 Token 的凭据。若已经公开，应停止继续传播，检查面板是否支持重新生成或重置订阅链接；具体入口未核实，以实际面板为准。