Shadowrocket Linux 版免費，Mac（Apple 晶片／Intel）、Windows、Android 版也免費；iPhone／iPad 版於 App Store 一次性付費 $2.99，系統需求以 App Store 頁面標示為準。本文說明 Linux 桌面版的安裝方式，涵蓋系統辨識、套件格式選擇、本機安裝、啟動疑難排解與連線檢查；安裝檔請至本站下載頁取得，無須另外尋找第三方軟體來源。
一、確認 Linux 發行版與處理器架構
deb、rpm 與 AppImage 是不同的軟體發佈格式，並非三種連線協定。選擇安裝包時，先確認發行版使用的套件管理工具，再核對處理器架構；副檔名相同，不代表一定適用於目前的裝置。Linux 桌面環境、執行程式庫與檔案系統權限也會影響啟動，不能只因下載成功就認定已符合執行條件。
在終端機執行以下兩個指令。第一個讀取發行版識別資訊，請留意 ID 與 ID_LIKE；第二個查看系統回報的機器架構。這些指令只會讀取資訊，不會安裝軟體，也不會變更連線設定。
cat /etc/os-release
uname -m判斷發行版
- Debian / Ubuntu
- 優先選擇 deb，使用 apt 安裝本機套件檔。
- Fedora
- 優先選擇 rpm，使用 dnf 安裝本機套件檔。
- 其他發行版
- 先查閱發行版說明，再確認 AppImage 的執行條件。
副檔名為 rpm，不代表所有 rpm 發行版的相依環境都相同。
架構與權限
- x86_64
- 通常對應 x64／amd64 架構的版本。
- aarch64
- 通常對應 ARM64 架構，下載頁也必須提供相符版本。
- 安裝權限
- 安裝 deb／rpm 通常需要 sudo 授權。
請以下載頁實際提供的架構為準，不要將其他架構的套件視為相容版本。
前往下載頁的 Linux 區域，選擇實際提供的套件。若沒有符合處理器架構的檔案，請先停止安裝；更改副檔名或反覆執行安裝指令，都無法將一種機器架構轉換成另一種。
二、下載後依序準備檔案
以下步驟會先處理檔案位置與名稱，再執行相應的安裝指令。文中的 shadowrocket-local.deb、shadowrocket-local.rpm 與 shadowrocket-local.AppImage 是為了方便輸入而設定的本機檔名，不是下載站上的實際套件名稱，也不代表版本資訊。
-
選擇安裝包
開啟本站取得應用程式頁面 → Linux，依發行版與架構下載合適的檔案。deb、rpm、AppImage 擇一安裝即可。
-
準備檔案位置
在檔案管理員中開啟檔案所在資料夾，使用桌面環境提供的「在終端機中開啟」功能。下載資料夾不一定名為 Downloads；名稱可能因本地化設定或瀏覽器設定而異。
-
簡化本機檔名
只重新命名剛下載的檔案：deb 改為 shadowrocket-local.deb，rpm 改為 shadowrocket-local.rpm，AppImage 改為 shadowrocket-local.AppImage。請保留原本的副檔名。
-
執行相應指令
依下一節選擇 apt、dnf 或 chmod 的操作方式。安裝完成後，從應用程式選單或檔案本身啟動，再前往 Home 檢查既有連線資訊。
三、Debian／Ubuntu：使用 apt 安裝 deb
Debian／Ubuntu 系統建議使用 apt 安裝本機 deb 套件。系統已設定的軟體來源可用時，apt 能處理相依套件；若只執行 dpkg -i，安裝後可能仍有尚未滿足的相依項目。安裝前可先讀取套件的架構欄位，並與前面確認的系統架構比對。
dpkg-deb -f ./shadowrocket-local.deb Architecture
sudo apt install ./shadowrocket-local.deb執行 sudo 時，請輸入目前 Linux 使用者的授權密碼；終端機通常不會顯示輸入的字元。apt 列出準備安裝或調整的套件後，請先檢視摘要；若出現大量與本次安裝無關的移除項目，請取消操作並檢查系統軟體來源與相依狀態，不要直接確認。
- 顯示相依項目無法滿足：先確認發行版仍受維護、軟體來源可正常存取，且套件架構相符。必要時執行
sudo apt update更新套件索引，再重新安裝本機檔案。 - 顯示套件管理器鎖定中：請等待系統更新或其他 apt 作業完成。不要直接刪除鎖定檔，以免破壞進行中的作業。
- 想確認套件是否已登錄：執行
dpkg-deb -f ./shadowrocket-local.deb Package查看實際套件名稱，再到系統套件管理工具中搜尋該名稱。
安裝完成後，從應用程式選單啟動 Shadowrocket。圖形桌面通常會讀取安裝包提供的桌面項目；若在終端機安裝成功後沒有立即看到圖示，可先關閉再重新開啟應用程式選單。不要根據產品顯示名稱猜測終端機可執行檔的大小寫。
四、Fedora：使用 dnf 安裝 rpm
Fedora 使用者可透過 dnf 安裝本機 rpm，所需相依套件由目前系統設定的軟體來源提供。請先查看套件名稱與架構，再執行安裝；查詢指令不會啟動應用程式。其他使用 rpm 的發行版，請依照各自的套件管理文件操作，不要直接照抄 Fedora 的指令與軟體來源設定。
rpm -qp --qf '%{NAME}\n%{ARCH}\n' ./shadowrocket-local.rpm
sudo dnf install ./shadowrocket-local.rpm若 dnf 回報缺少相依項目，請保留完整錯誤訊息，並確認問題是「無法連線至軟體庫」、「找不到所需相依套件」還是「架構不符」。這三種情況的處理方式不同：網路問題須恢復軟體庫連線；相依問題須確認系統相容性；架構問題則須重新選擇檔案。
- 不要使用忽略相依項目的參數強行完成安裝；套件已登錄，不代表程式就能正常啟動。
- 不要只為了安裝一個用戶端，就加入與目前發行版不相符的軟體來源。
- 後續更新可從本站下載頁取得相符的 rpm，再使用 dnf 處理本機更新；手動下載本機套件不代表已訂閱自動更新軟體來源。
五、AppImage：分別檢查執行權限與執行環境
AppImage 適合想將應用程式檔案放在使用者目錄中管理的情況，但「單一檔案」不代表適用於所有 Linux 系統。它仍受 CPU 架構、基礎執行程式庫、桌面環境與封裝方式影響；部分 AppImage 需要 FUSE 才能掛載執行。即使沒有管理員權限，也要先確認目前系統已具備所需條件。
依照前文重新命名下載的檔案後，在檔案所在目錄執行以下指令。第一個指令只會為目前使用者新增執行權限，第二個則從目前目錄啟動；不必將整個資料夾設為所有使用者皆可寫入。
chmod u+x ./shadowrocket-local.AppImage
./shadowrocket-local.AppImage- Permission denied：使用
ls -l ./shadowrocket-local.AppImage檢查使用者是否有執行權限。若已具備執行權限，請再確認檔案是否位於以noexec掛載的分割區。 - Exec format error：優先確認處理器架構與檔案類型，不要反覆執行 chmod。
- 顯示缺少 FUSE 或 libfuse：依目前發行版的文件安裝相容的執行元件。不同發行版的套件名稱可能不同，不要直接刪除或替換系統中已有的 FUSE 元件。
- 顯示缺少共用程式庫：記下終端機顯示的完整程式庫名稱與錯誤訊息，並檢查發行版相容性；不要從陌生網頁單獨下載系統程式庫來覆蓋原有檔案。
可將 AppImage 放在使用者主目錄下固定的應用程式資料夾，避免清理下載資料夾時誤刪。若桌面捷徑指向這個檔案，移動或重新命名後也須同步修改路徑。不要用 sudo 啟動整個圖形介面應用程式來規避一般檔案權限問題；若網路操作確實需要系統授權，請依應用程式與系統的授權提示處理。
六、安裝後區分啟動、設定與網路問題
應用程式能開啟，只代表安裝與基本執行環境通過初步檢查。使用連線功能仍需使用者已有的服務設定。本站不提供、不銷售，也不推薦節點、訂閱或服務商；用戶端安裝與線路服務是兩件獨立的事。
在 Home 檢查既有伺服器或訂閱是否已匯入，在 Config 確認目前使用的設定，再檢查 Global Routing。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是協定類型，不是安裝包格式；服務端提供的協定、連接埠、驗證與傳輸參數應逐項相符，不要因改用 Linux 就自行變更。
Config：規則模式
建議依目前設定中的規則處理連線。先確認設定來源與規則內容符合需求，再作為日常使用模式；並非所有設定都會將未符合規則的連線設為直連。
適用情況：已有明確的分流規則，需要依網域名稱或 IP 分別處理連線。
Proxy：代理模式
由用戶端接管的連線會以代理模式處理，可暫時用來排查差異是否由規則比對造成。但這不代表所有應用程式、容器或獨立網路環境中的流量都已由用戶端接管。
適用情況：暫時確認代理連線本身是否可用，檢查後再切回所需模式。
Direct：直連模式
由用戶端接管的連線會以直連模式處理。若目前使用 Direct，即使已選取伺服器，也不能據此認定網頁請求正透過該伺服器轉送。
適用情況：檢查本機基本網路，區分直連問題與代理連線問題。
例如，若想讓指定網域走代理、其他連線則直連，規則可寫成以下兩行。example.com 僅為語法範例；PROXY 指向的代理策略仍須在實際設定中可用。規則會依序比對，最後一行 FINAL 用來處理先前未符合的連線。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT不要因瀏覽器可以上網，就認定整個系統都使用相同的網路設定。命令列程式可能讀取自己的代理參數，背景服務與容器也可能使用獨立環境。若須手動填寫本機代理連接埠，請查看用戶端目前設定中的實際監聽連接埠，不要從教學文章猜測固定數字。
七、Linux 安裝常見問題
deb 無法安裝，可以改副檔名變成 rpm 嗎？
不可以。重新命名只會改變檔名，不會變更套件內的中繼資料、相依項目描述或安裝指令碼。請回到本站下載頁，選擇適用於目前發行版的檔案；本文簡化本機檔名時也必須保留原副檔名。
AppImage 按兩下沒有反應，該先檢查什麼？
先在檔案所在目錄執行 ./shadowrocket-local.AppImage，查看終端機錯誤訊息。權限錯誤請檢查執行權限與掛載參數；FUSE 錯誤請檢查執行元件；架構錯誤則重新核對 uname -m。不要反覆按兩下檔案來代替錯誤診斷。
三種套件都需要安裝嗎？
不需要。選擇符合系統的一種安裝方式即可。混用系統套件與多個 AppImage 副本，可能會產生多個啟動項目；排查問題時，先確認目前執行的是哪個檔案，再保留需要的安裝方式。
應用程式已啟動，但訂閱更新失敗怎麼辦？
先確認裝置時間與基本網路正常，再檢查 Home 中既有訂閱的網址是否完整且仍有效。保留錯誤訊息，並向原服務提供者確認存取條件；重新安裝 deb 或 rpm 通常無法修復失效的訂閱網址。分享診斷資訊時，請遮蔽訂閱 token 與驗證欄位。
建議排錯紀錄包含發行版名稱、uname -m 輸出、所選套件格式、執行過的指令，以及終端機完整錯誤訊息。依「檔案相符 → 安裝作業 → 應用程式啟動 → 連線設定」的順序排查，可避免將套件管理問題誤判為規則問題，也能避免因連線失敗而反覆重新安裝用戶端。