sing-box Windows 怎么用？桌面版、CLI 与 x64/ARM64 安装配置

更新于 2026-11-09 · amytelecom.top

简答：sing-box 在 Windows 上主要有两条路线：需要图形界面、配置管理或 TUN 的用户选择 sing-box for Desktop；只想运行核心、脚本化管理或后台运行的用户选择 CLI。先在 Windows“设置”→“系统”→“关于”确认系统架构，再从官方 Releases 页面选择对应构建。首次使用建议先导入一份有效的 sing-box JSON 配置，用系统代理验证连接，确认基础功能正常后再考虑 TUN。

定义：sing-box Windows 是在 Windows 系统上运行 sing-box 核心或桌面客户端的使用方式，其中 Desktop 负责图形化配置管理，CLI 通过命令行加载配置并运行核心。

先用 30 秒选对路线：Desktop 还是 CLI？

本文是边界云加速的第三方使用指南，不是 sing-box 官方页面。官方资料将 Windows 图形客户端列为 sing-box for Desktop，并说明它可以管理和运行本地或远程 sing-box 配置，同时提供包括 TUN 透明代理在内的平台功能；官方列出的 Windows 要求为 Windows 10 及以上，支持 x64、x86 和 arm64。可先查看sing-box for Desktop 官方说明。

你的需求	优先选择	先做什么
需要窗口、配置列表、系统代理或 TUN	sing-box for Desktop	确认 Windows 版本和系统架构，再下载对应桌面构建
只想运行核心、脚本或后台任务	Windows CLI	下载 CLI 构建或使用包管理器安装，然后用配置文件启动
普通 Intel 或 AMD 电脑	通常选择 x64	仍以“系统类型”和官方发布页资产名称为准
Windows ARM 设备	选择 arm64	在系统信息中确认是否为 ARM64

最短决策路径是：需要 GUI 或 TUN 就看 Desktop；只运行核心就看 CLI；普通 Intel/AMD 设备先查 x64；ARM 设备查 arm64。官方图形客户端列表还特别区分了项目维护的图形客户端与未列出的第三方项目，因此不要仅凭“支持 sing-box”字样判断下载来源，可参考官方图形客户端列表。

Windows 怎么查看 x64、x86 或 ARM64？

打开 Windows“设置”，进入“系统”→“关于”。
在“设备规格”或“系统类型”附近查看处理器和系统架构信息。
如果界面信息不清楚，按 Win+R，输入 msinfo32，打开“系统信息”查看“系统类型”。
根据结果选择：显示 x64 或基于 x64 的系统，选择 x64；显示 ARM64，选择 arm64；只有明确使用 32 位 Windows 时才考虑 x86。

下载前要同时确认两件事：文件属于 Desktop 还是 CLI，以及架构属于 x64、x86 还是 arm64。不能只看“Windows”几个字，也不能把 CLI 压缩包当成桌面安装程序。若系统类型与发布页资产名称对应不上，应回到发布说明核对，而不是随机尝试多个文件。

官方下载与安装：如何识别 Desktop、CLI 和版本类型？

打开SagerNet/sing-box 官方 Releases 页面，不要从搜索结果中的不明下载站替代发布页。
先看页面顶部的版本标签和发布类型，区分当前标记为 Latest 的版本与标记为 Pre-release 的预发布版本。
展开对应版本的 Assets，结合文件名判断平台、架构和用途。资产名称可能随版本变化，本文不把某个具体压缩包文件名写死。
如果目标是图形界面，优先寻找与 Desktop 对应的 Windows 构建；如果目标是命令行运行，寻找 Windows CLI 构建。无法确认时，以发布说明和官方 Desktop 页面中的下载入口为准。
下载后先保留原始文件，检查浏览器下载地址、文件名和发布页面是否一致，再解压或启动。不要把关闭 Defender、清除系统安全标记或强制放行作为默认安装步骤。

截至 2026-11-09，官方 Releases 页面同时展示稳定发布和预发布条目；版本会变化，因此发布时应重新查看页面当前标记为 Latest 的版本。日常使用优先从 Latest 开始，只有明确需要测试功能且确认配置兼容时，才考虑 Pre-release。

如果你已有配置，升级前先复制配置文件和记录当前代理开关；如果是新用户，没有默认配置也不必寻找所谓“原配置”，直接把准备使用的 JSON 文件复制一份作为备份即可。

Desktop 首次启动：从配置文件到系统代理的可执行流程

官方 Desktop 文档确认它支持管理和运行本地或远程配置，但当前公开页面没有固定列出所有 Windows 版本通用的菜单路径。不同构建的按钮名称可能不同，因此以下流程按功能顺序操作，看到“Profiles、Profiles/配置、Dashboard、Service、System Proxy、TUN”等相近名称时，以当前界面为准。

启动程序：运行下载的 Desktop 文件或安装完成后的快捷方式。如果 Windows 弹出来源或权限提示，先核对文件是否来自官方 Releases 页面。
添加本地 JSON：在配置或 Profiles 区域选择添加本地配置、打开文件或导入配置之类的入口，选中准备好的 .json 文件。导入前不要直接修改唯一原文件，先复制一份。
添加远程配置：在同一配置管理区域寻找添加 Remote Profile、远程配置或 URL 的入口，粘贴配置地址并保存。远程地址应返回 sing-box 配置内容，而不是登录页、HTML 错误页或普通文本说明。
选中配置并启动：导入后先选中目标配置，再使用启动、运行或服务开关。若出现字段错误，先停止服务，记录错误字段，再对照当前配置文档修正。
启用系统代理：在 Dashboard 或运行状态区域寻找 System Proxy、系统代理或类似开关。启用后，用一个明确遵循 Windows 代理设置的应用测试；若目标应用不读取系统代理，不要据此判断核心一定失效。
确认成功：查看状态、日志或连接列表是否出现运行中的服务，再测试一个普通网页或应用。连接成功、DNS 解析和目标内容可用是不同结果，应分别判断。

如果当前版本没有清晰的图形入口，先使用 CLI 校验配置并确认核心可运行，再回到 Desktop 检查配置导入。不要在系统代理、TUN、DNS 和路由上同时修改多个变量。

CLI 安装、解压与指定配置启动

官方包管理器页面列出了 Windows 的 Scoop、Chocolatey 和 winget 安装方式。它们对应的是 sing-box 核心安装路线，不应理解为会自动安装带窗口的 Desktop 客户端，可参考官方包管理器说明。

scoop install sing-box
choco install sing-box
winget install sing-box

使用包管理器前，先确认对应包管理器已安装并能正常工作。安装完成后重新打开 PowerShell，执行：

sing-box version

如果提示找不到命令，先重新打开终端，再检查包管理器的安装结果和 PATH。包管理器同步版本可能与 GitHub Releases 的发布时间不同，因此发现版本不一致时，应同时查看包管理器显示的版本和官方发布页，不要直接判定安装失败。

如果你下载的是 CLI 压缩包，可按以下顺序处理：

新建一个专用目录，例如 C:\sing-box，避免把程序和下载目录混在一起。
将压缩包解压到该目录，确认目录内存在 sing-box 可执行文件及其随包提供的依赖文件。
把配置文件复制到同一目录或记录其完整路径，例如 C:\sing-box\config.json。
在 PowerShell 中切换到程序目录，先校验配置，再启动：

cd C:\sing-box

.\sing-box.exe check -c .\config.json

.\sing-box.exe run -c .\config.json

官方配置文档说明 sing-box 使用 JSON 配置，并提供 check 和 format 命令；可查看配置文件说明。如果你的当前构建不接受某个命令参数，应以该版本运行 sing-box help 和官方文档为准。终端保持运行时，关闭窗口通常也会停止前台运行的核心。

配置导入失败：先验证格式、返回内容和版本兼容性

sing-box 配置不是“把其他客户端文件改成 .json”就能使用的通用格式。官方配置文档列出 JSON 配置结构，官方还提供与当前构建相关的 JSON Schema，说明见JSON Schema 文档。

本地文件：确认文件确实是 JSON，检查缺少引号、多余逗号、乱码和截断内容。
远程 URL：确认返回的是配置 JSON，而不是网页登录页、HTML、错误提示或需要额外认证的内容。
来源格式：确认它是 sing-box 配置，而不是其他客户端的 YAML、URI 列表或专用订阅格式。
版本兼容：如果日志指出未知字段、字段类型错误或已废弃选项，对照当前版本文档逐项修改，不要一次替换整份配置。
敏感信息：配置可能包含服务器地址、令牌、用户名、密码或远程订阅地址。分享日志、截图和配置前应脱敏。

最稳妥的验证顺序是：先运行 sing-box check -c config.json，再启动核心；如果校验通过但连接仍失败，再区分入站、出站、DNS、路由和目标服务问题。

系统代理与 TUN：先用低风险方式确认基础连通性

方式	适用范围	先检查什么
系统代理	主要影响会读取 Windows 代理设置的应用	代理开关、入站端口、应用是否遵循系统代理
TUN	通过虚拟网络接口处理更广泛的系统流量	配置中的 TUN 入站、权限、虚拟网卡、路由和 DNS

官方 Desktop 页面确认其提供 TUN 透明代理能力，但公开页面没有承诺所有配置导入后都能自动启用 TUN。建议先导入配置并使用系统代理验证核心和节点连通性，再根据确切需求启用 TUN。

保存当前配置，并记录 Windows 原有代理状态。
关闭其他可能创建虚拟网卡或接管代理的网络软件，减少变量。
在当前 Desktop 配置或 Dashboard 中找到 TUN 相关开关，确认配置本身包含可用的 TUN 入站；没有对应配置时，仅打开界面开关可能不会产生预期效果。
如系统弹出网络权限提示，先核对程序来源和操作范围，再决定是否允许。
启动后查看日志和 Windows 网络适配器状态；若出现权限不足、网卡创建失败、路由冲突或 DNS 异常，先关闭 TUN，回退到系统代理。

不要把固定 DNS、固定 MTU、删除虚拟网卡或强行提权当作通用解法。TUN 问题应按日志提示逐项验证，修改前保留原配置和系统代理状态，方便回滚。

连接失败时的排查顺序：现象→检查→处理→回滚

程序无法启动：先检查 Windows 架构和 Desktop/CLI 类型是否匹配；重新从官方 Releases 下载。若仍失败，保留错误提示，不要先关闭系统安全防护。
配置无法导入：先运行 sing-box check，确认 JSON 语法、返回内容和配置格式；修正后重新导入。
核心启动报字段错误：记录字段名、错误位置和版本，按当前配置文档修改；不要把其他客户端配置直接改名使用。
系统代理开启但浏览器无变化：确认系统代理状态和端口，再确认浏览器或目标应用是否读取 Windows 代理；必要时先用 CLI 日志确认核心是否在运行。
TUN 启动失败：先关闭 TUN，检查虚拟网卡、权限、路由和防火墙相关日志，再决定是否恢复 TUN。
连接成功但网页打不开：分别检查节点连接、DNS 解析、路由命中和目标内容可用性，不要直接修改 MTU 或 DNS。

每次只改一个变量，并记录修改前后的结果。如果改动后问题扩大，停止核心、关闭 TUN、恢复原系统代理和备份配置，再重新测试。

常见问题

sing-box Windows 应该下载 Desktop 还是 CLI？

需要图形界面、配置管理、系统代理或 TUN 时，优先选择 sing-box for Desktop；只想运行核心、脚本或后台任务时选择 CLI。官方包管理器命令属于核心安装路线，不应理解为自动安装桌面 GUI。

Windows 11 的 sing-box 应该选 x64 还是 arm64？

不要只按 Windows 11 判断。打开“设置”→“系统”→“关于”，或运行 msinfo32 查看系统类型；普通 Intel/AMD 电脑通常对应 x64，ARM 设备对应 arm64，具体仍以官方 Releases 页面资产名称为准。

sing-box Windows 怎么导入本地 JSON？

启动 Desktop 后，在配置或 Profiles 区域寻找添加本地配置、打开文件或导入配置等入口，选择有效的 sing-box JSON。不同版本菜单名称可能不同；如果无法确认界面路径，可先用 CLI 执行 sing-box check -c config.json 验证文件。

远程配置 URL 导入失败，最先检查什么？

先确认 URL 返回的是 sing-box JSON，而不是登录页面、HTML 错误页或其他客户端格式；再用当前核心校验配置字段。不要把普通订阅地址仅改名为 JSON 后直接导入。

系统代理和 TUN 有什么区别？

系统代理主要影响遵循 Windows 代理设置的应用；TUN 通过虚拟网络接口处理更广泛的系统流量，但还取决于 TUN 配置、权限、虚拟网卡、路由和 DNS。建议先用系统代理验证基础连通性，再考虑 TUN。

包管理器安装的 sing-box 与官方 Releases 版本不一致怎么办？

先分别记录包管理器显示的版本和官方 Releases 当前版本，确认是否只是同步延迟或发布渠道不同。不要直接覆盖现有程序；如需切换，先备份配置并保留原程序，按照当前安装来源的卸载或回滚方式处理。