TAG官网 - TAG VPN套餐价格 | Bronze、Silver、Gold计划 - TAG Pro网络加速返回首页

Mihomo 配置文件下载后怎么使用?Clash Verge Rev 导入与启用步骤

更新于 2026-11-08 · tagss11.buzz

简答:Mihomo 配置文件下载后,先确认文件是真正的 YAML,而不是网页、压缩包或 .yaml.txt;然后在 Clash Verge Rev 的配置页面新建本地配置,选择文件并保存,再点击配置卡片使其成为活动配置。最后选择代理节点、开启系统代理并查看连接日志,导入成功不等于代理已经生效。

定义:Mihomo 配置文件是使用 YAML 语法保存的运行配置,可能包含本地端口、代理节点、代理组、规则、DNS 和其他内核参数。

先做四步速查:下载后按这个顺序启用

  1. 确认文件:检查文件扩展名是否为 .yaml 或 .yml,并用文本编辑器打开确认内容不是网页、登录提示或 JSON 错误信息。Mihomo 使用 YAML 配置格式,YAML 区分大小写,层级依靠空格缩进,不能用 Tab 缩进。可参考Mihomo YAML 语法说明。
  2. 导入文件:打开 Clash Verge Rev,进入左侧配置页面,选择新建本地配置或导入本地文件,再选择下载的 YAML 文件并保存。项目文档列出了“新建配置文件导入”和“拖拽配置文件导入”两种本地导入方式。
  3. 启用配置:保存后点击配置卡片,使它成为当前活动配置。仅看到文件名或导入成功提示,不代表内核已经使用这份配置。
  4. 验证代理:进入代理页面选择一个节点,回到主页开启系统代理,保持规则模式进行首次测试,再查看连接记录。浏览器能打开网页且客户端出现请求记录,才算完成首次启用。
下载文件到代理生效的最短判断表
检查层级你要做什么成功判据
文件查看扩展名和文本内容是 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 配置文件说明。

  1. 启动 Clash Verge Rev,进入左侧的配置或 Profiles 页面。
  2. 点击新建、添加或类似按钮,选择本地配置类型。
  3. 填写一个便于识别的名称,例如“本地测试配置”,然后点击选择文件。
  4. 选择下载的 .yaml 或 .yml 文件,确认后保存。
  5. 如果客户端支持拖拽,也可以把配置文件拖入配置列表;若拖拽没有反应,改用新建本地配置方式。
  6. 在配置列表中找到刚刚保存的卡片,点击卡片或启用操作,使其成为当前活动配置。

成功判据:配置卡片已出现在列表中,点击后客户端没有立即提示解析错误;进入代理页面后能够看到代理组、节点或其他配置内容。只看到文件名并不能证明配置已经被内核采用。

部分版本会把选中的本地文件复制到客户端自己的配置管理目录,原文件移动或删除是否影响已导入配置,应以当前版本行为为准。需要保留原文件时,建议在首次成功启用前不要移动、覆盖或删除下载文件,并自行保留一份备份。

第三步:启用配置、选择节点并开启系统代理

导入完成后,还要完成三个动作:让配置成为活动配置、选择一个代理节点、让浏览器或其他应用指向本地代理端口。它们分别属于配置层、节点层和系统代理层,不能混为一步。

  1. 确认活动配置:回到配置列表,点击刚导入的配置卡片。若客户端显示多个配置,不要默认认为最后导入的文件就是当前使用的文件。
  2. 选择节点:进入代理页面,展开代理组,选择一个明确的节点或自动选择组。若配置只有文件卡片而没有节点,先查看配置内容和日志,不要直接反复更换模式。
  3. 保持规则模式:首次测试建议保持规则模式。Mihomo 文档将运行模式区分为规则、全局和直连;直连模式不会按代理规则转发请求,具体模式定义可参考Mihomo 通用配置说明。
  4. 开启系统代理:回到主页,打开系统代理开关。系统代理只会影响遵循操作系统代理设置的应用,浏览器通常更容易用于首次验证。
  5. 查看请求记录:打开浏览器访问一个普通网页,同时查看客户端连接或日志页面。如果客户端没有任何请求记录,优先检查系统代理地址、端口和客户端运行状态。
“导入成功”与“代理生效”的区别
现象能说明什么还不能说明什么
配置卡片出现文件被客户端保存或识别不代表已经启用
代理组出现配置中存在可读取的代理组或节点结构不代表节点认证成功
客户端状态运行内核或客户端进程正在工作不代表浏览器流量已接管
连接记录出现应用请求已到达客户端不代表每个目标都能访问

本地代理端口由配置中的端口字段或客户端运行设置决定。不要把示例端口当成固定值,也不要在没有看到实际监听端口前直接修改浏览器代理。若客户端主页显示了本地代理地址和端口,应以界面当前显示为准。

导入后不能用:按文件、配置、节点、系统代理顺序排查

  1. 配置列表没有文件:检查文件扩展名、文件权限和实际内容。若文件是压缩包,先解压;若打开后是网页或错误信息,重新获取文件,不要只改扩展名。
  2. 配置出现但没有节点:检查导入文件是否只是节点片段,或是否依赖尚未获取的远程提供器。查看配置文本和客户端日志,确认是否存在可读取的代理、代理组或提供器字段。
  3. 启用时提示解析错误:重点检查 YAML 缩进、冒号后的空格、引号、重复字段和当前内核不识别的字段。Mihomo 的 YAML 语法要求使用空格表示层级,不能用 Tab。
  4. 节点显示但连接失败:查看连接日志中的认证失败、TLS 错误、超时或远端拒绝信息。节点出现在列表中,只能说明配置读到了它,不能证明节点当前可用。
  5. 浏览器没有请求记录:确认系统代理开关已打开,并核对系统代理地址和端口是否与客户端当前监听值一致。导入配置本身不会自动让所有应用使用代理。
  6. 开启高级接管后断网:如果你额外开启了 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 后重新导入,并通过客户端提示和日志确认结果。

相关阅读

参考资料

  1. Mihomo 文档:YAML 配置语法
  2. Mihomo 文档:通用配置与运行模式
  3. Clash Verge Rev 项目文档:本地配置导入
  4. Clash Verge Rev 项目隐私说明
  5. Mihomo 项目发布页