Shadowrocket Linux 安裝指南：deb、rpm、AppImage 選擇與下載

先確認發行版、架構與安裝檔格式

deb、rpm、AppImage 是不同的軟體發佈格式，不是三種代理協定。Ubuntu、Debian 及相容的衍生版本通常選擇 deb；Fedora 等使用 dnf 的發行版通常選擇 rpm。AppImage 適合想保留獨立應用程式檔案、不透過系統套件管理工具安裝的情況，但仍受 CPU 架構與系統執行環境限制。

cat /etc/os-release
uname -m

第一個指令會查看系統的 ID、ID_LIKE 等資訊，第二個指令會查看電腦架構。常見的 x86_64 與 aarch64 不能混用；下載頁提供的架構必須符合裝置規格。可下載某種格式，不代表它能在所有發行版與架構上執行。

從下載頁取得適用的 Linux 檔案

前往Shadowrocket 下載頁，在 Linux 區選擇適用於本機的格式，並記下瀏覽器實際儲存的位置。本文不預設檔名；後續指令會要求輸入實際路徑，因此下載檔名即使包含版本或架構後綴也能使用。

1. 確認系統資訊

   開啟終端機，執行上方兩個查詢指令，記下發行版與架構。請勿只憑桌面外觀判斷系統是 Ubuntu 還是 Fedora。

2. 選擇格式

   前往下載頁 → Linux，依系統選擇 deb、rpm 或 AppImage，並確認下載項目標示的架構。

3. 找到檔案

   在瀏覽器的下載記錄中開啟檔案所在目錄，透過檔案屬性確認完整路徑。檔案尚未下載完成前，請勿執行安裝。

4. 執行指令

   在 Bash 終端機使用對應章節的指令。出現路徑提示後，貼上完整路徑，不加引號，也不要使用波浪號縮寫路徑，然後按 Enter。

使用 apt 安裝 deb：處理本機套件與相依項目

在 Debian、Ubuntu 等相容系統上，建議使用 apt 安裝本機 deb。相較於單獨解壓縮，這種方式也會嘗試從系統已設定的軟體來源安裝所需的相依套件。以下輸入內容只會保留在目前的終端機變數中；執行前請確認路徑指向從本站下載的 deb 檔案。

read -r -p '輸入 deb 檔案的完整路徑：' DEB
if [ -f "$DEB" ]; then
  sudo apt install "$DEB"
else
  printf '%s\n' '找不到檔案，請重新確認完整路徑。'
fi

apt 顯示安裝計畫後，請先查看將新增、升級或移除的套件，再決定是否確認。輸入 sudo 密碼時，終端機通常不會顯示任何字元，並非鍵盤故障。若提示找不到相依套件，請先檢查軟體來源、網路與發行版支援狀況，不要從不明來源安裝同名的系統程式庫。

• 若出現架構不符：重新確認 uname -m 與下載項目的架構，不要使用強制忽略架構的選項。
• 若套件管理工具提示鎖定中：請等待系統更新或其他安裝工作完成，不要直接刪除鎖定檔。
• 若提示路徑無效：確認輸入的是以 / 開頭的完整路徑，且檔案已下載完成。

安裝成功後，請在桌面應用程式清單搜尋 Shadowrocket 並啟動。安裝本機 deb 不會自動為系統新增應用程式更新來源；後續更新請回到本站下載頁取得適用檔案，再交由 apt 處理。

使用 dnf 安裝 rpm：以 Fedora 為例

Fedora 使用者可以透過 dnf 安裝本機 rpm，相依套件同樣由系統軟體來源解析。其他使用 rpm 的發行版可能使用不同的套件管理指令與相依套件名稱；副檔名相同，不代表 Fedora 的所有步驟都適用。

read -r -p '輸入 rpm 檔案的完整路徑：' RPM
if [ -f "$RPM" ]; then
  sudo dnf install "$RPM"
else
  printf '%s\n' '找不到檔案，請重新確認完整路徑。'
fi

若發生相依套件衝突，請保留終端機輸出中的套件名稱與錯誤原因，先確認發行版是否相符。不要為了繼續安裝而略過相依套件檢查、關閉安全政策或強制替換系統元件。安裝完成後通常可從應用程式清單啟動；若選單尚未更新，可先重新開啟應用程式清單，再考慮登出桌面工作階段。

• deb 與 rpm 擇一使用：在同一個系統上，優先選擇原生格式，不要轉換格式後重複安裝。
• 更新前請正常結束 Shadowrocket，避免將仍在執行的舊程序誤認為新安裝結果。
• 若要解除安裝，請在系統套件管理介面搜尋 Shadowrocket，依實際安裝記錄操作，不要猜測內部套件名稱。

AppImage：設定執行權限後啟動

AppImage 是獨立的應用程式檔案。請先將檔案移至預計長期存放的位置，再新增執行權限。不要放在瀏覽器的暫存目錄；若檔案位於外接硬碟、共享目錄或禁止執行的掛載點，即使權限設定正確也可能無法執行。

read -r -p '輸入 AppImage 檔案的完整路徑：' APPIMAGE
if [ -f "$APPIMAGE" ]; then
  chmod u+x -- "$APPIMAGE" && "$APPIMAGE"
else
  printf '%s\n' '找不到檔案，請重新確認完整路徑。'
fi

chmod u+x 只會為檔案擁有者新增執行權限，不必將權限改成所有人皆可寫入，也不需要使用 sudo 啟動整個圖形介面應用程式。首次測試建議保留終端機視窗：若按兩下沒有反應，通常可在終端機看到具體錯誤。

• 檔案路徑含空格時，務必保留上述指令中的雙引號；在提示後輸入路徑時則不必額外加上引號。
• 部分 AppImage 執行環境需要 FUSE 相容支援；若錯誤訊息明確提到 FUSE，請依目前發行版的文件安裝對應的相容套件，不要照抄其他發行版的套件名稱。
• 更新 AppImage 時，請先結束應用程式，下載新檔案後重新設定執行權限，再啟動新檔案。

安裝後先區分路由設定與連線資料

成功啟動只代表應用程式可以執行，不代表已具備可用連線。請使用自己已有且了解用途的連線資料或訂閱，在 Home、Config 中確認匯入結果；完整的匯入與更新步驟請參閱使用說明。更新訂閱是重新整理連線資料，不是更新 Linux 應用程式安裝檔。

排查連線狀況前，請先確認 Home → Global Routing。以下比較的是 Shadowrocket 本身的路由模式；這些設定無法取代伺服器位址、連接埠、驗證資訊與協定參數，也不會改變 AppImage 的檔案權限。

例如 DOMAIN-SUFFIX,example.com,DIRECT 表示指定的網域後綴採用 DIRECT；FINAL,DIRECT 則為前面未比對到的請求指定最終策略。這只是規則語法範例，並非要求覆蓋現有設定。安裝排錯時一次只變更一項設定，避免將設定變更與系統權限問題混為一談。

首次啟動遭阻擋：依錯誤原因處理

Linux 沒有適用於所有發行版的通用「放行」按鈕。請先判斷問題是缺少執行權限、掛載點禁止執行、架構不符，或受到桌面與系統安全政策限制。不要將所有啟動失敗都歸因於安全攔截，也不要透過關閉整體防護來繞過錯誤。

上述變數只在原本的終端機中有效，換用其他終端機時需重新輸入路徑。若需進一步排查，請記錄發行版、架構、套件格式、執行的指令與完整錯誤訊息；分享記錄前，請移除訂閱網址、驗證資訊與其他敏感內容。如此即可分別處理「無法啟動」與「啟動後無法連線」兩種問題。