Sparkle 导入订阅教程：仓库核对、安装包与导入

Sparkle 是什么

Sparkle 是一款桌面端图形客户端，官方仓库在 GitHub 的 xishang0128/sparkle，项目自述用一句话概括自己：另一个 Mihomo 图形界面。这里的 Mihomo 指的是 MetaCubeX 维护的代理内核，也就是原先常说的 Clash Meta。Sparkle 本身不负责转发流量，它做的事情是把内核的配置、订阅、策略组和日志用窗口的形式呈现出来，让用户不必手写配置文件。

从 README 的技术说明来看，Sparkle 基于 Electron、React 和 TypeScript 构建，主进程里集成了 Mihomo 内核管理与系统代理模块。安装包内自带稳定版和预览版两套 Mihomo 内核，用户可以在设置里切换。作者在 README 中写明这是一个自用项目，大部分外部合并请求可能不会被接受，这一点说明它的功能取舍主要由作者决定，用户提出的需求不一定会被采纳。

很多人第一次看到 Sparkle 时会觉得它的界面和某些同类客户端相似。这并不奇怪，Mihomo 生态里的桌面客户端在概念上高度一致：都有订阅管理、代理组、连接列表、规则和日志几个板块。区别更多体现在细节上，例如主题配色、覆写功能的写法、Tun 模式的实现方式以及发布节奏。

官方信息核对

以下信息来自本页在 2026 年 10 月 21 日对官方仓库页面和 GitHub 公开接口的查询，只记录实际看到的内容：

项目	核对结果
官方仓库	https://github.com/xishang0128/sparkle
最新正式版	1.26.9
发布日期	2026 年 9 月 30 日
支持平台	Windows（x64、arm64）、macOS（x64、arm64）、Linux（x64、arm64、loong64 等）
内核	Mihomo，安装包内置稳定版与预览版
许可证	GPL-3.0
是否归档	否
其他构建	仓库提供 rolling 滚动构建标签

仓库最近一次推送记录在 2026 年 10 月 20 日，说明项目仍在活跃开发。项目没有在 README 中给出独立官网，所以官方来源目前以 GitHub 仓库和它的 Releases 页面为准。官方页面没有明确列出支持哪些订阅格式，因此本页不对订阅格式兼容性下结论，只说明它使用 Mihomo 内核，能读取的是 Mihomo 可以解析的配置。

Sparkle 安装包怎么选

Sparkle 的 Releases 页面列出的文件比较多，第一次下载容易挑花眼。按照文件名可以这样区分：

• Windows 用户：文件名里带 windows 的是 Windows 版本。带 setup.exe 的是安装程序，带 portable.7z 的是免安装压缩包。x64 对应大多数 Intel 和 AMD 电脑，arm64 对应骁龙等 ARM 芯片的 Windows 设备。
• macOS 用户：文件名里带 macos 的是苹果电脑版本，格式为 pkg 安装包。arm64 对应 Apple 芯片的机型，x64 对应较早的 Intel 机型。不确定的话，可以在「关于本机」里查看芯片信息。
• Linux 用户：提供 deb、rpm 和 pkg.tar.zst 三种格式，分别适合 Debian 系、Red Hat 系和 Arch 系发行版。除了常见的 x64 和 arm64，还额外提供 loong64 架构，这在同类客户端中并不常见。

另外有一个 latest.yml，它是自动更新用的描述文件，不是安装包，普通用户不需要下载。

关于 rolling 标签：它是滚动构建，跟随代码提交自动生成，能更早体验新改动，但也更容易遇到尚未修复的问题。日常使用建议选择标记为 Latest 的正式版。下载前的通用注意事项，例如核对仓库地址、避开二次打包的网盘文件，可以参考 下载安全指南。

第一次启动要注意什么

Sparkle 在 README 里提到的一个特点是 Tun 模式开箱可用，不需要额外安装服务模式。Tun 模式会创建虚拟网卡来接管系统流量，比单纯设置系统代理覆盖的范围更广，命令行工具和部分不读取系统代理的程序也能被接管。

不过，开启虚拟网卡多少会涉及系统权限。在 Windows 上，首次启用时可能会出现管理员权限提示；在 macOS 上，pkg 安装过程会请求输入开机密码，这是系统层面的安装授权，属于正常现象。如果你的电脑有公司安全软件或其他代理工具，最好先关掉别的代理软件，避免多个程序同时抢占系统代理或虚拟网卡。

README 的开发注意事项里还提到，Windows 下如果出现页面白屏，关闭 Tun 后可以恢复。虽然这一条写在开发说明里，但普通用户遇到类似情况时也可以参考这个思路：先关闭虚拟网卡，确认界面能正常加载，再逐步排查。

Sparkle 导入订阅的步骤

不同版本名称略有差异，下面描述的是通用流程，具体按钮位置以你安装的版本为准：

1. 在机场后台复制 Clash 或 Mihomo 类型的订阅链接。如果后台提供多种格式，优先选择标注为 Clash Meta 或 Mihomo 的那一种。
2. 打开 Sparkle，进入订阅管理相关的页面，一般在侧边栏可以找到。
3. 粘贴订阅链接，确认导入。导入成功后，订阅列表里会出现一条新的记录，通常会显示流量和到期信息（前提是机场在订阅响应中提供了这些字段）。
4. 选中这条订阅，使其成为当前使用的配置。
5. 回到代理组页面，选择节点或策略组，然后打开系统代理或 Tun 模式开关。

如果你对订阅链接、策略组这些概念还不熟悉，建议先读一遍 Clash 订阅教程 和 订阅链接是什么。这些概念在 Mihomo 系客户端中是通用的，理解之后换任何一款同类软件都不会陌生。

Sparkle 还深度集成了 Sub-Store。Sub-Store 是一个订阅管理工具，可以对多条订阅做合并、筛选、重命名等处理。对于只有一条机场订阅的用户来说，这个功能不是必需的，直接粘贴链接即可；如果你同时持有多家机场的订阅，或者想把节点按地区重新整理，再去研究它也不迟。

覆写功能怎么理解

覆写是 Sparkle 在 README 中重点强调的功能。简单说，覆写就是在不改动订阅原文的前提下，对最终生效的配置做补充或修改。例如你想给某个网站单独指定走哪个策略组，或者调整 DNS 设置，就可以写一段覆写规则，而不必每次更新订阅后都手动改一次。

这个功能很强大，但也容易出错。覆写内容写错时，常见的表现是订阅能导入、节点也能看到，但实际连接失败，或者规则不按预期生效。建议遵循下面几条原则：

• 先在不启用任何覆写的情况下确认订阅本身可用，再逐条添加覆写。
• 每次只改一个地方，改完立即确认效果，方便定位问题。
• 不清楚某个字段含义时，去查 Mihomo 官方文档，不要照搬来路不明的脚本。

规则相关的基础知识可以参考 协议科普 中的介绍，了解不同协议的特点有助于判断节点问题出在哪一层。

与站内其他桌面客户端怎么选

Mihomo 系桌面客户端选择很多，站内已有几篇相关页面：Clash Verge Rev、Mihomo Party、FlClash、Clash Nyanpasu。它们都使用 Mihomo 内核，订阅可以通用，差异主要在界面风格和附加功能上。

如果你看重以下几点，Sparkle 值得一试：

• 希望 Tun 模式不依赖额外服务即可使用。
• 需要用覆写功能精细调整配置。
• 使用 Linux 的 loong64 等较少见的架构。

如果你更在意社区规模、文档数量和问题讨论的丰富程度，用户群更大的客户端可能更省心，遇到问题时更容易找到别人的经验。Windows 用户的整体选择思路可以看 Windows 客户端选择指南，苹果电脑用户可以看 Mac 客户端选择指南。

Sparkle 常见问题排查

导入订阅后提示失败：先把订阅链接粘贴到浏览器里看看能否返回内容。如果浏览器也打不开，问题多半在订阅本身，例如链接已经重置或套餐过期。如果浏览器能打开但客户端导入失败，可以参考 Clash 订阅导入失败排查，其中的检查顺序同样适用于 Sparkle。

能看到节点但无法上网：确认系统代理或 Tun 至少开启了一个；再确认当前选中的策略组里确实选了一个可用节点。如果开启了覆写，先暂时关掉覆写，排除配置冲突。

更新后行为变化：Sparkle 更新比较频繁，每次更新可能伴随内核版本变化。遇到升级后出现异常，可以先查看 Releases 页面上对应版本的更新说明，判断是不是已知改动；必要时可以回退到上一个正式版，但回退前记得备份配置。Sparkle 支持通过 WebDAV 备份和恢复配置，换电脑或重装系统时也能用到。

小结

Sparkle 是 xishang0128 维护的 Mihomo 桌面图形客户端，截至本页核对，最新正式版为 1.26.9，发布于 2026 年 9 月 30 日，许可证 GPL-3.0，仓库未归档且仍在更新。它覆盖 Windows、macOS、Linux 三个桌面平台，内置 Mihomo 稳定版与预览版内核，主打免服务模式的 Tun、覆写功能和 Sub-Store 集成。下载时只认官方 Releases，正式版优先于滚动构建；导入订阅前先确认链接本身可用。更多客户端可以回到 客户端总览 对比选择。