Shadowrocket Linux 版安裝教學：deb、rpm、AppImage 怎麼選

本文速覽

Debian、Ubuntu 及相容的衍生發行版優先選 deb；Fedora 等使用 dnf 的環境選 rpm；若希望以單一檔案保存並啟動應用程式，再考慮 AppImage。本篇適合已備妥 Linux 桌面環境的使用者：先確認發行版與處理器架構，再從本站下載頁取得適用的安裝檔，最後完成安裝、首次啟動與連線檢查。安裝 Shadowrocket（小火箭）和匯入既有訂閱是兩個獨立步驟。

一、依發行版選擇 deb、rpm 或 AppImage

先確認系統使用的套件管理方式，不要只看檔案大小來選擇。deb 與 rpm 會由系統套件管理器登錄；AppImage 通常以單一應用程式檔案執行，並不等於將 deb 或 rpm 套件安裝到系統中。無論使用哪種格式，都仍須符合處理器架構、系統函式庫與圖形環境的相容條件。

目前環境	建議格式	處理方式
Debian、Ubuntu 及相容的衍生發行版	deb	使用 apt 安裝本機檔案，並處理軟體來源中可取得的相依套件。
Fedora，以及使用 dnf 的相容 RPM 環境	rpm	使用 dnf 安裝；仍須確認系統可提供套件所需的函式庫。
希望以單一檔案保存應用程式的桌面環境	AppImage	加上執行權限後啟動；必要時檢查 FUSE 與執行階段函式庫。
其他發行版或無桌面的伺服器	先確認相容條件	不要轉換套件格式來推斷相容性，也不要假設一定有命令列執行模式。

在終端機執行以下兩個唯讀指令。第一個會顯示發行版資訊，請特別留意 ID、ID_LIKE 與 VERSION_ID；第二個會顯示機器架構。若輸出為 x86_64 或 aarch64，應分別核對下載頁上的對應架構說明；副檔名相同不代表可以混用。

cat /etc/os-release
uname -m

本文不列出固定的套件檔名，也不假設每種架構都有所有格式可選。請以Linux 下載區目前列出的安裝檔與需求為準。選好後請保留下載檔案的原始名稱，後續指令直接使用檔案的實際路徑。

二、下載前檢查與終端機準備

安裝用戶端不必先匯入訂閱。建議先確認桌面工作階段正常，且系統網路可連線至已設定的軟體來源，再下載安裝檔。使用 apt 或 dnf 安裝本機檔案時，仍可能需要從發行版軟體來源取得相依套件，因此「檔案已下載完成」不代表安裝過程能完全離線進行。

確認環境

執行 cat /etc/os-release 與 uname -m，記下發行版、系統版本與架構，並逐項比對下載頁的說明。
取得安裝檔

開啟Shadowrocket 下載頁，前往 Linux 區，選擇適用於目前系統的 deb、rpm 或 AppImage 檔案；本文不提供安裝檔直連。
確認檔案路徑

在檔案管理員中找到下載的檔案，記下完整路徑。若下載資料夾名稱經過在地化，請勿直接假設路徑是 ~/Downloads。
開啟終端機

以下互動指令以 Bash 撰寫。若目前使用其他 shell，可先輸入 bash；輸入檔案路徑時可按 Tab 鍵自動補完，避免手動輸入時漏掉空格或副檔名。

三、安裝 deb：使用 apt 處理本機檔案

Debian、Ubuntu 環境建議使用 apt install 安裝本機 deb 檔。相較於只交由底層安裝工具處理，apt 可以依照目前設定的軟體來源嘗試補齊相依套件。以下先讀取檔案的實際路徑，再轉換為絕對路徑，避免 apt 將檔名誤認為軟體來源中的套件名稱。

read -r -e -p '輸入已下載 deb 檔案的路徑：' pkg
pkg="$(realpath -- "$pkg")"
if [ -f "$pkg" ] && [[ "$pkg" == *.deb ]]; then
  sudo apt install "$pkg"
else
  printf '%s\n' '找不到 deb 檔案，請重新確認路徑。'
fi

在提示處輸入檔案路徑本身，不要連同 shell 指令外層的引號一起輸入；指令中的變數已加上雙引號，即使路徑含有空格也能傳給 apt。執行前請檢視 apt 列出的相依套件與磁碟變更；若計畫意外移除大量系統元件，請先取消，不要直接確認。

提示無法滿足相依條件：確認發行版版本與套件需求，再檢查系統軟體來源是否可用；不要任意混用其他發行版的相依套件。
提示找不到本機檔案：重新確認路徑及下載是否完成。輸入路徑時可使用 Tab 鍵自動補完，請勿將瀏覽器中的下載網址當成本機路徑。
提示架構不符：重新執行 uname -m，再回到下載頁確認架構。強制安裝無法改變二進位程式的目標架構。

安裝完成後，從桌面應用程式清單中找到 Shadowrocket 並啟動。套件管理器完成安裝，與用戶端能否建立連線是不同層面的事；相依套件安裝完成後，應先確認視窗能否正常開啟，再處理訂閱與網路設定。

四、安裝 rpm：使用 dnf，先檢視交易內容

Fedora 等使用 dnf 的系統可依照以下方式安裝本機 rpm。並非所有使用 rpm 格式的發行版都採用 dnf；若系統使用其他套件管理器，請依該發行版安裝本機套件的方式操作，不要為了照抄指令而額外更換系統套件管理工具。

read -r -e -p '輸入已下載 rpm 檔案的路徑：' pkg
pkg="$(realpath -- "$pkg")"
if [ -f "$pkg" ] && [[ "$pkg" == *.rpm ]]; then
  sudo dnf install "$pkg"
else
  printf '%s\n' '找不到 rpm 檔案，請重新確認路徑。'
fi

dnf 會顯示此次交易需要安裝的套件、相依項目及相關提示。確認來源與變更內容符合預期後再繼續；若遇到相依衝突，請記下完整錯誤訊息與系統版本，不要立刻加入強制覆寫或略過檢查的參數。

deb 安裝檢查

檔案格式: .deb
範例工具: apt install
檔案定位: 讀取實際路徑並使用絕對路徑
相依套件來源: 目前系統已設定的軟體來源

安裝成功後會由系統套件管理器登錄，但不代表會自動加入線上更新來源。

rpm 安裝檢查

檔案格式: .rpm
範例工具: dnf install
適用條件: 目前的發行版本身使用 dnf
交易檢查: 確認新增的相依套件與衝突資訊

同為 rpm 格式，不代表在不同發行版或不同系統版本間必然相容。

五、為 AppImage 加上執行權限並首次啟動

AppImage 不使用前兩節的套件管理器安裝流程。請先將檔案放在目前使用者可長期保存的位置，再加上執行權限。不要一直將檔案放在瀏覽器的暫存目錄，也不要在移動檔案後繼續使用指向舊位置的啟動捷徑。

read -r -e -p '輸入已下載 AppImage 檔案的路徑：' app
app="$(realpath -- "$app")"
if [ -f "$app" ] && [[ "$app" == *.AppImage ]]; then
  chmod u+x -- "$app" && "$app"
else
  printf '%s\n' '找不到 AppImage 檔案，請重新確認路徑。'
fi

chmod u+x 只會為檔案擁有者加上執行權限，不必將權限改成所有人皆可寫入。若檔案屬於其他使用者，請先確認檔案來源與存放位置。此指令會在終端機中直接啟動應用程式；若沒有出現視窗，可保留錯誤輸出，以便判斷是權限、執行階段函式庫或圖形工作階段問題。

套件管理器安裝與單一檔案執行的維護方式

deb / rpm

安裝狀態與相依套件由系統套件管理器記錄。
更新時，從本站下載頁取得適用的新套件，再交由相同的套件管理器處理。
解除安裝時，先在系統軟體管理工具中確認實際套件名稱，再依正常流程移除。

AppImage

自行管理應用程式檔案的存放位置與執行權限。
替換檔案前，先結束正在執行的應用程式，並備份需要保留的設定。
刪除應用程式檔案不等於刪除使用者設定；捷徑也可能需要另外清除。

依維護方式選擇格式，不要將 AppImage 視為適用所有發行版的通用保證。

六、安裝後匯入既有設定並檢查連線

視窗正常開啟後，再匯入使用者已有的服務商設定。本站僅說明用戶端的安裝與使用。安裝用戶端不會自動產生可用線路，也不會變更既有服務商的帳戶狀態、流量額度或裝置限制。

先匯入設定：依目前版本提供的匯入入口，新增既有訂閱或單筆設定。若介面使用 Home → + → Type → Subscribe，請填入自己的完整訂閱連結，儲存後再更新；各平台版面可能不同，請以實際介面為準。
檢查清單：確認更新後出現預期項目，再選擇要使用的伺服器。若清單為空，請優先確認連結是否完整及服務商端狀態；不要以重新安裝軟體取代訂閱問題排查。
確認路由：若目前介面提供 Global Routing，請留意 Direct 代表直連，而 Proxy 與依規則運作的 Config 用途不同；需要規則分流時，請先確認已選取正確的 Config。
分別進行測試：先在用戶端停止連線時確認系統網路正常，再啟用連線並測試目標網站。若介面提供 Connectivity Test，可用來輔助檢查所選伺服器，但測試結果不代表所有應用程式流量都已經透過代理。

如果用戶端已啟動，但瀏覽器的連線情況沒有變化，請進一步確認目前啟用的是系統代理，還是其他流量接管方式，以及目標應用程式是否遵循該方式。不要假設安裝完成後就會接管所有程序，也不要照搬其他裝置上的授權步驟。遇到系統權限提示時，請先閱讀要求的權限範圍。

七、安裝失敗與啟動異常常見問題

AppImage 已加上權限，為什麼仍顯示 Permission denied？

先使用 ls -l 搭配實際檔案路徑查看執行權限，再確認檔案所在分割區是否以 noexec 掛載。若執行權限正確但分割區禁止執行，可將檔案移至允許執行的使用者目錄後再試；不要直接修改整個系統的掛載設定。

按兩下 AppImage 沒有反應，終端機顯示 FUSE 錯誤怎麼辦？

保留終端機中的完整錯誤訊息，並依目前發行版的套件說明安裝相容的 FUSE 執行階段函式庫。不同系統的套件名稱可能不同；不要直接替換既有的 FUSE 元件。若仍不相容，可回到下載頁選擇適用於該系統的 deb 或 rpm。

出現 Exec format error，是權限不足嗎？

通常應先檢查目標架構與檔案類型，而不是反覆提高權限。執行 uname -m 並確認下載項目；若檔案尚未完整下載，也應重新下載。chmod 只能變更執行權限，無法將一種架構的程式轉換為另一種架構。

apt 或 dnf 顯示安裝成功，應用程式清單卻找不到？

先重新開啟桌面應用程式清單，必要時登出再登入桌面工作階段。接著在系統軟體管理工具中確認軟體確實已安裝；若啟動後立即結束，請記錄啟動錯誤，不要猜測可執行檔名稱。透過 SSH 登入的純終端機工作階段，也不等於可使用本機圖形桌面。

更新應用程式前需要先刪除舊設定嗎？

請勿將刪除設定當作一般更新步驟。先結束用戶端並備份既有設定，再從下載頁取得適用的套件進行更新。若新舊版本之間有明確的移轉說明，請依照說明操作；重新安裝應用程式也不一定會清除使用者目錄中保留的設定。

若仍無法找出原因，請記錄發行版資訊、架構、安裝格式、執行的指令及錯誤輸出中的關鍵行。若需向服務商確認訂閱狀態，請勿公開完整訂閱連結、帳戶密碼或存取權杖。更多連線問題可依照故障排查逐項檢查。