翻墙侠 - 自由上网的好帮手

Mihomo Party 配置教程:5 步完成安装、订阅与连接排查

更新于 2026-11-14 · fanqiangxia.top

简答:Mihomo Party 配置的完整顺序是:从当前官方 Releases 核对安装包、安装客户端、导入并更新订阅、启用配置和代理组、先测试系统代理后再考虑 TUN。订阅链接负责获取配置,配置文件中包含代理组和节点;只粘贴链接但没有更新、启用配置,通常不会出现可用节点。若导入失败或浏览器不通,先按本文的现象排错表检查响应内容、系统代理、端口和 DNS。

定义:Mihomo Party 配置教程,是围绕客户端安装、订阅导入、配置启用、代理组选择、系统代理与 TUN 设置以及连接验证建立的一套可复现流程。

先看 5 步流程:新手不要一开始就开 TUN

本文是第三方使用指南,与 Mihomo Party 项目官方无关联。当前项目官方仓库和文档页面主要使用 Clash Party、clash-party 等名称,搜索 Mihomo Party 时仍可能看到旧称;下载和设置时应以项目组织、仓库和当前 Releases 页面为准。本文核对日期为 2026 年 11 月 14 日。

截至本文核对日期,官方 Releases 页面将 v2.0.4 标记为 Latest,页面显示发布日期为 2026 年 10 月 18 日。版本和安装包会变化,实际下载前仍应重新打开该页面核对。

Mihomo Party 配置顺序与判断标准
步骤要做什么完成标准不要急着做什么
1核对官方仓库、版本和系统架构安装包能对应系统与 CPU 架构不要从搜索结果中的陌生下载站下载
2安装并完成首次启动客户端能打开,未出现权限或兼容性错误不要在来源未核实的情况下绕过系统保护
3备份并导入订阅订阅更新成功,配置卡片出现节点或配置内容不要把完整订阅链接发到公开群组
4启用配置、选择代理组和节点日志出现连接记录,节点能完成实际访问测试不要用测速结果替代真实网页验证
5先开系统代理,再评估 TUN浏览器或目标应用的请求进入客户端不要同时修改 TUN、DNS、覆写和端口

订阅链接可以理解为“获取配置的地址”,配置文件是客户端实际载入的内容,代理组负责决定使用哪个节点,节点则是具体的连接入口。这个关系弄清后,遇到“订阅成功但没有节点”“已连接但浏览器打不开”等问题,才能判断故障是在订阅、配置、代理组还是系统接管层。

第 1 步:核对官方来源、版本与系统架构

  1. 从项目组织的 GitHub 组织页进入 mihomo-party-org/clash-party 仓库,再打开仓库的 Releases。不要把个人账号下名称相近的仓库、第三方教程页面或要求输入订阅账号密码的下载页当作官方入口。

  2. 核对页面上的仓库组织名、仓库名、版本标签和 Assets。当前官方 Releases 页面展示了 v2.0.4,以及 Windows、macOS 和 Linux 的不同安装资产;具体文件名必须以页面当前显示为准。

  3. Windows 可在“设置→系统→系统信息”查看系统类型;macOS 打开“关于本机”确认 Intel 或 Apple 芯片;Linux 执行:

    uname -m

    常见结果包括 x86_64 和 aarch64。如果架构不匹配,可能出现安装失败、程序立即退出或系统提示不兼容。

  4. 下载后检查文件扩展名和页面资产是否对应。项目官方安装文档明确说明,安装版使用 exe,便携版使用 7z 压缩包,可参考安装指南。macOS 和 Linux 的安装包类型、架构与支持系统版本则以当前 Releases 页面为准。

仿冒下载站自查:地址是否能回到项目组织的 GitHub 仓库;仓库的 About 是否指向 clashparty.org;安装包是否能在 Releases 的 Assets 中找到;页面是否要求先提交订阅链接或账号密码。任何一项无法对应,都应标记为“未核实”,不要继续安装。HTTPS 证书只能说明连接已加密,不能单独证明网站属于项目方。

第 2 步:按系统安装并完成首次启动

Windows

  1. 安装版直接运行当前 Releases 页面中的 .exe 文件;便携版解压 .7z 后运行解压目录中的程序。不要照抄旧教程中的固定文件名,因为版本和架构会变化。

  2. 如果看到英文提示 Windows protected your PC,先返回 Releases 核对来源、文件名和哈希;来源无法确认时,不要点击强制运行。

  3. 如果需要写入系统代理、TUN 或服务组件时出现权限不足,关闭客户端后右键程序选择“以管理员身份运行”再测试。普通订阅导入不应成为长期使用管理员权限的理由。

macOS

  1. 根据本机芯片选择当前 Releases 中的 PKG。Intel 与 Apple Silicon 安装包不能混用。

  2. 首次启动被系统拦截时,先确认安装包来源,再打开“系统设置→隐私与安全性”查看是否出现允许打开的选项。来源不明时不要通过未知脚本绕过保护。

  3. 如遇权限或安装失败,官方 macOS 故障排除文档提供了停止 Helper 服务的命令:

    sudo launchctl stop party.mihomo.helper

    执行前确认你正在处理的是当前项目安装,并保留错误原文。不要一开始就删除服务文件。

Linux

  1. Debian、Ubuntu 类系统使用 Releases 页面实际下载的 DEB 文件:

    sudo apt install ./实际文件名.deb
  2. RPM 系统使用:

    sudo dnf install ./实际文件名.rpm
  3. Arch 系列只有在 Releases 提供对应包时才使用:

    sudo pacman -U ./实际文件名.pkg.tar.zst
  4. 安装后若提示架构不匹配,重新执行 uname -m 并选择对应资产。若程序从终端启动后立即退出,保留终端报错,不要先删除配置目录。

第 3 步:先备份,再导入并启用订阅

配置覆盖前先备份。最稳妥的做法是把你已经下载或导出的配置文件复制到单独目录,例如 Windows 的“文档\mihomo-party-backup-20261114”、macOS 的 ~/Documents/mihomo-party-backup-20261114,Linux 的 ~/mihomo-party-backup-20261114。官方文档明确给出了 macOS 数据目录,但 Windows 和 Linux 的当前数据目录在本次资料中未核实,因此不建议凭旧教程直接删除或覆盖应用数据目录。

macOS 官方故障排除页面列出的数据目录是:

~/Library/Application\ Support/mihomo-party

如果你要处理 macOS 安装问题,可先复制该目录;删除数据目录属于后续恢复步骤,不应作为首次排错动作。相关日志目录包括 ~/Library/Application Support/mihomo-party/logs/、/tmp/mihomo-party-install.log 和 /tmp/party.mihomo.helper.log,详见macOS 故障排除。

  1. 准备订阅链接。它通常是服务提供方生成的 URL,用于返回配置内容;不是节点名称,也不是普通介绍网页。

  2. 打开客户端中与订阅或配置管理相关的页面,添加订阅 URL 并保存。由于界面名称可能随版本变化,优先寻找“订阅”“配置”“Profiles”或相近入口,以当前客户端实际界面为准。

  3. 保存后执行更新。预期结果是出现更新时间、配置状态、节点或代理组信息。只添加但未更新,或者更新后未启用配置,都可能导致客户端仍使用旧配置。

  4. 在配置卡片或配置列表中选择启用、使用或切换到刚更新的配置,再进入代理组选择节点。官方快速上手文档的基本顺序也是导入订阅、选择节点、开启代理和选择模式,可参考快速上手。

检查订阅响应:不要使用只发送 HEAD 请求的 curl -I 来判断内容。Linux 或 macOS 可执行:

curl -L --max-time 20 -D headers.txt -o sub.txt "你的订阅链接"head -n 5 sub.txt

Windows PowerShell 可执行:

Invoke-WebRequest -Uri "你的订阅链接" -MaximumRedirection 5 -TimeoutSec 20 -OutFile sub.txtGet-Content .\sub.txt -TotalCount 5

预期是能保存配置响应或可解析内容。若开头明显是 HTML 登录页、验证码页或错误提示,说明链接、权限或服务端响应有问题;若出现 Could not resolve host,先查 DNS;若出现 Operation timed out,先查网络连通性。完整订阅 URL 等同于敏感配置入口,不要粘贴到公开截图、工单或聊天群。

第 4 步:选择代理组、节点与代理模式

配置启用后,先选择一个实际存在的节点,再做连接测试。节点为空时,优先回到订阅响应和配置启用状态,不要靠切换代理模式修复订阅内容。

规则、全局、直连模式对比
模式主要作用适合场景排查用法
规则依据配置中的规则决定直连或代理日常使用和分流查看连接详情,确认请求命中哪条规则
全局尽量让请求使用当前代理组临时验证节点是否能连接用于定位问题,不保证所有应用都遵守客户端代理
直连不使用代理节点恢复本地网络、对比前后差异测试完成后切回规则或需要的模式
  1. 先在全局模式中选择一个节点,等待状态变化并观察日志。

  2. 浏览器访问一个你平时能够访问的测试页面,再访问目标业务页面。实际页面能加载,比单次延迟数字更能说明连接是否可用。

  3. 切回规则模式,确认对应代理组已选择节点。如果某个目标打不开,查看连接详情,判断请求是直连、代理、拒绝还是没有进入客户端。

测速超时不一定等于节点完全不可用,测速地址、DNS、协议和本地网络都可能影响结果。优先选择连接成功且延迟相对稳定的节点,再用实际业务验证。

第 5 步:先设置系统代理,再决定是否启用 TUN

系统代理和 TUN 的接管范围不同。系统代理主要影响遵守系统代理设置的应用;TUN 通过虚拟网卡接管更多系统流量,通常需要额外权限。新手应先验证系统代理,再处理 TUN。

  1. 保持 TUN 关闭,只开启系统代理。打开浏览器访问测试页面,并观察客户端连接日志是否出现浏览器请求。

  2. 如果浏览器可用而某个命令行工具或应用不可用,先检查该应用是否支持系统代理,再考虑 TUN,不要直接同时修改 DNS 和覆写。

  3. 开启 TUN 前保存当前配置和开关状态。出现权限提示时,按客户端提供的授权流程操作;具体菜单名称以当前版本为准。

  4. TUN 开启后如果断网,立即关闭 TUN 和系统代理,等待直连恢复。Windows 可执行:

    ipconfig /flushdns

    该命令只清理 DNS 缓存,不能修复节点、端口或路由本身。若仍不能恢复,先重连当前网络,再回到日志和配置逐项排查。

  5. 如果出现“开机没网”,官方常见问题说明,常见原因是开启系统代理但客户端没有开机自启;可打开开机自启,或使用 pac 模式。相关说明见通用问题。

DNS 设置属于进阶项。没有明确的解析故障时,建议先保持默认;如果确认是域名解析慢、解析失败或 TUN 下 DNS 异常,再单独修改 DNS,并记录修改前后的值。不要把“已连接”直接等同于 DNS、代理和 TUN 都已正常。

现象式排错速查:先查哪一层

从报错现象到下一步动作
现象第一步检查命令或位置下一步
订阅导入失败确认 URL 返回的不是登录页或 HTMLcurl -L --max-time 20 -D headers.txt -o sub.txt "订阅链接"检查订阅权限、有效期或服务端响应;官方常见问题建议咨询节点提供方
节点为空确认订阅更新成功且配置已启用订阅/配置列表中的更新时间、状态和节点数量重新核对订阅 URL,不要先改 TUN 或 DNS
测速超时先用全局模式选择节点访问实际网页代理组、连接日志和浏览器测试比较其他节点和测试目标;不要只按测速数字下结论
浏览器不代理检查系统代理、浏览器独立代理和连接日志客户端系统代理开关、浏览器代理设置若没有请求记录,检查端口或浏览器设置;必要时参考Windows 系统代理无法上网排查
TUN 开启后断网先关闭 TUN 和系统代理,确认直连能恢复Windows 执行 ipconfig /flushdns;其他系统先重连网络逐项检查权限、虚拟网卡、DNS 和配置覆写
DNS 解析异常确认是否只有域名失败、IP 访问是否不同记录客户端日志和系统 DNS 设置再参考DNS 服务器选择和测试,一次只改一个变量

若问题集中在订阅更新,继续看Mihomo 订阅配置导入失败排查;若问题集中在虚拟网卡接管流量,继续看Mihomo TUN 模式无法接管流量排查。这两个页面分别对应订阅层和 TUN 层,不要把两个故障层混在一起修改。

配置完成后的安全检查清单

  • 下载地址能回到 mihomo-party-org/clash-party 组织和当前 Releases 页面。

  • 安装包架构与 Windows、macOS 或 Linux 本机架构一致。

  • 订阅 URL 没有出现在公开截图、日志、工单或聊天记录中。

  • 配置已更新并启用,代理组中确实存在可选择的节点。

  • 先验证系统代理,再决定是否需要 TUN;开启 TUN 前已经备份配置。

  • 遇到问题时只修改一个设置,并记录修改前后的现象和日志。

如果项目名称、菜单名称或安装包命名与旧教程不同,应优先查看当前官方仓库、Releases 和文档,而不是机械照抄旧截图。当前官方仓库 README 公开列出了 Smart 内核、Mihomo 内核、覆写、WebDAV 备份和订阅管理等功能,但具体开关位置仍应以当前客户端界面为准,可参考项目仓库说明。

常见问题

Mihomo Party 和 Clash Party 是什么关系?

当前官方仓库和文档主要使用 Clash Party、clash-party 等名称,搜索 Mihomo Party 时仍可能看到旧称。下载、版本和功能判断应以 mihomo-party-org/clash-party 仓库、当前 Releases 和 clashparty.org 文档为准。

Mihomo Party 配置时,订阅链接、配置文件、代理组和节点有什么区别?

订阅链接是获取或更新配置的 URL;配置文件是客户端实际载入的内容;代理组负责选择连接策略;节点是具体的连接入口。导入订阅后通常还要更新并启用配置,才能在代理组中选择节点。

订阅导入后没有节点怎么办?

先用 curl 或 PowerShell 保存订阅响应,查看文件开头是否为配置内容,而不是 HTML 登录页或错误提示;然后确认订阅已经更新并启用。如果服务端返回空内容或权限错误,应联系订阅提供方核实。

系统代理和 TUN 应该先开哪个?

建议先开启系统代理并验证浏览器,再根据目标应用是否遵守系统代理决定是否启用 TUN。TUN 需要额外权限,开启后断网时应先关闭 TUN 和系统代理,确认直连恢复后再排查。

为什么客户端显示已连接,但浏览器打不开网页?

先检查系统代理是否开启、浏览器是否设置了独立代理,以及客户端连接日志中是否出现浏览器请求。没有请求记录时,优先检查代理端口或浏览器设置;有请求但解析失败时,再排查 DNS。

为什么开机后没有网络?

官方通用问题文档指出,常见原因是开启系统代理但客户端没有开机自启。可打开开机自启,或改用 pac 模式;如果仍无网络,先关闭系统代理恢复直连,再检查客户端是否正常启动。

macOS 安装失败时可以直接删除 Helper 和数据目录吗?

不建议一开始就删除。先保留错误原文并尝试官方 macOS 故障排除页面中的服务停止或卸载步骤;删除 plist、Helper、日志和数据目录属于更彻底的恢复操作,执行前应备份配置,并确认路径与当前项目一致。

相关阅读

参考资料

  1. Releases · mihomo-party-org/clash-party
  2. GitHub - mihomo-party-org/clash-party
  3. Clash Party · GitHub 组织页
  4. 安装指南 - Clash Party(clashparty.org)
  5. 快速上手 - Clash Party(clashparty.org)
  6. Common - Clash Party(clashparty.org)
  7. macOS 故障排除 - Clash Party(clashparty.org)