Shadowrocket Linux 安裝指南:deb、rpm 與 AppImage 選擇方式

依發行版選擇安裝格式:Debian/Ubuntu 使用 apt 安裝 deb,Fedora 系統使用 dnf 安裝 rpm;其他發行版可為 AppImage 加上執行權限後直接執行。

本文重點

本文適合已準備在 Linux 桌面環境使用 Shadowrocket 的使用者。先確認發行版與處理器架構,再從本站下載頁選擇 deb、rpm 或 AppImage,依實際檔案路徑安裝;最後分別檢查程式啟動、訂閱匯入與流量接管。命令不依賴固定安裝檔名稱,也不預設本機代理連接埠。

一、先確認發行版、架構與安裝格式

deb、rpm 與 AppImage 是程式的散佈格式,不是三種代理協定。選擇格式時,先確認系統使用的套件管理工具,再核對下載頁列出的架構。Debian、Ubuntu 通常選擇 deb,Fedora 選擇 rpm;其他發行版可確認 AppImage 是否符合本機執行條件。系統能解壓檔案,不代表適合安裝另一種套件管理系統的套件。

在終端機執行以下兩個命令。第一個查看發行版識別資訊,第二個查看機器架構。不要只憑桌面外觀判斷系統:兩台電腦即使使用相同桌面環境,底層發行版與套件格式仍可能不同。

cat /etc/os-release
uname -m

系統資訊

NAME / ID
在 /etc/os-release 中確認發行版。
ID_LIKE
僅作為判斷發行版家族的參考,不能取代相容性說明。
uname -m
x86_64 與 aarch64 分別代表不同的處理器架構。

套件格式與架構都必須相符,不能只核對副檔名。

取得與執行

deb
交由 apt 安裝本機檔案並處理相依套件。
rpm
在 Fedora 上交由 dnf 安裝本機檔案。
AppImage
設定執行權限後,以目前的桌面使用者執行。

請以下載頁實際提供的格式與架構為準,不要轉換套件格式。

所有安裝檔均可從下載指南的 Linux 區段取得,安裝套件由本站 /dl/ 下載機制提供。請勿根據本文命令自行拼接下載網址。Shadowrocket 是閉源商業應用程式;iPhone/iPad 版從 App Store 取得,$2.99 一次付費;Mac(Apple 晶片與 Intel)、Windows、Android 與 Linux 版免費。

二、Debian/Ubuntu:使用 apt 安裝本機 deb 套件

以下命令請在 Bash 中執行。第一行會互動式讀取已下載檔案的完整路徑,輸入時不要額外加上引號;後續的雙引號會保護路徑中的空格。先查看套件中繼資料,再進行安裝。這裡讀取的是本機檔案,不會代你搜尋同名軟體。

read -r -e -p "輸入已下載 deb 檔案的完整路徑: " pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb --field "$pkg" Package Architecture Depends
dpkg --print-architecture
sudo apt install "$pkg"

使用完整路徑,是為了讓 apt 明確處理本機檔案。只輸入不含路徑的軟體名稱,則會變成從軟體來源搜尋套件。與只執行 dpkg -i 相比,使用 apt 安裝本機 deb 較方便在同一筆作業中處理相依套件;但仍要求本機能連線至已設定的軟體來源,且來源能滿足相依條件。

若出現 Unable to locate package,先確認輸入的是否為實際檔案路徑;若相依套件無法滿足,請檢查發行版相容性與軟體來源狀態。不要強制忽略相依套件來跳過錯誤,也不要把尚未完成的安裝作業當成安裝成功。

三、Fedora:使用 dnf 安裝本機 rpm 套件

rpm 套件同樣要先確認架構與套件資訊。以下操作適用於 Fedora 的 dnf 環境;其他使用 rpm 的發行版可能採用不同的套件管理命令與相依套件組合,不能只因副檔名相同就認定相容。

read -r -e -p "輸入已下載 rpm 檔案的完整路徑: " pkg
pkg="$(realpath -- "$pkg")"
rpm -qpi "$pkg"
rpm -qp --requires "$pkg"
uname -m
sudo dnf install "$pkg"

rpm -qpi 可查詢尚未安裝的套件檔案資訊,rpm -qp --requires 可列出所需能力或相依套件。使用 dnf 安裝時,請先閱讀交易摘要,再確認執行。下載本機套件不代表已下載所有相依套件;解析相依關係時仍可能需要連線至本機設定的軟體來源。

四、AppImage:授予執行權限不等於安裝至系統

AppImage 通常以單一可執行檔的形式保留,不會透過 apt 或 dnf 登記為一般套件。請先將檔案移至預計長期存放的位置,再新增執行權限。若直接從暫存下載資料夾啟動,之後清理該資料夾便會使原本的啟動路徑失效。

read -r -e -p "輸入已下載 AppImage 檔案的完整路徑: " app
app="$(realpath -- "$app")"
file -- "$app"
chmod u+x -- "$app"
"$app"

chmod u+x 只會為檔案擁有者新增執行權限;最後一行會以目前使用者啟動程式,並在目前終端機顯示診斷輸出。執行桌面程式時,請勿順手加上 sudo。安裝相依套件所需的管理員權限,與日常執行應用程式的使用者身分是兩回事。

  1. 若出現 Permission denied,先以 ls -l 檢查執行權限,再確認檔案所在分割區是否以 noexec 掛載。執行權限無法解除掛載選項的限制。
  2. 若錯誤訊息中出現 FUSE 或 libfuse.so.2,表示目前 AppImage 的掛載執行條件尚未滿足。請依本機發行版的套件說明安裝相應的執行相依套件;不同發行版的套件名稱可能不同。
  3. 若出現 Exec format error,請優先確認下載的架構是否正確;若檔案識別結果並非預期的可執行檔,請重新取得安裝檔。
  4. 若視窗沒有出現,請保留終端機的原始輸出。AppImage 並非通用相容層,圖形工作階段、系統程式庫與安全性政策仍可能影響啟動。

不要把停用安全機制作為通用的修復方式,也不要假設 AppImage 一定會自動建立桌面圖示或加入開機啟動。是否具備這些整合功能,請以實際介面與安裝結果為準。

五、首次開啟:分別檢查安裝、訂閱與連線

視窗出現只能表示程式已啟動,不能證明訂閱可用或應用程式流量已進入代理。以下步驟以使用者已有自己的服務商與訂閱為前提。本站不提供、不銷售、不推薦節點或訂閱;用戶端安裝與線路服務是兩個獨立環節。

  1. 確認啟動

    從桌面啟動器開啟 Shadowrocket;若使用 AppImage,請先從終端機執行。確認能進入 Home 後,再處理連線設定,避免把程式關閉與網路逾時混為一談。

  2. 匯入訂閱

    在 Home 右上角的「+」中將 Type 設為 Subscribe,輸入自己已有的訂閱連結並儲存。範例 https://example.com/sub?token=xxxx 是虛構網址,無法用於實際連線。

  3. 確認設定

    在 Home 確認更新後已出現項目;在 Config 確認目前使用的設定檔,再檢查 Global Routing。匯入節點清單與啟用規則設定是不同操作。

  4. 驗證流量

    開啟連線後,使用同一個應用程式存取同一個網址進行比對,記錄是否逾時或出現解析錯誤。若只有瀏覽器能使用,終端機工具卻無法使用,請繼續檢查各程式的代理設定與環境變數。

Linux 桌面應用程式採用系統代理的方式不盡相同。設定 HTTP 或 SOCKS 代理時,必須查看本機實際的監聽位址與連接埠,不要照抄網路上的固定數值。只有在應用程式明確提供並啟用相應的流量接管方式時,才依該方式進行排查;不能把「連線開關已開」解讀為所有處理程序的流量都會被接管。

六、Global Routing:區分規則問題與連線問題

安裝套件格式不會改變 Global Routing 的含義。排查時固定測試目標與使用的連線項目,每次只調整一個設定。以下比較僅適用於進入 Shadowrocket 處理路徑的流量,不代表能自動涵蓋系統中的所有程式。

Config

建議

依目前設定中的規則決定策略。檢查 DOMAIN-SUFFIX、IP-CIDR、GEOIP 等規則的排列順序,並確認 FINAL 的備援策略;Config 不代表所有未符合規則的流量都必然直連。

適用情境:日常使用已有的規則設定。

Proxy

將進入處理路徑的流量交由所選代理策略處理,而非依 Config 中的網域或位址規則分流。若結果與 Config 不同,請繼續檢查規則命中情形與策略選擇。

適用情境:暫時區分代理連線問題與規則問題。

Direct

讓進入處理路徑的流量採用直連策略。這不會替你關閉其他程式各自設定的代理,也不能證明目前網路一定能連上測試目標。

適用情境:以直連狀態進行比對,檢查目標本身是否可連線。

若設定中包含 DOMAIN-SUFFIX,example.com,DIRECT,應使用相應網域進行測試;改用 IP 位址直接連線,可能不會符合該網域規則。若使用 Scene,請依已設定的場景條件與相應策略檢查,不要將其視為固定的全域代理模式。診斷完成後,請恢復原本的日常設定,避免暫時測試影響後續判斷。

七、更新、解除安裝與常見安裝問題

deb 與 rpm 會由套件管理器記錄安裝狀態,但手動安裝本機檔案,不代表已新增可自動更新 Shadowrocket 的軟體來源。更新時請返回本站下載頁,取得適用於目前系統的套件,再交由相同的套件管理器處理。AppImage 通常需要以新版檔案取代目前執行的檔案,同時確認舊的桌面捷徑是否仍指向舊路徑。

安裝了 deb,為什麼沒有自動更新?

先確認系統是否已設定相應的更新來源。安裝本機 deb 本身無法證明存在更新來源;若需手動更新,請從下載頁重新取得檔案,使用 sudo apt install 搭配實際完整路徑進行安裝,並閱讀交易摘要。

解除安裝時要輸入哪個套件名稱?

deb 可使用 dpkg-deb --field "$pkg" Package 查看名稱,rpm 則使用 rpm -qp --queryformat '%{NAME}\n' "$pkg" 查看名稱。將輸出的實際名稱交給 apt remove 或 dnf remove,不要依檔案名稱猜測。

刪除 AppImage 後,設定也會消失嗎?

不一定。程式檔案與使用者設定通常分開存放,刪除 AppImage 不等於刪除設定。若要清理,請先使用應用程式提供的設定管理功能,並備份自己的設定;不要依猜測的路徑批次刪除使用者目錄中的檔案。

程式能開啟,訂閱卻一直是空的?

先確認 Home 中儲存的是 Subscribe 類型,並檢查連結是否完整、是否含有多餘空格,以及更新時是否回報錯誤。向既有服務商確認連結狀態時,請避免在公開截圖中洩露 token;更換 deb 或 rpm 無法修復失效的訂閱連結。

提交問題紀錄時,保留發行版名稱、uname -m 輸出、使用的格式、失敗階段與終端機原始錯誤訊息即可。訂閱網址、密碼、PrivateKey 等都屬於敏感資訊,傳送記錄前應先移除。若能指出問題發生於「套件管理器安裝失敗」、「AppImage 啟動失敗」或「啟動後連線失敗」,會比只描述「Linux 不能用」更有助於後續排查。

Shadowrocket 官方下載