Mihomo 订阅怎么导入配置文件？链接与 YAML 文件完整步骤

更新于 2026-10-31 · stc-spadesdns.cyou

简答：Mihomo 导入订阅前，先判断手里的是订阅链接还是本地 .yaml/.yml 文件。图形客户端通常按“配置/Profiles/订阅管理→添加 URL 或导入文件→更新→设为当前配置→选择代理组”操作；命令行则把订阅写入 proxy-providers，或将现成配置放入 Mihomo 工作目录后启动。导入成功不等于已经联网，还要确认配置已启用、代理组有节点，并按客户端方式开启系统代理或 TUN。

定义：Mihomo 是负责解析配置、加载代理节点和处理流量的核心；订阅链接或本地 YAML 文件是配置来源，图形客户端只是管理和控制这个核心的界面。

先判断你拿到的是什么：订阅链接还是配置文件

先不要直接点击导入。把内容分成三类，后面的入口不同：

你手里的内容	外观或判断方式	正确处理	成功标准
订阅链接	一段较长的 HTTP 或 HTTPS 地址，常带随机 token；不要把它公开	在图形客户端的配置、Profiles、订阅管理或远程配置入口中添加 URL	客户端能拉取配置，出现配置名称、代理组或节点
远程配置	服务方明确说明是 Clash、Clash Meta 或 Mihomo 格式的 URL	按客户端支持的格式添加，并在保存后执行更新	配置可以被解析，节点或代理组不为空
本地 YAML 文件	文件名通常为 .yaml 或 .yml，打开后可见 mixed-port、proxies、proxy-groups、rules 等字段	使用导入文件或配置文件目录入口；命令行则放入 Mihomo 工作目录	文件能通过校验并被设为当前配置

Mihomo 官方配置文档把远程节点来源写在 proxy-providers 中，HTTP 类型需要 url；本地文件则可作为配置文件或文件型 provider 使用。Mihomo 官方 proxy-providers 文档

如果你使用的是 Mihomo Party、Clash Party 或其他图形前端，不要把前端名称和内核混为一谈：前端负责按钮、配置列表和系统集成，Mihomo 负责读取配置和运行代理。不同项目的菜单名称可能不同，以下统一按功能名称描述，以当前界面实际文字为准。

图形客户端导入订阅链接：按这 5 步操作

复制订阅链接。从提供方后台复制完整 URL，不要手动删掉参数或换行。订阅链接通常同时具备识别信息和访问凭证，建议只粘贴到你信任的客户端，不要发到群聊、工单截图或公开代码仓库。
打开配置入口。在客户端中寻找“配置”“Profiles”“订阅管理”“远程配置”或相近名称。若当前页面只有“代理”，那通常是选节点的页面，不一定是添加订阅的入口。
添加 URL 并选择格式。粘贴链接，名称可自定义；格式优先选择服务方明确提供的 Clash、Clash Meta 或 Mihomo 选项。无法确认时，不要把格式名称当成协议名称，也不要仅凭端口号判断格式。
保存后执行更新或下载。有些客户端“添加”只保存地址，“更新/下载”才真正拉取内容。等待配置状态从失败、等待或空白变为可加载；如果出现 HTML、登录页或格式错误，先检查链接是否完整、是否过期，以及返回内容是否真的是 YAML 配置。
设为当前配置。在配置列表中点击使用、启用、激活或相近按钮，再进入代理页面。官方 MetaCubeXD 的配置管理流程也将“通过 URL 导入”“激活配置”和“校验后启动内核”分开处理。MetaCubeXD 官方配置管理说明

成功标准：配置列表中有已启用的配置，代理页面能看到代理组或节点，且客户端的本地代理入口已经启动。仅看到订阅名称，不能证明节点已加载；仅看到 TUN 开关打开，也不能证明目标连接已经成功。

本地 .yaml/.yml 配置文件怎么导入

如果你已经拿到现成的 YAML 文件，不要把文件内容粘贴到订阅 URL 输入框。使用客户端的“导入文件”“打开配置目录”或相近入口，选择文件后再执行校验、加载和启用。

保留原文件副本，例如复制一份为 config-backup.yaml，先不要覆盖原文件。
在客户端选择导入本地文件，选中 .yaml 或 .yml 文件。
如果客户端提示解析错误，先检查缩进、冒号、引号和列表短横线，不要一次修改多个字段。
导入后将它设为当前配置，再检查代理组是否引用了实际存在的节点或 provider。
确认代理入口启动后，再开启系统代理或 TUN；测试失败时先关闭刚开启的功能并恢复到原配置。

如果你使用的是纯 Mihomo 核心，官方服务文档示例是将配置文件放入 Mihomo 的工作目录，并通过 mihomo -d /etc/mihomo 运行服务；实际目录应按你的系统、启动参数和权限调整。Mihomo 官方服务启动文档

纯核心没有统一的“导入按钮”。它读取工作目录中的配置文件；如果你只是想加载一个订阅地址，可以在配置中使用下面的结构示例，其中 URL、名称和策略组需要按你的实际内容替换，不能原样当作可直接启动的完整配置：

proxy-providers: my-provider: type: http url: "https://example.invalid/replace-with-your-subscription" path: ./proxy_providers/my-provider.yaml interval: 86400

官方快速配置示例同样使用 proxy-providers、type: http、url 和更新间隔等字段。Mihomo 官方快速配置示例

命令行导入订阅：只做结构配置，不把占位地址当真实链接

命令行方式适合已经安装 Mihomo 核心、能够管理文件和进程的用户。最小流程是：创建工作目录、准备 config.yaml、写入 provider、校验配置、启动核心。

创建工作目录。例如 Linux 可使用你有权限管理的目录；不要直接照抄系统目录，先确认目录归属和读写权限。
编辑 config.yaml。将实际订阅地址放入 proxy-providers 的 url 字段，并为 provider 设置唯一名称。官方文档要求 provider 名称唯一。Mihomo provider 字段说明
补齐能运行所需的其他配置。订阅 provider 只是节点来源，不自动替你创建可用的代理组、规则和本地代理端口。官方配置示例包含 mixed-port、mode、external-controller 等字段，但你应根据现有配置和客户端需求逐项确认。
先校验再启动。如果你的发行版或管理面板提供配置测试，先运行测试；MetaCubeXD 的官方说明使用 mihomo -t 作为激活前的最终校验。MetaCubeXD 官方校验说明
启动并观察日志。记录启动输出，再逐项区分 YAML 解析失败、订阅下载失败、本地端口占用和目标连接超时。一次只改一个变量，改动后重新校验。

回滚方式：停止 Mihomo，恢复备份的 config.yaml，删除本次生成的 provider 缓存前先保留日志；确认旧配置可启动后，再单独替换订阅地址或 provider 设置。

导入后怎样选节点并验证真的可用

检查层级	操作	预期结果	失败时下一步
配置层	确认配置被设为当前或激活状态	客户端显示当前配置，内核未持续报配置错误	重新导入或恢复备份，检查 YAML 格式
节点层	打开代理组，选择一个实际节点或自动选择组	代理组中有可选择项，选择状态发生变化	检查订阅是否过期、provider 是否更新成功
入口层	查看 HTTP、SOCKS 或 mixed 入口状态	本地入口正在监听，客户端没有端口占用错误	检查端口是否被其他程序占用，不要把端口号当成协议类型
系统层	先开启系统代理；只有需要接管更多应用时再考虑 TUN	浏览器或测试应用确实使用了客户端入口	检查系统代理地址、端口、权限和应用自身代理设置
目标层	访问一个你有权访问的普通 HTTPS 页面，并查看日志	请求完成且日志不再出现 DNS、TLS 或上游超时	按 DNS、代理组、TLS 和上游网络顺序排查

Mihomo 文档将代理端口、TUN 和 listeners 视为不同的流量入口；是否能访问目标，还取决于监听地址、系统路由和防火墙。因此，“mixed-port 已开启”或“TUN 已打开”都不能单独证明目标网站可用。Mihomo 官方入口配置说明

建议先用系统代理完成一次最小验证，再决定是否启用 TUN。TUN 涉及系统路由、DNS 和权限，遇到断网时先关闭 TUN 并恢复系统代理，便于判断问题是在代理入口、DNS、路由还是目标连接。

常见导入失败：按现象定位，不要同时乱改

返回 HTML、登录页或“不是 YAML”。可能是订阅链接失效、需要重新登录，或服务端返回了网页而不是配置。用浏览器打开只能用于观察返回类型，不要公开完整链接；回到提供方后台重新复制并更新 token。
YAML 解析失败。先看报错行号，检查该行附近的缩进、冒号、引号和列表结构。恢复备份后只改一个字符或字段，再重新校验。
配置导入成功但没有节点。检查 provider 是否更新成功、内容是否为空，以及代理组是否引用了 provider。provider 配置中 type、url 和路径字段必须与实际类型匹配。官方 provider 配置参考
节点出现但无法联网。先确认代理组已选中节点，再确认系统代理指向客户端实际监听地址；不要先修改 DNS 或开启 TUN。若日志显示 DNS 解析失败，再单独处理 DNS；若 CONNECT 已建立但 TLS 或目标连接失败，则不要把问题归因于本地端口。
更新后自定义规则消失。不要直接改远程订阅原文；使用客户端支持的覆写或本地配置分层保存。具体字段必须以当前客户端和 Mihomo 文档为准，未知字段不要直接复制。

安全提醒：订阅 URL 往往等同于访问凭证。不要把完整 URL 放进截图、公开仓库或聊天记录；如果怀疑泄露，优先在提供方后台重置或重新生成订阅地址。本文不核验任何具体订阅服务的有效性、价格或状态。

这篇指南的适用边界

本文是第三方使用指南，不是“STC-SPADES”官方页面，也不代表任何订阅服务或客户端项目。文中只说明 Mihomo 核心、图形前端和通用配置之间的关系；具体按钮名称、订阅格式选项、系统权限和当前版本行为，以你正在使用的客户端界面及其官方说明为准。

如果你已经完成导入但仍然连接失败，下一步应先记录客户端日志中的具体错误，再按“本地入口→配置和节点→DNS→系统代理/TUN→目标连接/TLS”的顺序排查，而不是反复点击更新订阅。

常见问题

Mihomo 订阅链接应该导入哪里？

如果使用图形客户端，进入“配置”“Profiles”“订阅管理”或“远程配置”等入口，添加 URL 后再执行更新并设为当前配置。如果使用纯 Mihomo 核心，则把实际 URL 写入 config.yaml 的 proxy-providers，不能把链接当作本地 YAML 文件。

订阅导入后为什么没有节点？

先检查是否真的执行了更新，再检查 provider 返回内容是否为空或格式错误，最后确认代理组是否引用了该 provider。只看到订阅名称不代表节点已经加载。

Mihomo 导入 YAML 时提示解析错误怎么办？

根据报错行号检查缩进、冒号、引号和列表短横线，先恢复备份，再一次只改一个字段。不要把未核实的完整配置直接覆盖原文件。

导入成功后需要马上开启 TUN 吗？

不需要。先启用配置、选择节点并用系统代理完成最小验证；只有需要接管更多应用或处理系统级流量时，再根据客户端权限和系统支持情况考虑 TUN。

订阅链接泄露了怎么办？

把它当作访问凭证处理，立即在提供方后台重新生成或重置订阅地址，并删除公开位置的旧链接。不要只修改客户端名称，因为名称变化不会使旧链接失效。