本文適用於配備圖形桌面的 Linux 裝置。請先確認發行版與 CPU 架構，再從本站下載頁選擇 Shadowrocket 安裝檔：Debian、Ubuntu 通常使用 deb；Fedora 等採用 dnf 的系統使用 rpm；若想直接執行獨立檔案，則可選 AppImage。下文說明如何安裝本機檔案、設定執行權限，以及排除啟動錯誤與檢查更新；連線設定則以您已擁有服務商與訂閱為前提。
一、先確認發行版與架構，再選擇安裝格式
Shadowrocket（小火箭）的 Linux 安裝檔格式會決定由哪種工具管理檔案及處理相依套件，不會改變協定功能。請勿只看副檔名就執行：發行版、CPU 架構與下載頁列出的系統需求都必須相符。AppImage 可減少對發行版套件管理格式的依賴，但不代表同一個檔案能在所有架構與系統環境中執行。
請在終端機依序執行以下指令。第一個指令會顯示發行版資訊，第二個則顯示核心回報的機器架構。若輸出為 x86_64，請確認下載項目是否標示相符的 x86-64 架構；若為 aarch64，則確認是否提供對應的 ARM64 版本。下載頁若沒有相符項目，請勿透過更改副檔名嘗試安裝。
cat /etc/os-release
uname -m| 目前系統 | 安裝格式 | 處理方式 |
|---|---|---|
| Debian、Ubuntu 及相容系統 | deb | 使用 apt 安裝本機檔案並處理相依套件。 |
| Fedora 等採用 dnf 的系統 | rpm | 使用 dnf 安裝本機檔案並處理相依套件。 |
| 其他採用 RPM 的發行版 | rpm | 先確認相容性，再使用該發行版的套件管理工具；請勿直接套用 dnf 指令。 |
| 希望保留獨立執行檔案 | AppImage | 確認架構與執行需求，設定執行權限後再啟動。 |
安裝檔統一由全平台下載頁的 Linux 區取得，請以頁面實際提供的檔案為準。Linux 版免費；iPhone / iPad 版在 App Store 一次性付費 $2.99，Mac（Apple 晶片 / Intel）、Windows、Android 版也免費。請勿混用不同平台的取得方式。
二、依四個步驟完成下載前檢查
以下流程將「選擇套件」與「設定連線」分開處理。安裝程式能啟動，只表示本機執行條件大致符合；能否連線仍取決於您已有的伺服器參數、網路與目前路由設定。首次安裝時，請先不要自動接管網路，方便區分安裝錯誤與連線錯誤。
-
確認系統
執行
cat /etc/os-release與uname -m，記下發行版與架構。本文後續的互動指令以 Bash 撰寫，您可先執行bash進入該終端環境。 -
取得檔案
開啟本站下載頁 → Linux，依系統選擇頁面實際提供的 deb、rpm 或 AppImage。下載完成後，請在檔案管理員中確認檔案位置；尚未下載完成的檔案請勿交給安裝程式。
-
安裝並啟動
依下一節的對應指令安裝或執行。首次啟動程式時請使用一般使用者身分；只有套件管理器安裝等系統操作需要管理員授權，請勿使用
sudo啟動整個圖形應用程式。 -
匯入並確認
前往 Home →「+」→ Type → Subscribe，填入您已有的訂閱，儲存並更新。選擇可用設定後檢查 Global Routing，再視需要啟用連線；成功匯入訂閱不代表所有目標都能正常存取。
三、使用 apt 安裝 deb，使用 dnf 安裝 rpm
以下指令不預設安裝檔名稱。終端機提示輸入時，請貼上剛下載檔案的絕對路徑，再按 Enter 繼續；路徑前後請勿額外輸入引號。指令中的 "$pkg" 已處理路徑包含空格的情況。若檔案管理員的「複製位置」提供的是 file:// 網址，請先轉換成本機檔案路徑再使用。
Debian / Ubuntu：安裝本機 deb
read -r -p '請輸入 deb 檔案的絕對路徑：' pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"dpkg-deb 這一行會讀取套件名稱與架構，方便在安裝前再次確認。apt install 接受的是本機檔案路徑，而非遠端套件名稱；它會嘗試透過已設定的套件來源解決相依套件。若出現缺少相依套件的提示，請先檢查系統套件來源與網路；請勿使用強制忽略相依套件的參數，也不要為了完成安裝而隨意加入不明套件來源。
Fedora 等 dnf 系統：安裝本機 rpm
read -r -p '請輸入 rpm 檔案的絕對路徑：' pkg
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"rpm -qp 只會查詢指定檔案的中繼資料，實際安裝則交由 dnf 處理。請先閱讀交易摘要再確認：若出現大量移除系統元件、架構不符或相依套件衝突，請取消操作。其他採用 RPM 的發行版不一定預先安裝 dnf，套件也不一定相容，請先確認下載頁的說明。
- 提示找不到檔案：請重新確認路徑、大小寫，以及下載是否完成。請勿將網頁網址當成本機路徑。
- 提示架構不符：請比對
uname -m與套件中繼資料，重新選擇安裝檔；無法透過重新命名轉換架構。 - 提示無法滿足相依套件：請檢查發行版相容條件與套件來源狀態；請勿以略過相依性檢查的方式完成安裝。
四、AppImage 先設定執行權限，再以一般使用者身分執行
AppImage 通常以單一檔案形式保留，不會登錄在 apt 或 dnf 的安裝資料庫中。您可以先將檔案移至個人目錄中的固定位置，再設定執行權限。請勿長期從瀏覽器暫存目錄執行，以免清理暫存檔後找不到程式。以下指令仍在 Bash 中執行，並請輸入實際檔案的絕對路徑。
read -r -p '請輸入 AppImage 檔案的絕對路徑：' app
chmod u+x "$app"
"$app"chmod u+x 只會為檔案擁有者增加執行權限，不需要將檔案權限改為所有人皆可寫入。若連按兩下沒有反應，從終端機執行較容易看到錯誤訊息。若出現 Permission denied，除了檢查執行權限，也請確認所在檔案系統是否以 noexec 掛載；例如某些外接儲存裝置或受限目錄，即使增加執行權限也無法執行。
FUSE 相關錯誤應依發行版處理。部分 AppImage 執行環境需要 FUSE 支援。若終端機明確提示缺少相關程式庫或無法掛載，請查閱目前發行版的套件說明，再安裝相符元件。請勿盲目套用其他發行版的套件名稱，也不要移除系統已有的 FUSE 元件。
AppImage 也需要基本的圖形工作階段與系統執行環境。在純終端機伺服器、容器或缺少桌面工作階段的 SSH 環境中，檔案可執行不代表圖形視窗一定能顯示。若出現 cannot open display 等提示，請先回到本機桌面工作階段排查，而非反覆執行安裝指令。
五、啟動後區分安裝、訂閱與路由問題
開啟視窗後，請先確認 Home、Config、Settings 都能正常使用，再匯入您已有的連線資訊。協定與伺服器端參數必須一致：Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 不是可以任意互換的標籤。將某項設定的 Type 改成另一種協定，無法修正伺服器端不相符的問題。
排查時請特別區分以下三種 Global Routing 設定。此處所指的流量範圍，都是進入 Shadowrocket 處理流程的連線，不代表 Linux 上所有應用程式與所有協定都會自動被接管。Scene 則應依已設定的場景條件確認實際生效情形，請勿只憑名稱推斷目前連線的去向。
Config
建議依目前設定中的規則決定連線去向。DOMAIN-SUFFIX、IP-CIDR、GEOIP 等規則會參與比對，最終去向也取決於規則順序與 FINAL；未符合規則不代表一定會直連。
適用情況：已有確認無誤的分流設定，準備日常連線。
Proxy
將進入處理流程的連線統一交由選取的代理策略處理。可暫時用來區分規則比對問題與代理路徑問題，但仍須確認選取的伺服器與協定參數有效。
適用情況：短時間檢查 Config 中的規則或策略選擇。
Direct
讓進入處理流程的連線直接連線至目標，不經過代理伺服器。適合用來建立本機網路基準，但無法用於確認代理伺服器是否可用。
適用情況：確認本機 DNS、網路出口與目標本身是否正常。
首次測試時一次只改變一個條件：先記錄原有的 Global Routing，再暫時切換模式，針對同一個目標重複測試，完成後還原原設定。On Demand 是依條件觸發連線的設定，不是修復安裝問題的開關；初次排查時可先到 Settings → On Demand 檢查觸發條件，避免自動連線改變測試狀態。
六、常見安裝與啟動問題
下載了 deb，為什麼 Fedora 無法開啟？
先執行 cat /etc/os-release 確認系統。deb 與 rpm 屬於不同的套件管理體系，無法透過更改副檔名互換。請返回本站下載頁選擇相容的 rpm，或確認 AppImage 的執行條件；請勿在系統中混裝另一套套件管理工具來避開格式不符的問題。
AppImage 已執行 chmod，還是顯示無法執行？
先使用 ls -l "$app" 確認檔案擁有者是否有執行權限，再比對 uname -m 確認架構。若出現 Permission denied，請檢查所在分割區是否以 noexec 掛載；若出現 Exec format error，請優先排查架構不符或檔案不完整，請勿繼續增加權限。
視窗能開啟，但 Home 沒有連線項目，是不是沒安裝好？
沒有連線項目不代表安裝失敗。請使用您自己的服務商與訂閱，前往 Home →「+」→ Type → Subscribe 新增並更新，或依您已有的參數手動填寫。本站僅說明如何設定使用者已有的訂閱，不提供連線服務；匯入後仍應確認協定、伺服器連接埠與驗證欄位。
瀏覽器可以使用，但終端機指令沒有走代理，該怎麼辦？
先確認應用程式代理設定、系統接管方式，以及終端機程序的代理環境變數。終端機工具不一定會讀取桌面系統代理；若需指定代理位址，請從目前實際設定取得監聽位址、連接埠與協定，不要猜測預設連接埠。Linux 權限與流量接管問題應與安裝格式問題分開處理。
七、更新、回復與解除安裝前的保留事項
本機安裝 deb 或 rpm 不代表會自動加入更新套件來源。後續更新請回到本站下載頁確認目前提供的安裝檔，再使用相同的套件管理方式處理。若要更換安裝格式，請先確認原有程序已結束，避免桌面選單、舊檔案與新檔案同時存在，導致實際啟動路徑混淆。
- 保留設定：在 Config 中確認目前使用的設定，依介面提供的匯出或備份方式儲存，並記下 Home 中正在使用的連線項目與 Global Routing 設定。
- 記錄自訂項目：記下自行修改的監聽位址、連接埠、DNS 與規則策略。請勿將含有密碼、私鑰或訂閱憑證的備份存放在公開目錄。
- 更新 deb / rpm：下載架構相符的新檔案後，再執行前文對應的安裝指令。請先閱讀套件管理器的交易摘要，確認操作對象與相依套件變更。
- 更新 AppImage：結束舊程序後保留舊檔案，將新檔案放入固定目錄並重新設定執行權限。若曾建立桌面啟動項目，也請確認其目標指向新檔案。
- 解除安裝檢查：deb / rpm 請使用套件管理器依實際套件名稱解除安裝；可從安裝檔中繼資料查詢套件名稱。AppImage 則刪除執行檔與自行建立的啟動項目，即可移除該啟動入口；使用者設定可能仍會保留，請另行確認。
更新完成後，請使用相同的已知目標、連線項目與路由設定進行比對。只有「視窗能開啟」不足以確認網路功能正常；同時檢查訂閱更新、連線建立與實際存取結果，才能區分程式執行問題與設定問題。