sing-box Windows 导入订阅教程：从格式核验到开启代理
简答：Windows 上导入 sing-box 订阅，最稳妥的顺序是：先从项目官方发布渠道安装 sing-box for Desktop 或命令行核心，再确认服务商提供的是 sing-box 配置 URL，随后新增远程配置、更新配置、选择节点并启动代理。若导入失败，优先检查返回格式、订阅有效性和配置版本，不要把 Clash YAML 或普通 Base64 文本直接当作 sing-box JSON。
定义：sing-box Windows 导入订阅，是把远程 URL 返回的 sing-box 配置文件加入 Windows 客户端，并通过该配置启动核心、选择出站节点和接管系统网络请求。
先试这一步：确认客户端和订阅格式
本文面向已经拥有订阅地址、但不确定 Windows 如何使用 sing-box 的读者。本站是第三方使用指南站，不代表任何客户端项目或订阅服务的官方立场。资料核验日期：2026-11-02。
| 你要完成的事 | 优先选择 | 判断标准 |
|---|---|---|
| Windows 图形化导入、更新和选节点 | sing-box for Desktop | 官方图形客户端页面将 Windows 对应客户端列为 sing-box for Desktop；下载前应从项目文档或其官方代码仓库跳转到发布资源。 |
| 手动编辑 JSON、脚本启动或调试 | sing-box 命令行核心 | 需要自己准备配置文件，并在 PowerShell 中执行检查和运行命令。 |
| 已有 Clash、Base64 或节点分享链接 | 先向订阅提供方确认格式 | 不能仅凭链接名称判断兼容性；优先索取 sing-box 专用配置或明确写明支持 sing-box 的订阅。 |
官方客户端列表说明，Windows 对应的图形客户端是 sing-box for Desktop，项目代码仓库则将其描述为 Windows 客户端。下载时应核对发布者、仓库归属、文件名和校验信息；不要从搜索结果中的不明镜像直接运行安装包。查看官方图形客户端列表，再通过官方桌面客户端仓库核对项目身份。
Windows 图形客户端导入远程订阅
- 准备订阅地址：登录你的订阅服务后台，找到客户端订阅、配置订阅或 sing-box 配置入口，复制完整 HTTPS URL。不要把订阅 URL 发到群聊、截图或提交给陌生转换网站，因为 URL 可能包含账户凭据。
- 安装客户端：从官方项目页面进入 Windows 发布资源，下载与你的系统架构匹配的安装包。安装前检查下载页面是否仍属于项目维护者，并以当前发布页的系统要求为准；本文不固定写某个版本号。
- 打开配置管理：启动 sing-box for Desktop，在配置、Profiles、Profiles 管理或类似入口中新增远程配置。不同版本的菜单名称可能变化，核心动作应是“新增 Remote Profile”或“新增远程配置”。
- 填写字段：名称填写便于识别的标签，例如“工作订阅”；URL 粘贴刚复制的订阅地址；如果页面提供更新间隔或认证字段，只填写订阅服务明确要求的内容。
- 保存并更新：保存远程配置后执行更新或刷新。成功的可观察结果应至少包括：配置被保存、更新时间发生变化、能够看到可用出站或节点组，并且没有 JSON 解析错误。
- 选择节点：进入节点组、出站组或类似页面，选择一个出站。若只有一个出站，不要擅自修改配置；先确认它是否来自刚更新的远程配置。
- 启动核心：点击启动、Start 或等效按钮。启动状态只能说明核心进程尝试运行，不能单独证明网络已经生效，下一步还要进行代理验证。
- 开启接管方式：优先先使用客户端提供的系统代理模式验证；只有在需要接管不遵守系统代理的软件时，再考虑 TUN。启用 TUN 通常涉及管理员权限、路由和 DNS 变化，首次排查不建议同时修改多项设置。
官方对图形客户端的通用设计说明中，将远程配置定义为“以 URL 作为更新来源的 sing-box 配置”，并要求图形客户端支持远程配置更新。菜单名称和按钮位置会随客户端版本变化，因此应以当前界面为准。查看远程配置的官方说明。
如何判断订阅真的导入成功
- 配置层：远程配置有名称，保存后能看到最近更新时间，更新过程没有 HTTP、认证或解析错误。
- 节点层：配置中出现出站或出站组；如果列表为空，先不要启动 TUN，回到订阅服务后台确认返回内容。
- 核心层：客户端显示核心正在运行，日志中没有明显的 JSON 错误、字段不支持、地址为空或无法解析域名。
- 网络层：开启系统代理后，用浏览器访问一个普通 HTTPS 页面，再关闭客户端复测。只有“开启后能访问、关闭后恢复原状”，才算完成一次基本验证。
如果只看到“已启动”但网页打不开，先观察日志和节点连接结果，再分别测试 DNS、节点可达性和系统代理状态。不要一开始就同时更换 DNS、MTU、TUN 和规则，否则无法判断是哪一步造成变化。
如果配置包含 TUN，Windows 路由可能受到配置影响。官方路由文档说明，Windows 支持通过自动检测接口等选项减少 TUN 场景下的路由回环问题，但具体字段是否被你的订阅配置使用，应以当前配置和客户端版本为准。查看官方路由配置说明。
命令行路线：导入本地 JSON 配置
如果你不使用图形客户端，也可以运行 sing-box 命令行核心。此路线适合需要手动审查配置、查看详细日志或编写启动脚本的用户。
- 保存配置：从订阅服务获取明确的 sing-box JSON 配置，将文件保存为本地 JSON 文件。不要把真实订阅 URL、密码或密钥写进公开示例。
- 备份原文件：每次修改前复制一份配置文件，例如保留一个只读备份；出现启动失败时直接回滚，不要覆盖唯一副本。
- 检查配置：在 PowerShell 中进入 sing-box.exe 所在目录，运行当前版本支持的配置检查命令。命令参数可能随版本变化，先执行
sing-box help或查看对应版本文档，确认是检查本地配置还是运行配置。 - 启动核心：检查无误后再运行配置。若窗口立即退出，保留终端中的第一条错误信息；它通常比反复点击启动更有定位价值。
- 验证连接：确认日志出现启动完成、出站连接或监听信息，再在系统代理设置中填写配置要求的本地代理端口；端口必须以实际配置为准，不要照抄其他教程的数字。
sing-box 官方提供 JSON Schema，可用于兼容编辑器中的补全和校验；同时，Schema 命令可以生成与当前二进制构建相匹配的 Schema。这个方法适合发现字段拼写和结构问题，但不能证明订阅节点一定可连接。查看官方 JSON Schema 说明。
订阅不是 sing-box JSON 时怎么办
远程 URL 返回的内容可能是 sing-box JSON、Clash YAML、Base64 编码文本、单节点 URI 或登录后才能访问的页面。仅凭 URL 后缀、链接名称或网页标题无法确认格式。
- 返回 JSON：内容通常以 JSON 对象形式出现，并包含 sing-box 配置需要的结构；仍应以客户端解析结果为准。
- 返回 YAML：这通常不是可直接当作 sing-box JSON 使用的配置。先向订阅提供方索取 sing-box 格式，不要直接改后缀。
- 返回 Base64 或文本：需要确认它实际编码的是哪种订阅格式。解码不等于完成 sing-box 转换。
- 返回登录页面或 HTML：说明 URL 可能过期、需要认证、被拦截，或复制时缺少参数。先在浏览器或 PowerShell 中确认返回状态，但不要公开打印完整 URL。
如果必须使用转换工具，应先确认工具的隐私政策、是否会把完整订阅上传到服务器、是否支持目标协议和字段，并优先使用本地转换或服务商直接生成的 sing-box 配置。转换后的配置还要经过 JSON 校验和实际连接验证；不能把“转换成功”当作“节点可用”。
导入失败的分流排查顺序
| 现象 | 优先检查 | 修复动作 |
|---|---|---|
| 保存后提示格式错误 | 返回内容是否为 JSON、是否被登录页替代 | 重新复制完整 URL，向提供方索取 sing-box 格式，不要只改文件后缀。 |
| 更新提示超时或拒绝访问 | URL 是否过期、网络是否可访问、是否需要认证 | 在服务后台重新生成订阅；更换网络只用于复测，不要公开订阅凭据。 |
| 配置成功但节点为空 | 配置是否只有规则、是否使用了不兼容字段 | 查看原始返回内容和客户端日志，要求提供方确认出站配置。 |
| 核心启动后立即停止 | JSON 结构、必填字段、当前版本支持范围 | 恢复备份，逐项修正；不要一次粘贴多个网上修改片段。 |
| 核心运行但网页打不开 | 节点连通性、系统代理开关、DNS 或 TUN 路由 | 先关闭 TUN，仅用系统代理复测；再根据日志决定是否处理 DNS 或路由。 |
| 更新后旧节点仍在 | 是否更新了正确的远程配置、客户端是否使用缓存 | 确认配置名称和更新时间，手动刷新后再重启客户端；必要时备份后删除旧配置重新添加。 |
排查完成后执行一次回滚验证：关闭 sing-box，恢复系统代理和 DNS 原设置，确认普通网络恢复；然后只重新启用一个改动，记录结果。这样可以把订阅问题、客户端问题和 Windows 网络问题分开。
常见问题 FAQ
sing-box Windows 应该下载命令行核心还是图形客户端？
只想导入远程订阅、更新配置、选节点和开关代理，优先选择官方列表中的 sing-box for Desktop；需要脚本、手动 JSON 或详细调试时再选命令行核心。两者都应从项目官方文档或代码仓库跳转下载，具体系统要求以当前发布页为准。
Clash 订阅能不能直接导入 sing-box？
不能仅凭“订阅链接”四个字判断兼容。Clash YAML、Base64 文本、单节点 URI 和 sing-box JSON 是不同返回形式；先向订阅提供方确认是否提供 sing-box 格式，或使用经过审查的转换方案，再对转换结果做 JSON 校验和连接复测。
导入订阅时提示 JSON 错误，最先检查什么？
先确认复制的是完整 URL，并检查 URL 返回的是否为配置内容而不是登录页面、错误页面或过期提示。随后确认客户端版本是否支持配置字段。不要直接删除字段或把 YAML 改成 JSON 后缀。
开启 TUN 后 Windows 没网，怎么恢复？
先停止 sing-box，关闭 TUN，恢复系统代理和 DNS 设置，再测试普通网络。如果恢复正常，说明问题集中在 TUN、路由、DNS 或权限链路；下一次只启用系统代理或只启用 TUN，分别复测并查看日志。
订阅 URL 可以发给别人帮忙排查吗？
不建议。订阅 URL 可能包含账户凭据或访问令牌。排查时应打码域名后的令牌、账号参数和完整节点信息，只提供错误类型、客户端版本和不含凭据的日志片段。
常见问题
sing-box Windows 应该下载命令行核心还是图形客户端？
只想图形化导入订阅、更新配置和选节点，优先选择官方列表中的 sing-box for Desktop；需要脚本、手动 JSON 或详细调试时再选命令行核心。
Clash 订阅能不能直接导入 sing-box？
不能仅凭链接判断兼容。先确认返回格式，优先向订阅提供方索取 sing-box 配置；转换后仍需进行 JSON 校验和实际连接复测。
导入订阅提示 JSON 错误，最先检查什么？
先确认 URL 完整、返回内容不是登录页或错误页，再检查配置格式和客户端支持范围，不要只改文件后缀。
开启 TUN 后 Windows 没网，怎么恢复？
停止核心、关闭 TUN、恢复系统代理和 DNS 后复测；恢复正常后，再分别测试系统代理、TUN、DNS 和路由，避免同时修改多个设置。