AmyClash|网络连接与多平台使用指南

Mihomo 怎么导入订阅链接?粘贴后不生效这样排查

更新于 2026-10-24 · amyclash.top

简答:先确认你拿到的是可访问的订阅 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 PartyProfiles、配置或订阅管理页面下载或更新,激活配置,选择代理组,打开系统代理配置显示已激活,代理组出现节点,浏览器能通过代理访问测试页面
原生 Mihomo写入主配置的 proxy-providers 或本地配置文件通过 mixed-port 或 TUN 接管流量内核通过配置检查,端口监听,应用代理设置指向本地端口

最快操作:粘贴订阅、激活配置并开启代理

  1. 从服务后台复制订阅 URL。只复制完整地址,不要复制网页登录地址、二维码图片地址或浏览器地址栏中带后台路径的页面地址。订阅链接通常包含一段用于授权的令牌,不要公开粘贴到论坛、截图或日志中。
  2. 打开 Clash Party 的配置页面。当前版本常见入口是侧栏中的 Profiles、配置或订阅管理。进入后,在顶部的 URL 输入框粘贴订阅地址,点击导入、添加或从 URL 导入。由于界面名称可能随版本变化,按钮文字以当前客户端为准。
  3. 等待下载完成。看到配置卡片、配置名称或更新时间,才表示客户端保存了订阅;这不等于代理已经生效。若页面只显示错误提示,先不要反复点击更新,转到本文的故障表。
  4. 激活刚导入的配置。点击配置卡片,再选择启用、激活或设为当前配置。激活后检查代理组是否出现节点;如果节点列表为空,说明下载内容可能不是可识别的配置或节点列表。
  5. 选择代理组和节点。进入代理或策略组页面,先选择一个具体节点或自动选择组。只看到配置名称、但没有可选节点,不算导入完成。
  6. 开启系统代理。在客户端托盘菜单或设置页打开系统代理。若只打开了客户端而没有启用系统代理,普通浏览器和多数桌面应用不会自动使用 Mihomo。
  7. 最后验证。先访问一个你平时能正常打开的网页,再查看客户端连接日志、当前代理组和流量统计。三者都没有变化时,优先检查系统代理是否真的打开。

官方 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.yaml

Windows 如果当前目录没有加入 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 发给他人,也不要将下载后的完整配置上传到公开代码仓库。

导入后的五项验收清单

  1. 地址验收:订阅 URL 能返回内容,不是登录页、错误 JSON 或空响应。
  2. 配置验收:客户端出现配置卡片,或原生 Mihomo 通过 mihomo -t -f config.yaml。
  3. 节点验收:代理组中能看到节点,且选中节点后没有立即报错。
  4. 接管验收:图形客户端已开启系统代理;原生 Mihomo 的应用代理已指向 127.0.0.1:7890,或 TUN 已正确启用。
  5. 流量验收:访问网页时客户端日志、连接数或流量统计发生变化。

只满足前两项,代表“订阅导入成功”;满足前三项,代表“配置可用”;五项都满足,才可以认为当前应用流量已经通过 Mihomo 处理。

常见问题

Mihomo 订阅链接应该从哪里获取?

通常从你已购买或已获得服务的后台复制订阅 URL。不要把网页登录地址、二维码图片地址或包含 HTML 的页面地址当成订阅链接;具体格式和有效期以提供方说明为准。

为什么订阅导入成功,但代理组里没有节点?

先检查下载内容是否为 HTML 登录页、JSON 错误信息或空响应,再核对订阅权限和有效期。导入成功只代表客户端保存了地址,不代表内容已经被解析为节点。

原生 Mihomo 导入订阅后,浏览器为什么还是直连?

原生内核不会自动替所有应用设置代理。请确认配置有 mixed-port 或 TUN,并将浏览器或系统代理指向 127.0.0.1:7890;同时检查规则中是否有 MATCH,Proxy。

Clash Party 里找不到 Profiles 或订阅管理怎么办?

不同版本可能使用配置、Profiles、订阅或从 URL 导入等名称。先查看侧栏和设置页,重点寻找 URL 输入框、导入、更新和激活按钮;菜单名称以当前版本为准。

订阅链接泄露后应该怎么处理?

立即在提供订阅的后台重置或重新生成链接,并在客户端替换旧地址。之后不要公开包含授权令牌的 URL、截图或完整配置文件。

相关阅读

参考资料

  1. Mihomo 入站配置文档
  2. Mihomo 代理端口文档
  3. Mihomo TUN 配置文档
  4. Mihomo 官方 proxy-providers 字段说明
  5. Mihomo 官方配置示例
  6. Clash Party 官方组织页面
  7. Clash Party 官方发布记录