sing-box Windows 导入订阅教程：先判格式，再完成连接验证
简答：sing-box Windows 导入订阅，先不要直接粘贴链接反复重试：先确认你使用的是图形客户端还是官方命令行核心，再判断返回内容是 sing-box JSON、Clash/Mihomo YAML、URI 列表还是登录页。最快流程是三步：下载与系统架构匹配的客户端，添加远程配置或保存本地 JSON，启动后先用系统代理验证，再单独测试 TUN。
定义：sing-box Windows 导入订阅，是把远程订阅链接或本地 sing-box JSON 配置交给 Windows 客户端解析，再启动核心、选择出站并验证连接的过程。
先做三行判断：你应该走哪条导入路径
本文为第三方使用指南，不代表 sing-box 或任何订阅服务的官方页面。sing-box 官方文档将 Windows 图形客户端列为 sing-box for Desktop，同时也提供命令行核心；两者的操作方式不能混用。官方图形客户端用于管理和运行本地或远程 sing-box 配置，并提供包括 TUN 在内的平台功能。查看 sing-box 图形客户端说明 查看 sing-box for Desktop 官方说明
| 你手里的内容或需求 | 优先选择 | 先确认什么 |
|---|---|---|
| 已有完整 sing-box JSON，熟悉命令行 | 官方 sing-box 核心 | 文件是否为有效 JSON，字段是否符合当前配置文档 |
| 需要远程订阅、节点选择、日志和界面管理 | 支持远程 sing-box 配置的图形客户端 | 客户端是否明确支持远程配置、Windows 版本和系统架构 |
| 拿到的是 Clash/Mihomo YAML | 先向订阅提供方确认 sing-box 格式 | 不能默认把 YAML 当成 sing-box JSON 交给核心 |
| 拿到的是一行或多行 URI | 使用明确支持 URI 导入的客户端 | 官方核心不能把 URI 列表直接当完整配置文件运行 |
成功标准：远程配置已经保存；更新返回的不是登录页或 HTML；节点或出站项目出现；核心启动后持续运行；系统代理或 TUN 按预期接管流量。只满足其中一项，不能说明订阅已经真正生效。
适用范围与前置条件
- 本文面向 Windows 10/11 用户，具体支持范围仍以当前客户端文档和发布页为准。
- 准备一条由订阅提供方生成的完整 URL，或一份完整的 sing-box JSON 配置。
- 不要把带有访问令牌的完整订阅链接发布到截图、群聊、公共仓库或在线转换页面。
- 首次排查建议只启用一种接管方式：先测试系统代理，确认核心正常后再测试 TUN。
- 如果使用官方图形客户端，下载入口应从官方文档跳转到 GitHub Releases；不要把搜索结果中的第三方下载页当成官方入口。
截至 2026 年 11 月 4 日，官方文档列出的 sing-box for Desktop 要求为 Windows 10+，并列出 x64、x86 和 arm64；官方核心构建资料则列出 Windows amd64 和 arm64。具体安装包、版本和发布状态会变化，下载时应以当前发布页为准。核对桌面客户端系统要求 核对官方核心架构说明 查看当前官方发布页
图形客户端导入远程订阅：不要把不同客户端的菜单混在一起
sing-box for Desktop 与其他第三方 GUI 的菜单名称、订阅管理能力和格式兼容范围可能不同。因此，下面是通用操作顺序，不把某个第三方客户端的菜单路径冒充成 sing-box for Desktop 的固定界面。
- 确认链接来源：从订阅服务的账户页面复制完整 URL，不要手动删除问号后的参数，也不要把登录页地址当成订阅地址。
- 打开远程配置入口：在当前客户端中寻找“Profiles”“配置”“远程配置”“Remote”或类似入口。若客户端只有“导入本地文件”，说明它可能不支持直接拉取远程订阅，应改用本地 JSON 或客户端明确支持的格式。
- 新增并保存：粘贴 URL，填写便于识别的名称，保存后执行“更新、刷新或拉取”。不同客户端的按钮名称以当前界面为准。
- 检查返回内容：更新后确认不是空白、登录页、HTML 错误页或权限提示；如果出现这些内容，先回到订阅来源核对链接和授权。
- 选择并启动：当节点、出站或配置内容出现后，选择一个项目启动核心。首次验证先开启系统代理，不要同时修改 DNS、规则和 TUN。
如果客户端提供“测试 URL、查看日志或更新记录”，只把它们作为定位信息，不要据此推断订阅服务一定正常。远程配置能够保存，不等于节点一定可连接；节点出现，也不等于系统代理已经生效。
先看返回内容：远程订阅、JSON、YAML 和 URI 的区别
导入失败时，最有价值的第一步不是更换节点，而是确认链接或文件实际返回了什么。可以在不公开链接的前提下，将响应保存到本地，用文本编辑器查看开头和主要字段。不要把包含令牌的完整 URL 粘贴到不明在线检测站。
| 内容类型 | 常见特征 | 能否直接给官方核心 | 建议 |
|---|---|---|---|
| sing-box JSON | JSON 对象，可能包含 log、dns、inbounds、outbounds、route 等字段 | 可以，但必须符合当前配置结构 | 保存为 JSON 后先执行配置检查 |
| Clash/Mihomo YAML | 常见字段包括 proxies、proxy-groups、rules | 不能默认直接运行 | 向提供方索取 sing-box 格式，或只使用当前客户端明确说明的兼容功能 |
| URI 列表 | 通常一行一个分享链接，带有协议前缀 | 不能当完整 JSON 配置 | 使用明确支持 URI 导入的图形客户端，或先生成合规配置 |
| HTML 或登录页 | 出现网页标题、登录表单、错误提示或权限信息 | 不能导入 | 回到账户页面复制真正的订阅 URL |
官方配置文档明确说明 sing-box 使用 JSON 配置文件，并列出配置结构、检查、格式化和合并命令。Clash/Mihomo YAML、URI 列表与 sing-box JSON 的字段结构不同，不能根据文件后缀或搜索结果自行推断兼容。查看 sing-box 官方配置说明
命令行导入本地 JSON：使用已核实的检查与启动方式
命令行核心适合已经拿到完整 JSON 的用户。先将配置保存到单独目录，例如 C:\sing-box\config.json，确认资源管理器没有隐藏成 config.json.txt，再在 PowerShell 中进入 sing-box.exe 所在目录。
- 先检查配置：在配置文件所在目录执行
sing-box check。官方配置页给出的检查命令不带文件参数；如果你使用不同版本或不同目录结构，先查看该版本的命令帮助。 - 需要格式化时：使用官方文档列出的形式
sing-box format -w -c config.json -D config_directory。-w会写回文件，执行前建议先复制一份原始配置。 - 启动核心：在 PowerShell 中执行
sing-box.exe run -c config.json。官方项目资料和 Windows 使用场景均采用该形式；若提示找不到程序，请改用.\sing-box.exe或完整路径。 - 观察日志：窗口持续运行并出现启动日志，说明进程没有立即退出；若配置包含 TUN，可能还需要以管理员身份打开 PowerShell。
检查通过只代表配置能够被解析和初始化，不代表节点一定可达，也不代表系统代理已经设置。若命令提示字段错误，应保留完整错误原文，依据当前版本的配置文档核对字段，不要只删除报错字段后继续运行。
Windows 官方核心构建资料列出 amd64 和 arm64；不要把 x64、x86 和 arm64 资产混用。官方图形客户端页面列出的架构范围与核心构建范围并不完全相同，下载时必须按你选择的对象分别核对。核对检查与格式化命令 查看 Windows 下 run -c 的官方项目示例 核对核心架构
导入成功后的验证顺序：先系统代理，再 TUN
- 配置层：远程配置已保存，更新后能看到节点、出站或代理组，不是空白页面。
- 核心层：启动后状态保持运行，日志没有立即出现解析失败、初始化失败或进程退出。
- 代理层：确认客户端的系统代理开关已经打开，并检查 Windows 代理设置没有被其他程序覆盖。
- 网络层：先访问普通网页，再测试目标应用；浏览器能用而单个应用不能用，可能是应用代理设置、规则或 DNS 问题。
- TUN 层：仅在前四步正常后再开启 TUN。TUN 涉及虚拟接口、自动路由和权限，失败时先关闭 TUN，回到系统代理复测。
官方 TUN 文档说明，Windows 图形客户端和命令行客户端支持相关 TUN 功能，但具体字段、路由行为和权限要求取决于配置与当前版本。不要把 Linux 的命令或配置字段直接套到 Windows；如果图形客户端没有暴露某个选项，应以该客户端当前界面和官方文档为准。查看 sing-box 官方 TUN 配置说明
按现象分流：导入失败时先处理最可能的一层
| 现象 | 先检查 | 下一步 |
|---|---|---|
| 粘贴后解析失败 | 返回内容是否为 JSON、URL 是否完整、是否需要授权 | 重新复制对应格式；若返回 HTML 或登录页，回到账户页面获取真正订阅地址 |
| 配置保存了但没有节点 | 更新是否成功、响应是否为空、客户端是否支持该格式 | 查看更新日志；向提供方确认 sing-box 格式和权限，不要直接断定节点失效 |
| 节点出现但连接超时 | 是否只测试了一个节点、系统时间和 DNS 是否正常 | 换一个节点并保持其他设置不变；再分别排查 DNS、规则和网络环境 |
| 系统代理打开但浏览器无变化 | 核心是否运行、浏览器是否遵守系统代理、是否有其他代理程序 | 关闭冲突程序，重新确认系统代理状态，再做网页测试 |
| TUN 启动失败或 Access is denied | 管理员权限、虚拟网卡和其他 VPN/TUN 软件冲突 | 按客户端提示提升权限；关闭冲突软件；仍失败时先回退系统代理 |
| 提示端口已被占用 | 日志中的监听端口和其他本地程序 | 关闭占用程序或在当前客户端中改用未占用端口，每次只改一个设置 |
建议先做：重新确认格式、保存响应类型、查看日志、换一个节点。必须先做：运行 TUN 前确认权限与虚拟接口条件，命令行运行前确认配置检查通过。这样可以避免把格式问题误判成线路问题。
安全操作与回滚步骤
- 订阅 URL 可能包含访问令牌或账户识别信息，不能放入公开截图、工单附件、公共代码仓库或不明转换站。
- 优先使用订阅提供方直接生成的 sing-box 配置；若只能得到 YAML 或 URI，先确认转换方式和隐私风险。
- 导入陌生 JSON 前，先查看 DNS、出站、规则和远程资源地址；不理解的配置不要直接以管理员权限启动。
- 不要覆盖唯一一份可用配置。先复制旧文件，再执行格式化、修改或替换。
- 停止核心并关闭 TUN。
- 恢复 Windows 原有代理设置，确认其他应用可以正常联网。
- 停用刚添加的远程配置，保留原始链接但不要公开。
- 重新导入时只测试一个节点和系统代理，不同时开启自定义 DNS、复杂规则和 TUN。
- 每次只恢复一个设置；一旦出现新错误，回到上一个可用状态。
常见问题
sing-box Windows 能直接导入 Clash 订阅吗？
不能一概而论。Clash/Mihomo YAML 与 sing-box JSON 是不同格式，官方核心不能默认直接读取 YAML。只有当前图形客户端明确支持兼容或转换时，才应按照该客户端说明操作；更稳妥的方式是向订阅提供方确认是否有 sing-box 格式。
Windows 上应该使用官方核心还是图形客户端？
已有完整 JSON、熟悉 PowerShell 并希望自行管理配置时，可以使用官方核心；需要远程配置、节点选择、日志和系统代理界面时，选择支持远程 sing-box 配置的图形客户端更方便。两者不是同一个安装对象。
导入订阅后没有网络，是否说明订阅失效？
不一定。先确认配置中有节点、核心持续运行、系统代理真正开启，再换一个节点测试；如果仍失败，继续区分 DNS、规则、TUN、端口和网络环境。只有排除本地配置问题后，才适合向订阅提供方核对权限或状态。
TUN 一定比系统代理更好吗？
不一定。系统代理适合首次验证和只需要代理设置的应用；TUN 覆盖范围可能更广，但会涉及虚拟接口、路由、DNS、管理员权限以及其他网络软件冲突。建议先验证系统代理，再单独测试 TUN。
命令行检查配置时报错怎么办？
保留完整错误原文，确认文件路径、JSON 格式和程序架构，再依据当前官方配置文档核对字段。官方配置页展示的检查命令是 sing-box check；不同版本的参数行为可能变化，不要照搬未经核实的命令参数。
订阅链接在浏览器里打开是网页，能不能直接导入？
如果返回的是登录页、HTML 错误页或权限提示，不能直接作为 sing-box 配置导入。回到账户页面复制完整订阅 URL，并注意不要在测试过程中公开带令牌的地址。
常见问题
sing-box Windows 能直接导入 Clash 订阅吗？
不能默认直接导入。Clash/Mihomo YAML 与 sing-box JSON 是不同格式，只有当前图形客户端明确支持兼容或转换时才按其说明操作。
Windows 上应该使用官方核心还是图形客户端？
已有完整 JSON 且熟悉命令行时可用官方核心；需要远程订阅、节点选择、日志和系统代理界面时，选择支持远程配置的图形客户端。
导入订阅后没有网络，是订阅失效了吗？
不一定。先检查节点是否出现、核心是否持续运行、系统代理是否生效，再分流排查 DNS、规则、TUN、端口和节点超时。
TUN 一定比系统代理更好吗？
不一定。系统代理适合首次验证；TUN 可能覆盖更多流量，但涉及虚拟接口、路由、DNS、权限和软件冲突。
命令行检查配置时报错怎么办？
保留完整错误原文，确认路径和 JSON 格式，并依据当前官方配置文档核对字段。官方配置页展示的检查命令是 sing-box check。
订阅链接打开是网页，能不能直接导入？
如果返回登录页、HTML 错误页或权限提示，不能作为配置导入。应回到账户页面复制真正的订阅 URL，并保护其中的访问令牌。