Shadowrocket Linux 安裝指南:Deb、RPM、AppImage 與 apt、dnf、chmod +x

依 Linux 發行版選擇套件:Debian/Ubuntu 使用 apt 安裝 deb,Fedora 使用 dnf 安裝 rpm;其他發行版可為 AppImage 設定執行權限後啟動。

本文重點

Debian、Ubuntu 和 Fedora 優先使用各自的原生套件;沒有合適的原生套件時,再確認 AppImage 是否符合執行條件。本文適合首次在 Linux 桌面安裝 Shadowrocket 的使用者,涵蓋系統與架構辨識、本機套件安裝、AppImage 啟動,以及相依套件缺漏和權限錯誤的排除方式。

先確認發行版與 CPU 架構

在準備執行 Shadowrocket 的 Linux 桌面開啟終端機,執行以下兩個指令。第一個會顯示發行版識別資訊與版本;第二個會顯示目前核心回報的機器架構。若是在虛擬機器中使用,請在虛擬機器內查詢,不要依據主機資訊選擇套件。

grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
uname -m
  1. 確認系統

    ID=debian 或 ID=ubuntu 對應 deb,ID=fedora 對應 rpm。衍生發行版可參考 ID_LIKE,但這僅表示發行版之間的關係,不保證特定套件的相依項目都能滿足;下載前仍須確認頁面標示的適用系統。

  2. 確認架構

    x86_64 與 deb 常用的 amd64 屬於相同架構;aarch64 與常見的 arm64 也是如此。在 Debian 或 Ubuntu 上,也可執行 dpkg --print-architecture,確認套件管理工具使用的架構名稱。若沒有相符的版本,請勿只改副檔名或強制安裝。

  3. 取得檔案

    前往客戶端下載頁,在 Linux 區選擇適用的格式與架構。下載完成後,從桌面檔案管理員開啟瀏覽器實際使用的下載資料夾,確認完整檔名,特別留意副檔名,以及瀏覽器可能加上的重複檔名編號。

  4. 切換至目錄

    可在檔案管理員中使用「在此開啟終端機」功能(若桌面環境有提供),或在終端機使用 cd 切換到實際的下載目錄。執行 pwd 和 ls -l 確認所在位置與檔案。以下以 local.deb、local.rpm 和 local.AppImage 作為範例檔名,執行前請換成下載檔案的完整名稱;檔名含空格時請保留引號。

Debian 與 Ubuntu:使用 apt 安裝 deb

在套件所在目錄執行以下指令。./ 表示 apt 要處理目前目錄中的檔案,而不是從軟體來源搜尋同名套件。apt 會讀取本機套件的相依項目,並嘗試從已設定的軟體來源補齊缺漏項目。

dpkg-deb -f "./local.deb" Package Architecture Depends
sudo apt install "./local.deb"

第一個指令只會讀取套件資訊,可用來確認套件名稱、架構和相依項目;第二個指令才會進行安裝。確認前請檢查終端機列出的新增、升級與移除項目。若有大量無關套件即將移除,請先取消操作,再確認發行版相容性及軟體來源設定。

Fedora:使用 dnf 安裝 rpm

在 Fedora 上使用 dnf 安裝本機 rpm。它會解析安裝交易,並嘗試從已啟用的儲存庫取得相依項目。以下的 rpm -qp 只會查詢檔案中的中繼資料,不會將軟體安裝到系統。

rpm -qp --queryformat '%{NAME} %{ARCH}\n' "./local.rpm"
sudo dnf install "./local.rpm"

兩種原生套件都會由各自的套件管理工具登錄。若要確認是否已安裝或規劃解除安裝,請使用前面查詢到的套件名稱,而非下載檔名。

deb 安裝記錄

套件資訊
dpkg-deb -f "./local.deb" Package Architecture
查詢安裝狀態
dpkg-query -s 實際套件名稱
解除安裝指令
sudo apt remove 實際套件名稱

將指令中的「實際套件名稱」替換為 Package 欄位的值。

rpm 安裝記錄

套件資訊
rpm -qpi "./local.rpm"
查詢安裝狀態
rpm -q 實際套件名稱
解除安裝指令
sudo dnf remove 實際套件名稱

將指令中的「實際套件名稱」替換為使用 rpm -qp 查詢到的 NAME。

若 dnf 顯示相依項目無法滿足,請先確認錯誤訊息指出缺少哪個套件或程式庫,再使用 dnf repolist --enabled 檢查儲存庫是否已啟用。若出現衝突,請勿忽略相依性強制安裝;安裝交易未完成,與應用程式已安裝但無法開啟,是兩種不同問題。

AppImage:設定執行權限後啟動

沒有合適的 deb 或 rpm 時,可在確認架構與執行條件相符後嘗試使用 AppImage。建議將檔案放在目前使用者可寫入且允許執行程式的位置,並保留於固定目錄。以下使用 u+x 僅為檔案擁有者新增執行權限,是 chmod +x 的限制範圍寫法;請以一般桌面使用者身分執行這兩個指令。

chmod u+x "./local.AppImage"
"./local.AppImage"

AppImage 可直接從終端機啟動;設定執行權限不會讓它登錄為系統套件,也不一定會自動出現在應用程式選單中。以下比較 Shadowrocket 的兩種部署方式;推薦選項的前提是下載頁提供適用的原生套件。

由套件管理工具登錄

建議

使用 apt 或 dnf 安裝,之後可依套件名稱查詢狀態或解除安裝。本機安裝的套件若沒有對應的軟體來源提供更新,仍須下載新版檔案,再使用同一套件管理工具安裝。

適用情況:有合適的 deb 或 rpm,並希望使用系統工具管理安裝記錄

以使用者身分獨立執行

直接從檔案所在位置啟動 AppImage。更換套件前,請先結束正在執行的應用程式,再為新檔案設定執行權限;若自行建立了啟動捷徑,也請確認捷徑指向新檔案的位置。

適用情況:沒有合適的原生套件,並希望在使用者目錄中保留可執行檔

安裝後無法開啟:依錯誤訊息排查

先確認問題發生在哪個步驟:若套件管理工具未完成安裝,請處理安裝交易中的第一個具體錯誤;若安裝狀態正常但視窗未出現,請在目前的桌面工作階段重現啟動問題。AppImage 可直接從終端機啟動,方便查看雙擊時看不到的錯誤訊息。

已執行 chmod,為什麼仍出現 Permission denied?

先使用 ls -l "./local.AppImage" 確認檔案擁有者的權限欄位中有 x,再使用 findmnt -T "./local.AppImage" -o TARGET,OPTIONS 查看掛載選項。若顯示 noexec,即使變更檔案權限也無法在該位置執行;請將檔案移至允許執行的使用者目錄後再試,不必修改系統掛載設定。

終端機顯示找不到 libfuse.so.2,該怎麼處理?

這表示目前 AppImage 的執行環境找不到 FUSE 2 相容程式庫。先查看發行版的軟體儲存庫提供的是 libfuse2、libfuse2t64 或其他對應套件,再依該發行版的套件名稱安裝相容程式庫;請勿移除系統現有的 FUSE 3 元件。若本機政策不允許使用所需的 FUSE 功能,請優先確認是否有相符的原生套件。

出現 Exec format error,是權限不足嗎?

通常應先檢查檔案格式與架構,而不是重複執行 chmod。若有 file 指令,請執行 file "./local.AppImage",並與 uname -m 的結果比對。若辨識為其他 CPU 架構,請回到下載頁重新選擇;若辨識為 HTML 文件,表示下載的不是可執行套件,請重新下載。

套件已安裝,為什麼在應用程式選單中找不到?

先在目前登入的桌面工作階段搜尋 Shadowrocket。仍找不到時,使用 dpkg-query -L 實際套件名稱 或 rpm -ql 實際套件名稱 檢查套件是否提供 .desktop 啟動項目。若執行環境只有遠端終端機或沒有桌面工作階段,即使安裝記錄正常,也不代表能顯示圖形視窗。AppImage 若沒有選單入口,請先使用上一節的終端機指令啟動。

下載 Shadowrocket