Shadowrocket Linux 版安裝：deb、rpm、AppImage 如何選擇？apt／dnf 指令與執行權限

1. 選擇 Linux 安裝檔：先確認發行版，再確認架構

Linux 使用者應依系統的套件管理方式選擇格式，而非只看桌面外觀。Ubuntu、Debian 及採用相同套件管理系統的發行版通常選 deb；Fedora 等使用 dnf 的系統選 rpm；若想保留獨立的應用程式檔案，可確認 AppImage 是否符合目前的系統環境。rpm 是檔案格式，不代表所有使用 rpm 的發行版都採用 dnf。

1. 確認系統

   開啟終端機並執行 cat /etc/os-release，查看 ID 與 ID_LIKE。請優先依發行版官方說明確認套件管理器，不要根據檔案管理器或桌面主題判斷。

2. 檢查架構

   執行 uname -m。常見輸出 x86_64 代表 64 位元 x86，aarch64 代表 64 位元 ARM；架構必須符合下載頁提供的安裝檔。

3. 取得檔案

   前往下載頁的 Linux 區段，依系統選擇實際提供的檔案。若沒有符合架構的檔案，請勿藉由更改副檔名或反覆授予權限來嘗試執行。

4. 整理目錄

   在檔案管理器中開啟下載檔案所在的資料夾，並選擇在該資料夾開啟終端機。下方指令都要在檔案所在的資料夾執行；若資料夾名稱含空格，切換目錄時請以引號括住完整路徑。

cat /etc/os-release
uname -m
pwd
ls -lh

在 Linux 上，uname -m 只能顯示機器架構，無法保證 AppImage 所需的執行相依項目都已備妥。deb 套件中的 amd64 通常對應機器輸出的 x86_64，兩者名稱不同不代表必須轉換檔案格式。請依下載頁標示並核對套件內資訊。

2. Debian／Ubuntu：使用 apt 安裝本機 deb

Debian、Ubuntu 使用者安裝本機 deb 時，建議使用 apt install ./檔名.deb，讓套件管理器一併處理相依關係。請先在檔案管理器中將剛下載的 deb 重新命名為 shadowrocket.deb，確認目前目錄只有這次要安裝的目標檔案，再執行下方指令。重新命名只是方便輸入，不會改變套件內部名稱或架構。

dpkg-deb -f ./shadowrocket.deb Package Architecture
sudo apt update
sudo apt install ./shadowrocket.deb

在 Debian 系統中，第一行會讀取套件內的名稱與架構，不會執行安裝；第二行會更新已設定軟體來源的索引；第三行則安裝目前目錄中的本機檔案。./ 不可任意省略，否則 apt 可能會依套件名稱搜尋，而非開啟下載的檔案。輸入 sudo 密碼時，終端機通常不會顯示任何字元，這是正常現象。

• 顯示找不到檔案：先執行 pwd 和 ls -lh，確認終端機所在目錄、大小寫及實際副檔名。請勿將網頁網址直接當成本機檔案參數。
• 顯示無法滿足相依關係：記下缺少的相依項目名稱與版本限制，並檢查系統版本及軟體來源是否相符。不要為了完成安裝而加入其他發行版的軟體來源。
• 顯示架構不符：比對 dpkg-deb 的輸出與系統架構，重新選擇正確的檔案；執行權限無法解決架構問題。
• 顯示鎖定檔已被占用：確認系統更新程式或其他 apt 程序是否正在執行，並等待其完成。請勿直接刪除鎖定檔。

3. Fedora：使用 dnf 安裝本機 rpm

Fedora 使用者可使用 dnf 安裝下載至本機的 rpm。請將這次下載的檔案在本機重新命名為 shadowrocket.rpm，進入檔案所在目錄後，先讀取套件資訊，再執行安裝。其他使用 rpm 的系統若未採用 dnf，應依該發行版的套件管理流程操作，不要直接照搬 Fedora 指令。

rpm -qp --queryformat '%{NAME} %{ARCH}\n' ./shadowrocket.rpm
sudo dnf install ./shadowrocket.rpm

在 Fedora 上，rpm -qp 可查詢尚未安裝的套件檔案，並顯示其內部名稱與架構；dnf install 則負責安裝及相依性解析。看到確認清單後，請先檢查即將安裝、升級或移除的項目，再決定是否繼續。若出現大量與預期不符的移除項目，請停止操作並確認系統相容性。

在 Fedora 上，下載失敗、相依衝突與簽章提示應分開判斷。相依項目下載失敗時，通常要檢查系統軟體來源與網路；遇到相依衝突，則要查看具體套件名稱與版本限制；若出現來源或簽章相關提示，請確認檔案是否來自本站下載頁及系統政策，不要將略過檢查當成通用安裝步驟。

4. AppImage：新增執行權限後從終端機啟動

Linux 上的 AppImage 不透過 apt 或 dnf 安裝，但仍受處理器架構、系統程式庫、掛載方式與桌面環境限制。「免安裝」代表保留檔案即可啟動，不代表所有發行版都能直接執行。請將下載的檔案在本機重新命名為 Shadowrocket.AppImage，並放在目前使用者有寫入權限且允許執行程式的目錄中。

ls -l ./Shadowrocket.AppImage
chmod u+x ./Shadowrocket.AppImage
./Shadowrocket.AppImage

對 AppImage 執行 chmod u+x，可為檔案擁有者新增執行權限，是 chmod +x 的指定對象寫法。指令前的 ./ 代表執行目前目錄中的檔案；只輸入檔名時，終端機通常只會搜尋 PATH 中的目錄。首次從終端機啟動，有助於保留雙擊時無法看到的錯誤訊息。

若 AppImage 放在行動磁碟或共用資料夾，即使 ls -l 顯示可執行，也可能因掛載政策而遭到阻擋。可先將檔案移至使用者主目錄下允許執行的目錄，再試一次。請勿以遞迴修改整個下載目錄權限、授予所有使用者寫入權限，或關閉系統安全機制來取代錯誤診斷。

5. 首次啟動：區分安裝成功與連線可用

Linux 使用者看到 Shadowrocket 視窗，只能確認應用程式已啟動，不能據此認定代理連線可用。後續設定以使用者已有自己的服務商與訂閱為前提；本站不提供、不販售，也不推薦節點或訂閱。請先匯入已有設定，再檢查 Home 的連線狀態與 Global Routing；設定為空時，不要反覆重新安裝。

1. 從桌面應用程式清單開啟已安裝的應用程式；AppImage 則執行儲存的檔案。若出現系統權限要求，請先閱讀用途，再依實際操作授權。
2. 確認 Config 中目前使用的設定，以及使用者已有訂閱的匯入結果。範例網址 https://example.com/sub?token=xxxx 僅供說明格式，不能作為可用訂閱。
3. 返回 Home，檢查 SERVER 清單、目前選取的項目與 Global Routing。連線開關仍顯示 Not Connected 時，請先處理連線狀態。
4. 設定並建立連線後，再使用 Connectivity Test 檢查結果。測試逾時不代表 deb、rpm 或 AppImage 安裝失敗；請繼續檢查目標、網路與設定。

在提供 Global Routing 的介面中，Config、Proxy、Direct 與 Scene 是路由模式，不是安裝格式。以下比較僅適用於由應用程式接管的連線；系統流量是否進入應用程式，也取決於實際接管方式與權限。初次驗證時，請固定一個目標，每次只變更一項設定，避免同時修改模式、DNS 與訂閱，導致難以找出原因。

若介面顯示 Scene，請先檢查相對應場景的設定，再判斷實際行為；不要將 Scene 視為固定的全域代理或固定直連。若某個 Linux 版本的介面位置不同，請以目前應用程式中顯示的名稱為準；系統連線權限、應用程式路由與伺服器端連線狀況應分別檢查。

6. 更新與故障記錄：保留設定，避免重複安裝

Linux 使用者更新前，應先備份需要的設定資料，尤其是訂閱來源、手動填寫的伺服器參數與規則檔案。不要假設不同安裝格式一定共用相同的資料目錄，也不要將「刪除應用程式檔案」視為「刪除所有設定」。含 token、密碼或私密金鑰的內容應另行妥善保管，不要附在公開的故障記錄中。

• 更新 deb：從下載頁取得適用檔案，再執行本機 deb 安裝指令。讓套件管理器依套件內版本判斷是否升級，不要只憑檔名猜測更新關係。
• 更新 rpm：同樣使用 dnf 處理本機 rpm，並檢視交易摘要。若出現衝突，請保留原始錯誤訊息，不要強制覆寫系統檔案。
• 更新 AppImage：先結束正在執行的程式，備份設定後再替換檔案；新檔案需要重新檢查執行權限，桌面捷徑也可能需要修改目標路徑。
• 重複視窗或舊程式：檢查是否同時保留 deb、rpm 或 AppImage 的啟動項目。先確認目前執行的是哪個版本，再決定保留哪種安裝方式。

Linux 安裝問題的排查順序應為「檔案相符 → 套件管理或執行權限 → 應用程式啟動 → 設定與連線」。只有第一階段出錯時才重新選擇安裝檔；視窗正常開啟後，應優先檢查應用程式設定與網路，避免反覆解除安裝掩蓋真正問題。