Mihomo 订阅配置怎么导入？完整步骤与故障排查
简答：Mihomo 订阅配置导入通常分为两种方式：在图形客户端中粘贴远程订阅 URL，或导入本地 YAML 文件。最短流程是复制 Clash、Clash Meta 或 Mihomo 格式的完整订阅地址，进入客户端的配置/Profile 页面添加，下载并加载配置，再到代理组选择节点、开启系统代理，最后用网页访问或日志确认流量已经接管。
定义：Mihomo 订阅配置是由远程 URL 或本地 YAML 文件提供的代理节点、代理组和规则配置，导入后还必须完成加载、启用和流量验证才算真正生效。
先试这一步：确认你拿到的是正确的 Mihomo 订阅
本文是面向客户端使用者的第三方操作指南，不代表任何订阅服务或客户端项目的官方页面。导入前先不要急着修改 DNS、TUN 或高级规则，优先确认订阅格式和配置是否能被客户端识别。
| 你手里的内容 | 适合的导入方式 | 是否能自动更新 | 先检查什么 |
|---|---|---|---|
| 以 http:// 或 https:// 开头的完整订阅地址 | 在 Profiles、配置或订阅页面通过 URL 添加 | 通常可以，更新周期以客户端和服务端设置为准 | 地址是否完整、是否包含必要的 token、返回内容是否为配置而不是网页 |
| 本地 .yaml 或 .yml 文件 | 通过“从文件导入”或“导入本地配置”添加 | 不能依靠本地文件自动获取远程更新 | 文件是否为 Mihomo 可识别的 YAML，是否包含代理组或可用节点 |
| Base64、JSON、V2Ray 等其他格式链接 | 不能直接假定兼容 Mihomo | 需由客户端或转换工具支持 | 订阅页面是否明确标注 Clash、Clash Meta 或 Mihomo 格式 |
如果你使用的是自己的订阅面板，请登录后台后寻找名称类似“Clash”“Clash Meta”“Mihomo”“配置订阅”或“复制订阅链接”的入口。不要只复制浏览器地址栏，也不要把只用于网页登录的地址当成订阅 URL。订阅地址通常包含账户识别信息，应当像密码一样保存；公开粘贴或转发后，建议回到面板重新生成或重置链接。
官方 Mihomo 文档把远程节点来源区分为配置文件和 proxy-providers；其中远程 provider 通常需要 URL、保存路径和更新间隔等字段。对普通用户来说，优先使用图形客户端提供的订阅导入入口，不要在第一次导入时手工改写 YAML。可参考 Mihomo 官方 proxy-providers 文档。
图形客户端导入远程订阅：最短可复制流程
- 复制完整订阅地址。在订阅面板中选择 Clash、Clash Meta 或 Mihomo 格式，点击复制。复制后可先粘贴到记事本检查是否从 http:// 或 https:// 开始，且中间没有换行或多余空格。
- 打开客户端的配置入口。不同客户端可能叫 Profiles、配置、订阅、Profiles 管理或配置文件。进入后选择“添加订阅”“从 URL 导入”或同类按钮；菜单名称会随客户端版本变化，以当前界面显示为准。
- 粘贴 URL 并保存。名称可以写成容易识别的名称，例如“主订阅-2026-11”，但不要把完整订阅地址写进公开名称或截图中。
- 执行下载或更新。有些客户端添加 URL 后会自动下载，有些客户端需要再点击“下载配置”“更新订阅”或刷新按钮。看到配置大小、更新时间或节点数量发生变化，才说明远程内容已经返回。
- 加载并设为当前配置。“已添加”不等于“已启用”。在配置列表中选中刚下载的配置，点击加载、启用、激活或设为当前配置。部分客户端会在加载前进行格式检查。
- 进入代理组选择节点。打开 Proxies、代理或策略组页面，先找到名为“Proxy”“默认”“节点选择”或类似的主代理组，再选择一个节点。只看到节点列表但没有选中代理组，不一定会有实际流量经过节点。
- 开启代理接管。桌面端通常需要打开系统代理；如果客户端提供 TUN，则应先确认当前系统和客户端版本支持，再按需启用。首次排查不要同时修改系统代理、TUN、DNS 和规则，避免无法判断是哪一步造成问题。
这套流程对应五个检查点：订阅能否下载、内容能否解析、配置是否加载、代理组是否选中、系统流量是否被接管。任何一个检查点失败，后面的步骤都不会自动补救。
如果使用的是带 Mihomo 内核的管理面板，官方 metacubexd 文档说明，配置管理可以通过 URL 导入远程 profile，并在激活前进行 Mihomo 配置校验；这也说明“导入”和“激活”是两个不同动作。可参考 MetaCubeX metacubexd 官方项目说明。
本地 YAML 配置怎么导入？什么时候不该用本地文件
如果你已经拿到一个 .yaml 或 .yml 文件，可在客户端的配置页面选择“从文件导入”“导入本地配置”或相近入口，然后选择文件。导入后仍要执行加载或激活，再进入代理组选择节点。
- 确认文件扩展名为 .yaml 或 .yml，且文件内容不是 HTML 登录页。
- 用文本编辑器打开时，先观察是否能看到
proxies、proxy-groups、rules或其他 Mihomo 配置字段；字段不完整不代表一定错误，但明显是网页源码时不能继续。 - 导入后查看客户端是否提示 YAML 解析错误、缺少必要字段或配置校验失败。
- 通过“加载”“启用”或“激活”让它成为当前配置，再进入代理组选择节点。
本地文件适合临时测试、手工维护或已经确认内容的离线配置；它通常不会随着远程订阅自动更新。远程订阅适合需要定期获取节点变化的场景，但每次更新后也要检查当前配置是否仍被激活，以及代理组是否仍指向有效节点。
不要把一个只包含节点列表的文件误认为完整配置。Mihomo 的完整配置还可能需要代理组、规则、端口等部分；如果导入后有节点却无法选择，重点查看是否缺少 proxy-groups 或代理组没有引用这些节点。
导入成功但不能上网：按现象分流
| 现象 | 优先判断 | 处理动作 |
|---|---|---|
| 订阅下载失败或一直超时 | URL、网络访问或订阅服务响应异常 | 重新复制完整 URL，去掉首尾空格；在客户端内重新更新。不要把浏览器能打开网页当成订阅一定可用。 |
| 返回 401 或 403 | 订阅凭证失效、权限不足或地址已被重置 | 回到订阅面板重新复制，确认账户状态和授权信息；不要反复导入同一个失效地址。 |
| 返回 HTML、登录页或验证码页面 | 复制的是网页地址，不是订阅接口 | 回到面板寻找 Clash、Clash Meta 或 Mihomo 格式的复制入口。 |
| 导入成功但节点为空 | 格式不兼容、配置被筛选，或返回内容本身没有节点 | 查看配置预览或原始内容，确认不是 Base64、JSON 或其他格式；再检查面板是否生成了正确类型的订阅。 |
| 有节点但没有代理组 | 导入的是节点文件而不是完整配置 | 使用完整配置，或在确认字段兼容后为节点配置代理组；新手不建议直接复制网上的未知模板。 |
| 节点可见但网页仍走本地网络 | 配置未激活、代理组未选择，或系统代理未开启 | 依次确认当前配置、主代理组、系统代理开关；先不要修改 DNS 和 TUN。 |
| 客户端启动后配置消失或无法加载 | YAML 语法错误、权限问题或配置版本不兼容 | 切回上一个可用配置，保留错误提示和日志，再逐项检查缩进、引号及客户端支持的字段。 |
如果客户端支持日志，优先查看导入时的 HTTP 状态码、解析错误和启动错误。不要把“配置文件能打开”当作“节点能连通”，也不要把某个普通网页能访问当作所有目标应用都已经恢复。
导入后的验证、复测与回滚
验证顺序
- 在代理组页面确认主代理组已经选中具体节点，而不是停留在空选择或直连。
- 确认系统代理开关状态；桌面端还要检查系统网络设置中是否出现客户端设置的代理。
- 打开一个普通 HTTPS 网站进行基础访问测试，再查看客户端连接日志是否出现请求。
- 如需确认出口变化，可使用你信任的 IP 检测页面，但结果只代表该次请求，不等于所有应用、网站或节点都可用。
- 如果只有部分应用不通，再分别判断应用是否遵循系统代理、是否需要 TUN，以及规则模式是否把该流量分到了直连。
回滚方法
- 在修改前保留原有可用配置，不要直接覆盖唯一配置文件。
- 如果更新订阅后异常，先切回上一次成功加载的配置，再关闭系统代理或 TUN，恢复到能正常使用的基础状态。
- 删除重复或失效的 profile 前，先确认当前生效的配置名称，避免误删正在使用的配置。
- 记录错误提示、更新时间、配置名称和客户端版本；需要求助时只提供脱敏后的日志，不要公开订阅 URL、token 或账户信息。
如果你直接运行 Mihomo 核心而不是使用图形客户端，官方文档提供了配置目录和服务运行方式；此时导入本质上是把有效 YAML 放入核心读取的配置位置，并通过核心的配置检查和日志确认启动结果。直接运行核心时，文件路径、权限、端口和服务管理方式不能照搬图形客户端界面，建议以 Mihomo 官方服务运行文档为准。
首次导入时哪些设置可以先不改
第一次只为完成订阅导入和基础连接验证时，可以暂时不改 DNS、MTU、IPv6、规则集、代理链和 TUN。先让默认配置完成“下载—解析—加载—选组—系统代理—复测”闭环，再根据具体现象单独调整一个变量。
- DNS：只有出现域名解析失败、特定域名打不开或日志明确指向解析问题时再排查。
- MTU：只有出现连接建立后频繁断开、部分网页加载不完整等现象时再测试，不要凭经验直接填写固定值。
- TUN：只有需要接管不遵循系统代理的应用时再考虑，并先确认客户端、系统权限和网络驱动支持。
- 规则模式：新手优先确认当前模式和代理组选择，避免同时切换规则、全局和直连造成结果难以比较。
对于配置字段，版本差异可能导致同名字段的可用取值和行为变化。发现字段校验失败时，应以当前 Mihomo 官方文档和客户端实际提示为准，不要把其他核心或旧版本配置直接复制过来。
常见问题 FAQ
Mihomo 订阅链接和节点链接是一回事吗？
不一定。订阅链接通常返回一组节点或完整配置，节点链接可能只代表单个节点。导入前应选择面板明确标注为 Clash、Clash Meta 或 Mihomo 的订阅格式。
订阅添加后为什么还要点击下载或更新？
添加 URL 只是保存远程来源，客户端还需要请求地址并取得内容。部分客户端自动下载，部分客户端需要手动点击更新；看到配置内容或更新时间变化后，再执行加载或激活。
导入成功但代理页面没有节点怎么办？
先确认返回内容不是 HTML 登录页，再检查订阅格式是否兼容、配置是否实际加载，以及面板是否返回了空内容。如果只有节点没有代理组，则可能导入的是节点列表而不是完整配置。
本地 YAML 文件可以替代远程订阅吗？
可以用于临时测试或固定配置，但本地文件通常不会自动获得远程更新。节点发生变化时，需要重新取得文件并再次导入或替换。
要不要一导入就开启 TUN？
通常不需要。先用系统代理完成基础验证；只有目标应用不遵循系统代理，且客户端和系统具备相应支持时，再单独测试 TUN。
重复导入多个订阅会影响连接吗？
重复 profile 本身不一定导致连接失败，但会增加误选配置、更新错对象和排查混乱的概率。建议给配置使用清晰名称，并定期删除已确认失效的重复项。
常见问题
Mihomo 订阅链接和节点链接是一回事吗？
不一定。订阅链接通常返回一组节点或完整配置，节点链接可能只代表单个节点。优先选择面板明确标注为 Clash、Clash Meta 或 Mihomo 的订阅格式。
订阅添加后为什么还要点击下载或更新？
添加 URL 只是保存远程来源，客户端还需要请求地址并取得内容。下载成功后还要加载或激活，才会成为当前配置。
导入成功但代理页面没有节点怎么办？
检查返回内容是否为 HTML 登录页、订阅格式是否兼容、配置是否已经加载，以及面板是否返回空内容；如果只有节点没有代理组，可能导入的不是完整配置。
本地 YAML 文件可以替代远程订阅吗？
可以用于临时测试或固定配置，但本地文件通常不会自动更新。节点变化后，需要重新取得文件并再次导入或替换。
要不要一导入就开启 TUN？
通常不需要。先用系统代理完成基础验证；只有目标应用不遵循系统代理，且客户端与系统支持时，再单独测试 TUN。