Shadowrocket Linux 安裝指南：deb、rpm、AppImage 與 apt/dnf 指令

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

請勿只看副檔名就開始安裝。發行版決定使用哪種套件管理工具，處理器架構則決定檔案能否在目前裝置上執行。先在終端機執行以下兩個指令，記下發行版的 ID、ID_LIKE 與架構資訊，再前往下載指南的 Linux 區域，選擇實際提供的版本。

cat /etc/os-release
uname -m

x86_64 通常對應下載頁上的 x64 或 amd64 標示；aarch64 通常對應 ARM64。這些是架構名稱的不同寫法，不代表可以混用。若下載頁沒有符合您架構的版本，請勿強行安裝其他架構的套件，也不要只憑電腦品牌推測處理器類型。

其他使用 rpm 的發行版未必採用 dnf，請使用該系統原生的套件管理方式。AppImage 也不保證能在所有 Linux 系統上執行，仍須符合桌面工作階段、系統程式庫與執行環境的實際需求。本文指令適用於桌面安裝，不代表純命令列伺服器已具備圖形執行環境。

二、從下載到啟動：完成以下五個步驟

Linux 安裝包請從本站下載頁取得，本文不提供固定檔案直連。為避免將下載檔名誤認為固定名稱，以下統一使用自行重新命名的本機檔名；這些名稱僅供指令示範，不代表下載包的原始檔名。

1. 辨識系統

   執行 cat /etc/os-release 和 uname -m，確認發行版與處理器架構。請勿以副檔名代替架構確認。

2. 選擇安裝包

   前往下載指南，在 Linux 區域選擇適用於目前系統的 deb、rpm 或 AppImage。只需下載這次要使用的格式。

3. 整理本機檔案

   在檔案管理員中，將所選檔案分別重新命名為 shadowrocket-local.deb、shadowrocket-local.rpm 或 Shadowrocket-local.AppImage，並保留對應的副檔名。

4. 開啟終端機

   在檔案所在資料夾使用桌面環境提供的終端機入口，執行 pwd 和 ls -l 確認路徑。終端機的初始目錄不一定是瀏覽器的下載資料夾。

5. 安裝並啟動

   依下文選擇對應指令安裝其中一種格式。deb、rpm 安裝完成後，請在應用程式選單中查看；AppImage 則可在目前目錄直接執行。首次啟動時先確認視窗能正常開啟，再處理連線設定。

三、deb 與 rpm：使用套件管理工具安裝本機檔案

Debian、Ubuntu：使用 apt 安裝 deb

請在儲存 deb 檔案的目錄執行以下指令。./ 表示目前目錄中的檔案，能明確告訴 apt 要安裝的是本機套件，而不是依名稱至軟體來源搜尋。apt update 會更新軟體來源索引，並不等於升級整個系統。

sudo apt update
sudo apt install ./shadowrocket-local.deb

請先閱讀 apt 列出的安裝計畫，再確認執行。若無法滿足相依條件，請記下錯誤訊息中的套件名稱與版本限制，並檢查目前發行版的軟體來源是否正常，以及所選套件是否適用於目前系統。請勿忽略相依套件，讓失敗的安裝看似成功；也不要只為了解決一則安裝提示，就任意加入其他發行版的軟體來源。

Fedora 等 dnf 環境：安裝 rpm

sudo dnf install ./shadowrocket-local.rpm

dnf 同樣會讀取本機套件資訊，並嘗試從已設定的軟體來源解析相依套件。若出現套件簽章或來源相關提示，請先確認檔案是否來自本站下載頁，再查看提示涉及的是安裝檔還是軟體來源設定；請勿直接加入略過驗證的參數。安裝成功代表套件管理流程已完成，不表示桌面工作階段與網路設定也已完成。

四、AppImage：設定執行權限後啟動

AppImage 的基本操作是為檔案設定執行權限，再從目前目錄執行。它通常不會透過 apt 或 dnf 登記為已安裝套件。以下指令使用前文約定的本機檔名，一般使用者即可執行；若雙擊沒有反應，請勿因此改用 sudo 啟動圖形程式。

chmod u+x ./Shadowrocket-local.AppImage
./Shadowrocket-local.AppImage

chmod u+x 只會為檔案擁有者新增執行權限，不會安裝缺少的系統元件，也無法解除檔案系統的 noexec 限制。若檔案儲存在外接儲存裝置、共享資料夾或受限掛載點，建議先移至個人主目錄中允許執行的一般資料夾，再視需要執行。複製後可用 ls -l 查看權限，但不要為了啟動單一檔案而遞迴修改整個主目錄的權限。

• 若看到 Permission denied：先檢查執行權限、上層目錄的存取權限，以及所在掛載點是否禁止執行。
• 若看到 Exec format error：優先確認 uname -m 的結果與下載包架構是否相符，再確認下載是否已完整完成。
• 若看到與 FUSE 或 libfuse.so.2 相關的錯誤：請依目前發行版查詢所需的相容元件；不同發行版的套件名稱可能不同，請勿照抄其他系統的安裝指令。
• 若看到動態程式庫或桌面顯示相關錯誤，請保留終端機的完整輸出，分辨是系統程式庫還是圖形工作階段的問題，不要將它們歸類為執行權限錯誤。

AppImage 是否需要特定 FUSE 元件，取決於封裝方式與執行環境，並非每次啟動都一定會缺少該元件。先閱讀錯誤訊息再處理，可避免安裝不相關的元件。桌面檔案管理員對可執行檔的雙擊行為也可能不同；首次排查時，使用終端機啟動較容易看出錯誤原因。

五、deb、rpm 與 AppImage 的維護方式

選擇檔案格式不只影響首次啟動，也會影響後續更新與移除。透過本機 deb 或 rpm 安裝，不代表系統已新增自動更新的軟體來源；是否有更新來源，請以實際安裝結果為準。需要更新時，請先結束用戶端，再從下載頁選擇適用於目前系統的檔案，並詳閱套件管理工具列出的變更計畫。

無論使用哪種格式，刪除程式檔案與刪除個人設定是兩回事。更換安裝方式前，請先保留目前的設定；不了解用途時，不要清空整個使用者設定資料夾。若應用程式選單與手動啟動的結果不同，請先結束所有副本，確認實際啟動的檔案路徑，再進行後續排查。

六、安裝完成後：區分啟動、設定與連線問題

視窗能正常開啟，只能確認安裝階段沒有問題，不能證明連線服務可用。後續操作以使用者已有自己的服務商與訂閱為前提。本站不提供、銷售或推薦節點、訂閱或連線服務；用戶端取得方式與使用者已有的連線服務應分開處理。

• 程式未啟動：先排查架構、相依套件、執行權限與圖形工作階段問題，暫時不要修改訂閱或規則。
• 程式已啟動，但沒有設定：依照使用教學匯入使用者已有的設定，並確認連結完整；不要以為用戶端安裝成功就會自動取得連線參數。
• 匯入後仍無法連線：確認伺服器位址、連接埠、協定與認證資料是否符合既有設定，再檢查網路錯誤；反覆重新安裝通常無法修正這些欄位。
• 連線後瀏覽仍異常：請依疑難排解手冊分辨路由、規則與 DNS 問題，不要同時修改多項設定後才判斷原因。

在支援相應介面的裝置上，Home 可查看連線與設定入口，Config 用於管理規則設定，Settings 用於調整設定；這些操作與 Linux 套件管理工具安裝相依套件屬於不同層面。跨平台核對時，請以目前裝置實際顯示的入口為準，不要將某個平台的系統 VPN 授權流程直接套用到 Linux。

七、Linux 安裝常見問題