本文說明 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 安裝套件,依上一節確認的結果選擇格式與架構。本文不指定固定的安裝檔名稱,也不以檔名中的數字判斷相容性。後續指令會透過互動提示讀取實際下載的檔案路徑。
-
確認系統資訊
執行
cat /etc/os-release與uname -m,記下發行版和 CPU 架構,不要根據桌面佈景主題判斷系統類型。 -
選擇檔案
開啟全平台下載頁的 Linux 區段,選擇相符的 deb、rpm 或 AppImage;確認瀏覽器已完成下載後再繼續操作。
-
複製路徑
在檔案管理員的檔案內容中查看檔案位置,取得包含檔名的完整絕對路徑。依下文提示輸入時,不要另外加上引號。
-
依格式操作
在 Bash 終端機執行對應小節的指令。若出現錯誤,先閱讀終端機輸出,不要接連改用不同格式覆蓋安裝。
三、Debian 與 Ubuntu:使用 apt 安裝 deb
對於符合目前系統的 deb,建議使用 apt 安裝本機檔案。相較於單純解壓縮,apt 會檢查相依性,並嘗試從目前已設定的套件來源取得所需套件。安裝時可能需要連線至發行版的套件來源;有本機安裝檔不代表整個安裝流程可以離線完成。
read -r -p "請輸入 deb 檔案的絕對路徑:" pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
第一個檢查指令會讀取套件內的名稱與架構,不會安裝程式。確認輸出符合預期後,再執行安裝。這裡使用絕對路徑,讓 apt 將輸入辨識為本機檔案;若使用相對路徑,應加上 ./,不能只輸入檔名。
- 若出現相依套件下載失敗,請檢查網路、套件來源網址與索引狀態;必要時執行
sudo apt update後再試一次。 - 若顯示架構不相符,請重新確認下載頁資訊與
uname -m的輸出,不要使用強制選項略過檢查。 - 若顯示找不到可安裝的相依套件候選版本,請確認目前發行版是否符合套件需求,不要混用其他發行版的套件來源。
- 安裝完成後,從應用程式選單啟動 Shadowrocket;不要為了啟動圖形介面而再次使用 sudo。
之後要使用新的本機 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 無法解除分割區的掛載限制。
- 執行
ls -l "$pkg"查看權限,確認目前使用者具有相應的讀取與執行權限。 - 若出現
Exec format error,請優先確認 CPU 架構以及檔案是否下載完整,不要將此錯誤視為訂閱連線問題。 - 若出現 FUSE 相關錯誤,請依目前發行版的文件確認所需相容元件。不同發行版的套件名稱不盡相同,不要照抄其他系統的安裝指令。
- 若提示缺少共享程式庫或執行程式庫符號,請記下完整錯誤訊息並檢查系統相容性需求;執行權限本身無法補足執行環境。
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 版免費。請前往下載頁選擇對應系統的檔案,安裝後依照教學匯入已有的訂閱並檢查路由設定。