Mihomo订阅怎么导入？两种方法与失败排查

更新于 2026-10-18 · leiting.autos

简答：Mihomo订阅通常不是直接粘贴到节点列表，而是通过客户端的订阅管理功能，或在配置文件的proxy-providers中填写type、url、path等字段。导入前先确认订阅链接可访问、格式与客户端兼容。

定义：Mihomo订阅是由订阅链接或本地配置文件提供代理节点数据，Mihomo通过客户端订阅管理或proxy-providers配置读取并定期更新这些节点。

一、先判断你的订阅属于哪一种格式

“Mihomo订阅”在实际使用中可能指两类内容：一类是客户端可以直接添加的订阅链接；另一类是写入Mihomo配置文件中的代理集合。两者都可能包含节点，但导入位置不同。

常见订阅类型与处理方式

类型	常见表现	推荐处理方式
订阅链接	以http或https开头，复制后可在客户端中添加	打开客户端的订阅管理或配置管理，新增URL并更新
完整YAML配置	下载后包含proxies、proxy-groups、rules等字段	作为配置文件导入，不要只放进proxy-providers
节点集合链接	只提供节点数据，不一定包含完整策略组和规则	在proxy-providers中使用type和url引用

官方配置示例将远程节点集合放在proxy-providers下，并使用type: http、url、path等字段定义获取方式；因此，订阅链接和完整配置文件不能简单地当成同一种文件处理。可参考Mihomo官方配置示例和官方proxy-providers文档。

二、通过客户端导入Mihomo订阅

准备订阅链接。
从订阅提供方复制完整的http或https地址。不要把账号密码、访问令牌或订阅链接公开发布；这类链接通常具备直接获取配置或节点数据的权限。
打开客户端的配置或订阅管理页面。
不同Mihomo图形客户端的菜单名称可能不同，常见入口包括“订阅管理”“配置管理”“Profiles”或“添加远程配置”。如果客户端没有订阅管理入口，应查看该客户端是否支持远程配置，不能仅凭内核名称判断。
新增远程订阅。
将订阅链接粘贴到URL输入框，填写便于识别的名称，然后保存。名称只用于本地识别，不建议使用重复名称。
执行更新。
在订阅列表中点击“更新”“刷新”或相近按钮，等待客户端完成下载和解析。更新成功后，进入配置列表选择刚导入的配置。
选择代理组和节点。
如果配置文件已经包含策略组，选择一个可用策略组，再从节点列表中选择节点。如果导入后只有节点、没有策略组，说明它可能只是节点集合，需要使用另一份完整配置，或在自己的配置文件中补充proxy-groups和rules。
先测试普通连接。
先确认客户端日志没有解析错误，再测试一个普通网页或客户端自带的延迟测试。不要把“能显示节点”误认为“配置已经可用”，节点解析、策略组引用和实际连接是三个不同环节。

客户端界面属于具体软件的实现，按钮名称和位置可能随版本变化。遇到菜单不同，应优先以当前客户端的帮助文档为准；Mihomo官方文档主要规定配置字段和内核行为，不统一规定所有图形客户端的操作界面。

三、在YAML配置中使用proxy-providers导入

如果你使用的是Mihomo命令行、服务端程序或支持自定义YAML的客户端，可以把订阅作为远程代理集合写入配置文件。下面是官方配置结构的简化示例，订阅地址仅作字段位置示例，不是可用订阅：

proxy-providers:
  provider1:
    type: http
    url: "https://example.com/subscription"
    path: ./proxy_providers/provider1.yaml
    interval: 3600
    health-check:
      enable: true
      interval: 600
      url: https://cp.cloudflare.com/generate_204

其中，provider1是代理集合名称；type: http表示通过HTTP方式获取；url填写远程地址；path指定下载后在本地保存的位置；interval表示自动更新间隔，单位为秒；health-check用于对代理集合进行健康检查。字段含义和示例可在Mihomo官方代理集合文档中核对。

仅写入proxy-providers还不一定能在界面中直接选择节点。策略组需要引用这个代理集合，例如：

proxy-groups:
  - name: 节点选择
    type: select
    use:
      - provider1

官方示例展示了策略组通过use引用代理集合的写法。如果你的配置使用的是proxies而不是use，就需要确认节点是否已经被写入主配置；不能把代理集合名称直接当成单个节点名称使用。配置修改后，保存文件并在客户端中重新加载配置，或重启对应的Mihomo进程。

如果订阅提供的是完整YAML配置，通常应将它作为配置文件加载，而不是再嵌套放进proxy-providers。如果订阅只返回节点集合，则更适合放在proxy-providers中。无法确认返回格式时，可以先在浏览器或文本编辑器中查看下载内容，但不要在公开平台粘贴完整订阅地址。

四、导入失败时按顺序排查

提示URL无效或下载失败：检查地址是否完整、是否包含必要的访问参数，并确认当前网络可以访问该地址。若链接已过期或被撤销，应向订阅提供方重新获取，本站无法替代提供方验证链接状态。
下载成功但解析失败：检查返回内容是否为Mihomo支持的配置或代理集合格式。HTML登录页、错误提示页或其他客户端专用格式，都可能被误当成订阅内容。
导入后没有节点：确认策略组是否通过use引用了正确的provider名称，同时检查provider1等名称是否前后一致。官方示例中，代理集合名称、策略组引用和本地保存路径都是分开的字段。
节点有名称但无法连接：先查看日志中的解析、DNS、TLS或连接超时信息，再分别测试其他节点。不要只根据节点名称判断地区或质量；节点名称属于订阅内容，未必代表实际线路。
更新后配置被覆盖：如果使用的是完整远程配置，每次更新可能同步替换远程文件中的规则、策略组或其他设置。需要保留自定义设置时，可考虑使用代理集合方式，把节点数据和本地规则分开管理。
YAML报错：检查缩进、冒号、引号和重复字段。YAML对层级缩进敏感，建议使用支持YAML语法检查的编辑器，并逐项对照官方示例。

五、导入前后的安全与兼容性检查

不要公开订阅链接：订阅链接可能包含身份验证信息。发布截图、日志或求助内容时，应遮住完整URL及访问参数。
优先使用HTTPS：如果提供方同时给出HTTP和HTTPS地址，通常应优先核对并使用HTTPS版本；具体是否可用仍以提供方说明为准。
不要混用字段：完整配置和代理集合的结构不同。看到proxies、proxy-groups、rules等字段时，不要默认它只是一个可以直接填入url的节点列表。
先备份原配置：修改前复制一份能正常加载的配置文件，出现解析错误时可以快速恢复。
核对客户端支持范围：Mihomo内核支持的字段，不代表所有客户端界面都开放对应功能；客户端可能对配置路径、更新方式或自定义字段有额外限制。

如果你只是想把一条订阅链接导入电脑或手机，优先使用客户端的远程配置入口；如果你需要把订阅节点与本地规则、策略组分开维护，再使用proxy-providers方式更合适。

结论：应该选哪种导入方式

普通用户选择“客户端添加远程订阅”即可：添加URL、更新、选择配置、选择策略组。需要自定义规则或多个订阅来源时，再采用YAML中的proxy-providers，并通过策略组的use引用代理集合。遇到失败时，优先判断是链接不可访问、返回格式不兼容、策略组未引用，还是节点本身连接异常。

如果你准备同时管理多个订阅，建议先备份配置，再为每个代理集合设置不同名称和本地path，避免更新时覆盖错误文件。字段写法请以官方配置示例与官方proxy-providers说明为准。

常见问题

Mihomo订阅链接应该填到哪里？

如果你使用图形客户端，应填在客户端的订阅管理、配置管理或远程配置入口。如果使用自定义YAML，则通常写在proxy-providers下的url字段，并同时配置type和path。

为什么订阅导入成功，却没有节点或不能选择？

常见原因是策略组没有通过use引用对应的provider名称，或者导入内容只是节点集合而不是完整配置。请分别检查proxy-providers、proxy-groups和use字段。

完整配置文件可以放进proxy-providers吗？

不建议直接混用。完整配置通常包含proxies、proxy-groups、rules等顶层字段，应作为配置文件加载；proxy-providers更适合引用远程代理集合。最终以订阅返回格式和官方字段说明为准。

Mihomo订阅多久自动更新一次？

如果使用proxy-providers，可通过interval设置更新间隔，单位为秒；官方示例使用了该字段。图形客户端的更新周期则取决于客户端实现和具体配置。

导入订阅会不会泄露账号信息？

订阅链接可能包含访问凭证或识别参数。不要把完整链接发到公开群组、工单或截图中；排查时应打码处理，并在链接疑似泄露后向提供方申请重新生成。