官方手冊 · 問題索引

Shadowrocket 常見問題

依取得、安裝、匯入和連線四個階段查找問題。先確認裝置及錯誤發生的步驟,再依答案逐項檢查;每次只變更一項設定,並保留原設定以便還原。

以下問答可直接展開閱讀,不需使用指令碼。完整操作流程請見快速入門;各平台下載入口請見全平台下載頁。

正版核對與購買

先確認平台、商店地區及購買紀錄。

電腦和 Android 可以使用 Shadowrocket 嗎?各平台如何取得?

可以。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片版和 Intel 版。先前往全平台下載頁選擇裝置;iPhone / iPad 會前往 App Store 產品頁,其他平台的安裝檔可從本站 /dl/shadowrocket/ 路徑取得。一次買斷 App 不等於包含連線服務;使用連線功能前,仍須備妥自己已有的訂閱或伺服器資訊。

iPad 可以安裝嗎?如何查看手機和平板的系統需求?

iPad 可以安裝 Shadowrocket。iPhone / iPad 版在 App Store 一次性付費 $2.99,兩種裝置皆可使用;Mac / Windows / Android / Linux 版免費。手機和平板的系統需求請以 App Store 產品頁標示為準,安裝前查看相容性資訊。同一購買帳號的其他相容裝置,可在已購項目中尋找;若顯示購買價格,先確認商店登入帳號及購買紀錄,勿直接再次確認付款。

如何確認 App Store 上的 Shadowrocket 是正版?

請一併確認 App 名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。可將圖示與本站頁首的官方圖示比對,並在產品頁網址中核對 App ID;不要只憑搜尋結果中的名稱判斷。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。商店價格與電腦、Android 下載入口是不同的取得方式。

為什麼在 App Store 搜尋不到 Shadowrocket?

先開啟本頁提供的 App Store 產品頁,確認是搜尋不到,還是目前商店地區無法下載。中國大陸商店未提供此 App;商店地區由購買帳號設定決定,不受裝置顯示語言影響。可在系統設定的帳號頁面進入「媒體與購買項目」,查看帳號的「國家或地區」。若確實需要變更,請依該頁面的地區變更流程辦理,並先確認餘額、訂閱及付款方式等條件;若只是排查問題,不必立即變更地區。

換機或重新安裝後,需要再買一次嗎?

iPhone / iPad 使用原購買帳號時,先在 App Store 帳號頁面的 App 或已購項目中尋找 Shadowrocket,再點選雲朵下載按鈕。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。重新下載 App 不代表 App 內資料也會還原:移轉前請另外備份自己的設定與連線資訊。電腦和 Android 重新安裝時,可回到本站下載頁取得安裝檔;匯入資料前先確認備份可正常使用。

家人共享可以讓家庭成員安裝嗎?

先查看 App Store 產品頁目前的家人共享說明,再確認家庭群組是否已開啟購買項目共享,以及成員帳號地區是否符合商店規定。符合條件時,家庭成員可從家庭購買紀錄中尋找 App,不必交換帳號密碼。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。共享購買資格不會自動共享 App 內的訂閱連結、設定檔或伺服器憑證。

安裝與首次開啟

確認架構和來源,再處理系統提示。

Mac 應選 Apple 晶片版還是 Intel 版?

開啟 Mac 的 Apple 選單,選擇「關於這台 Mac」:若顯示「晶片」及 Apple 系列名稱,請選 Apple 晶片版;若顯示 Intel 處理器,請選 Intel 版。不要依電腦外觀、購買年份或瀏覽器判斷結果猜測處理器架構。兩種版本都可從本站下載頁取得。安裝後若系統阻止開啟,先確認安裝檔來源及架構,再依本分類的 macOS 放行步驟處理;更換架構前請先備份既有設定。

Windows 顯示風險提示或 SmartScreen 阻止執行時怎麼辦?

先確認安裝檔來自本站下載頁,實際下載網址位於本站 /dl/shadowrocket/ 路徑,並確認裝置允許自行安裝 App。出現 SmartScreen 提示時,可展開「更多資訊」,確認要執行的檔案後選擇「仍要執行」。這不代表應關閉整個系統的防護。若沒有這個按鈕,或裝置由公司或機構管理,請停止操作並聯絡裝置管理員;來源不明、檔名異常或明確偵測為威脅的檔案,切勿強行放行。

Mac 顯示無法驗證開發者或 App 已損毀,該如何處理?

先確認安裝檔來自本站下載頁,且架構正確。若顯示無法驗證開發者,可先嘗試開啟一次,再進入系統設定的「隱私權與安全性」,找到相應的阻擋紀錄並選擇「仍要打開」。若顯示 App 已損毀,先重新下載並安裝;確認來源無誤後,可在終端機執行 xattr -cr /Applications/Shadowrocket.app,再嘗試開啟。此命令會清除指定 App 的延伸屬性,無法修復實際損毀;路徑必須符合實際安裝位置,勿對整個磁碟執行。

Android 安裝遭到阻止,或在微信點選下載沒有反應,該怎麼辦?

先複製本站下載頁網址,並用系統瀏覽器開啟,再下載 Android 安裝檔。若系統要求授權,請只在設定中為實際用來開啟安裝檔的瀏覽器或檔案管理員啟用「允許安裝未知應用」;安裝完成後可關閉此選項。裝置架構須符合下載頁的說明。若仍無法安裝,請檢查儲存空間、檔案是否下載完整,以及裝置管理限制;不要為了繞過明確的威脅提示而關閉所有安全檢查。

Linux 的 deb、rpm、AppImage 該如何選擇?

依發行版使用的套件格式選擇:Debian、Ubuntu 系列通常使用 deb,Fedora 等通常使用 rpm;不確定時,先查看系統說明及下載頁的適用條件。下載 AppImage 後,須為實際檔案新增執行權限,再從終端機啟動以查看錯誤訊息。安裝 deb 或 rpm 時,建議使用發行版的軟體安裝程式,由系統處理相依套件。若架構不符或缺少相依套件,應先處理具體錯誤,不要反覆以不同格式覆蓋安裝。

介面是英文,建議先查看哪些項目?

本手冊保留介面英文原文,方便逐項對照。Home 用來查看既有連線資料,Add Server 用來新增伺服器,Subscribe 用於訂閱相關操作,Config 用於設定檔,Global Routing 用來選擇路由模式,Settings 集中其他設定。不同平台和版本的入口位置可能不同,請依名稱尋找。先完成匯入、選擇模式及連線測試,再逐步了解 On Demand 等自動連線設定;不必為了跟著教學操作而先變更系統語言。

訂閱與節點匯入

以下操作須以已有自己的連線資料為前提。

首次匯入前需要準備哪些資料?

請準備自己已有的訂閱連結,或伺服器位址、連接埠、協定、驗證資訊,以及相應的 TLS、SNI 等參數。訂閱連結和單一伺服器分享連結並非同一種資料,請選擇相符的匯入方式;手動填寫時,進入 Add Server 並先選擇協定。範例網址 example.com 僅供說明格式,無法用於實際連線。本站不提供、販售或推薦節點或訂閱,也不會接收使用者完整的連線憑證。

Shadowrocket 訂閱匯入失敗,應依什麼順序檢查?

先檢查連結是否完整、有沒有多出空格、換行或聊天訊息中的標點,再確認它是供 App 使用的訂閱網址,而不是登入頁面。接著確認目前網路可以連到訂閱網址,且訂閱仍有效。若回傳的是網頁、驗證提示或空白內容,請向原資料提供者確認連結狀態及支援格式。排查時只記錄錯誤類型;不要將含有存取憑證的完整連結貼到公開截圖、搜尋框或回報內容中。

Scan QR Code 掃描成功後,為什麼還是無法使用?

掃描成功只代表已讀取 QR Code 內容,不表示其中的伺服器參數有效。先確認 QR Code 包含伺服器分享資訊或受支援的訂閱內容,而非一般網頁網址。匯入後檢查協定、位址、連接埠及驗證欄位是否完整,再確認有效期限及服務狀態。相機無法辨識時,可改善光線或改用清晰的原始圖片;不要為了方便辨識,就把含有連線憑證的 QR Code 上傳到公開辨識網站。

如何更新既有訂閱?為什麼更新後清單沒有變化?

在 Home 找到原有訂閱項目,使用該項目的更新功能,不要一再將同一連結當成新訂閱加入。更新前保留必要的備份,更新後確認有無錯誤,以及清單排序或篩選是否隱藏了變化。即使成功取得訂閱內容,也可能與上次相同,因此清單沒有變化不一定代表更新失敗。若出現驗證或存取錯誤,先確認原訂閱網址仍有效;反覆重新整理無法修復已失效的連結。

多個訂閱出現重複項目,如何整理才不會誤刪?

先為不同來源的訂閱設定容易辨認的備註,再確認哪些項目來自訂閱、哪些是手動新增。更新後若出現重複項目,先檢查是否重複匯入同一個訂閱;不要只看節點名稱判斷,因為名稱相同的項目可能使用不同位址或協定。備份後再刪除多餘的訂閱來源,並確認目前選取的項目仍存在。訂閱產生的清單應盡量透過原訂閱管理,以免下次更新覆蓋手動整理的結果。

匯入訂閱和匯入 Config 設定檔有什麼不同?

訂閱通常用於更新伺服器清單;Config 設定檔則可能包含規則、DNS 及策略設定,兩者用途不能互相取代。已有伺服器清單,不代表已啟用適合自己的規則設定。匯入 Config 前,先閱讀內容並備份目前設定,特別檢查規則比對順序、策略指向及 DNS 設定;接著前往 Global Routing 選擇 Config 進行測試。不要直接用陌生設定檔覆蓋目前使用的設定,也不要一次變更多個項目後才開始排查問題。

規則分流與問題排查

先測試基本網路,再分辨伺服器、規則與 DNS 問題。

連線開關無法開啟,或開啟後立刻關閉,該怎麼辦?

首次連線時,系統會要求允許新增 VPN 設定檔;如果先前取消了,請重新發起連線並依系統提示確認。接著檢查 Home 是否選取有效的伺服器,以及系統是否有其他 VPN 或裝置管理政策占用連線。先關閉衝突的連線,再單獨測試 Shadowrocket。若開關立刻關閉,請記錄當時的系統提示和 App 錯誤,必要時重新啟動裝置;未備份前不要先刪除所有設定,也不要移除由公司或機構管理的設定。

顯示已連線,卻無法上網,應先檢查什麼?

先中斷連線,確認目前的 Wi-Fi 或行動網路本身可以瀏覽常用網站;需要網頁登入的網路,請先完成驗證。重新連線後,分別測試多個目標,以區分單一網站異常和所有請求都失敗。短暫將 Global Routing 切換至 Proxy,有助判斷問題是否與規則有關;測試後請恢復原模式。若仍無法連線,請檢查伺服器是否有效、驗證參數及 DNS,並改用另一個網路比對。系統顯示 VPN 已連線,只表示通道已建立,不代表遠端服務一定可用。

Global Routing 的 Config、Proxy、Direct 三種模式該怎麼選?

Config 會依目前設定檔中的規則決定流量走向,適合已確認規則後日常使用;Proxy 會依此模式將流量交由選取的代理處理,適合短時間比對排查;Direct 則使用直接連線。切換模式無法修復伺服器驗證錯誤,也不能取代有效的連線資料。測試時保持伺服器和網路不變,每次只切換一種模式,記錄同一目標的結果,再恢復預期設定。

連線後耗電增加,該如何排查 On Demand?

先查看系統電池用量統計,區分前景使用、背景連線及其他 App 產生的網路活動;不要只看單一百分比就判定異常。持續下載、頻繁重新連線、詳細記錄及網路切換都可能增加耗電。可暫時停用 On Demand,手動維持一次穩定連線,並在相同使用條件下觀察變化;之後再依實際需求設定自動連線條件。排查時一次只變更一個項目,結束後關閉不再需要的診斷記錄,並檢查是否有持續失敗的連線請求。

Connectivity Test 有測試結果,為什麼實際瀏覽仍然失敗?

Connectivity Test 的結果只反映當次使用的測試方法和目標,不能代表所有網站、協定及持續傳輸都正常。先確認實際請求使用的是同一台伺服器,再檢查目標網域比對到的規則及 DNS 解析結果。若只有部分目標失敗,檢查相應規則、遠端服務和目標網站;若全部失敗,則回頭排查網路、驗證資訊及伺服器狀態。比對結果時應使用相同網路和測試目標,不要只憑單次延遲數字判斷服務是否可用。

如何判斷是否為 DNS 問題,並保留有用的排查資訊?

若錯誤訊息與網域解析有關,先檢查目前 Config 的 DNS 設定、系統網路是否需要登入驗證,以及問題是否只發生在特定網路。不要一開始就同時更換 DNS、伺服器及規則,否則無法確認是哪個變更造成影響。記錄裝置系統、網路類型、Global Routing 模式、問題發生步驟及已去識別化的錯誤內容,再對照快速入門的驗證步驟。分享記錄前,請刪除訂閱網址、密碼、存取憑證,以及含有這些資訊的 QR Code。