Shadowrocket Linux 版安裝指南：deb、rpm、AppImage 如何選擇

先確認發行版、架構與桌面環境

安裝格式取決於發行版使用的套件管理系統，而非桌面佈景主題。同樣使用 GNOME 的 Ubuntu 與 Fedora，通常分別選擇 deb 與 rpm。其他發行版可考慮 AppImage，但仍受 CPU 架構、系統執行程式庫與桌面環境限制，並非所有 Linux 系統都能直接執行。

cat /etc/os-release
uname -m

第一個指令會顯示 ID、ID_LIKE 與 PRETTY_NAME，第二個則用來查看電腦架構。常見的 x86_64 對應 x64，aarch64 對應 ARM64；下載時請以頁面實際提供的架構為準。變更 deb、rpm、AppImage 副檔名並不會改變檔案格式，也無法解決架構不符的問題。

• Debian / Ubuntu：選擇 deb，使用 apt 安裝本機檔案並處理軟體來源中可取得的相依套件。
• Fedora：選擇 rpm，使用 dnf 安裝；openSUSE 同樣採用 rpm 套件格式，但使用 zypper。
• 其他桌面發行版：先確認是否有適用的 AppImage，再核對執行條件。
• 純命令列伺服器：本文說明的是桌面應用程式安裝，不應將圖形程式視為背景服務；沒有圖形工作階段時，不要只因視窗未顯示就判定安裝損壞。

下載後依四個步驟完成準備

以下指令中的檔名只是方便輸入的本機名稱，並非本站安裝檔的固定檔名。請先在檔案管理器中將下載完成的檔案重新命名為對應名稱，再執行指令；若保留原檔名，也可以將檔案拖曳至終端機取得完整路徑。請勿將瀏覽器尚未下載完成的暫存檔當成安裝檔。

1. 確認系統資訊

   執行 cat /etc/os-release 和 uname -m，記下發行版與架構；Debian 系統也可使用 dpkg --print-architecture 查看套件管理器使用的架構名稱。

2. 取得檔案

   開啟Linux 下載區，依頁面實際提供的格式與架構下載，請勿透過修改副檔名轉換安裝檔。

3. 整理檔案路徑

   將檔案放入 ~/Downloads，並依格式重新命名為 Shadowrocket.deb、Shadowrocket.rpm 或 Shadowrocket.AppImage。若系統的下載資料夾名稱不同，請使用實際路徑。

4. 安裝並啟動

   只執行下方與所選格式相符的一組指令。deb、rpm 安裝後，從應用程式選單啟動；AppImage 則直接執行檔案。初次排除問題時，請保留終端機輸出。

deb 與 rpm：使用系統套件管理器安裝

本機套件路徑前的 ./ 有其作用：它會告訴套件管理器讀取目前目錄中的檔案，而非只依套件名稱查詢軟體來源。安裝時使用 sudo 提升權限；日常啟動圖形程式則使用一般使用者帳號，請勿以 root 身分執行整個桌面程式。

Debian / Ubuntu 操作方式

cd ~/Downloads
dpkg-deb -f ./Shadowrocket.deb Package Architecture Depends
sudo apt install ./Shadowrocket.deb

dpkg-deb -f 用於讀取套件內的中繼資料，不會安裝程式。若 apt 提示軟體來源索引過期，可先執行 sudo apt update 再重試；若提示架構錯誤，請重新選擇正確架構，不要加入強制安裝選項。若遇到無法滿足的相依套件，請記下具體套件名稱與系統版本，不要直接移除系統核心程式庫。

Fedora / openSUSE 操作方式

cd ~/Downloads
rpm -qp --queryformat '%{NAME} %{ARCH}\n' ./Shadowrocket.rpm

# Fedora
sudo dnf install ./Shadowrocket.rpm

# openSUSE：請使用這一行，不要執行上方的 dnf 指令
sudo zypper install ./Shadowrocket.rpm

rpm 是封裝格式，不代表所有採用 rpm 的發行版都具有相同的執行環境。若套件管理器明確指出相依套件無法使用，請先核對下載頁上的適用條件；不要忽略相依套件，將錯誤留到啟動時才處理。安裝完成只表示檔案與登錄資訊已寫入系統，不代表設定與網路連線已完成驗證。

AppImage：加入執行權限後從終端機啟動

AppImage 通常不會像 deb、rpm 一樣登錄至系統套件資料庫，而是以單一檔案形式保存；首次使用時須加入執行權限。移動或刪除檔案會影響既有捷徑，建議將檔案放在固定資料夾，不要長期留在可能自動清除的下載資料夾。

mkdir -p "$HOME/Applications"
mv "$HOME/Downloads/Shadowrocket.AppImage" "$HOME/Applications/"
cd "$HOME/Applications"
chmod u+x ./Shadowrocket.AppImage
./Shadowrocket.AppImage

如果 chmod 已成功，但執行時仍顯示權限不足，可使用 findmnt -T ./Shadowrocket.AppImage 查看所在檔案系統的掛載資訊。可卸除式磁碟或受限制的資料夾可能採用 noexec；建議先將檔案移至允許執行的使用者資料夾，無須為單一應用程式放寬整個磁碟的限制。若出現 FUSE 相關錯誤，請勿照搬其他發行版的程式庫名稱，也不要先進行大範圍系統升級。

首次啟動：先匯入設定，再檢查 Global Routing

看到視窗後，安裝階段大致完成。接著依照使用者已有的設定操作：在 Home 管理伺服器與訂閱，在 Config 管理規則設定檔，在 Settings 調整客戶端設定。安裝檔格式不會取代這些設定，也不會自動提供可連線的服務。

1. 在 Home 點選「+」，將 Type 設為 Subscribe，填入自己已有的訂閱網址並儲存；匯入後重新整理訂閱，確認清單中出現預期項目。訂閱網址通常包含存取憑證，請勿放入公開截圖。
2. 在 Home 選取既有項目，執行 Connectivity Test。若測試失敗，先檢查位址、連接埠、驗證資料與目前網路；不能只憑安裝成功就判定遠端服務可連線。
3. 在 Config 匯入並選用自己的規則設定檔，再檢查 Global Routing。首次驗證連線時先手動操作；若需要自動連線，可另外在 Settings → On Demand 中設定。這項設定無法取代協定參數與路由規則。

如果目前介面提供 Scene，請檢查所選場景的條件與策略，不要將 Scene 視為 Config 的同義詞。變更模式後請重新發出請求，避免以瀏覽器仍沿用的舊連線判斷新設定。若要檢查規則語法或 DNS，請接著參閱疑難排解手冊。

安裝、升級與啟動常見問題