先按发行版选 DEB、RPM 或 PACMAN

Clash Party 是 Mihomo Party 项目延续使用的当前名称。官方 GitHub Releases 在本文核对时为 Linux 同时列出 DEB、RPM 和 PACMAN 包,并分别提供 64 位与 ARM64 架构。包格式不是功能版本:它主要决定由哪一种系统包管理器登记文件、依赖、升级与卸载。

发行版家族优先包典型后缀
Debian、Ubuntu、Linux MintDEB.deb
Fedora、RHEL 系兼容发行版RPM.rpm
Arch Linux、ManjaroPACMAN.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 绕过检查。

容器不是主机:如果在容器或远程终端运行命令,确认看到的是准备安装 GUI 的那台 Linux 主机架构。

从官方 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 或用户目录权限问题。

  1. 确认包管理器报告安装完成。
  2. 检查应用菜单是否生成 Clash Party 条目。
  3. 终端启动一次,记录首条明确错误。
  4. 确认同一用户可以写入应用配置目录。
  5. 导入配置后先测试系统代理,再评估 TUN 权限。

TUN 需要额外的虚拟网卡和路由权限,不能用 TUN 失败反推桌面包安装失败。先让界面、内核和系统代理工作,再单独处理 TUN。无桌面的服务器环境也不是 Electron GUI 的常规目标,不应把无法显示窗口误判为下载包错误。

升级、降级与卸载也交给包管理器

升级前导出重要配置并阅读 Release 说明,然后下载相同包格式和架构的新版本,用同一包管理器安装。不要同时保留手工解压副本与包管理版本,否则桌面快捷方式可能启动另一份二进制。需要降级时先确认配置格式兼容,并保留新版本数据的备份。

卸载应使用发行版的包查询与删除命令,先确认准确的软件包名,再决定是否保留用户配置。本文不提供盲目的删除命令,因为项目名称迁移和发行版打包可能导致登记名与下载文件名不同。官方构建与资产命名可核对 项目构建工作流;本地包安装语义可分别参考 Debian apt 和 Arch pacman 官方手册。

最终只需记住两个判断:发行版决定包格式,CPU 决定架构。版本号、文件名和散列必须来自同一个官方 Release,安装状态则由本机包管理器确认。

官方来源与版本边界

版本号、文件名和界面文字可能随项目更新而变化,操作前请以链接中的项目文档为准。