Mihomo 订阅怎么导入？URL、本地 YAML 与节点不显示排查
简答：Mihomo 订阅通常通过支持 Mihomo 的图形客户端导入订阅 URL，或写入 Mihomo 的 proxy-providers 配置；导入后还要设为当前配置、选择策略组并开启系统代理或 TUN。最快做法是先复制完整订阅地址，再确认配置中出现节点，最后通过日志或实际网页访问验证，不要把“导入成功”当成“流量已经接管”。
定义：Mihomo 订阅是由服务商提供的远程配置或节点集合地址，客户端按 URL 下载并解析节点、策略组等内容；本地 YAML 则是已经下载到设备上的配置文件。
先看这张表：你要导入的到底是什么
本文是 naixinternet.shop 的第三方使用指南，不代表 Mihomo 或任何订阅服务商的官方页面。Mihomo 官方文档将远程节点集合定义为 proxy-providers，可使用 type: http 和 url 下载远程内容；配置内容还可能是 YAML、URI 或 base64，三者不能在同一个 provider 文件中混写。可先查看 Mihomo proxy-providers 官方文档 和 provider 内容格式说明。
| 你手里的内容 | 适合的导入方式 | 能否自动更新 | 常见误区 |
|---|---|---|---|
| 订阅 URL | 在图形客户端的订阅、Profiles、配置或 Import from URL 入口粘贴 | 通常可以，具体由客户端和配置决定 | 复制不完整、带空格，或把单节点链接当成订阅地址 |
| 本地 YAML 文件 | 在客户端选择本地配置、Import File 或打开配置文件 | 通常不会自动跟随远程地址更新 | 文件能打开不代表节点可用，也不代表已成为当前配置 |
| 单节点 URI | 使用客户端的单节点添加或扫码入口 | 通常只添加单个节点 | 不能直接等同于包含策略组的完整订阅 |
| 网页上显示的账号、密码或短链接 | 回到服务商后台寻找 Clash、Clash Meta 或 Mihomo 订阅项 | 以页面说明为准 | 不要凭名称猜格式；未核实的地址不要反复导入 |
停止条件：如果你拿到的只是单个 vmess://、vless://、ss:// 等节点链接，不要直接把它当成完整订阅；先确认客户端是否提供单节点导入功能。
最快 5 步：导入 URL 并确认配置生效
- 备份当前配置。如果客户端已有能正常使用的配置，先导出或复制一份；不要在还未确认新订阅可解析时删除旧配置。把订阅 URL 当作敏感信息管理，尤其是地址中带有 token、用户标识或授权参数时，不要贴到公开聊天、工单或代码仓库。
- 从服务商后台复制完整地址。优先选择明确写着 Clash、Clash Meta 或 Mihomo 的订阅项。复制后检查开头、结尾和中间是否被换行、空格或富文本截断；本文无法核实任何具体服务商后台的菜单位置，实际名称以页面显示为准。
- 在客户端找到配置入口。常见名称包括“订阅管理”“配置”“Profiles”“Import from URL”。粘贴 URL 后保存或导入。不同客户端的菜单名称、按钮位置和支持格式可能不同，不能仅凭 Mihomo 内核文档推断某个客户端一定有相同界面。
- 将新配置设为当前配置。导入列表中出现新配置，只能说明文件或远程内容已经被保存；还要点击使用、激活或设为当前配置。然后检查节点、代理组或策略组是否出现。若列表为空，先停止，不要急着打开 TUN。
- 选择策略并验证。先选择 Rule 或客户端默认的规则策略，再选择一个节点或自动测速策略组；随后按客户端提供的开关开启系统代理。只有需要接管不遵循系统代理的应用时，才考虑启用 TUN。打开网页、查看客户端连接日志或对比出口信息只能作为验证证据之一，单次网页访问不等于长期稳定。
官方配置示意中，远程 provider 至少需要唯一名称、type: http、url 和本地保存路径；例如：
proxy-providers:
provider1:
type: http
url: "https://example.invalid/subscription"
path: ./proxy_providers/provider1.yaml
上面的地址只是格式示例，不是可用订阅。具体策略组还需要引用 provider；仅下载 provider 文件并不等于已经选中节点。官方 API 文档也将 provider 的节点列表、更新和健康检查分开说明，可参考 Mihomo API 文档。
导入成功但节点为空：按现象分流
| 现象 | 先观察什么 | 处理顺序 | 验证边界 |
|---|---|---|---|
| 点击导入后没有任何配置 | 客户端是否提示 URL 无效、超时或格式错误 | 重新复制完整 URL；确认网络能访问该地址；再尝试重新添加 | 能打开后台页面不代表订阅 URL 本身可下载 |
| 配置出现但节点为空 | 当前配置内容是否包含 proxies、proxy-providers 或节点列表 | 确认格式选择正确；检查是否误把单节点链接当成完整订阅；查看客户端解析日志 | 配置名称出现不代表节点解析成功 |
| 提示 403 或 404 | 订阅地址是否过期、复制错误或需要授权 | 回到提供地址的页面重新复制；不要自行修改 token；必要时按页面说明重新生成 | 无法仅凭状态码判断服务端具体原因 |
| 提示 Timeout | 设备当前网络、DNS 和客户端日志 | 先确认普通网络可用，再重试；若反复超时，记录时间和日志，向地址提供方核对 | 一次超时不能证明订阅永久失效 |
| 节点有延迟但网页打不开 | 系统代理是否开启、当前策略是否选中、是否有其他客户端占用代理设置 | 暂时关闭其他代理客户端；重新选择策略组；再检查系统代理或 TUN 状态 | 延迟测试只表示测试请求有响应，不等于所有网页都可用 |
最小回滚：如果导入后网络异常，先关闭系统代理或 TUN，再恢复原先能工作的配置；不要同时修改 DNS、MTU、规则和 TUN，否则很难判断是哪一步造成变化。
本地 YAML 怎么导入？为什么更新不了
本地 YAML 的处理方式是“导入文件—设为当前配置—检查解析结果”。文件导入成功后，客户端通常只读取本地副本；它是否保留远程 URL、是否提供手动更新按钮，要以客户端实现为准。若你希望以后能点击更新，优先保留原始订阅 URL，并在客户端的订阅管理中使用 URL 导入，而不是只下载一次 YAML。
如果你直接维护 Mihomo 配置文件，可以使用官方文档中的 provider 结构，将远程地址放在 proxy-providers 下；如果是普通完整配置，则还要确认策略组实际引用了该 provider。官方文档说明，provider 的 interval 用于设置更新间隔，health-check 用于延迟检查；这些字段必须与客户端支持的配置版本相匹配，不能把其他内核的字段直接照搬。
需要更改配置时，建议一次只改一个变量：先确认订阅能下载，再确认节点出现，最后再处理 DNS、TUN 或 MTU。官方 TUN 文档说明，TUN 会影响系统路由和 DNS 行为；其中 auto-route、dns-mode、dns-hijack 等选项具有不同作用，普通导入问题不应一开始就修改这些高级设置。可参考 Mihomo TUN 官方文档。
导入前后的自查清单
- 地址：是否复制了完整订阅 URL，而不是后台页面地址或单节点 URI。
- 格式：是否选择了服务商实际提供的 Clash、Clash Meta 或 Mihomo 格式。
- 状态：是否依次确认“已导入”“已设为当前”“节点已出现”“策略已选择”“系统代理或 TUN 已开启”。
- 冲突：是否同时运行了多个会修改系统代理、端口或 TUN 的客户端。
- 日志：遇到 403、404、Timeout 或解析失败时，是否保留了错误提示和时间，而不是只反复点击更新。
- 回滚：网络异常时是否先关闭系统代理或 TUN，并恢复旧配置。
截至 2026-10-31，本文只依据 Mihomo 官方配置、TUN、API 和项目发布资料核对通用能力；具体图形客户端的菜单、打包内核版本和移动端权限可能变化，使用前应以对应客户端页面和 Mihomo 官方说明为准。Mihomo 的版本与构建文件应从其公开发布页面核对，不在本文承诺某个版本或平台一定可用。
结语：先完成导入，再处理连接问题
Mihomo 订阅导入的关键不是只把 URL 粘贴进去，而是完成四个状态确认：远程内容能下载、配置能解析、配置已设为当前、实际流量经过系统代理或 TUN。只要按照这个顺序排查，就能把“订阅失效”“格式错误”“没有选中配置”和“代理未接管”区分开。
推荐：如果你还需要进一步排查跨境办公中的延迟、丢包或客户端连接问题，可了解边界云加速的相关网络诊断服务，具体能力与使用条件以官网为准。
常见问题
Mihomo 订阅 URL 和单节点链接有什么区别？
订阅 URL 通常用于下载一组节点、策略组或完整配置，客户端可按订阅更新；单节点链接通常只描述一个节点，常见为 vmess、vless、ss 等 URI，是否能导入取决于客户端的单节点功能，不能默认当作完整订阅。
Mihomo 导入订阅后为什么没有节点？
先确认新配置是否已设为当前配置，再检查内容格式和客户端日志。若只看到配置名称但没有节点，可能是复制不完整、格式选择不匹配、订阅返回空内容，或把单节点链接放到了完整订阅入口；应先保留错误提示，不要直接修改 TUN、DNS 或 MTU。
本地 YAML 导入后可以自动更新吗？
本地 YAML 通常只是设备上的副本，能否自动更新取决于客户端是否保留远程地址并提供更新机制。需要定期同步时，优先在客户端使用原始订阅 URL；如果手动写 Mihomo 配置，可按官方 proxy-providers 结构配置远程 URL 和更新间隔。
导入成功后网页还是打不开怎么办？
按顺序检查当前配置、策略组和节点选择，再确认系统代理是否开启；只有需要接管不遵循系统代理的应用时再检查 TUN。若仍失败，查看客户端连接日志，并先关闭其他可能修改系统代理、端口或 TUN 的客户端。
订阅地址带 token，可以发给别人帮忙排查吗？
不建议公开发送。带 token 或授权参数的地址应按敏感信息管理；排查时可遮盖域名后的授权参数，或让对方提供不含凭据的错误提示、状态码和日志片段。