官方手冊 · 疑難排解

Shadowrocket 疑難排解

先確認問題發生在哪個步驟:從商店取得、首次授權、匯入資訊,還是連線後的實際請求。依下列四類查找解答;排查時一次只修改一項,保留原設定,再比較結果。

正版確認與 App Store 購買

取得與復原都透過 App Store 處理。請先確認 App 身分,再核對帳號、商店地區與購買紀錄;裝置上的連線設定不屬於購買紀錄。

在 App Store 搜尋不到 Shadowrocket,應先檢查哪些項目?

先從本站下載頁開啟 App Store 產品頁,確認 App ID 為 932747118,再查看目前帳號所屬的商店是否提供此 App。光看搜尋結果不足以確認是否可取得。若要確認地區,請前往系統 Settings,開啟 Apple Account 的 Media & Purchases,再進入 View Account 查看 Country/Region;項目名稱可能因系統語言而異。變更地區前,請先詳閱 Apple 關於餘額、訂閱及付款方式的說明。

如何確認商店中的 App 是正版 Shadowrocket?

請同時確認三項:開發者為 Shadow Launch Technology Limited、圖示與本站頁首的官方圖示相同,以及產品頁網址包含 id932747118。不要只憑相似名稱或搜尋結果排序判斷。進入產品詳情頁後,再確認價格與相容性;系統需求請以 App Store 頁面標示為準。本站下載頁整理了這些資訊,確認後再透過 App Store 購買。

更換裝置或刪除後重新安裝,需要再購買一次嗎?

請先使用原購買帳號登入 App Store,並在帳號的已購項目中尋找 Shadowrocket;符合復原資格時即可重新下載。若仍顯示價格,請先確認購買紀錄、目前登入的帳號及商店地區,不要急著再次付款。清單名稱可能因系統版本而異。重新取得 App 與還原原有設定是兩回事;已有的訂閱、伺服器資訊及設定檔應另外備份。復原資格請以 App Store 頁面標示為準。

買斷 Shadowrocket 後,就能直接連線嗎?

一次買斷客戶端 ≠ 購買線路方案。購買取得的是 Shadowrocket 客戶端的使用資格,連線仍須有使用者自己的訂閱或伺服器資訊。匯入後還要檢查參數、選擇伺服器並完成系統授權。美國商店價格為 $2.99,請以商店頁面為準;其他商店會以當地貨幣顯示。本站不提供、不銷售,也不推薦節點或訂閱;App 購買與既有線路服務分開管理。

iPad 可以使用嗎?購買資格是否與 iPhone 共用?

Shadowrocket 可透過同一個 App Store 產品頁在 iPad 上取得。請先登入購買時使用的帳號,再確認商店顯示的是下載按鈕還是價格;裝置相容性、系統需求及通用購買資格請以 App Store 頁面標示為準。iPad 與 iPhone 的可用顯示空間不同,但仍須分別檢查目前使用的伺服器、Config 與連線授權。購買資格不代表設定會自動同步;更換裝置後,請確認既有資訊是否完整。

查看正版確認說明 · 查看已購項目復原步驟

安裝與首次連線

安裝完成後,依序確認資訊匯入、選擇伺服器、檢查 Global Routing、完成系統授權及實際瀏覽。介面名稱請以 App 內顯示為準。

首次開啟 Shadowrocket 後,建議依什麼順序操作?

先確認裝置在關閉連線時能正常上網,再準備使用者已有的訂閱或伺服器資訊。在 Home 匯入資訊,或透過 Add Server 輸入參數;確認項目已新增,並選取要使用的伺服器,再檢查 Global Routing。首次開啟連線時,依系統提示新增 VPN 設定檔,最後前往明確的目標網頁確認結果。先測試單一伺服器,再調整規則,較容易找出問題所在。

首次連線時出現新增 VPN 設定檔的提示,該如何處理?

這是系統授權 App 建立 VPN 設定檔的步驟,與購買是否成功無關。確認提示是剛開啟的 Shadowrocket 所觸發後,依畫面指示允許並完成裝置身分驗證,再返回 App 查看連線狀態。若先前取消,可再嘗試開啟連線。若裝置受組織管理,設定權限可能受到限制;請檢查系統管理設定並向裝置管理員確認,不要反覆刪除其他用途的設定檔。

連線開關無法開啟,或開啟後立刻關閉,該如何排查?

先查看 App 或系統是否顯示具體錯誤,再確認已選取有效伺服器並完成 VPN 設定檔授權。檢查是否有其他 VPN 連線正在使用,以及裝置管理是否限制設定。接著關閉連線並重新開啟 App,只測試目前選取的伺服器。若仍無法連線,請記下錯誤訊息、發生步驟及目前的網路類型;不要同時重置網路、刪除設定檔或修改多個參數,否則難以判斷是哪項變更影響結果。

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

Config 會依目前設定檔中的規則決定流量策略;Proxy 會讓相關流量使用所選的代理策略;Direct 則用於直接連線。需要依規則分流時,請選擇 Config,並確認 Config 中實際啟用的檔案。排查時可針對同一目標分別測試不同模式,記錄結果後再還原日常設定。Global Routing 與規則中的 PROXY、DIRECT 屬於不同層級,不能只根據單一規則推斷所有流量的去向。

介面顯示英文時,如何對照教學找到操作項目?

先依英文介面名稱尋找:Home 查看伺服器與連線,Add Server 新增伺服器,Config 管理設定檔,Settings 查看設定,Global Routing 選擇連線模式。官方手冊保留這些英文名稱,只以中文說明用途。裝置與系統設定可能影響文字顯示,不必因語言不同而重新安裝 App;找不到項目時,先確認目前所在頁面及 App 實際提供的選項,再對照教學繼續操作。

依使用教學完成首次連線 · 查看功能與連線模式說明

訂閱與節點匯入

以下操作以使用者已有的訂閱或伺服器資訊為前提。請先分辨輸入的是訂閱網址、單一伺服器參數還是設定檔,再選擇相應的匯入方式。

已有的訂閱匯入失敗,應先檢查哪些項目?

先確認貼上的是使用者已有的完整訂閱網址,而非帳戶管理或說明頁面,並檢查網址前後是否有空格、換行或遺漏參數。接著確認目前網路可以連上該網址、訂閱仍有效,而且回傳格式適用於 App 的匯入入口。若出現錯誤,請記下狀態或錯誤訊息,不要連續重複提交。訂閱網址可能含有存取憑證,排查時請遮蔽敏感部分,不要放進公開截圖。

透過 Add Server 手動輸入後無法連線,哪些欄位最容易填錯?

先確認協定類型,再逐項檢查伺服器位址、連接埠及該協定要求的驗證資訊。若既有資料還包含 TLS、Server Name、傳輸方式或路徑,請依原始資料逐字填寫,不要自行猜測。顯示名稱只供辨識,不會影響連線能力;位址欄也不應混入說明文字。每次只修正一個欄位,儲存後再測試;確認裝置日期與時間正確,並保留原始資料以供核對。請勿公開密碼或其他驗證資訊。

Scan QR Code 無法辨識,或匯入後參數不完整,該怎麼辦?

先確認 QR Code 中包含的是使用者已有的伺服器或訂閱資訊,而不是一般網頁網址。使用 Scan QR Code 時,請檢查相機權限、畫面是否清晰,以及 QR Code 邊緣是否完整。成功辨識後仍應開啟項目,確認協定與必要欄位;辨識成功不代表設定正確。若原始資料也提供文字資訊,可改用相應匯入方式,或透過 Add Server 逐項輸入,再比對重要欄位;避免反覆掃描同一張不完整的圖片。

更新訂閱後項目有所變動,如何確認更新正確?

更新前先記下目前選取的伺服器與訂閱群組,必要時備份設定。更新後確認項目仍屬於原訂閱,再檢查原先選取的項目是否遭移除、更名或取代;名稱變更不代表連線資訊相同。若更新失敗,先查看錯誤提示並確認網址有效,不要一直刪除後重新新增。訂閱內容與 Config 檔案分別管理;更新完成後應重新選取有效項目並測試,不要假設原有選取會保留。

訂閱、伺服器項目與 Config 檔案有什麼不同?

伺服器項目儲存特定連線所需的協定與驗證參數;訂閱用於批次取得或更新使用者已有的伺服器資訊;Config 檔案則描述規則、DNS 等設定行為。成功匯入訂閱,不代表已啟用合適的 Config;切換 Config 也不代表伺服器憑證已更新。排查時先判斷問題出在連線參數還是規則行為,再到相應位置修改。重要設定應另外備份,還原後再確認實際啟用的檔案與伺服器。

規則、DNS 與連線排查

顯示連線、探測到延遲、網頁可以瀏覽,代表不同層次的結果。請以同一個目標進行比對,依序檢查本地網路、伺服器、規則與 DNS。

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

先關閉連線,確認本地網路正常,再開啟連線並瀏覽同一個目標,以區分基礎網路與代理路徑問題。接著確認目前使用的伺服器、Global Routing 及實際啟用的 Config,再查看目標請求對應的規則與錯誤資訊。若只有部分網域失敗,優先檢查規則與 DNS;若多個目標都無法連線,再檢查伺服器參數與網路環境。每次只修改一項,並記錄變更前後的結果,不要直接替換整份設定。

Connectivity Test 顯示延遲數值,為什麼仍可能無法瀏覽?

Connectivity Test 的結果只表示當時以所選測試方式完成相應探測,無法同時證明網域解析、驗證、規則選擇及目標連線都正常。先確認測試對象與目前選取的伺服器一致,再查看無法開啟的網頁所對應的實際請求。若連線探測有結果但網域無法存取,應繼續檢查 DNS;若只有特定目標異常,則檢查規則策略及目標本身是否可用。延遲數值可作為線索,不應是唯一判斷依據。

Config 中的規則未依預期生效,如何檢查比對順序?

先確認 Global Routing 設為 Config,並確認目前使用的設定檔,而不是只修改了其他檔案。規則由上而下逐條比對,符合後便採用對應策略;較具體的條件應排在前面,FINAL 則放在 [Rule] 區段最後。檢查目標是否先符合範圍較廣的 DOMAIN-SUFFIX、GEOIP 或 IP-CIDR 條件,再確認 PROXY、DIRECT、REJECT 是否符合預期。修改後重新送出請求驗證,不要沿用既有連線的結果判斷。

懷疑 DNS 解析失敗時,如何縮小範圍排查?

先確認是多個網域都無法解析,還是只有單一網域異常,再檢查目前 Config 的 [General] 區段及 App 實際生效的 DNS 設定。確認是否有無法連線的自訂解析位址、Host 覆寫,或影響解析請求的規則。備份原設定後,只調整一項 DNS 相關設定並重新測試;使用 DNS over HTTPS 時,解析服務的位址本身也必須可連線。不要把連線成功或單次延遲正常,直接當成 DNS 正常的證明。

背景耗電偏高時,該如何檢查 On Demand?

先在系統的電池設定中查看相關時段的用量,並一併比較螢幕使用情況、網路環境及實際傳輸量;耗電占比不代表額外耗電完全由 App 造成。接著檢查 On Demand 條件是否頻繁觸發連線,以及網路切換時是否反覆重新連線。可在相似使用情境下比較開啟與關閉時的表現,再保留符合需求的條件。On Demand 用於控制隨選連線,不保證一定省電,也不能取代對異常網路活動的檢查。

需要逐段檢查 [General] 與 [Rule] 時,請接著閱讀規則與設定參考。排查完成後,請還原日常使用的 Global Routing,並再次確認目前的伺服器與設定檔。