Shadowrocket 匯入訂閱與首次連線

步驟 01 · 先確認資訊類型

Add Server：新增伺服器與 Subscribe

開啟 Shadowrocket 後進入 Home，在 SERVER 分組附近找到 Add Server，也可以使用頁面上的新增按鈕進入。先辨認手上的資訊：用於批次更新節點的網址屬於訂閱；一組網址、連接埠、協定與驗證參數則屬於單一伺服器資訊。這兩種輸入方式不可混用，尤其不要把整段訂閱網址填入 Host。

已有訂閱連結時

進入 Add Server 後，開啟 Type 並選擇 Subscribe，將自己的訂閱連結貼到相應的網址欄位；若介面提供備註欄位，可填入便於辨識的來源名稱，然後儲存。返回 Home 後更新該訂閱，等待解析完成，再檢查 SERVER 中是否出現實際伺服器項目。儲存訂閱網址與成功取得節點是兩回事；如果只有訂閱名稱而沒有可選伺服器，就不應直接進入連線步驟。

貼上前請檢查連結的開頭與結尾，避免複製到空格、換行、聊天說明或中文標點。連結中的參數通常屬於驗證資訊，不要任意刪改，也不要公開傳送。若更新後顯示錯誤或清單為空，請先保留原網址並查看錯誤提示，不要連續重複新增相同訂閱。訂閱是否到期、是否允許目前的請求，應向使用者已有的服務商確認；這些狀態不取決於用戶端的安裝或購買結果。

已有單一伺服器資訊時

在 Type 中選擇實際協定，再依原始資料填寫 Host、Port 及該協定要求的驗證欄位。以 Shadowsocks 為例，需核對 Password 與 Method；切換到其他協定後，欄位可能不同，不能照抄截圖中的欄位組合。Host 通常填寫伺服器網域名稱或 IP 位址，Port 填入連接埠數字，密碼及其他驗證值需保持原樣，大小寫也要一致。

若有可匯入的 QR Code，可使用 Scan QR Code；Import from Cloud JSON 則適用於相應的 JSON 資料來源，不是任意訂閱連結的通用替代入口。匯入後仍應開啟項目檢查協定與網址，確認與既有資料一致。最後儲存並返回 Home，確認 SERVER 分組內已有可選項目，再繼續選擇 Global Routing。協定欄位的差異可參閱術語手冊，此步驟不需修改暫時不理解的進階參數。

步驟 02 · 決定流量處理方式

Global Routing：選擇三種模式

匯入伺服器後，先別急著開啟連線開關。在 Home 點開 Global Routing，確認目前使用設定檔(Config)、代理(Proxy)還是直連(Direct)。伺服器項目回答的是「使用哪台伺服器」，Global Routing 回答的是「請求如何處理」；只選了伺服器卻選錯全域模式，存取結果仍可能與預期不同。

1. 設定檔(Config)：依目前設定檔中的規則，決定請求使用 PROXY、DIRECT 或 REJECT。適合日常規則分流，但前提是已選取正確的設定檔，且規則符合目標需求。
2. 代理(Proxy)：以全域代理模式處理請求，可作為短暫的排查方式，協助判斷問題來自伺服器還是 Config 規則。這不是會為特定網站自動產生規則的功能。
3. 直連(Direct)：以直連模式處理請求，不應用來證明代理伺服器已可使用。需要比較原始網路的存取情況時可暫時使用，測試後再恢復預期模式。

準備使用 Config 時，開啟底部的 Config 頁面，確認目前選取的是預期設定檔。伺服器訂閱與設定檔不是同一種內容：前者主要管理可連線項目，後者包含規則及其他設定。更新訂閱後節點變多，不代表 Config 中的分流規則也已更新。進入設定檔編輯頁可看到 General、Rule、Hosts、URL Rewrite 等區段；初次使用只需確認 Rule 的實際內容，不必同時修改多個區段。

以下片段用於理解規則順序，不要求新手立即替換現有設定。此範例表示：example.com 及其子網域走 PROXY，其餘請求交由 DIRECT 處理。範例網域僅用於展示語法，不代表實際測試目標；實際設定前應換成自己的目標，並保留原設定副本。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Rule 通常由上往下比對，FINAL 應放在最後的預設位置；若過早比對，後續目標規則便不會處理該請求。需要新增規則時使用 Add Rule，並檢查儲存後的排列順序。更多規則類型、策略與優先順序說明，請參閱規則與設定參考。確認模式與設定檔後返回 Home，下一步再建立連線，避免將設定檔編輯與連線故障混在一起排查。

步驟 03 · 選取項目後再連線

Home：開啟連線與系統授權

返回 Home，在 SERVER 分組中點選準備使用的伺服器，確認選取標記位於預期項目上。若清單中有多個名稱相近的項目，可先開啟項目核對 Host 與 Port，再返回選取。一次只測試一台伺服器，不要在開啟開關時反覆切換項目，否則發生故障時難以判斷實際使用了哪組參數。

檢查 Global Routing 是否顯示剛才選擇的模式，再開啟頂端 Not Connected 附近的連線開關。首次連線時，iPhone / iPad 會要求允許新增 VPN 設定；確認操作來自 Shadowrocket 後，依系統提示允許，並完成裝置密碼或生物辨識驗證。若取消這次請求，應用程式便未取得相應授權，請返回 Home 重新觸發連線，而不是重新匯入所有伺服器。

完成授權後返回應用程式，觀察頂端狀態是否改變、開關能否維持開啟。系統狀態區域是否顯示 VPN 標示會受裝置與目前介面影響，不要只靠標示判斷結果。連線已建立只代表系統層級的連線流程已進行，不等於目標網站、DNS 與分流規則都已驗證通過。因此完成此步驟後，仍需實際存取與測試。

若開關立即回落，先記下系統提示或應用程式錯誤文字。檢查裝置上是否還有正在運作的其他 VPN 設定或管理策略，避免多個連線設定互相影響；受管理的裝置應遵循組織要求，不要擅自刪除管理設定。對自己能管理的其他連線，先停止再重新嘗試。若系統授權已完成但仍持續失敗，請在最後一步依故障階段處理。

需要停止時，返回 Home 關閉頂端開關即可。初次排查可先完整執行一次「關閉 → 確認狀態 → 重新開啟」，讓目前設定重新套用；不要連續快速點擊開關。連線狀態穩定後，保留目前的伺服器與 Global Routing 選擇，繼續下一步驗證，讓每次測試都有明確的起點。

步驟 05 · 從故障發生的位置回查

Settings：依故障點檢查

匯入後沒有可選伺服器

先返回訂閱項目，確認 Type 使用 Subscribe、網址沒有複製遺漏，而且已執行更新。若清單為空，請檢查回傳內容是否為登入頁、錯誤頁或用戶端不相容的資料，不要反覆點擊儲存。使用者既有服務商端的有效期限、存取限制或連結更換，也會影響更新結果。重新匯入前先保留原設定；大量重複項目會讓後續選擇與排查更困難。

伺服器存在，但開關無法維持開啟

先核對系統授權是否完成，再檢查選取的伺服器是否就是剛才填寫的項目。手動新增的資訊應逐項與原始資料比對，特別是連接埠、驗證值、Method，以及協定所需的 TLS 或其他欄位。不要用「看起來相近」的值代替缺少的參數。訂閱匯入的項目則先嘗試更新，再向使用者既有的服務商確認伺服器狀態。

連線已開啟，但部分目標無法存取

先核對 Global Routing 與目前的 Config，再檢查目標是否被較早的規則分配到 DIRECT 或 REJECT。如果網域解析失敗，應檢查目前使用的 DNS 設定與網路環境，不要直接更換整份設定檔。網站登入、目標服務維護、應用程式快取與既有連線也可能影響結果；同一目標在瀏覽器與其他應用程式中的差異，應分別記錄，不能用一次成功或失敗概括所有請求。

使用 Settings 協助定位

開啟底部的 Settings，先查看 Test Method 是否符合目前的測試目的，再視需要使用 Diagnostics 收集錯誤資訊。On Demand 是依條件觸發連線的設定，不是修復訂閱或驗證錯誤的開關；初次驗證建議先手動建立並停止連線，確認基本路徑可用後再設定自動連線條件。

Settings 中也能看到 Proxy、TCP、UDP 等相關設定。不要因為某個目標無法開啟就逐項修改這些選項；先記錄原始值，只修改與現象直接相關的一項，若沒有改善則恢復原值。向既有服務商描述問題時，說明網路類型、Global Routing 模式、錯誤文字與重現步驟即可；分享截圖或 Diagnostics 內容前，請移除訂閱網址、密碼、驗證參數與其他個人資訊。

若仍未解決，請依「匯入失敗、連線失敗、連線後存取失敗」分類後閱讀FAQ 故障排查。若需進一步修改規則比對、DNS 或設定檔欄位，請參閱設定欄位參考。先確認故障發生在哪個步驟，比同時重設所有選項更容易保留有效資訊。