外观
sing-box Windows 教程：订阅转换、配置文件与 GUI 使用步骤
这篇 sing-box Windows 教程讲两种用法：用社区图形界面直接导入机场提供的专用配置订阅，或者下载命令行核心、把一份 JSON 配置文件交给它运行。前者适合大多数人，后者适合想完全掌控配置的用户。
速读要点
- 官方只提供命令行，Windows 图形界面全是社区项目
- check 命令无输出代表配置合法
- 第三方订阅转换会拿到你的链接，优先用机场自带
适用范围
- 机场明确提供专有格式订阅的用户。
- 想用 Hysteria2、TUIC 等新协议，而现有客户端支持不好的用户。
- 对 JSON 不反感、愿意看官方文档的用户。
准备
- 确认机场用户中心是否有专用配置订阅。没有的话需要订阅转换，见下文。
- 从官方 GitHub Releases 下载 Windows 命令行版本；图形界面选社区项目时，同样只从其官方发布页下载。
- 想用 TUN 入站需要管理员权限。
sing-box Windows 教程：图形界面与命令行的区别
| 对比项 | 图形界面（社区 GUI） | 命令行核心 |
|---|---|---|
| 导入订阅 | 粘贴链接即可 | 需要自己下载配置或写配置 |
| 切换节点 | 点选 | 改配置或用 Clash API 面板 |
| 更新 | 一键 | 重新下载配置并重启 |
| 适合 | 日常使用 | 服务器、脚本化、极简需求 |
官方本身只提供命令行核心，Windows 图形界面都是社区项目，稳定性和更新节奏各不相同。不确定选哪个时，先用 Clash Verge Rev，等明确需要它的特性再换。
步骤：图形界面导入配置订阅
- 安装图形界面后打开，进入订阅或配置页面；结果是看到添加按钮。
- 粘贴机场提供的专属订阅链接，保存；结果是自动下载并生成一份配置。
- 启动核心，选择节点；结果是状态显示运行中。
- 需要全局接管时在设置里启用 TUN，并以管理员身份运行；结果是出现虚拟网卡。
操作对照：图形界面订阅导入
在此步骤中，界面重点核对订阅链接解析成功、节点列表刷新完整，且出站模式保持规则分流。
步骤：命令行运行配置文件
- 把下载的压缩包解压到一个目录，比如
D:\sing-box；结果是目录里有可执行程序文件。 - 从机场的订阅链接下载 JSON 保存为同目录的
config.json；结果是文件以{开头。 - 在该目录打开终端，执行
sing-box check -c config.json；结果是没有输出，代表配置合法。 - 执行
sing-box run -c config.json；结果是日志滚动，显示入站监听。 - 按配置里的入站类型，在 Windows 里把系统代理指向该端口，或者配置含 TUN 入站时以管理员身份运行终端；结果是流量开始经过它。
机场没有专用格式订阅怎么办：订阅转换
- 思路是用订阅转换服务把通用格式转成 JSON 配置。有些机场在用户中心内置了转换，有些需要你自建或使用第三方转换工具。
- 第三方转换服务会拿到你的订阅链接，等于把账号交给别人。优先选机场自带转换或自己部署。
- 转换后仍要用配置检查命令验证，再确认协议名、端口等信息与机场一致。
怎么验证已经成功
- 配置校验无报错，后台运行日志里没有 FATAL 字样。
- 浏览器或终端访问国外网站成功，日志里出现对应连接记录。
- 用图形界面时，节点延迟有数字。
Windows 使用常见问题
启动报错「decode config」怎么办？
JSON 语法错误或配置字段与核心版本不兼容。用 check 看具体行号，并确认核心版本在机场标注的范围内。
Windows 上 sing-box 的 TUN 开不起来怎么办？
没有以管理员身份运行，或驱动被安全软件拦截。以管理员身份打开终端或图形界面再试，见 TUN 失败。
提示端口被占用怎么办？
改配置里入站的监听端口，或先关掉占用该端口的其他客户端，见端口占用。
配置合法但节点全部超时怎么办？
先确认系统时间准确、协议参数与机场一致，再看节点全部超时。
下一步
- 不想折腾 JSON，直接按 Clash Verge Rev 导入订阅教程走。
- 配置合法但启动报端口占用，按端口占用处理换端口。
- 想用新协议又要线路稳定，在 IEPL 专线机场筛选里挑。