Shadowrocket 匯入與連線
依序完成新增、模式選擇、連線、測試與排錯。先建立一條可供驗證的連線，再調整規則與自動連線條件。
本文主要說明 iPhone / iPad 上的操作。介面用語保留英文原文，截圖可協助尋找功能入口；實際版面與可用選項請以目前 App 介面為準。
01 · Add Server 與 Subscribe
依手邊資料的類型選擇一種新增方式，不必重複匯入。
開啟 Shadowrocket，進入底部的 Home。在 SERVER 區塊找到 Add Server，也可以使用介面上的新增入口進入編輯頁。先確認手邊資料是單一伺服器欄位、完整訂閱連結，還是相容的 QR Code：三者的匯入方式不同。訂閱連結不是伺服器的 Host，不能把整條連結拆開填入 Host 與 Port。
已有伺服器資料：先選 Type，再填寫欄位
在 Add Server 頁面點選 Type，選擇與既有資料相符的協定類型。以 Shadowsocks 為例，依原始資料填寫 Host、Port、Password 和 Method。Host 填伺服器網域或位址，Port 填連接埠；Method 必須與伺服器端一致，不要只憑名稱相似就選擇。不同 Type 顯示的欄位也不同，截圖中的欄位不適用於所有協定。
填寫時請特別確認複製內容前後是否多了空格、連接埠是否誤用了全形數字，以及輸入法是否替換了密碼中的標點符號。若資料還包含 TLS、傳輸方式或其他參數，請依原始說明逐項核對，不能只填四個基本欄位就認定設定完整。完成後按頁面上的儲存或完成按鈕，返回 Home，確認 SERVER 中已出現相應項目。
已有訂閱連結：使用 Subscribe
若已有完整訂閱連結，請在 Type 中選擇 Subscribe，將完整連結貼到 URL 欄位，再填寫方便辨識的備註並儲存。連結中的查詢參數可能包含存取憑證，請勿任意刪除或分享。儲存後等待內容載入；若目前介面提供更新功能，可更新一次訂閱，再確認伺服器項目是否已展開或列出。
訂閱項目可用來管理一組伺服器，但不代表清單中的每個項目都已通過連線測試。請在 Home 選擇一台實際伺服器作為本次測試對象，記下它的名稱，測試期間不要更換。若清單空白，請先確認連結是否仍有效、複製內容是否完整，以及目前網路能否取得訂閱內容，避免重複新增相同連結。
已有 QR Code：Scan QR Code
在 Add Server 頁面使用 Scan QR Code，依系統提示授予所需的相機權限，並將已有的相容 QR Code 完整放入取景範圍。辨識後先確認匯入的是單一伺服器還是訂閱，再核對 Type、Host 或 URL 等重要資料。掃描只是輸入資料的方式，不能代替有效性驗證；若辨識失敗，可改用原始連結或欄位輸入，請勿嘗試修改 QR Code 內容來修復。
頁面底部的 Import from Cloud JSON 是另一種資料匯入入口，不能取代一般訂閱連結。只有在既有資料明確採用相應格式時才使用。完成任一新增方式後，下一步先決定 Global Routing 如何處理流量，而不是立刻修改多項進階設定。
02 · 選擇 Global Routing
伺服器決定連線目標，Global Routing 則決定流量的處理方式。
返回 Home，點選 Global Routing。這裡有三種模式：設定檔 (Config)、代理 (Proxy)、直連 (Direct)。它們不是三種伺服器協定，也不能取代連線開關。選好模式後，仍須進行下一步的連線操作，才能驗證實際路徑。
設定檔 (Config)會依目前啟用設定檔中的規則處理流量，不同目標可能分別套用 PROXY、DIRECT 或其他已定義的策略。日常需要規則分流時，請先確認設定檔的來源與內容，再使用此模式。SERVER 中選了伺服器，不代表所有請求都會經過該伺服器；若某個目標符合 DIRECT 規則，直連就是規則的處理結果。
代理 (Proxy)會在一般流量處理層使用所選的代理路徑，適合暫時確認伺服器是否可用，或排除規則造成的影響。這不代表所有 App 請求都一定經過同一條可觀察的路徑，仍須搭配實際目標與連線記錄判斷。直連 (Direct)會直接連線至目標，可作為基本網路的對照；Direct 模式下能開啟目標頁面，並不能證明代理伺服器本身可用。
使用 Config 前，先檢查目前設定檔
進入底部的 Config，確認要使用的設定檔，再開啟內容查看。官方截圖展示的是設定檔編輯頁，分為 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 等區段；這不是 Global Routing 的選擇選單。請先分辨兩個功能入口，避免把編輯設定檔誤認為切換模式。
初次使用時，只需優先確認 Rule：網域規則、網段規則與最終規則分別套用哪種策略，以及引用的策略是否存在。使用 Add Rule 新增規則前，請先儲存原始設定檔副本。規則通常依序比對，較早符合的規則會影響後續處理；例如 DOMAIN-SUFFIX 用來比對網域後綴，FINAL 則負責處理前面未符合規則的流量。
首次建立連線時，不需要調整 URL Rewrite 或 HTTPS Decryption。縮小變更範圍，才能更容易判斷問題出在伺服器、規則還是網路。若手邊沒有確認過的規則設定，可先使用 Proxy 短暫測試連線，再回到 Config 逐項檢查。若要深入了解規則概念與協定欄位，請參閱協定詳解；如有具體使用問題，請查閱常見問題。
03 · Home 連線與系統授權
確認所選伺服器與模式，再開啟頂端的連線開關。
返回 Home，先確認 SERVER 中選的是剛才輸入或匯入的伺服器，再檢查 Global Routing 顯示的模式是否符合本次測試目的。若使用 Config，也要確認啟用的是剛檢查過的設定檔。核對這三項後，開啟頂端位於 Not Connected 狀態附近的連線開關。
首次建立連線時，系統可能會提示允許新增 VPN 設定。這表示 Shadowrocket 需要透過系統網路延伸功能處理相關流量；此步驟僅用於授予網路權限。閱讀 App 名稱與權限說明後，依照你的意願允許，並依系統要求完成裝置驗證。若取消授權，本次連線便無法完成；請返回 App 重新發起連線，不必反覆重新匯入伺服器。
授權流程結束後返回 Home，查看連線開關與狀態文字是否更新。若畫面仍顯示 Not Connected，請先等目前的請求結束，再確認是否還有待處理的系統提示。不要只根據狀態列上的圖示判斷，因為系統顯示方式可能因裝置與目前畫面而異；請一併確認 App 內的狀態及後續實際請求。
連線狀態不代表目標一定可連線
開關維持開啟，只能表示系統連線流程已建立或正在運作，不能單獨證明所選伺服器、DNS 與目標服務都正常。接著還需要執行 Connectivity Test，並開啟實際要使用的頁面。若有其他設定正在管理裝置的網路連線，請先確認目前生效的是哪一項，以免測試受到其他連線狀態干擾。
首次測試期間，請先保持 On Demand 條件不變，也不要同時切換網路與更換伺服器。測試結束時，返回 Home 關閉連線開關，再確認狀態已恢復。連線資料會繼續保留，關閉開關不會刪除訂閱或伺服器。
04 · Connectivity Test 與實際測試
比對測試結果、目標連線情況與規則記錄。
在 Home 點選或執行 Connectivity Test，等待測試結果顯示。測試用於觀察目前條件下的連線情況，不保證所有目標服務都能連線。結果會受到測試方式、測試目標、目前網路與伺服器狀態影響，因此單次逾時不代表所有請求都失敗，單次成功也不能證明每條規則都正確。
接著開啟實際要使用的目標頁面，重新發出請求，確認是否載入預期內容。盡量開啟新頁面，避免快取內容讓你誤以為目前的連線路徑已生效。若目標原本就能直接連線，只看到頁面開啟仍不足以分辨代理或直連；還需要搭配 Global Routing 與記錄判斷。
查看 Data 中的策略與連線資訊
返回 App 開啟 Data，查看目前介面提供的連線或請求記錄。若能看到目標、符合的規則或策略，請確認是否符合預期：Config 模式下符合 DIRECT 的請求，不應誤判為「代理未連線」；符合 PROXY 後仍失敗的請求，則需要繼續檢查伺服器與目標。記錄名稱與詳細程度會依目前功能和介面而異，請以實際顯示為準。
若仍無法判斷問題所在，可先記下原本的模式，短暫切換至 Proxy 後重試同一個目標，再切換到 Direct 作為基本網路對照。每次只更改模式，並維持伺服器、網路與目標一致，結果才有比較意義。Proxy 可用但 Config 不可用時，優先檢查設定檔規則及所引用的策略；兩者都失敗時，再檢查伺服器欄位與基本網路。
測試結束後，恢復日常使用的模式。若切回 Config，請再次確認啟用的設定檔；不要忘記自己為何切換，而長期保留暫時用來排錯的模式。建議記錄本次使用的伺服器名稱、模式、網路類型與錯誤情況，不必儲存或公開訂閱連結、密碼等憑證。完成這一步後，再考慮是否設定 On Demand 等自動連線功能。
05 · Settings 與常見問題
依網路、資料、授權、規則的順序檢查，每次只修改一項。
訂閱沒有伺服器項目：先檢查內容取得流程
若儲存 Subscribe 後，SERVER 中仍沒有伺服器，請先暫停連線並確認裝置目前的網路可正常連線。接著確認訂閱 URL 是否完整、是否誤複製說明頁面的網址、連結是否已失效，以及訂閱內容是否適用於目前的匯入方式。可向既有資料的提供者確認狀態；本站不提供替代訂閱。保留原有項目，先進行一次結果明確的更新，不要重複新增多筆相同訂閱。
有伺服器項目但連線失敗：重新核對原始欄位
依序檢查 Type、Host、Port、Password 與該協定的其他欄位。Shadowsocks 尤其要核對 Method；其他協定也可能需要額外的識別資訊、傳輸方式或 TLS 設定。不要為了讓測試顯示數字而任意更換參數。若剛更新過訂閱，也請確認目前選取的伺服器沒有因內容變更而失效或遭到移除。
測試逾時：確認 Test Method 與實際連線結果
進入 Settings 查看 Test Method，確認目前的測試方式，再比對實際目標的連線結果。某種測試方式失敗，不一定代表所有 App 請求都失敗；反之，測試有結果但頁面無法載入，也可能與目標、DNS 或規則有關。先釐清「哪項測試、哪個目標失敗」，再縮小檢查範圍，不要一次同時修改 DNS、TCP 與 UDP。
連線狀態反覆變化：檢查 On Demand
On Demand會在符合條件時觸發連線，與 Global Routing 的流量分配不同。若手動關閉後又重新連線，或切換網路後狀態改變，請先檢查是否設定了 On Demand 條件。為了進行可重複的手動測試，可先記下原設定，再暫時關閉相關自動觸發；確認連線後，依實際需求恢復設定。
只有部分目標失敗：檢查規則與診斷資訊
若大多數目標正常，只有某個目標失敗，請先在 Config 核對相應的 Rule 與最終策略，再查看 Data 中的相關記錄。Settings 裡的 Diagnostics 可供進一步排查，但診斷資訊必須對照錯誤發生時間、所選伺服器與模式才有意義。對外提供截圖或記錄前，請刪除訂閱 URL、密碼、存取憑證及不必要的個人網路資訊。
若切換模式後能穩定重現差異，請保留這組比對結果，不必急著重新安裝 App。重新安裝會增加還原資料的工作，也無法自動修正錯誤欄位或失效訂閱。如需更多購買、訂閱與設定資訊，請查閱常見問題；若想了解協定參數與選擇方式，請繼續閱讀Shadowsocks 與協定參考。
