Shadowrocket 使用教學：
訂閱匯入與連線測試
依新增、分流、連線、測試、排錯的順序操作。先完成一次可重現的連線，再調整規則和自動連線設定。
已有伺服器項目的話，可從第二步繼續；若顯示已連線卻無法瀏覽，可直接檢查第四步和第五步。
Add Server：新增伺服器或匯入訂閱
先確認手上的資料是訂閱連結，還是一組伺服器參數。訂閱可用於批次匯入及後續更新伺服器項目；手動新增則需逐一填寫單一伺服器資料。兩種方式擇一即可，不必重複輸入同一份資料。訂閱網址通常包含存取憑證，請只在自己的裝置和可信任的輸入位置使用；排查問題時也不要公開完整網址。
手動新增：依 Type 填寫對應欄位
在 Shadowrocket 的 Home 中，前往 SERVER 區域並開啟 Add Server；也可以使用頁面上的新增入口。進入後先點選 Type，選擇與現有資料相符的協定類型。接著填寫 Host 和 Port，再依該類型的要求填入 Password、Method 或其他驗證與傳輸欄位。官方截圖中的欄位僅適用於當時選取的 Type，並不代表所有協定都使用相同參數。
Host 通常填寫伺服器網域名稱或 IP 位址，Port 填寫資料提供的連接埠。不要將含路徑的訂閱連結整段貼進 Host，也不要把密碼填入 Method。若資料包含 TLS、伺服器名稱或傳輸路徑等設定，請依原始資料逐項填寫；不確定的欄位先向資料來源確認，不要猜測填入。完成後使用頁面右上角的儲存功能，返回 Home 查看 SERVER 中是否出現該項目。
匯入訂閱：選擇 Subscribe 後儲存
若有自己的訂閱連結，請在 Add Server 的 Type 中選擇 Subscribe，將完整網址填入對應的 URL 欄位，並新增方便辨識的備註。貼上後檢查開頭和結尾是否多出空格、換行或聊天內容；網址中的大小寫、參數和符號都應保持原樣。儲存並等待讀取完成，返回 Home 確認是否出現訂閱群組及其中的伺服器項目。
Subscribe 網址與 Config 設定檔網址用途不同。前者主要提供伺服器項目，後者則包含規則和設定內容；不能只因兩者都是連結，就使用相同的匯入入口。若匯入後清單為空，先確認資料格式和用途，再檢查訂閱是否有效；不要立刻更改 Global Routing，因為分流模式不會將錯誤格式轉換成伺服器清單。
頁面底部的 Scan QR Code 用於掃描相容的 QR Code，Import from Cloud JSON 則用於相應的雲端 JSON 匯入流程，兩者都不是通用的訂閱匯入入口。使用前請確認手上的資料確實符合該方式。匯入完成後，在 Home 的 SERVER 中點選要使用的項目，確認選取標記，再進入下一步。
本步完成條件：SERVER 中有可辨識的項目，所需欄位已儲存，且已選取一項。協定欄位的意義可參閱術語手冊。
Global Routing：選擇設定檔、代理或直連
伺服器項目決定「透過哪個連線出口」，Global Routing 則決定「流量採用哪種處理方式」。完成匯入後返回 Home，開啟 Global Routing，依使用目的選擇設定檔(Config)、代理(Proxy)或直連(Direct)。切換分流模式不會取代伺服器資料，也無法修復已失效的驗證資訊。
設定檔(Config)：依目前規則處理
設定檔(Config)適用於需要依規則分流的日常使用。選取後前往 Config，確認目前啟用的設定檔，並開啟查看 Rule 內容。只在編輯頁面看到某個檔案，不一定表示它已設為目前使用的設定檔；儲存修改後，還要確認清單中的目前選取狀態。成功匯入伺服器訂閱，也不代表已同步取得符合個人需求的規則檔。
規則會由上而下檢查，符合的第一條規則會採用對應策略。因此，條件範圍較明確的規則通常應放在較廣泛的規則前面，並以 FINAL 處理其餘請求。以下僅示範「指定網域使用 PROXY，其餘使用 DIRECT」的邏輯，並非可直接匯入的完整設定檔。網域僅供教學示範，實際使用時請依需求調整，並先保留原始設定檔。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT上述範例會讓 example.com 及其子網域符合 PROXY，其他未符合規則的流量則由 FINAL,DIRECT 處理。PROXY、DIRECT、REJECT 是策略關鍵字，不是需要自行填寫的伺服器名稱。排查時應一併確認規則順序、目前使用的檔案和分流模式，不能只因某一行「存在」就認定它已生效。
代理(Proxy)與直連(Direct)：用於特定目的的對照
代理(Proxy)會將一般流量交由所選代理處理，適合用來暫時判斷問題是否與規則選擇有關，但不保證伺服器一定可用。直連(Direct)會讓一般流量直接連線至目標，可作為基礎網路的對照，但不能用來證明所選伺服器連線正常。實際處理方式仍須留意 App 設定中的例外情況。
首次操作不必同時修改 General、Hosts、URL Rewrite 或 HTTPS Decryption。先確認目前設定檔的基本分流符合預期，再繼續連線。測試期間若暫時切換為代理(Proxy)或直連(Direct)，請記下原本的分流模式，對照完成後再恢復，避免下次使用時誤以為規則失效。規則關鍵字的詳細說明請見術語手冊，系統化排查請見故障排查。
本步完成條件：清楚目前 Global Routing 的選擇；使用設定檔(Config)時，能確認目前檔案及其預設策略。
Home：開啟 Not Connected 旁的開關
完成伺服器選取和 Global Routing 設定後，返回 Home。先確認 SERVER 中選取的項目是否為這次要使用的伺服器，再查看 Global Routing 顯示的分流模式。此時頂端可能仍顯示 Not Connected，代表尚未啟動連線，並不表示匯入失敗。
首次連線時允許新增 VPN 設定
開啟頂端的連線開關。首次使用時，系統會詢問是否允許新增 VPN 設定；確認目前操作的是 Shadowrocket 後，允許新增並依系統要求完成裝置密碼或生物辨識驗證。這項授權是讓系統建立本機 VPN 通道，將需要處理的流量交由 App 處理；它不是伺服器帳號，也不會替你補上缺少的訂閱或驗證資訊。
若先前取消授權，請返回 App 再次嘗試連線，並依實際出現的系統提示操作。裝置若受管理或有系統限制，能否新增設定取決於裝置管理政策，請先確認裝置允許此操作。不要為了繼續教學而刪除用途不明的管理設定；無法判斷時請先停止變更。
等待狀態變更，再開始瀏覽測試
完成授權後返回 Home，觀察頂端狀態及開關是否維持穩定。系統狀態列也可能顯示 VPN 標示，實際位置依裝置而異。連線狀態維持開啟，代表系統通道已建立，但不表示所選伺服器、DNS 和所有目標網站都已通過測試，因此下一步仍須實際瀏覽。
若開關很快又關閉，先記下錯誤提示及發生階段：授權前、授權後，還是嘗試連線後。若裝置上有其他 VPN 連線正在使用，請先停止另一個連線，再單獨測試，以減少切換造成的干擾。不要快速重複點按開關，也不要在連線時同時修改多項參數。
本次先維持 On Demand 的現有設定，優先完成一次手動連線流程。若手動關閉後連線又自動建立，請在第五步檢查 On Demand 條件。確認開關穩定後，繼續執行 Connectivity Test 並使用瀏覽器測試，不要只看見 VPN 標示就結束檢查。
本步完成條件：已完成必要的系統授權，Home 的連線狀態穩定，且清楚目前使用的伺服器和分流模式。
Connectivity Test：測試後再實際瀏覽
確認連線維持開啟後，在 Home 點選 Connectivity Test，等待本次測試完成。測試結果可協助判斷目前記錄是否能透過所選測試方式收到回應；它不等於完整的網站瀏覽測試，也不能直接證明某條規則已符合。先查看目前選取的項目，再檢查其他項目，避免把清單中另一項的結果誤認為目前連線的測試結果。
先確認測試條件，再解讀結果
Connectivity Test 的結果與 Settings 中的 Test Method、目前網路，以及伺服器對測試方式的支援有關。發生逾時不一定代表所有實際請求都無法通過；測試成功也不保證所有 App 流量、UDP 或所有目標都可使用。比較兩次結果時，應盡量使用相同網路、相同項目和相同測試方式，不要把不同條件下的數值直接當成優劣結論。
以兩種瀏覽測試確認預期路徑
接著開啟瀏覽器，造訪自己有權使用且預期會走 PROXY 的目標，再造訪預期會走 DIRECT 的目標。使用設定檔(Config)時，應依目前規則選擇測試對象，不要隨機開啟網頁。若採用前述教學規則，只有符合 example.com 的請求會走 PROXY；其他目標可直連成功，並不能證明代理伺服器可用。
若 App 的 Data 或相關請求記錄中可查看本次請求的處理資訊，可依目標網域、時間和策略進行核對。可用資訊以 App 實際顯示為準；不能只憑網頁開啟速度推斷流量走哪條路徑。有些頁面會繼續向其他網域發出請求，請檢查發生問題的具體請求，不要只看最初輸入的網址。
若要進行簡單對照，可暫時將 Global Routing 從設定檔(Config)改為代理(Proxy)，維持使用同一台伺服器，再重新載入同一個目標。若代理(Proxy)可瀏覽而設定檔(Config)失敗，請優先檢查規則、目前使用的檔案和 DNS；若兩者都失敗，先回頭確認伺服器資料和基礎網路。測試結束後恢復原本的分流模式。
本步完成條件：不只確認連線開關已開啟，也能在已知條件下重現瀏覽結果，並判斷是否符合目前分流模式和規則的預期。
Settings 與常見問題排查：依發生階段檢查
先判斷問題發生在匯入、建立連線，還是連線後的瀏覽階段。三個階段的檢查方向不同：訂閱讀取失敗先檢查網址，開關無法維持開啟先檢查授權，只有部分目標失敗再檢查規則與 DNS。完成以下基本定位即可；若涉及多項設定或問題持續發生，請前往完整故障排查指南繼續檢查，初次使用不必逐一查看所有進階參數。
匯入失敗或 SERVER 沒有項目
重新確認訂閱網址是否完整、仍然有效，以及是否確實用於伺服器訂閱。若出現網路或憑證錯誤，先檢查目前網路能否正常連線至訂閱所在網址，並確認裝置時間正確。不要將完整網址貼到公開搜尋或截圖中；若需向自己的服務提供者詢問，僅提供必要的錯誤資訊並遮蔽憑證。
手動新增後無法使用時，返回 Add Server 檢查 Type、Host、Port 和驗證欄位。密碼即使看起來相同，也可能多了前後空格；連接埠、加密方式或 TLS 相關參數不一致，同樣可能導致連線失敗。修正後儲存，再返回 Home 重新選取項目並測試，避免仍在使用舊項目。
開關無法開啟、自動中斷或重新連線
先確認系統 VPN 設定授權是否完成，再檢查是否有其他 VPN 連線同時運作。若手動關閉後又自動建立連線，請前往 Settings 查看 On Demand 是否已啟用及其觸發條件；此功能控制自動連線時機，與 Config 中「連線後如何分流」屬於不同層級的設定。調整前記下原本狀態，排查結束後依使用需求恢復。
若問題是在 Wi-Fi 與行動網路切換後才出現，請分別在兩種網路下重新測試，不要直接歸因於 App 本身。保留目前設定檔和項目，只變更網路，觀察相同目標是否出現一致結果。如此才能區分基礎網路差異和伺服器參數錯誤。
已連線但無法瀏覽，或只有部分目標失敗
先使用已知可用的一般目標確認基礎網路，再檢查目前伺服器和 Global Routing。代理(Proxy)正常而設定檔(Config)異常時，優先確認實際啟用的設定檔、規則順序和 FINAL。只有少數網域失敗時，再檢查 DNS 解析和相關請求；不要一開始就同時修改 DNS、TCP、UDP 和所有傳輸設定。
Settings 中的 Test Method 可協助了解連線測試條件，Diagnostics 則可在排查問題時提供線索；Proxy、TCP、UDP 等項目涉及較細部的行為，初次使用時維持原有設定即可。準備分享診斷資訊前，先檢查是否包含訂閱網址、伺服器資料或瀏覽記錄，只保留排錯所需部分。
若訂閱更新後原先選取的項目消失，請返回 SERVER 重新確認目前選取項目；若問題是在修改設定檔後才出現，先還原先前保留的設定檔，再以相同目標重新測試。依照「還原基準、一次只改一項、重新測試」的順序操作，通常比不斷疊加設定更容易找出原因。
至此，首次使用流程已完成。介面詞彙說明請參閱術語手冊；持續逾時、DNS、耗電或更新後異常等情況，請依故障排查中的相應症狀繼續檢查。
