安裝 Shadowrocket（小火箭）Linux 版前，請先確認 Linux 發行版與 CPU 架構：Debian、Ubuntu 系統通常選 deb；Fedora 等使用 dnf 的系統通常選 rpm；需要直接執行檔案時則可考慮 AppImage。本文提供本機安裝指令、執行權限設定及啟動失敗的排查方式。安裝完成後，再匯入向服務商取得的訂閱；安裝成功不代表連線已可使用。
1. 先確認發行版，再選安裝套件
deb、rpm、AppImage 是不同的散布格式，不是三種代理協定。選擇時應先看系統使用的套件管理器，再確認下載頁標示的架構與執行條件。副檔名相同不代表適用於所有 Linux 系統；檔案能下載，也不表示能在目前的電腦上執行。
| 系統環境 | 優先選擇 | 安裝或啟動方式 |
|---|---|---|
| Debian、Ubuntu 及使用 apt 的衍生發行版 | deb | sudo apt install ./shadowrocket.deb |
| Fedora 及使用 dnf 的 RPM 系發行版 | rpm | sudo dnf install ./shadowrocket.rpm |
| 希望直接執行獨立檔案的桌面環境 | AppImage | 新增執行權限後，以一般使用者身分啟動 |
先在終端機執行以下指令。/etc/os-release 中的 ID 與 ID_LIKE 可用來辨認發行版，uname -m 則用來查看電腦架構。請勿只憑桌面外觀判斷系統，也不要因為電腦採用相同 CPU 就略過相依套件檢查。
cat /etc/os-release
uname -m例如，x86_64 與 aarch64 代表不同架構。下載時請確認下載頁是否提供符合本機架構的版本；若沒有對應版本，請勿嘗試安裝其他架構的套件。AppImage 同樣受架構與系統執行程式庫限制，並非通用的架構轉換工具。
2. 下載後分四步準備本機檔案
以下指令中的 shadowrocket.deb、shadowrocket.rpm 和 shadowrocket.AppImage 是為了方便輸入而使用的本機檔名，不是伺服器上的安裝檔名稱。請先下載實際檔案，再於檔案管理員中重新命名；也可以保留原檔名，並將指令中的檔名換成磁碟上的完整名稱。
-
確認系統環境
開啟終端機，執行
cat /etc/os-release和uname -m，記下發行版與架構，再依下載頁標示選擇相符的套件。 -
取得檔案
前往下載頁的 Linux 區段，選擇 deb、rpm 或 AppImage。請等瀏覽器完成下載，不要對尚未下載完成的暫存檔執行安裝指令。
-
開啟檔案所在目錄
在檔案管理員中找到安裝檔，使用「在終端機中開啟」功能進入該目錄。若檔案確實位於
~/Downloads，也可以執行cd ~/Downloads；若目錄名稱經過本地化或自訂，請改用實際路徑。 -
選擇相應指令
deb 使用 apt，rpm 使用 dnf；AppImage 則先執行
chmod u+x，再以一般使用者身分執行。選擇其中一種方式即可，不必安裝全部三種套件。
開始前先用 pwd 確認目前目錄，再用 ls -lh 確認檔案存在。路徑含空格時需要加上引號，例如 sudo apt install "./shadowrocket linux.deb"。其中的 ./ 明確表示目前目錄中的本機檔案，請勿任意省略。
3. 安裝 deb：使用 apt 處理相依套件
在 Debian、Ubuntu 等使用 apt 的系統上，建議透過 apt 安裝本機 deb 套件。apt 會讀取套件的相依性宣告，並嘗試從系統已設定的軟體來源補齊相依套件。安裝檔來自本機，不代表整個安裝過程都不需要網路連線。
sudo apt update
sudo apt install ./shadowrocket.deb第一個指令會更新軟體來源索引；第二個指令會安裝目前目錄中的檔案。輸入 sudo 密碼時，終端機通常不會顯示字元或星號，這是終端機的密碼輸入方式。請先確認提示中預計安裝、升級或移除的項目，再決定是否繼續；若相依套件變更提示異常，請勿略過。
- 找不到檔案：執行
pwd和ls -lh，確認目錄、大小寫及檔名完全相符。 - 架構不相符：重新確認
uname -m的結果與下載項目，請勿加入強制忽略架構的參數。 - 無法滿足相依套件：先確認
sudo apt update是否成功，再檢查目前發行版是否符合套件的執行條件。 - 套件管理器遭鎖定：請等待系統更新或其他安裝作業完成，不要直接刪除鎖定檔案。
若先前使用其他工具造成相依套件狀態未完成，可以先執行 sudo apt --fix-broken install，閱讀修復方案後再確認。此指令會處理系統的套件相依狀態，無法讓不相容的安裝檔自動適用於目前系統。安裝成功後，請從桌面應用程式清單啟動 Shadowrocket，不要以 sudo 啟動整個圖形應用程式。
4. 安裝 rpm：使用 dnf 安裝本機套件
在 Fedora 等使用 dnf 的系統上，請透過本機 rpm 路徑安裝。rpm 是套件格式，dnf 則是能處理相依套件的管理器；其他採用 rpm 格式的發行版不一定使用 dnf，請遵循該發行版的套件管理方式，不要因此額外安裝另一套套件管理器。
sudo dnf install ./shadowrocket.rpmdnf 會顯示交易摘要，包括需要安裝的相依套件及可能發生的變更。若提示某項相依套件不存在，請先確認系統版本、軟體來源是否可用，以及安裝檔的適用範圍。不要為了消除提示而使用 --nodeps 強行略過相依性，也不要任意替換系統程式庫檔案。
deb 安裝路徑確認
- 套件管理器
- apt
- 本機安裝
sudo apt install ./shadowrocket.deb- 相依套件來源
- 系統已設定的軟體來源
- 啟動方式
- 安裝完成後，從應用程式清單開啟
請勿將 deb 檔交給 dnf 安裝，也不要省略本機檔案路徑。
rpm 安裝路徑確認
- 套件管理器
- 本文指令適用於 dnf
- 本機安裝
sudo dnf install ./shadowrocket.rpm- 相依套件來源
- 系統已啟用的軟體來源
- 啟動方式
- 安裝完成後，從應用程式清單開啟
rpm 格式不代表所有 RPM 系發行版都能直接執行。
5. AppImage：新增執行權限後直接啟動
AppImage 通常不會透過 apt 或 dnf 登錄為系統套件。請將檔案放在使用者目錄中適合長期保存的位置，新增執行權限後直接啟動。不要將檔案長期放在可能遭清除的暫存目錄，也不要把它當成 deb 或 rpm 交給套件管理器安裝。
chmod u+x ./shadowrocket.AppImage
./shadowrocket.AppImagechmod u+x 只會為檔案擁有者新增執行權限，不需要使用 chmod 777。從終端機啟動可以保留錯誤輸出，方便區分權限、架構與執行程式庫問題。雙擊後沒有視窗，不代表應用程式已在背景執行。
Permission denied：先檢查執行權限；若檔案所在磁碟以noexec掛載，即使已設為可執行也可能無法啟動，請將檔案移至允許執行的使用者目錄。Exec format error：優先檢查架構，以及檔案是否下載完整。新增執行權限無法解決架構不相符的問題。- 出現 FUSE 相關錯誤：部分 AppImage 執行時需要相容的 FUSE 程式庫；套件名稱依發行版而異，請參照目前系統的套件說明處理，不要任意替換系統的 FUSE 元件。
- 提示
GLIBC版本不符或缺少共用程式庫：請確認系統執行條件；不要手動覆寫系統的 libc，也不要將來源不明的程式庫複製到系統目錄。
更新 AppImage 時，請先結束正在執行的應用程式，再替換檔案並確認新檔案具有執行權限。請保留原有設定的備份，但不要以為更換檔案就會清除設定。deb、rpm 本機安裝也不代表已新增自動更新軟體來源；後續取得安裝檔請以本站下載頁為準。
6. 安裝成功後，分別檢查設定與路由
安裝要解決的是「程式能否執行」；訂閱與路由要解決的是「如何建立連線、如何處理流量」。啟動 Shadowrocket 後，先確認 Home 中的連線資料是否齊全，再檢查 Config 與 Global Routing。本文不會將特定平台的按鈕位置視為所有 Linux 桌面環境的固定版面，請以目前應用程式實際顯示的項目為準。
- 準備向服務商取得的訂閱連結，透過 Subscribe 項目匯入；匯入後確認清單中確實出現訂閱，更新後再檢查一次內容。
- 手動新增時，請在 Add Server 中依資料選擇 Type。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的欄位不可互相套用。
- 確認位址、連接埠與憑證。伺服器連接埠由服務商提供，不要因為有些連線常用
443，就自行改用該連接埠。 - 檢查 Global Routing 目前的模式，再測試已知可存取的目標。應用程式能啟動、設定能儲存、連線能使用，是三個不同的檢查項目。
Config
建議依目前設定中的規則選擇策略。請依自身需求檢查規則；FINAL 決定未符合前面規則時的最終處理方式，不一定固定代表代理或直連。
適用情況：已有可用的規則設定，需要依目標分流
Proxy
對納入代理處理範圍的連線套用代理策略。適合與 Config 的結果互相核對，但不能據此認定 Linux 上所有程式的流量都已經由代理處理。
適用情況：暫時確認問題是否與規則選擇有關
Direct
對納入處理範圍的連線採用直連，方便比對本機網路的存取結果。若目前停留在 Direct，不應將網頁能開啟視為代理連線正常運作的證據。
適用情況：比較直連與代理的存取差異
若瀏覽器與終端機的存取結果不同，請先確認兩者使用的代理入口是否相同，以及各自是否讀取系統代理或環境變數。不要自行填寫本機監聽連接埠；請查看應用程式中實際啟用的位址、連接埠與代理類型。變更套件格式無法修正錯誤的訂閱參數，也不能取代路由設定。
7. 常見問題：先查看終端機輸出，再決定下一步
下載了 deb，但系統沒有 apt，該怎麼辦？
執行 cat /etc/os-release 確認發行版，再回到下載頁選擇適用的格式。不要為了安裝 deb 而臨時在非 Debian 系統上加入 apt，也不要先轉換套件格式來略過相容性檢查。
AppImage 雙擊沒有反應，需要以管理員身分啟動嗎？
先在檔案所在目錄執行 chmod u+x ./shadowrocket.AppImage，再執行 ./shadowrocket.AppImage 查看錯誤訊息。一般啟動不需要 sudo；請依輸出排查權限、掛載選項、FUSE 或執行程式庫問題。
安裝完成後，應用程式選單中沒有項目，該怎麼辦？
直接執行 AppImage 不一定會自動建立選單項目，請先從終端機啟動。若安裝的是 deb 或 rpm，請先確認套件管理器的交易已成功完成，再重新開啟應用程式清單；不要把安裝錯誤提示誤認為安裝已完成。
匯入訂閱失敗，需要重新安裝 Linux 套件嗎？
請先確認向服務商取得的連結是否完整、是否已過期，以及目前網路是否能存取訂閱網址。回報錯誤時只提供已遮蔽敏感資料的訊息，不要公開 token、UUID、密碼或完整訂閱連結。若程式能正常啟動，應先排查設定與網路，不要反覆重新安裝。
向支援人員提供排查資訊時，請記錄發行版、uname -m 的輸出、所選套件格式、執行過的指令及完整錯誤文字。請分開描述「安裝相依套件失敗」、「視窗無法啟動」、「訂閱更新失敗」及「連線後無法開啟目標」，避免混淆不同階段的問題。