Mihomo 如何导入订阅？从链接导入到连接验证

更新于 2026-10-30 · xn--kbtz2zn3ab56c.shop

简答：Mihomo 导入订阅有两条路径：使用 Mihomo Party/Clash Party 图形客户端时，在配置或订阅管理中粘贴完整订阅链接并启用配置；直接运行 Mihomo 内核时，则把订阅写入 config.yaml 的 proxy-providers。导入成功不等于代理已经生效，还要选择代理组、开启系统代理或 TUN，并完成网页与日志验证。

定义：Mihomo 订阅是由服务端提供的远程配置地址，客户端或 Mihomo 内核通过该地址获取节点列表、代理组及相关配置；它不是单个节点分享链接，也不等同于已经启用代理。

先判断你使用哪一种 Mihomo

“Mihomo”通常可能指 Mihomo 内核，也可能指带图形界面的桌面客户端。两者导入方式不同，先不要把图形客户端的菜单路径套到命令行内核上。

导入方式速查

使用环境	识别特征	推荐导入方式	导入后还要做什么
Windows、macOS 或 Linux 图形客户端	可以看到配置、订阅、代理组等页面	在配置或订阅管理页面粘贴 URL	选择当前配置，启动内核，再开启系统代理或 TUN
直接运行 Mihomo 内核	通过命令行启动，目录中有 config.yaml	在 YAML 中配置 proxy-providers	检查 YAML、启动内核，并通过代理端口验证
只有一个 ss、vmess、vless 等分享链接	链接通常只描述单个节点	不能直接当作完整订阅处理	向服务提供方获取 Clash/Mihomo 格式订阅

当前官方桌面项目的发布页使用“Clash Party”名称，旧资料中仍可能出现“Mihomo Party”。不同版本的菜单名称和布局会变化，以下以常见桌面界面为例，实际按钮以你安装的版本为准。官方桌面客户端发布页列出了当前版本及各系统安装包。

导入前：获取完整订阅并先做检查

从服务商后台复制完整订阅地址。不要只复制页面中显示的一部分，也不要把单个节点分享链接误当成订阅。
确认格式兼容。向服务商确认链接返回的是 Clash、Clash Meta 或 Mihomo 可读取的配置；如果返回 HTML 登录页、错误提示或空内容，客户端通常无法生成节点。
不要公开订阅链接。订阅地址可能包含授权信息。不要把它发到公开聊天、截图或工单之外的地方；如果已经泄露，优先在服务商后台重置或重新生成。
准备回滚。如果已经有可用配置，先导出或复制一份。第一次导入不要覆盖原配置，便于恢复。

订阅链接本身不是“测速结果”或“连接成功证明”。它只能说明客户端有机会从远程地址获取配置，后续还要检查配置解析、内核启动和实际请求。

图形客户端导入：粘贴 URL、启用配置、验证连接

以下步骤适用于带 Mihomo 内核的桌面图形客户端。当前版本支持对订阅、代理组和相关配置进行可视化管理，但具体入口可能因版本或简易模式不同而变化；如果你找不到完全相同的文字，请寻找含有“配置”“Profiles”“订阅”或“远程配置”的页面。官方 v2.0.4 发布说明提到该版本新增了可视化编辑订阅、代理组和规则等功能。

打开客户端，先确认 Mihomo 内核已经安装或能正常启动。
进入常见的“配置”“Profiles”或“订阅管理”入口，选择新增远程配置。
粘贴完整订阅 URL，填写一个容易识别的名称，例如“办公订阅”。如果页面提供“通过代理更新”或 User-Agent 选项，先保持默认；只有服务商明确要求时再修改。
点击导入、保存或更新，等待客户端完成下载和解析。成功后应看到配置名称、节点或代理组，而不是只有一个空白卡片。
将刚导入的配置设为当前配置。仅导入但未选中时，运行中的内核可能仍使用旧配置。
启动 Mihomo 内核。若客户端有“启动”“运行”或托盘开关，确认状态已经变为运行中。
先开启“系统代理”验证浏览器流量；不要一开始就同时启用 TUN、复杂 DNS 覆写和自定义规则。系统代理能工作后，再按需要测试 TUN。
在代理组中选择一个节点或自动选择组，然后打开一个普通网页。再查看客户端连接日志，确认请求是否进入代理组。

最短验证链：配置能显示节点 → 配置被设为当前 → Mihomo 内核运行 → 代理组有选中项 → 系统代理已开启 → 浏览器请求有连接记录。任何一环缺失，都不能把问题简单归结为“节点不可用”。

纯 Mihomo 内核导入：使用 proxy-providers

如果你没有图形界面，而是直接运行 Mihomo，需要把远程订阅声明为 HTTP 类型的 proxy provider。官方配置示例使用 proxy-providers、type: http、url、path 和可选的更新间隔与健康检查字段。Mihomo 官方配置示例和proxy-providers 官方文档可用于核对字段。

下面是一个用于字段核对的最小示例。请把示例 URL 替换成你自己的订阅地址，不要照抄示例地址：

mixed-port: 7890
mode: rule

proxy-providers:
  my-sub:
    type: http
    url: "https://example.com/your-subscription"
    path: ./proxy-providers/my-sub.yaml
    interval: 3600

proxy-groups:
  - name: PROXY
    type: select
    use:
      - my-sub

rules:
  - MATCH,PROXY

在 Mihomo 工作目录创建或编辑 config.yaml。
确认 proxy-providers 与 proxy-groups 的缩进使用空格，不要混用 Tab。
把真实订阅地址写入 url，并为 path 指定可写入的本地文件路径。
在代理组中通过 use 引用 provider 名称。本例中的名称是 my-sub，两处必须一致。
启动 Mihomo，观察启动日志。如果 YAML 解析失败，先修复缩进、冒号、引号和字段层级，再继续测试网络。
启动后检查 provider 文件是否生成、代理组是否出现节点，再使用 mixed-port 进行本机代理验证。

配置文件能够启动，只说明 YAML 和部分字段通过解析；它不代表订阅内容一定有可用节点，也不代表浏览器已经使用了 7890 端口。

导入成功后如何确认真的生效

检查配置：能看到订阅名称、节点或代理组，且没有“解析失败”“内容为空”等错误。
检查运行状态：Mihomo 内核处于运行中，日志没有持续出现配置加载失败或端口占用。
检查代理组：代理组中有可选择的节点；如果只有 DIRECT，优先检查订阅返回内容或 provider 引用。
检查接管方式：系统代理适合先验证浏览器等遵循系统设置的应用；TUN 用于需要更广泛接管流量的场景，但会涉及系统权限、路由和 DNS，建议在基础代理验证成功后再开启。
检查请求：打开一个普通网页，同时查看连接记录或日志。单独 ping、端口监听或一次延迟测试都不能证明所有应用都能正常连接。

如果系统代理下浏览器正常，而某个独立应用仍不通，问题可能在该应用是否遵循系统代理、应用自己的代理设置或规则匹配，不要立即修改 DNS 或 MTU。

按现象排查：导入失败、无节点与浏览器不通

Mihomo 订阅导入故障分流

现象	优先检查	处理方法
点击导入后提示格式错误	订阅返回内容、链接是否完整、客户端版本	在服务商后台重新复制完整链接，确认返回 Clash/Mihomo 兼容格式；不要把网页错误页保存成 YAML。
导入成功但节点为空	provider 是否更新成功、配置是否过期、代理组是否引用 provider	手动更新订阅，查看更新日志；内核模式检查 `use` 名称和本地 provider 文件是否生成。
更新失败或超时	当前网络能否访问订阅域名、是否需要代理更新、服务端是否返回错误	先确认本机基础网络，再尝试客户端提供的代理更新选项；若只有该订阅地址失败，向服务商核对地址有效期和访问要求。
节点有延迟但浏览器打不开	当前配置、系统代理开关、浏览器独立代理、规则组	重新确认配置已设为当前，开启系统代理，选择明确的代理组节点，并查看连接日志。
开启 TUN 后反而断网	系统权限、DNS、已有 VPN、其他代理软件和路由冲突	先关闭 TUN，恢复系统代理验证；确认基础代理正常后一次只改一个 TUN 或 DNS 选项，并保留撤销路径。
配置启动时报 YAML 错误	缩进、冒号、引号、重复字段	回退到最近一次可用配置，逐段加入订阅字段；不要在同一轮同时改 DNS、规则和 TUN。

Windows、macOS 和 Linux 的差异提醒

图形客户端的订阅导入逻辑通常相同，但权限和安装包不同。Windows 可能涉及系统代理权限或管理员重启；macOS 可能需要允许网络扩展、辅助组件或系统代理变更；Linux 则可能需要确认桌面环境、代理变量或 TUN 所需权限。不要把某个平台的菜单名称、权限提示或 TUN 行为直接推断为所有平台都一致。

如果你使用的是纯 Mihomo 内核，系统不会自动因为内核启动就替你设置浏览器代理。你需要在浏览器或操作系统中明确指定代理，或者在确认权限和路由后配置 TUN。Mihomo 官方发布页与文档可用于核对当前内核版本和配置字段，客户端界面则应以所安装发行版的说明为准。Mihomo 官方发布页

补充更新：导入后仍不稳定时的回滚顺序

关闭 TUN 和自定义 DNS，只保留基础系统代理。
切回之前保存的可用配置，确认客户端和内核能正常启动。
重新导入订阅，但先不要修改规则、覆写、DNS 或 MTU。
确认节点、代理组、系统代理和网页请求依次正常后，再一次只启用一个高级选项。
每次修改后记录结果；如果问题出现，撤销最近一次改动，而不是同时重置所有设置。

如果同一订阅在图形客户端和纯内核中的结果不同，先比较两边实际下载到的配置内容、内核版本和代理组引用关系。不要仅凭客户端名称判断兼容性。

结论

Mihomo 导入订阅的关键不是只把 URL 粘贴进去，而是完成“获取完整链接—导入或写入 provider—启用当前配置—启动内核—选择代理组—开启接管—验证请求”这条链路。图形客户端优先走配置或订阅管理入口；纯内核则使用 proxy-providers，并检查 YAML 缩进与代理组引用。

本文为第三方使用指南，不代表任何客户端或订阅服务的官方页面；客户端版本、菜单名称和服务商订阅格式如有变化，以对应官方资料和服务商后台显示为准。

常见问题

Mihomo 和 Mihomo Party 是同一个东西吗？

不完全是。Mihomo主要指代理内核；Mihomo Party是曾被广泛使用的图形客户端称呼，当前官方桌面项目发布页使用Clash Party名称。导入时应先确认你使用的是图形客户端还是纯内核，界面名称以当前版本为准。

Mihomo 导入订阅后为什么没有节点？

常见原因包括订阅返回空内容、链接已过期、客户端无法访问订阅地址、格式不兼容，或纯内核配置中的proxy-groups没有通过use引用对应provider。先查看更新日志和provider状态，再核对订阅格式与YAML字段。

导入订阅后必须开启 TUN 吗？

不必须。建议先用系统代理验证基础连接；TUN用于更广泛接管流量，但会增加系统权限、路由和DNS变量。基础代理未验证前，不建议同时启用TUN、DNS覆写和复杂规则。

订阅链接可以直接发给别人帮忙排查吗？

不建议。订阅链接可能包含授权信息。排查时应打码域名路径中的令牌，或只提供错误提示、配置字段和不含凭据的日志；如果链接已经公开，优先在服务商后台重置或重新生成。

纯 Mihomo 内核如何确认订阅已经生效？

检查三点：provider本地文件是否更新、代理组是否通过use引用该provider、启动日志是否没有配置或更新错误。之后再通过mixed-port或已配置的系统代理发起实际网页请求。