Shadowrocket Linux 版安裝指南:deb、rpm、AppImage 套件選擇

依 Linux 發行版選擇安裝套件:Debian/Ubuntu 使用 apt 安裝 deb,Fedora 等發行版使用 dnf 安裝 rpm;其他發行版可下載 AppImage,執行 chmod +x 後即可啟動。

本文重點

本文說明 Shadowrocket Linux 版的安裝套件選擇、CPU 架構確認、本機安裝指令與首次啟動檢查。deb 和 rpm 使用對應的系統套件管理工具安裝;AppImage 則需要執行權限及相容的執行環境。以下操作以使用者已有自己的服務商與訂閱為前提,先完成程式安裝,再分別檢查設定與網路連線。

一、先確認發行版,再選擇安裝套件

選擇安裝套件時,先確認發行版使用的套件管理系統,再查看 CPU 架構。桌面環境不能用來判斷:同樣使用 GNOME 或 KDE 的系統,底層可能分別採用 deb 或 rpm。開啟終端機,執行以下指令查看目前的系統資訊。

cat /etc/os-release
uname -m

/etc/os-release 中的 ID 用來識別目前的發行版,ID_LIKE 可協助判斷所屬系統系列;uname -m 則會顯示機器架構。常見的 x86_64 對應 x86 64 位元架構,下載頁有時會標示為 amd64;aarch64 對應 ARM 64 位元架構,下載頁有時會標示為 arm64。請以下載頁實際列出的檔案為準,不要只看副檔名選擇。

系統環境選擇格式安裝或執行方式優先確認項目
Debian、Ubuntu 及其衍生發行版deb使用 apt 安裝本機檔案套件架構與相依性是否相符
Fedora 等使用 dnf 的發行版rpm使用 dnf 安裝本機檔案發行版相容性與相依套件來源
其他相容的 Linux 桌面環境AppImage授予執行權限後啟動CPU 架構、執行程式庫與掛載條件

rpm 不代表所有使用 rpm 格式的系統都能執行同一個檔案。例如,使用其他套件管理前端的發行版,就不能直接照抄 dnf 指令。AppImage 也不是完全不依賴系統環境的容器;如果底層執行程式庫不符合需求,即使授予執行權限,仍可能無法啟動。

二、從下載頁取得檔案並記下路徑

前往全平台下載頁,找到 Linux 安裝套件,依上一節確認的結果選擇格式與架構。本文不指定固定的安裝檔名稱,也不以檔名中的數字判斷相容性。後續指令會透過互動提示讀取實際下載的檔案路徑。

  1. 確認系統資訊

    執行 cat /etc/os-release 與 uname -m,記下發行版和 CPU 架構,不要根據桌面佈景主題判斷系統類型。

  2. 選擇檔案

    開啟全平台下載頁的 Linux 區段,選擇相符的 deb、rpm 或 AppImage;確認瀏覽器已完成下載後再繼續操作。

  3. 複製路徑

    在檔案管理員的檔案內容中查看檔案位置,取得包含檔名的完整絕對路徑。依下文提示輸入時,不要另外加上引號。

  4. 依格式操作

    在 Bash 終端機執行對應小節的指令。若出現錯誤,先閱讀終端機輸出,不要接連改用不同格式覆蓋安裝。

三、Debian 與 Ubuntu:使用 apt 安裝 deb

對於符合目前系統的 deb,建議使用 apt 安裝本機檔案。相較於單純解壓縮,apt 會檢查相依性,並嘗試從目前已設定的套件來源取得所需套件。安裝時可能需要連線至發行版的套件來源;有本機安裝檔不代表整個安裝流程可以離線完成。

read -r -p "請輸入 deb 檔案的絕對路徑:" pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"

第一個檢查指令會讀取套件內的名稱與架構,不會安裝程式。確認輸出符合預期後,再執行安裝。這裡使用絕對路徑,讓 apt 將輸入辨識為本機檔案;若使用相對路徑,應加上 ./,不能只輸入檔名。

之後要使用新的本機 deb 更新時,仍可透過 apt 安裝新檔案,讓套件管理工具判斷升級關係。安裝單一本機 deb 不代表系統已設定應用程式更新來源;是否有更新來源,應查看實際的套件來源設定,不能單憑安裝成功就認定。

四、Fedora:使用 dnf 安裝 rpm

在使用 dnf 的系統上,先讀取 rpm 套件資訊,再進行安裝。dnf 會一併考量本機套件、系統已安裝內容及啟用中的套件庫,以處理相依性。副檔名相同但針對不同發行版建置的 rpm,仍可能需要不同的執行程式庫。

read -r -p "請輸入 rpm 檔案的絕對路徑:" pkg
rpm -qp --queryformat '%{NAME}\n%{ARCH}\n' "$pkg"
sudo dnf install "$pkg"

安裝交易開始前,請檢查 dnf 列出的新增、升級與移除項目。若輸出中有大量未預期的系統元件替換,請先取消交易,回到下載頁確認檔案及發行版需求。不要為了安裝一個應用程式,就直接接受無法解釋的系統層級變更。

deb 安裝確認

系統資訊
cat /etc/os-release
套件資訊
dpkg-deb -f "$pkg" Package Architecture
本機安裝
sudo apt install "$pkg"

apt 負責處理安裝程序與相依性,輸入的檔案必須適用於目前系統。

rpm 安裝確認

機器架構
uname -m
套件資訊
rpm -qpi "$pkg"
本機安裝
sudo dnf install "$pkg"

此處的指令適用於 dnf 環境;rpm 格式不代表可跨發行版相容。

五、AppImage:授予執行權限後啟動

AppImage 一般不需透過 apt 或 dnf 安裝:將檔案放在目前使用者可讀取的位置,授予執行權限後直接啟動。建議先決定固定的存放位置,避免程式執行後又移動或刪除原始檔案。以下指令只會修改目前選取的檔案,不會遞迴變更目錄權限。

read -r -p "請輸入 AppImage 檔案的絕對路徑:" pkg
chmod +x "$pkg"
"$pkg"

若按兩下後沒有明顯反應,請先在終端機執行最後一行指令並保留錯誤訊息。若出現 Permission denied,可能是檔案沒有執行權限,也可能是所在分割區使用 noexec 掛載選項;反覆執行 chmod 無法解除分割區的掛載限制。

AppImage 通常不會像本機 deb 或 rpm 一樣,自動列為套件管理工具中的已安裝項目,也不能因此假設應用程式選單一定會建立捷徑。更新前請先結束正在執行的程式並保留設定,再依下載頁說明替換檔案;新檔案可能需要重新授予執行權限。

六、首次啟動:分開檢查安裝與路由

能開啟 Shadowrocket,只能證明程式已啟動,不代表訂閱有效或流量已進入代理。請先確認使用者已有的服務資訊,再檢查 Home 中的伺服器選擇與連線狀態。設定檔在 Config 中管理,Global Routing 用來決定目前採用的路由模式;排查時一次只變更一項設定。

以下比較的是 Shadowrocket 本身的 Global Routing 設定,不同安裝套件之間沒有性能差異可供比較。deb、rpm 與 AppImage 是發行格式,不應用來判斷連線速度。

Config

建議

依目前設定的規則決定連線的去向。規則可指定代理、直連或其他已定義的策略,並非所有未符合規則的流量都會預設直連;最終結果也取決於兜底規則。

適用情況:已有可用設定,需要依網域或 IP 規則分流。

Proxy

將納入用戶端處理範圍的連線交由目前的代理策略處理。這可暫時排除分流規則的影響,但不會自動修正錯誤的伺服器參數,也不保證未被接管的流量會經過代理。

適用情況:短時間確認代理連線與規則比對是否為同一個問題。

Direct

讓納入用戶端處理範圍的連線採用直連。在 Direct 模式下網頁可以開啟,並不足以證明代理伺服器可用;測試代理功能前,請先確認目前的路由模式。

適用情況:對照檢查原始網路是否能連線至目標。

例如,以下兩行表示 example.com 及其子網域採用直連,其餘連線則由 FINAL 指定為 PROXY。此處的 PROXY 必須對應目前設定中可用的策略;這段內容只用來說明規則順序,不能直接取代完整的現有設定檔。

DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY

若 Home 中的 Connectivity Test 顯示測試結果,但瀏覽器連線仍不如預期,請繼續確認瀏覽器是否使用個別代理設定、系統代理是否指向實際監聽位址,以及 Global Routing 是否符合目前的測試目的。不要直接套用網路上常見的連接埠號碼;本機監聽連接埠須以實際設定為準。

七、安裝與啟動常見問題

apt 顯示找不到檔案,是套件損壞了嗎?

先確認輸入的是完整的本機路徑。使用 ls -l "$pkg" 確認檔案存在,且不是瀏覽器的下載暫存檔。相對路徑應加上 ./,絕對路徑則應以 / 開頭;檔案路徑不是套件庫中的套件名稱。

AppImage 已執行 chmod,為什麼還是無法開啟?

在終端機執行該檔案並查看錯誤訊息。先判斷是執行權限、noexec 掛載、架構、FUSE 或執行程式庫問題,再處理對應項目。不要使用 chmod 777 擴大檔案權限,也不要把所有啟動錯誤都歸咎於網路。

安裝 deb 後,還需要安裝 AppImage 嗎?

安裝完成且能正常執行後,不需要為了匯入訂閱再安裝另一種格式。安裝多份程式會增加辨識啟動項目與設定位置的難度。切換格式前,請先結束程式、備份設定並記下原本的安裝方式。

程式已開啟,但訂閱更新失敗,需要重新安裝嗎?

先確認已有的訂閱網址、有效狀態與目前網路,再檢查連線至該網址所需的路由條件。訂閱屬於設定資料,重新安裝程式不會變更服務端網址或授權狀態。排查時請勿公開完整訂閱連結,其中可能含有存取權杖。

若要記錄問題,請保留發行版名稱、uname -m 輸出、安裝格式、執行指令與完整錯誤訊息。這些資訊有助於區分安裝程序失敗、執行環境不符及連線設定錯誤。分享記錄前,請移除訂閱權杖、伺服器密碼及其他存取憑證。

下載 Shadowrocket 並繼續設定

iPhone/iPad 版在 App Store 一次性付費 $2.99,系統需求以 App Store 頁面標示為準;Mac(Apple 晶片與 Intel)、Windows、Android、Linux 版免費。請前往下載頁選擇對應系統的檔案,安裝後依照教學匯入已有的訂閱並檢查路由設定。

下載 Shadowrocket