Shadowrocket
常見問題與排查

先從本站正版下載頁開啟 App Store 產品頁，確認是搜尋不到結果，還是目前商店無法取得。商店地區取決於購買時使用的 Apple 帳號，與裝置語言無關。可在系統設定中前往 Apple 帳號 → 媒體與購買項目 → 檢視帳號 → 國家或地區，確認目前的商店。若確實需要變更地區，請依該頁面的官方流程操作，並先了解餘額、訂閱及付款方式的相關要求；不要只為了搜尋一次而反覆切換。產品是否顯示及購買條件，請以目前的 App Store 頁面為準。

請一併核對產品名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、官方圖示及 App ID。App ID 是產品頁網址中的 id932747118，對應數字 932747118；圖示應與本站頁首的官方圖示相同。搜尋結果中的名稱或圖示相似，並不足以確認身分，請進入產品頁核對開發者與 ID。購買前也請查看價格、相容性及適用的購買範圍，詳細資訊以 App Store 頁面標示為準。

不包含。一次買斷客戶端 ≠ 購買連線方案。購買取得的是 Shadowrocket 客戶端的使用權；連線所需的訂閱或伺服器資訊，須由使用者自行準備。美國商店售價為 $2.99，一次性買斷；實際金額與購買條件以商店頁面為準，其他商店則以當地貨幣顯示。既有訂閱的續期、流量與伺服器狀態由相關服務決定，不能以 App Store 購買紀錄取代。首次使用前，請先確認既有設定仍有效，再進行匯入與連線測試。

通常使用原購買時的 Apple 帳號，即可在 App Store 帳號頁面尋找已購項目並重新下載；入口名稱可能因系統介面而異。若看到價格按鈕，請先確認媒體與購買項目所用帳號、購買紀錄及目前商店，不要立即重複付款。重新下載應用程式不代表會還原其中的所有設定，換機前請妥善備份既有設定。若打算透過家人共享取得，請確認產品頁的支援情況與家庭設定；適用範圍以 App Store 頁面標示為準。

先查看 App Store 顯示的詳細提示，確認是付款未完成、帳號需要驗證、裝置儲存空間不足，還是網路中斷。檢查購買紀錄確認是否已完成交易，再處理付款方式或待確認條款；若紀錄已存在，請回到同一帳號的已購項目中嘗試下載。也請確認裝置可用空間及系統相容性；系統需求以 App Store 頁面標示為準。若商店錯誤持續出現，請記下提示原文，並透過 Apple 支援管道處理；應用程式內的伺服器設定無法解決商店付款問題。

Shadowrocket 主要用於 iPhone 與 iPad。請先在 iPad 的 App Store 使用原購買帳號查看產品頁或已購項目；若該帳號已有購買權益，通常可直接重新下載。是否支援目前裝置、系統需求及購買適用範圍，請以 App Store 頁面標示為準。安裝後仍須匯入使用者既有設定，購買應用程式不代表設定會自動同步。Mac、Apple TV 與 Apple Vision 的適用資訊，也請查看同一產品頁的相容性欄位。

這是系統授權應用程式建立 VPN 設定的步驟，讓 Shadowrocket 依所選模式處理網路流量。請先確認目前開啟的是已核對過的 Shadowrocket，再閱讀系統提示並依指示完成裝置驗證。授權本身不會產生伺服器資訊，也不能證明既有設定可用。若先前曾取消，可返回應用程式重新嘗試連線，並留意系統提示；若裝置受組織管理或使用限制，請先確認管理規範，不要刪除用途不明的系統設定。

先確認是否已匯入設定並選取可用伺服器，再確認系統 VPN 設定的授權是否完成。返回 Home 再試一次，觀察是開關立即跳回關閉，還是維持開啟但網頁無法載入；兩種情況應分開排查。若開關立即關閉，還需檢查系統中的其他 VPN 連線、裝置管理限制及應用程式提示，避免多種連線機制互相影響。記下錯誤原文後再調整設定；未備份前不要刪除所有設定。若開關維持開啟但無法存取網頁，請接著排查連線後的網路與 DNS。

本官方手冊保留介面英文原文，方便直接查找：Home 用於查看伺服器與連線狀態，Add Server 用於填寫伺服器資訊，Config 用於管理設定檔，Global Routing 用於選擇流量處理模式，Settings 用於查看設定。可先查看系統為該應用程式提供的語言選項；可用語言以應用程式與系統實際顯示為準。跟著教學操作時，請依欄位用途填寫，不要把中文說明輸入協定名稱、規則關鍵字或伺服器參數欄位。

連線建立後，通常不必讓應用程式持續停留在前景。耗電量會受實際流量、無線訊號、伺服器重新連線頻率、協定及額外處理設定影響；請在相近的使用條件下查看系統電池用量，而非只比較連線前後的瞬間變化。先暫停重複測試與頻繁更新訂閱，確認伺服器沒有持續斷線重連，再檢查近期變更的設定。若要停止處理流量，請主動關閉連線並檢查 On Demand 設定；離開應用程式頁面不代表已中斷連線。

先確認複製的是使用者既有的完整訂閱連結，而不是帳號頁面、說明網頁或遭截斷的文字；並檢查前後空格、換行及多餘引號。接著判斷是連結無法送出請求，還是回傳內容無法解析：前者請檢查目前網路及服務是否有效，後者請確認訂閱格式是否受 Shadowrocket 支援。必要時向原服務提供者確認連結狀態與格式，不要反覆修改連結中的驗證參數。訂閱網址可能包含個人存取憑證，排查時不要將完整網址公開在網頁或截圖中。

成功辨識 QR Code 只代表讀取到內容，不代表內容一定是可匯入的伺服器資訊。先確認 QR Code 來自使用者既有的設定，並判斷內容是單一伺服器、訂閱網址還是一般網頁。使用 Scan QR Code 讀取後，請留意應用程式顯示的匯入確認或錯誤提示；若提示格式不支援，應確認原始內容類型，而不是反覆掃描同一張圖片。QR Code 模糊或遭裁切時，請改用清晰完整的原始圖片；辨識結果中的密碼、網址及驗證參數也應妥善保管。

先選擇與既有伺服器相符的協定類型，再逐項核對位址、連接埠及相應的驗證欄位。VLESS、Trojan、WireGuard 等類型的欄位不可只因名稱相似就互相套用；TLS、sni、傳輸方式與路徑也應依原始設定填寫。伺服器位址通常只需填主機名稱或 IP，不要將整個訂閱連結貼入位址欄。儲存後先確認目前選取的是剛新增的項目，再進行測試。若原服務提供者只提供訂閱，應優先匯入訂閱，避免在缺少完整參數時猜填。

在 Home 找到對應的訂閱群組，使用目前介面提供的更新操作，並留意是否出現請求或解析錯誤。更新會重新讀取訂閱內容；服務提供者調整伺服器名稱、參數或可用項目後，本機列表也可能隨之變動。更新成功不代表每台伺服器都已通過連線驗證。更新前可記下目前選取的項目，更新後再確認它是否仍在列表中或已遭替換。若持續更新失敗，請先保留現有可用設定並確認連結有效，不要為了更新而先刪除整個訂閱群組。

兩者用途不同。Subscribe 通常用來讀取並更新一組伺服器資訊；Config 設定檔則用來定義規則、DNS 等流量處理設定，實際內容取決於檔案本身。伺服器列表存在，不代表所需規則已啟用；選取 Config，也不代表伺服器驗證資訊正確。匯入前先確認手上的內容類型，匯入後分別檢查伺服器選取項目、目前設定檔與 Global Routing。對於既有且穩定的設定，修改前請先備份，避免誤將更新訂閱當成替換所有規則。

Config 依目前設定檔中的規則決定流量處理方式，適合日常使用已有規則的設定；Proxy 會依此模式將流量交由所選代理處理，適合短暫確認伺服器連線；Direct 則以直連方式處理，適合與本地網路狀況比對。三種模式代表不同的流量處理方式，並非速度檔位。排查時一次只切換一項，並記錄同一目標的結果；若只有在 Config 下失敗，應優先檢查匹配規則與 DNS，而非立刻重建伺服器。

先暫時中斷連線，確認本地網路本身能正常瀏覽網頁，再重新連線並核對目前伺服器與 Global Routing。顯示已連線代表系統通道已建立，不表示遠端伺服器、驗證、DNS 與目標網站都正常。可使用 Connectivity Test 輔助檢查，再分別測試數個已知正常的網站。若全部失敗，優先確認伺服器是否有效及驗證參數是否正確；若只有部分網站失敗，再檢查相關規則、解析結果及目標服務狀態。每次只變更一個條件，避免多處修改掩蓋真正原因。

Connectivity Test 只反映所選測試方式與目標在當下的結果，不代表所有網站、所有協定或完整使用流程都能正常運作。請繼續核對實際目標的 DNS 解析、規則匹配情況與連線錯誤；單憑一個測試數值，無法判定整體設定正確。若要更換 DNS 進行排查，先記下原設定並確認新位址可連線，每次只修改一項。不要看到網域錯誤就同時修改伺服器、規則與 DNS；應在適當條件下比較同一目標於 Direct、Proxy 與 Config 模式中的結果。

先將 Global Routing 設為 Config，並確認目前啟用的確實是剛編輯的設定檔。以指定網域走代理、其他流量直連為例，可將 DOMAIN-SUFFIX,example.com,PROXY 放在 FINAL,DIRECT 之前；其中 example.com 僅為示例網域，請依實際目標修改。規則會依序匹配，較早符合的規則會影響後續判斷；FINAL 應放在末尾作為兜底。一個網站也可能連線至其他網域，需依實際連線紀錄逐一確認，不宜直接擴大到所有流量。

On Demand 會在符合所設條件時由系統觸發連線，實際行為取決於已啟用的條件與系統狀態。若手動中斷後又自動連線，應先檢查是否啟用了相關條件，而非直接認定開關故障。為了方便重複排查，可先記錄並暫時關閉 On Demand，再手動連線測試；確認基本連線與規則正常後，再逐項恢復。On Demand 無法補齊缺少的伺服器參數，也無法修復失效的訂閱；設定前應先確認手動連線可正常使用。