Shadowrocket Linux 版安裝指南：deb、rpm、AppImage 怎麼選

先確認發行版、架構與取得方式

安裝套件格式決定軟體如何交由系統管理，不會影響節點協定或連線速度。Debian、Ubuntu 及相容發行版通常選 deb；Fedora 通常選 rpm；沒有相符的原生套件時，再確認 AppImage 是否適用目前環境。不能只憑副檔名判斷相容性：即使都是 rpm，不同發行版也可能需要不同相依套件。

先在終端機執行以下指令。第一個指令會查看發行版的 ID、ID_LIKE 等資訊，第二個則查看機器架構。下載頁提供的架構必須符合本機；常見的 x86_64 與 aarch64 無法直接互換。若下載頁沒有列出相符架構，請勿強行安裝其他架構的套件。

cat /etc/os-release
uname -m

• Debian／Ubuntu：優先從下載頁選擇符合本機的 deb，交由 apt 安裝並處理相依套件。
• Fedora：優先選擇符合本機的 rpm，交由 dnf 安裝；其他 RPM 系發行版須依本機套件管理工具與相容性需求處理。
• 其他桌面發行版：確認 AppImage 的架構與執行條件；AppImage 並非在所有 Linux 環境中都能直接使用。

deb：使用 apt 安裝本機檔案

從下載頁取得 deb 後，開啟 Bash 終端機並執行以下兩行指令。出現提示時，貼上已下載檔案的完整絕對路徑，再按 Enter；輸入內容本身不要加上引號。指令中的雙引號會保留路徑內的空格，避免檔名被拆成多個參數。

read -r -p '請貼上 deb 檔案的完整絕對路徑：' pkg
sudo apt install "$pkg"

請使用實際檔案路徑，例如檔案管理員顯示的位置，而不是只輸入檔名。apt 可以安裝本機 deb，並嘗試從已設定的軟體來源解析相依套件。若只使用 dpkg -i，遇到相依套件缺漏時，套件可能會停留在尚未完成設定的狀態；首次安裝直接使用 apt，更容易查看完整處理結果。

1. 先查看 apt 列出的待安裝、升級或移除項目，確認沒有異常的大量移除，再確認執行。
2. 安裝完成後，在桌面應用程式選單搜尋 Shadowrocket，並以一般使用者身分開啟。
3. 若系統提示相依套件無法滿足，請記下完整錯誤訊息與發行版資訊，不要強制忽略相依套件來繞過問題。

終端機顯示下載進度不代表已成功安裝。請以 apt 最終執行結果為準；若最後仍有錯誤，先處理軟體來源、網路或相依套件問題，再嘗試啟動。

rpm：在 Fedora 使用 dnf

Fedora 使用者下載符合架構的 rpm 後，可在 Bash 中使用相同的路徑輸入方式。dnf 會將本機套件及系統軟體來源中的相依套件一併納入安裝程序；不建議為了省略相依套件檢查而改用強制安裝參數。

read -r -p '請貼上 rpm 檔案的完整絕對路徑：' pkg
sudo dnf install "$pkg"

本機 rpm 不代表整個過程完全離線：若缺少相依套件，仍可能需要連線至已啟用的軟體來源。若下載逾時，先確認系統軟體來源可正常使用；若架構不符，請重新選擇檔案，不要反覆執行安裝指令。

• 找不到檔案：確認路徑完整，輸入時不要連同終端機提示符或多餘的引號一起貼上。
• 相依套件無法滿足：確認套件適用的發行版環境，不要任意安裝其他發行版的基礎函式庫。
• 執行遭安全政策封鎖：保留詳細錯誤或安全事件紀錄，依發行版的安全政策排查；不要把停用整套安全機制當成一般處理步驟。

AppImage：加上執行權限後啟動

AppImage 通常不會透過 apt 或 dnf 登錄為已安裝軟體。請將檔案放在自己可管理的固定目錄，再授予目前使用者執行權限；若移動檔案後，桌面捷徑仍指向舊路徑，也需要一併調整。以下指令不會變更整個目錄的權限。

read -r -p '請貼上 AppImage 檔案的完整絕對路徑：' app
chmod u+x "$app"
"$app"

最後一行會在目前終端機中執行檔案，若啟動失敗，可直接查看錯誤輸出。請勿使用 sudo 啟動整個圖形應用程式來測試權限；檔案執行權限、檔案系統掛載選項，以及連線所需的系統授權，是不同的問題。

若終端機顯示 FUSE 相關錯誤，請依目前發行版文件安裝相符的執行支援，或改用相容的原生套件。若檔案位於以 noexec 掛載的儲存媒體，即使已執行 chmod，也可能無法啟動；可將檔案移至允許執行的使用者目錄後再試。

首次啟動：匯入現有訂閱並檢查路由

看到應用程式視窗，只能表示圖形程式已啟動，無法證明訂閱可用或系統流量已接入。安裝階段先處理檔案與相依套件；進入應用程式後，再分別檢查訂閱、選取的節點、Global Routing 與系統授權。以下會使用 Home、Config、Settings 等介面名稱來定位功能；若不同平台的版面有所差異，請以目前介面實際提供的選項為準。

1. 開啟應用程式

   從應用程式選單或 AppImage 檔案啟動 Shadowrocket。先確認視窗正常顯示；若系統要求網路相關授權，請核對應用程式名稱與授權內容後再處理。

2. 新增訂閱

   前往 Home → + → Type → Subscribe，貼上自己已有的訂閱連結並儲存。連結含有存取憑證，請勿將完整連結貼在截圖或問題回報中。

3. 更新清單

   在 Home 對該訂閱執行更新，確認是否出現節點。範例 https://example.com/sub?token=xxxx 僅供說明格式，並非可用的訂閱連結。

4. 選擇策略

   選擇一個現有節點；使用規則分流前，先在 Config 確認目前設定，再將 Global Routing 設為 Config。測試時記錄所選節點與路由模式。

5. 測試連線

   啟用連線後瀏覽目標頁面，並查看可用的連線記錄。確認請求是否進入用戶端及命中的策略；不能只憑開關已開啟就判定成功。

訂閱中的位址、連接埠、密碼與 TLS 參數應以服務商提供的資訊為準，不要為了測試而任意改成 443。Settings → On Demand 是依條件連線的設定，不是修復安裝相依套件的入口；只有目前平台提供此功能時才依需求設定。首次排查時先手動連線，避免自動連線條件干擾結果。

安裝後如何選擇 Global Routing 模式

安裝套件格式不會替使用者選擇分流策略。日常使用時應先確認設定內容，再決定路由模式。以下比較的是 Shadowrocket 本身的設定；這些模式只會作用於已由用戶端接管的請求，不能據此推斷 Linux 上所有程序的流量都已進入代理。

例如，只讓範例網域透過代理，其餘請求直接連線，可在設定的 Rule 區段使用以下片段。這只是規則語法範例，不含節點；套用前應先備份目前設定，並確認 PROXY 所引用的代理策略可用。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

DOMAIN-SUFFIX 會比對指定網域及其子網域，規則會由上而下檢查；FINAL 則處理前面未比對到的請求。因此，FINAL 應放在規則末尾。若 Config 下的結果與 Proxy 不同，應查看命中的規則，而不是重新安裝軟體。若要進一步確認模式與欄位，請參閱代理模式和設定欄位。

常見問題：無法開啟、更新與解除安裝

解除安裝原生套件通常使用 apt remove 或 dnf remove，但應先查詢並確認套件名稱；AppImage 則在結束程序後刪除對應檔案及自行建立的捷徑。以上操作不保證會刪除使用者目錄中的設定。更換安裝格式前，請先保存必要設定，並避免同時啟動兩個執行個體，以免混淆目前的連線與設定來源。