本文適合已備妥 Linux 桌面環境、準備安裝 Shadowrocket（小火箭）的使用者。先確認發行版與處理器架構，再前往本站下載頁選擇 deb、rpm 或 AppImage；接著依相應步驟安裝或執行，最後檢查 Home、Config 與 Global Routing。文中的指令會讀取您實際下載的檔案路徑，不依賴固定檔名，也不會將不同格式的安裝檔混用於同一組指令。
先確認發行版與架構
安裝格式與處理器架構是兩項不同條件。deb、rpm 決定系統使用哪種工具管理軟體；x86_64、aarch64 等架構則決定程式能否在目前的處理器上執行。副檔名正確，不代表架構也符合需求。開啟終端機，先執行以下兩個指令，記下發行版名稱與架構資訊。
cat /etc/os-release
uname -m/etc/os-release 中的 ID 與 ID_LIKE 有助於判斷系統家族；uname -m 通常會回傳 x86_64 或 aarch64 等值。下載頁上的 x64、amd64 通常對應 x86_64，arm64 通常對應 aarch64。請只選擇下載頁實際提供且符合系統的架構；轉換檔案格式無法解決架構不相容問題。
| 系統環境 | 優先選擇 | 執行方式 |
|---|---|---|
| Debian、Ubuntu 及相容系統 | deb | 使用 apt 安裝本機檔案並處理相依套件 |
| Fedora 等使用 dnf 的系統 | rpm | 使用 dnf 安裝本機檔案並處理相依套件 |
| 其他相容的 Linux 桌面環境 | AppImage | 授予執行權限後，以一般使用者身分執行 |
同屬 rpm 系列不代表都使用 dnf；若系統沒有 dnf，不應直接照抄 Fedora 的指令。AppImage 也不代表相容所有發行版，仍會受到處理器架構、系統執行程式庫與桌面環境影響。本文以圖形桌面環境為前提；遠端終端機無法顯示視窗，不代表安裝檔已損壞。
安裝格式與取得方式
前往Shadowrocket 下載頁選擇 Linux 安裝檔，下載後確認副檔名。本文不指定固定檔名；後續指令需輸入實際下載完成的檔案路徑。瀏覽器尚未完成下載時請勿執行，帶有暫存下載副檔名的檔案也不能當作完整安裝檔使用。
iPhone／iPad 版請從 App Store 下載，開發者為 Shadow Launch Technology Limited，價格為 $2.99 一次性付費，系統需求以 App Store 頁面標示為準；Mac（Apple 晶片與 Intel）、Windows、Android 與 Linux 版免費，安裝檔請至本站下載頁取得。Shadowrocket 是閉源商業應用程式，Linux 版免費不會改變其軟體性質。
依系統套件管理方式選擇
使用 deb／rpm
- 系統具備相容的套件管理工具。
- 希望由系統管理軟體套件及相依關係。
- 安裝時可提供管理員權限。
使用 AppImage
- 下載頁提供符合架構的檔案。
- 希望將程式檔案放在個人目錄。
- 能自行檢查執行權限與執行環境。
若有相容的 deb 或 rpm，建議優先使用系統套件管理方式；AppImage 是獨立檔案，不代表不需要任何系統相依套件。
使用 apt 安裝 deb
在 Debian、Ubuntu 等系統上，建議使用 apt 安裝本機 deb。與單獨解開套件相比，apt 會嘗試從目前啟用的套件來源解析相依套件。以下指令請在同一個 Bash 終端機中依序執行；輸入路徑時不要額外加上引號，可使用絕對路徑或相對於目前目錄的路徑。
read -r -p '請輸入已下載 deb 檔案的實際路徑：' pkg
pkg=$(realpath -- "$pkg")
dpkg-deb -f "$pkg" Package Architecture
sudo apt update
sudo apt install "$pkg"dpkg-deb 這一行只會讀取套件名稱與架構，不會執行安裝。請先確認輸出符合預期，再執行後續指令。realpath 會將輸入轉換為絕對路徑，讓 apt 明確將其視為本機檔案；若顯示檔案不存在，請先修正路徑，不要繼續執行安裝指令。
-
確認檔案
在檔案管理程式中找到已下載完成的 deb，並記下完整路徑。若下載資料夾名稱不是英文 Downloads，請使用實際儲存位置。
-
檢查架構
對照
dpkg-deb -f顯示的 Architecture 與系統架構；若不相符，請返回下載頁重新選擇，不要使用強制安裝選項。 -
執行安裝
執行 apt 指令，查看即將安裝、升級或移除的套件清單。若出現大量移除系統元件的提議，請先取消並確認發行版相容性。
-
啟動程式
等待安裝順利完成後，從桌面應用程式選單啟動 Shadowrocket。請勿以 sudo 啟動整個圖形程式來取代首次連線時的授權流程。
使用 dnf 安裝 rpm
在使用 dnf 的系統上安裝本機 rpm，同樣需要指定實際檔案路徑。先讀取套件資訊，再讓 dnf 處理安裝程序。以下指令與上一節相互獨立；即使已關閉終端機，也可重新輸入檔案路徑後使用。
read -r -p '請輸入已下載 rpm 檔案的實際路徑：' pkg
pkg=$(realpath -- "$pkg")
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"rpm -qp 可查詢尚未安裝的本機套件。dnf 會顯示相依套件、下載項目與交易摘要，請確認後再繼續。若找不到相依套件，先檢查網路與系統套件來源是否正常；不要將停用相依性檢查當成一般安裝步驟。
- 架構不相容：返回下載頁，選擇與
uname -m相符的套件。 - 找不到路徑：檢查輸入內容是否包含多餘引號、空格或錯誤的目錄；指令中的
"$pkg"已可妥善處理路徑中的空格。 - 套件衝突：記下衝突套件名稱，先確認是否已安裝同一應用程式的其他套件格式，不要直接使用強制覆寫參數。
- 系統沒有 dnf：查閱目前發行版安裝本機 rpm 的方式，或選擇下載頁提供的相容 AppImage。
安裝 deb 與 rpm 都可能需要連線下載相依套件。下載主要安裝檔不代表已準備好離線安裝；缺少相依套件時，應先處理套件來源的連線問題，而不是反覆下載同一個檔案。
首次執行 AppImage
AppImage 通常以單一檔案保存，下載後建議先移至長期使用的個人目錄。它不是 deb 或 rpm，不能交由 apt、dnf 安裝。首次執行前，請為目前使用者授予執行權限，再直接啟動該檔案。
read -r -p '請輸入 AppImage 檔案的實際路徑：' app
app=$(realpath -- "$app")
chmod u+x -- "$app"
"$app"chmod u+x 只會為檔案擁有者新增執行權限，不需要開放所有人的寫入權限。程式執行時請保留此終端機視窗，以便查看啟動錯誤。一般情況下應以目前的桌面使用者身分執行；不要只為了排除一項錯誤就改用管理員身分啟動。
- Permission denied：先確認檔案屬於目前使用者且已具備執行權限，再檢查所在分割區是否以
noexec掛載。此時可將檔案移至允許執行的個人目錄。 - Exec format error：優先確認架構並確認下載已完成；新增執行權限無法修正架構錯誤。
- FUSE 相關錯誤：部分 AppImage 執行方式需要 FUSE。請依目前發行版的說明安裝相容元件，不要套用其他系統的套件名稱。
- 缺少圖形顯示環境：請在本機桌面工作階段中啟動。僅透過 SSH 登入的終端機不一定能顯示應用程式視窗。
若雙擊後只出現「選擇開啟方式」，可先依照上述終端機指令執行，判斷是執行權限還是檔案關聯問題。AppImage 是否自動加入應用程式選單，取決於桌面整合方式；沒有選單圖示不代表檔案無法執行。移動檔案後，舊的捷徑也可能失效，請更新其目標路徑。
安裝後的連線檢查
視窗能開啟，只代表程式已成功啟動，並不表示代理連線可用。以下步驟假設使用者已有自己的服務商與訂閱：在 Home 新增既有伺服器資訊或訂閱，在 Config 確認要使用的設定，再檢查 Global Routing。請勿混淆安裝格式與網路模式；改用 AppImage 通常無法修正規則中的錯誤。
Config
建議依目前生效設定中的規則，決定已接管請求所使用的策略。使用前請確認 Config 啟用的是預期設定，並檢查末尾 FINAL 的指向。
適用情境：已有正確設定，日常需要依網域或 IP 分流。
Proxy
將已接管的流量統一交由代理策略處理，可用來區分伺服器連線問題與規則問題；這不代表所有程序都會自動被接管。
適用情境：暫時檢查代理路徑是否可用，測試後請恢復原本模式。
Direct
將已接管的流量一律以直連方式處理。瀏覽器在此模式下能瀏覽一般網站，不代表代理伺服器可用。
適用情境：檢查本機基本網路，並與代理路徑進行比較。
例如，Config 中的以下規則表示，example.com 及其子網域使用 PROXY；其他未符合規則的請求則使用 DIRECT。這是規則語法範例，不是伺服器設定，也不會自動建立可用連線。診斷時請先確認實際符合的項目，再核對策略；不要將規則片段直接當成完整設定檔匯入。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT安裝與更新常見問題
apt 顯示找不到檔案，但檔案明明已下載？
先在檔案管理程式中確認檔案位置，再重新執行讀取路徑的指令。請輸入實際檔案路徑，不要輸入下載頁網址；路徑含空格時可直接輸入，但不要自行再加一層引號。確認檔案存在且下載完成後，才能繼續安裝。
AppImage 已新增權限，還是無法開啟？
從終端機執行該檔案並查看錯誤訊息。依序檢查架構、執行權限、掛載選項、FUSE 與執行程式庫；若明確提示缺少系統程式庫，請依目前發行版的套件說明處理，不要停用系統安全機制碰運氣。
deb、rpm 會隨系統自動更新嗎？
安裝本機套件不代表已新增套件來源。若尚未確認對應的更新來源，請返回本站下載頁取得相容套件，再使用相同的套件管理方式安裝。AppImage 則需先結束程式，再以新下載的相容檔案取代，並重新確認執行權限。
重新安裝前需要先刪除設定嗎？
請勿將刪除設定當成第一個排查步驟。先備份現有設定與訂閱資訊，再確認問題發生於啟動、匯入或連線階段。系統套件與使用者設定通常屬於不同層級的資料；解除安裝套件不應被視為可靠的設定備份或清除方式。
安裝完成後，建議記下發行版、架構、使用的套件格式與具體錯誤訊息。需要進一步排查時，這些資訊比「Linux 版無法開啟」更有幫助。分享記錄前，請移除訂閱 token、密碼及私人伺服器資訊；每次只調整一項設定，才能判斷是哪個步驟改變了結果。