Debian、Ubuntu 和 Fedora 優先使用各自的原生套件;沒有合適的原生套件時,再確認 AppImage 是否符合執行條件。本文適合首次在 Linux 桌面安裝 Shadowrocket 的使用者,涵蓋系統與架構辨識、本機套件安裝、AppImage 啟動,以及相依套件缺漏和權限錯誤的排除方式。
先確認發行版與 CPU 架構
在準備執行 Shadowrocket 的 Linux 桌面開啟終端機,執行以下兩個指令。第一個會顯示發行版識別資訊與版本;第二個會顯示目前核心回報的機器架構。若是在虛擬機器中使用,請在虛擬機器內查詢,不要依據主機資訊選擇套件。
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
uname -m
確認系統
ID=debian或ID=ubuntu對應 deb,ID=fedora對應 rpm。衍生發行版可參考ID_LIKE,但這僅表示發行版之間的關係,不保證特定套件的相依項目都能滿足;下載前仍須確認頁面標示的適用系統。確認架構
x86_64與 deb 常用的amd64屬於相同架構;aarch64與常見的arm64也是如此。在 Debian 或 Ubuntu 上,也可執行dpkg --print-architecture,確認套件管理工具使用的架構名稱。若沒有相符的版本,請勿只改副檔名或強制安裝。取得檔案
前往客戶端下載頁,在 Linux 區選擇適用的格式與架構。下載完成後,從桌面檔案管理員開啟瀏覽器實際使用的下載資料夾,確認完整檔名,特別留意副檔名,以及瀏覽器可能加上的重複檔名編號。
切換至目錄
可在檔案管理員中使用「在此開啟終端機」功能(若桌面環境有提供),或在終端機使用
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"
第一個指令只會讀取套件資訊,可用來確認套件名稱、架構和相依項目;第二個指令才會進行安裝。確認前請檢查終端機列出的新增、升級與移除項目。若有大量無關套件即將移除,請先取消操作,再確認發行版相容性及軟體來源設定。
- 找不到相依項目:若軟體來源設定正確,可先執行
sudo apt update更新索引,再重試安裝。若更新成功後仍顯示某項相依套件沒有候選版本,請記下錯誤訊息中的套件名稱與版本條件,並確認目前發行版是否符合需求。 - 顯示架構不符:比對
dpkg-deb輸出的Architecture與dpkg --print-architecture的結果。請改用架構相符的檔案,不要為了安裝桌面應用程式而更改系統架構設定。
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 若沒有選單入口,請先使用上一節的終端機指令啟動。