GUI.for.SingBox 导入订阅教程：图形化管理 sing-box

官方信息核对

以下信息核对自 GUI-for-Cores 组织的官方仓库、Releases 发布页及官方文档，核对日期为 2026 年 10 月 21 日：

项目	核对结果
最新版本	v1.28.0（Releases 页标记为 Latest，非预发布）
发布日期	2026-10-21
平台	Windows（386、amd64、arm64）、macOS（amd64、arm64）、Linux（amd64、arm64），发布文件均为 zip
价格	官方页面未见收费说明，开源项目，Releases 可直接下载
许可证	GPL-3.0（GitHub 仓库标注）
是否归档	否
官方来源	仓库 https://github.com/GUI-for-Cores/GUI.for.SingBox ，发布页 https://github.com/GUI-for-Cores/GUI.for.SingBox/releases ，文档 https://gui-for-cores.github.io/zh/guide/

需要提前说明的是：官方文档里 GUI.for.SingBox 的社区教程是基于 v1.9.0 写的，和当前 v1.28.0 的界面会有出入。本文沿用官方教程里的模块名称，实际使用时 不同版本名称略有差异，以你看到的界面为准。

它和 sing-box 是什么关系

sing-box 是一个通用代理内核，以 JSON 作为配置语言，协议覆盖面广。它本身是命令行程序，直接使用需要手写一份结构严谨的 JSON 配置，对普通用户门槛较高。

GUI.for.SingBox 的角色，是在 sing-box 内核外面套一层图形界面：

• 下载和更新 sing-box 内核；
• 管理订阅，把节点保存为本地 JSON；
• 通过表单或「向导模式」，把入站、出站、路由、DNS、规则集这几块拼成完整配置；
• 启动内核、查看日志、运行插件和计划任务。

和 GUI.for.Clash 一样，官方文档反复强调，GUI 程序本身不是代理软件，不带任何节点。你看到的所有可用线路，都来自你自己导入的订阅。

如果你想先弄懂 sing-box 内核本身，可以读本站的 sing-box 介绍；协议层面的背景知识整理在 协议百科。

GUI.for.SingBox 订阅格式：这是最容易卡住的地方

GUI.for.SingBox 对订阅内容的预期和 Clash 系客户端完全不同。官方社区教程写得很明白：订阅文件只需要包含 outbounds 部分，也就是一个由节点对象组成的 JSON 数组。

这意味着：

• 机场后台如果有「sing-box」或「SingBox」格式的订阅，优先复制它；
• Clash 的 YAML 订阅，官方教程没有说明可以直接使用；
• v2rayN 那种 base64 编码的分享链接合集，教程里同样没有提及。

机场只提供 Clash 订阅的话，与其花时间折腾格式转换，不如直接改用 Clash 系桌面客户端，比如同门的 GUI.for.Clash 或 Clash Verge Rev。不确定机场给的是哪种格式，可以把链接贴到浏览器里看返回内容：开头是花括号或方括号的是 JSON，一行行 proxies: 开头的是 Clash YAML，一整串字母数字混杂的通常是 base64。

下载与首次设置

从官方 Releases 下载对应系统的 zip：Windows 常见电脑选 windows-amd64，骁龙笔记本选 windows-arm64；Apple 芯片 Mac 选 darwin-arm64，Intel Mac 选 darwin-amd64；Linux 按架构选择。解压到一个固定目录后运行。下载渠道的注意事项见 下载安全指南。

首次打开，建议先进入「软件设置」里的「通用设置」：

• 选择界面语言；
• 按习惯勾选「自动启动内核程序」「退出程序时同时关闭内核」等选项。

这两个选项看似琐碎，却能避免一种常见困惑：关掉窗口以为断开了代理，其实内核还在后台跑着。

第一步：下载 sing-box 内核

在「软件设置」中切换到「内核」选项卡，下载或更新 sing-box 核心程序。内核版本和 GUI 版本是两回事，GUI 更新不会自动替换内核，反之亦然。如果机场的节点用到了较新的协议特性，内核版本过旧可能导致配置报错，这时回到这一页更新内核即可。

第二步：GUI.for.SingBox 订阅设置

订阅是必须配置的模块。进入「订阅设置」，点击添加：

1. 订阅链接：粘贴从机场复制的 sing-box 格式链接。
2. 命名：写一个容易分辨的名字。
3. 保存路径：订阅内容会保存成本地 JSON 文件，官方建议使用相对路径，便于整体迁移程序目录。
4. 点击 更新，确认显示的节点数量与机场后台大致一致。

节点数为零或明显偏少，通常是格式不对，或者机场按客户端标识返回了不同内容。前者换链接，后者可以对照 订阅更新失败 里的思路检查。

第三步：配置设置

配置同样是必须项。进入「配置设置」，点击「添加」并命名。之后有两种编辑方式：

• 右键配置进入详细设置，逐项修改；
• 使用「向导模式」，按步骤填写。

点击右上角的文档按钮，可以随时预览当前生成的 JSON，这对想学习 sing-box 配置结构的人很有帮助。

配置由以下几块组成，官方教程按这个顺序介绍：

入站设置。 支持 Mixed、HTTP、SOCKS 等本地监听入站，默认监听 127.0.0.1 和对应端口。浏览器或其他程序通过这个端口把流量交给内核。

出站设置。 这里决定节点如何分组。分组类型包括直连、手动选择、自动选择，还可以用正则表达式按节点名包含或排除，比如只把名字里带「香港」的节点放进某个组。

路由设置。 决定哪些流量走哪个出站，比如国内网站直连、其他走代理。

DNS 设置。 sing-box 对 DNS 的控制粒度很细，新手保持默认即可，遇到解析问题再调整。

规则集。 引用远程或本地规则集，减少手写规则的工作量。

第四步：Tun 入站与权限

只用浏览器的话，配合 Mixed 入站加系统代理就够了。如果希望所有程序都走代理，包括那些不认系统代理设置的软件，就要用到 Tun 入站。它通过虚拟网卡接管系统流量，应用无需支持代理也能生效。

官方教程提到的要点：

• 堆栈可选 system、gvisor、mixed，默认是 mixed；
• 建议启用「自动设置全局路由」，同时启用「自动检测出站接口」，以免流量绕回自身形成回环；
• Windows：需要在「软件设置」中启用「以管理员身份运行」，非管理员组用户尤其要开；
• macOS 和 Linux：在「内核」设置页点击授权按钮完成授权。

TUN 模式的通用原理和副作用，可以阅读 TUN 模式说明。

插件中心能做什么

GUI.for.SingBox 带有插件系统，官方教程里举的例子是一个显示国旗图标的插件，用来让节点名称里的地区旗帜正常显示。插件还可以挂在特定触发时机上，比如生成配置时自动注入额外字段。是否需要插件因人而异，入门阶段不装任何插件也完全能用。

用 JSON 预览学习 sing-box 配置

GUI.for.SingBox 有一个对学习者非常友好的设计：每次在表单里改动入站、出站或路由，都可以通过右上角的文档按钮预览最终生成的 JSON。这相当于一位随身的「翻译」，把你在界面上点的每一个选项，翻译成 sing-box 能读懂的配置字段。

推荐的学习方式是这样的：

1. 先用向导模式生成一份能用的配置，确认可以正常上网；
2. 打开 JSON 预览，从上往下对照界面，看清楚 inbounds、outbounds、route、dns 各自对应哪一块；
3. 每次只改一个选项，再看 JSON 里哪一行发生了变化；
4. 改坏了就回退，或者复制一份配置专门用来实验。

坚持几次之后，你会发现 sing-box 的配置结构并没有想象中复杂。将来即使换到别的 sing-box 客户端，或者需要在路由器上直接运行内核，这些理解都能直接用上。路由规则本身的写法思路，本站另有 sing-box 内核介绍 可以参考。

GUI.for.SingBox 导入订阅排查清单

1. 节点数为零：确认复制的是 sing-box 格式，并在浏览器中确认链接返回 JSON。
2. 内核启动即退出：查看日志，大多是配置字段与内核版本不匹配，更新内核或检查出站设置。
3. 浏览器打不开网页：确认入站端口与系统代理设置一致，或改用 Tun 入站。
4. Tun 开了没反应：检查管理员权限或系统授权是否完成。
5. 国内网站变慢：检查路由设置里是否有国内直连规则。

通用的导入问题也可参考 Clash 导入失败排查，其中关于链接有效性、网络可达性的检查方法同样适用。

适合人群

GUI.for.SingBox 适合两类用户：一是机场提供 sing-box 订阅、又想在电脑上用图形界面管理的人；二是想借助可视化表单和 JSON 预览，逐步学会 sing-box 配置的人。如果你更习惯「导入订阅即用」，或机场只给 Clash 格式，那么 Clash Verge Rev、Mihomo Party 会更合适；喜欢 sing-box 内核但想要更省事的界面，也可以看看 Hiddify 或 Karing。更多选项见 客户端总览，以及 Windows 客户端指南、Mac 客户端指南。