Debian、Ubuntu 建議優先選擇 deb;使用 dnf 的 Fedora 建議優先選擇 rpm。若想將程式留在個人目錄中,以檔案方式啟動,可在確認架構與執行環境相容後選擇 AppImage。以下步驟適用於首次安裝,或從一種格式改用另一種格式的情況,涵蓋下載前檢查、安裝指令及首次啟動錯誤排查。
先依發行版與處理器架構選擇格式
套件格式與處理器架構是兩項不同條件。Ubuntu 和 Fedora 即使使用相同處理器,通常仍分別採用 deb 和 rpm。反之,即使兩個檔案的副檔名都是 .deb,也可能適用於不同架構。請先確認系統,再依下載頁標示核對檔案;不要試圖透過變更副檔名,把一種套件格式轉成另一種。
cat /etc/os-release
uname -m
第一個指令用來查看發行版,請留意 ID;衍生發行版也可參考 ID_LIKE。第二個指令則查看目前的核心架構。常見輸出 x86_64 對應下載頁標示的 x86-64,deb 套件通常標為 amd64;aarch64 對應 64 位元 ARM,deb 套件通常標為 arm64。若系統使用的使用者空間架構與核心不同,請以套件管理器可處理的架構為準;在 Debian 或 Ubuntu 上可用 dpkg --print-architecture 確認。架構名稱的對應不代表每種格式都提供所有架構的版本。
使用套件管理器安裝
建議使用符合發行版的 deb 或 rpm。apt 或 dnf 會登錄已安裝的套件,並嘗試從已啟用的軟體來源解析相依性。安裝本機檔案本身並不會新增更新來源。
適用情況:發行版有相應套件,且希望透過系統套件管理器查看或解除安裝 Shadowrocket。
直接啟動 AppImage 檔案
將檔案存放在個人目錄,設定執行權限後即可直接啟動,不必先將它登錄到 apt 或 dnf。仍須符合該檔案的架構與執行環境需求。
適用情況:希望自行管理程式檔案,或系統沒有適用的 deb、rpm,但能執行該 AppImage。
下載後確認檔案位置與名稱
開啟下載頁
前往下載頁的 Linux 區,依照上一步確認的套件格式與架構選擇檔案。只需選擇一種安裝方式;重複下載三種格式並不會補上任何相依套件。
找到下載的檔案
在瀏覽器的下載記錄中找到剛下載的檔案,開啟檔案所在資料夾,並確認下載已完成。不要把尚未下載完成的暫存檔當成安裝套件,也不要假設檔案一定存放在名為
Downloads的資料夾。開啟檔案所在目錄
在終端機使用
cd切換至檔案所在目錄;路徑包含空格時,請用雙引號括住。執行pwd確認目前目錄,再用ls -l核對檔名。後續指令都從這個目錄執行。確認指令中的檔名
指令中的
Shadowrocket.deb、Shadowrocket.rpm和Shadowrocket.AppImage都是範例檔名。執行時請換成實際檔名,保留前面的./,並留意 Linux 檔名有大小寫之分。檔名含空格時,請將完整的./檔名放在雙引號內。
使用 apt 安裝 deb,使用 dnf 安裝 rpm
以下兩個指令只需執行與下載格式相符的一個。./ 表示這是目前目錄中的本機檔案,而不是要從軟體來源依名稱搜尋的套件。指令會顯示預計安裝、升級或移除的套件;確認清單後再繼續,尤其要留意非預期的移除項目。
安裝 deb
- 適用系統
- Debian、Ubuntu 等使用 apt 的發行版
- 安裝指令
sudo apt install "./Shadowrocket.deb"- 確認架構
dpkg --print-architecture- 查看套件名稱
dpkg-deb -f "./Shadowrocket.deb" Package
若出現缺少相依套件的提示,請先確認錯誤訊息中的套件名稱與版本需求,再檢查目前發行版的軟體來源。
安裝 rpm
- 適用系統
- Fedora 等使用 dnf 的發行版
- 安裝指令
sudo dnf install "./Shadowrocket.rpm"- 查看套件架構
rpm -qp --qf '%{ARCH}\n' "./Shadowrocket.rpm"- 查看套件名稱
rpm -qp --qf '%{NAME}\n' "./Shadowrocket.rpm"
rpm 是套件格式,不代表所有使用 rpm 的發行版都採用 dnf,也不代表不同發行版之間的安裝套件可以互換。
指令完成後,可使用資訊卡中的查詢指令讀取套件內部名稱。deb 使用者接著以 dpkg -s 加上該套件名稱查看狀態;若顯示 Status: install ok installed,即表示已登錄為安裝完成。rpm 使用者則以 rpm -q 加上套件名稱查詢。查詢時請勿使用下載檔名代替套件內部名稱。確認安裝完成後,再從桌面應用程式選單搜尋 Shadowrocket。
為 AppImage 設定執行權限並啟動
若打算長期使用 AppImage,建議先將檔案移至個人家目錄下方便管理的位置,再於該目錄執行以下指令。第一個指令只會為檔案擁有者新增執行權限;第二個指令則以目前使用者身分啟動。兩個指令都不需要 sudo。
chmod u+x "./Shadowrocket.AppImage"
"./Shadowrocket.AppImage"
- 保留終端機視窗:若雙擊檔案沒有反應,從終端機啟動即可直接查看錯誤輸出。先查看第一則具體錯誤,再判斷問題出在權限、架構還是執行環境。
- 區分檔案與選單項目:直接執行 AppImage 不代表它已登錄為桌面應用程式選單項目。即使在選單中搜尋不到,也可以回到檔案所在目錄,執行相同的啟動指令。
- 區分程式與設定:更換 AppImage 時,請先結束正在執行的程式,再下載新檔案、設定執行權限並啟動確認。刪除舊的 AppImage 只會移除程式檔案,不會清除使用者目錄中的應用程式設定。
常見安裝與啟動錯誤
檔案明明已下載,為什麼找不到?
先執行 pwd 和 ls -l,確認終端機目前所在位置與瀏覽器顯示的下載位置一致。重複下載後,檔名可能會多出編號;大小寫也必須與磁碟上的名稱一致。在終端機輸入 ./ 和檔名前幾個字元,再按 Tab 鍵自動補完,可減少手動輸入錯誤。
apt 或 dnf 無法安裝相依套件,該怎麼辦?
先記下缺少的相依套件名稱、版本需求與目前使用的發行版。若 apt 顯示套件索引過期或無法找到相依套件,可先執行 sudo apt update;dnf 則可用 dnf repolist 查看已啟用的軟體來源。更新索引後仍找不到所需版本時,請回到下載頁確認套件與系統是否相符,不要強制略過相依性檢查。
已設定執行權限,為什麼仍顯示 Permission denied?
先用 ls -l 確認檔案擁有者權限中包含 x,再用 findmnt -T . -o TARGET,OPTIONS 檢查目前目錄所在的掛載點。若選項中包含 noexec,即使為檔案設定執行權限也無法直接執行;請將檔案移至允許執行的個人目錄,再重新確認權限並啟動。
AppImage 顯示缺少 FUSE 或 libfuse.so.2,該怎麼辦?
先確認錯誤訊息是否明確指出缺少 libfuse.so.2。若是,請從目前發行版的軟體來源尋找提供該程式庫的相容套件;只安裝 FUSE 3 不代表系統也提供 FUSE 2 程式庫。若執行環境不允許 AppImage 所需的掛載操作,而下載頁提供相容的 deb 或 rpm,可改用相應的套件管理器安裝。