sing-box Windows 官方 GUI 教程:下载安装、导入配置与连接

版本说明:本文配图来自 Windows 版 sing-box 1.14.2 简体中文界面,下载文件与截图版本一致,核对日期为 2026-09-27。截图展示配置、启动、分组和设置界面;安装器、本地配置编辑器及模式切换界面未包含在本次素材中。

sing-box 现已提供适用于 Windows 的官方图形客户端 sing-box for Desktop,Windows 安装包名称以 SFW 开头。本文说明如何选择安装包、准备兼容配置并启动连接。若你安装的是第三方 GUI for SingBox,请查看 GUI for SingBox 使用教程,两款客户端的界面和操作流程不同。

一、确认系统与下载文件

官方 Windows GUI 要求 Windows 10 或更新版本,提供 x64、x86 和 ARM64 安装包。在 Windows 的“设置 → 系统 → 关于”中查看系统类型:常见 Intel/AMD 64 位系统选 x64,32 位系统选 x86,ARM64 系统选 ARM64。截图中的应用版本为 1.14.2;图片本身不能确认 Windows 的具体版本和架构。

SFW 1.14.2 — x64(Intel/AMD 64 位) 官方安装包

SFW 1.14.2 — x86(32 位) 官方安装包

SFW 1.14.2 — ARM64 官方安装包

上面是固定的 1.14.2 文件。其他版本请从 官方 Desktop 下载说明进入对应 Release,检查是否为正式版。以 sing-box-…-windows-….zip 命名的是命令行内核包;希望使用本文界面的用户应选择 SFW 的 EXE 安装程序。

二、安装并首次启动

运行从官方 Release 下载的 SFW 安装程序,按安装器提示完成安装,然后打开应用。出现系统权限提示时,先核对文件来源。首次打开后,左侧显示“仪表、日志、工具、设置”,左上角可见版本号;没有添加配置时,仪表页的“配置”卡片显示“无配置”。

官方 Windows 客户端通过系统服务运行 sing-box 内核,官方说明日常使用不需要每次请求管理员提权。安装阶段的权限提示与日常启动是两件事,不应把“始终以管理员身份运行”当成必需步骤。

sing-box 1.14.2 Windows 初始仪表界面
初次打开仪表页,配置区域显示“无配置”。

三、准备可以导入的 sing-box 配置

客户端负责读取配置并运行代理服务。开始前需要准备兼容当前版本的 sing-box 配置文件,或能够返回该配置的远程地址。只有安装程序而没有有效配置,不能直接建立所需连接。

本地配置适合已保存到电脑上的配置文件;远程配置使用 URL 下载配置,方便后续刷新。请先确认服务提供方提供的是 sing-box 格式,不能仅凭链接里含有“订阅”就判断兼容。

Clash YAML、Base64 节点列表、单个节点分享链接与完整 sing-box 配置并不相同。如果只有其他格式,优先向提供方获取兼容的 sing-box 配置;不要把私有订阅地址随意提交给不熟悉的在线转换站。旧配置启动失败时,还应核对 官方配置迁移说明。

四、添加远程配置或本地配置

添加远程配置:在“仪表”页找到“配置”卡片,点击右上角的 +。在“新建配置”窗口填写便于辨认的名称,将“类型”设为“远程”,在 URL 输入框粘贴完整的 sing-box 配置地址。按需开启“自动更新”并设置间隔,再点击右下角“创建”。官方文档说明默认更新间隔为 60 分钟,截图中的数值也是 60。

需要身份验证的地址应按提供方要求在客户端本地填写,不要把认证信息放进公开截图。出现下载失败时,先检查地址是否完整、是否过期、是否要求额外认证;不要反复更改配置内容来解决单纯的下载问题。

sing-box Windows 新建远程配置与自动更新表单
新建远程配置。URL 为用户提供的示例值,请替换为自己的有效配置地址;不要照抄。

已有本地配置:官方通用文档将本地配置定义为保存在本机的 sing-box 配置,并要求客户端提供编辑器。可在“新建配置”的类型菜单中查找本地选项,再按应用提示录入配置内容。本次截图未展示本地编辑器,因此这里不指定未经核对的“导入文件”按钮位置;配置内容应是适配当前版本的 sing-box JSON。

本地和远程两条路径择一即可。下图是远程配置创建后的界面:名称显示为“订阅”,下方有“远程”与更新时间,右下角可见编辑、刷新和分享图标。名称可自行填写,不代表配置格式;应以类型标记判断本地或远程。

sing-box Windows 远程配置保存后的待启动界面
远程配置已添加;选择配置后可用顶部播放按钮启动。

配置下载或保存成功只说明客户端取得了配置,还需要确认服务能够启动并正常连接。

五、选择配置、启动服务并确认连接

在“仪表”页的配置下拉框中选中要使用的条目,点击顶部靠左的三角形播放按钮启动。运行后,该位置会显示计时与方形停止按钮;左侧增加“概述、组、连接”等入口。打开“概述”可以查看上传/下载流量、内存、连接数等状态。

Desktop 提供 TUN 透明代理等平台功能,具体路由与代理行为取决于当前配置。不要照搬第三方客户端中“另外下载内核,再开启左上角系统代理”的固定步骤,也不要假定所有流量会自动按自己的预期分流。

sing-box Windows 运行计时、流量与连接状态
服务运行中的概述页;零流量不代表已验证实际访问。

图中的运行计时和停止按钮说明服务已启动,但上传/下载均为 0 B/s、连接数为 0,不能据此认定代理访问已经成功。请再用浏览器或目标应用进行一次实际访问,并观察连接和流量变化。运行图展示的是标为“本地”的配置示例,与前面的远程配置图分别说明两种状态;并不表示远程配置启动后会自动变成本地。

若已运行但访问不正常,先查看是否选错配置、出站是否可用、日志是否出现错误,再检查路由/TUN 配置和其他代理程序是否冲突。每次只改一项并复测,便于判断问题来自哪里。

六、查看分组、选择节点与切换模式

运行后点击左侧“组”。示例配置包含“节点选择”Selector 组,当前选中“自动选择”URLTest,也列出了直连和多个节点。需要手动选择时,在可选组里点击对应出站卡片;使用自动选择时,由配置中的测试规则决定候选出站。截图中的分组和节点名称来自示例配置,你的列表可能不同。

模式选择也由配置决定:官方通用文档说明,配置使用至少两个 clash_mode 值时提供模式选择器。本次截图只展示分组,没有模式控件,不把“规则/全局”开关作为所有配置都必有的步骤。看不到分组或模式时,先检查配置定义。

sing-box Windows Selector 和 URLTest 节点分组
“组”页面示例:Selector 中可以选择自动选择、直连或具体节点。

分组延迟测试用于辅助比较可达性和响应时间,不等于完整下载带宽测试;直连是否适合当前目标,也取决于网络与路由设置。

七、刷新配置、更新应用与停止连接

刷新远程配置是重新下载配置内容,更新 SFW 应用则可能带来客户端与内核变化。在远程配置卡片中使用循环箭头刷新,或在创建远程配置时启用自动更新。更新应用前保留可恢复的配置,并阅读目标版本更新记录。

在左侧进入“设置”,打开“应用”设置页,可调整语言、外观、主题、开机启动和托盘选项。截图中“启用托盘”“将托盘保留在后台”已打开,“开机启动”关闭,更新通道为“稳定版”。按自己的需求设置,不必为了导入配置填写 GitHub Token。

sing-box Windows 应用设置和后台托盘选项
“设置 → 应用”中的语言、托盘与更新通道选项。

结束使用时,点击顶部计时旁的方形停止按钮,再确认需要直连的网络访问恢复正常。启用后台托盘时,不要把关闭窗口等同于停止代理。截图未覆盖升级和完整退出流程,升级后的配置保留及退出行为应以实际版本为准。

八、常见问题

为什么下载后只有命令行窗口?请先检查文件名。SFW 的 EXE 是图形安装程序,sing-box 的 Windows ZIP 是命令行内核;两者用途不同。

旧第三方客户端的配置能直接搬过来吗?可以先尝试获取兼容本版的 sing-box 配置,再通过官方客户端导入。第三方应用自己的插件、设置目录和订阅处理规则不一定能够迁移,不能直接把整个应用目录当作配置。

有配置但没有节点列表怎么办?先判断配置是否定义了分组出站。单一出站的配置不一定提供可切换的节点列表;缺少分组控件本身不证明配置损坏。

配置能下载但服务无法启动怎么办?查看启动阶段的错误,核对配置格式、引用文件和版本兼容性。下载链接问题、JSON 解析问题、内核启动问题和节点连接问题应分开排查。

反馈问题时需要提供什么?记录 Windows 版本和架构、SFW/内核版本、失败发生在哪一步,以及经过脱敏的错误提示。不要发送完整订阅地址、节点密码或带凭据的配置文件。

相关教程与官方资料

sing-box 版本更新记录 · macOS 客户端教程 · 第三方 GUI for SingBox 教程

官方 Desktop 文档 · Windows 服务说明 · 官方配置与界面功能说明