sing-box Windows 怎么导入订阅？从链接检查到启动验证
简答：在 Windows 上导入 sing-box 订阅，最短路径是：安装支持远程配置的图形客户端，新增远程配置并粘贴订阅 URL，保存后手动更新，选择节点并启动核心，最后用浏览器验证。若导入失败，先确认链接返回的是 sing-box JSON，而不是 Clash YAML、Base64 节点列表或单独的 URI 列表。
定义：sing-box 订阅导入，就是把服务提供方的远程配置 URL 添加到 sing-box 客户端，让客户端下载、保存、更新并使用其中的 JSON 配置。
先看这张速查卡：你应该用哪种方式
先确认自己安装的不是只有命令行核心。sing-box 官方项目把 Windows 图形客户端单独维护为 sing-box for Desktop，当前项目说明将其标注为实验性 Windows 客户端；命令行核心则主要通过 JSON 配置文件运行。官方桌面客户端说明
| 你手上的工具 | 适合的导入方式 | 新手建议 |
|---|---|---|
| sing-box for Desktop 或其他支持远程配置的 GUI | 新增 Remote Profile/远程配置，填写名称和 URL，保存后更新 | 优先使用，操作最短 |
| 第三方 Windows GUI | 按客户端中的 Quick Start、Remote Profile 或订阅管理入口添加 URL | 按钮名称可能不同，以当前客户端界面为准 |
| sing-box 命令行核心 | 把完整 sing-box JSON 保存为配置文件，再用 sing-box check 检查 | 不适合只拿到订阅 URL 的普通新手 |
- 确认 Windows 客户端能添加远程配置。
- 复制服务商提供的 sing-box 专用订阅链接。
- 粘贴 URL，保存并执行更新。
- 选择出站节点或策略组后启动核心。
- 打开浏览器访问一个平时无法直接打开的测试页面，确认是否生效。
导入前：确认订阅链接和格式
订阅 URL 通常包含访问凭据，不要公开发到聊天群、截图、工单或不可信的转换网站。本文无法核实 v2ray.tattoo 用户中心的具体菜单名称，实际入口请以当前页面为准；如果链接失效，重新复制最新链接，必要时联系服务提供方。
1. 优先寻找 sing-box 专用链接
如果用户中心同时提供多种格式，优先选择明确写有“sing-box”“JSON”或“sing-box 配置”的链接。sing-box 官方配置文档说明，其配置文件使用 JSON。sing-box 配置文档
2. 不要把不同格式默认当成同一种订阅
| 链接或内容类型 | 能否直接当作 sing-box JSON 导入 | 处理建议 |
|---|---|---|
| sing-box JSON 远程配置 | 通常可以 | 直接添加为远程配置，再更新 |
| Clash 或 Mihomo YAML | 不能默认直接使用 | 先确认客户端是否明确支持转换或该格式 |
| V2Ray/Xray Base64 节点列表 | 不能直接当作完整 JSON 配置 | 需要服务方提供 sing-box 格式，或使用可信且明确支持的转换方案 |
| 单独的 URI 列表 | 不能默认直接作为完整配置 | 需要生成包含入站、出站和路由的 sing-box 配置 |
如果浏览器打开订阅 URL 后看到的是一大段 JSON，仍不能只看“像 JSON”就判断可用；它还需要包含 sing-box 所需的配置结构。官方文档列出了 dns、inbounds、outbounds、route 等配置区域。官方配置结构说明
Windows 图形客户端导入订阅的最短步骤
步骤一：打开远程配置入口
启动支持 sing-box 的 Windows 图形客户端，在主界面或配置管理区域寻找 Remote Profile、远程配置、Add Profile、添加订阅 或类似入口。不同 GUI 的菜单名称可能不同，不要因为按钮名称不完全一致就重复下载多个核心。
步骤二：填写名称和 URL
- 名称填写便于识别的名称，例如“办公订阅”或“主订阅”。
- URL 粘贴完整订阅链接，检查开头是否为
https://或服务方实际提供的协议。 - 不要在 URL 后面自行添加空格、引号或换行。
- 如果界面提供自动更新选项，可以先关闭自动更新，完成首次验证后再开启。
官方 GUI 规范将远程配置定义为“以 URL 作为更新来源”的配置，并要求图形客户端支持远程配置更新；其默认更新间隔在规范中写为 60 分钟，但具体客户端是否采用该默认值，要以当前客户端设置为准。官方图形客户端配置规范
步骤三：保存并手动更新
点击保存、添加或确认后，执行一次更新订阅、Update、Refresh或同义操作。首次导入不要直接点击启动，先观察是否出现配置下载成功、节点数量或配置内容预览。
步骤四：选择节点或策略组
如果配置包含 Selector 或 URLTest 等出站组，客户端通常会提供节点或策略组选择入口。先选择一个明确的节点，不要同时修改 DNS、规则、TUN 等高级设置。
步骤五：启动并验证
点击启动核心或连接按钮。如果客户端提供系统代理开关，确认它已开启；如果使用 TUN，则确认客户端请求了 Windows 管理员权限并且 TUN 状态显示正常。然后重新打开浏览器，访问普通网页并检查是否仍能正常访问。
命令行核心用户：保存 JSON 后先检查再启动
命令行方式适合已经熟悉 PowerShell、工作目录和 JSON 配置的人。仅有一个订阅 URL 时，命令行核心不会自动替你完成图形化的远程配置管理；你需要先获得完整 JSON 配置，或使用能下载并保存远程配置的工具。
- 在一个单独目录中保存配置文件，例如
config.json。 - 打开 PowerShell，切换到 sing-box 核心所在目录。
- 运行配置检查命令：
sing-box check -c .\config.json。 - 检查通过后，再运行：
sing-box run -c .\config.json。 - 观察终端日志，再用浏览器验证连接。
官方文档明确提供了 sing-box check 配置检查命令，并说明配置文件采用 JSON。若检查失败，应先修复 JSON 语法、字段或类型问题，不要先开启 TUN。官方命令与配置文档
如果 PowerShell 提示找不到 sing-box，说明当前目录或系统 PATH 没有包含核心程序；这属于本地程序路径问题，不等同于订阅失效。
导入后没有节点、无法启动或浏览器不生效：按现象排查
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 保存 URL 后提示格式错误 | 返回内容是否为 sing-box JSON，是否误用了 YAML、Base64 或 URI 列表 | 重新获取 sing-box 专用链接；不要只修改文件后缀 |
| 导入成功但节点列表为空 | 更新是否真正完成，远程链接是否过期，配置是否只有规则没有可用出站 | 手动刷新并查看客户端日志；必要时重新复制链接 |
| 有节点但核心启动失败 | 配置检查、端口占用、权限、核心版本和日志 | 关闭其他代理程序，先用非 TUN 模式启动 |
| 核心运行但浏览器不生效 | 系统代理是否开启，浏览器是否使用独立代理设置，是否有其他软件覆盖代理 | 先开启客户端系统代理，再重启浏览器验证 |
| TUN 无法启动 | 管理员权限、虚拟网卡、其他 VPN/TUN 软件冲突 | 先关闭其他网络接管软件；基础连接正常后再单独排查 TUN |
| 更新后突然不能用 | 订阅内容是否变化、链接是否失效、当前节点是否仍可用 | 回到上一次可用配置或重新获取链接，不要同时改多项设置 |
排查顺序建议固定为：订阅 URL 可访问性 → 配置格式 → 节点或出站是否存在 → 核心能否启动 → 系统代理 → TUN 和 DNS。这样可以把“导入失败”“核心失败”和“浏览器未走代理”分成三个不同问题。
如果更新后需要保留旧配置，先导出或复制当前配置文件，再尝试替换远程链接。不要把包含访问凭据的完整 URL 粘贴到公开日志中。
几个容易混淆的判断
导入成功，不等于已经联网
导入成功只说明客户端保存或读取了配置；还需要选择出站、启动核心，并让浏览器或系统流量实际经过客户端。
核心启动，不等于所有应用都走代理
如果只启动了本地入站而没有开启系统代理、浏览器代理或 TUN，部分应用仍可能直连。优先用客户端提供的系统代理开关做基础验证，确认基础链路后再配置 TUN。
能打开网页，不等于 DNS、IPv6 和所有应用都已验证
一次网页访问只能说明某个应用在当时完成了连接。若仍有域名解析异常、办公软件无法连接或 IPv6 行为异常，应单独进行 DNS、系统代理和应用代理设置检查。
本文适用范围与核验说明
本文面向 Windows 10 及更高版本上使用 sing-box 图形客户端或命令行核心的用户，重点解决“已有订阅链接，如何导入、更新、启动和验证”这一问题。具体客户端的版本、按钮名称、系统要求和自动更新设置可能变化，下载包和当前版本请以官方项目页面及客户端当前界面为准。官方项目的 Windows 桌面客户端说明可在其仓库中核对，版本变化可查看官方 Releases 页面。Windows 桌面客户端仓库 官方 Releases 页面
本站是第三方使用指南站，不是 sing-box 官方站，也不代替服务提供方确认订阅内容。本文未核实 v2ray.tattoo 用户中心的具体页面布局，因此菜单名称仅按常见图形客户端流程描述。
常见问题
sing-box Windows 可以直接导入 Clash YAML 吗？
不能默认认为可以。sing-box 官方配置文档说明其配置文件使用 JSON；Clash/Mihomo YAML、Base64 节点列表和 URI 列表不是同一种完整配置格式。优先向服务提供方获取 sing-box JSON 链接。
为什么订阅导入成功，却显示没有节点？
可能是更新动作没有完成、远程链接已失效，或返回的配置本身没有可用出站。先手动更新并查看日志，再检查配置预览；不要先修改 DNS 或 TUN。
sing-box Windows 启动后浏览器还是不能用，怎么办？
先确认核心确实处于运行状态，再开启客户端的系统代理开关，并重启浏览器。若仍无效，检查浏览器是否设置了独立代理，以及是否有其他代理软件覆盖 Windows 系统代理。
需要一开始就开启 TUN 模式吗？
不需要。建议先用系统代理完成基础连接验证，再单独排查 TUN 的管理员权限、虚拟网卡和软件冲突问题。这样更容易判断故障发生在哪一层。
订阅链接泄露了应该怎么办？
订阅 URL 可能包含访问凭据。若链接已经公开暴露，应尽快在服务提供方后台重新生成或更换链接；本文无法确认具体服务商是否支持撤销旧链接，操作以其当前页面为准。