Shadowrocket Linux 安裝教學：deb、rpm、AppImage 如何選擇

本文重點

Ubuntu、Debian 系統建議選 deb；Fedora 等使用 dnf 的系統建議選 rpm；若希望保留獨立程式檔案，再考慮 AppImage。本文從確認系統與處理器架構開始，說明本機套件安裝、執行權限、首次啟動及連線測試。以下步驟以你已向服務商取得訂閱為前提；安裝完成不代表網路連線已設定妥當。

一、確認發行版、架構與安裝套件

Shadowrocket（小火箭）Linux 版免費，可從本站下載頁面的 Linux 區域選擇安裝套件。deb、rpm、AppImage 是不同的封裝形式，不代表三種不同的訂閱，也不能只看副檔名就判斷是否適用於目前的處理器。下載前請一併確認發行版、套件架構與頁面標示的執行需求。

先開啟終端機並執行以下兩個指令。/etc/os-release 可用來識別發行版；uname -m 會顯示目前執行中的核心架構。常見的 x86_64 與 aarch64 並不通用，套件管理器中的名稱也可能分別標示為 amd64 或 arm64。

cat /etc/os-release
uname -m

Ubuntu、Debian 及相容發行版：優先選擇 deb，使用 apt 安裝本機檔案，讓套件管理器處理相依套件。
Fedora 等使用 dnf 的發行版：優先選擇 rpm，使用 dnf 安裝；不能只因副檔名相同，就認定所有 RPM 系發行版都相容於同一個套件。
其他桌面發行版：可確認 AppImage 的架構與執行環境需求。AppImage 不保證能在所有 Linux 環境中執行。

二、使用 apt 安裝本機 deb 檔案

以下指令請在 Bash 中執行。先將下載的 deb 檔案放在容易找到的位置，再複製完整的絕對路徑，例如在檔案管理員中查看檔案屬性。輸入路徑時不必另外加上引號，也不要將瀏覽器中的下載連結當成本機路徑；指令中的變數引用會處理路徑內的空格。

read -r -p "貼上 deb 檔案的完整絕對路徑：" pkg
test -f "$pkg" && sudo apt install "$pkg"

apt install 後面接本機檔案路徑，表示安裝該檔案，而非到軟體來源搜尋同名應用程式。使用絕對路徑可避免因目前目錄不正確而找不到檔案。終端機要求輸入密碼時，請輸入目前 Linux 使用者的授權密碼；輸入時通常不會顯示字元。

確認檔案

在下載頁選擇 deb 後，等候瀏覽器完成下載。確認檔案不是尚未下載完成的暫存檔，並核對頁面標示的架構。
執行安裝

將完整路徑貼到終端機提示後按 Enter。檢查 apt 列出的安裝、升級與移除項目，再確認繼續。
處理相依套件

若提示相依套件無法滿足，先執行 sudo apt update，再重試原本的安裝指令。若仍失敗，記下缺少的相依套件名稱，不要直接忽略相依性問題。
首次開啟

安裝成功後，從桌面應用程式選單搜尋 Shadowrocket，並以一般使用者身分開啟。若選單沒有立即更新，可重新登入桌面後再查看。

若系統提示套件架構不符，請返回下載頁重新選擇，不要使用強制安裝選項。若提示某個程式庫版本過舊，更新軟體來源不一定能解決問題：目前發行版提供的系統程式庫可能確實不符合需求。此時請確認支援環境，不要為了安裝單一應用程式而任意替換系統核心程式庫。

三、使用 dnf 安裝本機 rpm 檔案

在使用 dnf 的系統上，安裝方式與 deb 相同：明確指定已下載的本機檔案，讓發行版的套件管理器解析相依套件。以下同樣使用絕對路徑，不必重新命名檔案，也不預設下載檔案的名稱。

read -r -p "貼上 rpm 檔案的完整絕對路徑：" pkg
test -f "$pkg" && sudo dnf install "$pkg"

出現確認清單：檢查相依套件的來源與交易內容，確認不會意外移除重要的桌面元件後再繼續。
提示找不到相依套件：先確認目前系統的軟體來源可正常使用，可執行 sudo dnf makecache --refresh 更新中繼資料，再重試安裝。
提示架構或發行版不相容：請停止安裝並核對下載頁的需求。不要略過相依性檢查或強制替換系統檔案來規避錯誤。
出現完整性、簽章或信任相關錯誤：保留原始錯誤訊息，確認檔案是透過本站下載流程取得後重新下載；不要直接關閉套件管理器的安全檢查。

安裝成功只表示套件檔案與相依套件已寫入系統，不代表代理已啟用。請先從應用程式選單啟動 Shadowrocket，再匯入訂閱並設定連線。排查時請將「軟體安裝失敗」與「安裝成功但請求失敗」分開處理，避免反覆重新安裝而掩蓋真正的網路問題。

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

AppImage 通常以獨立檔案方式執行，不會透過 apt 或 dnf 登錄為系統套件。建議先將檔案移到固定的個人目錄，再新增執行權限。不要長期從瀏覽器的暫存目錄啟動，否則清理下載檔案時可能連程式也一併刪除。

read -r -p "貼上 AppImage 檔案的完整絕對路徑：" app
if test -f "$app"; then
  chmod u+x "$app" && "$app"
fi

chmod u+x 只會為檔案擁有者新增執行權限；接下來的指令會直接執行該檔案。一般啟動不需要在前面加上 sudo。若圖形桌面沒有反應，保留終端機視窗中的錯誤輸出，比反覆點擊更容易判斷原因。

檔案執行條件

執行權限: 使用 chmod u+x 新增
檔案位置: 放在固定的個人目錄
處理器架構: 符合下載頁標示與本機架構
啟動身分: 以一般桌面使用者身分執行

獨立檔案仍仰賴主機系統提供相容的執行環境。

常見錯誤線索

Permission denied: 檢查執行權限與掛載選項
Exec format error: 優先確認架構與檔案是否完整
FUSE 相關錯誤: 依發行版確認相容的執行元件
缺少共享程式庫: 檢查執行需求與系統程式庫版本

依錯誤內容處理，不要以提高整個應用程式的權限取代診斷。

如果檔案所在的分割區使用 noexec 掛載選項，即使已新增執行權限，也可能無法啟動。可將檔案移至允許執行的個人目錄後再試。FUSE 相關元件的名稱會因發行版而異，請先查看系統的套件資訊；不要直接將其他發行版的安裝指令複製到本機。

五、首次開啟後匯入訂閱並確認分流

先確認應用程式能正常顯示視窗，再設定網路。訂閱連結請向你的服務商取得，並視為敏感資訊妥善保存。若介面提供相應入口，可在 Home 右上角的「+」中將 Type 設為 Subscribe，輸入連結並儲存，再更新訂閱；若桌面版配置與行動版不同，請以目前介面顯示的入口為準。

匯入後，檢查清單中是否出現預期項目，再選取一個現有項目進行連線。只看到訂閱名稱不代表更新成功；若清單是空的，應先處理訂閱請求錯誤。Config 中的設定檔與 Home 中的伺服器項目並非同一個項目，匯入伺服器不代表規則已符合你的使用需求。

Config

建議

依照目前選取的設定檔處理已接管的請求。規則由上而下比對，實際使用代理或直連取決於符合的規則與策略，不是固定依地區判斷。

適用情境：已檢查設定檔後的日常分流

Proxy

讓已接管的請求使用代理路徑，適合短暫與 Config 設定進行對照。這不會自動接管原本未進入代理的應用程式流量。

適用情境：區分代理連線問題與規則比對問題

Direct

讓已接管的請求使用直連路徑。切換後仍須以相同目標、相同應用程式進行測試，才能方便比較直連與代理路徑的差異。

適用情境：短暫建立直連對照結果

檢查規則時，可先了解以下三行的意義。這是語法範例，不是完整設定檔；PROXY 必須對應到目前設定中的有效策略。不要直接以範例覆蓋現有設定，也不要據此判斷特定網站應使用哪條線路。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

DOMAIN-SUFFIX：比對指定的網域後綴；範例網域僅用於說明語法。
IP-CIDR：依目標 IP 網段進行比對；範例範圍為私有位址區段。
FINAL：前面的規則都未符合時採用的最終策略，應放在規則末尾。

在 Linux 上，還要區分「代理程式正在執行」與「目標應用程式正在使用代理」。應用程式是否會接管系統流量、是否需要另外設定瀏覽器或終端機，取決於目前啟用的網路模式。若介面顯示本機監聽位址與連接埠，請依實際值填寫，不要假設連接埠固定為特定數字。

六、安裝成功後的常見問題

雙擊 AppImage 沒反應，需要重新安裝嗎？

先在終端機依第四節的方式執行並查看錯誤輸出。若出現 Permission denied，請檢查執行權限與 noexec；若是 FUSE 或共享程式庫錯誤，請依發行版處理執行元件。沒有錯誤訊息前，不要直接認定是下載套件有問題。

首次啟動時跳出系統授權提示，該怎麼選？

先查看要求授權的程式與操作內容。安裝套件時的管理員授權，與執行期間修改網路設定的授權並不相同。只有在剛執行相應操作，且提示內容與該操作一致時才確認；不要為了消除提示，長期以 root 身分執行整個圖形應用程式。

瀏覽器能開啟網頁，但終端機請求失敗？

檢查終端機是否仍使用直連，或保留了舊的代理環境變數。可執行 env | grep -i proxy 查看，再與目前的監聽位址及連接埠核對。HTTP 代理與 SOCKS 代理的類型不可混用；修改後請在同一個終端機工作階段中重新測試。

訂閱更新失敗，需要更換安裝套件格式嗎？

不必先更換格式。請檢查訂閱連結是否完整、是否已過期，以及目前網路能否連線至訂閱網址；再向服務商確認回傳內容。回報錯誤時請隱藏連結中的 token 等憑證，避免在螢幕截圖或記錄中貼出完整訂閱網址。

驗證時一次只改變一個條件。例如使用同一個瀏覽器和同一個目標網址，先測試 Direct，再測試 Proxy，最後回到 Config 檢查規則。若瀏覽器成功、終端機失敗，通常應先檢查兩者的代理設定差異；若兩者都失敗，則繼續檢查連線狀態、DNS 與服務商提供的設定，而不是先重複安裝。

七、後續更新與移除須知

透過本機 deb 或 rpm 安裝，不代表系統已訂閱應用程式的軟體更新來源。日後取得新版安裝套件時，仍應查看本站下載頁，並在結束應用程式後依對應方式安裝。AppImage 則是獨立檔案；替換前請先關閉舊程序，並確認桌面捷徑沒有繼續指向舊路徑。

更新前：備份個人設定並妥善保管訂閱資訊。套件管理器更新程式檔案，不等於備份個人設定。
移除 deb / rpm：先在圖形化軟體管理器的已安裝清單中確認套件名稱，再執行移除；不要依應用程式顯示名稱猜測系統套件名稱。
移除 AppImage：結束程序後刪除對應檔案，並檢查自行建立的捷徑。刪除程式檔案不一定會一併移除使用者設定。
清除網路設定：若曾手動為瀏覽器或終端機設定本機代理，停止應用程式後也應一併還原，否則請求仍可能傳送至已關閉的監聽連接埠。

選擇安裝格式時，應以發行版、架構與維護方式是否相符為原則。安裝問題請查看套件管理器或終端機的錯誤訊息；連線問題則檢查訂閱、流量接管範圍與分流設定。將這兩種排查方向分開，可減少無效的重新安裝，並保留有用的診斷資訊。