官方手冊 · 疑難排解

Shadowrocket 疑難排解

依照現象找出問題:先確認購買與系統狀態,再檢查現有連線參數,最後檢查規則。每次只調整一項,並保留錯誤提示與原始設定。

首次設定可先閱讀快速入門;需要確認商店入口時,請查看下載指南。本頁僅說明如何使用使用者現有的訂閱或伺服器資訊。

共 20 個問題 · 點選問題展開答案 · 可同時展開多項比對

01 / App Store

正版確認與購買

先確認產品頁、購買帳號與裝置相容性。購買應用程式與取得連線資料是兩回事。

如何確認商店中的應用程式是正版 Shadowrocket?

請在產品頁核對三項資訊:開發者 Shadow Launch Technology Limited、與本站頁首相同的官方圖示,以及連結中的應用程式 ID 932747118。不要只憑應用程式名稱或搜尋結果的排序位置判斷;名稱相近或圖示相似,都不能取代開發者與應用程式 ID 的確認。確認三項資訊一致後,再查看目前商店顯示的價格與裝置相容性。Shadowrocket 唯一的取得管道是 App Store,購買與後續應用程式更新都在商店內完成。

換新 iPhone 或重新安裝後,需要再次購買嗎?

通常使用原購買 Apple 帳號,即可從 App Store 的已購項目記錄重新取得。先確認 Media & Purchases 目前登入的帳號,再到已購項目中尋找 Shadowrocket;購買所用帳號可能與裝置上用於 iCloud 的帳號不同。若顯示價格,而非重新取得的選項,請先檢查購買記錄、商店地區與訂單狀態,不要立即重複付款。重新取得應用程式與還原連線設定是兩回事;現有訂閱、Config 與自訂規則仍須從自己的備份還原。

購買應用程式後,就包含可用的連線嗎?

一次買斷用戶端 ≠ 線路方案。購買取得的是 Shadowrocket 應用程式的使用資格,連線仍須使用者已有的訂閱或伺服器資訊。首次開啟後,請先確認現有資料中的協定類型、位址、連接埠與認證欄位,再進行匯入;完成付款不會自動產生這些參數。本網站不提供、不販售,也不推薦節點或訂閱。價格請以 App Store 產品頁標示為準;若連線失敗,應分別確認應用程式的購買狀態與現有服務是否有效,不要混為一談。

iPad 可以安裝嗎?如何確認其他 Apple 裝置的相容性?

Shadowrocket 主要供 iPhone 與 iPad 使用。請先在目標裝置開啟同一個 App Store 產品頁,查看相容性與適用的購買範圍。在 iPad 上使用原購買帳號時,可先檢查已購項目記錄,再依商店提示取得應用程式。Mac、Apple TV、Apple Vision 是否適用,也請查看該產品頁的相容性欄位。系統需求以 App Store 頁面標示為準,不要因其他裝置可以安裝,就推斷目前裝置一定符合需求;不同裝置的畫面配置與操作入口也可能不同。

02 / Home & Settings

安裝與首次開啟

系統授權、應用程式介面與連線測試分別代表不同狀態,不能互相取代。

首次連線時為什麼會要求授權 VPN 設定?

Shadowrocket 需要透過系統網路延伸功能處理符合設定的流量,因此首次建立連線時會要求加入 VPN 設定。請確認提示視窗是由剛開啟的 Shadowrocket 觸發,再依系統提示授權並完成裝置身分驗證。若先前取消了要求,可回到應用程式重新發起連線。系統中的 VPN 狀態只表示網路延伸功能是否正在執行,不代表伺服器參數、認證或規則已驗證成功;授權完成後,仍須選取現有連線,並前往實際需要使用的目標進行檢查。

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

先確認 Home 中有有效的連線項目且已選取,再檢查首次 VPN 設定授權是否完成。開啟系統 Settings,查看 VPN 設定狀態;若裝置受到組織管理或家長監護限制,請確認相關管理規範。同時檢查是否有其他 VPN 連線正在執行,避免反覆切換。保留現有設定後,重新開啟應用程式再試一次;若開關仍立即關閉,請記錄當時的系統提示與日誌,不要先刪除所有設定,以免失去排查問題所需的原始資訊。

介面是英文,Home、Config、Data、Settings 各自代表什麼?

依照要執行的工作尋找入口,不要逐字猜測。Home 用來查看與選取現有連線,Add Server 用來新增連線參數;Config 著重於設定檔與規則,Data 用來查看流量相關記錄,Settings 則是應用程式設定。Global Routing 中的 Config 是連線模式選項,與設定檔入口用途不同。不同裝置或應用程式的介面配置可能有差異,請以畫面實際顯示的英文標籤為準。遇到問題時,記下入口名稱與所選項目,比只描述按鈕位置更容易重現問題。

Connectivity Test 有測試結果,就代表所有網站都能存取嗎?

不能只憑 Connectivity Test 的結果判斷所有連線請求。測試只涵蓋其使用的目標、方法與當時的網路條件;實際存取還會受到網域解析、Global Routing、命中規則與目標服務狀態影響。先選定同一個連線,執行測試後再前往實際目標;若兩者結果不同,請查看該請求所套用的策略與日誌。不要把測試結果直接當成下載速度,也不要只因某次測試失敗就立刻修改所有參數;應先確認測試目標本身是否可連線。

更新應用程式前,如何保留現有設定?

應用程式更新透過 App Store 完成。操作前,先確認仍可從自己的安全記錄中取得現有訂閱網址與必要的伺服器資訊,並備份目前使用的 Config 和自訂規則。若使用 iCloud 相關同步功能,請確認內容已同步到目前裝置,不要把開啟同步開關當成已完成備份。更新後先檢查連線項目、所選設定檔與 Global Routing,再建立連線。不要只為排查介面變動就先刪除應用程式;重新安裝不代表所有本機資料都會自動還原。

03 / Subscribe & Add Server

訂閱與連線資料匯入

以使用者現有的連線資料為前提,分別檢查網址、回傳內容、協定欄位與更新結果。

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

先確認複製的是使用者現有的完整訂閱網址,而不是帳號管理網頁或說明頁;檢查網址前後是否有空格、換行或遺漏查詢參數。接著確認裝置目前的網路可以連線至該網址,再檢查現有服務是否有效,以及回傳內容是否為 Shadowrocket 可辨識的訂閱格式。記錄應用程式顯示的錯誤訊息,區分請求失敗、認證失敗與內容解析失敗。排查時一次只修改一項;訂閱網址可能包含身分憑證,向他人說明問題時請遮蔽敏感內容,不要公開完整連結。

如何更新 Subscribe?更新後還要檢查什麼?

在 Home 找到現有的 Subscribe 群組,使用該群組提供的更新功能;入口位置請以實際介面為準。更新前確認目前的網路可以取得訂閱內容,更新後檢查群組中的項目是否已更新,以及原先選取的連線是否仍存在。訂閱更新處理的是遠端提供的連線資料,不等於更新 App Store 應用程式,也不一定會更新目前 Config 中的所有規則。若更新後項目減少或變成空白,先檢查提示訊息與回傳內容,不要連續刪除並重建多個相同群組。

Scan QR Code 無法辨識,只能重新輸入嗎?

先確認系統已允許相機存取,再檢查 QR Code 是否完整、清晰且未被反光遮住。QR Code 必須包含可辨識的連線資訊;一般網頁、帳號登入或付款用的 QR Code,不能直接當作伺服器參數匯入。若 QR Code 由自己的現有服務提供,可重新顯示原始圖片後再試,避免使用經壓縮的截圖片段。仍無法辨識時,可改用現有連線連結,或在 Add Server 填寫參數。匯入後還要核對 Type、Address、Port 與認證欄位;掃碼成功不代表連線一定可用。

使用 Add Server 手動新增時,哪些欄位最容易填錯?

先選擇與現有伺服器資訊相符的 Type,再逐項填入 Address、Port 及該協定要求的認證欄位。Address 通常只填主機名稱或位址,不要混入網頁路徑;Port 應與伺服器端設定一致。Shadowsocks 的加密方式、VMess 或 VLESS 的 UUID,以及 Trojan 的 Password 不能互相替代。若使用 TLS,也要核對 SNI、憑證驗證與傳輸設定。儲存前檢查複製內容前後是否有空格,不要用停用憑證驗證的方式掩蓋網域或參數錯誤。

Config 設定檔和 Subscribe 訂閱有什麼差異?

Subscribe 通常用來維護一組現有連線項目,更新時會依遠端內容重新整理;Config 則用來組織規則、策略與相關設定。實際包含哪些項目取決於檔案內容,不能只憑連結名稱判斷。匯入訂閱後,還要檢查目前使用哪個 Config,以及 Global Routing 是否選擇 Config;反過來,匯入規則檔也不代表已具備完整的伺服器參數。修改前先備份原有設定,分別確認連線資料與規則的來源,避免把訂閱更新當成全面取代所有本機設定。

04 / Global Routing

規則分流與故障排查

從基礎網路到連線參數,再到規則命中。系統顯示已連線,不代表所有請求都能完成。

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

Config 會依目前設定檔中的規則決定請求策略;Proxy 會讓一般可處理的請求使用所選代理連線;Direct 則採用直接連線。日常需要規則分流時,先確認 Config 與規則是否正確。排查問題時,可以短暫切換 Proxy 與 Direct,使用同一個目標比較結果,協助判斷是連線問題還是規則問題,但不要同時更換伺服器與設定檔。測試結束後,請恢復預期模式,並留意介面中的 Proxy 模式與規則策略 PROXY 屬於不同層級的設定。

顯示已連線卻無法上網,該先檢查哪些項目?

先暫時中斷 Shadowrocket,確認裝置原本的網路能否連線至正常目標;若基礎網路異常,先處理 Wi-Fi 或行動網路。接著重新連線,檢查所選項目的有效狀態與參數,再確認 Global Routing 和目前的 Config。使用同一個目標,分別觀察 Direct 與 Proxy 下的結果,再查看日誌中的解析錯誤、連線失敗或認證提示。顯示已連線只代表系統網路延伸功能正在執行,不保證已成功連上遠端。保留錯誤資訊,每次只調整一項,避免同時修改 DNS、規則與伺服器,導致無法判斷原因。

只有某個網域套用了錯誤策略,該如何調整規則?

先確認 Global Routing 設為 Config,並核對目前使用的設定檔。規則會由上而下比對,命中第一條後即停止;針對單一網域的 DOMAIN 例外,應排在涵蓋範圍更大的 DOMAIN-SUFFIX 或 DOMAIN-KEYWORD 之前。接著檢查策略是否為預期的 PROXY、DIRECT 或 REJECT,以及最後一條 FINAL 的預設處理方式。不要以為只要在清單末尾新增一條規則就會生效;若前面的廣泛規則已命中,後面的例外就不會再進行比對。

使用後耗電增加,如何判斷是否與設定有關?

先查看系統 Settings 中同一時段的電池使用記錄,區分螢幕使用、持續傳輸與背景活動。耗電量會受到流量大小、訊號強度、協定處理、日誌記錄與反覆重新連線影響,不能只因狀態列顯示 VPN 圖示就下結論。在相近的使用條件下,分別減少持續測試、過於詳細的日誌與不必要的背景工作,再觀察變化。若連線頻繁中斷,應先檢查網路與參數;也要確認 On Demand 的連線觸發條件,不要靠反覆切換開關來評估耗電量。

On Demand 為什麼在手動中斷後又重新連線?

On Demand 用來依設定條件觸發連線,並不是決定某個網域使用 PROXY 或 DIRECT 的規則。啟用後,符合條件的網路活動可能再次發起連線,因此手動中斷後,應同時檢查 On Demand 是否仍開啟,以及系統 VPN 設定中的相關狀態。若只是暫時排查問題,可先記錄原有條件,再暫停對應的觸發設定進行測試;確認原因後,恢復需要的行為。也請檢查是否有其他自動化操作,避免把條件觸發誤認為連線開關故障。