GUI.for.Clash 导入订阅教程：从下载内核到生成配置

官方信息核对

本文所有版本与平台信息均来自 GUI-for-Cores 组织的官方 GitHub 仓库、Releases 发布页和官方文档站，核对日期为 2026 年 10 月 21 日：

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

官方文档里有一条值得放在最前面的提醒：GitHub Releases 是唯一可信的下载来源，不要使用来历不明的安装包，包括群聊里转发的文件。本站也遵守这条约定，只给出官方链接。

先理解它的定位：图形前端，不是代理本身

很多人第一次接触 GUI.for.Clash 时会误以为它是一款「自带节点的翻墙软件」，这是错误的。官方文档用了相当明确的措辞：GUI 程序不是内核，也不是 VPN 或代理软件，没有内置任何代理。

它真正做的事情是：

• 把 Mihomo 内核的大量参数用图形界面展示出来，并给出合理的默认值；
• 帮你下载、保存、更新订阅，并从中提取节点；
• 用订阅里的节点拼装出一份完整的内核配置文件；
• 启动和停止内核，切换系统代理；
• 提供插件系统和计划任务，处理一些内核配置本身做不到的自动化工作。

项目基于 Wails（Go 语言）加 Vue 3 构建，体积比 Electron 系的客户端小。它的设计哲学偏向「让你看清配置里每一块在做什么」，所以界面上会出现订阅、配置、规则集、插件这几个分开的模块，而不是像有些客户端那样一键全包。理解了这一点，后面的操作顺序就很好记了：先有内核，再有订阅，最后用订阅生成配置。

下载与解压

Releases 页的每个版本提供七个 zip 包，按系统和处理器选择：

• Windows 普通电脑选 windows-amd64，骁龙笔记本选 windows-arm64，非常老的 32 位系统才需要 windows-386。
• macOS 的 M 系列芯片选 darwin-arm64，Intel 芯片选 darwin-amd64。
• Linux 按架构选 linux-amd64 或 linux-arm64。

解压后建议放在一个固定的、路径里没有特殊字符的文件夹里，比如 D:\Apps\GUI.for.Clash。原因是程序会在自己的目录下生成 data 文件夹，订阅、配置、内核都存在里面，随意移动程序位置容易让相对路径失效。安装与卸载的细节，官方文档分别有「安装」「卸载」两个独立章节可查。下载文件的一般性安全建议见 下载安全指南。

第一步：为 GUI.for.Clash 下载 Mihomo 内核

打开程序后，进入「设置」里的「内核」页面。程序会检查本地有没有内核文件，没有的话点击「更新」即可下载。官方文档提示，这一步通常需要能正常访问外网。

如果下载卡住或失败，有一个文档里给出的变通办法：从 Mihomo 官方发布页单独下载内核，把文件重命名为 mihomo.exe（或 Alpha 分支对应的 mihomo-alpha.exe），放到程序目录的 data/mihomo 文件夹里，重启软件即可识别。内核显示出正常的版本号后，还可以在同一页面切换稳定版和 Alpha 分支。

第二步：在 GUI.for.Clash 用「快速开始」导入订阅

对于只想尽快用上的读者，官方提供了一个快捷入口。

1. 登录机场后台，复制 Clash 格式 的订阅链接。分不清格式时，参考 Clash 订阅说明。
2. 在 GUI.for.Clash 里进入「概览」页面，点击「快速开始」。
3. 把订阅链接粘贴进去并确认。

这时程序会做三件事：下载订阅文件并提取节点；生成一个以随机 ID 命名的 .yaml 文件；自动创建一份与该订阅关联的配置。确认没有报错后，点击「启动内核」。

不同版本名称略有差异，如果你的界面上按钮文字和这里不完全一致，找意思相近的入口即可。

第三步（进阶）：在「订阅」页面手动添加

想同时管理多个机场，或者想更清楚地控制每个文件存在哪里，可以跳过快速开始，走手动流程：

1. 进入「订阅」页面，点击「添加」。
2. 按表单填写，带星号的是必填项，通常包括名称、订阅链接、保存路径。
3. 点击「更新」，程序会把链接内容保存到你填的保存路径。

这里有一个容易被忽略的细节：官方文档说明 GUI 只保存订阅内容中的 proxies 字段。也就是说，机场 YAML 里写好的分组和规则默认不会被原样搬过来，节点才是订阅页面关心的唯一东西。分组和规则要在下一步的「配置」里处理。

另外，订阅类型选「本地」时，文档建议把链接写成 data/local/文件名.txt 这种形式；如果链接与保存路径相同，更新时会跳过保存，只刷新节点数量等信息。

第四步：生成配置

进入「配置」页面，点击「添加」。这里有两条路可选：

路线 A：直接使用机场的分组与规则。 勾选「使用订阅内的代理组和分流规则」，订阅更新时会自动生成配置，省事。但代价是，每次订阅更新都会覆盖这份配置，你手动做的修改会丢失。

路线 B：自己搭配置。 官方文档更推荐这条路。新建的配置默认带五个代理组，每个组至少要引用一个订阅或节点，否则会出现感叹号提示。编辑代理组时，界面分为三块：已有的代理组（包括内置的 DIRECT、REJECT）、订阅列表、每个订阅下的节点。注意不要让代理组互相引用形成循环。

「规则设置」对应内核配置里的 rules 部分。类型选「规则集」可以引用已经添加的规则集；如果列表是空的，可以去「插件中心」运行「一键添加规则集」插件。GEOSITE、GEOIP 这类规则的写法，文档建议参考 MetaCubeX 的规则数据项目。

第五步：开启系统代理或 TUN

GUI.for.Clash 默认 不会改动系统设置，内核启动后浏览器不会自动走代理，这一点和很多「开箱即用」的客户端不同。你有两个选择：

• 手动打开「系统代理」开关；
• 在「设置」里开启「自动配置系统代理」，让程序在启动内核时自动处理。

如果要让不支持系统代理的程序也走代理，就需要 TUN 模式。官方文档说明，使用 TUN 需要打开「以管理员身份运行」。TUN 的工作方式和潜在影响，见 TUN 模式说明。

日常维护：计划任务、插件与升级

配置跑通之后，GUI.for.Clash 还有几个模块能减少日常的手动操作。

计划任务。 官方文档单独有一章介绍计划任务。最典型的用法是让程序定时更新订阅，这样机场换了节点地址，你不必每次手动点更新。也可以定时更新规则集，让分流规则保持较新的状态。

插件中心。 插件是 GUI-for-Cores 系列的一大特色，官方维护了一个插件列表页面。前面提到的「一键添加规则集」就是插件之一。插件以脚本形式运行，可以在生成配置、启动内核等时机自动执行。安装插件前建议先看说明，只装自己确实需要的，插件越多，排查问题时干扰因素也越多。

程序升级。 官方文档有专门的「更新」章节。升级 GUI 本身不会删除 data 目录里的订阅和配置，但稳妥起见，升级前把整个 data 文件夹复制一份备份，出问题时可以直接还原。

卸载。 由于程序是解压即用的，卸载基本就是删除目录。如果曾经开启过系统代理，删除前先在程序里关闭它，否则系统可能残留一个指向本地端口的代理设置，导致浏览器打不开网页。

GUI.for.Clash 导入订阅常见问题的排查思路

订阅更新后节点数为零。 先把链接放进浏览器打开，确认返回的是 YAML 而不是 base64 字符串。如果是后者，说明复制了错误的格式。

启动内核后立即退出。 多数是配置有语法问题或端口被占用。先确认没有其他 Clash 系客户端在后台运行，再到日志里看具体报错。

配置被莫名其妙改回去。 检查是否勾选了「使用订阅内的代理组和分流规则」，这个选项会在每次更新时覆盖配置。

需要某个界面上没有的内核参数。 文档提到可以用插件（触发器为「生成配置时」）向最终配置注入额外字段，也可以使用「混入与脚本」功能。

更完整的通用排查清单见 Clash 导入失败排查 与 订阅更新失败。

和同类客户端怎么选

GUI.for.Clash 适合愿意花十分钟理解「订阅、配置、内核」三者关系的用户，回报是对配置的掌控力更强，多机场合并、自定义分组都很顺手。如果你更想要一键导入、即刻可用的体验，同样基于 Mihomo 的 Clash Verge Rev、Mihomo Party 会更省心。机场如果给的是 sing-box 配置，可以看同门的 GUI.for.SingBox，或者直接了解 sing-box 本身。更多桌面客户端对比，请回到 客户端总览，或查看 Windows 客户端指南 与 Mac 客户端指南。