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

先確認 Linux 發行版與架構

在 Linux 安裝 Shadowrocket（小火箭），不能只看副檔名。deb、rpm 是不同套件管理系統使用的格式，AppImage 則是可執行的應用程式檔案；三者都必須符合目前的 CPU 架構與執行環境。先在終端機執行以下唯讀指令，不會變更系統設定。

cat /etc/os-release
uname -m

/etc/os-release 中的 ID 與 ID_LIKE 可用來辨識 Linux 發行版及其家族。uname -m 輸出 x86_64，代表常見的 64 位元 Intel / AMD 架構；輸出 aarch64，通常代表 ARM64。安裝套件必須同時符合「格式正確」與「架構相符」；AppImage 也不能直接跨 CPU 架構執行。

「使用 rpm」不代表「所有 rpm 發行版都能直接安裝同一個檔案」。例如，系統使用的套件管理器不一定是 dnf，基礎程式庫版本也可能不同。遇到相依套件未滿足時，應查看具體錯誤訊息；不要只把副檔名改成 deb，或強行忽略相依性。

取得安裝檔並確認資訊

從本站取得應用程式頁面進入 Linux 區域，依目前提供的格式與架構選擇檔案。下載頁會將安裝檔導向本站的 /dl/shadowrocket/ 路徑。請勿照著範例拼湊檔名，也不要因瀏覽器下載清單中有多個舊檔案，就隨意挑選其中一個。

1. 確認系統資訊

   執行 cat /etc/os-release 和 uname -m，記下發行版家族與 CPU 架構。

2. 選擇格式

   在取得應用程式頁面選擇 Linux 版 deb、rpm 或 AppImage；若下載頁未列出你的架構，請勿用其他架構的檔案替代。

3. 記下檔案位置

   在檔案管理員確認下載完成，並記下完整路徑。以下指令會透過互動輸入讀取實際路徑，不依賴固定的安裝檔名稱。

4. 查看套件資訊

   deb 使用 dpkg-deb -f、rpm 使用 rpm -qpi 查看資訊；AppImage 可先用 file 辨識檔案類型與架構。

使用 apt 安裝 deb

在 Ubuntu、Debian 上，建議使用 apt 安裝本機 deb。相較於單獨解開套件，apt 會一併檢查相依套件，並嘗試從目前已設定的系統軟體來源取得所需元件。若系統軟體來源無法使用，客戶端安裝也可能卡在下載相依套件的階段。

read -r -p '輸入 deb 檔案完整路徑：' pkg
dpkg-deb -f "$pkg" Package Version Architecture
dpkg --print-architecture
sudo apt install "$pkg"

前兩項架構資訊應相符，例如系統架構為 amd64 時，應選擇對應的 x86-64 安裝檔。確認 apt 顯示的安裝計畫後再繼續。輸入 sudo 密碼時，終端機通常不會顯示任何字元，這是正常情況，不代表鍵盤失效。

• 出現「找不到檔案」：確認輸入的是實際下載檔案的完整路徑，而不是下載資料夾或瀏覽器中的網頁網址。
• 出現「無法滿足相依套件」：保留完整的相依套件名稱與版本限制，先確認系統發行版是否符合該套件的需求。
• 出現軟體來源索引過期：可先執行 sudo apt update，成功後再試一次安裝；這只會更新索引，不代表升級所有系統軟體。
• 系統先前有未完成的套件操作：先閱讀 apt 提示並處理套件管理狀態，不要反覆啟動多個安裝程序。

安裝完成後，從桌面應用程式選單開啟 Shadowrocket。不要為了排除一般啟動問題而使用 sudo 執行整個圖形介面客戶端；若需要系統網路權限，請依實際顯示的授權流程操作。

使用 dnf 安裝 rpm

在 Fedora 等使用 dnf 的系統上，使用 dnf 安裝下載到本機的 rpm。此方式會檢查相依關係並顯示交易計畫。以下查詢只會讀取套件資訊；真正變更系統的是最後一條安裝指令。

read -r -p '輸入 rpm 檔案完整路徑：' pkg
rpm -qpi "$pkg"
rpm --eval '%{_arch}'
sudo dnf install "$pkg"

確認 rpm 資訊中的 Architecture 與本機架構相符。如果輸出顯示相依性衝突或基礎程式庫版本不足，先確認是否選錯發行版適用範圍；不要使用略過相依性檢查的參數，強行將檔案寫入系統。

AppImage 先設定執行權限

AppImage 不必像 deb、rpm 一樣先登錄到系統套件資料庫，但「免安裝」不代表「沒有執行條件」。檔案必須有執行權限，存放位置也必須允許執行；執行環境可能還需要 FUSE 支援。建議先將檔案存放在自己的本機資料夾，再從終端機執行並查看錯誤訊息。

read -r -p '輸入 AppImage 檔案完整路徑：' app
file "$app"
chmod u+x "$app"
"$app"

chmod u+x 只會為檔案擁有者新增執行權限，不必將檔案權限擴大為所有人皆可寫入。最後一行會直接執行使用者輸入的檔案。若終端機顯示 Exec format error，應優先檢查架構與檔案類型；反覆新增執行權限無法解決架構不符的問題。

• Permission denied：使用 ls -l "$app" 檢查擁有者與執行權限；若已有執行權限，再檢查檔案所在分割區是否使用 noexec 掛載選項。
• 缺少 libfuse.so.2：表示目前的 AppImage 執行環境需要 FUSE 2 相容程式庫。不同發行版的套件名稱可能是 libfuse2 或 libfuse2t64，請先查詢本機軟體來源，再安裝相應程式庫。
• 雙擊後只開啟檔案選擇對話框：先設定執行權限，再從終端機執行一次；檔案管理員的雙擊行為無法取代錯誤記錄。
• 提示 GLIBC 版本不足：這是基礎執行程式庫的相容性問題，請勿手動覆蓋系統 libc；請改用符合執行需求的系統環境。

首次啟動後的檢查

視窗能開啟，只代表程式已成功啟動，不代表已有可用連線。以下操作假設使用者已擁有自己的服務商與訂閱。本站不提供、不銷售、不推薦節點或訂閱；安裝檔本身不會產生服務憑證。

1. 進入 Home，使用新增入口；訂閱類型選擇 Subscribe，貼上自己已有的訂閱網址並儲存。請勿將訂閱網址填入單一伺服器的位址欄位。
2. 在 Home 更新該訂閱，確認是否出現預期的設定項目。若更新結果為空，先確認訂閱期限、回傳內容與連線狀態，不要立刻重新安裝應用程式。
3. 需要規則分流時，進入 Config，確認已匯入並啟用相應設定，再將 Global Routing 設為 Config。
4. 選擇已有的可用項目並開啟連線，依實際提示完成必要的網路授權，再測試已知可連線的網站。

排查時，先區分「訂閱更新失敗」與「開啟連線後無法瀏覽」。前者發生在取得設定的階段；後者還與服務狀態、DNS 及路由規則有關。不要同時更換安裝檔並修改多項設定，否則很難確認是哪個步驟改變了結果。

初次測試先使用手動連線即可。若先前設定過自動連線，再檢查 Settings → On Demand 的目前狀態，避免測試期間受到既有條件影響而改變連線狀態；各平台請以實際提供的選項為準。

如何判斷常見錯誤

記錄錯誤時，保留指令、完整錯誤訊息與系統架構即可。請勿在公開記錄中留下訂閱 URL、存取權杖或伺服器密碼。以下依「安裝前、啟動時、連線後」區分問題，避免將相依套件問題誤認為訂閱問題。