本文適用於配備圖形桌面的 Linux 裝置。先在終端機確認發行版與系統架構,再從下載指南選擇 Shadowrocket 安裝套件。deb 和 rpm 會登錄至系統套件管理器;AppImage 則以可執行檔形式保留。下文將分別說明安裝指令,以及遇到相依性、權限或首次啟動錯誤時的排查步驟。
安裝前:確認發行版與系統架構
套件格式取決於 Linux 發行版及其套件管理器;系統架構則決定套件內的程式能否在目前系統執行。請在準備安裝 Shadowrocket 的系統上確認這兩項資訊。例如在虛擬機器中安裝時,應以虛擬機器內的輸出為準,而非主機的裝置型號。
-
辨識 Linux 發行版
開啟終端機,讀取
/etc/os-release中的ID和ID_LIKE。ID=debian或ID=ubuntu對應 deb;ID=fedora對應 rpm。衍生版可參考ID_LIKE,但也要確認實際使用的套件管理器,以及下載頁標示的適用範圍。 -
確認系統架構
執行
uname -m查看核心架構。x86_64對應 deb 常用的amd64標記;aarch64對應arm64。安裝 deb 時,再執行dpkg --print-architecture,並以套件管理器回報的系統架構為準。 -
選擇安裝套件
前往Shadowrocket 下載指南,在 Linux 區塊確認套件格式與架構。其他發行版可先查看是否有適用的 AppImage。若頁面沒有提供相符架構的套件,請勿只改副檔名或強行安裝。
-
啟動並記錄錯誤
依照對應套件格式完成下方操作。安裝 deb 或 rpm 後,先從桌面應用程式選單尋找 Shadowrocket;AppImage 則可直接在終端機執行。視窗開啟後,先確認
Home能正常顯示。若視窗沒有出現,記下終端機顯示的第一則錯誤,再參考後續問答排查。
grep -E '^(ID|ID_LIKE)=' /etc/os-release
uname -m
Debian/Ubuntu 使用 apt,Fedora 使用 dnf
請依照系統選擇其中一組指令執行。範例適用於 Bash:出現提示後,貼上實際檔案的絕對路徑並按 Enter,路徑前後不要加引號。後續指令中的雙引號請保留,即使路徑含有空格,也會作為單一參數傳入。先確認套件資訊符合預期,再執行安裝指令。
deb
- 適用的 Linux 發行版
- Debian、Ubuntu
- 安裝工具
apt install- 查詢本機套件資訊
dpkg-deb -f- 解除安裝工具
apt remove
解除安裝時請使用 Package 欄位的值,不要使用下載檔名。
rpm
- 適用的 Linux 發行版
- Fedora 及使用 dnf 的相容衍生版
- 安裝工具
dnf install- 查詢本機套件資訊
rpm -qpi- 解除安裝工具
dnf remove
解除安裝時請使用 Name 欄位的值,並先檢視交易摘要。
安裝 deb 套件
read -r -p '輸入 deb 檔案的絕對路徑: ' pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
apt 會從已設定的套件庫解析所需相依套件。若只輸入檔名而未包含目錄,可能會被視為套件庫中的套件名稱,因此此處請使用絕對路徑。如果相依套件清單來自過期的索引,可先執行 sudo apt update 再試一次;若仍顯示某項相依套件沒有可用候選版本,請勿混用其他發行版的套件來源,先確認下載套件要求的系統環境。
安裝 rpm 套件
read -r -p '輸入 rpm 檔案的絕對路徑: ' pkg
rpm -qpi "$pkg"
sudo dnf install "$pkg"
rpm -qpi 只會讀取本機套件資訊,不會安裝軟體。由 dnf 負責解析目前啟用的套件庫相依項目並執行安裝。若交易摘要顯示將移除與本次安裝無關的軟體,請先取消操作,檢查套件適用的發行版和套件庫設定,不要略過相依性檢查。
AppImage:設定執行權限並從終端機啟動
AppImage 通常不需要登錄到系統套件管理器。可先將檔案移至家目錄下適合長期存放的位置,再為檔案擁有者加上執行權限。以下同樣請輸入實際檔案的絕對路徑;執行程式本身不需要 sudo。
read -r -p '輸入 AppImage 檔案的絕對路徑: ' app
file -- "$app"
chmod u+x -- "$app"
"$app"
file顯示 HTML 或一般文字:下載到的可能是提示頁,而非程式檔案。請返回下載指南,重新選擇相符的套件;修改副檔名並無作用。chmod執行成功仍顯示Permission denied:使用findmnt -no OPTIONS --target "$app"查看所在檔案系統的掛載選項。若包含noexec,請將檔案移至允許執行的位置,不必更改整個磁碟的掛載設定。- 終端機明確提示缺少
libfuse.so.2:請查閱目前發行版的套件庫說明,找出提供此程式庫的 FUSE 2 相容套件。已安裝 FUSE 3 不代表系統也有這個程式庫,也不應因此移除現有的 FUSE 3。
首次開啟後:區分安裝問題與路由問題
能開啟 Home,代表程式已成功啟動,但不能據此判斷連線或規則是否生效。已有設定與連線資料的使用者,可在 Config 確認目前使用的檔案,再返回 Home 查看 Global Routing。下方兩種設定可用來區分規則分流與直連結果;切換模式僅用於檢查應用程式啟動後的行為,不會解決安裝相依性問題。
Config
建議依目前設定的規則順序處理請求。選擇一個已知應符合規則的網域進行比對;若設定末尾有 FINAL,再以一個未符合前面規則的請求,確認預設處理方式。
適用情況:已有設定,想在首次使用時確認規則分流是否符合預期。
Direct
所有流量都會直連,不能用這個結果判斷規則是否正確。暫時切換後,使用相同網路和相同的可直連目標再次測試;完成比對後請恢復原設定。
適用情況:確認目標在目前網路下是否可直連。
安裝、更新與解除安裝常見問題
Ubuntu 下載到 rpm,需要轉換嗎?
不需要轉換。請返回下載指南,選擇與 dpkg --print-architecture 輸出相符的 deb。即使可以修改檔案副檔名,套件內的中繼資料和相依項目仍維持原格式。
雙擊 AppImage 沒有反應,如何找出原因?
依照上文從終端機啟動,先確認錯誤是權限問題、缺少執行程式庫,還是 Exec format error。若是最後一種情況,先用 file 和 uname -m 比對檔案與系統架構,不要反覆執行 chmod。
更新前需要先解除安裝舊版嗎?
先結束應用程式,並備份需要保留的設定。同套件名稱、同系統架構的新版本 deb 或 rpm,可直接使用原安裝指令處理;先確認交易摘要顯示的是升級。本機安裝套件已登錄至套件管理器,不代表系統會自動從套件庫更新。
刪除下載檔案就算解除安裝了嗎?
對 deb 或 rpm 而言,刪除下載檔案不會移除已安裝的程式,必須使用對應的套件管理器解除安裝。對 AppImage 而言,結束程式後可刪除可執行檔,也可移除自行建立且仍指向該檔案的桌面捷徑。使用者設定與程式檔案是兩回事;清除設定前,請先確認是否仍需保留。