Mihomo 订阅配置文件怎么导入：按类型操作，逐步验证

更新于 2026-11-10 · passwall.lol

简答：先看你手中是订阅 URL、完整 YAML，还是节点集合，再确认使用图形客户端或纯内核。Clash Verge Rev 用户可在订阅页导入链接或拖入本地 YAML，随后选中配置；纯内核用户先取得本地完整配置，用 -t 校验，再用 -f 指定加载。节点集合需要主配置引用，出现配置记录或校验通过，都不等于实际连接成功。

定义：Mihomo 配置导入，是把兼容的主配置交给内核加载，或由图形客户端获取、保存并启用；订阅 URL 是获取地址，YAML 是内容载体，节点集合是供主配置引用的资源。

先试这一步：按手中内容选择导入路线

拿到订阅却找不到导入按钮，先别改 DNS 或开启 TUN。本站是第三方使用指南站，不代表客户端项目；本页只解决 Mihomo 配置导入，图形路线统一使用 Clash Verge Rev，纯内核命令仅以 Windows PowerShell 为例。

最短路径：保留旧配置 → 识别手中内容 → 按下表导入 → 选中或加载新配置 → 检查节点并测试实际请求。

图形导入依据 Clash Verge Rev 文档中的订阅导入页；远程记录更新范围可对照 v2.4.3 的 src/pages/profiles.tsx：onUpdateAll；集合更新依据 Mihomo 代理集合配置文档。上述资料访问日期均为 2026-11-10。

本文验收建议：把下载、解析、启用和实际请求分开记录。只有配置卡片出现，或只有校验通过，都先不要删除旧配置。

导入前确认：你用的是客户端，还是命令行内核

先记录程序名称、操作系统和版本。本文的图形步骤适用于 Clash Verge Rev，相关交互对照固定标签 v2.4.3 的源码；命令参数对照 Mihomo v1.19.17 的源码。这是适用依据，不是最新版声明，也不要求为阅读本文更换版本。来源分别为 Clash Verge Rev 固定标签订阅页源码和 Mihomo 固定标签 main.go，访问日期：2026-11-10。

• 有订阅页面：按下文图形路线操作，不需要另开一个内核实例。
• 只有命令行程序：按纯内核路线准备本地文件，再校验和启动。
• 界面来自其他客户端：不要照搬本文按钮名称，先查该客户端自己的配置导入说明。

接着确认内容类型。订阅 URL 只是地址，实际返回内容仍需核对；YAML 扩展名也不能证明它就是完整主配置。项目的 代理集合内容文档展示了以 proxies 为主体的 YAML 集合，因此不能只看到 proxies 就认定已经具备完整的策略和流量处理配置。访问日期：2026-11-10。

建议在本机检查内容，并从原提供方确认应获取的是完整配置还是节点集合。不要为识别格式把带有令牌的订阅地址、密码或整份配置提交到不可信的在线转换网站；求助截图也应先遮住这些信息。

图形路线一：把订阅 URL 导入并选中

1. 保留当前可用配置，记录当前选择，不先删除旧订阅。
2. 打开 Clash Verge Rev 的“订阅”页，在订阅链接输入框粘贴完整 URL，点击“导入”。
3. 等待结果。如果报错，先保留错误信息，不连续创建多个相同记录。
4. 出现新配置后，点击对应配置卡片切换到它；若切换报错，先处理错误，不以卡片存在作为启用成功的依据。
5. 进入“代理”页检查预期策略组和节点，选择测试所需的节点与模式。
6. 需要用遵循系统代理的浏览器验证时，按项目快速入门启用系统代理，再请求你有权限访问的目标服务。

URL 输入框和导入按钮、onImport 中的地址检查与导入调用，以及 activateProfile 中的当前配置切换，均可在 v2.4.3 的 src/pages/profiles.tsx定位；节点、模式和系统代理的操作范围见 Clash Verge Rev 文档中的快速入门页。访问日期：2026-11-10。

判断：导入解决的是获取配置，选中解决的是使用哪份配置，实际请求解决的是连接是否可用。若新记录无法正常使用，先切回保留的旧记录，再用同一目标复测。

更新边界：固定标签源码中的 onUpdateAll 会筛选 remote 类型记录进行更新，但这不能证明你的定时更新已开启。本文不指定未经核实的默认更新周期；需要定时更新时，以所用版本的订阅设置为准。依据仍为上述固定标签源码，访问日期：2026-11-10。

图形路线二：导入本地 YAML，避免误建空配置

1. 先复制一份原始 YAML，保留未修改备份。
2. 打开 Clash Verge Rev 的订阅页，把本地 .yaml 或 .yml 文件拖入页面。
3. 等待本地配置记录出现，再点击该记录进行切换。
4. 检查预期策略组和节点，并按上一节的方法完成实际请求测试。
5. 取得新版文件后，建议另行导入并验证，不先覆盖唯一可用记录。

拖拽流程的依据是 v2.4.3 的 src/pages/profiles.tsx：handleFileDrop：该函数检查 .yaml 与 .yml 扩展名，读取文件内容，并通过 createProfile 创建 local 类型记录；选中行为对应同一文件中的 onSelect 和 activateProfile。访问日期：2026-11-10。

如果改用“新建配置文件导入”，一定确认已经选择原文件。Clash Verge Rev 文档中的订阅导入页明确说明：不选择文件直接保存会生成空配置；选择的文件会复制到客户端的 profiles 目录。访问日期：2026-11-10。

更新与回滚：本地导入不能当作对原文件的实时同步。建议保留原文件备份和旧配置记录，更新后检查当前选中项；失败就切回旧记录。若主配置另有远程集合，其资源更新应单独检查，不能和本地文件替换混为一谈，集合机制见 Mihomo 代理集合配置文档，访问日期：2026-11-10。

纯内核路线：用本地文件校验，再明确指定加载

以下是唯一一套命令示例，环境为 Windows PowerShell。假设你已创建 C:\MihomoImport 文件夹，其中程序名为 mihomo.exe，完整配置名为 config.yaml；实际路径和文件名请自行替换。

如果只有 URL，先通过原提供方支持的方式取得兼容的完整 YAML。本文不提供把真实订阅 URL 写入终端历史的下载命令；若拿到的只是节点集合，先看下一节，不要直接覆盖主配置。

在上述文件夹打开 PowerShell，先查看版本，再校验文件：

.\mihomo.exe -v

.\mihomo.exe -t -d "C:\MihomoImport" -f "C:\MihomoImport\config.yaml"

只有校验通过，才使用相同目录和文件启动：

.\mihomo.exe -d "C:\MihomoImport" -f "C:\MihomoImport\config.yaml"

参数依据 Mihomo v1.19.17 的 main.go：init 与 main：-v 显示版本，-d 设置配置目录，-f 指定配置文件，-t 测试配置后退出；文件路径处理也在 main 中。访问日期：2026-11-10。这里的 -f 使用本地文件路径，不是把订阅 URL 交给客户端管理的操作。

成功判据：校验没有配置错误，启动没有因初始化错误退出，然后再进行实际请求验证。本页不要求匹配某句监听日志，也不把窗口关闭视为成功。校验与启动是源码中的不同流程，依据为上述 main.go。

回滚：前台运行时可用 Ctrl+C 停止本次实例，再用旧配置执行同一套校验和启动命令；该版本在 main.go 中处理了 os.Interrupt。若测试时另外改过系统代理，应恢复测试前状态，不把停止内核等同于所有网络设置已经恢复。不要同时运行两个测试实例。

只有节点集合：检查定义、引用和更新对象

代理集合不是另一种完整配置导入按钮。根据 Mihomo 代理集合配置文档，集合在 proxy-providers 下定义，类型包括 http、file、inline；根据 代理组通用字段文档，策略组可通过 use 引入集合。访问日期：2026-11-10。

1. 查定义：已有主配置中是否定义了要使用的集合，资源地址或文件路径是否正确。
2. 查引用：如果使用 use，引入的名称是否与集合定义一致；同时检查筛选设置是否排除了预期节点。
3. 查更新：HTTP 集合的 interval 表示集合更新间隔，单位为秒，不代表整份主配置自动更新。
4. 查结果：集合资源加载后，实际使用的策略组是否出现预期节点。

字段含义、集合更新间隔和策略组引入方式，分别依据上述两份文档。这里不增加第二套手写模板：如果你无法确认现有主配置如何引用集合，先向原提供方索取适配的完整配置，再回到图形或纯内核路线。

最终结论：URL 需要先获取内容；本地完整主配置可以交给本文的 -f 示例；节点集合应由主配置引用。主配置保持不变，不代表其远程集合没有更新；集合更新成功，也不代表当前策略组已经选对。

导入后没节点或无法连接：按现象检查，不反复重装

下面是本文建议的定位顺序，不是对任何具体服务状态的判断。空配置与文件复制行为依据 Clash Verge Rev 文档中的订阅导入页，选中与切换依据 固定标签订阅页源码，集合引用依据 Mihomo 代理组通用字段文档；访问日期：2026-11-10。

首次验证建议只改变配置这一项，不同时开启新 TUN 设置或修改 DNS。请求失败时先切回旧配置，对同一个目标复测，避免一次改动多项后无法判断原因。

若配置已经加载、节点也能看到，下一步阅读本站的 连接问题排查指南；只有错误已经指向域名解析时，再看 DNS 分层排查与复测。

参考资料与适用范围

资料访问日期统一为 2026-11-10。图形交互对照 Clash Verge Rev 固定标签 v2.4.3，内核参数对照 Mihomo 固定标签 v1.19.17；文档页面可能继续更新。源码证明的是对应版本的操作实现，不等于本文完成了用户设备上的实测。

• Clash Verge Rev 文档：订阅导入，用于远程与本地导入方式、空配置及复制行为。
• Clash Verge Rev 文档：快速入门，用于节点、模式与系统代理操作范围。
• Clash Verge Rev v2.4.3：src/pages/profiles.tsx，定位 onImport、handleFileDrop、onSelect、activateProfile 和 onUpdateAll。
• Mihomo v1.19.17：main.go，用于参数、路径处理、校验流程和退出信号处理。
• Mihomo 文档：代理集合内容，用于识别集合与主配置的区别。
• Mihomo 文档：代理集合配置，用于集合类型、资源路径与更新间隔。
• Mihomo 文档：代理组通用字段，用于集合引用与节点筛选。

常见问题

Mihomo 没有订阅导入按钮，是不是下载错了？

不一定。先确认使用的是命令行内核还是图形客户端。本文图形路线仅演示 Clash Verge Rev；纯内核使用本地完整配置配合 -t 校验和 -f 加载，具体参数依据正文列出的固定标签 main.go。

订阅 URL 能直接放到 mihomo -f 后面吗？

不要按本文示例这样操作。本文核对版本的 -f 用于指定配置文件，示例使用本地路径。先通过原提供方支持的方式取得兼容主配置；远程节点集合则由主配置中的代理集合机制处理。

本地 YAML 拖入后，修改原文件会同步生效吗？

不能这样假定。正文所引文档说明选择文件导入会复制文件，固定标签的拖拽函数也会读取内容创建本地记录。建议保留旧记录，再导入新版文件并切换验证，不把导入当作原文件实时同步。

导入链接后会自动更新吗？

不能仅凭导入成功认定定时更新已开启。正文固定标签源码支持更新远程记录，但本文不核实用户设备上的默认周期和开关状态。本地文件与远程集合也要分开判断：集合更新间隔不代表整份主配置自动更新。

配置里有 proxies，为什么还是看不到节点？

它可能是节点集合，而不是满足当前用途的完整主配置。先确认当前选中记录，再检查集合是否加载、策略组是否引用，以及筛选条件是否排除了节点。不要只按扩展名或单个字段判断配置完整性。

配置校验通过，就说明可以正常联网吗？

不能。-t 是配置测试，不代替应用代理设置、节点连通性和实际目标服务测试。建议分别确认内容获取、解析、当前配置启用和实际请求四个阶段，失败时回退到对应阶段。

怎样避免更新覆盖唯一可用配置？

首次测试采用新增而非覆盖，保留原文件备份、旧配置记录和测试前网络设置。新配置通过实际请求验证后再决定是否替换；失败时图形客户端切回旧记录，纯内核恢复旧文件并重新校验加载。

相关阅读

• 配置加载后的连接问题排查
• DNS 分层排查与复测

参考资料

1. Clash Verge Rev 文档：订阅导入；访问日期：2026-11-10（clashverge.dev）
2. Clash Verge Rev 文档：快速入门；访问日期：2026-11-10（clashverge.dev）
3. Clash Verge Rev v2.4.3 固定标签：订阅页导入、拖拽、切换及远程记录更新；访问日期：2026-11-10
4. Mihomo v1.19.17 固定标签：参数、路径、配置校验与退出信号；访问日期：2026-11-10
5. Mihomo 文档：代理集合内容；访问日期：2026-11-10
6. Mihomo 文档：代理集合配置；访问日期：2026-11-10
7. Mihomo 文档：代理组通用字段；访问日期：2026-11-10