Mihomo 怎么导入订阅链接?粘贴后不生效这样排查
简答:先确认你拿到的是可访问的订阅 URL,再在 Clash Party 的 Profiles/订阅页导入、下载并激活配置,最后选择代理组并开启系统代理;原生 Mihomo 则需写入配置文件并让应用连接 mixed-port。
定义:Mihomo 订阅导入,是把服务提供的远程 URL 下载为 Mihomo 可加载的配置或节点集合,再通过代理组、规则和入站端口让应用实际使用。
先确认你用的是图形客户端还是原生 Mihomo
本文与 Mihomo 及 Clash Party 的开发者、项目方无隶属关系。需要先区分两种场景:Clash Party 是带界面的桌面客户端,负责保存订阅、生成或加载配置,并可设置系统代理;原生 Mihomo 是内核程序,通常需要你自己准备 config.yaml、启动内核,再让浏览器或系统连接它的代理端口。
官方项目组织目前将项目称为 Clash Party,仓库仍说明它是 Mihomo 图形界面;如果你安装的是旧版,菜单可能仍显示 Mihomo Party,具体名称以当前客户端界面为准。可参考Clash Party 官方组织页面。
| 场景 | 订阅导入位置 | 导入后还要做什么 | 正常判定 |
|---|---|---|---|
| Clash Party | Profiles、配置或订阅管理页面 | 下载或更新,激活配置,选择代理组,打开系统代理 | 配置显示已激活,代理组出现节点,浏览器能通过代理访问测试页面 |
| 原生 Mihomo | 写入主配置的 proxy-providers 或本地配置文件 | 通过 mixed-port 或 TUN 接管流量 | 内核通过配置检查,端口监听,应用代理设置指向本地端口 |
最快操作:粘贴订阅、激活配置并开启代理
- 从服务后台复制订阅 URL。只复制完整地址,不要复制网页登录地址、二维码图片地址或浏览器地址栏中带后台路径的页面地址。订阅链接通常包含一段用于授权的令牌,不要公开粘贴到论坛、截图或日志中。
- 打开 Clash Party 的配置页面。当前版本常见入口是侧栏中的 Profiles、配置或订阅管理。进入后,在顶部的 URL 输入框粘贴订阅地址,点击导入、添加或从 URL 导入。由于界面名称可能随版本变化,按钮文字以当前客户端为准。
- 等待下载完成。看到配置卡片、配置名称或更新时间,才表示客户端保存了订阅;这不等于代理已经生效。若页面只显示错误提示,先不要反复点击更新,转到本文的故障表。
- 激活刚导入的配置。点击配置卡片,再选择启用、激活或设为当前配置。激活后检查代理组是否出现节点;如果节点列表为空,说明下载内容可能不是可识别的配置或节点列表。
- 选择代理组和节点。进入代理或策略组页面,先选择一个具体节点或自动选择组。只看到配置名称、但没有可选节点,不算导入完成。
- 开启系统代理。在客户端托盘菜单或设置页打开系统代理。若只打开了客户端而没有启用系统代理,普通浏览器和多数桌面应用不会自动使用 Mihomo。
- 最后验证。先访问一个你平时能正常打开的网页,再查看客户端连接日志、当前代理组和流量统计。三者都没有变化时,优先检查系统代理是否真的打开。
官方 Mihomo 文档将代理端口、TUN 和 listeners 分为不同的入站方式;其中 mixed-port 同时支持 HTTP(S) 与 SOCKS5,适合让支持代理设置的应用连接。可参考Mihomo 入站配置文档和Mihomo 代理端口文档。
订阅链接、配置文件和节点不是一回事
订阅链接是一个远程 URL,客户端通过它下载内容;配置文件是 Mihomo 实际加载的 YAML 或组合配置;节点是配置中的具体代理条目。导入订阅只完成了获取或保存,下载成功也不代表配置已经激活,更不代表应用流量已经接管。
对于原生 Mihomo,官方文档中的 proxy-providers 支持 http、file 和 inline 类型。HTTP provider 需要配置 URL,保存路径可选;实际内容应以客户端能解析的格式为准。不要因为内容不是 YAML 就直接断定不兼容:完整配置、Base64 内容和常见 URI 列表可能都能被相关 provider 或客户端处理,但返回 HTML 登录页、JSON 错误信息、鉴权失败页面或空响应时,才是明显的内容异常。可参考Mihomo 官方 proxy-providers 字段说明。
检查方法很简单:把 URL 放入浏览器或命令行下载工具中,只检查响应状态、内容类型和正文开头,不要把完整订阅内容复制到公开平台。示例命令中的域名必须替换为你自己的订阅地址:
curl -L --max-time 20 -o subscription.txt "https://example.com/replace-with-your-subscription-url"这条命令的目的,是判断 URL 是否能在 20 秒内返回内容;example.com 只是示例域名,必须替换。若工具未安装,请改用浏览器下载或客户端自带更新功能。状态为 200 只能说明请求返回成功,仍需打开文件前几行确认不是 HTML 登录页或 JSON 报错。
原生 Mihomo 的最小可运行配置
如果你没有使用图形客户端,而是直接运行 Mihomo,不能只写 proxy-providers 和 proxy-groups。至少要有一个入站端口和一条路由规则,否则内核可能启动,但应用流量不会经过你选择的策略组。
mixed-port: 7890
mode: rule
log-level: info
proxy-providers:
my-subscription:
type: http
url: "https://example.com/replace-with-your-subscription-url"
path: ./profiles/my-subscription.yaml
interval: 3600
proxy-groups:
- name: Proxy
type: select
use:
- my-subscription
proxies:
- DIRECT
rules:
- MATCH,Proxy示例中的 URL、provider 名称和路径都可以替换;示例域名必须替换为你自己的订阅地址。mixed-port: 7890 提供 HTTP 与 SOCKS 混合入口,proxy-groups 将 provider 节点加入名为 Proxy 的策略组,MATCH,Proxy 让未被其他规则匹配的流量交给该策略组。官方配置示例同时展示了 provider、策略组和节点健康检查结构,可参考Mihomo 官方配置示例。
配置保存为 config.yaml 后,先在当前目录运行配置检查。命令适用于支持 -t 参数的 Mihomo 版本;先用 mihomo -v 确认你执行的是目标内核:
mihomo -t -f config.yaml这条命令的目的,是检查 YAML 和 Mihomo 配置结构,不会替代实际联网验证。看到配置检查通过后,再启动内核:
mihomo -f config.yamlWindows 如果当前目录没有加入 PATH,可使用 .\mihomo.exe -t -f config.yaml;macOS 或 Linux 若文件没有执行权限,先运行 chmod +x ./mihomo,再运行 ./mihomo -t -f config.yaml。macOS 若系统阻止下载的未签名程序,可先确认文件来源,再按系统安全提示处理;不要执行来源不明的二进制文件。
启动后还要让应用连接 127.0.0.1:7890。浏览器或系统代理中的 HTTP、HTTPS、SOCKS 端口应按应用支持情况填写;如果应用不支持手动代理,可在配置中启用并正确设置 TUN。官方文档说明,TUN 用于捕获系统流量,但属于更高级的入站方式,启用时还会涉及路由、DNS、权限和防火墙。可参考Mihomo TUN 配置文档。
导入成功但不能用:按现象逐项排查
| 现象 | 优先检查 | 处理方法 | 正常标准 |
|---|---|---|---|
| 导入后提示 401 或 403 | 订阅权限、令牌、有效期 | 重新从服务后台复制新 URL;确认没有复制登录页地址。若后台仍拒绝,联系提供订阅的一方。 | 客户端更新时不再返回 401/403,且能生成配置卡片 |
| 请求超时或下载失败 | 本地网络、DNS、防火墙和 URL 是否可访问 | 先用浏览器或带超时参数的命令测试;确认系统时间正常,暂时切换网络后再试。 | 在限定时间内返回内容,客户端日志不再出现 timeout |
| 导入成功但节点为空 | 响应正文是否为 HTML、JSON 错误或空文件 | 重新下载并查看文件开头;若内容是登录页面或错误 JSON,回服务后台核对订阅类型。 | 代理组中出现可选择的节点或 provider 节点 |
| 配置已激活但网页直连 | 系统代理、代理组和规则 | 确认选择了具体节点,打开系统代理;原生内核则把应用代理指向 127.0.0.1:7890,或正确启用 TUN。 | 客户端连接日志出现请求,流量统计随访问增加 |
| 内核启动失败 | YAML 缩进、字段拼写、端口占用和配置路径 | 先运行 mihomo -t -f config.yaml;根据报错定位字段,不要直接删除未知字段。确认 7890 未被其他程序占用。 | 配置检查通过,进程持续运行,端口处于监听状态 |
如果订阅地址曾经泄露,最稳妥的处理是回到提供订阅的后台重置或重新生成链接,并在所有客户端替换旧地址。不要把包含令牌的 URL 发给他人,也不要将下载后的完整配置上传到公开代码仓库。
导入后的五项验收清单
- 地址验收:订阅 URL 能返回内容,不是登录页、错误 JSON 或空响应。
- 配置验收:客户端出现配置卡片,或原生 Mihomo 通过
mihomo -t -f config.yaml。 - 节点验收:代理组中能看到节点,且选中节点后没有立即报错。
- 接管验收:图形客户端已开启系统代理;原生 Mihomo 的应用代理已指向
127.0.0.1:7890,或 TUN 已正确启用。 - 流量验收:访问网页时客户端日志、连接数或流量统计发生变化。
只满足前两项,代表“订阅导入成功”;满足前三项,代表“配置可用”;五项都满足,才可以认为当前应用流量已经通过 Mihomo 处理。
常见问题
Mihomo 订阅链接应该从哪里获取?
通常从你已购买或已获得服务的后台复制订阅 URL。不要把网页登录地址、二维码图片地址或包含 HTML 的页面地址当成订阅链接;具体格式和有效期以提供方说明为准。
为什么订阅导入成功,但代理组里没有节点?
先检查下载内容是否为 HTML 登录页、JSON 错误信息或空响应,再核对订阅权限和有效期。导入成功只代表客户端保存了地址,不代表内容已经被解析为节点。
原生 Mihomo 导入订阅后,浏览器为什么还是直连?
原生内核不会自动替所有应用设置代理。请确认配置有 mixed-port 或 TUN,并将浏览器或系统代理指向 127.0.0.1:7890;同时检查规则中是否有 MATCH,Proxy。
Clash Party 里找不到 Profiles 或订阅管理怎么办?
不同版本可能使用配置、Profiles、订阅或从 URL 导入等名称。先查看侧栏和设置页,重点寻找 URL 输入框、导入、更新和激活按钮;菜单名称以当前版本为准。
订阅链接泄露后应该怎么处理?
立即在提供订阅的后台重置或重新生成链接,并在客户端替换旧地址。之后不要公开包含授权令牌的 URL、截图或完整配置文件。