Mihomo配置文件怎么导入？本地YAML与订阅链接完整步骤
简答：先判断你手里的是本地 config.yaml、远程订阅链接，还是单个节点链接：本地 YAML 用 Mihomo 的配置目录或图形客户端导入，订阅链接则应作为远程配置添加。导入后不要直接判断“能启动”就是可用，建议依次完成文件检查、mihomo -t 校验、启动日志和本地代理测试。
定义：Mihomo配置文件导入，是把包含端口、代理节点或代理提供者、代理组和规则等字段的 YAML 配置交给 Mihomo 内核或图形客户端加载。
先判断输入类型：三种链接或文件不要混用
导入前先看清楚手里的内容。不同输入的处理方式不同，单个节点链接不能直接当成完整的 Mihomo 配置文件使用。
| 你手里的内容 | 正确处理方式 | 常见误区 |
|---|---|---|
本地 config.yaml 或 config.yml | 放入 Mihomo 配置目录，或在图形客户端选择本地配置导入 | 文件扩展名实际是 .yaml.txt |
| 远程订阅链接 | 在支持远程配置的客户端中新增远程配置，或写入 proxy-providers | 把订阅链接粘贴进 YAML 后没有配置字段 |
| 单个节点链接 | 先转换为客户端支持的节点配置，不能直接作为完整配置启动 | 只复制一行链接就期待出现代理组 |
截至2026年10月28日，Mihomo 文档将远程节点集合配置放在 proxy-providers 中；HTTP 类型需要填写 url，本地文件类型则使用 path。Mihomo proxy-providers 文档
先试这一步：在文件管理器中开启“显示文件扩展名”，确认文件名确实以 .yaml 或 .yml 结尾；用纯文本编辑器打开，确认内容是 YAML，而不是网页错误页、JSON 提示或订阅失效信息。
导入前准备：备份、目录和敏感信息检查
- 先备份：复制原配置文件，并在副本文件名中加入日期或序号。不要直接覆盖当前能启动的配置。
- 确认配置目录：Mihomo 可以通过启动参数
-d指定配置目录。独立内核场景下，建议使用一个专用目录，例如/path/to/mihomo-config，并将主配置保存为该目录中的config.yaml。 - 检查编码和缩进：使用 UTF-8 保存；YAML 通常依靠空格表示层级，不要用 Tab。冒号、短横线和缩进位置错误，都可能导致加载失败。
- 清理敏感内容：订阅链接可能含个人令牌，节点配置可能含密码、UUID，控制器配置可能含
secret。不要把完整配置或日志原样发到公开论坛。Clash Verge Rev 的隐私说明也提醒，配置文件和日志可能包含订阅令牌、服务器地址、密码、UUID及访问域名。Clash Verge Rev 隐私说明
配置文件中的 external-controller 不应随意绑定到所有网卡；Mihomo 文档说明，监听在 0.0.0.0 会接收所有网络接口的连接，未加密的 HTTP、SOCKS 和 Mixed 入站不应直接暴露到互联网。Mihomo 入站配置文档
独立 Mihomo 内核：放置 config.yaml 并启动
独立内核没有统一适用于所有系统的“固定导入按钮”，核心流程是：准备配置目录、放入主配置、使用同一个目录启动。下面的命令是操作骨架，路径和二进制文件名需要替换成你实际使用的值。
- 创建配置目录，并把本地文件复制为该目录下的
config.yaml。 - 先进入终端或命令提示符，执行配置校验：
mihomo -t -d /path/to/mihomo-config。 - 只有校验通过后，再启动：
mihomo -d /path/to/mihomo-config。 - 观察启动日志，确认没有 YAML 解析错误、端口占用、代理组引用不存在或订阅下载失败。
官方生态中的管理面板在激活配置前也会调用 mihomo -t，并在校验通过后才重启内核；这说明配置校验应放在启动或切换配置之前，而不是出错后才处理。MetaCubeX 配置管理说明
Linux 使用 systemd 时，官方示例将配置复制到 /etc/mihomo，并通过 mihomo -d /etc/mihomo 启动；日志可用 journalctl -u mihomo -o cat -e 查看。普通用户目录和系统服务目录的权限不同，不要在没有确认影响范围前使用管理员权限覆盖文件。Mihomo systemd 服务示例
注意：mihomo -t 主要验证配置能否被内核解析和初始化，不等于订阅一定有效，也不等于每个节点都能连接。配置通过后仍需进行代理端口测试。
图形客户端导入：以 Clash Verge Rev 的配置流程为例
如果你使用的是集成 Mihomo 内核的图形客户端，通常不需要手动寻找内核目录，而是在“配置”或“Profiles”页面导入。
- 本地 YAML：打开配置管理页面，选择新建本地配置或拖拽配置文件；确认文件类型为 YAML，保存后再切换到该配置。
- 远程订阅：在远程配置输入框粘贴订阅链接，保存并等待客户端下载；如果下载失败，先检查链接是否能在浏览器或命令行返回有效内容，再检查系统代理和证书设置。
- 启用配置：导入成功不代表已经使用，仍要点击该配置对应的启用、切换或激活操作。
- 设置代理：根据配置中的
port、socks-port或mixed-port设置系统或应用代理。Mihomo 文档说明，mixed-port同时支持 HTTP(S) 与 SOCKS5，实际端口必须以当前配置为准。Mihomo 代理端口文档
Clash Verge Rev 的公开文档将本地配置分为“新建配置文件导入”和“拖拽配置文件导入”，远程配置则支持订阅链接导入等方式；具体菜单文字可能随客户端版本变化，应以当前界面为准。Clash Verge Rev 配置导入说明
配置中最容易缺少的三个部分
一份能被加载的 YAML，不一定具备完整的代理选择逻辑。排查时可以重点看下面三个区块：
| 区块 | 作用 | 检查重点 |
|---|---|---|
proxy-providers | 从远程链接或本地文件加载一组节点 | HTTP 类型是否有 url，文件类型是否有有效 path，名称是否唯一 |
proxy-groups | 让用户在节点、提供者或策略之间选择 | 引用的名称是否真实存在，是否误写成已删除的节点名 |
rules | 决定流量匹配后走代理、直连或其他策略 | 规则顺序是否符合预期，是否存在无法识别的策略名称 |
如果只有 proxy-providers，但没有代理组使用它，客户端可能已经下载了节点，却不会在界面中出现可选择的代理组。反过来，如果代理组引用了不存在的节点名称，配置校验可能失败或启动后无法正常选择。具体字段仍要以当前 Mihomo 版本文档为准。
导入后校验：按“配置、端口、节点、应用”四层确认
- 配置层：执行
mihomo -t -d 配置目录，先解决 YAML 语法、字段拼写和引用错误。 - 进程层：启动后查看日志，确认内核没有立即退出，且没有端口被占用。
- 代理层：确认客户端显示了代理组和节点，再用实际配置中的本地端口测试。例如配置使用
mixed-port: 7890，可在本机执行curl -x http://127.0.0.1:7890 -I https://example.com。这里的结果只能说明该请求通过指定代理端口完成，不代表所有网站、协议或节点都可用。 - 应用层：最后再开启系统代理、浏览器代理或 TUN。若应用仍无法连接，先关闭 TUN 或恢复原代理设置，确认基础代理端口可用后再逐项启用高级功能。
Mihomo 的代理端口、TUN 和监听器属于不同入站方式；不要把“端口能监听”直接等同于“系统流量已经被 TUN 接管”。Mihomo 入站配置文档
常见失败分流：不要一上来重写整份配置
- 提示 YAML 解析错误：回到报错行附近检查 Tab、缩进、冒号后的空格、引号和重复键；先用最小副本验证，再逐段恢复。
- 代理组为空：检查订阅是否下载成功、提供者名称是否一致，以及代理组是否通过
use或节点名称引用了正确来源。 - 订阅更新失败：先在浏览器或命令行确认链接返回的是有效 YAML或客户端支持的订阅格式，不要把 HTML 错误页保存成配置文件；再检查证书、系统时间和网络路径。
- 端口占用：查看日志中的端口号，关闭占用进程或更换配置端口；更改端口后，系统代理和应用代理也要同步修改。
- 配置能启动但没有网络：先确认代理组已选中节点，再区分 DNS、规则、节点认证和目标站点问题。不要仅凭一次 ping 或单个网页结果判断整体可用。
- 改完重启又恢复旧配置：图形客户端可能保存了远程配置、合并配置或生成运行时配置。应在当前激活配置中修改，或确认自动更新与配置合并设置。
补充更新：导入前后的安全边界
配置导入本身不需要公开订阅链接、密码、UUID或控制器密钥。若需要提交日志或寻求帮助，先删除域名、IP、令牌、认证字段和访问记录。对于远程订阅，建议保留一个本地备份，以便订阅暂时不可访问时回滚；但备份文件同样需要限制访问权限。
本站是第三方使用指南站，不是任何客户端或配置服务的官方站点。Mihomo 内核、图形客户端和订阅提供方的版本、菜单与兼容性可能不同，遇到差异时以当前客户端和内核文档为准。
常见问题
Mihomo 配置文件一定要命名为 config.yaml 吗？
独立内核通常会从配置目录读取默认配置文件；为了减少识别问题，建议主配置使用 config.yaml。若使用 -f 指定文件，则应确认当前版本支持该参数，并让校验和启动使用同一文件。图形客户端可能会复制或重命名导入文件，最终以客户端当前配置列表为准。
config.yaml 和 config.yml 有什么区别？
两者都是常见的 YAML 扩展名，真正影响导入的通常是文件内容、客户端支持方式和文件是否被系统隐藏扩展名。若客户端提示只能选择 YAML，先确认文件不是 config.yml.txt，也不是下载失败后保存的 HTML 页面。
为什么配置导入成功，但代理组里没有节点？
常见原因是订阅没有成功下载、proxy-providers 名称写错、代理组没有引用该提供者，或者订阅返回格式不被当前内核识别。先看更新日志，再检查提供者是否有节点列表，最后检查 proxy-groups 的引用关系。
执行 mihomo -t 通过后，就一定能正常上网吗？
不一定。-t 主要用于校验配置能否被内核解析和初始化；它不能证明每个节点认证成功、DNS正常、规则符合预期或目标网站可访问。还需要启动日志、代理端口测试和实际应用验证。
导入订阅时要不要开启“允许无效证书”？
不要把它作为默认解决方案。先确认订阅地址、系统时间、证书链和网络路径；只有在明确了解风险并确认来源可信时，才按当前客户端说明处理。开启后仍需恢复更安全的证书校验设置。