sing-box Windows 客户端配置教程:下载安装、导入配置与启动代理
简答:如果你在 Windows 上第一次配置 sing-box,优先使用官方 sing-box for Desktop:先确认系统架构,再从 GitHub Releases 下载对应安装包,导入 sing-box JSON 配置,启动后先用系统代理验证,确认浏览器能访问且客户端流量统计变化,再考虑 TUN。当前 Releases 页面显示的稳定 Latest 版本应以页面实时内容为准,本文核对时为 1.14.4,预发布版本不建议新手直接使用。
定义:sing-box Windows 客户端配置,是在 Windows 10 及以上系统中使用 sing-box for Desktop 管理本地或远程 JSON 配置,并通过系统代理或 TUN 让应用连接经过所选出站。
先看结论:Windows 新手应该下载什么
如果你的目标是在 Windows 上导入配置并启动代理,优先选择 sing-box for Desktop 桌面客户端,而不是先下载命令行核心或来路不明的第三方图形界面。项目文档将 Windows 客户端列为 sing-box for Desktop,并说明其支持管理本地或远程配置以及 TUN 透明代理;Windows 支持范围为 Windows 10 及以上,架构包括 x64、x86 和 arm64。
| 下载或使用方式 | 适合场景 | 新手建议 |
|---|---|---|
| SFW Windows 安装包 | 需要托盘、配置管理、系统代理或 TUN | 优先选择 |
| Windows ZIP 命令行核心 | 需要脚本启动、手动管理 JSON 或排查核心问题 | 有命令行经验再用 |
| 第三方 GUI | 依赖特定界面或额外功能 | 先核对项目来源、版本和配置兼容性 |
截至核对日期,GitHub Releases 页面把 1.14.4 标为 Latest,同时列出 1.15.0-alpha.13 等预发布版本。版本号和文件名会变化,下载前应以 sing-box Releases 页面当前显示为准,不要照抄旧教程中的固定版本。
下载安装:先确认 Windows 架构
- 按
Win+I打开“设置”,进入“系统”→“系统信息”或“关于”,查看“系统类型”。显示“基于 x64 的处理器”时下载 x64;显示 ARM 或 ARM64 时下载 arm64;如果系统是 32 位,则选择 x86。若系统信息和处理器信息不一致,以安装程序能否正常启动为最终判断。 - 打开 Releases 页面,选择稳定版本的 Windows 安装包。官方更新记录曾明确说明 Windows 客户端安装包采用类似
SFW-<version>-<architecture>.exe的命名方式,但当前具体文件名仍应以 Release 资产列表为准。 - 运行安装程序并完成安装。若 Windows SmartScreen 弹出提示,先核对文件来源、下载页面和文件名;不要因为无法确认来源就强行运行。安装后从开始菜单启动 sing-box for Desktop。
如果你选择 ZIP 命令行核心,解压后应能看到 sing-box.exe。在 PowerShell 中执行下面的命令确认版本:
.\sing-box.exe versionPowerShell 5.1 与 PowerShell 7.x 均可使用该命令;若提示找不到文件,请先用 cd 进入解压目录,或把命令中的路径改为 C:\path\to\sing-box.exe。版本输出可能包含构建信息,不要把订阅链接、密钥或完整配置粘贴到公开页面。
配置导入:远程 URL、本地 JSON 和其他格式要分开
sing-box 核心使用 JSON 配置格式,官方配置文档列出的顶层结构包括 log、dns、inbounds、outbounds 和 route 等字段。导入前先判断你手上的内容属于哪一种:
| 手上资料 | 能否直接按 sing-box 配置导入 | 处理方法 |
|---|---|---|
| sing-box JSON 文件 | 可以 | 在客户端添加本地配置,选择 JSON 文件 |
| 返回 JSON 的远程订阅 URL | 通常可以 | 添加远程配置,粘贴 URL,并按页面提示更新 |
| Clash YAML 文件 | 不能直接当作 sing-box JSON | 向配置提供方索取 sing-box 格式,或使用已核实的转换方案 |
| 单个节点分享链接 | 不能等同于完整配置 | 需要配置提供方给出完整 sing-box 配置或明确导入方式 |
导入远程配置 URL
- 打开客户端的配置或 Profiles 页面,选择添加远程配置。不同版本的按钮名称可能是“Add Remote”“添加远程”或相近文字,以当前界面为准。
- 粘贴订阅 URL,填写易识别的名称,保存后执行更新。
- 如果更新失败,先在浏览器中打开该 URL,观察是否能返回内容;不要把带令牌的完整 URL 发到群聊、工单或截图中。
导入本地 sing-box JSON
- 把配置文件保存到固定目录,例如
C:\Users\你的用户名\sing-box\profiles\config.json。 - 在客户端选择本地配置并打开该 JSON 文件。
- 若客户端拒绝加载,可先用命令行检查 JSON。进入核心目录后执行:
.\sing-box.exe check -c "C:\Users\你的用户名\sing-box\profiles\config.json"正常结果是命令返回成功且没有配置错误;异常结果通常会指出 JSON 语法、字段或配置结构问题。若命令提示无法识别参数、配置字段不兼容或版本不支持,请先查看当前版本文档,不要随意删除字段。
启动代理:先用系统代理,再决定是否启用 TUN
首次配置建议先选择系统代理验证,因为它影响范围较小,便于确认“配置能否运行、节点是否可用、浏览器是否使用代理”。在客户端启动配置后,打开系统代理开关或配置中提供的系统代理选项,再用浏览器访问一个你平时能稳定访问的页面。
| 模式 | 覆盖范围 | 适合第一次排查吗 | 注意事项 |
|---|---|---|---|
| 系统代理 | 遵守 Windows 代理设置的浏览器和应用 | 适合 | 部分应用不读取系统代理 |
| TUN | 通过虚拟网卡接管更广泛的流量 | 确认基础配置正常后再试 | 可能需要管理员权限,并可能影响本地网络、虚拟机或 DNS |
官方 TUN 文档说明,Windows 支持 TUN;启用 strict_route 时,Windows 上经过非 TUN 接口的 53 端口流量会被阻止,同时可能影响部分依赖特殊网络路径的应用。因此,不要把 TUN 当作所有问题的第一步。先关闭其他代理软件,启动系统代理并验证;系统代理有效但目标应用不走代理时,再考虑 TUN。
- 系统代理验证:启动配置后打开客户端状态页,确认服务运行;检查 Windows“设置”中的代理是否出现对应本地代理;浏览器访问测试页面。
- TUN 验证:以管理员身份启动或按客户端提示授权,启用 TUN;观察 Windows 网络适配器是否出现虚拟接口,并查看客户端日志是否出现启动成功信息。
- 停止验证:关闭客户端后,确认系统代理恢复原状态;若关闭后仍无法联网,进入 Windows 代理设置手动检查并关闭残留代理。
官方文档还说明,TUN 的 stack 字段在 1.15.0 已标记为 deprecated,将使用 sing-tun 自有 TCP/IP 栈。因此不要照抄旧教程,把 system、gvisor 或 mixed 当成当前 Windows 的默认推荐值;当前配置是否需要这些字段,应以所用版本文档和实际配置为准。
启动后怎么判断真的连通
- 正常:客户端状态显示服务正在运行,日志没有持续的配置解析或拨号错误,浏览器能够打开目标页面,客户端流量统计随访问增加。
- 异常:客户端一启动就退出、配置列表为空、日志持续报 JSON 解析错误、浏览器完全无响应,或只有部分应用有效。
若需要进一步确认,可在 PowerShell 中检查系统代理状态:
Get-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings' | Select-Object ProxyEnable,ProxyServerProxyEnable 为启用状态且 ProxyServer 指向客户端监听地址时,说明 Windows 系统代理已设置;这不等于每个应用都会使用它。也可以执行:
curl.exe -I https://example.com如果该命令失败,不要立即判断节点失效:先确认系统代理是否被 curl 使用、目标地址是否可访问,以及客户端日志是否有对应连接记录。测试订阅 URL 或配置文件时,注意命令窗口可能显示令牌、用户名或密码,复制日志前请先遮盖敏感内容。
常见失败阶段与处理顺序
- 下载阶段失败:确认访问的是 Releases 页面,重新核对 Windows 架构和文件名;不要混用 Android、Linux 或 macOS 文件。
- 配置导入失败:检查返回内容是不是 JSON。若打开 URL 后得到 HTML 登录页、空内容或 YAML,说明它不是可直接导入的 sing-box JSON,需向配置提供方核实格式。
- 配置解析失败:使用
sing-box check -c 配置路径检查;正常是检查通过,异常则根据错误行号或字段名修正。没有错误原文时,不要凭猜测增加字段。 - 服务启动失败:查看客户端日志入口,重点区分端口占用、权限不足、TUN 初始化失败和出站拨号失败。可先关闭其他代理客户端,再只启动 sing-box 做对照测试。
- 代理运行但页面打不开:先关闭 TUN,改用系统代理;检查浏览器代理设置、DNS 错误和节点选择。若只有某个应用失败,确认该应用是否遵守 Windows 系统代理。
日志等级方面,配置文档列出 trace、debug、info、warn、error、fatal 和 panic。排查时可短时间提高日志等级,复现问题后恢复,避免长期记录过多敏感连接信息。
安全提醒与更新方法
远程配置 URL 往往包含可识别账号或访问令牌,完整配置中也可能出现节点密码、私钥或服务器信息。保存文件时使用本地固定目录即可,不要把完整 URL、JSON、日志和截图上传到公开平台。自查方法是:发布前搜索文本中的 token、password、uuid、private_key 等字段,并遮盖 URL 查询参数。
更新时先打开 当前 Releases 页面查看稳定版本、预发布标记和资产架构,再更新客户端。更新前备份本地 JSON;更新后重新执行 sing-box.exe version 和 sing-box.exe check -c 配置路径。如果版本升级后出现新字段报错,应以当前版本迁移说明和配置文档为准,不能仅凭旧教程判断配置一定错误。
本站为第三方使用指南,内容用于客户端安装、配置和连接排查,不代表任何软件项目的官方网站。
常见问题
sing-box Windows 应该下载哪个版本?
优先选择 Releases 页面标为 Latest 的稳定版本和对应 Windows 架构安装包。本文核对时页面将 1.14.4 标为 Latest,但版本会变化,应以当前页面为准;1.15.0-alpha.13 等预发布版本不建议新手直接使用。
Clash YAML 可以直接导入 sing-box Windows 客户端吗?
不能把 Clash YAML 直接当作 sing-box JSON 导入。sing-box 官方配置文档使用 JSON;如果手里只有 YAML,应向配置提供方索取 sing-box 格式,或使用已核实且可信的转换方案。
sing-box Windows TUN 启动失败怎么办?
先关闭其他代理软件,确认客户端具备所需权限,再暂时改用系统代理验证配置和节点。若系统代理正常而 TUN 失败,再查看日志中的权限、虚拟网卡、路由或端口错误,不要直接修改未经核实的 TUN 字段。
怎么确认 sing-box 已经连接成功?
同时检查三点:客户端状态显示运行中,日志没有持续的解析或拨号错误,浏览器访问时流量统计发生变化。仅看到客户端窗口打开,不能证明应用流量已经经过代理。
sing-box 配置文件检查命令是什么?
在 Windows ZIP 核心所在目录执行 <code>.\sing-box.exe check -c "配置文件完整路径"</code>。命令成功返回且没有配置错误表示基础检查通过;若提示字段或格式错误,应根据当前版本文档处理。