Shadowrocket 入門教學
從既有資料開始，依序完成新增、選擇模式、連線與驗證。先確認連線正常，再調整規則或自動連線設定。
下方圖片為 App Store 官方截圖，可用來辨識頁面與欄位。實際選項會依協定及 App 介面而異；請只填入自己的資料，不要照抄截圖中的範例內容。訂閱連結、密碼和設定檔可能包含存取憑證，請勿公開分享。
Add Server / Subscribe：新增既有資料
訂閱連結與單台伺服器參數是兩種不同的輸入方式。依手邊資料擇一使用，不必同時操作。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket 的 Home，在 SERVER 分組找到 Add Server，進入新增頁面。點開 Type，選擇 Subscribe，再將自己的完整訂閱連結填入 URL 欄位。儲存前檢查開頭的協定、路徑與查詢參數，確認複製時沒有帶入說明文字、換行或前後空格。備註僅供辨識，不能取代實際連結。
儲存後返回 Home，等待訂閱內容載入。成功取得資料後，清單中應會出現訂閱分組及其伺服器項目；若只看到訂閱名稱，卻沒有可選項目，就不算完成匯入。先確認連結仍有效，再使用該訂閱項目提供的更新功能。更新訂閱會重新取得遠端內容，不等同於備份本機修改，因此初次使用時請先保留原有參數。
已有伺服器參數：依 Type 逐項填寫
若手邊有單台伺服器的位址、連接埠與驗證資料，請在 Add Server 的 Type 中選擇對應協定，再填寫 Host、Port 及該協定要求的欄位。Shadowsocks 的 Method、Trojan 的 TLS 相關參數與 WireGuard 的金鑰不能互換。介面會依 Type 顯示不同選項；若資料缺少必填內容，請先向自己的服務商確認，不要猜測數值填入表單。
Host 通常填入資料指定的網域或位址，Port 填入對應連接埠。Password 的大小寫與特殊字元都必須完整保留。若資料另有提供 SNI、傳輸方式或路徑，請依序填入目前協定頁面對應欄位；不要把瀏覽器頁面網址直接當成伺服器位址。儲存並返回 Home 後，確認備註與類型，避免將新項目和既有項目混淆。
已有 QR Code：使用 Scan QR Code
若已有資料以 QR Code 提供，可在 Add Server 使用 Scan QR Code，依系統提示授權相機後掃描。辨識完成後仍須檢查 Type、位址與連接埠，再儲存。QR Code 承載的是特定資料，不能從一般網頁圖片推測伺服器參數。Import from Cloud JSON 是另一種匯入方式，不應將訂閱連結隨意填入這個流程。
Global Routing：選擇連線模式
三種模式為設定(Config)、代理(Proxy)與直連(Direct)。模式決定處理路徑，不會補齊或修復伺服器資料。
返回 Home，點開 Global Routing 查看目前選項。日常依規則使用時選擇設定(Config)；需要暫時檢查代理路徑時，可選擇代理(Proxy)；希望要求走直連路徑時，選擇直連(Direct)。選擇後返回 Home，確認 Global Routing 顯示剛選定的值，再進行連線。
設定(Config)：先確認目前的設定檔
Config 會依目前設定中的規則決定如何處理要求。進入底部的 Config 頁面，確認正在使用的設定檔；若要查看內容，開啟對應檔案的編輯入口，即可看到 General、Rule、Hosts 等區段。初次使用不必逐一修改，先確認 Rule 是否符合預期。若使用既有設定，請先閱讀其說明，不要直接拼接多個來源的規則。
以下僅說明規則含義，初次連線時不需要貼上。DOMAIN-SUFFIX 會比對網域後綴，符合後交由指定策略處理；FINAL 則是在前面的規則都未符合時使用的預設規則。範例中的 example.com 並非可用的伺服器位址，PROXY 也不是訂閱名稱。修改前請保留原始檔案，避免同時調整規則、DNS 和連線參數後，無法判斷是哪項變更造成影響。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT代理(Proxy)與直連(Direct)：區分連線路徑
Proxy 會讓要求使用代理路徑，適合短時間測試，以區分「伺服器連線問題」與「規則比對問題」。Direct 使用直連路徑，因此即使連線開關已開啟，也不能據此認定網站是透過伺服器存取。仍須依實際設定與 App 設定判斷，不要把某一種模式當成所有問題的通用解法。
若暫時切換至 Proxy 後目標頁面可用，恢復 Config 後卻出現異常，請回頭檢查設定與規則順序，不要重複匯入同一份訂閱。更多規則說明請見功能說明；需要系統性排查時，請閱讀疑難排解手冊。確認模式後，再開啟連線開關。
Home：選擇伺服器，再開啟開關
清單中有項目不代表已選取；開關開啟也不代表所有目標網站都已通過驗證。
返回 Home，在 SERVER 分組中點選這次要使用的伺服器。確認該項目左側出現選取圓點，再檢查 Global Routing 是否仍為上一步選定的模式。只開啟項目的編輯頁面查看參數後返回，不能取代選取預設伺服器；若有多個分組，尤其要確認圓點對應的是哪個項目。
接著開啟 Home 頂部的開關。未連線時，頂部會顯示 Not Connected；開始連線後，請觀察狀態變化。首次建立連線時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。閱讀彈出視窗中的 App 名稱與說明，確認是由這次操作觸發後，選擇允許，並依系統要求完成裝置驗證。這個步驟是為 App 建立網路連線設定，不是再次購買。
授權完成後返回 Shadowrocket，檢查開關是否維持開啟，以及頂部是否已不再顯示 Not Connected。若開關立刻關閉，先查看 App 顯示的錯誤訊息，不要連續快速點按。若先前拒絕授權，可重新嘗試連線並依系統提示處理；裝置受到管理或系統限制時，相關權限也可能影響設定建立，請先確認裝置允許的操作範圍。
首次驗證期間，暫時不要讓其他 VPN 連線同時參與測試，也不要立刻啟用 On Demand。先透過手動開關建立可重複的測試流程：選取同一台伺服器、使用同一個網路、開啟連線，再檢查結果。狀態列中的 VPN 標示只能表示系統處於 VPN 連線狀態，不能證明特定網域實際採用了預期策略。
Connectivity Test：分別檢查連線與存取
依照「測試結果 → 實際存取 → 規則路徑」的順序確認。單次測試成功，不代表所有網站和所有要求類型都可使用。
先在 Home 使用 Connectivity Test，等待目前測試回傳結果。測試結果可提供連線狀況線索，並會受到測試方式、測試目標與目前網路影響。發生逾時時，記錄使用哪台伺服器及哪種網路；收到回應時，也不要只憑顯示數字判斷長期速度。應比較相同條件下能否完成測試，而不是追求特定數值。
接著開啟瀏覽器，造訪一個已知正常且適合目前網路環境的頁面。先確認一般網頁能正常載入，再測試原本要驗證的目標。若瀏覽器一直停留在舊頁面，可重新載入或開啟新分頁，避免把快取內容當成連線已生效的證據。測試期間保持伺服器不變，才能將目前結果與上一步對照。
使用設定(Config)時，還要確認目標要求原本是否應走 PROXY。規則會由上往下比對；若目標符合 DIRECT，頁面能開啟並不代表代理路徑已驗證成功。反之，某個頁面無法開啟，也不能直接證明整台伺服器失效。可在保留原設定的前提下，短暫切換至代理(Proxy)重新測試，完成後恢復原模式，並一併記錄兩次結果。
若一般頁面可正常存取，只有特定網站異常，請優先檢查該目標對應的規則、DNS 解析與網站本身狀態；若所有頁面都異常，先關閉連線開關並檢查原本的網路。若原本的網路也無法存取，請先恢復網路，再回到本教學繼續。若要進一步釐清原因，可參閱常見問題與依症狀整理的疑難排解手冊。
Settings：依問題發生階段逐項檢查
保留目前資料，每次只修改一項。先確認問題發生於匯入、授權、連線，還是規則處理階段。
新增失敗或訂閱清單為空
先回到新增資料的步驟，確認 Type 與輸入內容是否相符。Subscribe 需要完整訂閱連結，單台伺服器則需要對應協定的參數，兩者不能混填。訂閱無法更新時，請檢查連結是否已過期、目前網路能否連至該網址，以及資料提供者是否要求其他操作。不要反覆新增同名訂閱，以免混淆之後選取的伺服器來自哪個分組。
開關無法維持開啟，或連線後完全無法使用
開關無法維持開啟時，先確認系統 VPN 設定授權，再查看 App 的錯誤提示。若開關能維持開啟但無法存取，請檢查是否選到正確的伺服器，以及 Host、Port、Password 和協定附加欄位是否與原始資料一致。暫時關閉連線後，確認原本的網路能正常上網；確認正常後再開啟連線並重做相同測試，才能判斷問題是否隨伺服器設定出現。
Connectivity Test 逾時或結果不一致
進入 Settings 查看 Test Method，確認目前使用的測試方式。不同測試方式檢驗的條件不同，結果不能視為同一項指標。若調整測試方式，請記錄調整前後的設定，再使用同一台伺服器重新測試；不要同時修改連接埠、DNS 和測試方式。若要比較 Wi-Fi 與行動網路，也請一次只更換網路，並保留其他條件不變。
連線自動變更或特定網站異常
在 Settings 確認 On Demand。若已啟用，按需連線條件可能會影響自動建立連線的時機；初次排查時，先暫停自動連線，再用手動開關重現問題，完成後視需要恢復。特定網站異常時，優先回到 Config 檢查 Rule 與目前的 Global Routing，不要只為了單一目標就修改所有 Proxy、TCP、UDP 選項。
需要進一步定位時，可在 Settings 查看 Diagnostics。整理問題時，記下「目前模式、選取的伺服器、網路類型、測試是否逾時、實際存取情況」，比只寫「連不上」更有幫助。提供診斷資訊給他人前，請隱藏訂閱 URL、驗證欄位及其他個人資料；不要直接公開完整設定檔。涉及 DNS、耗電或更新後異常等較複雜的排查流程，請前往疑難排解手冊，依照對應症狀處理。
至此，已完成從匯入到驗證的基本流程。購買、授權與資料管理的簡要說明請見常見問題；若想了解各項功能的適用範圍，可繼續閱讀功能說明。
