Mihomo 订阅配置文件怎么导入？
简答：Mihomo 导入订阅前，先判断你拿到的是远程订阅 URL 还是本地 YAML 文件：远程 URL 用图形客户端的配置或订阅管理入口添加，本地文件直接导入 .yaml/.yml，纯命令行则把配置放入工作目录后启动 Mihomo。导入后还要选中当前配置、选择策略组或节点，并确认代理端口、系统代理或 TUN 已真正生效。本站是第三方使用指南，具体客户端菜单名称可能因平台和版本不同而变化。
定义：Mihomo 订阅配置文件导入，就是把远程订阅链接或本地 YAML 配置加载到 Mihomo 内核或图形客户端中，再选中配置并启用代理。
先判断：你手里的是订阅 URL 还是 YAML 文件
最短判断方法是看内容形态：如果你拿到的是一串以 http:// 或 https:// 开头的地址，它通常是远程订阅 URL；如果你已经下载了以 .yaml 或 .yml 结尾的文件，它属于本地配置文件。Mihomo 使用 YAML 作为配置格式，YAML 对大小写敏感，缩进只能使用空格，不能使用 Tab。可先参考 Mihomo YAML 语法说明核对文件结构。
| 你手里的内容 | 推荐导入方式 | 导入前检查 |
|---|---|---|
| 远程订阅 URL | 图形客户端的配置、Profiles 或订阅管理入口 | 地址完整、没有多余空格，返回内容应是 Clash/Mihomo 可识别配置 |
| 本地 .yaml/.yml | 图形客户端导入本地文件，或复制到 Mihomo 工作目录 | 文件扩展名、YAML 缩进、必需字段是否完整 |
| 只有节点分享链接 | 不能直接当作完整配置导入 | 确认服务端是否提供 Clash/Mihomo 格式订阅 |
特别注意：登录网页、账户管理地址或普通下载页面，不一定就是订阅地址。若浏览器打开后显示 HTML 页面、登录页或错误提示，而不是配置文本，先回到提供方页面重新复制订阅链接。具体订阅格式和可用客户端应以提供方说明为准。
方法一：在图形客户端中通过 URL 导入远程订阅
这是大多数用户最省事的方法。不同 Mihomo 图形客户端的菜单可能叫“配置”“Profiles”“订阅管理”或“添加配置”，但操作逻辑基本相同。
- 备份当前配置。如果客户端里已有能正常使用的配置，先导出或复制保存，避免新订阅导入失败后无法回退。
- 打开配置管理入口。进入客户端的配置、Profiles 或订阅管理页面，寻找“添加 URL”“新建远程配置”或类似按钮。
- 粘贴订阅地址。将完整 URL 粘贴到地址栏；如果客户端要求填写名称，使用容易识别的名称，例如“工作订阅”。不要把包含访问令牌的订阅 URL 发到公开群组或截图中。
- 执行下载或更新。等待客户端完成拉取和解析。如果出现返回内容为空、格式错误或 HTTP 错误，先不要反复点击，转到本文的异常排查部分。
- 选中当前配置。导入成功不等于已经启用，必须在配置列表中点击或勾选该配置，使其成为当前运行配置。
- 选择策略组和节点。打开代理或策略页面，确认策略组中出现节点；如果策略组显示“无可用代理”，先检查订阅格式和配置引用关系。
- 开启代理并验证。按你的使用场景开启系统代理；只有在客户端和平台支持且确有需要时再开启 TUN。Mihomo 的运行模式包括规则、全局和直连，官方配置说明可参考全局配置文档。
验收标准是：配置列表中能看到该订阅、当前配置状态为已选中、策略组能显示节点、日志没有持续解析错误，并且浏览器或目标应用的流量确实经过客户端。单看“导入成功”提示还不够。
方法二：导入本地 YAML 配置文件
如果你已经有 config.yaml 或其他 YAML 文件，可以在图形客户端的“导入本地文件”“添加本地配置”或类似入口选择它。导入后仍然要完成“选中配置—选择策略组—开启代理—验证连接”这条链路。
- 将文件复制到容易找到的位置，并先保留一份原始备份。
- 在客户端配置管理页面选择“本地文件”或“从文件导入”。
- 选择
.yaml或.yml文件，等待客户端解析。 - 如果解析失败，检查冒号后的空格、缩进层级、列表中的短横线，以及是否误用了 Tab。
- 导入成功后点击该文件对应的配置，使其成为当前配置。
- 进入代理组页面，确认配置中的节点或代理提供者已经出现，再开启系统代理或 TUN。
如果本地文件只包含 proxy-providers，它可能只是“远程代理提供者”定义，并不等同于已经建立可选择的代理组。官方示例显示，代理提供者通常需要配置唯一名称、url、type: http 等字段；详情可查看proxy-providers 配置文档和官方快速配置示例。
结构示例，不可直接复制：
proxy-providers:
provider1:
url: "替换为你的订阅URL"
type: http
interval: 86400
上面只是展示字段关系，实际配置还可能需要代理组、规则、端口或 DNS 等内容。不要把示例中的占位地址直接保存为正式配置，也不要为了“能启动”随意删除原文件中的字段。
方法三：纯 Mihomo 命令行加载 config.yaml
没有图形客户端时，可以直接使用 Mihomo 二进制程序加载配置目录。官方服务示例使用工作目录方式运行：将配置文件放入 Mihomo 目录，再通过 -d 指定配置目录；相关做法可参考Mihomo 官方服务启动说明。
- 准备与当前操作系统和 CPU 架构匹配的 Mihomo 程序。官方发布页会按系统、架构和编译方式区分文件，下载前应参考官方文件选择说明。
- 建立一个专用工作目录，并把配置文件命名为便于识别的名称，例如
config.yaml。 - 将订阅配置或本地 YAML 放入该目录。若使用
proxy-providers，还要确认订阅 URL 可访问，并且配置中有能够引用代理提供者的策略组或规则。 - 先在终端中使用当前构建支持的帮助参数核对启动选项，不要直接套用其他版本的命令。
- 按照官方示例思路，用工作目录启动，例如
mihomo -d /path/to/config。其中路径必须替换为你的实际目录，Windows、macOS、Linux 的路径写法不同。 - 查看启动日志。如果出现 YAML 解析错误，先修复文件格式；如果能启动但没有节点，继续检查代理提供者下载和代理组引用。
如果你配置了外部控制 API，可以通过 API 查询当前运行配置；官方 API 文档列出了 /configs 和 /version 等接口，但 API 监听地址和密钥必须妥善保护，避免把管理接口暴露给不受信任的网络。可参考Mihomo API 文档。
导入后怎么确认配置真的生效
建议按下面的顺序验收，不要只看客户端是否显示“已连接”。
| 检查项 | 怎么做 | 异常说明 |
|---|---|---|
| 当前配置 | 回到配置列表，确认刚导入的配置处于选中或运行状态 | 未选中时，客户端可能仍在使用旧配置 |
| 节点或代理组 | 打开代理、策略或 Proxies 页面，查看是否有可选节点 | 没有节点通常优先检查订阅返回内容、代理提供者和 YAML 引用 |
| 日志 | 观察更新、解析、连接相关日志 | 持续出现 YAML、超时或下载错误时，不要直接开启 TUN |
| 本地代理 | 查看配置中的 mixed-port、HTTP 或 SOCKS 端口，并在应用中按实际端口填写 | 端口被占用或应用填写错误会表现为无法连接 |
| 系统代理或 TUN | 先只启用一种接管方式，再访问普通网页或工作应用测试 | 多套代理软件同时接管可能造成端口或路由冲突 |
对于普通桌面应用，优先先验证系统代理；只有应用不遵循系统代理、需要接管更多流量或客户端明确要求时，再考虑 TUN。TUN 涉及路由、权限和 DNS，出现问题时应先关闭 TUN，回退到系统代理进行分流定位。
常见导入失败：按现象分流排查
提示 YAML 解析失败
先用文本编辑器检查缩进是否使用空格、键名后是否有空格、引号和冒号是否成对，以及是否把网页内容误保存成了 YAML。Mihomo 官方语法说明明确指出 YAML 使用缩进表示层级，Tab 不能作为缩进。
导入成功但没有节点
先打开订阅 URL 查看返回结果是否是配置文本，而不是登录页、错误页或空白页；再检查配置是否只定义了 proxy-providers，却没有代理组引用它。若订阅需要通过特定格式转换，应以提供方支持的 Clash/Mihomo 格式为准，不要自行猜测字段。
配置能加载但更新失败
检查订阅地址是否过期、网络是否能访问该地址，以及客户端是否把旧配置缓存为当前版本。可以先保留旧配置，再新建一个远程配置测试，避免直接覆盖原配置。
有节点但浏览器仍然直连
确认当前配置已选中，再检查系统代理是否开启、浏览器是否有独立代理设置，以及是否同时运行了其他网络接管软件。若只在 TUN 模式下失败，先关闭 TUN，用系统代理复测，以区分配置问题和路由权限问题。
订阅链接泄露怎么办
订阅 URL 往往包含访问凭证。不要公开发布完整链接、截图二维码或把它提交到不可信的在线解析服务；如果怀疑已经泄露，应按提供方支持的方式重新生成或撤销订阅地址。
常见问题
Mihomo 可以直接导入普通节点分享链接吗？
不能默认认为可以。单个节点分享链接与完整 Clash/Mihomo 配置不是同一种内容；应先确认提供方是否支持 Clash 或 Mihomo 格式订阅，再通过远程 URL 或本地 YAML 导入。
订阅 URL 导入后为什么看不到节点？
优先检查三点：URL 返回的是否是配置而不是网页；配置中的 proxy-providers 是否成功下载；代理组是否引用了该代理提供者。只导入一个提供者定义，不一定会自动生成可选择的节点组。
导入配置后必须开启 TUN 吗？
不必须。可以先使用系统代理验证配置和节点是否正常；只有应用不使用系统代理或确实需要更完整的流量接管时，再根据客户端和系统支持情况开启 TUN。
修改 YAML 后为什么客户端没有变化？
常见原因是修改的文件不是当前运行配置，或客户端没有重新载入文件。先确认配置列表中的当前文件，再执行客户端提供的更新、重载或重新选择操作；无法确认时保留旧配置并新建副本测试。
Mihomo 配置文件应该放在哪里？
图形客户端通常允许从本地文件选择，不必手动猜目录；纯命令行则应放入你指定的工作目录。官方服务示例使用 <code>-d</code> 指定 Mihomo 配置目录，具体路径应按当前系统和启动方式调整。