01 · Add Server：新增現有伺服器

開啟 Shadowrocket，進入 Home，點選新增按鈕開啟 Add Server。先選擇 Type，再填寫其他欄位。Type 必須與現有資料中的協定相符，不能只憑伺服器名稱猜測。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等類型所需欄位各不相同；切換 Type 後，請重新檢查畫面上標示的必填項目。

將伺服器位址與連接埠分別填入對應欄位。位址欄通常只接受主機名稱或 IP 位址，請勿將整段網頁網址連同連接埠一起貼入。依資料填寫驗證資訊，並留意前後空格、換行與大小寫。若資料包含 TLS、傳輸方式或其他附加參數，也要逐項填妥；不能只填位址與驗證資訊就儲存。

確認 Type 與資料相符，再檢查位址、連接埠及驗證欄位。
核對附加參數；資料未提及的選項請勿任意啟用。
填寫方便辨識的備註，儲存後返回 Home。
點選剛新增的項目，確認它已顯示為目前選取項目。

儲存成功只代表用戶端接受了這些欄位，不表示伺服器端已通過驗證。暫時不要連續更改多個參數；先保留這份設定，稍後使用一致的驗證方式檢查。若現有資料是 QR code，可使用 Scan QR Code 掃描，儲存前仍須核對協定、位址與附加參數。

Home 已顯示伺服器後，可略過訂閱步驟，繼續檢查 Config。若要透過訂閱統一管理多筆伺服器資料，請依下一步匯入，不必再逐筆手動輸入相同內容。

訂閱 URL 用來取得伺服器項目，並非一般的服務介紹網頁。請先從自己的服務商資料複製完整連結，再到 Home 開啟 Add Server，將 Type 設為 Subscribe，並在 URL 欄位貼上連結。可填寫方便辨識的備註；確認無誤後儲存，等待用戶端取得並解析訂閱內容。

貼上時請勿手動刪除問號後方的參數。部分連結中的參數用於識別存取權限，少一個字元就可能導致取得失敗。若複製的內容含引號、前後空格或換行，請對照原始資料修正。請勿將含有個人驗證參數的實際連結傳給他人代為測試。

儲存後返回 Home，檢查對應的訂閱群組是否顯示伺服器項目。看得到群組名稱但內容為空，不代表匯入成功。請區分「已儲存訂閱位址」與「已解析伺服器清單」這兩種結果。清單正常顯示後，展開群組並選取準備使用的項目，再進行後續連線步驟。

Subscribe 更新後的檢查

服務商通知內容有變更，或現有項目可能已過期時，請在 Home 對應訂閱的操作選單中執行更新。選單位置與顯示方式可能因 App 介面而異，請以目前畫面為準。更新完成後，重新檢查清單與選取項目；原有項目可能已調整或移除，不能只看到更新完成就繼續使用原本的選取項目。

請勿在短時間內反覆重新整理來代替排查。更新失敗時，先記下錯誤狀況，確認目前裝置能否存取訂閱位址，以及服務商是否說明存取限制。若訂閱清單正常但伺服器連線失敗，應繼續檢查伺服器參數與連線路徑，而非立即刪除整個訂閱。

若要進一步分辨連結格式與伺服器端回應問題，可閱讀訂閱匯入失敗或節點清單為空的自我檢查筆記。匯入完成後，下一步是檢查決定規則行為的設定檔。

03 · Config：確認目前設定檔

開啟 Config，查看目前啟用的設定檔。伺服器項目決定可使用哪條連線，設定檔則描述規則等處理設定，兩者並非同一份內容。成功匯入訂閱，不代表 Config 中的規則已更換；反之，選取設定檔也不會自動補齊缺少的伺服器驗證資訊。

首次使用時，先確認目前設定即可，不必為了完成連線測試而立即取代整份檔案。若已有可信任且了解用途的設定，可依其說明在 Config 中匯入並選用。匯入前請保留原始檔案，修改前先另存副本。來自不明來源的設定可能會改變流量處理路徑，請勿只憑檔名決定是否啟用。

以下僅以簡短規則說明閱讀順序，不需要直接覆寫目前檔案。範例中的 example.com 是示範網域；PROXY 對應的實際代理選項，仍須核對目前設定與用戶端設定。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

使用 Config 模式時，請求會依規則順序尋找符合項目。第一行依網域後綴比對，第二行依目標 IP 範圍比對，FINAL 則處理前面沒有符合的請求。因此，「檔案中有某條規則」不代表它一定會命中；前置規則與最終策略同樣重要。

此處先確認「知道目前使用哪份設定檔」。若要回顧三種處理方式，請參閱Global Routing 步驟；App 取得方式、商店地區與購買項目還原等完整說明，請參閱安裝指南。

04 · Global Routing：選擇處理方式

返回 Home，開啟 Global Routing。此處決定請求整體採用哪種處理方式，不負責匯入伺服器，也無法修正錯誤的驗證欄位。三種模式分別是 Config、Proxy、Direct。請先依目前需求選擇，再返回 Home 確認所選模式。

Config: 依目前啟用的設定檔比對規則，並執行對應策略。若要區分不同目標的處理路徑，請使用此模式。使用前應了解目前設定檔及其最終策略，否則特定請求的實際路徑可能與預期不同。
Proxy: 以代理方式處理由用戶端接管的請求，適合初步檢查時減少規則差異的干擾。此模式仍仰賴正確選取伺服器並填妥參數，無法讓無法使用的伺服器恢復正常，也不代表每個 App 的所有流量都一定會由用戶端接管。
Direct: 以直連方式處理請求，可用來對照目前網路本身的存取狀況。這不等於關閉用戶端連線開關。若要完全停止目前連線，請返回 Home 關閉開關，而非只切換為 Direct。

首次驗證時，可先使用 Proxy 檢查已選取的伺服器，再切換至 Config 檢查規則行為。若 Proxy 下目標正常、Config 下異常，應優先檢查規則與策略，而非立刻重新填寫伺服器資料。若兩種模式都失敗，也不能直接判定伺服器失效，還需檢查系統連線狀態與目標服務本身。

每次切換後都使用同一目標重新送出請求，避免拿不同網頁的結果互相比較。驗證結束後，恢復準備長期使用的模式，並記下目前設定檔與伺服器名稱，方便日後重現問題。

05 · Home：開啟連線並完成系統授權

在 Home 再確認兩件事：目前選取的確實是準備使用的伺服器，Global Routing 也確實是剛才選擇的模式。接著開啟頂端的連線開關。首次建立連線時，系統可能會要求新增 VPN 設定；確認要求是由目前操作的 Shadowrocket 發起後，再依系統提示允許並完成裝置驗證。

這項系統授權可讓用戶端建立所需的網路處理設定，不是購買提示，也不代表伺服器驗證已成功。若先前取消了要求，請返回 Shadowrocket 再次發起連線，並依系統提示操作。若開關未能維持開啟，請勿因此反覆新增伺服器；輸入資料與系統授權屬於不同的檢查環節。

完成授權後返回 App，查看開關與連線狀態是否維持正常。系統顯示 VPN 狀態，只能表示相應的網路連線狀態已建立，無法單獨證明目標網站能正常存取，更不能證明某條 Rule 已命中。此時應進行下一步的實際驗證，而非只看狀態標示就結束操作。

若裝置上已有其他 VPN 連線，請先確認目前使用的是哪一個，再進行對照測試。若連線會在特定網路下自動恢復，可到 Settings 檢查 On Demand 是否啟用；初次排查時建議先記下相關設定，避免將按需連線行為誤判為手動開關失效。受管理裝置的限制，請依管理規範處理。

06 · Connectivity Test：確認是否生效

返回 Home，執行 Connectivity Test，查看已新增伺服器的測試結果。測試方式與目前網路都會影響結果，請先確認此次測試所使用的設定。某筆記錄有回應，只代表它通過該項測試；不代表驗證、目標服務存取及所有服務請求都已通過檢查。

接著開啟瀏覽器，存取一個你有權使用、且能明確判斷是否載入完成的目標服務。請勿只看頁面標題或快取圖片，應重新載入並確認實際內容已傳回。若目標服務需要登入，請先區分登入狀態與網路連線問題，不要將權限提示直接視為連線失敗。

記下測試時使用的網路、伺服器、Global Routing 與目前 Config。
使用 Proxy 重新存取同一目標，確認基本代理路徑。
切換至 Config，重新存取並核對規則處理結果。
需要對照時使用 Direct，之後再切回預期模式。

若要確認規則是否生效，請查看 App 中可用的連線記錄或日誌，找到剛才送出的目標請求，再核對符合的規則與執行策略。網域命中 DOMAIN-SUFFIX 與最後套用 FINAL 是不同結果；即使兩者剛好採用相同策略，也不應視為命中同一條規則。

延遲測試數值反映特定測試方式下的回應狀況，並不等同於實際傳輸速度。App 內測試正常但網頁異常時，也應考慮 DNS、目標服務狀態與驗證問題。每次只更換一個條件，並重複相同操作，才能判斷變化來自伺服器、網路還是設定。

07 · 依失敗環節排查，勿反覆清空設定

先用一句話描述問題發生在哪個環節：「訂閱未解析出項目」、「開關無法維持開啟」、「測試有回應但網頁無法開啟」或「只有 Config 模式下異常」。這些狀況各自對應不同環節。請先儲存目前設定與必要記錄再處理；不要同時刪除訂閱、更換伺服器、修改 DNS 和取代規則，否則難以判斷是哪項修改產生影響。

訂閱已儲存，但清單是空的

返回Subscribe 步驟，確認 URL 是否完整、是否為訂閱位址，以及目前的存取權限是否有效。若回傳的是登入頁面或錯誤說明，用戶端可能無法將其解析為伺服器清單。若需確認內容格式或權限，請聯絡自己的服務商，不必先修改 Global Routing。

伺服器已列出，但連線失敗

先確認是否選取正確項目，再逐一核對 Type、位址、連接埠、驗證資訊與附加參數。透過訂閱管理的項目，可先正常更新一次，再重新選取。手動輸入的項目則請依原始資料逐項比對。若改用另一種可用網路後結果不同，請記下網路差異，不要據此直接修改驗證欄位。

開關無法開啟，或開啟後很快中斷

檢查系統授權是否完成、是否有其他正在使用的 VPN 連線，以及裝置是否受到管理限制。若開關會自動重新開啟，請檢查 On Demand 的條件。先處理系統連線環節，再測試網頁存取；反覆修改規則通常無法解決授權尚未完成的問題。

Proxy 正常，部分目標在 Config 下異常

確認 Config 中啟用的是預期檔案，查看目標請求實際符合的規則，並檢查 FINAL 的指向。網域規則與 IP 範圍規則的比對依據不同，DNS 結果也可能影響後續處理。請先在副本中修改單一規則並重新測試，不要為了單一目標取代整份規則。

測試有回應，但實際服務仍無法使用

檢查目標服務是否正常、帳號是否具備存取權限，以及用戶端記錄中是否出現驗證、解析或連線錯誤。向服務商回報時，請說明發生時間、目前網路類型、協定類型與已完成的對照步驟；並隱藏訂閱 URL、密碼及其他驗證資訊。測試結果僅供參考，應一併檢視實際請求狀況。

之後若只需更新現有訂閱，可直接前往訂閱更新步驟；若要比較分流行為，請返回Global Routing 說明。更換裝置、重新安裝或購買記錄相關問題，請閱讀App Store 安裝指南，不必重新從伺服器參數開始排查。

Shadowrocket 使用教學