← 返回 GitHub Proxy 最新地址发布 - GitHub 文件 , Releases 首页

Mihomo 怎么导入订阅和配置文件？

更新于 2026-10-31 · ghproxy.cyou

简答：Mihomo 导入方式主要有两种：把订阅链接作为远程配置导入，或把本地 YAML 文件导入客户端。最快路径是打开客户端的配置/Profile 页面，粘贴订阅 URL 或选择 YAML 文件，保存后选中该配置，再开启系统代理或 TUN；如果导入后没有节点，先检查链接返回内容和配置格式。

定义：Mihomo 订阅是由远程 URL 定期获取的节点或配置内容，本地配置文件则是保存在设备上的 YAML 文件，两者都需要被客户端或 Mihomo 核心加载后才能生成代理组和可用节点。

先判断你手里的是订阅链接还是配置文件

不要把“节点链接”“订阅链接”和“本地配置文件”混为一谈。订阅链接通常是以 http:// 或 https:// 开头的远程地址，客户端可以保存它并按设置更新；本地配置通常是 .yaml 或 .yml 文件，需要从文件选择器或拖拽入口导入。

类型适合场景导入后的更新方式常见问题
订阅 URL已有服务商提供的远程订阅地址在客户端中手动更新或按客户端设置自动更新链接过期、被截断、返回 HTML、格式不兼容
本地 YAML已有完整配置文件，想离线保存或手动修改重新选择或替换本地文件YAML 缩进错误、缺少代理组、文件内容不完整
纯 Mihomo 的 config.yaml不使用图形客户端，直接运行核心替换工作目录中的配置并重载核心路径错误、字段不兼容、代理提供器未加载

对于 Mihomo 核心，远程订阅也可以通过 proxy-providers 的 type: http 配置加载；官方字段包括 url、path、interval 和可选的请求头。具体字段以 Mihomo 官方 proxy-providers 文档为准。

最快路径：在图形客户端导入订阅 URL

  1. 准备订阅地址。从提供方复制完整 URL，不要把前后的空格、换行或查询参数删掉，也不要把订阅令牌公开发到群聊、截图或代码仓库。
  2. 打开配置入口。Mihomo Party 通常进入配置或订阅管理页面；Clash Verge Rev 进入 Profiles 页面；FlClash 进入配置或 Profile 页面。不同版本菜单名可能变化，以当前界面为准。
  3. 粘贴并保存。选择远程 URL、Remote、URL 或类似入口，粘贴链接后保存或下载。Clash Verge Rev 官方文档将远程订阅分为订阅链接导入、订阅链接配置和 URL Schemes 等方式，并同时支持本地配置导入，详情可查看其官方 Profile 文档。
  4. 选中刚导入的配置。导入成功不等于已经生效。需要在配置列表中选中该配置，并确认它显示为当前配置、已激活或类似状态。
  5. 再开启代理入口。先选择代理模式和代理组，再按需要开启系统代理。TUN/虚拟网卡是另一条接管系统流量的路径，不应把“导入成功”“TUN 已开启”直接当成目标网站一定可用。

FlClash 的官方项目说明显示，它支持从订阅链接或文件导入配置，并覆盖 Windows、macOS、Linux 和 Android；如果你使用的是该客户端，应以其当前界面和项目说明为准，入口可能随版本调整。可参考FlClash 官方仓库。

导入本地 YAML 配置文件的步骤

  1. 先检查文件内容。用文本编辑器打开文件，确认不是网页错误页、登录页或空文件。正常的 Mihomo 配置通常会出现端口、代理、代理组、规则或代理提供器等配置块，但不同订阅可能只提供部分内容。
  2. 确认扩展名和格式。优先使用 .yaml 或 .yml 文件；不要把二维码图片、单条 ss:// 或 vless:// 链接直接改名为 YAML。
  3. 在客户端选择本地导入。在 Mihomo Party、Clash Verge Rev 或其他支持 Mihomo 配置的客户端中，选择 Local、本地文件、导入文件或拖拽入口，然后选中 YAML 文件。
  4. 启用并检查代理组。导入后打开代理页面，确认能看到代理组和节点。如果只有配置名称、没有节点，可能是文件本身没有 proxies，也可能是 proxy-providers 尚未成功下载。
  5. 需要回滚时删除新配置。不要直接覆盖原来能用的配置；先保留旧配置，确认新配置能够加载后再清理。

Clash Verge Rev 的官方文档明确区分了“新建配置文件导入”和“拖拽配置文件导入”，并说明导入后客户端会把文件复制到自身的配置目录，因此原文件移动或删除通常不会影响已导入副本；但具体行为仍应以当前版本为准。

纯 Mihomo 核心：用 config.yaml 加载订阅

如果你没有使用图形客户端，可以让 Mihomo 从工作目录加载 config.yaml。官方服务示例使用 -d 指定配置目录，例如把配置文件放进 /etc/mihomo 后，以 mihomo -d /etc/mihomo 启动。可查看Mihomo 官方服务启动文档。

下面只是结构示例，不是可直接启动的完整配置。其中的 URL、代理组引用和节点内容必须替换为你实际拥有且确认格式兼容的内容；示例没有提供真实节点，也不能保证替换后一定可用。

mixed-port: 7890
mode: rule
proxy-providers:
  provider1:
    type: http
    url: "https://example.invalid/your-subscription"
    path: ./proxy_providers/provider1.yaml
    interval: 3600
proxy-groups:
  - name: Proxy
    type: select
    use:
      - provider1
    proxies:
      - DIRECT
rules:
  - MATCH,Proxy

这里的关键边界是：proxy-providers 只负责获取或加载代理集合，proxy-groups 负责把代理集合纳入可选择的策略组，rules 决定请求最终匹配哪个策略。官方文档分别列出了代理提供器、代理组和规则的字段及引用关系，可参考代理组文档与规则文档。

Windows 可在配置目录打开 PowerShell，运行 .\mihomo.exe -d .\mihomo；Linux 或 macOS 可在终端运行 ./mihomo -d ./mihomo。如果启动后立即退出，先看终端报错；如果服务方式运行，则查看 systemd 状态和日志，而不要先反复更换节点。

导入后 5 项验证：确认是配置生效，而不是只下载成功

  1. 配置状态：配置列表显示当前配置已启用，且没有“解析失败”“更新失败”或类似错误。
  2. 节点状态：代理组中能看到节点或代理提供器内容；若只有 DIRECT，先检查订阅下载和配置引用。
  3. 代理选择：在代理组内选择一个节点或自动策略，不要停留在仅直连的选项。
  4. 系统接管：按客户端需求开启系统代理或 TUN。系统代理通常只影响遵循系统代理设置的应用，TUN 则可能接管更多系统流量，权限和路由要求也不同。
  5. 连接验证：先观察客户端日志和连接记录，再访问一个你有权访问的普通网页或使用系统网络诊断工具。出口变化、延迟数字或连接成功都只能说明某一层测试通过，不能替代对具体目标的逐项验证。

Mihomo 官方 API 文档提供了查看代理组、代理提供器和规则状态的接口；如果你启用了外部控制器，可以用这些状态判断配置是否加载、代理提供器是否有节点以及规则是否命中，而不是只看客户端首页的开关。

导入失败时按现象定位

现象优先检查处理动作
提示 URL 无效地址是否以 HTTP 或 HTTPS 开头，是否被截断重新从原页面复制完整链接，避免手动改写参数
下载成功但没有节点返回内容是否为 HTML、空内容或不兼容格式用文本编辑器检查前几行，并向提供方确认 Clash/Mihomo 格式
本地文件无法解析YAML 缩进、冒号、引号和重复键一次只改一个变量，先恢复到原文件再重新导入
有节点但无法连接当前代理组、系统代理/TUN、日志中的连接错误先确认代理组不是 DIRECT，再分开检查本地入口、DNS、上游连接和目标 TLS
订阅突然失效链接过期、令牌被重置或远程服务返回错误回到提供方页面重新复制或重置订阅；不要把旧令牌继续公开使用

如果怀疑订阅令牌已经泄露，应优先在提供方后台重置订阅地址，再删除客户端中的旧 URL。不要把包含令牌的链接贴入公开 issue、聊天记录或截图。

本文适用范围与版本提醒

本文是第三方使用指南，不是 Mihomo、Mihomo Party 或其他客户端的官方页面。Mihomo 核心、图形客户端和系统网络权限是三个不同层次：客户端负责导入和管理，核心负责解析配置与建立连接，系统代理或 TUN 决定应用流量是否进入代理入口。

截至 2026年10月31日，官方文档与项目仓库仍可能随版本更新调整字段、菜单和发布渠道。下载客户端或核心时，应核对对应项目的官方 Release；本文不提供未经核验的下载地址、订阅、节点、价格或可用性承诺。

常见问题

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

先确认配置是否已选中并激活，再检查订阅返回内容是否为空、是否为 HTML 错误页、是否被截断或不是 Mihomo/Clash 可识别格式。如果配置使用 proxy-providers，还要确认代理组通过 use 引用了正确的 provider 名称。

订阅链接和 YAML 配置文件可以互相替代吗？

不能简单等同。订阅链接是远程资源，适合定期更新；YAML 是本地配置，可能包含端口、代理组、规则和代理提供器等结构。把订阅 URL 保存成文本并改成 .yaml，不会自动变成有效配置。

导入 Mihomo 配置后要不要马上开启 TUN？

不一定。先用系统代理验证配置、代理组和节点是否正常；只有需要接管不遵循系统代理的应用，或客户端明确要求时，再按权限和系统条件配置 TUN。TUN 开启不等于目标连接必然成功。

Mihomo Party、Clash Verge Rev 和 FlClash 的导入方法一样吗？

基本逻辑相同，都是添加远程 URL 或本地文件、启用配置、选择代理组并开启流量入口，但菜单名称和版本行为可能不同。应以各项目当前界面及官方说明为准，不要照搬其他客户端的按钮名称。

纯 Mihomo 运行 config.yaml 时最容易出错的地方是什么？

常见问题包括工作目录指定错误、YAML 缩进错误、provider 没有被 proxy-groups 的 use 引用，以及配置文件字段与当前核心版本不匹配。优先查看启动终端或服务日志，再一次只修改一个字段。

相关阅读

参考资料

  1. Mihomo 官方文档：Proxy Providers 配置
  2. Mihomo 官方文档：Proxy Groups 配置
  3. Mihomo 官方文档：Routing Rules 配置
  4. Mihomo 官方文档：使用 systemd 创建服务
  5. Clash Verge Rev 官方文档：Profile 导入方式
  6. FlClash 官方仓库：功能与配置导入说明