sing-box订阅怎么导入Windows？格式、更新与无法联网排查
简答：Windows导入sing-box订阅，先确认链接返回的是客户端支持的JSON配置，再在sing-box for Desktop中添加Remote Profile、保存并更新，最后启动配置。判断是否成功的标准是：配置能解析、出站可见、内核运行，且系统代理或TUN确实接管流量。
定义：sing-box订阅导入，是把远程配置地址保存到Windows客户端，由客户端获取、解析、更新并运行其中的配置内容。
先看这张表：你的订阅能不能直接导入
你从面板复制了订阅链接，粘进sing-box后却没有节点或无法联网？常见原因不是“保存失败”，而是链接格式不匹配，或者保存后没有执行更新。先按下面的内容判断，再进入客户端操作。
本站是第三方使用指南站，与sing-box官方及freecat无关联；订阅链接的位置、有效期和返回内容，以你实际使用的面板或服务方为准。
| 打开链接后看到的内容 | 可能类型 | 能否直接作为Remote Profile | 下一步 |
|---|---|---|---|
JSON对象，包含inbounds、outbounds或route等字段 | sing-box配置 | 可以尝试 | 添加远程配置，保存后手动更新 |
以proxies:、proxy-groups:等结构开头 | Clash YAML | 不能直接按原生sing-box JSON处理 | 向提供方索取sing-box格式，或使用明确支持转换的工具 |
| 一长串编码文本，解码后才出现节点 | Base64订阅 | 视客户端和解码结果而定 | 先确认解码后是sing-box JSON还是节点列表；节点列表通常需要转换 |
以vless://、hysteria2://等开头 | 单节点URI | 不是远程JSON配置 | 使用单节点或手动配置入口，或索取sing-box订阅 |
sing-box官方配置文档采用JSON配置结构，并提供配置检查命令。可查看sing-box配置官方文档。如果订阅链接包含token，不要公开发到群组、截图或工单；已经泄露时，应回到原面板撤销、重置或重新生成链接，具体操作以面板为准。
三步速查：保存远程地址 → 更新远程内容 → 启动配置。保存不等于更新，更新也不等于已经接管系统流量。
Windows客户端怎么选：官方桌面版与GUI.for.SingBox
| 客户端 | 定位 | 导入时应注意 |
|---|---|---|
| sing-box for Desktop | sing-box项目文档列出的Windows桌面客户端 | 官方页面列出Windows 10及以上，并按x64、x86、arm64区分；下载文件名和版本以官方Releases页面实时显示为准 |
| GUI.for.SingBox | 独立的社区GUI项目，不是sing-box官方桌面客户端 | 菜单、配置保存方式和系统代理实现以该项目自己的说明为准，不能把官方桌面版步骤直接套用 |
| 命令行sing-box | 直接运行JSON配置的核心程序 | 适合检查配置和定位GUI问题，但需要自行处理配置文件、权限、运行命令和系统代理 |
sing-box官方客户端列表将Windows客户端列为sing-box for Desktop，并说明该客户端用于管理和运行本地或远程配置，同时提供平台相关功能；具体要求可核对sing-box for Desktop官方页面和官方项目仓库。
GUI.for.SingBox的公开仓库将其描述为基于Wails和Vue 3的独立桌面项目。它属于第三方GUI，项目地址见GUI.for.SingBox项目仓库。本文主流程只按官方sing-box for Desktop的Remote Profile概念说明，不混用第三方GUI的按钮名称。
Windows导入Remote Profile：按这个顺序操作
- 复制完整订阅地址。进入你获得订阅的面板，在订阅、配置或客户端配置页面寻找复制按钮。不要只复制显示文字的一部分，也不要删除问号后的参数。
- 确认格式。先按上面的格式表判断。若打开后是登录页、HTML错误页、Clash YAML或单节点URI，不要直接当作sing-box远程JSON导入。
- 安装官方桌面客户端。从官方页面进入Releases，按Windows系统架构选择文件。安装目录应放在当前用户有写入权限的位置；版本和文件名以Releases页实时显示为准。
- 进入配置或Profile区域。官方图形客户端规范把远程配置称为Remote Profile，其更新来源是URL。相关定义见sing-box图形客户端通用规范。当前界面若显示Profiles、Remote或配置管理等相近名称，应选择远程配置入口；按钮名称可能随客户端版本变化。
- 新建远程配置。填写一个便于识别的名称，并粘贴完整订阅URL。若客户端支持官方URL Scheme，也可以使用
sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName形式导入；URL中的原始地址和名称需要按URL规则编码。 - 保存后执行更新。保存只代表客户端记录了地址。对刚添加的Remote Profile执行Update、Refresh或同义操作，等待客户端显示成功、失败或解析错误。
- 选择配置并启动。选中刚更新的配置，启动核心或运行配置。如果配置包含Selector、URLTest等出站组，再在客户端提供的组选择器中选择实际出站。
- 验证接管方式。如果配置使用TUN，检查TUN状态和Windows权限；如果配置依赖HTTP或mixed入站，则检查系统代理是否由配置或客户端设置接管。
官方通用客户端规范要求图形客户端支持Remote Profile、自动更新和配置内容查看，但没有在通用文档中固定所有Windows界面的菜单文字。因此，无法从官方资料核实的按钮名称不应硬写成固定路径；以当前客户端界面为准更安全。
系统代理、TUN和Rule模式：三个容易混淆的地方
系统代理不一定有统一开关。sing-box的mixed或http入站可以使用set_system_proxy字段，在启动时设置系统代理、停止时清理。该字段在Windows上受支持，具体行为见mixed入站文档和HTTP入站文档。如果远程配置没有这个字段，或当前GUI没有实现独立开关，就不要假设Windows系统代理会自动打开。
TUN是另一种接管路径。TUN配置和系统代理不是同一回事。启动TUN失败时，优先检查管理员权限、虚拟网卡冲突和安全软件拦截；不要因为订阅能够更新，就判断TUN一定可以启动。配置字段可核对sing-box TUN入站文档。
Rule、Global、Direct不是必有菜单。这些名称与Clash模式有关。sing-box只有在配置启用了相关Clash API能力，且当前客户端实现了对应界面时，才可能出现相近选项。官方文档说明Clash API与clash_mode相关，可查看Clash API配置文档和路由规则文档。找不到这些按钮不代表订阅一定损坏。
按报错关键词速查：导入后没有节点或无法联网
parse error / JSON parse error：返回内容可能不是合法JSON，或者把网页提示、登录页内容一起保存了。先重新打开订阅地址确认返回内容，再使用命令检查本地配置：
sing-box check -c <实际配置文件><实际配置文件>必须替换为真实路径或文件名。不要把示例文件名直接复制执行。
403、404：优先核对订阅URL、token、访问权限和订阅状态。若浏览器打开也是同样状态，不要直接归因于Windows客户端，应向提供方核对链接。
failed to fetch remote profile / 更新超时：先确认Windows可以访问订阅域名，暂时关闭其他代理客户端，避免客户端通过自身未启动的代理下载订阅；再检查DNS、安全软件或企业网络是否拦截。PowerShell只能用于基础连通性判断：
Test-NetConnection <订阅域名> -Port <端口><订阅域名>和<端口>必须替换为实际值，端口以订阅URL协议、客户端设置页或提供方说明为准。
导入后没有节点：保存后没有更新、订阅过期、返回内容为空、格式不兼容，都可能造成列表为空。重新执行更新，并确认返回内容不是Clash YAML、Base64节点列表或单节点URI。
TUN启动失败：以管理员权限启动客户端，检查是否有其他虚拟网卡或代理工具同时运行，并查看Windows安全软件是否拦截。若只有订阅更新失败而TUN正常，优先处理订阅下载；若订阅能更新但TUN失败，优先处理权限和网卡。
端口被占用：检查mixed、HTTP或SOCKS入站的实际监听端口。不要照抄其他教程的默认值；在客户端设置页查看当前端口，关闭占用程序或改用未占用的端口后再启动。
TLS握手或证书异常：先开启Windows自动设置时间并校准时区，再检查安全软件、企业代理或HTTPS检查是否拦截连接。系统时间错误可能影响TLS证书校验和订阅握手。
配置无法保存：检查安装目录和配置目录的写入权限。将客户端或配置移到当前用户可写的位置，或按客户端要求以管理员身份运行；不要随意把来源不明的程序加入安全软件排除项。
确认已经生效：Windows最小验证清单
- Remote Profile列表中有配置名称，最近一次更新不是失败状态。
- 配置内容能够解析，并且至少有一个可用出站或节点。
- 核心已经启动，没有权限、TUN、解析或端口错误。
- 系统代理或TUN至少有一种接管路径生效，避免同时运行多个代理客户端。
- 先访问普通网页，再按需检查DNS和目标连接；不要只凭托盘图标判断成功。
- 停止客户端后，检查系统代理是否恢复；如果没有恢复，手动检查Windows代理设置。
- 排查时只保留错误类型、更新时间、系统架构和配置格式等必要信息，不要公开完整订阅URL、token或个人数据。
如果你使用的是Clash YAML而不是sing-box JSON，可参考站内的Clash Verge Rev订阅导入与格式判断；这不是把Clash配置直接当作sing-box配置，而是换用匹配其格式的客户端流程。
常见问题
sing-box订阅可以直接粘贴到Windows客户端吗？
可以，但前提是链接返回的是客户端支持的sing-box配置格式。先确认内容是JSON配置，而不是Clash YAML、Base64节点列表、单节点URI或HTML错误页，再添加为Remote Profile并执行更新。
保存订阅后为什么没有节点？
保存只记录远程地址，不代表已经下载。请手动更新，并检查返回格式、订阅权限、token、网络连通性和订阅是否过期。
sing-box在Windows里一定有系统代理开关吗？
不一定。系统代理可能由配置中的mixed或HTTP入站的set_system_proxy字段控制，也可能由具体图形客户端实现；如果配置使用TUN，应检查TUN状态和权限。
为什么找不到Rule、Global、Direct？
这些是Clash模式相关名称，不是所有sing-box配置的通用菜单。只有配置启用了相关Clash API能力且客户端支持时，才可能出现对应选项。
TUN启动失败但订阅能更新，说明订阅坏了吗？
不一定。订阅下载和TUN启动是两个环节。优先检查管理员权限、虚拟网卡冲突、安全软件拦截，以及其他代理程序是否同时运行。
GUI.for.SingBox能不能照着官方sing-box for Desktop的步骤操作？
不建议完全照搬。GUI.for.SingBox是独立社区GUI，菜单和系统代理实现可能不同；本文的Remote Profile和配置格式判断可作概念参考，具体按钮应以该项目说明为准。
订阅链接泄露后应该怎么办？
立即回到提供订阅的面板撤销、重置或重新生成链接；如果面板没有该功能，联系提供方处理。不要继续公开使用已经泄露token的链接。