本文適合準備在 Linux 桌面安裝 Shadowrocket 的使用者。先確認發行版與處理器架構，再從下載頁選擇 deb、rpm 或 AppImage；接著使用套件管理器安裝，或為 AppImage 新增執行權限。最後分別處理安裝失敗、桌面啟動失敗與連線設定問題，避免混為一談。
先確認發行版、架構與安裝套件格式
Shadowrocket（小火箭）的 Linux 安裝套件請從本站下載頁取得。套件格式取決於發行版，架構則由裝置與系統環境決定。副檔名相同，不代表套件內的程式適用於目前的處理器；AppImage 也不代表適用所有架構。
在桌面終端機執行以下兩個指令。第一個顯示發行版資訊，請留意 ID、ID_LIKE 與 PRETTY_NAME；第二個顯示核心回報的機器架構。常見的 x86_64 與 aarch64 屬於不同架構，請依下載頁列出的支援範圍選擇。
cat /etc/os-release
uname -m| 系統環境 | 優先確認的格式 | 處理方式 |
|---|---|---|
| Debian、Ubuntu 及相容環境 | deb | 使用 apt 安裝本機套件，並處理軟體來源中可用的相依套件。 |
| Fedora 及使用 dnf 的相容環境 | rpm | 使用 dnf 安裝本機套件，並確認交易中的相依套件異動。 |
| 其他桌面發行版 | AppImage | 先確認架構與執行環境，再新增執行權限。 |
deb 安裝：使用 apt 處理本機套件與相依套件
在 Debian 或 Ubuntu 桌面環境，建議使用 apt 安裝 deb。按兩下 deb 開啟軟體安裝程式，也能處理本機套件；不過終端機會保留完整錯誤訊息，更容易判斷問題是缺少相依套件、架構不符或權限不足。
-
確認系統
執行
cat /etc/os-release與uname -m。確認目前環境使用 apt，並記下架構。 -
取得安裝套件
前往下載頁的 Linux 區段，選擇適用的 deb。保留下載後的實際檔名，不要手動變更副檔名。
-
複製路徑
在檔案管理員中查看檔案位置並複製完整路徑。執行下方指令後，依終端機提示貼上路徑；輸入內容前後不要另外加上引號。
-
執行安裝
檢查 apt 列出的安裝與相依套件異動，確認後繼續。安裝成功後，從桌面應用程式清單啟動 Shadowrocket，不要使用 sudo 啟動圖形應用程式。
read -r -p '請貼上 deb 檔案的完整路徑：' pkg
pkg=$(realpath -- "$pkg")
sudo apt install "$pkg"這裡的 pkg 是終端機變數，用來儲存輸入的實際檔案路徑；指令中的雙引號可保護路徑裡的空格。realpath 會將路徑轉換為絕對路徑，避免 apt 把單純的檔名誤認為軟體來源中的套件名稱。執行前請確認輸入的是實際存在的 deb 檔案。
- 若顯示無法滿足相依性：查看缺少的相依套件及其需求，確認目前的發行版是否受支援。
sudo apt update只能更新已設定軟體來源的索引，無法讓不相容的套件變得相容。 - 若顯示架構不符：重新確認
uname -m的結果與下載頁上的架構說明，不要使用強制參數略過檢查。 - 若先前透過其他方式留下未完成的相依套件交易：先查看
sudo apt --fix-broken install提出的變更，確認不會誤刪所需軟體後再繼續。
rpm 安裝：使用 dnf 檢查安裝交易
在使用 dnf 的系統上，使用 dnf 安裝本機 rpm，通常比直接呼叫底層 rpm 安裝指令更容易處理相依套件。rpm 是套件格式，並非相容性保證：不同發行版的軟體來源、系統程式庫與封裝慣例可能各異。
read -r -p '請貼上 rpm 檔案的完整路徑：' pkg
pkg=$(realpath -- "$pkg")
sudo dnf install "$pkg"此指令會將本機套件交由 dnf 處理，再由目前系統的軟體來源提供可用的相依套件。出現交易摘要時，請逐項檢查新增、升級或移除的軟體。若出現大量與安裝目標無關的替換或移除，請取消交易，重新確認套件是否適用於目前環境。
檢查 deb 路徑
- 安裝工具
apt install- 輸入項目
- 本機 deb 的絕對路徑
- 相依套件來源
- 目前設定的軟體來源
- 成功判斷依據
- 安裝交易結束且未出現錯誤
安裝程式發生錯誤時，先處理套件與相依性問題，不要進入連線疑難排解。
檢查 rpm 路徑
- 安裝工具
dnf install- 輸入項目
- 本機 rpm 的絕對路徑
- 相依套件來源
- 目前啟用的套件庫
- 停止條件
- 架構錯誤或無法滿足相依性
不要略過相依性檢查，試圖讓失敗的交易看似成功。
若終端機顯示 dnf: command not found，請先確認系統實際使用的套件管理器。並非所有支援 rpm 的發行版都使用 dnf，不要只為了照抄指令而安裝另一套套件管理器。請參考發行版說明與下載頁的支援範圍，選擇相符的處理方式。
執行 AppImage：新增執行權限並檢視啟動輸出
AppImage 通常以單一可執行檔運作，不會透過 apt 或 dnf 註冊為一般系統套件。請先將檔案放在目前使用者擁有的固定目錄，再新增執行權限。首次執行時，建議在桌面工作階段的終端機操作並保留錯誤輸出；不要使用 sudo 執行整個圖形程式。
read -r -p '請貼上 AppImage 檔案的完整路徑：' app
app=$(realpath -- "$app")
chmod u+x -- "$app"
"$app"chmod u+x 會為檔案擁有者新增執行權限；常見的 chmod +x 寫法也能新增執行權限，但此處明確只修改擁有者的執行位元。變數參照中的雙引號可確保含空格的路徑仍會作為單一參數傳入。執行權限不會改變架構，也不會補齊系統執行程式庫。
- 若出現
Permission denied：使用ls -l -- "$app"查看執行位元，並確認檔案是否位於禁止執行的掛載點。即使已設定執行位元，noexec掛載選項仍可能阻止執行。 - 若出現
Exec format error：檢查架構與檔案格式。不要反覆修改權限；權限通常不是這類錯誤的主因。 - 若提示缺少 FUSE 相關程式庫：請依目前發行版的文件安裝相容元件。不同發行版的套件名稱可能不同，不要直接套用其他系統的套件名稱。
- 若提示無法連線至顯示服務：確認目前是在已登入的圖形桌面工作階段中執行。一般 SSH 終端機或沒有顯示服務的環境，不能視同桌面啟動環境。
首次開啟後：區分安裝成功與連線成功
Shadowrocket 視窗能夠開啟，表示程式已進入桌面啟動階段，但不代表使用者已有的服務已匯入，也不代表系統流量已依預期處理。安裝程式記錄用來釐清安裝問題；應用程式內的設定與連線狀態則用來釐清網路問題，兩者應分開檢查。
在 Home（首頁）檢查目前的服務設定，並依照已有的服務資料確認位址、連接埠、協定與認證欄位。不要只憑協定名稱猜測連接埠：例如資料明確標示連接埠為 443，就應填入該值，不要因為更換協定而自行改成其他連接埠。匯入含有存取憑證的連結時，不要將完整連結寫入公開記錄或截圖。
Config（設定）
建議Global Routing（全域路由）會依目前設定檔比對規則。請先在 Config（設定）確認已選取設定檔；未符合前序規則的連線會依 FINAL 指定的策略處理，並非固定直連。
適用情況：已有確認過的設定檔，並需要依目標分流。
Proxy（代理）
在客戶端接管的連線範圍內採用代理模式，可用來判斷問題是否與規則分流有關。這不代表作業系統中的所有程序與所有協定都已由客戶端接管。
適用情況：已有可用服務，想暫時縮小與規則相關的故障排查範圍。
Direct（直連）
採用直接連線至目標的模式。若目前目標需要透過使用者已有的代理服務連線，使用 Direct 無法驗證該代理服務是否可用。
適用情況：檢查基本網路與直連存取狀況。
Global Routing 中的 Scene（場景）應搭配已設定的場景使用，不建議作為首次安裝疑難排解的預設選項。Settings（設定）中的 On Demand（按需連線）用來依條件觸發連線，無法修復相依套件或授予檔案執行權限。請先手動確認連線，再設定自動化條件；不同平台顯示的選項以實際介面為準。
安裝錯誤常見問題與後續更新
下載了 deb，系統卻顯示不支援，改成 rpm 副檔名可以嗎？
不可以。副檔名無法決定檔案內部的套件結構。執行 cat /etc/os-release 確認系統，再回到下載頁選擇對應格式。不要靠重新命名或略過套件管理器檢查來安裝。
AppImage 已經執行 chmod +x，為什麼按兩下還是無法開啟？
請在圖形桌面的終端機直接執行檔案，查看第一則錯誤訊息。若是權限錯誤，檢查執行位元與掛載選項；若是架構錯誤或缺少程式庫，則依相應類別處理。按兩下後沒有視窗，無法據此判斷原因。
安裝成功後，為什麼還是找不到應用程式選單項目？
先關閉再重新開啟桌面應用程式搜尋。deb、rpm 是否提供選單項目，取決於套件是否包含桌面啟動檔；AppImage 不一定會自動註冊選單項目。不要猜測可執行指令名稱，也不要因此重複安裝多種格式。
之後更新時需要刪除所有舊檔案嗎？
請先備份現有設定。若套件識別資訊與升級關係相容，deb、rpm 可交由對應的套件管理器更新；若出現衝突提示，請先停止並查看原因。AppImage 則應先結束程式，再替換檔案，並重新確認執行權限與捷徑路徑。
結束疑難排解時，請記下發行版名稱、架構、安裝格式、執行的指令與完整錯誤訊息。這些資訊比「打不開」更有助於定位問題。分享記錄前，請刪除訂閱存取憑證、密碼及其他敏感欄位；若應用程式已能正常開啟但無法連網，請改查連線與設定，不必重複執行安裝指令。