本文重點

在執行 Linux 桌面的電腦上,先確認發行版與處理器架構。Debian、Ubuntu 優先選擇適用於目前系統的 deb;Fedora 優先選擇適用於目前系統的 rpm。若不需要透過套件管理器登錄程式,且系統符合執行條件,也可以選 AppImage。下文將說明安裝或啟動方式,以及如何分辨相依性錯誤、執行權限問題與連線問題。

選擇安裝套件:先確認發行版,再確認架構

在要執行 Shadowrocket 的電腦上開啟終端機。如果使用虛擬機器,請在虛擬機器內執行命令,不要用主機的資訊選擇套件。第一個命令會列出系統名稱與發行版識別資訊;第二個命令會顯示目前系統回報的機器架構。

grep -E '^(PRETTY_NAME|ID|ID_LIKE)=' /etc/os-release
uname -m
系統或需求優先考慮的格式安裝前確認
Debian、Ubuntudeb套件適用於目前的發行版,且所需相依套件可從目前的軟體來源取得
Fedora 等使用 DNF 的發行版rpm套件明確適用於目前系統;副檔名相同,不代表可以在不同發行版之間混用
不想將程式登錄到系統套件管理器AppImage套件架構相符、存放位置允許執行,且系統符合執行條件

x86_64 在 deb 的架構標示中通常寫作 amd64;aarch64 通常對應 arm64。這是架構名稱的對應關係,不代表下載頁一定提供每種架構的版本。請選擇 Linux 下載區實際列出且適用於你系統的安裝套件。若只提供另一種架構,請勿藉由修改檔名或強制安裝來處理。ID_LIKE 只能提示發行版家族,不能取代相容性說明。

安裝 deb、rpm 或啟動 AppImage

以下命令以 Bash 為例。先在檔案管理器中找到已下載的檔案,再執行對應的程式碼區塊。終端機出現提示時,貼上以 / 開頭的完整檔案路徑,不必手動加上引號。三種格式擇一即可,不必依序執行。

  1. 找到安裝套件

    開啟瀏覽器的下載清單,從該筆紀錄開啟檔案所在的資料夾。確認下載已完成,並分辨正式安裝套件與暫存下載檔。使用檔案管理器提供的複製路徑功能,避免漏掉副檔名,或誤選架構不同但檔名相同的檔案。

  2. 使用 APT 安裝 deb

    apt install 接受本機 deb 路徑,並會嘗試從已設定的軟體來源補齊相依套件。確認交易摘要中的新增、升級與移除項目後再繼續;若出現大量與安裝目的無關的移除項目,請先取消。

    read -r -p '輸入 deb 檔案的完整路徑:' pkg
    sudo apt install -- "$pkg"
  3. 使用 DNF 安裝 rpm

    dnf install 會讀取本機 rpm,並從已啟用的套件庫解析相依套件。請勿加入自動確認參數;先檢查 DNF 預計執行的交易。若遇到衝突,記下錯誤列出的套件名稱,不要改用略過相依性檢查的方式安裝。

    read -r -p '輸入 rpm 檔案的完整路徑:' pkg
    sudo dnf install -- "$pkg"
  4. 執行 AppImage

    將檔案放在自己擁有且允許執行程式的資料夾,以一般使用者權限加上執行權限後啟動。AppImage 本身就是啟動檔;若終端機回報錯誤,請先保留輸出內容,不要改用 sudo 重試。

    read -r -p '輸入 AppImage 檔案的完整路徑:' pkg
    chmod +x -- "$pkg" && "$pkg"
  5. 確認視窗已開啟

    deb 或 rpm 安裝成功後,可在桌面應用程式清單中搜尋 Shadowrocket;AppImage 則從儲存位置啟動,不一定會自動新增選單項目。視窗能開啟,只代表安裝或啟動步驟已完成。節點與訂閱請向你的服務商取得;請在完成設定後再測試網路。

安裝後的啟動、更新與移除

安裝格式會決定由誰管理程式檔案。開始排查前,先確認目前啟動的是由套件管理器安裝的程式,還是單獨儲存的 AppImage。若兩種方式都試過,請先關閉正在執行的視窗,再從明確的入口啟動,避免將舊檔案的狀況誤認為新套件的問題。

deb / rpm

安裝紀錄
由系統套件管理器登錄
查詢套件名稱
對本機檔案使用 dpkg-deb -f "$pkg" Package 或 rpm -qp --queryformat '%{NAME}\n' "$pkg"
更新方式
本機安裝不代表已設定更新套件庫;需要手動更新時,請使用適用於目前系統的新套件
移除方式
使用 sudo apt remove 或 sudo dnf remove,並在後面加上查得的套件名稱;確認交易內容後再執行

移除時使用套件名稱,而非下載檔名;刪除下載套件也不會解除安裝已安裝的程式。

AppImage

啟動方式
已設定執行權限的 AppImage 檔案
檔案位置
保留在允許執行的個人資料夾中,避免長期放在可能遭清理的暫存資料夾
更新方式
關閉舊程式,為新檔案加上執行權限,確認能開啟後再清理舊檔案
移除方式
關閉程式後移除 AppImage 檔案;如果曾手動建立捷徑,也一併移除舊的啟動入口

刪除啟動檔不等於刪除個人設定。更換套件進行排錯時,請先保留設定,避免同時改變兩個條件。

常見安裝錯誤:依終端機提示排查

APT 顯示無法處理此檔案時,先檢查什麼?

先確認輸入的是完整檔案路徑,而不是瀏覽器中的下載網址。保留剛才輸入的路徑於 pkg,並使用 file -- "$pkg" 查看檔案類型。若結果顯示為 HTML 文件,代表取得的是網頁內容而非 deb;請回到下載頁重新下載,修改副檔名無法解決問題。

顯示架構不符或 Exec format error,該怎麼辦?

重新執行 uname -m,核對下載項目的架構標示。deb 可使用 dpkg-deb -f "$pkg" Architecture 查看套件標頭;rpm 可使用 rpm -qp --queryformat '%{ARCH}\n' "$pkg" 查看。若架構選錯,請改用相符的套件;若架構一致,請繼續檢查檔案類型與下載是否完成。

顯示缺少相依套件,需要更換軟體來源嗎?

先記下錯誤中第一個無法滿足的相依套件名稱與條件,並確認安裝套件適用於目前的發行版。Debian 或 Ubuntu 可先執行 sudo apt update 更新軟體來源索引;使用 DNF 時,可執行 dnf repolist --enabled 確認已啟用的套件庫。若目前發行版的正常軟體來源仍無法滿足相依條件,請勿混用其他發行版的軟體來源。

AppImage 已加上執行權限,為何仍顯示 Permission denied?

使用 ls -l -- "$pkg" 確認目前使用者是否有權執行檔案,再使用 findmnt -no OPTIONS --target "$pkg" 查看所在檔案系統的掛載選項。若出現 noexec,請將檔案移到允許執行的個人資料夾,更新路徑後再試。不要為單一應用程式變更整個磁碟的掛載設定。

AppImage 顯示缺少 libfuse.so.2,但系統已有 FUSE,該怎麼辦?

此錯誤指向 FUSE 2 的使用者空間程式庫;已安裝 FUSE 3 不代表系統也有 libfuse.so.2。請在目前發行版的軟體來源中尋找提供此程式庫的相容套件,並確認安裝交易不會移除系統既有元件。若沒有適用的相容套件,建議改用下載頁列出且適用於目前系統的 deb 或 rpm。

視窗已開啟但網頁無法連線:分辨路由與安裝問題

視窗能正常開啟後,不要透過重新安裝來測試網路。先確認使用一般網路連線時能否開啟同一個測試網頁,再檢查目前用戶端中的 Global Routing。以下對照適用於介面提供這些選項的情況;切換時請保持測試網頁與其他設定不變。

Config

建議

依目前設定的規則選擇策略。測試時,選擇一個已知會符合代理規則的網址,再選一個預期直接連線的網址。僅憑直接連線的網址能開啟,無法判斷代理線路是否可用。

適用情境:完成設定後,分別驗證代理與直接連線規則。

Direct

讓用戶端處理的流量直接連線,不經過代理線路。如果同一個網址在 Direct 下能開啟、在 Config 下卻失敗,接下來應檢查符合的規則與所選策略,而不是更換安裝套件格式。測試結束後,請恢復原本的路由選項。

適用情境:以同一個測試網址建立直接連線的對照。