Mihomo 订阅转换怎么弄?从订阅链接到配置生效的完整步骤
简答:Mihomo 订阅转换的核心,是把原始订阅整理成 Mihomo 能解析的配置或节点列表。先下载订阅内容判断格式:如果已经是 YAML 配置,通常可以直接导入;如果只是 Base64、URI 或其他客户端格式,再选择在线转换、本地转换或 Sub-Store 输出 Mihomo 格式。导入后必须以客户端解析成功、节点出现、代理组可选和实际连接测试通过为准。
定义:Mihomo 订阅转换,是将原始订阅链接、节点 URI、Base64 节点列表或其他客户端格式,转换为 Mihomo 可读取的配置或节点数据的过程。
先试这一步:判断订阅是否已经是 Mihomo 格式
不要一拿到订阅链接就转换。先在浏览器或下载工具中请求订阅,但不要把真实链接发到群聊、工单、截图或第三方检测网站。下载结果建议保存到本地后查看响应头、文件扩展名和文件开头几行。
- 响应头:关注 HTTP 状态是否为成功,以及
Content-Type是否接近 YAML、文本或 JSON。状态成功只能说明文件被返回,不能证明内容一定能被 Mihomo 使用。 - 文件名:常见后缀可能是
.yaml、.yml、.json或无后缀;无后缀并不代表格式错误。 - 首行和结构:如果开头能看到
proxies:、proxy-groups:、rules:等 YAML 配置字段,可先按 Mihomo 配置尝试;如果是一长串编码文本或大量协议://地址,通常更像节点列表,需要转换或由客户端解析。 - 最终判据:格式外观只能辅助判断,不能单独证明兼容。Mihomo 官方文档把配置、代理、规则和 DNS 分开定义,能否通过客户端解析或命令行测试才是最终依据。查看 Mihomo 配置文档
| 看到的内容 | 通常怎么处理 | 成功判据 |
|---|---|---|
| 完整 YAML 配置 | 先备份后直接导入 Mihomo 客户端 | 配置解析通过,代理组和节点出现 |
只有 proxies 节点列表 | 导入后补充或绑定客户端需要的通用配置 | 客户端能生成代理组并完成连接测试 |
| Base64 或 URI 文本 | 转换目标选择 Mihomo 或 Clash.Meta | 输出为可解析的 YAML 或节点列表 |
| JSON、其他客户端格式 | 使用支持该输入格式的转换器或本地工具 | 输出文件通过 Mihomo 校验 |
| HTML 登录页或报错文本 | 不要转换,先检查链接、登录状态和返回状态码 | 重新获取到真实订阅内容 |
Sub-Store 的公开说明列出了多种输入格式,并将 Clash.Meta(mihomo) 作为输出目标之一;它也提醒部分 HTTP(S) 内容并不是标准节点 URI,不能仅凭链接形式判断格式。查看 Sub-Store 输入与输出格式说明
三种转换方式怎么选:在线、本地还是 Sub-Store
在线转换:适合临时把一个订阅转换为 Mihomo 格式。一般流程是选择输入类型或自动识别,目标选择 Mihomo、Clash.Meta 或同类名称,粘贴订阅链接,生成配置链接或下载文件,再导入客户端。不同工具的字段、模板和参数并不完全相同,无法确认的选项不要随意开启。
在线方式的主要风险是订阅链接可能经过第三方服务器。订阅链接通常包含账号凭据、流量标识或可持续更新的访问权限,所以不要把真实链接交给来历不明的网页,也不要把生成后的完整链接公开。转换结果还可能只包含节点,不包含原订阅中的规则、DNS、策略组或更新逻辑。
本地转换:适合长期使用、需要控制订阅隐私或想固定转换参数的情况。可以在本机运行转换工具,输入文件或链接,输出 Mihomo YAML,再用 Mihomo 命令行校验。优点是订阅内容不必发送给额外的在线服务;缺点是需要自行安装运行环境、更新工具并处理格式兼容。
Sub-Store:适合管理多个订阅、合并输入和统一输出。官方说明支持将多种输入转换为 Mihomo 目标格式,也支持订阅格式化和多订阅集合。使用时仍需自己确认部署来源、访问权限和日志是否会暴露订阅地址。查看 Sub-Store 官方项目说明
- 只想快速导入一次:优先尝试原订阅直接导入,失败后再转换。
- 需要合并多个订阅:考虑 Sub-Store 或本地转换。
- 订阅包含敏感凭据:优先本地处理,避免第三方在线页面。
- 只需要节点,不需要原规则:可以选择“仅节点”类输出,但转换器是否提供该选项要以当前页面为准。
在线转换的可照做流程
- 备份原链接:将原订阅保存在密码管理器或本地安全位置,不要直接粘贴到公开文本。
- 确认返回内容:先下载一份副本,检查状态码、响应类型、文件大小和首行内容。如果返回的是登录页、验证码页或 HTML,停止转换。
- 选择目标:目标选择
Mihomo、Clash.Meta或页面明确写明兼容 Mihomo 的选项;不要把旧版 Clash 目标当成必然等价。 - 选择输出类型:需要完整规则和代理组时选择完整配置;只想获得节点时选择节点列表或仅代理模式,但要确认客户端是否能自动生成代理组。
- 生成并保存:优先下载为本地 YAML 文件,再导入客户端。若使用转换链接,先在浏览器中打开检查返回内容,确认不是 HTML 报错页。
- 保留原订阅:转换后的文件或链接不一定能自动跟随原订阅更新。若页面提供更新链接,保存前确认它仍包含必要的认证参数,并避免公开。
如果生成内容开头是 YAML,仍不能只凭出现 proxies 判断完整可用。还要检查代理组引用的名称是否确实存在、规则目标是否存在,以及 DNS、TUN 或外部控制字段是否符合当前客户端环境。
Windows、macOS、Android、Linux 如何导入
Windows:图形客户端导入
- 打开已安装的 Mihomo 图形客户端,进入订阅、配置或 Profiles 一类页面。
- 如果手里是订阅链接,选择添加远程订阅并粘贴链接;如果已经下载 YAML,选择导入本地配置。
- 保存后执行更新或下载,等待配置完成,再点击该配置使其成为当前配置。
- 进入代理组页面,确认至少能看到节点或策略组;随后选择节点并开启系统代理或客户端代理模式。
Clash Party 的快速上手文档展示了“导入订阅—选择节点—选择模式”的基本流程;具体菜单文字可能随版本变化,找不到入口时优先在侧栏寻找订阅、配置、Profiles 或代理页面。查看 Clash Party 快速上手文档
macOS:与 Windows 相同的判断顺序
- 先判断是远程订阅还是本地 YAML。
- 在客户端的订阅或配置页面添加远程链接,或使用本地文件导入。
- 下载完成后切换到当前配置,选择代理组中的节点。
- 只在节点可见且连接日志正常后,再开启系统代理或 TUN;若开启后断网,先关闭 TUN 并恢复系统代理,再看日志。
Mihomo 官方启动文档按 Windows、Linux、macOS、Android 等系统提供不同构建选择,因此原生内核与图形客户端的安装方式不能混为一谈。查看 Mihomo 启动与系统构建说明
Android:先确认客户端接受哪种输入
- 在 Android 客户端中打开配置、订阅或远程配置页面。
- 优先粘贴原始订阅链接,选择 Mihomo、Clash.Meta 或客户端明确支持的格式。
- 如果原始链接只返回 Base64、URI 或其他格式,再导入转换后的 YAML 或 Mihomo 目标链接。
- 更新配置后检查节点数量、代理组和日志;最后再授予 VPN 权限并测试单个节点。
Android 客户端之间的入口名称差异较大,不能把桌面端的菜单路径直接套用。若客户端只接受某一种格式,应以它的导入说明为准;格式不匹配时,回到“判断返回内容—选择目标格式—重新生成”的流程。
Linux:文件、校验、启动和更新
- 从 Mihomo 文档或其发布页选择匹配 Linux 架构的构建,确认 CPU 架构后再下载。官方启动文档列出了 Linux 和多种架构选项。查看官方构建选择
- 将转换得到的文件保存为配置目录中的
config.yaml,并限制文件权限,避免订阅链接和密钥被其他用户读取。 - 先执行只读配置测试:
mihomo -t -f /etc/mihomo/config.yaml。预期结果是测试通过或进程返回成功;如果出现解析错误,不要直接启动。 - 测试通过后可直接运行:
mihomo -d /etc/mihomo。如果使用 systemd,可按官方服务文档将配置目录放在/etc/mihomo,再执行服务启动和状态检查。查看 Mihomo systemd 服务说明 - 更新订阅前先备份当前配置:
cp /etc/mihomo/config.yaml /etc/mihomo/config.yaml.bak。下载新文件后再次执行mihomo -t -f /etc/mihomo/config.yaml,通过后再重载服务。 - 验证运行状态时查看日志和控制接口。官方 API 文档提供了版本、日志、配置、代理组和节点延迟等接口;若启用了外部控制器,必须限制监听地址并设置可靠密钥。查看 Mihomo API 文档
回滚方法:如果更新后内核无法启动,停止服务,把备份文件恢复为 config.yaml,再次运行配置测试,然后启动旧配置。不要在未备份的情况下覆盖唯一可用配置。
导入后怎么验证:不要只看“节点出现”
- 格式验证:客户端没有弹出解析错误,或 Linux 下
mihomo -t测试通过。 - 配置验证:能看到代理组、节点名称和规则;如果只有节点没有代理组,说明转换结果可能是节点列表而非完整配置。
- 连接验证:选择一个节点,观察日志是否出现连接成功或明确的失败原因。Mihomo API 支持读取代理信息和对策略组进行延迟测试,但延迟数值只代表当前测试条件,不等于所有网站的速度。查看节点与策略组测试接口
- 应用验证:分别测试客户端内置连接、浏览器加载和实际工作应用。若客户端显示连接成功但浏览器打不开,继续检查系统代理、DNS、规则命中和 TUN,而不是立刻重复转换。
一个简单的安全检查示例:下载订阅后只保留文件扩展名、响应类型和 YAML 第一行的截图,隐藏完整 URL、用户名、Token、节点地址、密码、UUID、私钥和生成后的转换链接。任何需要公开求助的内容都应先脱敏。
常见失败排查:现象→判断→处理→回滚
| 现象 | 先检查什么 | 处理方法 |
|---|---|---|
| 转换结果是 HTML | 状态码、登录状态、响应头 | 重新获取真实订阅,不要把 HTML 当 YAML 导入 |
| 配置解析失败 | 错误行号、缩进、字段名、特殊字符 | 重新生成目标为 Mihomo 的配置,或恢复上一份备份 |
| 节点为空 | 转换结果是否只有规则、是否过期、是否被过滤 | 检查原订阅内容,换成完整配置输出再测试 |
| 节点显示但无法连接 | 日志中的 DNS、TLS、超时和认证信息 | 单独测试其他节点,确认订阅本身和本地网络是否正常 |
| 更新后配置失效 | 更新后文件是否被覆盖、链接是否过期 | 先恢复备份,再重新生成或绑定可更新的订阅来源 |
| 开启 TUN 后断网 | 权限、路由、DNS 劫持和端口冲突 | 先关闭 TUN 恢复网络,再逐项开启并观察日志 |
如果同一订阅在多个客户端都显示为空或返回错误,优先怀疑订阅链接、权限或服务端返回内容;如果只有一个客户端失败,优先检查该客户端支持的格式、内核版本和配置路径。版本号、菜单和支持协议可能变化,页面当前显示应以对应项目的最新说明为准。
风险与回滚:订阅链接不要当普通网址处理
- 不要把真实订阅链接粘贴到公开工单、截图、代码仓库或聊天群。
- 不要为了“检测格式”把订阅交给不明在线页面;优先下载到本地查看。
- 不要公开完整 YAML。配置中可能包含节点地址、认证信息、规则来源、API 密钥或其他敏感字段。
- 使用第三方转换服务时,先确认是否支持本地部署、是否会保存输入、是否会把订阅写入日志;无法确认就按“存在风险”处理。
- 每次更新前保留上一份可用配置;新配置必须先校验,失败就恢复旧文件。
如果怀疑订阅已经泄露,应立即在订阅提供方后台重新生成或撤销旧链接;具体入口和处理方式以对应服务页面为准,本文不对任何服务的状态作判断。
常见问题
Mihomo 订阅一定要转换吗?
不一定。如果原链接直接返回 Mihomo 可识别的完整 YAML,通常可以直接导入;如果返回的是 Base64、URI、其他客户端格式,或客户端提示格式不支持,才需要转换。最终以客户端解析结果或 Linux 下的 mihomo -t 校验为准。
订阅转换后只有节点,没有规则和代理组,正常吗?
可能正常,因为有些转换结果只输出节点列表,不包含原订阅的规则、DNS 或策略组。此时选择完整 Mihomo 配置输出,或在客户端中补充代理组和规则;不要只看到 proxies 字段就认定配置完整。
Mihomo 配置解析失败怎么办?
先看报错行号和字段,确认下载到的不是 HTML 页面,再检查 YAML 缩进、特殊字符和目标格式。Linux 用户可执行 mihomo -t -f /etc/mihomo/config.yaml;图形客户端则先恢复上一份备份,再重新生成 Mihomo 或 Clash.Meta 目标配置。
Windows 和 macOS 导入订阅的菜单一样吗?
基本流程都是添加远程订阅或导入本地配置、更新、切换当前配置、选择节点和开启代理,但菜单名称会随客户端和版本变化。找不到固定入口时,应在订阅、配置、Profiles 或代理页面中查找,不要把某个客户端的路径当成所有客户端的固定路径。
Linux 下更新订阅前需要做什么?
先复制当前可用配置作为备份,再下载新配置并执行 mihomo -t -f 配置路径进行校验。只有校验通过后才替换正式配置并重载服务;启动失败时恢复备份文件,再次校验和启动。
把订阅链接交给在线转换工具安全吗?
不能默认安全。订阅链接可能包含持续访问凭据,在线转换服务可能接触请求内容、日志或生成链接。无法确认保存策略时,优先选择本地转换,并且不要公开真实订阅、完整 YAML、Token、UUID、密码或私钥。
相关阅读
- 继续看:Mihomo 配置文件下载后怎么导入和启用
- 配置较多时:Mihomo 配置文件怎么切换
- 导入成功但打不开网页:按连接记录、DNS 和 TUN 排查
- 节点能看到却连不上:检查超时、DNS 和节点选择
- 如果目标是 sing-box:订阅链接转换成配置的方法
参考资料
- Mihomo Configuration 官方文档
- Mihomo 启动与系统构建官方文档
- Mihomo API 官方文档
- Sub-Store 官方项目说明:输入格式与 Mihomo 输出
- Clash Party 快速上手文档(clashparty.org)
- Mihomo systemd 服务官方说明