糖果云 sing-box Windows 怎么导入订阅?
简答:糖果云订阅能否直接导入 Windows sing-box,取决于面板实际返回的格式;本页未核实糖果云当前是否提供 sing-box 专用 JSON 链接。如果面板明确标注 sing-box 或 JSON 配置,可使用 SagerNet 的 sing-box-for-desktop Windows 客户端添加远程配置;如果只显示通用订阅、Clash、Base64 或单节点链接,不要直接假设兼容。
定义:sing-box 远程配置是由 URL 提供更新来源的完整配置档案,不等同于任意订阅链接、网页地址或单个节点 URI。
先判断:糖果云哪种链接可以导入
本文是第三方使用指南,不是 Candytally(糖果云)官方页面。糖果云后台的入口名称、复制按钮和当前返回格式尚未核实,因此不能直接告诉你某个固定菜单一定存在。打开当前面板中与“订阅”“客户端”或“配置”有关的页面,先看链接旁边是否明确写有 sing-box、JSON 或远程配置。
| 面板显示 | 是否建议直接导入 | 处理方式 |
|---|---|---|
| sing-box、JSON 配置、Remote Profile | 可以尝试 | 复制完整的 https:// 或 http:// 链接,不要删掉参数。 |
| 通用订阅,但没有说明返回格式 | 未核实 | 先确认实际返回内容,不能仅凭“订阅”二字判断兼容。 |
| Clash、Base64 或其他客户端格式 | 不要直接粘贴 | 寻找 sing-box 专用链接,或按提供方说明使用支持该格式的客户端。 |
| 单个节点 URI、二维码或分享链接 | 不等同于远程配置 | 需要客户端支持单节点导入,本文只讲远程配置导入。 |
直接结论:如果面板没有 sing-box 或 JSON 标识,先不要导入。浏览器能打开链接、文件能下载,均不能证明它就是 sing-box 可解析的配置。
推荐使用哪个 Windows 客户端
为避免把多个 GUI 的菜单混在一起,本文固定以 SagerNet 项目的 sing-box-for-desktop 为例。其项目页将它描述为“Experimental Windows client for sing-box”,也就是说它是由 sing-box 项目组织维护的 Windows 客户端,但当前仍属于实验性客户端,不应理解为成熟稳定版 Windows GUI。查看 sing-box-for-desktop 项目页
下载前先在项目页确认当前发布内容、系统架构和文件来源。不要从搜索结果中的不明镜像下载可执行文件。sing-box 核心与 Windows 图形客户端不是同一个东西:核心负责运行配置,图形客户端负责管理配置、状态和操作界面。查看 sing-box 核心项目
如果你不想使用实验性 Windows 客户端,应先选择自己能核验来源的其他 GUI;但不同 GUI 的菜单路径并不统一,不能把本文的字段名称直接套用到其他软件。
Windows 导入糖果云订阅的可操作步骤
- 复制完整链接。登录糖果云当前用户面板,在订阅或客户端相关区域寻找明确标注为 sing-box、JSON 或远程配置的链接。复制时保留协议头、路径和全部参数。停止条件:如果只看到未说明格式的通用链接,先不要继续。
- 安装并打开 sing-box-for-desktop。从项目页进入发布内容,核对文件来源和 Windows 架构后再运行。首次启动如果提示核心组件或权限,按客户端提示完成;不要把“程序已打开”当作核心已运行。
- 添加远程配置。在客户端中寻找 Profile、Remote Profile、Add Profile 或同义入口。官方图形客户端规范把 Remote Profile 定义为“以 URL 作为更新来源的远程 sing-box 配置”,并要求图形客户端提供配置内容查看能力。查看 sing-box 图形客户端通用规范
名称可填写“糖果云 Windows”,URL 粘贴刚才复制的完整链接。具体按钮文字以当前客户端版本为准。 - 更新并查看解析结果。保存后点击 Update、Refresh 或同义按钮。优先查看配置预览、配置内容或客户端日志是否显示解析成功;不要只看“URL 已保存”。如果返回内容为空、是网页 HTML 或出现 JSON parse error,停止启动,先排查格式。
- 启动核心,再选择代理模式。配置解析成功后启动 Profile 或核心。若配置包含 Selector、URLTest 等出站组,再在 Dashboard 或组选择区域选择出站。确认核心运行后,先使用系统代理测试;TUN 不是订阅导入的必要条件,只有在确实需要接管更多系统流量时再按客户端提示处理权限和网卡。
官方规范说明,Remote Profile 支持自动更新,规范中的默认更新间隔为 60 分钟;这是图形客户端规范层面的要求,不代表所有 Windows GUI 都使用相同的界面或实际更新策略。查看 Remote Profile 规范
如何确认导入成功,而不是只保存了链接
| 检查层级 | 可观察结果 | 不能据此得出的结论 |
|---|---|---|
| 订阅层 | 更新操作完成,配置预览或日志显示已获取内容。 | 不能仅凭浏览器能打开链接判断配置可用。 |
| 解析层 | 客户端能读取 JSON 配置,没有持续出现解析错误。 | 解析成功不等于节点一定能连接。 |
| 核心层 | Profile 或核心状态显示运行,日志没有持续报错。 | 核心运行不等于 Windows 流量已经经过代理。 |
| 系统层 | 开启系统代理后,普通网页能够完成一次实际访问。 | 一次网页访问不代表所有节点、协议或长期性能都正常。 |
Windows 系统代理属于应用主动使用的代理方式,部分程序可能不读取系统代理,UDP 和 ICMP 流量也不能仅凭网页结果判断。sing-box 文档将系统代理、虚拟接口和防火墙重定向区分为不同接管方式。查看 sing-box 客户端接管方式说明
导入失败时按错误现象处理
| 现象 | 先检查什么 | 下一步和停止条件 |
|---|---|---|
| subscription update fail | 完整 URL、网络访问、客户端日志中的 HTTP 状态。 | 若出现 401、403、404 或持续超时,重新从当前面板复制链接;不要凭猜测修改参数。具体失效原因未核实。 |
| 打开链接却看到网页 | 复制的是否为登录页、帮助页或错误页,而不是配置内容。 | 回到面板重新找 sing-box 或 JSON 配置链接。不要把网页地址粘贴到 Remote Profile。 |
| JSON parse error | 返回内容是否为 JSON,是否误用了 Clash、Base64、单节点链接或带额外引号的文本。 | 在客户端的配置预览或日志中确认原始响应类型;无法确认格式时停止启动。 |
| 更新成功但没有节点或出站 | 当前 Profile 是否选对,配置是否确实包含 outbounds,客户端是否支持该配置版本。 | 保留旧配置,重新核对面板格式;不要直接判断糖果云服务失效。 |
| 节点出现但网页打不开 | 核心是否运行、是否选中出站、系统代理是否开启、端口是否被占用。 | 先关闭系统代理并停止核心,再逐项恢复;如果使用 TUN,先关闭 TUN 后再测试系统代理。 |
链接过期、返回 403/404 时怎么做
- 先记录客户端显示的状态码或错误文本,不要只根据“更新失败”猜原因。
- 回到糖果云当前用户面板,重新寻找订阅或客户端配置区域,并重新复制完整链接。
- 如果面板提供重新生成、重置、撤销或重新获取订阅的按钮,按页面说明操作;这些按钮是否存在以及真实名称目前未核实。
- 把旧 Profile 保留为备份,新增一个远程配置测试新链接。新链接确认可解析后,再删除旧链接。
订阅链接可能包含账户识别信息或访问凭据。不要将完整链接发到公开群组、工单截图、代码仓库或社交平台;截图时遮住域名后的令牌和参数。如果怀疑链接泄露,应以当前服务页面提供的重置方式为准,本文不推测具体处理入口。
本文已核实与未核实的边界
已核实的是:SagerNet 项目提供 sing-box 核心,并单独维护一个实验性的 Windows 客户端;sing-box 图形客户端规范定义了 Remote Profile、URL 更新来源、配置内容查看和 Dashboard 等能力。Windows 客户端项目页 图形客户端通用规范
未核实的是:糖果云当前后台是否提供独立 sing-box JSON 链接、订阅入口的真实名称、复制按钮位置、链接有效期、重新生成方式和当前服务状态。因此本文只提供格式判断和客户端操作路径,不把糖果云与 sing-box 的实际兼容性写成已确认事实。
本文最后核验日期为 2026 年 10 月 31 日;客户端界面、发布版本和糖果云面板字段后续可能变化,操作时以当前页面显示为准。
常见问题
糖果云订阅可以直接粘贴到 Windows sing-box 吗?
不一定。只有当当前面板明确提供 sing-box、JSON 配置或兼容的 Remote Profile 链接时才建议尝试。糖果云当前面板是否提供这类链接尚未核实;如果只写通用订阅,应先确认返回格式。
为什么链接能在浏览器打开,却在 sing-box 中出现 JSON parse error?
浏览器能打开只说明服务器返回了某种内容,可能是登录页、错误页或其他订阅格式,不代表它是 sing-box JSON。应在客户端配置预览或日志中确认原始响应,再回到面板寻找明确的 sing-box 或 JSON 链接。
订阅更新返回 403 或 404,怎么处理?
先记录状态码,回到糖果云当前面板重新复制完整链接;如果页面提供重新生成、重置或重新获取订阅的入口,再按页面说明操作。具体入口名称和链接有效期未核实,不要自行修改 URL 参数。
节点已经显示,为什么 Windows 还是打不开网页?
按核心运行状态、出站选择、系统代理开关和端口占用顺序排查。先关闭 TUN 与系统代理并停止核心,再只开启系统代理进行测试;节点出现不等于系统流量已经经过 sing-box。
Windows sing-box 一定要开启 TUN 吗?
不一定。可以先用系统代理完成基础验证;TUN 是另一种流量接管方式,涉及网卡、路由和权限,不是订阅导入的必要步骤。