Mihomo Party 使用教程：安装、订阅导入与连不上排查

更新于 2026-10-24 · oumei.online

简答：Mihomo Party 当前在官方仓库中以 Clash Party 名称发布。先从官方 Releases 下载对应系统文件，再导入订阅、选择代理组并开启系统代理；只有应用不遵循系统代理时，才考虑开启 TUN。

定义：Mihomo Party 是基于 Mihomo 内核的桌面图形客户端，当前官方代码仓库以 Clash Party 名称发布，可用于导入订阅、切换代理组、设置系统代理和管理 TUN。

先按这条最短流程配置

如果你只想先用起来，按下面顺序操作：下载官方发布页中的对应安装包，启动客户端；打开“订阅管理”，粘贴订阅链接并保存；点击订阅卡片更新配置；进入“代理”或代理组页面选择一个节点；最后打开“系统代理”。浏览器能正常访问后，再根据需要处理 TUN、DNS 或规则。

如果你已经同时运行 Clash Verge Rev、Mihomo、sing-box 或其他代理客户端，先全部退出，只保留一个客户端运行。多个程序同时接管系统代理、TUN 或同一个端口时，容易出现端口占用、代理残留和规则判断混乱。

截至 2026-10-24，Releases 标记为 Latest 的是 v2.0.3。下载时以官方发布页的当前标签和资产名称为准；如果发布页提供对应资产的 SHA256 文件，再对下载的原始安装包或压缩包进行校验，不要把校验文件本身当作校验对象。来源：Clash Party Releases。

它到底是什么：Mihomo Party、Clash Party 与 Mihomo 的关系

搜索词里常见的“Mihomo Party”，在官方组织的当前代码仓库中使用的是“Clash Party”项目名；官方文档站仍可看到 Mihomo Party 标题。因此，搜索到 Mihomo Party 教程时，应优先确认链接是否指向官方组织的 clash-party 仓库或其文档，而不是只看下载页上的软件名称。

Mihomo 是负责代理协议、路由规则、DNS、TUN 和连接处理的内核；Clash Party 是提供图形界面的桌面客户端。简单说，客户端负责按钮、订阅管理和配置编辑，内核负责真正启动代理和处理流量。不要把其他内核或其他客户端的字段直接复制到本客户端。

官方仓库当前列出的桌面平台包括 Windows、macOS 和 Linux。iOS 没有对应的这个桌面客户端；Android 也不能直接照搬桌面安装包，需要使用适配移动系统的客户端。平台资产、架构和系统要求应以具体 Release 页面为准。

Windows、macOS、Linux 下载与首次启动

Windows

1. 打开官方 Releases 页面，按 Windows 版本和处理器架构选择安装版或便携版。普通 Windows 10/11 用户优先确认是 x64 还是 ARM64；旧系统不要凭文件名猜测兼容性。
2. 安装后启动客户端。如果要启用 TUN 或客户端提示需要提升权限，按客户端提供的管理员启动、服务模式或授权流程操作，不要直接给下载目录开放过大的权限。
3. 如果客户端已启动但浏览器没有变化，先确认“系统代理”开关，而不是直接开启 TUN。

macOS

1. 按 Intel 或 Apple Silicon 选择 PKG；macOS 10.15 与 macOS 11 及以上的资产要以发布页实际标注为准。
2. 首次打开若出现“无法验证开发者”或类似拦截，先确认文件来自官方发布页且未被改动，再尝试“系统设置”→“隐私与安全性”→“仍要打开”。Apple 明确提醒，绕过安全检查会增加风险，因此不要对来源不明的安装包使用该操作。参考 Apple：安全地打开 Mac 应用。
3. 如果需要 TUN 或系统代理权限，按系统弹窗授予权限；若仍无法启动，重新打开客户端并查看连接日志，不要先删除所有配置。

Linux

1. 根据发行版选择 DEB、RPM 或其他官方发布资产，并确认 amd64、arm64 等架构。
2. 安装或解压后，确认主程序和数据目录属于当前运行用户，且主程序具有执行权限。可用下面命令检查并修正单个文件：

   ls -l ./clash-party-<版本号>
   chmod u+x ./clash-party-<版本号>

3. 如果使用 systemd 管理自启动，建议使用专用用户运行，并让该用户只拥有程序目录和配置目录所需权限；修改所有者时使用 chown，不要用 root 身份长期运行桌面客户端。Ubuntu 的文件权限说明可参考 Ubuntu：Working with files。
4. 启用 TUN 后若出现权限或路由问题，先关闭 TUN 验证系统代理是否正常，再根据日志处理，不要同时运行多个内核。

导入订阅：链接是什么，怎样避免导入后失效

订阅链接是一条由配置提供方生成的地址，客户端通过它获取节点和配置。它通常包含访问凭据，应当像密码一样保存，不要公开粘贴到论坛、截图或聊天记录中。链接泄露后，能够访问该链接的人可能取得你的配置内容；如果已经泄露，应按提供方的流程重置或更换。

1. 从你信任的配置提供方复制完整订阅链接，确认没有漏掉开头、结尾或特殊字符。
2. 打开客户端左侧“订阅管理”，添加订阅，粘贴链接并保存。
3. 点击刚添加的订阅卡片或其更新按钮，等待配置下载完成。
4. 进入订阅卡片的详情、编辑或配置入口，确认订阅状态、更新时间和代理组是否出现。
5. 选择一个代理组，再选择其中的节点。若只有订阅名称而没有节点，先检查订阅返回内容和客户端日志。

不要只根据浏览器打开订阅地址后的页面判断成功。部分订阅会依据 User-Agent 返回网页、Base64 文本或不同格式内容，浏览器能打开不代表客户端一定能解析。更可靠的判断是看客户端订阅更新结果、配置解析提示和日志。

官方文档说明，覆写可以用于修改订阅配置，并且在订阅更新后继续生效；入口是左侧“覆写”页面，导入或创建文件后，再到“订阅管理”中打开对应订阅的“编辑信息”并选择覆写。参考 Mihomo Party 官方文档：覆写。

系统代理、规则、全局、直连和 TUN 怎么选

系统代理只影响会读取系统代理设置的程序；TUN 通过虚拟网卡和系统路由接管更底层的流量，因此权限、路由和 DNS 影响范围更大。Mihomo 官方文档将 TUN 描述为可用于自动路由、DNS 劫持和按应用路由的入站方式；Windows、Linux 和 macOS 的 DNS 行为也不完全相同，参考 Mihomo 官方文档：TUN。

验证是否真的走代理，不要只看托盘图标：打开连接日志，确认请求命中的策略组和节点；也可以在关闭与开启代理后对比出口 IP。若浏览器可用但某个应用不可用，先判断该应用是否遵循系统代理，再考虑 TUN。

DNS 与端口：先恢复默认，再做精确检查

DNS 怎么排查

1. 先记录当前 DNS 设置，不要一次修改多个选项。
2. 在客户端的 DNS 设置中确认是否启用 DNS、增强模式是 fake-ip 还是 redir-host。Mihomo 文档列出这两种增强模式；fake-ip 会为域名返回映射地址，redir-host 保留域名解析结果，具体兼容性取决于应用和规则。参考 Mihomo 官方文档：DNS 配置。
3. 如果修改后大量域名都打不开，先恢复订阅原有 DNS 或关闭自定义 DNS，再重新测试。
4. Windows 可用 nslookup example.com 检查系统解析；Linux 和 macOS 也可用 nslookup example.com，若系统没有该命令，再安装对应 DNS 工具包。
5. 结合连接日志判断是“域名解析失败”“节点连接失败”还是“规则命中直连”。三者不是同一个问题。

端口被占用怎么办

混合端口常见默认为 7897 或 7890，以客户端设置页为准。先在设置中查看当前 mixed-port，再检查占用进程：

Windows：
netstat -ano | findstr 7890

macOS：
lsof -nP -iTCP:7890 -sTCP:LISTEN

Linux：
sudo ss -ltnp | grep :7890

Windows 的 netstat -ano 可以显示监听端口和 PID，参考 Microsoft Learn：netstat。macOS 用 lsof，Linux 用带 sudo 的 ss，避免只看到不完整的进程信息。若端口确实被另一个客户端占用，退出该客户端，或在 Mihomo Party 设置中修改混合端口，并让浏览器或应用重新读取代理设置。

常见故障的固定排查顺序

1. 先退出其他 Clash 或 Mihomo 客户端。
2. 确认客户端内核已经启动，查看日志中是否有配置解析错误。
3. 确认订阅更新成功，并且代理组里确实有可选节点。
4. 确认混合端口没有被占用。
5. 只开启系统代理，使用浏览器测试。
6. 观察连接日志命中的策略；若规则判断异常，再临时切换全局模式对比。
7. 最后才处理 DNS、覆写和 TUN，避免多个变量同时变化。

覆写规则的安全写法：不要直接替换整份 rules

覆写的目的，是让订阅更新后仍保留自定义修改。官方文档说明，数组可以使用 + 做前置或追加操作；直接写 rules: 会覆盖原规则数组，可能导致原订阅规则丢失。因此，新手只添加规则时，应优先使用 +rules:，并且只能引用订阅中确实存在的策略组。

下面示例只演示把一个域名强制直连，不依赖任何未声明的策略组：

+rules:
  - DOMAIN-SUFFIX,example.com,DIRECT

操作路径：左侧“覆写”→新建 YAML→粘贴内容→保存；然后进入“订阅管理”→找到目标订阅→右上角菜单→“编辑信息”→在“覆写”字段选择该文件→保存并重新更新订阅。官方 YAML 文档还说明，数组支持 +rules 前置和 rules+ 追加，详见 Mihomo Party 官方文档：YAML 覆写。

如果你想把域名交给代理，必须先确认订阅中存在可用的代理组名称，再把该名称写进规则；不要照抄网上的 MATCH,auto，因为“auto”并不是每份订阅都会提供的策略组。

最后检查：不用时关闭代理并保护订阅

完成测试后，如果不需要持续代理，关闭客户端中的“系统代理”；再打开系统网络设置，确认没有残留的手动代理地址。若启用了 TUN，也要关闭 TUN 并确认虚拟网卡或路由已恢复。客户端不运行时，浏览器仍打不开网页，优先检查代理残留，而不是重新导入订阅。

订阅链接、配置文件和连接日志可能包含节点地址、用户名或其他凭据。不要把完整链接、带凭据的日志和配置文件上传到公开平台；排障截图前先遮住链接、Token、服务器地址和个人信息。

如果你还需要处理跨设备的网络设置，可以继续查看设备配置指南；遇到端口、DNS、系统代理或连接失败问题，可参考连接问题排查。

参考资料

本文依据以下已打开的项目与系统文档整理：Clash Party Releases、Clash Party GitHub 仓库、Mihomo Party 官方文档：覆写、Mihomo Party 官方文档：YAML 覆写、Mihomo 官方文档：DNS 配置、Mihomo 官方文档：TUN、Apple：安全地打开 Mac 应用、Microsoft Learn：netstat。

常见问题

Mihomo Party 现在是不是改名了？

官方组织当前代码仓库和 Releases 使用 Clash Party 名称，官方文档站仍使用 Mihomo Party 标题。搜索下载时优先核对是否来自 mihomo-party-org/clash-party 官方仓库。

Mihomo Party 导入订阅后没有节点怎么办？

先看订阅更新结果和客户端日志，确认链接完整、配置解析成功且代理组已生成。浏览器能打开订阅地址不代表客户端一定能解析，因为服务端可能按请求方式返回不同内容。

Mihomo Party 应该开系统代理还是 TUN？

先开系统代理验证浏览器等常规应用；只有目标应用不读取系统代理时，再测试 TUN。TUN 涉及系统路由、权限和 DNS，出现断网时先关闭 TUN。

为什么所有节点都显示超时？

先退出 Clash Verge Rev、Mihomo、sing-box 等其他客户端，检查混合端口是否被占用，再看内核日志和节点连接结果。不要先同时修改 DNS、规则和 TUN。

覆写规则为什么不能直接写 rules？

直接写 rules 可能替换订阅原有规则。只想在前面添加规则时使用客户端支持的 +rules，追加到末尾时使用 rules+，并确认规则引用的策略组真实存在。

关闭客户端后网络仍然打不开怎么办？

检查系统代理是否仍开启，关闭系统代理并确认系统网络设置中没有残留手动代理；如果开启过 TUN，也要关闭 TUN并确认路由恢复。

相关阅读

• 设备配置指南
• 连接问题排查
• 常见问题

参考资料

1. Clash Party Releases
2. Clash Party GitHub 仓库
3. Mihomo Party 官方文档：覆写（mihomo.party）
4. Mihomo Party 官方文档：YAML 覆写（mihomo.party）
5. Mihomo 官方文档：DNS 配置
6. Mihomo 官方文档：TUN
7. Apple：安全地打开 Mac 应用
8. Microsoft Learn：netstat
9. Ubuntu：Working with files（ubuntu.com）