Shadowrocket 首次連線教學
先匯入現有資訊，再選擇 Global Routing；開啟連線開關後，透過測試結果與實際瀏覽共同確認。
Add Server：新增伺服器或匯入訂閱
先判斷手邊資訊的類型。完整訂閱連結用於匯入一組伺服器；單一伺服器的位址、連接埠、協定及驗證資訊則用於手動新增。依照現有資料選擇其中一種方式即可，不必重複建立相同項目。不要將服務管理頁面的網址填入訂閱連結欄位，也不要只憑位址外觀判斷協定。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket 的 Home，在 SERVER 分組附近找到 Add Server 並進入。在 Add Server 中點開 Type，選擇 Subscribe，接著將完整的現有訂閱連結填入相應的 URL 欄位；若有備註欄位，可填寫方便自行辨識的名稱。確認沒有多餘空格、換行或遺漏查詢參數，再使用頁面右上角的儲存操作返回 Home。
等待訂閱內容載入後，檢查 SERVER 下方是否出現可選伺服器。儲存一筆訂閱記錄與成功取得訂閱內容並非同一件事：若只看到訂閱名稱卻沒有伺服器，先查看內容是否仍在載入，必要時使用該訂閱記錄對應的更新操作。若出現錯誤訊息，保留錯誤原文，並在最後一步依「匯入失敗」的方式處理；不要反覆新增相同連結來嘗試修復。
已有單一伺服器資訊：依 Type 填寫欄位
同樣從 Add Server 進入，先選擇正確的 Type，再確認該類型顯示的欄位。官方截圖中可見 Host、Port、Password、Method；不同 Type 的欄位不盡相同，應嚴格依照現有伺服器資料填寫。Host 填入伺服器位址，Port 填入連接埠數字，驗證值與 Method 等選項必須相符，不能將某種協定的參數套用至另一種協定。
若現有資料是 QR Code，可以使用 Scan QR Code，並依系統提示授予相機權限；從相簿讀取時，也只選擇自己的有效設定圖片。Import from Cloud JSON 則用於匯入既有的相應格式資料，並非匯入任意網頁內容的按鈕。資訊中包含密碼或存取憑證時，不要公開傳送原圖或完整連結。
本步驟完成標準：Home 的 SERVER 中至少有一台可供選取的伺服器。此時尚未驗證連線能力；下一步先決定流量處理方式，再開啟連線。訂閱與設定檔是不同概念，可參閱名詞解釋。
Global Routing：選擇設定、代理或直連
匯入伺服器後，返回 Home 並點開 Global Routing。此處用來控制請求的處理方式，不會替使用者補上伺服器資訊。三種模式分別是設定(Config)/代理(Proxy)/直連(Direct)。先了解差異，再選擇符合目前目的的模式，可避免誤判「開關已開，但某個頁面仍未經代理」。
- 設定(Config)：依照目前啟用設定中的規則處理請求。不同目標可能符合 PROXY、DIRECT 或 REJECT；適合已備妥相應規則的日常使用情境。
- 代理(Proxy)：以代理方式處理流量，可用於短時間對照測試，判斷某項異常是否與 Config 中的分流有關。不要將它視為可以改變伺服器本身的可用性。
- 直連(Direct)：不透過代理伺服器轉送。需要驗證代理伺服器時，不應停留在此模式。
準備依規則使用時，先選擇設定(Config)，再前往 Config 頁面確認目前啟用的是預期設定檔。點開設定檔可檢視 General、Rule、Hosts 等區段；本頁官方截圖展示的是設定檔編輯頁面，而非 Home 中的 Global Routing 選擇入口。不要因為曾進入某個檔案的編輯頁面，就認定該檔案已啟用；請返回設定檔列表確認目前的選取狀態。
Rule 中的規則通常由上而下比對，應將具體規則放在適當位置；若前面的規則都未符合，則由 FINAL 指定後續策略。PROXY、DIRECT、REJECT 是處理策略，不是伺服器名稱。首次連線不建議同時修改 General、Rule 與 DNS；先沿用已確認用途的設定，讓後續測試有明確的起點。
若尚未準備好自己的規則設定，可先使用代理(Proxy)進行一次伺服器連通性對照測試，完成後再決定是否切回設定(Config)。從 Config 切換到 Proxy 後瀏覽恢復正常，只能說明規則、解析或路徑存在差異，不能單憑此現象斷定某條規則有誤。
本步驟完成標準：清楚知道目前 Global Routing 使用哪個模式；選擇 Config 時，也知道目前使用哪個設定檔。需要查詢規則關鍵字時，請參閱名詞解釋；初次使用不必在此處擴充整套規則。
Home：選取伺服器並開啟開關
返回 Home，在 SERVER 中點選本次準備使用的伺服器，確認出現選取圓點或相應的選取標記。列表中有伺服器不代表已選定預設伺服器；進入某筆記錄的編輯頁面也不代表已選取該筆記錄。請返回 Home，直接確認列表中的選取狀態，再檢查上方的 Global Routing 是否仍為前一階段確定的模式。
確認後，開啟 Home 頂部的連線開關。首次使用時，系統可能會要求新增 VPN 設定；確認要求由 Shadowrocket 發起，並了解此授權用於建立系統網路通道後，依裝置提示完成確認與身分驗證。若選擇取消，應用程式將無法建立本次通道。若裝置由組織管理，相關權限可能受到管理政策限制，請先確認裝置允許新增此設定。
完成授權後留在 Home，觀察頂部原先的 Not Connected 是否轉為連線狀態，並稍候連線完成。狀態尚未穩定時，不要連續快速切換開關，以免多次啟動與停止混在一起，影響後續判斷。若開關立即返回或一直無法連線，先記錄當時的提示，而不是立刻切換所有設定。
系統顯示 VPN 標記，代表系統網路通道已建立，不代表每個請求都會透過代理，也不代表遠端伺服器一定能成功轉送目標請求。尤其在設定(Config)模式下，符合 DIRECT 的請求仍會直連；這是規則處理結果，不能只憑造訪某個原本可以直連的頁面來判斷代理是否有效。
建立連線後，先保留目前選取的伺服器與 Global Routing，不要立刻切換 Wi-Fi、行動網路或其他伺服器。保持條件穩定，才能將下一步 Connectivity Test 的結果與此次連線相互對照。若需要更換伺服器，一次只更換一台，重新確認選取標記後再測試。
本步驟完成標準：已明確選取伺服器、完成系統授權，且 Home 頂部顯示連線狀態。接下來必須進行驗證；不要把「開關維持開啟」當成教學的終點。
Connectivity Test：驗證連線與實際瀏覽
在 Home 點選 Connectivity Test，等待本次測試結束，再讀取介面顯示的結果。測試可提供可重複觀察的連通性指標，但不等同完整的頻寬測量，也不保證每個網站或每種應用程式請求都能成功。不要將單次測試數值視為長期效能結論，也不必為了追求更小的數字而反覆更改設定。
完成應用程式內的測試後，切換至瀏覽器或實際要使用的應用程式，開啟需要造訪的頁面並重新整理一次。現有頁面可能來自快取，因此「看得到頁面」與「剛完成網路請求」並非同一回事。可在同一頁面內開啟其他內容，確認新的請求是否正常完成；本教學不指定外部測試網站，也不要求提交帳戶或憑證來驗證。
驗證時同時檢查三件事：Home 的連線狀態是否維持、Connectivity Test 是否完成，以及實際目標是否能正常瀏覽。三者都符合預期，就可以保留目前設定。若測試成功但某個頁面失敗，先判斷是單一目標異常還是多個目標都異常，再檢查 Config 的比對結果與 DNS；不要立刻刪除所有伺服器或重新安裝應用程式。
需要進行對照時，先記錄目前設定，再短暫將 Global Routing 從設定(Config)改為代理(Proxy)，重新發出相同請求。如果兩種模式的結果不同，排查重點應轉向分流設定及相關解析路徑；若兩種模式都失敗，則繼續檢查伺服器資訊與本機網路。測試結束後恢復原本需要的模式，避免將臨時測試設定保留為日常設定。
若準備從 Wi-Fi 切換至行動網路進行比較，請維持伺服器與 Global Routing 不變，待網路切換完成後再重新測試。網路變化會影響解析與連線路徑，這次比較只能用於判斷是否與本機網路連線有關，不能據此保證某台伺服器在所有環境下都可用。
本步驟完成標準：已確認應用程式內測試與實際請求，或已明確記錄某個階段的故障狀況。後者同樣有幫助：可為下一步提供明確可行的排查起點。
Settings：依故障階段逐項排查
先將問題歸類為「無法匯入」、「無法建立連線」或「連線後瀏覽異常」，再只檢查與該階段相關的項目。Settings 中可見 Test Method、On Demand、Diagnostics，以及 Proxy、TCP、UDP 等設定；這些入口用途各異，遇到故障時不代表都要啟用。先保留預設或已知可用的設定，每次只調整一個變數。
無法匯入：先檢查輸入內容與取得流程
返回第一步，檢查是否將訂閱連結填入 Subscribe 對應的 URL 欄位、是否完整複製、是否混入說明文字，以及本機網路是否能順利請求該連結。訂閱連結的有效性、存取限制與內容狀態，請向使用者原有的服務提供者確認。若伺服器列表為空，先確認是訂閱更新失敗，還是回傳內容中沒有可用項目；不要將空列表歸因於 Global Routing。
無法連線：確認選取狀態與伺服器欄位
確認 Home 是否確實選取伺服器，再開啟該筆記錄檢查 Type、Host、Port 與驗證資訊。手動輸入時，最常見的問題是協定類型不符、連接埠填錯，或複製驗證值時混入空格。確認已完成系統 VPN 設定授權，並檢查是否有其他 VPN 連線影響本次測試；需要進行對照時，先暫停其他連線，再重新啟動 Shadowrocket。
已連線但瀏覽異常：區分測試、規則與網路
在 Settings 查看 Test Method，確保前後比較採用相同的測試方式；變更測試方式會改變結果的意義。若需要進一步觀察，可進入 Diagnostics，使用介面實際提供的工具檢查目前問題。診斷記錄可能包含目標網域、伺服器位址或連線資訊，向他人說明問題前應先隱藏敏感內容，只保留排查所需的錯誤片段。
當設定(Config)模式異常而代理(Proxy)正常時，優先確認目前啟用的檔案與 Rule，不要將所有請求永久改成相同策略。若只在切換本機網路後恢復，先記錄網路差異，再檢查 DNS 與網路連線條件。DNS、UDP 或特定協定的進階參數應依具體狀況調整，不能將任意項目的「開啟」視為通用修復方法。
首次測試期間也不必啟用 On Demand。它用於依條件觸發連線，無法修復錯誤的伺服器資訊；待基本連線驗證完成後再設定，更容易區分自動觸發條件與實際連線故障。需要進一步確認時，請閱讀問答中的故障排查或相關術語解釋；商店地區、購買與換機還原問題則參閱正版指南，不要與網路參數排查混為一談。
排查完成後：恢復所需的 Global Routing，確認預設伺服器，重新執行 Connectivity Test 並瀏覽實際目標。保留一份可正常使用時的設定記錄，下次遇到問題即可逐項對照，不必從頭修改所有設定。
