先按发行版选 DEB、RPM 或 PACMAN
Clash Party 是 Mihomo Party 项目延续使用的当前名称。官方 GitHub Releases 在本文核对时为 Linux 同时列出 DEB、RPM 和 PACMAN 包,并分别提供 64 位与 ARM64 架构。包格式不是功能版本:它主要决定由哪一种系统包管理器登记文件、依赖、升级与卸载。
| 发行版家族 | 优先包 | 典型后缀 |
|---|---|---|
| Debian、Ubuntu、Linux Mint | DEB | .deb |
| Fedora、RHEL 系兼容发行版 | RPM | .rpm |
| Arch Linux、Manjaro | PACMAN | .pkg.tar.zst |
“基于某发行版”不保证百分之百兼容。例如衍生系统可能使用不同的库版本、桌面会话或安全策略。先查系统自己的包管理器和版本,再选相应资产。不要因为 DEB 文件能被解压,就在 Arch 上手工复制文件;那会绕过依赖和卸载记录。
再确认 x86_64、amd64、aarch64 与 arm64
包名中的 amd64 通常对应 64 位 x86 机器,系统常把同一架构显示为 x86_64;arm64 与 aarch64 通常指 64 位 ARM。不要只根据电脑品牌或“64 位系统”判断,因为两种架构都是 64 位,但二进制不能互换。
Shelluname -m
# Debian / Ubuntu 还可核对软件包架构
dpkg --print-architecture
# RPM 系可查看主机架构
rpm --eval '%{_arch}'
若结果是 x86_64,选择文件名中 amd64、x64 或 x86_64 的对应资产;若是 aarch64,选择 arm64 或 aarch64。32 位 x86、ARMv7、LoongArch 等结果不能假定兼容。官方 Release 没有列出对应架构时,应停止安装,而不是用 --force 绕过检查。
从官方 Release 对照版本、文件名和校验文件
打开 官方 Releases 页面,先阅读目标版本说明,再展开 Assets。本文在 2026 年 9 月 6 日核对时,页面首个发布为 v2.0.2;以后阅读本文时应以页面当时的首个稳定发布为准,而不是把这个版本号永久当作“最新”。
官方资产名会同时表达项目、平台、版本、架构与包格式。例如 DEB 资产使用 amd64 或 arm64,RPM 与 PACMAN 资产可能使用 x86_64 或 aarch64。选择后下载同版本、同文件名对应的 .sha256 校验文件(若该发布提供),不要把另一个架构或另一个版本的散列拿来比较。
Shellsha256sum clash-party-linux-VERSION-ARCH.PACKAGE
# 将输出与同一 Release 中对应的 .sha256 内容逐字比较
校验一致能发现下载损坏或文件被替换,但不能让非官方镜像自动变可信。来源页必须仍位于 github.com/mihomo-party-org/clash-party 官方仓库;搜索广告、网盘重打包和不明“一键安装脚本”不在这条信任链中。
用发行版包管理器安装本地文件
在下载目录运行对应命令,并把示例名替换成你实际下载的完整文件名。命令中的 ./ 很重要,它明确表示安装当前目录的本地包。先不要把来自不同版本的多个包一起安装。
Shell# Debian / Ubuntu
sudo apt install ./clash-party-linux-VERSION-amd64.deb
# Fedora 等使用 DNF 的 RPM 系统
sudo dnf install ./clash-party-linux-VERSION-x86_64.rpm
# Arch Linux / Manjaro
sudo pacman -U ./clash-party-linux-VERSION-x64.pkg.tar.zst
包管理器会检查架构、登记文件并处理它认识的依赖。若报告架构不匹配,应重新下载正确资产;若报告依赖不可满足,先确认发行版版本和仓库状态,不要从陌生网站手工拼装共享库。其他 RPM 系发行版可能使用不同前端,应遵循该系统官方文档。
首次启动失败时检查桌面与权限层
安装完成后从桌面应用菜单启动,或先查包安装的可执行文件与桌面条目。若没有窗口,使用终端启动并保留错误输出。优先检查图形会话、缺失库、配置目录权限和旧进程,而不是立即切换安装包格式。DEB 与 RPM 内的程序通常相同,换格式不能修复 Wayland、X11 或用户目录权限问题。
- 确认包管理器报告安装完成。
- 检查应用菜单是否生成 Clash Party 条目。
- 终端启动一次,记录首条明确错误。
- 确认同一用户可以写入应用配置目录。
- 导入配置后先测试系统代理,再评估 TUN 权限。
TUN 需要额外的虚拟网卡和路由权限,不能用 TUN 失败反推桌面包安装失败。先让界面、内核和系统代理工作,再单独处理 TUN。无桌面的服务器环境也不是 Electron GUI 的常规目标,不应把无法显示窗口误判为下载包错误。
升级、降级与卸载也交给包管理器
升级前导出重要配置并阅读 Release 说明,然后下载相同包格式和架构的新版本,用同一包管理器安装。不要同时保留手工解压副本与包管理版本,否则桌面快捷方式可能启动另一份二进制。需要降级时先确认配置格式兼容,并保留新版本数据的备份。
卸载应使用发行版的包查询与删除命令,先确认准确的软件包名,再决定是否保留用户配置。本文不提供盲目的删除命令,因为项目名称迁移和发行版打包可能导致登记名与下载文件名不同。官方构建与资产命名可核对 项目构建工作流;本地包安装语义可分别参考 Debian apt 和 Arch pacman 官方手册。
最终只需记住两个判断:发行版决定包格式,CPU 决定架构。版本号、文件名和散列必须来自同一个官方 Release,安装状态则由本机包管理器确认。
官方来源与版本边界
- github.com/mihomo-party-org/clash-party/releases
- github.com/mihomo-party-org/clash-party/blob/smart_core/.github/workflows/build.yml
- manpages.debian.org/apt/apt.8.en.html
- man.archlinux.org/man/pacman.8.en
版本号、文件名和界面文字可能随项目更新而变化,操作前请以链接中的项目文档为准。