本文適合準備在 Linux 桌面安裝 Shadowrocket(小火箭),且已有自己的服務商與訂閱的使用者。請先確認發行版與 CPU 架構,再選擇 deb、rpm 或 AppImage。安裝後分別確認應用程式能否啟動、訂閱是否匯入,以及連線是否正常,避免將安裝問題與設定問題混為一談。
一、先確認發行版、架構與安裝檔格式
deb、rpm 與 AppImage 是不同的 Linux 軟體散布格式,並非不同的代理協定。選擇時,先確認發行版使用的套件管理工具,再核對下載頁列出的架構與執行需求。將副檔名從 .rpm 改成 .deb 不會轉換套件格式,也無法解決架構不相容的問題。
開啟終端機並執行以下指令。/etc/os-release 可用來辨識發行版,uname -m 則用來確認架構;請分別核對這兩項資訊,不要只憑桌面外觀判斷。
cat /etc/os-release
uname -m
| 安裝格式 | 常見適用環境 | 安裝方式 | 注意事項 |
|---|---|---|---|
| deb | Debian、Ubuntu 及使用 apt 的衍生發行版 | 使用 apt 安裝本機檔案 | 由套件管理工具登記,並從已設定的軟體來源解析相依套件。 |
| rpm | Fedora 及使用 dnf 的發行版 | 使用 dnf 安裝本機檔案 | 使用 rpm 格式不代表所有發行版都採用 dnf。 |
| AppImage | 符合該檔案執行需求的 Linux 桌面環境 | 新增執行權限後執行 | 仍會受到 CPU 架構、系統程式庫、FUSE 與掛載選項影響。 |
例如,x86_64 通常對應下載頁中的 x64 或 amd64,aarch64 通常對應 arm64。這是架構名稱的對應關係,不代表本站一定提供所有組合;實際可用檔案請以全平台下載頁為準。架構不符時,請勿反覆新增執行權限。
二、取得檔案並記下安裝前資訊
在下載頁選擇 Linux,再依發行版挑選格式。本文所有下載操作都從本站下載頁開始,無須自行拼湊安裝檔網址。請記下下載檔案所在資料夾與完整檔名,後續安裝、疑難排解及查詢套件資訊都會用到。
-
檢查系統
開啟終端機,執行上一節的兩個指令,記下發行版名稱與架構。遠端終端機連線的系統不一定是目前桌面所在的系統,請確認操作對象。
-
選擇格式
前往全平台下載頁的 Linux 區域。使用 apt 的系統選擇 deb,使用 dnf 的系統選擇 rpm;若要使用 AppImage,請先閱讀對應的執行需求。
-
記下路徑
在檔案管理員中查看檔案資訊,複製實際的絕對路徑。下文的終端機提示要求輸入路徑時,請勿額外加上引號,也不要用尚未展開的波浪號代替主目錄。
-
確認檔案來源
確認檔案是從本站下載頁取得,且已下載完成。若檔名仍帶有瀏覽器的暫存下載副檔名,請等候下載完成再安裝,不要手動移除副檔名後強行執行。
三、分別安裝 deb、rpm 與 AppImage
以下指令請在 Bash 中執行,每次只執行與所選格式相符的一組。指令會以互動方式讀取實際檔案路徑,不預設安裝檔名稱;變數以外的雙引號用來保留路徑中的空格。安裝前請先關閉正在執行的 Shadowrocket。
deb:使用 apt 處理本機安裝與相依套件
在 Debian、Ubuntu 等 apt 環境中執行以下指令。輸入檔案的絕對路徑後,先查看 apt 列出的安裝、升級或移除計畫,再決定是否確認;不要為了略過相依套件錯誤而直接使用強制安裝選項。
read -r -p "請輸入 deb 檔案的絕對路徑: " pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
dpkg-deb 會輸出套件名稱與套件架構,可用來確認所選檔案。若 apt 顯示找不到相依套件,請先檢查系統軟體來源是否可用;需要更新套件索引時,執行 sudo apt update 後再試一次。更新索引不等於升級整個系統,也無法自動解決發行版不相容的問題。
rpm:在 dnf 環境中安裝本機檔案
Fedora 等使用 dnf 的系統可執行以下指令。先讀取套件資訊,再交由 dnf 解析相依套件。其他使用 rpm 格式、但未使用 dnf 的系統,應採用該發行版的套件管理方式;不要為了照抄指令而額外更換套件管理工具。
read -r -p "請輸入 rpm 檔案的絕對路徑: " pkg
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
若出現 nothing provides,請查看後方列出的相依套件名稱,並核對系統支援條件及已啟用的軟體庫。不要使用忽略相依套件的參數強行讓安裝程序顯示成功;套件已登記不代表程式具備執行所需的程式庫。
AppImage:新增執行權限後直接執行
請將檔案放在一般使用者可存取、且不會被隨意清除的位置,再執行以下指令。AppImage 不會透過 apt 或 dnf 登記,因此首次執行後不會自動取得套件管理工具提供的更新與解除安裝入口。
read -r -p "請輸入 AppImage 檔案的絕對路徑: " pkg
chmod u+x "$pkg"
"$pkg"
chmod u+x只會替檔案擁有者新增執行權限,無須開放所有使用者的寫入權限。- 日常使用時請以一般使用者身分啟動。若視窗沒有出現,不要因此改用
sudo執行整個圖形應用程式。 - 執行成功後請保留該檔案;若自行建立桌面捷徑,捷徑目標必須指向檔案實際存放的位置。
- AppImage 可以將應用程式檔案集中在一起,但不能據此推斷所有資料都會寫入同一個資料夾,也不能假設已包含所有系統相依項目。
四、首次開啟後,分別檢查設定與連線
視窗能開啟只代表應用程式已啟動,不代表訂閱、伺服器與分流策略都已設定完成。首次檢查可依序了解 Home、Config、Settings 的用途:在 Home 查看連線與伺服器,在 Config 確認使用中的設定檔,並於 Settings 檢查相關設定。若系統要求網路授權,請先確認提示內容再按下確認。
檢查應用程式內設定
- Home
- 確認已匯入的伺服器及目前選取項目。
- Config
- 確認啟用中的設定檔與 Rule 區段。
- Global Routing
- 確認目前使用 Config、Proxy 或 Direct。
- Connectivity Test
- 檢查所選伺服器的連線,再測試實際請求。
每次只變更一項設定,並保留變更前的狀態,方便判斷結果。
檢查系統狀態
- CPU 架構
- 將 uname -m 的輸出與下載頁標示的架構相互核對。
- 系統時間
- 檢查時區與日期;時間明顯錯誤可能影響 TLS 驗證。
- 網路環境
- 先確認一般網路正常,並可使用需要登入的網路認證頁面。
- 伺服器連接埠
- 依服務商提供的資料填寫,不要預設所有協定都使用 443。
系統可連上網路與代理連線可用是兩項不同檢查,不能互相取代。
若已有訂閱,請在 Home 右上角點選「+」進入新增畫面,在 Type 選擇 Subscribe,填入向服務商取得的訂閱連結並儲存。接著更新訂閱,確認 Home 中出現伺服器項目。更新訂閱通常是刷新伺服器資料,不應直接視為已取代 Config 中的所有分流規則。
手動新增時,Shadowsocks、VMess、VLESS、Trojan、Hysteria2 與 WireGuard 的欄位不可混用。請依服務商提供的協定、位址、連接埠及驗證參數逐項填寫;不要把訂閱連結當成某種協定的伺服器位址。分享疑難排解資訊前,請隱藏訂閱權杖、密碼與 Private Key。
五、使用 Global Routing 區分安裝與分流問題
安裝完成後若遇到部分網站能瀏覽、部分無法連線,請先檢查 Global Routing,不要立即重新安裝。以下比較的是 Shadowrocket 本身的處理模式;實際作用範圍仍取決於哪些流量會進入用戶端處理,不應將 Proxy 理解為必定接管所有系統程序。
Config
建議依目前設定處理請求。檢查 Rule 區段的順序與策略,確認目標網域最後符合哪條規則;規則設定正確後,適合作為日常使用模式。
適用情境:依網域與位址進行日常分流。
Proxy
將進入用戶端處理的請求以代理模式處理,可暫時排除部分分流規則的影響。若切換後狀況有所改變,應繼續檢查設定,而非據此認定系統安裝有問題。
適用情境:短時間檢查規則與策略選擇。
Direct
以直連模式處理請求,不透過代理伺服器轉送。可用來觀察原始網路狀態;需要代理的目標在此模式下連線失敗,不能證明伺服器無法使用。
適用情境:比較直連網路與代理連線的差異。
在 Config 中,DOMAIN-SUFFIX 用於比對網域後綴,IP-CIDR 用於比對位址網段,GEOIP 依位址所屬地區比對,FINAL 則負責最後的預設處理。規則通常由上而下比對;若目標已符合較前面的規則,修改後面的規則不會改變該次比對結果。修改前請先備份目前設定,完成驗證後還原暫時性的診斷設定。
六、首次啟動常見錯誤與處理順序
疑難排解時請保留完整錯誤訊息與操作步驟,不要只記下「打不開」。以下列出 Linux 安裝與執行時常見的問題類型,並非每種發行版都會遇到。請先處理檔案執行與相依套件問題,再檢查應用程式設定,最後測試實際請求。
AppImage 顯示 Permission denied,檔案已下載完成,該怎麼辦?
先對實際檔案執行 chmod u+x "$pkg",再從同一個終端機啟動。若仍無法執行,請執行 findmnt -T "$pkg" -o TARGET,OPTIONS,檢查所在檔案系統是否設有 noexec。若有此選項,可將檔案移至允許執行的使用者目錄;不要直接修改系統掛載設定。
出現 Exec format error,是權限不足嗎?
通常應先檢查檔案格式或架構,而非新增權限。比對 uname -m、下載頁的架構標示,以及 file "$pkg" 的輸出。若 file 顯示 HTML 文件,代表取得的可能是錯誤頁面,請返回下載頁重新下載正確檔案。
AppImage 顯示缺少 libfuse.so.2,該安裝什麼?
請先記下完整錯誤訊息,再使用目前發行版的套件搜尋工具,尋找提供該檔案的 FUSE 相容執行環境。不同發行版及版本的套件名稱可能不同,請勿直接移除現有的 FUSE 元件。安裝相符的相依套件後,再以一般使用者身分從終端機啟動。
點選圖示後沒有視窗,如何查看原因?
AppImage 可使用前文設定的路徑變數直接從終端機執行;deb 或 rpm 則可先在桌面啟動器屬性中查看實際啟動指令,再於終端機執行。記下缺少程式庫、圖形工作階段或權限相關訊息,不要猜測可執行檔名稱,也不要任意停用安全機制。
已安裝成功,為什麼訂閱更新仍然失敗?
請先確認一般網路可用、系統時間正確,且訂閱連結沒有多複製空格或換行,再確認服務商端的訂閱狀態是否有效。若只有某個訂閱失敗,應優先檢查該連結與網路路徑;重新安裝應用程式通常無法修復失效的權杖。
七、更新與移除時應保留哪些資訊
之後更新時,仍請從本站下載頁取得架構相符、格式合適的檔案。deb 與 rpm 通常由各自的套件管理工具依套件中繼資料處理升級;AppImage 則需先關閉應用程式,再以新檔案取代,並重新確認執行權限與捷徑路徑。不要以為將檔案放進下載資料夾就會自動套用更新。
- 更新前請備份自行編輯的 Config 檔案,並記下目前啟用的設定檔與 Global Routing 狀態。
- 保留服務商提供的原始設定資料;備份中的訂閱連結、密碼與金鑰都應視為敏感資訊妥善保存。
- 移除 deb 或 rpm 時,請先查詢實際套件名稱,再使用 apt 或 dnf 的移除指令,查看確認清單後再執行。
- 移除 AppImage 檔案不等於清除使用者設定。若要清理資料,請先確認實際儲存位置,不要憑猜測路徑批次刪除資料夾。
- 更新後請依「啟動應用程式 → 檢查 Home → 確認 Config → 測試請求」的順序重新確認,方便找出變化發生在哪個環節。
選擇格式的關鍵,是讓應用程式符合目前系統的管理方式:apt 環境優先選用相符的 deb,dnf 環境使用相符的 rpm;選擇 AppImage 則需自行檢查檔案位置、權限與執行相依項目。安裝完成後,再依現有服務商資料設定訂閱與連線。