Mihomo 怎么导入订阅?配置文件、订阅链接与节点更新步骤
简答:Mihomo 导入订阅的关键不是直接粘贴链接,而是先判断手里的内容类型:订阅链接用于远程更新,YAML 文件用于本地配置,单节点 URI 只能作为单个代理导入。最快做法是从已登录的服务后台复制明确标注为 Clash、Clash Meta 或 Mihomo 的订阅地址,在支持 Mihomo 的客户端中选择“添加订阅/从 URL 导入”,保存后设为当前配置,再检查代理组和节点数量。本文未核实 bv2.best 当前后台的具体菜单名称,以下按通用界面说明,实际名称以当前页面为准。
定义:Mihomo 订阅是一个可重复请求的远程配置或节点地址,客户端能够按链接下载并在更新时重新获取内容;本地 YAML 则是已经保存到设备上的配置文件,单节点 URI 只描述一个节点,不能替代完整订阅。
先判断你拿到的是什么:订阅、YAML 还是单节点
导入失败最常见的原因之一,是把不同类型的内容放进了错误入口。先不要修改 DNS、TUN 或端口,按下面的特征判断。
| 内容类型 | 常见表现 | 适合的入口 | 更新方式 |
|---|---|---|---|
| 订阅链接 | 一串以 http:// 或 https:// 开头的地址,通常带有较长参数或令牌 | 客户端的“订阅”“配置 URL”“远程配置” | 手动点击更新,或按客户端支持的周期更新 |
| 本地 YAML | 文件名通常以 .yaml 或 .yml 结尾,打开后可看到 proxies、proxy-groups、rules 等字段 | 客户端的“导入文件”“打开配置”或原生 Mihomo 的配置目录 | 重新替换文件,或改用 proxy-providers 远程更新 |
| 单节点 URI | 以某种协议名称开头,内容通常只描述一个节点 | 客户端的“添加节点”“从剪贴板导入节点” | 通常不能像订阅一样批量更新 |
Mihomo 官方配置将远程节点集合定义为 proxy-providers,支持 http、file 和 inline 类型;其中远程类型需要配置 url,并可设置保存路径和更新间隔。可参考 Mihomo 官方 proxy-providers 文档。
从后台复制正确的 Mihomo 订阅链接
- 登录你购买或获得订阅的服务后台,进入订阅、套餐、节点或客户端配置相关页面。
- 寻找明确写有“Clash”“Clash Meta”“Mihomo”或“通用订阅”的复制按钮。不要把登录页网址、用户中心网址或单个节点详情页地址当成订阅链接。
- 复制后先粘贴到临时文本框,确认没有多余空格、换行或中文引号。订阅链接通常包含访问令牌,不要发到公开群组、工单截图或代码仓库。
- 如果后台只提供一种通用链接,无法确认格式是否兼容 Mihomo,先在客户端执行一次更新;若返回 HTML 登录页、JSON 错误信息或空内容,应回到后台核对格式,而不是直接修改 YAML。
本文没有核实 bv2.best 当前后台是否提供专用的 Mihomo 或 Clash Meta 订阅入口,因此不能指定某个菜单名称或声称某条链接一定兼容。实际页面若只有“复制订阅”按钮,可复制后按下文的更新验证判断结果。
图形客户端导入:添加 URL、启用配置并选择节点
不同 Mihomo 图形客户端的按钮名称可能不同,但流程通常可以按以下顺序完成。不要把“添加成功”误认为“已经生效”。
- 打开客户端的配置、Profiles、订阅或远程配置页面。
- 选择“添加 URL”“新建订阅”或含义相近的入口,粘贴订阅链接。
- 保存后点击“更新”“下载”或“刷新”。等待客户端返回成功状态,不要在下载过程中连续点击。
- 将刚导入的配置设为当前配置。部分客户端可能同时保留多个配置,未激活的配置不会影响当前连接。
- 进入代理、策略组或 Proxies 页面,确认至少出现一个代理组和节点名称。代理组用于选择节点或策略;官方文档说明,代理组可以通过
proxies引用代理,也可以通过use引用代理集合,详见 Mihomo 官方 proxy-groups 文档。 - 选择一个可用节点或自动选择组,再根据客户端提供的开关启用系统代理。若只打开了客户端但没有启用系统代理,浏览器和其他应用可能仍未使用 Mihomo。
- 先用一个普通网页或应用做连通性验证,再查看日志。成功标准应包括:当前配置已启用、代理组不为空、节点列表能展开、日志没有持续的解析错误。
模式选择也要区分:官方文档将 rule 定义为按规则匹配,global 需要在全局代理组中选择代理,direct 则是全局直连。初次排查建议先保持已有配置的模式,不要为了“测试”随意改成全局代理或直接开启 TUN。相关字段可查看 Mihomo 官方通用配置文档。
本地 YAML 配置文件怎么导入
如果你拿到的是 .yaml 或 .yml 文件,而不是链接,应使用本地配置入口。操作前建议先复制一份原配置,保留文件名和修改时间,便于回滚。
- 确认文件来源可信,并用文本编辑器打开检查开头和结尾是否完整。正常 YAML 通常能看到配置字段,而不是一整页网页源码或登录提示。
- 在客户端选择“导入文件”“打开本地配置”或相近入口,选择该 YAML 文件。
- 导入后先执行客户端提供的配置校验,或查看是否出现 YAML 解析错误。不要在报错状态下继续开启 TUN、系统代理或高权限模式。
- 将本地配置设为当前配置,检查代理组、节点和规则是否存在。
- 如果配置能加载但节点为空,检查文件是否只包含策略组和规则,却没有
proxies或有效的proxy-providers。
本地 YAML 的字段、缩进和引用名称必须一致。例如代理组通过 use 引用了某个 provider 时,provider 名称必须与 proxy-providers 下的名称相同。不要直接套用网上模板替换整份配置,因为规则、DNS、端口和 TUN 设置可能改变现有网络行为。
原生 Mihomo 用 config.yaml 加载远程订阅
没有图形客户端时,可以让原生 Mihomo 通过配置文件中的 proxy-providers 下载远程节点,再由 proxy-groups 引用。下面只展示结构示例,不能直接保证适用于你的订阅格式或系统路径。
proxy-providers:
my-provider:
type: http
url: "https://example.com/your-subscription"
path: ./proxy_providers/my-provider.yaml
interval: 3600
proxy-groups:
- name: Proxy
type: select
use:
- my-provider
proxies:
- DIRECT
mode: rule其中 url 应替换为你自己的订阅地址,path 是本地缓存文件,interval 使用秒作为单位。官方文档还说明,默认情况下 provider 文件路径受 Mihomo 工作目录限制;如果要放到其他位置,需按官方安全路径规则配置,不能随意写入任意目录。配置完成后,先做配置校验,再启动内核。
如果客户端或发行版没有提供明显的校验按钮,不要凭记忆执行未知命令。应以当前 Mihomo 发行版的帮助信息和官方文档为准。当前官方发布页可在 Mihomo Releases 核对对应系统和架构的文件;具体版本、文件名和兼容性仍需按当前发布说明确认。
节点更新后配置被覆盖怎么办
订阅更新通常会重新下载远程内容,因此直接在订阅生成的 YAML 中手动改节点名、规则或代理组,下一次更新后可能丢失。更稳妥的做法是分开管理:
- 节点来源:由远程订阅或
proxy-providers负责更新。 - 选择逻辑:由本地代理组、规则或客户端覆写负责管理。
- 个性化修改:优先使用客户端提供的覆写功能;没有确认字段含义时,不要直接覆盖整份订阅文件。
如果只是想保留某个节点选择,可先确认客户端是否支持保存策略组选择。官方通用配置中的 profile.store-selected 用于保存策略组选择,但是否被具体图形客户端启用,取决于客户端实现。不要把“更新成功”与“所有自定义设置都会保留”混为一谈。
导入或更新失败:按现象判断先查什么
| 现象 | 先查什么 | 判断标准 | 处理与回滚 |
|---|---|---|---|
| 粘贴后提示格式错误 | 链接是否为订阅地址,是否复制了网页或登录页 | 更新结果应返回配置内容,而不是 HTML 页面 | 重新从后台复制对应格式;保留原配置,不要覆盖成功配置 |
| 配置导入成功但节点为空 | 文件是否包含节点或 provider,代理组是否引用正确名称 | 代理组可以展开并显示节点 | 检查 proxies、proxy-providers 和 use 的名称;恢复到备份文件 |
| 更新失败或超时 | 设备当前网络、链接有效期和返回状态 | 客户端能完成下载并保存更新时间 | 先在浏览器或命令行中确认是否能访问;不要公开带令牌的完整链接 |
| 配置解析失败 | YAML 缩进、冒号、引号和字段拼写 | 配置校验通过,日志不再出现解析错误 | 撤销最近改动,恢复上一份可用配置,再逐项修改 |
| 节点显示但无法连接 | 节点本身、代理组选择、系统代理和规则模式 | 代理组已选择节点,应用流量确实进入客户端 | 先关闭 TUN 等高权限功能,使用普通系统代理做范围更小的验证 |
如果开启了 TUN,排查范围会扩大到系统路由、DNS 劫持、防火墙和权限。Mihomo 官方文档将 TUN 作为捕获系统流量的入口,并说明其配置涉及自动路由、DNS 劫持等行为;因此导入订阅失败时不建议把开启 TUN 作为默认解法,可先完成普通代理模式验证,相关说明见 Mihomo 官方 TUN 文档。
安全检查:订阅链接相当于访问凭证
- 不要把包含令牌的完整订阅链接发到公开聊天、截图、工单或代码仓库。
- 复制前后检查浏览器地址栏和剪贴板,避免把后台登录链接误当成订阅链接。
- 导入陌生 YAML 前先查看内容,重点注意外部规则地址、未知脚本、远程 UI、开放监听地址和高权限 TUN 配置。
- 修改前备份原配置,并记录当前代理端口、系统代理开关和 TUN 状态。
- 如果订阅疑似泄露,应在服务后台重新生成或重置订阅地址;具体操作以对应后台为准。
订阅能下载并不等于节点一定可用,也不等于规则、DNS 或系统代理已经生效。导入完成后,应分别验证“配置已加载”“节点可选择”“应用流量进入客户端”三个环节。
补充推荐:需要线路和网络诊断时
如果你已经完成 Mihomo 导入,但仍要区分延迟、丢包、DNS、MTU 或跨境办公连接问题,可把配置版本、系统、现象、日志时间和复现步骤整理后再做诊断。需要进一步处理线路与网络连接问题时,可了解边界云加速的相关服务。
常见问题
Mihomo 可以直接导入普通订阅链接吗?
不一定。链接需要返回 Mihomo 或 Clash 兼容的配置内容,具体取决于提供方的格式。若返回网页、登录提示或其他客户端专用格式,客户端可能无法解析。先确认后台标注的格式,再通过更新结果和节点列表验证。
订阅链接和配置文件有什么区别?
订阅链接是远程地址,客户端可以重新下载并更新;配置文件是已经保存到设备上的 YAML。订阅适合持续获取节点,YAML 适合本地备份和手动管理,两者不能默认使用同一个导入入口。
Mihomo 导入后为什么没有节点?
常见原因包括订阅返回内容为空、格式不兼容、YAML 中没有有效的 <code>proxies</code> 或 <code>proxy-providers</code>,以及代理组没有正确引用 provider。先看更新返回内容和日志,再检查代理组的 <code>use</code> 名称是否与 provider 完全一致。
节点更新会覆盖我手动改的规则吗?
可能会。如果你直接编辑由订阅生成的配置文件,下一次重新下载可能覆盖改动。建议把订阅作为节点来源,把代理组、规则和个性化设置放在客户端覆写或独立配置中,并在修改前备份。
导入订阅后需要立即开启 TUN 吗?
不需要。TUN 是系统级流量捕获方式,涉及路由、DNS 和权限。建议先在普通系统代理模式下验证配置、节点和应用流量,再根据具体需求决定是否启用 TUN。