Official Manual / FAQ

Shadowrocket 常見問題

依購買、首次開啟、匯入現有設定與連線排查分類。先確認問題發生在哪個步驟,再逐項檢查;每次只更改一項設定,並保留可供比對的測試結果。

App Store / Purchase

正版確認與購買

確認產品頁、購買帳戶與相容性,再處理不同裝置間的還原問題。

App Store 搜尋不到 Shadowrocket,該先檢查什麼?

先從取得應用程式頁面開啟 App Store 產品頁,排除搜尋字詞或搜尋結果造成的影響。如果顯示目前所在國家或地區無法使用,請確認「媒體與購買項目」所用 Apple ID 的國家或地區;再檢查「螢幕使用時間」中的內容與隱私權限制,確認未限制此 App 的年齡分級。如需更改地區,請依系統設定中的官方路徑操作:Apple ID → 媒體與購買項目 → 檢視帳號 → 國家或地區,並先處理帳戶餘額、訂閱及付款條件。實際供應情況以商店當下顯示為準。

如何確認開啟的是 Shadowrocket 正版產品頁?

請一併核對產品名稱 Shadowrocket、開發者 Shadow Launch Technology Limited,以及產品頁網址中的 App ID 932747118,並比對本站頁首使用的官方 App 圖示。名稱或圖示相似,都不能單獨作為判斷依據。購買前也請展開相容性、價格與購買適用範圍說明,確認適用於目前的裝置與帳戶。Shadowrocket 是付費閉源商業 App,唯一取得管道為 App Store;詳細核對步驟請參閱取得應用程式頁面。

購買 Shadowrocket 後就能直接連線嗎?

一次買斷 App 客戶端 ≠ 購買線路方案。購買後取得的是 Shadowrocket 客戶端的使用資格,不會自動提供可連線的伺服器資訊。後續操作須以使用者已有自己的訂閱或伺服器資訊為前提:先確認設定來源與有效狀態,再完成匯入、選取預設伺服器及系統授權。本網站不提供、不販售、不推薦節點、訂閱或相關服務。App 價格與購買條件以 App Store 頁面標示為準;連線所用設定是否有效,則須另外確認。

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

先確認 App Store 中「媒體與購買項目」所用帳戶是否與原購買帳戶相同,再前往帳戶的已購 App 清單尋找 Shadowrocket,並開啟產品頁確認是否顯示重新下載選項。裝置登入的 iCloud 帳戶可能與商店購買帳戶不同,不能只看設定頁面頂端的帳戶名稱。如果仍顯示價格,請先檢查購買記錄與目前的商店地區,不要急著再次付款。跨裝置購買適用性與家人共享資格,以 App Store 頁面標示為準;重新下載 App 不代表本機設定也會還原。

iPad 可以安裝嗎?如何確認 Mac 與 Apple TV 的相容性?

Shadowrocket 主要供 iPhone 與 iPad 使用,iPad 也須從 App Store 產品頁取得。請先在商店的相容性欄確認裝置與系統要求,再確認目前的購買帳戶是否已有購買記錄。Mac、Apple TV 與 Apple Vision 的相容性也請查看同一產品頁;系統要求及是否適用通用購買,一律以 App Store 頁面標示為準。請勿將某部裝置上的可用狀態直接套用到其他裝置;連線設定與伺服器允許的同時使用裝置數,也須分別確認。

Home / First Connection

安裝與首次開啟

分開檢查系統授權、伺服器選取與實際連線,不要將開關狀態視為最終結果。

首次開啟時,系統提示加入 VPN 設定是什麼意思?

這是系統建立網路連線設定時顯示的授權提示。請先確認操作的是已核對過的 Shadowrocket,且已有可用的伺服器設定,再依系統提示允許加入;必要時輸入裝置密碼或完成生物辨識驗證。加入成功只代表系統允許建立連線,不代表伺服器已可使用,也不代表所有流量都會採用相同策略;實際連線路徑也會受到 Global Routing 與 Config 規則影響。授權後返回 Home,選取伺服器,再使用 Connectivity Test 進行驗證。

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

先確認 Home 中已有伺服器,並點選一項作為預設伺服器,查看左側是否出現選取圓點。接著確認系統加入 VPN 設定的授權已完成,並檢查裝置上是否有其他正在使用的 VPN 連線。如果是公司或學校管理的裝置,也請檢查管理政策是否限制 VPN。先停止其他連線再試一次,並記下彈出視窗的原文或 Log 中的錯誤訊息。不要連續刪除所有設定;只有確認系統設定異常且已完成備份後,才考慮重新加入授權設定。

介面顯示英文,需要更改手機語言嗎?

不必為了對照教學而立刻更改整部裝置的語言。本網站依照 App 中的英文介面名稱說明操作,例如 Home、Add Server、Config 與 Settings,請先依這些名稱尋找功能。若想調整顯示語言,可到系統設定中的 Shadowrocket App 設定頁查看是否提供語言選項;實際可選項目以目前 App 與系統顯示為準。更改語言不會補齊伺服器參數,也無法修復連線問題。若手冊中的入口與畫面不同,請先確認所在頁面與操作項目,再對照設定手冊。

如何確認首次連線已完成,而不只是開關已開啟?

請分三個層次檢查:Home 已選取預設伺服器、系統已建立連線,以及 Connectivity Test 對測試目標回傳可用結果。接著再開啟實際要使用的網頁或 App,確認目標也能正常運作。開關開啟只表示連線程序已啟動或通道已建立,不能取代實際目標的連線驗證。測試時固定使用同一台伺服器、同一個網路與同一種 Global Routing 模式,避免同時更動多個變因;若只有部分目標連線失敗,應優先檢查規則與 DNS,而非重複加入系統授權。

持續連線會耗電嗎?On Demand 該如何設定?

耗電量會受到實際流量、無線網路品質、伺服器重新連線頻率、測試頻率與記錄 Log 等因素影響,不能只憑連線圖示判斷。請先在系統電池頁面觀察相近使用時間下的耗電變化,再減少重複測速及不必要的詳細 Log。On Demand 用於依條件觸發連線,不是固定的省電開關;啟用前請先確認手動連線穩定,再逐項設定條件。如果手動中斷後又自動連線,請先檢查 On Demand 是否啟用及其符合條件。

Subscribe / Add Server / Config

訂閱與節點匯入

以下操作均以使用者已有自己的訂閱或伺服器資訊為前提。匯入前先分辨內容用途,更新前保留可還原的設定。

已有訂閱匯入失敗,如何分辨是連結還是格式問題?

先確認複製的是服務提供者給的訂閱網址,而非帳戶登入頁或說明頁網址,並檢查是否混入空格、換行或中文標點。接著確認目前網路能否連上該網址,以及服務是否有效。如果伺服器回傳登入頁、錯誤頁或空白內容,即使網址能開啟,也無法解析為訂閱。網路連線正常但仍無法辨識時,再向原設定提供者確認輸出格式是否與 Shadowrocket 相容。回報錯誤時請遮蔽完整網址中的帳戶資訊,不要公開原始訂閱網址。

手動填寫 Add Server 時,哪些欄位最容易填錯?

先確認 Type 與現有伺服器資訊中的協定一致,再逐項核對位址、連接埠與驗證欄位。Shadowsocks、VMess、VLESS、Trojan 等協定所需欄位各不相同,不能將一組參數原樣填入另一種 Type。若涉及 TLS 或傳輸設定,也要核對伺服器端提供的名稱與路徑,並保留原有大小寫及字元。連接埠請使用提供者給的數字;位址欄位不要加入多餘路徑。儲存後先選取該伺服器進行測試,不要只憑成功儲存就認定填寫正確。

Scan QR Code 掃描成功,卻沒有可用伺服器,該怎麼辦?

辨識 QR Code 只代表讀取到其中的內容,不一定表示內容是 Shadowrocket 支援的伺服器資訊。先確認 QR Code 來自使用者已有的設定,且內容是伺服器或訂閱資訊,而不是帳戶網頁。若掃描後進入參數頁,請檢查 Type、位址與驗證欄位是否完整,儲存後返回 Home 查看是否新增項目。若仍無法辨識,請向原設定提供者確認 QR Code 內容格式。QR Code 可能包含驗證資訊,請勿將原圖貼到公開討論區;排查時只提供已遮蔽的欄位與錯誤訊息。

已有訂閱如何更新?更新失敗會有什麼影響?

在 Home 找到相應的 Subscribe 群組或訂閱管理入口,使用該訂閱的更新功能,再確認清單內容與預設伺服器是否仍有效。實際操作入口以目前 App 顯示為準;若要自動更新,再查看相關訂閱設定。更新失敗後不要立刻刪除原有群組,先記錄錯誤,並檢查網路、網址是否有效及回傳內容。原有項目是否保留取決於實際更新結果;清單中仍看得到伺服器,也不代表它仍可連線。詳細步驟請參閱訂閱更新文章。

匯入訂閱和匯入 Config 是同一回事嗎?

不是。Subscribe 通常用來管理伺服器項目集合及其更新來源;Config 則用來管理規則等連線行為設定。匯入其中一種,不代表另一種也已完成。先確認手上的內容用途,再選擇相應入口。更換 Config 前應備份目前設定,並確認其中的策略引用符合實際伺服器或策略群組。遇到不熟悉的設定,請先閱讀規則與 DNS 等內容,不要直接覆蓋日常使用的設定。匯入完成後,使用相同的測試目標驗證,方便判斷變更來自哪個部分。

Global Routing / Diagnostics

規則分流與故障排查

先檢查基本網路,再檢查伺服器,最後核對規則與目標。記錄測試條件,比反覆切換設定更有幫助。

Global Routing 中的 Config、Proxy、Direct 該怎麼選?

Config 模式會依目前選取的 Config 規則決定連線策略,適合已確認規則後的日常使用;Proxy 模式會讓連線採用代理路徑,適合排查時確認所選伺服器是否可用;Direct 模式則直接連線至目標,適合檢查目前網路的基本連線情況。三種模式代表不同的路由選擇,不是由弱至強的等級。測試時保持目標與伺服器不變,一次只切換一種模式,並搭配規則命中記錄判斷差異;不要只憑模式名稱推測連線結果。

顯示已連線,但網頁仍無法開啟,該依什麼順序排查?

先中斷連線,確認目前的 Wi-Fi 或行動網路本身能正常連上常用目標;若網路需要網頁登入,請先完成驗證。接著返回 Shadowrocket,確認預設伺服器與現有服務狀態,並執行 Connectivity Test。伺服器測試通過後,再檢查 Global Routing:若 Proxy 可用但 Config 不可用,優先檢查規則與策略引用;若網域無法連線但其他測試正常,再查看 DNS 相關記錄。每次只更改一項設定,並保留錯誤訊息,避免同時更換伺服器、規則與 DNS,導致無法定位原因。

只有特定網站或 App 連線失敗,為什麼不先換伺服器?

部分目標連線失敗時,伺服器可能仍正常運作;差異也可能來自規則比對、DNS、目標本身的狀態或 App 快取。先記下連線失敗的網域與發生時間,再查看命中的規則及最終策略。DOMAIN-SUFFIX 用於比對網域後綴,DOMAIN-KEYWORD 用於比對網域關鍵字,規則順序會影響結果;應將特定比對規則放在 FINAL 之前。確認目前啟用的是剛修改的 Config 後再測試。不要只為單一目標就直接替換整份設定,也不要公開包含驗證資訊的完整 Log。

延遲測試有結果,為什麼實際連線仍失敗?

延遲結果只反映目前測試方法與目標下的回應情況,不代表所有網站、協定和 App 都能正常使用。先在 Settings 中確認 Ping 相關的測試方式與目標,再使用 Connectivity Test 和實際連線交叉驗證。比較結果時,請使用相同網路、相同測試方式及相近時間;不要將不同方法測得的數值直接排序比較。若測試有回應但實際連線失敗,應繼續檢查驗證參數、規則策略、DNS 與目標狀態;反覆測速通常無法解決這些問題。

Log 該如何使用?回報問題前要遮蔽哪些內容?

先明確選定一個要重現的問題,再視需要啟用 Log,執行一次相應操作,並記錄當時的網路、Global Routing 模式與測試目標。優先保留錯誤類型、規則命中情況與發生順序,完成後恢復適當的記錄層級,避免長期累積不必要的詳細資料。回報前請遮蔽訂閱網址、驗證欄位、伺服器憑據,以及可能辨識個人瀏覽行為的網域或請求內容。不要只貼連線圖示的截圖,也不要直接公開整份設定;提供最少必要資訊更有助於定位問題。