Shadowrocket 使用教學
依新增、模式、連線、確認與排除問題的順序操作。先完成一條可供核對的連線，再調整規則或自動連線條件；本頁僅說明首次使用所需的設定。
閱讀順序：首次設定請從第 01 步開始；若已開啟開關但無法正常瀏覽，可直接從第 04 步確認。需要了解協定參數時，再前往協定手冊，首次連線前不必逐項修改進階設定。
Add Server / Subscribe
選擇符合現有資料的入口，儲存後先確認 SERVER，不必急著開啟連線。
開啟 Shadowrocket，進入 Home，找到 Add Server。開始填寫前，先確認手上的資料是哪一種：單一伺服器的位址與驗證參數、可更新的訂閱連結，或包含伺服器資訊的 QR Code。這三種資料用途不同，不應將整段訂閱連結填入 Host，也不應將一般網頁網址當成訂閱內容匯入。
手動填入已有的伺服器資訊
進入 Add Server 後，先點選 Type，選擇與現有伺服器資訊相符的協定。類型會決定接下來需要填寫哪些欄位；截圖呈現的是一組具體欄位，不代表所有協定都需要相同參數。依資料填寫 Host、Port 及對應的驗證資訊；只有所選類型要求時，才填寫 Password、Method 等項目。
逐項比對時，特別留意位址前後是否有空格、連接埠是否完整，以及驗證內容是否區分大小寫。伺服器位址、用於 TLS 驗證的名稱及其他傳輸設定不一定相同，不要只因看起來相似就互相替代。資料未要求的進階項目先維持原狀；遇到不熟悉的欄位，請參閱協定手冊中的參數說明，不要自行猜測填入。
透過 Subscribe 匯入已有訂閱
如果已有完整的訂閱連結，請在 Add Server 的 Type 中選擇 Subscribe，將連結填入對應的 URL 欄位，確認複製內容沒有截斷或夾帶說明文字，再儲存。訂閱網址可能包含存取個人訂閱所需的驗證資訊，請妥善保管，不要直接貼在公開求助內容或截圖中。
儲存後返回 Home，查看對應的訂閱群組及其中的伺服器項目。若暫時沒有內容，請檢查訂閱更新狀態，並使用訂閱項目提供的更新功能重新取得一次；接著再確認清單是否有變化。成功儲存只代表新增了記錄，不代表一定能讀取遠端內容，也不代表回傳內容一定能解析。若清單持續空白，應先檢查完整連結與訂閱狀態，不要反覆新增同一筆記錄。
使用 Scan QR Code 前，先確認資料類型
已有 QR Code 時，可使用 Scan QR Code，依系統提示授予本次掃描所需的相機權限。讀取後請檢查匯入的是單一伺服器還是訂閱，並核對協定、位址等內容。Import from Cloud JSON 是另一種資料匯入入口，只有在已有符合該入口的資料時才使用；它不是所有訂閱連結通用的貼上位置。
本步完成的判準是：SERVER 中看得到與現有資訊相符的項目，且可以開啟並核對欄位。此時先保留一個明確的測試對象，接著設定 Global Routing。伺服器項目、訂閱與設定檔的差異，可參閱術語表。
Global Routing 三種模式
配置(Config) / 代理(Proxy) / 直連(Direct)。先確認目前模式，再判斷瀏覽結果。
儲存伺服器資料後，返回 Home，點選 Global Routing。這裡用來決定流量的處理方式，不是用來選擇伺服器的替代入口。首次排查時，請記下目前選項；同一筆伺服器資訊在不同模式下可能有不同表現，容易把規則問題誤認為伺服器問題。
配置(Config)：依目前設定處理流量
需要依規則分流時，使用配置(Config)。此模式下也應查看 Config 中目前使用的設定檔，確認其中的規則與策略符合預期。匯入訂閱主要是管理伺服器清單，不代表會自動取得適用於所有用途的規則。只看到伺服器清單出現，還不足以判斷目前設定會如何處理特定請求。
官方截圖中的設定編輯頁包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等分頁。初次使用時，先認得 Rule 與 Add Rule 的位置即可，不必逐項編輯。尤其不要為了完成基本連線而啟用與目前需求無關的處理項目。
檢查規則時，先看順序，再看命中後採用的策略。DOMAIN-SUFFIX 用於比對網域後綴，GEOIP 涉及 IP 地理位置比對，FINAL 是前面的規則都未命中時採用的最終策略；DIRECT、PROXY、REJECT 則會影響請求的處理結果。此處的 PROXY 是規則策略關鍵字，應與 Global Routing 中的 Proxy 模式區分。
代理(Proxy)：用於比對伺服器路徑
代理(Proxy)會以代理方式處理流量，可在排查時作為對照。維持同一台伺服器不變，暫時切換至此模式，再嘗試開啟同一個頁面。如果代理(Proxy)可以瀏覽而配置(Config)不行，下一步應優先核對目前設定、規則命中情況與相關設定，而不是立刻重新填寫所有伺服器參數。這不代表任何伺服器都一定可用，也不能取代實際瀏覽測試。
直連(Direct)：確認本機網路
直連(Direct)會以直連方式處理流量，可用來確認目前的 Wi-Fi 或行動網路是否能正常連線。在此模式下能開啟頁面，不代表所選伺服器運作正常。比對完成後，請切回預期使用的模式；需要依規則分流時，恢復配置(Config)，並記下目前的 Config，再進行下一步連線。
本步只需確認「使用哪種模式、哪份設定」。規則關鍵字的完整說明請參閱術語表；首次確認時不要同時更換模式、伺服器與設定檔，否則難以判斷是哪項變更影響結果。
Home：選擇項目並開啟開關
系統授權、開關狀態與實際瀏覽是三個不同的檢查項目。
返回 Home，先在 SERVER 群組中點選本次要使用的伺服器，確認選取標記與項目名稱。訂閱中有多個項目時，不必逐一切換；先以一個資料完整的項目完成整套確認。接著再次查看 Global Routing，確認仍是上一步選擇的模式。
尚未連線時，頂端會顯示 Not Connected。開啟頂端的連線開關後，首次使用可能會出現系統新增 VPN 設定的授權提示。請閱讀系統提示，確認目前操作的是 Shadowrocket，再依系統要求完成確認或裝置驗證。此授權用於建立系統層級的網路連線設定，不會代為填入伺服器位址，也不會補上訂閱內容。
完成授權後返回 App，查看頂端開關與狀態是否維持連線。若先前取消了授權，請重新發起連線並查看系統提示，不必因此先刪除已匯入的伺服器。若開關立即恢復關閉，先記下是否出現錯誤訊息、是否剛切換網路，以及選取的是哪一台伺服器；這些資訊比連續重複點按更有助於找出問題。
在 iPad 上也依相同方式操作：先選取項目，再確認模式，最後開啟連線。頁面版面可能因裝置與 App 目前介面而異，依介面文字與項目內容辨認入口即可。首次測試期間，盡量維持目前網路不變，並避免同時啟用其他會改變系統網路連線狀態的設定。
要停止本次連線，請返回 Home 關閉頂端開關，再確認狀態。若稍後發現連線自動恢復，請在第 05 步檢查 On Demand 條件，不要把所有自動連線情況都判斷為開關故障。
Connectivity Test 與實際瀏覽
分別確認「測試有結果」、「頁面能開啟」與「規則依預期處理」。
維持剛才選取的伺服器與模式不變，在 Home 使用 Connectivity Test。等待結果返回後，再開啟日常使用的頁面，確認是否能完整載入。測試結果會受測試方法、目標與當下網路狀態影響；單一延遲數值不等於持續傳輸速度，也無法直接推斷影片或所有 App 的使用體驗。
如果測試有結果但頁面無法開啟，先確認測試與瀏覽是在相同網路、相同伺服器和相同模式下進行。有些頁面還會載入其他網域的內容，首頁出現不代表所有資源都已成功載入。可再找一個平時能正常瀏覽的頁面作為對照，避免只憑單一目標判斷整條連線。
在配置(Config)模式下，還要確認請求是否採用預期策略。可查看 App 中的連線記錄，了解請求與命中情況，再返回目前的 Config 核對相關規則。若記錄顯示請求由 DIRECT 處理，頁面可以瀏覽並不能證明所選代理伺服器已生效；若命中 REJECT，應先確認是否符合目前設定的預期。
需要比對模式時，每次只變更一項 Global Routing，並維持伺服器與測試頁面不變。記錄配置(Config)、代理(Proxy)、直連(Direct)下的差異，測試完成後恢復原先需要的模式。不能只憑頁面外觀判斷瀏覽路徑，也不要為了取得某個測試數值而接連更換所有設定。
選取的項目明確、開關狀態穩定、實際瀏覽正常，且配置(Config)下的處理路徑符合預期時，本次首次設定檢查即可完成。之後再依實際需要逐項調整規則或自動連線條件。若仍有異常，保留這組比對結果，接著依下一步縮小範圍；更多問題說明請參閱常見問題。
依故障環節逐項檢查
先處理最早出錯的步驟。每次修改一項、重新測試一次，再決定是否繼續。
清單空白：返回 Subscribe 檢查
若連 SERVER 項目都沒有出現，先不要檢查分流規則。開啟對應訂閱，確認 URL 是否完整、是否連同說明文字一起複製，以及連結目前是否有效，再確認更新操作是否完成。若訂閱回傳的是登入頁面或錯誤訊息，也可能無法產生伺服器清單。請在自己的服務管理頁面確認訂閱狀態與內容後再更新，避免重複匯入造成混淆。
項目存在但測試失敗：確認欄位與測試方法
清單中看得到名稱，不代表參數一定正確。重新開啟該項目，依原始資料比對 Type、Host、Port 與驗證資訊；涉及 TLS 或其他傳輸欄位時，也要一併檢查是否有遺漏。接著在 Settings 查看 Test Method。不同測試方法反映的條件各異，單次逾時無法證明所有瀏覽都失敗，應搭配實際頁面瀏覽結果判斷。
開關關閉或自動變動：區分授權與 On Demand
開關無法維持開啟時，先查看系統是否已允許 VPN 設定，以及是否出現具體錯誤。如果是關閉後又自動連線，請檢查 Settings 中的 On Demand 與已設定的觸發條件。初次排錯時，可暫時停用相關自動條件，觀察手動連線是否穩定；排查完成後再決定是否恢復。不要在未記下原始設定的情況下，反覆變更多個自動連線行為。
代理(Proxy)正常、配置(Config)異常：檢查規則
遇到這種差異，應先返回目前的 Config，確認使用中的檔案、規則順序與最終策略。檢查目標是否過早命中 DIRECT 或 REJECT，以及 FINAL 是否符合預期。先依連線記錄找出特定請求，再修改對應規則；不要只因一個頁面無法開啟就刪除整份設定。
只有部分網域異常：再檢查 DNS 與網路差異
同一台伺服器下，部分頁面能開啟、部分網域持續失敗時，應檢查 DNS 與規則。先還原近期變更過的相關設定，確認目前設定中是否有特定的解析安排。切換 Wi-Fi 與行動網路可作為對照，但切換後要重新執行測試並註明網路變更。不要將網址列改成任意 IP 作為通用驗證方法，因為網域、TLS 驗證與伺服器端行為可能同時改變。
使用 Diagnostics 時保留必要資訊
Settings 中的 Diagnostics 可用於進一步查看診斷資訊。記錄出錯步驟、模式、測試方法、錯誤訊息，以及是否僅影響特定請求，通常比籠統地說「無法使用」更有幫助。對外分享記錄前，請遮蔽訂閱 URL、驗證欄位與個人連線資訊；保留能說明問題的介面文字與錯誤內容即可。
完成排查後，還原暫時變更，重新依照「選擇伺服器 → 確認模式 → 開啟連線 → 測試與瀏覽」的順序操作。如果要進一步了解某種協定的參數，請閱讀協定手冊；如果只想確認某個開關或關鍵字的意思，請查看術語表或常見問題，不必為了首次設定而一次重寫所有設定。
