Mihomo 配置文件下载后怎么使用?Clash Verge Rev 导入与启用步骤
简答:Mihomo 配置文件下载后,先确认文件是真正的 YAML,而不是网页、压缩包或 .yaml.txt;然后在 Clash Verge Rev 的配置页面新建本地配置,选择文件并保存,再点击配置卡片使其成为活动配置。最后选择代理节点、开启系统代理并查看连接日志,导入成功不等于代理已经生效。
定义:Mihomo 配置文件是使用 YAML 语法保存的运行配置,可能包含本地端口、代理节点、代理组、规则、DNS 和其他内核参数。
先做四步速查:下载后按这个顺序启用
- 确认文件:检查文件扩展名是否为
.yaml或.yml,并用文本编辑器打开确认内容不是网页、登录提示或 JSON 错误信息。Mihomo 使用 YAML 配置格式,YAML 区分大小写,层级依靠空格缩进,不能用 Tab 缩进。可参考Mihomo YAML 语法说明。 - 导入文件:打开 Clash Verge Rev,进入左侧配置页面,选择新建本地配置或导入本地文件,再选择下载的 YAML 文件并保存。项目文档列出了“新建配置文件导入”和“拖拽配置文件导入”两种本地导入方式。
- 启用配置:保存后点击配置卡片,使它成为当前活动配置。仅看到文件名或导入成功提示,不代表内核已经使用这份配置。
- 验证代理:进入代理页面选择一个节点,回到主页开启系统代理,保持规则模式进行首次测试,再查看连接记录。浏览器能打开网页且客户端出现请求记录,才算完成首次启用。
| 检查层级 | 你要做什么 | 成功判据 |
|---|---|---|
| 文件 | 查看扩展名和文本内容 | 是 YAML 配置,不是网页或压缩包 |
| 导入 | 在配置页面选择本地文件并保存 | 配置卡片出现在列表中 |
| 启用 | 点击配置卡片切换为活动配置 | 代理页面出现节点或代理组 |
| 代理 | 选择节点并开启系统代理 | 浏览器请求出现在连接记录中 |
本文聚焦“下载本地配置后首次启用”这一问题,以下以 Clash Verge Rev 的桌面图形界面为主。本站是第三方使用指南站,不是 Mihomo 或 Clash Verge Rev 的官方网站;软件版本和界面文字发生变化时,以项目当前文档和客户端实际显示为准。
第一步:确认下载的文件确实能作为配置使用
Windows 用户最容易遇到的不是导入按钮找不到,而是下载结果并不是可用的 YAML。先在文件资源管理器中打开“查看”或“显示”,启用“文件扩展名”,再检查完整文件名。不要只看图标或文件名末尾的一部分。
| 文件状态 | 如何识别 | 处理方式 |
|---|---|---|
.yaml 或 .yml | 可用文本编辑器打开,内容包含 YAML 键值或列表结构 | 进入 Clash Verge Rev 配置页尝试导入 |
config.yaml.txt | 资源管理器显示完整扩展名为 .txt | 先确认内容确实是 YAML,再通过“重命名”去掉末尾的 .txt |
.zip、.gz 等压缩包 | 双击后能看到多个文件 | 先解压,区分可执行程序、说明文件和 YAML 配置 |
| 打开后是 HTML 页面 | 能看到登录页、错误提示、网页标签或下载说明 | 不要直接改后缀,重新获取正确的配置文件 |
| 只有少量节点文本 | 缺少端口、代理组或规则等运行区块 | 可能是节点片段,不要直接当作完整配置导入 |
文件名不是有效性的判断依据。即使文件名叫 config.yaml,也可能是错误页面被保存后的结果;反过来,名称不同的 YAML 文件也可能可以导入。最终应以客户端导入结果、配置校验提示和运行日志为准。
如果配置文件来自远程地址,还要区分“已经下载到本地的文件”和“订阅链接”。本地文件保存的是某一次获取到的内容;订阅链接则需要客户端再次请求远程地址才能更新。不要把订阅链接复制到“选择本地文件”的文件选择框中,也不要把本地 YAML 当成可自动更新的订阅。
第二步:在 Clash Verge Rev 导入本地 YAML
Clash Verge Rev 项目文档说明,本地配置可以通过新建配置文件导入,也可以通过拖拽配置文件导入;文档同时提示,拖拽导入需要满足项目列出的版本条件。由于界面会随版本变化,找不到完全相同的按钮时,应优先寻找“配置”“Profiles”“新建”或“本地配置”等同义入口。具体导入方式可查看Clash Verge Rev 配置文件说明。
- 启动 Clash Verge Rev,进入左侧的配置或 Profiles 页面。
- 点击新建、添加或类似按钮,选择本地配置类型。
- 填写一个便于识别的名称,例如“本地测试配置”,然后点击选择文件。
- 选择下载的
.yaml或.yml文件,确认后保存。 - 如果客户端支持拖拽,也可以把配置文件拖入配置列表;若拖拽没有反应,改用新建本地配置方式。
- 在配置列表中找到刚刚保存的卡片,点击卡片或启用操作,使其成为当前活动配置。
成功判据:配置卡片已出现在列表中,点击后客户端没有立即提示解析错误;进入代理页面后能够看到代理组、节点或其他配置内容。只看到文件名并不能证明配置已经被内核采用。
部分版本会把选中的本地文件复制到客户端自己的配置管理目录,原文件移动或删除是否影响已导入配置,应以当前版本行为为准。需要保留原文件时,建议在首次成功启用前不要移动、覆盖或删除下载文件,并自行保留一份备份。
第三步:启用配置、选择节点并开启系统代理
导入完成后,还要完成三个动作:让配置成为活动配置、选择一个代理节点、让浏览器或其他应用指向本地代理端口。它们分别属于配置层、节点层和系统代理层,不能混为一步。
- 确认活动配置:回到配置列表,点击刚导入的配置卡片。若客户端显示多个配置,不要默认认为最后导入的文件就是当前使用的文件。
- 选择节点:进入代理页面,展开代理组,选择一个明确的节点或自动选择组。若配置只有文件卡片而没有节点,先查看配置内容和日志,不要直接反复更换模式。
- 保持规则模式:首次测试建议保持规则模式。Mihomo 文档将运行模式区分为规则、全局和直连;直连模式不会按代理规则转发请求,具体模式定义可参考Mihomo 通用配置说明。
- 开启系统代理:回到主页,打开系统代理开关。系统代理只会影响遵循操作系统代理设置的应用,浏览器通常更容易用于首次验证。
- 查看请求记录:打开浏览器访问一个普通网页,同时查看客户端连接或日志页面。如果客户端没有任何请求记录,优先检查系统代理地址、端口和客户端运行状态。
| 现象 | 能说明什么 | 还不能说明什么 |
|---|---|---|
| 配置卡片出现 | 文件被客户端保存或识别 | 不代表已经启用 |
| 代理组出现 | 配置中存在可读取的代理组或节点结构 | 不代表节点认证成功 |
| 客户端状态运行 | 内核或客户端进程正在工作 | 不代表浏览器流量已接管 |
| 连接记录出现 | 应用请求已到达客户端 | 不代表每个目标都能访问 |
本地代理端口由配置中的端口字段或客户端运行设置决定。不要把示例端口当成固定值,也不要在没有看到实际监听端口前直接修改浏览器代理。若客户端主页显示了本地代理地址和端口,应以界面当前显示为准。
导入后不能用:按文件、配置、节点、系统代理顺序排查
- 配置列表没有文件:检查文件扩展名、文件权限和实际内容。若文件是压缩包,先解压;若打开后是网页或错误信息,重新获取文件,不要只改扩展名。
- 配置出现但没有节点:检查导入文件是否只是节点片段,或是否依赖尚未获取的远程提供器。查看配置文本和客户端日志,确认是否存在可读取的代理、代理组或提供器字段。
- 启用时提示解析错误:重点检查 YAML 缩进、冒号后的空格、引号、重复字段和当前内核不识别的字段。Mihomo 的 YAML 语法要求使用空格表示层级,不能用 Tab。
- 节点显示但连接失败:查看连接日志中的认证失败、TLS 错误、超时或远端拒绝信息。节点出现在列表中,只能说明配置读到了它,不能证明节点当前可用。
- 浏览器没有请求记录:确认系统代理开关已打开,并核对系统代理地址和端口是否与客户端当前监听值一致。导入配置本身不会自动让所有应用使用代理。
- 开启高级接管后断网:如果你额外开启了 TUN 或修改了 DNS,先关闭新增设置并恢复到仅系统代理的状态,再重新测试。首次导入验证不需要同时修改多个网络变量。
成功判据:配置能被客户端加载,代理组中有节点,客户端出现请求记录,浏览器能够完成基本访问。页面能打开但客户端没有请求记录,可能仍是直连;客户端有请求记录但连接失败,则应继续看节点认证、超时和规则日志。
回滚方法:记下当前配置名称和修改项,关闭系统代理后切回此前能正常使用的配置;如果刚导入的配置导致客户端异常,可删除该配置卡片或恢复导入前的备份。不要在唯一一份配置上连续覆盖修改。
隐私与备份:不要直接公开完整配置文件
配置文件和日志可能包含订阅地址、个人令牌、节点地址、端口、密码、UUID、API 地址或控制器密钥。Clash Verge Rev 的项目隐私说明也提醒,配置、凭据和日志会以本地文件形式保存在设备上,部分内容可能暴露订阅令牌、代理地址和访问元数据,可参考其项目隐私说明。
- 不要把完整 YAML 上传到公开论坛或工单。
- 分享截图前遮挡订阅地址、密码、UUID、节点域名和控制器密钥。
- 分享日志前删除完整 URL、认证头和可能出现的访问域名。
- 修改前复制一份备份,文件名可以加入日期,但不要把真实令牌写进公开文档。
- 如果怀疑订阅链接或凭据已经公开,应根据提供方支持的方式更新或撤销相关凭据。
本文不提供固定版本号、固定端口或固定下载文件名,因为这些内容可能随项目发布和客户端配置变化。需要下载内核或核对版本时,应从Mihomo 项目发布页确认当前系统和 CPU 架构对应的文件。
最后用这张清单确认是否完成
| 项目 | 完成标准 | 未完成时的动作 |
|---|---|---|
| 文件类型 | 扩展名正确,内容不是网页或错误页 | 重新显示扩展名并检查文件内容 |
| 本地导入 | 配置卡片已保存 | 改用新建本地配置方式导入 |
| 活动配置 | 已点击并切换为当前配置 | 不要只停留在配置列表 |
| 节点选择 | 代理组中有已选择节点 | 查看节点、代理组和日志字段 |
| 系统代理 | 开关已开启,地址和端口匹配 | 检查客户端主页与系统网络设置 |
| 请求验证 | 浏览器请求出现在连接记录中 | 区分直连、规则、节点或端口问题 |
| 回滚准备 | 保留原配置或可切回旧配置 | 停止继续修改,先建立备份 |
如果你只想完成一次本地导入,做到“识别文件→导入→启用→选节点→开系统代理→看请求记录”即可,不必一开始就调整 TUN、DNS、规则脚本或其他高级选项。
如果配置已经导入并能产生请求,但仍出现延迟、丢包、DNS 或跨平台连接问题,建议把这些现象单独记录,再进入对应的网络排查流程。
常见问题
Mihomo 配置文件下载后打不开,应该怎么办?
先在 Windows 文件资源管理器中显示完整文件扩展名,确认文件不是 .yaml.txt、压缩包或网页错误页。用文本编辑器查看内容;如果不是 YAML 配置文本,不要只改后缀,应重新获取文件。
配置导入成功但没有节点,是什么原因?
导入成功只代表客户端保存或读取了文件。文件可能只是节点片段,也可能依赖尚未获取的远程提供器。请查看配置内容、代理组字段和客户端日志,区分文件不完整与节点加载失败。
为什么配置启用后浏览器还是直连?
导入和启用配置不等于打开系统代理。请确认已选择节点、系统代理开关已开启,并核对系统代理地址和端口是否与客户端当前监听值一致;同时查看连接记录是否出现浏览器请求。
Mihomo 配置文件一定要叫 config.yaml 吗?
不一定。Clash Verge Rev 的本地导入流程通常允许选择其他名称的 YAML 文件。文件名不是判断配置有效性的依据,最终应以导入结果、解析提示和运行日志为准。
配置文件可以直接发给别人吗?
不建议。配置或日志可能包含订阅令牌、节点地址、密码、UUID、API 地址和控制器密钥。分享前应删除敏感字段,并避免公开完整订阅链接。
首次使用需要同时开启系统代理和 TUN 吗?
不需要。本文的首次验证只要求先选择节点并开启系统代理。若额外开启 TUN 后断网,应先关闭新增设置恢复网络,再单独查看路由、DNS 和权限问题。
导入失败后如何恢复?
先停止继续修改,保留原文件备份,切回此前能正常使用的配置或删除刚导入的配置卡片。修复 YAML 后重新导入,并通过客户端提示和日志确认结果。