先按發行版選 DEB、RPM 或 PACMAN

Clash Party 是原 Mihomo Party 專案延續使用的名稱。官方 Releases 在本文核對時，同時為 Linux 提供 DEB、RPM、PACMAN 的 64 位與 ARM64 資產。格式主要決定哪個套件管理器負責檔案、相依套件、升級和移除，並不是三種不同功能版本。

發行版家族優先套件副檔名
Debian、Ubuntu、MintDEB.deb
Fedora、RHEL 相容系RPM.rpm
Arch、ManjaroPACMAN.pkg.tar.zst

衍生發行版仍可能有不同函式庫和安全政策。先確認本機套件管理器；不要在不相符的系統上解壓 DEB 後手動複製，否則相依與移除紀錄都會遺失。

確認 amd64、x86_64、arm64、aarch64

amd64 通常對應系統顯示的 x86_64；arm64 通常對應 aarch64。兩者都是 64 位，但二進位不能交換。不可只看電腦品牌或「64 位作業系統」。

Shelluname -m
dpkg --print-architecture
rpm --eval '%{_arch}'

結果為 x86_64 時選 amd64、x64 或 x86_64 對應資產；為 aarch64 時選 arm64 或 aarch64。官方沒有 32 位 x86、ARMv7 或其他架構資產時就應停止，不使用強制參數繞過。

確認執行位置：容器或遠端終端的 uname 不一定代表準備安裝 GUI 的桌面主機。

在官方 Release 對照檔名和校驗

到 官方 Releases 讀取目標版本說明並展開 Assets。2026 年 9 月 6 日核對時，首個發布為 v2.0.2；日後應以當時頁面為準，不能把本文版本永久稱為最新。

檔名會表達版本、架構與格式。下載同一發布中對應的 .sha256（若提供），不可拿另一版本或架構的值比較。

Shellsha256sum clash-party-linux-VERSION-ARCH.PACKAGE

雜湊一致可發現損毀或替換，但不會讓第三方網盤變成官方來源。頁面網域與儲存庫擁有者都應是 github.com/mihomo-party-org/clash-party。

使用系統套件管理器安裝

進入下載目錄，將範例檔名替換成實際名稱。./ 表示安裝目前目錄的本機檔案。

Shell# Debian / Ubuntu
sudo apt install ./clash-party-linux-VERSION-amd64.deb

# 使用 DNF 的 RPM 系統
sudo dnf install ./clash-party-linux-VERSION-x86_64.rpm

# Arch / Manjaro
sudo pacman -U ./clash-party-linux-VERSION-x64.pkg.tar.zst

架構不符就重新下載；相依套件無法滿足時先檢查發行版版本與軟體來源，不要從陌生網站拼裝共享函式庫。其他 RPM 系統應遵循自己的官方工具。

不要直接執行網頁管道腳本：先下載、核對來源與雜湊，再安裝本機檔案。

首次啟動問題和 TUN 分開處理

先從應用程式選單啟動；沒有視窗時在終端執行並保存第一條錯誤。依序查圖形工作階段、缺失函式庫、設定目錄權限和舊程序。更換 DEB/RPM 格式不能解決 Wayland、X11 或家目錄權限問題。

  1. 確認套件管理器回報成功。
  2. 檢查桌面項目。
  3. 終端啟動並記錄錯誤。
  4. 確認目前使用者可寫入設定目錄。
  5. 先測系統代理，再處理 TUN 權限。

TUN 需要額外虛擬網卡與路由權限。它失敗不等於 GUI 套件安裝失敗；無桌面伺服器也不是 Electron GUI 的一般執行環境。

升級和移除也使用同一套件系統

升級前備份設定並讀 Release 說明，下載相同格式和架構的新版本，再由同一管理器安裝。不要同時保留手工解壓副本，否則捷徑可能啟動另一個二進位。降級前要考慮設定資料相容性。

移除前先查實際登記的套件名稱，再決定是否保留使用者設定；名稱遷移可能使登記名與下載檔名不同，因此不提供盲目刪除命令。資產規則可查 官方建置流程，安裝語意可查 Debian apt 與 Arch pacman。

發行版決定格式，CPU 決定架構；版本、檔名和校驗必須來自同一官方 Release。

安裝完成後可用套件管理器的查詢功能確認登記版本與架構，再把下載檔移到自己的封存位置或按需要清理。若是多人共用電腦，應先確認程式以哪個使用者保存設定，避免用 sudo 啟動 GUI 後產生由 root 擁有的設定檔，導致一般帳戶下次無法更新。這類權限問題與 DEB、RPM 或 PACMAN 的選擇無關。

官方來源與版本邊界

版本號、檔案名稱與介面文字可能隨專案更新而變動，操作前請以連結中的專案文件為準。