官方手冊 / 快速入門
Shadowrocket 訂閱匯入與規則設定
依序進行新增、選擇模式、連線、驗證與排查。首次設定先建立一條可供確認的連線，再調整分流規則，不必一次改完所有設定。
截圖取自 App Store 官方展示，用於辨識介面項目。實際顯示的欄位可能因 Type、裝置及 App 介面而異，請以目前 App 顯示為準，不要照抄截圖中的連線參數。
STEP 01 / IMPORT
Add Server：新增伺服器或匯入訂閱
先確認手上的是訂閱連結，還是單一伺服器的參數。訂閱連結用來取得並更新一組伺服器資料；手動輸入則須逐項填寫。兩者不是同一種資料，不能將整條訂閱網址直接填入伺服器的 Host。開啟 Shadowrocket，進入 Home，在 SERVER 分組中找到 Add Server，或使用頁面上的新增入口進入編輯頁面。
已有訂閱連結：選擇 Subscribe
在 Add Server 中點選 Type，選擇 Subscribe，再將自己的完整訂閱連結填入該類型對應的網址欄位。可填寫方便辨識的名稱，但不要把帳號密碼寫進名稱。確認貼上的內容首尾完整，沒有混入聊天說明、空格或換行，再儲存並返回 Home 等待匯入結果。
匯入成功後，SERVER 清單中應會出現訂閱提供的伺服器資料或相應分組。請確認看得到預期的名稱；若只看到訂閱名稱，卻沒有伺服器內容，就還沒完成連線準備。若 App 顯示取得失敗，先檢查網址是否仍有效、目前網路能否連線至該網址，再確認訂閱回傳的內容是否適用於 Shadowrocket。不要連續重複新增同一個訂閱，否則之後更難辨認選取項目。
已有伺服器參數：依 Type 逐項填寫
手動新增時，先依自己持有的資料選擇 Type，再填寫 Host、Port 及該類型要求的驗證欄位。例如，是否出現 Password、Method，取決於所選類型；不要為了讓編輯頁面看起來像截圖而更改協定。Host 通常填寫伺服器網域名稱或 IP 位址，不應額外加上網頁路徑；連接埠也必須與伺服器端設定一致。
如果手上有用於匯入的 QR Code，可在 Add Server 頁面使用 Scan QR Code，辨識後仍須確認欄位內容。Import from Cloud JSON 是另一種匯入方式，僅在已有適用內容時使用，與 Subscribe 不同。匯入可減少手動輸入，但無法證明遠端伺服器目前可用。
儲存後返回 SERVER，點選準備測試的項目，確認選取標記位於預期的資料上。若清單中有同名項目，請先核對所屬分組與伺服器資料，再進行下一步。訂閱連結可能包含存取憑證，排查問題時不要公開完整網址或 QR Code。若想進一步了解訂閱與設定檔的差異，請參閱使用手冊。
STEP 02 / ROUTING
Global Routing：選擇設定檔、代理或直連
有伺服器不代表已決定所有請求的連線路徑。返回 Home，點選 Global Routing 查看目前模式。三種常用模式為設定檔 (Config)、代理 (Proxy) 與直連 (Direct)。它們決定請求如何選擇路徑；伺服器清單中的選取項目則決定需要代理時使用哪條連線，這兩處都要分別確認。
設定檔 (Config)：依目前設定檔處理請求
選擇設定檔 (Config) 後，請求會依目前設定檔中的規則與策略處理。使用前先進入 Config，確認已選取要使用的設定檔，而不只是將檔案匯入清單。官方截圖展示的是設定檔編輯頁面，可看到 General、Rule、Hosts 等區段；日常使用不必逐段修改，也不需要為一般連線啟用 HTTPS Decryption。
訂閱通常管理伺服器清單，設定檔則管理規則等設定，因此成功匯入訂閱不代表已套用任何分流規則。在 Rule 中檢視規則時，須一併確認比對條件、順序及目標策略。以下僅為說明規則判讀順序的範例，並非可直接貼上的完整設定；實際設定中的策略名稱必須確實存在。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY範例會先判斷網域後綴，再判斷 GEOIP 條件；前面都未符合時，才會套用 FINAL。其中 example.com 僅用於說明語法，不是伺服器網址，也不應視為連線資料。若暫時看不懂規則，請保留原設定，先使用下方模式進行對照；首次測試時不要同時新增或刪除多條規則。
代理 (Proxy) 與直連 (Direct)：用於明確對照
代理 (Proxy) 會讓一般請求經由代理路徑處理，可用來判斷問題是否來自規則分流；但不保證速度，實際情況仍受相關設定與網路環境影響。直連 (Direct) 則使用本機網路路徑，不經由選取的遠端代理伺服器，適合檢查基本網路是否正常。選擇 Direct 後能開啟目標網站，並不能證明代理伺服器正常。
初步排查時，可先選擇代理 (Proxy)，確認已選取的伺服器能否連線，再切回設定檔 (Config) 檢查日常分流。每次切換後，返回 Home 確認 Global Routing 顯示的模式；測試結束後，請恢復所需模式。規則順序與策略引用的詳細說明，請參閱使用手冊；本頁先協助完成一條連線。
STEP 03 / CONNECT
Home：開啟開關並完成連線授權
先確認伺服器與模式，再開啟頂端開關。返回 Home，在 SERVER 中確認目前選取的項目，再檢查 Global Routing。頂端顯示 Not Connected 代表目前尚未建立 App 連線，不表示伺服器資料一定有誤；新增資料與實際啟動是兩個不同步驟。
開啟頂端的連線開關。首次啟動連線時，系統可能會要求允許新增 VPN 設定。請閱讀系統提示，確認這是由目前操作觸發的要求後再允許；若系統要求裝置身分驗證，請依照裝置提示完成。此授權可讓 Shadowrocket 在系統層級處理相關網路流量，但不會替你補齊伺服器參數，也不代表遠端驗證已成功。
完成授權後返回 App，確認開關與連線狀態是否維持啟用。若先前拒絕授權，再次啟動時請依照 App 與系統提示操作，不要為了重試而先刪除所有訂閱。若裝置由組織管理，或相關權限受到限制，應先確認裝置管理規範，單靠反覆切換模式無法解決問題。
連線開關維持開啟後，先不要修改其他設定，接著進行下一步驗證。系統連線圖示只能表示相關網路設定正在運作，無法單獨證明每個網站都依預期路徑連線。若開關隨即關閉、授權未完成或出現錯誤訊息，請記下訊息原文及發生的步驟，再前往第五步分類檢查。
為了讓首次測試結果更容易判斷，建議先維持相同的本機網路環境，不要在開啟開關的同時切換 Wi-Fi 與行動網路。也不要同時修改伺服器、模式與設定檔；連線成功後，才能確認是哪組設定有效。之後再切回日常使用所需的設定檔 (Config) 模式，並重新驗證一次。
STEP 04 / VERIFY
Connectivity Test：確認測試結果與實際連線狀況
有效驗證須同時查看測試結果、實際連線與目前模式。先在 Home 使用 Connectivity Test，確認準備使用的伺服器是否回傳測試結果。測試數值僅代表目前測試方法的一次結果，不是下載速度，也不保證所有目標都能連線。即使顯示逾時，也須搭配測試方法與實際連線狀況判斷，不要只憑一個數值就修改所有參數。
接著開啟瀏覽器或目標 App，造訪一個預期會由目前設定處理的頁面，並等待完整載入一次。盡量開啟新頁面或重新送出請求，避免只查看快取內容。記錄目前選取的伺服器、Global Routing 模式、使用的網路及實際狀況：是完全無法載入、部分內容失敗，還是能開啟但速度不理想。這些差異會影響下一步該檢查規則、伺服器或本機網路。
接著返回 Shadowrocket，查看 Data 中可用的流量或活動紀錄。數據變化可協助確認 App 正在處理請求，但總量增加不代表特定目標套用了指定策略。若目前介面提供相關請求詳細資訊，請搭配目標、規則與策略內容一併確認；不要只以狀態列圖示或單一外部位址顯示結果作為判斷依據。
若使用代理 (Proxy) 時連線正常，但在設定檔 (Config) 下無法連線至同一目標，請先檢查目前設定檔、規則順序、目標策略及相關解析設定，不要立刻重建伺服器。相反地，若兩種模式都無法連線，可先維持現有參數，關閉連線後檢查本機網路，再用自己已有的另一筆伺服器資料進行對照。
若只是速度較慢，先區分首次載入、持續傳輸與偶發中斷，不要將這些狀況一概視為延遲問題。更多依現象分類的檢查方式，請參閱疑難排解；本頁接著處理初次使用時最常遇到的問題。
STEP 05 / CHECK
Settings：依失敗環節檢查，避免同時修改多項
先找出問題發生在哪個步驟，再檢查相應設定。Settings 中的選項並非初次連線都必須調整的清單。截圖中的 Test Method、On Demand、Diagnostics 各有不同用途，不能只切換一個開關就取代所有排查。開始前記下目前的伺服器、模式及錯誤訊息原文，並保留可還原原狀的紀錄。
訂閱沒有內容：先檢查匯入步驟
如果 SERVER 中沒有預期的資料，先返回訂閱項目，確認網址完整且仍有效。檢查目前本機網路是否能成功取得內容，再確認回傳格式是否相容。即使先前曾成功，連結的存取權限或內容仍可能變更；這類情況應向自己原有服務的提供者確認。不要把伺服器資料缺失誤認為是 Global Routing 選錯。
清單有資料但無法連線：確認參數與授權
開啟所選資料的編輯頁面，逐項確認 Type、Host、Port 及驗證資料，特別留意複製時混入的空格、遺漏字元，以及與伺服器要求不符的傳輸選項。只修改已確認有誤的欄位，儲存後重新選取該項並測試。若頂端開關無法維持開啟，請先確認系統授權與 App 提示，不要急著調整規則。
測試逾時或結果不一致：檢查 Test Method
在 Settings 查看 Test Method，確認目前結果是由哪種測試方式產生，再以相同方式比較自己已有的伺服器。若部分測試失敗但實際連線成功，應先釐清測試條件，不要直接以測試數值判定整條連線。若實際連線也失敗，可保留 App 設定，分別測試 Wi-Fi 與行動網路，每次只更換一項條件。
連線狀態自動變動：檢查 On Demand
若手動關閉後連線又重新啟動，或切換網路時連線狀態改變，請檢查是否已啟用 On Demand 及其條件。這項功能用於依條件管理連線，無法修復錯誤的伺服器密碼或失效的訂閱。若要建立明確的手動測試基準，請先記下目前條件，再暫時關閉相關自動功能；測試結束後，依自己的使用需求恢復設定。
只有部分目標連線失敗：返回 Config 檢查規則
若大多數連線正常，只有特定目標失敗，請優先比較代理 (Proxy) 與設定檔 (Config) 的結果，並檢查目前啟用的設定檔。不要為了測試單一目標而變更所有解析與傳輸設定，也不要任意啟用 HTTPS Decryption。若需要進一步記錄，可查看 Diagnostics 提供的診斷功能；分享任何紀錄前，請遮蔽訂閱網址、密碼、驗證欄位及個人請求資訊。
若仍無法找出原因，整理「失敗步驟、錯誤訊息原文、模式、網路環境，以及已完成的一項對照測試」即可繼續排查，不必公開完整設定。請依現象前往疑難排解；如需了解 Config、Data 或日常維護的完整說明，請參閱完整使用手冊。問題解決後，返回常用模式並重做第四步驗證，建立可重複使用的檢查流程。
