1. Add Server / Subscribe：新增與匯入
先確認手邊資料屬於哪一種：用於更新伺服器清單的完整連結，請以訂閱方式匯入；單一伺服器的位址、連接埠、協定與驗證資料，則以新增單一伺服器的方式處理。兩種方式都從 Home 開始，不要將訂閱連結填入伺服器位址欄，也不要把只有伺服器資料的文字當成訂閱連結提交。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket，進入 Home，點選右上角的新增入口，再進入 Add Server。在 Type 選擇 Subscribe，將完整訂閱連結填入 URL，並在 Remarks 輸入方便辨識的名稱，例如「個人訂閱」。名稱僅供本機辨識，無法修復連結，也不會改變伺服器本身。儲存前請檢查連結開頭、路徑與查詢參數是否完整，尤其不要漏掉問號後方的內容。
儲存後返回 Home，等待訂閱請求完成，並確認對應群組中已出現伺服器項目。若只看到訂閱名稱、群組內卻沒有項目，不代表匯入成功；請先確認是否仍在更新或出現請求失敗訊息，再回頭核對原始資料。部分訂閱網址在瀏覽器中顯示為文字或編碼內容，不要只因頁面沒有一般網頁排版，就判定連結失效。
若資料是透過訊息或文件傳送，複製時請留意行尾空格、換行、中文標點及遭截斷的尾端參數。訂閱連結通常包含存取憑證，請勿將完整網址放在公開截圖、文章留言或測試紀錄中。若要確認訂閱是否有效，請透過原有服務管道查詢狀態，不要反覆建立相同訂閱。
已有單一伺服器：依協定逐項填寫
同樣進入 Add Server，在 Type 選擇資料明確指定的協定，再填入伺服器位址、連接埠與驗證欄位。不同協定所需欄位各異：密碼、識別碼、傳輸方式與 TLS 相關設定不能互相替代。請先依原始資料完整填寫，不要因為不熟悉某個欄位就留空，或照抄其他伺服器的設定。
伺服器位址欄通常只填入提供的主機名稱或 IP 位址；連接埠請填在對應欄位，不要將包含路徑的完整網頁網址貼進去。若已有可匯入的伺服器連結，或資料以 QR Code 提供，也可使用 App 對應的匯入入口或 Scan QR Code；匯入後仍須開啟項目，核對協定、位址與連接埠，不能只確認名稱是否正確。
儲存並返回 Home 後，選取準備使用的伺服器，確認目前的選取標記。清單中有多個項目，不代表它們會同時處理請求；首次測試請先選定一項並記下名稱，後續測試與瀏覽都使用同一項目。此時先不要開啟 On Demand，以免自動連線條件干擾手動驗證。
2. Global Routing：選擇連線模式
匯入伺服器後，下一步是決定如何處理請求。在 Home 開啟 Global Routing，確認目前的選擇。三種模式分別是設定 (Config)／代理 (Proxy)／直連 (Direct)：它們會改變路由決策方式，但不會替你修正伺服器密碼，也無法讓失效的訂閱恢復有效。
設定 (Config)：依目前設定決定策略
設定 (Config) 會依照目前生效設定中的規則處理請求。進入 Config 後，先確認實際啟用的是哪個檔案，再查看其中包含的規則與策略。僅匯入伺服器訂閱，不代表所有目標都已有符合預期的分流規則；伺服器清單與規則設定負責不同工作，請分別核對。
查看規則時，請留意符合條件、順序與最後的處理方式。DOMAIN-SUFFIX 用於比對網域後綴，IP-CIDR 用於比對位址網段，FINAL 表示前面的規則都未符合時採用的策略。下方僅為規則語法範例，並非可直接匯入的完整設定；example.com 是示範網域，不代表實際測試目標。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY其中 PROXY、DIRECT 是策略關鍵字，不是伺服器名稱。PROXY 表示交由代理策略處理，DIRECT 表示直接連線；若規則或策略群組另有指定，還須進一步核對實際選擇。不要只因為看到某條規則，就認定請求一定符合該規則：前置規則、目前生效的檔案，以及請求使用的網域都可能影響結果。
代理 (Proxy)：單獨核對代理連線
代理 (Proxy) 會將適用流量交由目前的代理策略處理。首次排查時，可暫時使用此模式，分別確認「伺服器是否正常」與「規則是否依預期符合」。這不能證明所有 App 的行為都一致；系統流量範圍、目前網路與目標服務本身的狀態仍會影響瀏覽結果。測試結束後，若要使用規則分流，記得切回設定 (Config)。
直連 (Direct)：確認直接連線基準
直連 (Direct) 用於直接連線，不能作為代理連線已生效的證據。此模式適合用來對照目前網路能否直接連線至某個目標。若切換至直連 (Direct) 後頁面可以開啟，只能表示此次直接連線成功，不能證明伺服器參數正確。開始下一步連線前，請再次確認 Global Routing，避免將暫時測試模式當成最終設定。
3. Home：開啟連線並完成系統授權
返回 Home，依序核對目前的伺服器、Global Routing 與網路。首次操作建議保持網路不變，例如先在同一個 Wi-Fi 下完成一輪測試，再單獨測試行動網路。伺服器尚未選定前，不要反覆開關連線，也不要同時更換伺服器、網路與規則檔案，否則發生問題時難以判斷是哪個項目造成變化。
開啟 Home 頂端的連線開關。首次連線時，系統可能會提示新增 VPN 設定；這是 App 建立系統網路連線所需的授權步驟。請閱讀提示中的 App 名稱與說明，確認是由此次操作觸發後，再依系統提示完成確認與身分驗證。授權程序會在系統介面中完成，不需要將裝置解鎖資訊或 Apple 帳號憑證填入伺服器項目。
返回 Shadowrocket 後，確認開關與連線狀態是否維持開啟。若開關立即恢復關閉，請先檢查是否取消了系統授權、是否有待處理的提示，以及是否有其他 VPN 設定正在使用。可在系統 Settings 中查看相關 VPN 狀態，再返回 App 嘗試；不要為了讓開關維持開啟，就任意刪除用途不明的系統設定。
連線狀態建立，只表示系統連線通道已啟動，不代表選取的伺服器能連線至所有目標。密碼、連接埠或傳輸參數錯誤，仍可能導致實際請求失敗。因此，完成授權後應立即進行下一節的測試，不要把狀態列圖示當成最終結果。iPhone 與 iPad 的狀態列顯示方式可能受裝置與系統介面影響，請交叉核對 App 與系統顯示的連線狀態。
本輪測試結束後，請在 Home 關閉連線開關，並確認系統連線已結束。若之後發生自動連線，請確認 On Demand 是否已開啟。首次手動操作流程完成前，讓自動連線條件保持不參與測試，可減少「剛關閉又重新連線」造成的誤判。
4. Connectivity Test：驗證是否生效
驗證分為三個層面：伺服器測試是否有結果、系統連線是否建立，以及實際請求是否採用預期策略。三者回答的問題不同，不能互相取代。先在 Home 使用 Connectivity Test 測試已選取的伺服器，等結果穩定後再進行實際瀏覽；測試期間不要一邊切換項目，一邊把前一項的結果誤認為來自另一台伺服器。
Connectivity Test 的結果取決於測試方式與目標。有數值只代表該項測試收到回應，不表示所有網頁與 App 請求都能正常使用；出現 timeout 時，也須配合目前的測試方式與目標判斷，不能只憑一次結果就認定所有伺服器都已失效。首次操作請優先留意目前選取的項目，避免將整份清單的結果混在一起比較。
接著開啟瀏覽器，瀏覽你已知在目前網路下通常能正常開啟的頁面，再瀏覽需要核對策略的目標。每次都重新送出請求，不要只看已載入的舊頁面或快取內容。記錄「目標、網路類型、伺服器、Global Routing 模式」，比只記下「可用」或「無法使用」更有助於後續排查。
使用設定 (Config) 時，可查看 App 的 Data 中可用的連線紀錄，找到剛才送出的請求，核對紀錄顯示的目標、規則與策略。不同紀錄可提供的資訊可能不同；若看不到策略細節，請勿自行推測。重點是確認目前使用的是生效中的設定，並判斷請求採用 DIRECT、PROXY 或設定中指定的其他策略是否符合預期。
若在代理 (Proxy) 模式下可以瀏覽，但設定 (Config) 下的結果不如預期，請先返回 Config 檢查規則順序與策略選擇，不要立刻修改伺服器驗證參數。若兩種模式都失敗，而直連 (Direct) 可以開啟對照頁面，請繼續檢查伺服器與連線路徑。這項對照只能縮小排查範圍，仍須根據具體目標與錯誤紀錄判斷。
5. 常見問題：依序定位
從最早發生問題的步驟開始排查。清單為空時，先處理匯入；項目存在但測試失敗時，先檢查伺服器參數；連線建立後只有部分目標異常時，再檢查規則與目標連線。先保留原始設定與現有項目，每次只變更一項，重新測試並記錄結果。反覆刪除、重新匯入與更換規則，往往會讓原本單一的問題變得難以確認。
訂閱儲存成功，但清單為空
先返回 Subscribe 項目，確認 URL 完整，並確認複製的是訂閱網址，而非帳戶頁面或介紹頁面。查看更新是否完成，確認目前網路能否連線至該網址，再透過原有服務管道確認訂閱狀態與內容是否有效。若更新回傳錯誤或空白內容，重複新增相同連結通常無法解決問題；請先確認錯誤發生在請求階段還是內容解析階段。
若更新前已有可用項目，請先保留現有資料，不要為了重新取得清單而大量刪除項目。記錄問題是在手動更新後、切換網路後，還是重新開啟 App 後發生，有助於判斷是否與更新時機有關。更多排查步驟請參閱訂閱更新後節點清單為空的自我檢查順序。
Connectivity Test 顯示 timeout
先確認測試對象確實是目前選取的伺服器，再逐項核對位址、連接埠、協定、驗證與傳輸參數。確認裝置日期與時間正確，尤其是需要 TLS 或與時間相關的驗證時，系統時間不正確可能導致連線失敗。接著改用另一種實際網路重新測試，區分目前網路與伺服器本身的問題；切換網路後仍須使用同一台伺服器及同一測試目標。
不要憑猜測反覆更換連接埠、關閉驗證或修改 TLS 設定。參數應以你已有的伺服器資料為準，服務狀態則應透過原有服務管道確認。若需要更詳盡的紀錄方式，請參閱節點逾時與連線失敗排查，依序保存結果。
已建立連線，但網頁無法開啟
先確認原本的網路可以瀏覽對照頁面，排除 Wi-Fi 尚未完成網路登入、行動數據無法使用等基本問題。接著核對 Global Routing：若目前是直連 (Direct)，請勿預期請求會採用代理策略；若使用設定 (Config)，請檢查目前生效的檔案與符合的策略。只有明確出現網域解析相關錯誤時，才進一步排查 DNS 設定，避免同時變更伺服器、規則與 DNS。
若只有單一目標無法連線，先用其他已知可用的目標進行對照，並查看該次請求紀錄。目標服務本身異常、規則符合不符預期、伺服器存取受限與驗證失敗，可能呈現不同結果，不能一概歸因於「App 未連線」。若只有某個 App 異常，請重新送出該 App 的網路請求，並留意既有連線或快取可能使觀察結果延遲。
變更設定後，結果變得混亂
返回最近一次有明確紀錄的狀態：還原原本的伺服器、Global Routing 與設定檔，關閉本輪新增的 On Demand 條件，再從驗證步驟重新測試。不要把一次暫時成功視為設定已穩定；請在相同條件下重複驗證，再分別檢查切換網路後的情況。
排查紀錄只需保留時間、網路類型、伺服器的本機名稱、模式與錯誤現象。向他人說明問題前，請遮蔽完整訂閱連結、密碼、金鑰及其他驗證資料；分享設定片段前，也應先確認其中不含這些資訊。若要重新確認購買、從商店取得 App 或換機還原流程，請前往安裝指南，不要將取得 App 的問題與現有伺服器的連線問題混為一談。