安裝 Shadowrocket（小火箭）Linux 版前，先確認 Linux 發行版與處理器架構，再從本站下載頁選擇 deb、rpm 或 AppImage。本文介紹本機檔案的安裝指令、AppImage 執行權限、首次啟動檢查方式，以及如何區分安裝問題與連線設定問題。適合已備妥 Linux 桌面環境，並準備匯入自有服務商設定的使用者。
先確認發行版、架構與執行環境
安裝檔格式與處理器架構是兩項不同條件。deb 適用於 Debian／Ubuntu 套件管理系統；本文的 rpm 安裝流程則適用於 Fedora，並使用 dnf。AppImage 可作為其他桌面發行版的選項，但仍受處理器架構、系統函式庫與執行環境限制，並非所有 Linux 系統都能執行。
開啟系統的 Terminal，執行以下兩個指令。第一個指令讀取發行版識別資訊，第二個顯示核心回報的機器架構。下載時請比對下載頁實際列出的架構，不要只依電腦品牌判斷，也不要把副檔名改成其他格式。
cat /etc/os-release
uname -mID=ubuntu或ID=debian：優先選擇 deb 安裝檔。ID=fedora：優先選擇 rpm 安裝檔，並使用 dnf 處理相依套件。x86_64通常對應 x64／amd64，aarch64通常對應 ARM64；請以下載頁實際提供的選項為準。- 只有命令列的伺服器與桌面環境不同。不要把缺少圖形工作階段所造成的啟動錯誤，誤判為安裝檔損壞。
下載前依環境選擇安裝方式
前往客戶端下載頁的 Linux 區段，選擇符合系統的檔案。本文不固定列出安裝檔名稱，以免將舊檔名誤認為目前的下載項目。下載完成後，請在瀏覽器的下載紀錄中確認儲存位置，後續指令直接使用該檔案的實際路徑。
選擇依據：系統套件管理或獨立檔案執行
Debian / Ubuntu / Fedora
- Debian／Ubuntu 選用 deb，並以 apt 安裝本機檔案。
- Fedora 選用 rpm，並以 dnf 安裝本機檔案。
- 套件管理器會記錄安裝結果，並嘗試從已啟用的軟體來源解析相依套件。
其他桌面發行版
- 先確認下載頁是否提供符合架構的 AppImage。
- 為檔案設定執行權限，並以一般使用者身分啟動。
- 將檔案放在可讀寫及可執行的位置，遇到相依性錯誤時再依發行版處理。
若有適用的系統套件，優先使用套件管理器；選擇 AppImage 時，另須確認系統相容性與執行權限。
一次只驗證一種安裝方式。若同時保留 deb 安裝版與 AppImage，桌面選單捷徑和終端機啟動的檔案可能不是同一份。排查時請記錄實際啟動路徑，避免修改了某個檔案，卻一直開啟另一個副本。
安裝指令：使用下載檔案的實際路徑
以下指令使用 Bash 撰寫。每組指令開始時會提示輸入檔案的完整路徑；直接貼上路徑，不要額外加上引號。指令中的雙引號可保護含空格的路徑，而 realpath -e 會確認檔案確實存在。路徑輸入錯誤時請先停止，不要繼續執行安裝指令。
Debian／Ubuntu：使用 apt 安裝 deb
read -r -p '請輸入 deb 檔案的完整路徑：' pkg
pkg=$(realpath -e -- "$pkg") && sudo apt install "$pkg"此處輸入的是本機檔案的絕對路徑，不是軟體來源中的套件名稱。apt 會列出準備安裝的套件、相依套件與磁碟空間用量，確認內容後再繼續。下載相依套件需要系統已設定可連線的軟體來源；若安裝失敗，請先查看終端機指出的相依套件名稱與軟體庫錯誤，不要反覆按兩下安裝檔。
- 顯示檔案不存在：回到瀏覽器的下載紀錄，確認路徑、大小寫，以及檔案是否已下載完成。
- 顯示無法滿足相依性：檢查發行版版本、架構與軟體來源設定；必要時執行
sudo apt update後再試一次，並保留原始錯誤訊息。 - 顯示套件管理器正在使用中：等待系統更新完成，不要直接刪除鎖定檔案。
Fedora：使用 dnf 安裝 rpm
read -r -p '請輸入 rpm 檔案的完整路徑：' pkg
pkg=$(realpath -e -- "$pkg") && sudo dnf install "$pkg"請使用 dnf，而非只執行較底層的安裝指令，以便一併處理系統軟體庫可提供的相依套件。rpm 是檔案格式，不代表所有採用 rpm 的發行版都提供相同版本的相依套件；不可直接將 Fedora 的相容性結論套用到其他發行版。
- 檢視安裝程序列出的變更；若出現大量非預期的移除項目，請先取消。
- 若遇到架構不符或缺少系統函式庫，請回到下載頁確認套件的適用範圍。
- 不要忽略相依性強行完成安裝，否則可能留下無法啟動的程式。
AppImage：設定權限後執行
read -r -p '請輸入 AppImage 檔案的完整路徑：' app
if app=$(realpath -e -- "$app"); then
chmod u+x -- "$app" && "$app"
fichmod u+x 只會為檔案擁有者新增執行權限，不需要擴大為所有使用者都可寫入。執行 AppImage 本身不需要使用 sudo。首次驗證建議從終端機啟動，即使視窗沒有出現，也能查看缺少函式庫、FUSE 或圖形工作階段相關的錯誤。
首次啟動：先確認程式可執行，再匯入設定
安裝完成與成功連線是兩回事。先確認程式能正常開啟，再匯入自有設定，最後檢查連線結果。以下依 Home、Config、Settings 的功能位置說明操作；不同平台的按鈕排列可能不同，請確認介面文字後再操作，不要只憑圖示位置猜測。
-
確認程式啟動
使用系統套件安裝後，從桌面應用程式選單開啟 Shadowrocket；使用 AppImage 則執行剛才確認的完整路徑。若沒有出現視窗，請先查看 Terminal 輸出，不要立刻變更網路設定。
-
匯入既有設定
前往 Home → 新增項目 → Type → Subscribe，輸入自己的訂閱網址後儲存並更新。訂閱網址可能包含存取憑證，請勿將完整網址貼到公開記錄或截圖中。
-
核對規則
前往 Config，確認目前啟用的設定；再核對 Global Routing 的選項。安裝完成不代表既有規則、策略名稱與伺服器參數一定彼此相符。
-
測試連線
在 Home 選擇既有設定中可用的連線並開啟開關，分別檢查連線狀態與瀏覽器的存取結果。若出現權限要求，請先確認要求來源，再依系統提示處理。
若程式能正常開啟但無法連線，請檢查位址、連接埠、驗證資訊與傳輸參數，不要反覆更換安裝檔。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 的參數結構各不相同，不能只複製伺服器位址就視為完成設定。本站不提供、不銷售也不推薦節點或訂閱。
區分 Global Routing 設定與安裝問題
瀏覽器仍能開啟某個網站，不能單憑這點證明流量符合預期策略；即使連線開關已開啟，也不代表每條連線都會採用相同路徑。請先核對 Global Routing，再依目前設定中的規則判斷。以下僅比較 Shadowrocket 各設定的用途。
Config
建議依目前設定中的規則選擇處理策略。結果取決於規則順序與策略引用，不應將 Config 簡化成固定的「部分直連、部分代理」。
適用情境：日常使用既有規則設定，以及驗證流量分流。
Proxy
由客戶端接管的連線會依代理模式處理，可用來對照 Config 的處理結果；這不代表系統中每個程序的所有流量都必定會由客戶端接管。
適用情境：暫時判斷問題是否與規則比對有關。
Direct
由客戶端接管的連線會依直連模式處理。若停留在此模式，不能以網頁可正常開啟來證明代理參數正確。
適用情境：比對本機網路的直接連線結果。
若 Global Routing 目前使用 Scene，請先檢查實際啟用的場景及其條件，再與上述模式比較。Settings → On Demand 涉及依條件觸發連線，並不負責安裝相依套件，也不是修復 AppImage 執行權限的開關。
DOMAIN-SUFFIX：檢查比對的網域後綴，以及命中後引用的策略是否存在。IP-CIDR、GEOIP：檢查 IP 範圍或地理位置規則，不要只依瀏覽器顯示的網域推斷命中結果。FINAL：檢查未符合前面規則的連線最後會如何處理。
常見錯誤：依實際狀況處理，勿反覆安裝
AppImage 按兩下沒有反應，先檢查什麼？
先從 Terminal 執行檔案並查看錯誤訊息。若出現 Permission denied，請確認 chmod u+x 是否執行成功；若已有執行權限，再檢查所在磁碟分割區是否以 noexec 選項掛載。可將檔案移至允許執行的使用者目錄後重試，不要變更整個磁碟的安全設定。
檔案明明在目錄裡，為什麼還是顯示找不到？
Linux 預設不會從目前目錄搜尋可執行檔。請使用檔案的絕對路徑，或在檔名前加上 ./。若使用絕對路徑仍出現 No such file or directory，請進一步確認錯誤是否來自程式載入器或缺少的執行階段函式庫，不要只是不斷修改檔名。
顯示 Exec format error，需要改用 rpm 嗎？
先執行 uname -m 確認架構，並檢查下載的檔案類型。這個錯誤可能與架構不符有關，修改副檔名無法解決問題。若檔案尚未下載完成，或實際上並非程式檔，請回到下載紀錄確認；不能只憑一個錯誤就判定原因。
程式視窗能開啟，但啟用連線後網頁無法載入，該怎麼辦？
此時請保留目前可正常啟動的安裝環境，檢查 Home 中的連線參數、Global Routing 與 Config。確認系統時間正確後，分別測試伺服器連通性與規則結果；不要以解除安裝再重裝取代參數檢查。
更新與清理：保留可還原的設定
更新前先儲存目前設定與必要的連線參數，並確認備份檔案的實際內容。設定可能包含訂閱網址、密碼或金鑰，請存放在只有本人能存取的位置。不要把應用程式視窗截圖當成完整備份，也不要假設解除安裝後設定一定會保留或一定會刪除。
- deb／rpm：回到本站下載頁取得符合系統的檔案，再依照對應的 apt／dnf 本機安裝流程更新。套件管理器會依套件中繼資料判斷更新關係；下載本機套件並不代表已新增可持續更新的軟體來源。
- AppImage：先結束正在執行的程式，再確認新檔案能正常啟動。新檔案完成啟動與設定驗證前，請保留舊檔案，並確認原有的桌面捷徑是否仍指向舊路徑。
- 解除安裝系統套件：先在系統軟體管理介面確認已安裝套件的實際名稱，再執行解除安裝；不要憑顯示名稱猜測指令中的套件名稱。
- 清除 AppImage：刪除檔案只會移除這份可執行檔；使用者設定、快取與捷徑是否仍存在，需另外確認。
記錄發行版、架構、安裝方式、啟動方式，以及終端機顯示的第一個錯誤，通常比只說「打不開」更有助於找出問題。若安裝已完成，後續排查應聚焦於實際錯誤，避免同時修改軟體來源、檔案權限與連線設定，以免無法判斷是哪項操作造成影響。