天际网络返回首页

sing-box Windows 客户端配置教程:下载安装、导入配置与启动代理

更新于 2026-11-16 · v2rocket.buzz

简答:如果你在 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 架构

  1. 按 Win+I 打开“设置”,进入“系统”→“系统信息”或“关于”,查看“系统类型”。显示“基于 x64 的处理器”时下载 x64;显示 ARM 或 ARM64 时下载 arm64;如果系统是 32 位,则选择 x86。若系统信息和处理器信息不一致,以安装程序能否正常启动为最终判断。
  2. 打开 Releases 页面,选择稳定版本的 Windows 安装包。官方更新记录曾明确说明 Windows 客户端安装包采用类似 SFW-<version>-<architecture>.exe 的命名方式,但当前具体文件名仍应以 Release 资产列表为准。
  3. 运行安装程序并完成安装。若 Windows SmartScreen 弹出提示,先核对文件来源、下载页面和文件名;不要因为无法确认来源就强行运行。安装后从开始菜单启动 sing-box for Desktop。

如果你选择 ZIP 命令行核心,解压后应能看到 sing-box.exe。在 PowerShell 中执行下面的命令确认版本:

.\sing-box.exe version

PowerShell 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

  1. 打开客户端的配置或 Profiles 页面,选择添加远程配置。不同版本的按钮名称可能是“Add Remote”“添加远程”或相近文字,以当前界面为准。
  2. 粘贴订阅 URL,填写易识别的名称,保存后执行更新。
  3. 如果更新失败,先在浏览器中打开该 URL,观察是否能返回内容;不要把带令牌的完整 URL 发到群聊、工单或截图中。

导入本地 sing-box JSON

  1. 把配置文件保存到固定目录,例如 C:\Users\你的用户名\sing-box\profiles\config.json。
  2. 在客户端选择本地配置并打开该 JSON 文件。
  3. 若客户端拒绝加载,可先用命令行检查 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。

  1. 系统代理验证:启动配置后打开客户端状态页,确认服务运行;检查 Windows“设置”中的代理是否出现对应本地代理;浏览器访问测试页面。
  2. TUN 验证:以管理员身份启动或按客户端提示授权,启用 TUN;观察 Windows 网络适配器是否出现虚拟接口,并查看客户端日志是否出现启动成功信息。
  3. 停止验证:关闭客户端后,确认系统代理恢复原状态;若关闭后仍无法联网,进入 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,ProxyServer

ProxyEnable 为启用状态且 ProxyServer 指向客户端监听地址时,说明 Windows 系统代理已设置;这不等于每个应用都会使用它。也可以执行:

curl.exe -I https://example.com

如果该命令失败,不要立即判断节点失效:先确认系统代理是否被 curl 使用、目标地址是否可访问,以及客户端日志是否有对应连接记录。测试订阅 URL 或配置文件时,注意命令窗口可能显示令牌、用户名或密码,复制日志前请先遮盖敏感内容。

常见失败阶段与处理顺序

  1. 下载阶段失败:确认访问的是 Releases 页面,重新核对 Windows 架构和文件名;不要混用 Android、Linux 或 macOS 文件。
  2. 配置导入失败:检查返回内容是不是 JSON。若打开 URL 后得到 HTML 登录页、空内容或 YAML,说明它不是可直接导入的 sing-box JSON,需向配置提供方核实格式。
  3. 配置解析失败:使用 sing-box check -c 配置路径 检查;正常是检查通过,异常则根据错误行号或字段名修正。没有错误原文时,不要凭猜测增加字段。
  4. 服务启动失败:查看客户端日志入口,重点区分端口占用、权限不足、TUN 初始化失败和出站拨号失败。可先关闭其他代理客户端,再只启动 sing-box 做对照测试。
  5. 代理运行但页面打不开:先关闭 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>。命令成功返回且没有配置错误表示基础检查通过;若提示字段或格式错误,应根据当前版本文档处理。

相关阅读

参考资料

  1. sing-box for Desktop:Windows 支持范围与桌面客户端定位
  2. sing-box 图形客户端列表与第三方项目说明
  3. sing-box GitHub Releases:稳定版、预发布版与下载资产
  4. sing-box 配置格式与 check、format、merge 命令
  5. sing-box TUN 配置、Windows 路由与 DNS 行为
  6. sing-box 日志字段与日志等级