Linux 安裝與套件格式

一、先確認發行版與架構

Shadowrocket（小火箭）的 Linux 套件應依目前系統選擇，而非依桌面外觀判斷。GNOME、KDE 等桌面環境無法決定該使用 deb 還是 rpm；Ubuntu 與 Fedora 即使使用相似的桌面環境，套件管理方式也不同。在終端機執行以下兩個唯讀指令，分別查看發行版識別資訊與機器架構。

cat /etc/os-release
uname -m

第一個指令的輸出請特別留意 ID、ID_LIKE，並參考該發行版自己的套件管理說明。第二個指令常見的輸出為 x86_64 或 aarch64。前者通常對應下載說明中的 x64，後者通常對應 ARM64；套件格式與架構是兩項不同條件，副檔名相同不代表處理器相容。若下載頁沒有提供相符架構的版本，請勿勉強安裝其他架構的套件。

二、取得安裝套件並準備本機檔案

前往客戶端下載頁的 Linux 區塊取得安裝套件，確認格式與架構後再儲存。本文不使用第三方下載網址，也不透過終端機下載遠端安裝指令碼。若瀏覽器尚未完成下載、檔案大小為零或仍帶有暫存副檔名，請先等候下載完成。

1. 在使用者的家目錄下建立 shadowrocket-install 資料夾。
2. 只將這次選擇的一個安裝套件放入該資料夾，避免混入其他軟體或舊套件。
3. 為方便複製下方指令，請將 deb 檔重新命名為 shadowrocket-local.deb，或將 rpm 檔重新命名為 shadowrocket-local.rpm。AppImage 的儲存方式請參閱第五節。
4. 只修改檔名，不要藉由變更副檔名轉換格式。重新命名也不會改變檔案內部的架構與相依套件需求。

mkdir -p "$HOME/shadowrocket-install"
cd "$HOME/shadowrocket-install"
ls -lh

上述檔名是使用者在本機設定的操作名稱，並非本站安裝套件原始檔名的規定。若保留下載時的原始檔名，請在後續指令中替換整個檔案路徑；路徑含空格時，請用英文雙引號括住。請勿同時執行 deb 和 rpm 兩套步驟。

三、deb：使用 apt 安裝本機檔案

在 Debian、Ubuntu 等使用 apt 的系統中，先切換至剛才建立的資料夾，再安裝本機 deb 套件。指令中的 ./ 很重要：它表示參數是目前資料夾中的檔案，而非軟體來源中的套件名稱。安裝時需要管理員授權；相依套件通常會從系統已設定的軟體來源取得，因此若有相依套件需要下載，網路必須可用。

cd "$HOME/shadowrocket-install"
sudo apt install ./shadowrocket-local.deb

1. 請查看 apt 列出的新增、升級與移除項目。若出現大量且明顯與這次操作無關的移除項目，請先取消，不要直接確認。
2. 確認交易內容後，等待安裝程序完成。終端機重新顯示提示符號且沒有安裝錯誤後，再從桌面應用程式清單尋找 Shadowrocket。
3. 若顯示找不到檔案，請執行 pwd 和 ls -lh，先確認目錄與檔名，不要立刻更換安裝指令。
4. 若顯示架構不相符，請回到下載頁確認架構；若顯示相依套件無法滿足，請檢查系統支援範圍、軟體來源設定與相依套件名稱。

sudo apt update 只會更新軟體來源索引，不等於升級整套系統，也不會直接安裝 Shadowrocket。若錯誤明確指出索引已過期，可先執行此指令，再重試本機安裝。若系統版本無法提供所需相依套件，重複更新索引也無法解決執行環境不相容的問題。

四、rpm：使用 dnf 檢查並執行安裝交易

在 Fedora 等使用 dnf 的系統中，本機安裝方式與 apt 類似，但參數必須是 rpm 檔案。dnf 會依套件中繼資料檢查架構與相依套件，並顯示即將執行的交易內容。安裝前請先關閉已執行的 Shadowrocket，避免更新程式檔案時，舊程序仍在使用舊檔案。

cd "$HOME/shadowrocket-install"
sudo dnf install ./shadowrocket-local.rpm

• 顯示檔案不存在：請檢查目前目錄與檔案副檔名，確認沒有將 deb 重新命名為 rpm。
• 顯示缺少相依套件提供者：記下缺少的項目，檢查發行版相容性與軟體來源狀態，請勿任意下載同名系統程式庫並覆蓋現有檔案。
• 顯示套件衝突：先確認是否安裝過其他打包格式或舊套件，再使用系統套件管理工具查看已安裝項目；請勿手動刪除系統目錄中的應用程式檔案。
• 交易已取消：重新查看取消前的提示，確認原因是使用者拒絕、權限問題還是相依套件檢查失敗，再決定下一步。

安裝完成後，從桌面應用程式清單開啟程式。若應用程式捷徑沒有立即出現，請先重新整理應用程式清單或重新登入桌面工作階段；不要因為「看不到圖示」就認定安裝失敗。若終端機明確回報交易失敗，請先處理安裝錯誤，不要反覆點選桌面捷徑。

五、AppImage：新增執行權限並從終端機啟動

AppImage 通常以單一檔案儲存與執行，不會像 deb、rpm 一樣登錄相同的系統安裝交易。但這不代表它適用於所有 Linux 環境：處理器架構、基礎執行程式庫、圖形工作階段，以及部分版本使用的 FUSE 機制，都可能影響啟動。請先確認下載頁的說明，再選擇此格式。

在家目錄中建立 Applications 資料夾，將已下載完成的 AppImage 移入其中，並在檔案管理員中重新命名為 Shadowrocket.AppImage。接著執行下列指令；chmod u+x 只會為檔案擁有者新增執行權限，不需要將程式設為所有人皆可寫入。

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

若出現 Permission denied，除了檢查執行權限，也要確認檔案所在分割區是否以 noexec 掛載。若出現 FUSE 相關錯誤，請依目前發行版的文件確認所需執行元件，不能假設所有發行版的元件名稱都相同。AppImage 沒有自動出現在應用程式選單中，也不代表檔案已損毀。

六、首次開啟：分開檢查安裝與連線

能夠開啟主視窗，只表示程式已完成啟動階段；接下來還需設定使用者已有的伺服器或訂閱。本站不提供、不販售也不推薦節點或訂閱。首次測試時，請先確認現有網路可正常使用，在 Home 檢查匯入內容，確認位址、連接埠與驗證欄位沒有遺漏，再建立連線。請勿為了讓測試通過而隨意填入連接埠號碼。

1. 在 Home 匯入使用者自己已有的設定。訂閱是一組可更新的設定來源，並非安裝套件的一部分。
2. 確認目前選取的項目就是準備使用的伺服器，避免誤選已過期的項目。
3. 檢查 Global Routing 目前的模式，再進行一次明確的連線測試。切換模式前請記下原本設定，測試後再還原。
4. 若視窗運作正常但連線失敗，請分別檢查驗證資訊、連線逾時、網域名稱解析與規則比對結果；此時先排查設定，不要立刻解除安裝重裝。

七、更新、解除安裝與常見錯誤

更新前，請先使用應用程式提供的匯出功能備份自己的設定，並妥善保管訂閱憑證。deb、rpm 的套件管理器登錄方式與 AppImage 檔案替換方式不同；從本站取得新套件，不代表系統會自動切換目前正在執行的程序。更新後應結束舊程序，重新開啟程式並確認設定是否保留。

• 更新 deb：下載相符架構的新套件後，仍使用本機 apt install 方式，讓套件管理器依套件資訊判斷升級關係。
• 更新 rpm：使用本機 dnf install 時，請確認交易內容確實將套件識別為預期的更新，不要忽略降級或衝突提示。
• 更新 AppImage：結束應用程式後替換原檔，並重新檢查執行權限。新下載的檔案不一定會保留舊檔案的執行權限。
• 解除安裝：deb、rpm 請透過系統軟體管理工具確認正確的套件名稱後移除；AppImage 則在結束程式後刪除檔案與自行建立的捷徑。個人設定是否保留需另外確認，移除程式不代表所有使用者資料也會一併清除。