sing-box Windows 客户端怎么导入订阅?
简答:先确认你安装的是 sing-box for Desktop,而不是只有命令行内核的 Windows 压缩包;再确认订阅返回的是 sing-box JSON 或客户端明确支持的远程配置。当前官方资料没有公开一套长期固定的 Windows 按钮路径,因此本文不虚构菜单名称,而是用可观察的页面功能、格式特征和成功标志完成导入。
定义:sing-box Windows 订阅导入,是把服务提供方生成的远程配置地址添加到 Windows 图形客户端,由客户端拉取配置、解析出站并运行配置。
先看三步速查:确认客户端、检查格式、再添加远程配置
如果你现在只想尽快完成导入,按这张速查卡操作。每一步都配有成功标志,避免只看到“链接能打开”就误以为导入成功。
| 步骤 | 怎么判断 | 成功标志 |
|---|---|---|
| 1. 确认客户端 | 查看窗口标题、安装包名称和来源。官方资料将 sing-box for Desktop 定位为 Windows 图形客户端;普通 sing-box Windows 压缩包属于命令行核心,不要混用。 | 客户端能打开图形界面,并能看到配置、服务状态或设置等管理功能。 |
| 2. 检查订阅格式 | 把链接放入浏览器访问,查看返回内容开头。以 { 开头且能看到 outbounds 等配置字段,才更接近 sing-box JSON;如果返回的是 HTML 登录页、错误页或单节点 URI,就不能当作完整远程配置。 | 返回内容不是登录页,且结构与 sing-box 配置相符。 |
| 3. 添加并更新 | 在客户端中寻找配置管理、配置文件、Profiles、远程配置或添加 URL 等含义相近的功能。不同构建版本的菜单文字未在官方文档中固定说明。 | 配置列表出现名称、更新时间或可用出站,且更新操作没有解析错误。 |
官方变更记录说明,sing-box for Desktop 面向 Windows 10 及以上,并提供 x64、x86、arm64 架构版本,安装包从 GitHub Releases 分发。官方仓库 README 同时将该项目描述为实验性 Windows 客户端,因此版本升级后按钮和页面布局可能变化。请查看官方变更记录与官方桌面客户端仓库。
安装前先分清:官方桌面客户端、裸核压缩包和第三方 GUI
| 类型 | 能否直接照本文操作 | 识别方式 |
|---|---|---|
| sing-box for Desktop | 可以作为本文主要示例,但必须以当前版本界面为准。 | 安装后是图形客户端;官方资料称其为 Windows 图形客户端,仓库说明仍标注为实验性项目。 |
| sing-box Windows 核心压缩包 | 不能直接套用图形界面步骤。 | 通常只有可执行文件和配置文件,没有配置列表、按钮或系统代理界面。官方配置文档说明 sing-box 使用 JSON 配置。 |
| 第三方 GUI | 不能把菜单、内核下载方式和格式兼容性套到官方客户端。 | 客户端名称、仓库和安装包与官方桌面仓库不一致。 |
关于内核问题要特别谨慎:官方桌面仓库的构建配置显示 Windows 安装包会打包桌面守护进程相关文件,但当前公开资料没有给出“首次启动必须手动下载内核”的统一用户操作说明。因此,安装后若没有单独的内核下载提示,不要再照第三方 GUI 教程额外替换文件;若客户端明确提示缺少组件,应以当前版本界面和仓库说明为准。
下载时不要把核心项目的 Releases 页面误当成桌面客户端安装包页面。官方变更记录只确认桌面客户端从 GitHub Releases 分发,具体安装包名称、版本号和架构应以当前发布页显示为准,本文不固定写死版本。
订阅格式怎么判定:浏览器能打开不等于客户端能导入
订阅格式是最容易卡住的地方。建议先复制链接,在浏览器中访问一次;不要登录账号后复制浏览器地址栏,而要从服务面板复制明确标注为订阅、远程配置或 sing-box 的地址。
| 返回内容 | 可观察特征 | 处理方式 |
|---|---|---|
| sing-box JSON | 文本通常以 { 开头,能看到 JSON 字段;完整配置常见顶层结构包括 outbounds、route、dns 等。 | 优先添加到远程配置或配置文件入口。官方文档说明 sing-box 配置采用 JSON。 |
| HTML 登录页或错误页 | 开头常见为 <!DOCTYPE html>、<html>,或显示登录、过期、无权限等文字。 | 不能导入。回到提供方面板重新复制订阅地址,确认链接没有被截断。 |
| 单节点 URI | 以某种协议前缀开头,只描述一个节点,不是完整配置。 | 只有客户端明确提供单节点导入时才使用;不要粘贴到远程配置 URL 输入框。 |
| Clash YAML 或通用订阅 | 返回内容是 YAML,或同一链接根据客户端类型返回不同格式。 | 不要默认兼容。优先在面板选择 sing-box 格式,或向提供方索取适配当前客户端的配置。 |
检查响应时,不要只看浏览器“能不能打开”。如果页面显示一段 JSON,建议用文本方式查看前几行;如果浏览器直接下载文件,也可以用记事本打开副本确认开头是否为 JSON。不要把带账号令牌的完整链接发到公开平台。
Windows 上添加远程订阅:按功能名称找,不照抄不存在的按钮
- 启动客户端并确认服务处于停止状态。首次导入时先不要开启系统代理或 TUN,避免解析失败时把系统网络一起影响。
- 打开配置管理区域。在当前界面寻找“配置”“配置文件”“Profiles”“远程配置”“Remote profile”“添加 URL”或类似含义的入口。官方公开页面没有固定公布每个版本的中文菜单层级,因此不能保证所有版本都出现同样的按钮。
- 选择添加远程配置。如果界面同时提供本地文件、剪贴板和远程地址,选择远程地址或 URL,而不是把订阅链接当作本地 JSON 文件上传。
- 填写名称和 URL。名称可以写成便于识别的文字;URL 粘贴完整订阅地址。不要填写网页登录地址,也不要把带空格、换行或被截断的链接保存进去。
- 保存后执行更新。寻找“保存”“添加”“更新”“刷新”或含义相近的动作。成功标志应至少包括配置条目出现、更新时间变化、出站或节点列表不为空三项中的一项;只有弹出“已保存”不能证明配置可运行。
- 选中配置并启动服务。配置条目需要处于启用、选中或当前配置状态,然后再点击启动或运行。若客户端同时显示服务开关和配置开关,先确认配置已选中,再启动服务。
- 先开系统代理,最后再测 TUN。系统代理排查范围更小。确认浏览器或目标应用正常后,再根据当前客户端是否提供 TUN 开关和权限提示决定是否启用。
成功判定:配置列表有更新时间,节点或出站列表不为空,服务状态显示运行中,系统代理开启后目标应用能建立连接。若只完成了 URL 保存但没有节点或日志仍报解析错误,不算导入完成。
导入后怎么刷新、选节点和回滚
- 刷新订阅:在配置条目旁寻找更新、刷新或重新拉取动作。刷新只是重新获取远程内容,不代表服务已经启动;更新后仍要重新确认当前配置和节点列表。
- 选择节点:如果界面显示出站组、选择器、节点组或类似列表,先选一个具体出站,再启动服务。若只有一个默认出站,不要为了“切换节点”修改 JSON 配置。
- 确认当前配置:多个配置同时存在时,检查当前标记、勾选状态或配置名称,避免更新了 A 配置却启动 B 配置。
- 回滚:启动后出现断网,先停止服务、关闭 TUN、关闭系统代理,再退出其他网络代理软件。恢复普通直连后,只重新测试订阅更新,不要同时修改 DNS、MTU 和路由。
官方配置文档说明 sing-box 配置包含 DNS、路由和出站等结构;因此“节点存在”与“规则、DNS、系统代理均正常”是不同层次的问题。排查时一次只改一个变量,更容易定位原因。可参考官方配置结构说明。
按现象排查:解析失败、没有节点、内核提示和启动后没网
| 现象 | 先检查什么 | 下一步 |
|---|---|---|
| 解析失败、JSON 错误 | 返回是否为 JSON、链接是否完整、是否误复制登录页。 | 重新复制 sing-box 格式链接;把返回内容前几行与客户端日志对照。 |
| 配置成功但没有节点 | 当前配置是否选中、远程更新是否完成、返回内容是否为空。 | 手动更新一次;确认出站列表;仍为空时向订阅提供方核对格式和有效期。 |
| 提示缺少内核或组件 | 是否安装了官方桌面客户端,还是只下载了核心 ZIP。 | 回到官方桌面仓库和当前发布页核对安装包;不要把第三方 GUI 的内核文件覆盖到官方客户端目录。 |
| 启动后全局没网 | TUN 权限、系统代理残留、其他代理软件和防火墙提示。 | 停止服务,关闭 TUN 和系统代理,退出其他代理软件后复测。 |
| 浏览器能用但某个应用不能用 | 该应用是否读取 Windows 系统代理,以及规则是否将其直连。 | 先保持系统代理模式;不要马上修改 MTU、DNS 或复杂路由。 |
Windows 7 不要直接套用本文。官方变更记录列出的桌面客户端范围是 Windows 10 及以上;Windows 7 的兼容性在本次检索资料中未核实。当前日期为 2026 年 11 月 3 日,版本、安装包和菜单仍应以发布时的官方页面为准。
安全提醒与常见问题
订阅链接为什么不能公开发出来?
订阅地址可能包含账户令牌或可识别凭据。排查时只提供打码后的域名、错误类型和无凭据日志;如果链接已经公开,应按提供方支持的方式更换或重新生成。
sing-box for Desktop 是否一定要手动安装内核?
本次检索到的官方资料没有给出统一的“首次启动手动安装内核”步骤。官方桌面仓库的构建配置显示 Windows 包含桌面守护进程相关文件,因此不要把裸核教程直接套用;如果当前版本明确弹出组件提示,以该版本界面和仓库说明为准。
为什么不能给出固定的“配置→远程配置→添加”菜单路径?
官方仓库 README 和变更记录确认了客户端定位、系统范围和发布方式,但没有公开一套固定的 Windows 中文按钮文档。为了避免把其他 GUI 的界面冒充成官方客户端,本文只给出功能名称和可观察成功标志;实际菜单以当前安装版本为准。
Windows 10、11 应该下载哪个架构?
普通 Intel 或 AMD 64 位电脑通常对应 x64;ARM Windows 设备对应 arm64;x86 设备对应 x86。官方变更记录确认桌面客户端提供这三类架构,但具体安装包文件名以当前 GitHub Releases 页面为准。
导入后要不要立即开启 TUN?
不建议。先用系统代理验证配置、节点和基础连接,再按需测试 TUN。出现全局断网时,先关闭 TUN 并恢复系统代理,确认问题是否来自接管范围或权限。
只有 Clash YAML,没有 sing-box 订阅怎么办?
不要默认兼容。先查看提供方是否能生成 sing-box JSON 或远程配置;若必须使用转换服务,只选择你信任且了解数据处理方式的服务,不要把包含账号令牌的订阅链接提交给不明来源的平台。
常见问题
sing-box for Desktop 是否一定要手动安装内核?
本次检索到的官方资料没有给出统一的手动安装步骤。不要把第三方 GUI 教程套用到官方客户端;如果当前版本提示缺少组件,以当前界面和官方仓库说明为准。
为什么订阅链接能打开,导入后却没有节点?
浏览器能打开只说明 URL 返回了内容,可能是 HTML 登录页、空配置或不兼容格式。检查返回内容开头、当前配置是否选中,以及客户端日志。
Windows 7 能不能安装 sing-box for Desktop?
官方变更记录列出的桌面客户端范围是 Windows 10 及以上,Windows 7 兼容性未核实,不要直接套用本文步骤。
Clash YAML 可以直接导入 sing-box Windows 客户端吗?
不能默认可以。优先获取 sing-box JSON 或远程配置;只有当前客户端明确支持该格式时才尝试导入。
导入后要不要马上开启 TUN?
不建议。先用系统代理完成基础连通性测试,再按需启用 TUN,出现断网时也更容易回滚。
订阅链接能否发给别人帮忙排查?
不要公开发送完整链接。订阅地址可能包含账户令牌,应打码或只提供无凭据的日志和错误信息。