Shadowrocket 使用教學
從現有訂閱或伺服器資料開始，依序完成新增、選擇模式、連線與驗證。先確認一條連線可正常運作，再調整規則與按需連線設定。
操作順序：先確認輸入資料完整，再選擇處理方式；開啟連線後，還需要驗證實際要求。訂閱與配置檔是兩種不同內容，請勿只憑檔名判斷匯入入口。
Add Server：新增伺服器與匯入訂閱
手動填寫與匯入訂閱擇一即可。匯入完成的判斷依據，是 Home 的 SERVER 中出現可選擇的伺服器，而不只是連結已儲存。
手動新增：依 Type 填寫對應欄位
開啟 Shadowrocket 的 Home，在 SERVER 區域找到 Add Server 並進入。先點選 Type，依伺服器資料指定的協定選擇類型，再填寫 Host 與 Port。Host 應填入對方提供的伺服器位址，請勿將整條訂閱連結貼在這裡；Port 填入對應連接埠，不要加上說明文字。選定協定後，頁面會顯示相應的驗證欄位；欄位是否必填，取決於協定與伺服器設定。
例如選擇 Shadowsocks 時，請依資料填寫 Password 和 Method，不要只憑名稱相似就選擇加密方式。使用 VMess、VLESS、Trojan 或 Hysteria2 時，也要核對相應的身分、TLS 與傳輸參數；不可將一種協定的參數套用到另一種協定。若服務供應商提供的資料缺少必要欄位，應先補齊資料，不要使用隨機值嘗試。可以填寫方便辨識的備註，但備註不能取代實際位址或驗證資訊。
檢查完成後儲存並返回 Home。確認 SERVER 中出現剛新增的項目，名稱符合預期，再點選該伺服器。這只代表資料已輸入完成，尚不能據此判斷伺服器可用。如果你有可辨識的伺服器 QR Code，可以從 Add Server 的 Scan QR Code 入口讀取；匯入後仍應開啟項目檢查 Type、Host、Port 等資訊，掃描成功不等於連線成功。
Subscribe：匯入自己的訂閱
如果你手上有訂閱連結，請在 Add Server 中選擇 Subscribe，依頁面欄位填入完整連結及方便辨識的備註，再儲存。複製時請保留原有查詢參數，移除聊天文字、換行與連結外層的引號。含有存取憑證的訂閱連結屬於私密資訊，請勿貼到公開留言或公開截圖中；需要協助時，只描述錯誤現象，並遮蔽連結中的敏感部分。
返回 Home 後，等待訂閱內容載入；必要時可在對應的訂閱項目中更新。成功時應能看到由該訂閱產生的伺服器項目。若只看到訂閱名稱，卻沒有伺服器，請先檢查是否有取得錯誤，再確認連結傳回的是 Shadowrocket 可辨識的訂閱內容，而非登入頁面或一般網頁。不要為了解決一次失敗而反覆建立同名訂閱，否則日後更容易選錯項目。
更新訂閱是為了同步遠端伺服器資料，不等於匯入規則配置，也不一定會保留你對訂閱項目的本機修改。請先選擇一台資料完整的伺服器繼續下一步；訂閱更新失敗、內容變更及重複項目的詳細處理方式，請參閱常見問題。配置檔結構另請參閱配置欄位參考；本步驟先不要修改規則。
Global Routing：配置、代理與直連
伺服器項目決定連線目的地，Global Routing 決定要求的處理方式。這兩項需要分別確認。
新增完成後返回 Home，點選 Global Routing，查看目前選取的模式。三種常見選項為配置(Config)、代理(Proxy)、直連(Direct)。先確認目前勾選的項目，再決定是否變更；不要因為連線失敗就連續切換多種模式，否則很難判斷是哪次變更影響結果。
配置(Config)：依目前配置進行比對
選擇配置(Config)時，要求會依目前生效配置中的規則處理。進入 Config，確認目前使用哪一份配置，再開啟相應內容查看 Rule。配置檔出現在清單中，不代表它必然正在生效；編輯另一份檔案，也不會自動改變目前連線使用的規則。初次使用時，先確認目前檔案符合預期即可，不必一次修改 General、Rule 與其他所有區段。
Rule 通常依由上而下的順序檢查，符合相應規則後便採用指定策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示指定網域後綴採用 PROXY；IP-CIDR,192.168.0.0/16,DIRECT 用於比對相應的位址範圍。最後的 FINAL,PROXY 會指定前面規則都未符合時的處理方式。以上是語法範例，請勿整段覆蓋原有且正在使用的規則。
PROXY、DIRECT、REJECT 是策略關鍵字，不能只憑中文直覺任意替換。檢查規則時，也要確認相應策略或策略群組確實存在，且目標選擇符合預期。規則類型、DNS 解析與比對條件之間的關係屬於進階配置內容，具體寫法請參閱Rule 與規則順序說明；本教學只要求先辨識目前使用的檔案與實際策略。
代理(Proxy)與直連(Direct)：用來比對連線路徑
選擇代理(Proxy)可用來確認所選代理路徑是否正常，避免一開始就把複雜規則一併納入排查。選擇直連(Direct)則可觀察直接連線情況，但不能用來證明所選代理伺服器可用。如果代理(Proxy)正常、配置(Config)下某個目標卻異常，應優先檢查該目標符合的規則與策略，而不是立刻重新填寫所有伺服器參數。
選好模式後返回 Home，再確認一次 Global Routing 顯示的值，以及 SERVER 中目前選取的伺服器。比對測試結束後，請恢復準備長期使用的模式；若打算依規則使用，通常應切回配置(Config)，並保留剛確認有效的配置。下一步只需開啟連線開關，不要同時編輯配置檔。
Home：開啟連線並允許 VPN 設定
先確認伺服器與 Global Routing，再開啟上方開關。系統權限與伺服器驗證是兩回事。
返回 Home，確認 SERVER 下選取的是剛才準備測試的伺服器，而非同名舊項目。再確認 Global Routing 是否與上一步一致。確認後，開啟頁面頂端的連線開關。尚未連線時，頁面可能顯示 Not Connected；開啟開關後的狀態變化可用來判斷系統連線是否建立，不能單獨用來判斷某個目標網站能否存取。
首次連線時，系統會提示允許 Shadowrocket 新增 VPN 設定。確認提示中的 App 名稱與目前操作相符後，選擇允許，並依裝置要求完成認證。這裡建立的是供系統網路延伸功能使用的 VPN 設定，不需要重新填寫伺服器 Password。請勿將伺服器密碼輸入到不相關的系統認證欄位，也不必為了這項提示另外尋找配置檔匯入。
完成系統確認後返回 Shadowrocket，查看連線開關是否維持啟用，以及頁面是否從 Not Connected 變為已連線狀態。如果系統提示出現後選擇取消，App 可能無法繼續建立連線；再次啟動連線，依提示重新授權即可。若先前曾在系統設定中刪除相應 VPN 設定，也可能需要重新完成這個步驟。
如果開關立即跳回關閉狀態，請先記下是否出現權限提示或錯誤訊息。你可以在 iPhone / iPad 的系統設定中搜尋 VPN，查看相應設定是否存在，以及是否有其他連線正在接管目前網路。沒有記錄前，請勿刪除所有網路設定；先確認權限、目前連線與 App 內選項，通常更容易找出問題。受裝置管理限制的裝置，也應遵守其管理政策。
開關維持啟用後，讓 App 完成狀態更新，再開始驗證存取情況。系統出現 VPN 標示，只表示相關系統連線正在運作，不能證明訂閱仍有效、伺服器驗證正常、遠端存取成功，或每條分流規則都正確。先不要開啟 On Demand，也不要同時切換多台伺服器。維持目前條件不變，才能在下一步將測試結果對應到這條連線。
若要暫停，返回 Home 關閉頂端的連線開關即可。完成一次手動連線與中斷測試後，再考慮設定按需連線。首次授權的意義與誤刪後的處理方式，也可參閱新增 VPN 設定提示說明。
Connectivity Test：從測試到實際存取
分別確認「測試有回應」、「系統已連線」與「目標可成功存取」。三種狀態不能互相取代。
先測試目前伺服器，再開啟目標頁面
在 Home 找到 Connectivity Test，執行測試並等待結果。先檢查目前所選伺服器的測試結果，不必一次比較整份清單。測試結果會受 Settings 中的 Test Method、目前網路與測試目標等條件影響；收到回應只表示在相應測試條件下取得結果，不能據此推論所有協定參數、所有目標存取與所有規則都已正確。
接著開啟瀏覽器，前往自己有權使用且平常可正常存取的目標頁面。盡量輸入明確網址，等待頁面載入完成，再確認主要內容是否能正常操作。不要只查看已快取的首頁或 App 中尚未更新的舊內容；必要時重新載入，並記錄異常發生在解析、連線、載入還是登入階段。網站登入失敗不一定是代理連線問題，應與網路要求失敗分開判斷。
搭配 Data 檢查實際策略
如果頁面可以存取，但你還想確認是否經過預期路徑，可在 Data 中查看相關要求紀錄。依目前版本提供的資訊，核對目標網域、符合的規則與使用的策略。在配置(Config)下，部分要求符合 DIRECT 是規則執行結果，不表示整體連線未啟用；同樣地，頂端連線開關已開啟，也不代表所有要求都應使用 PROXY。
若只有一個目標異常，先維持伺服器不變，比較代理(Proxy)與配置(Config)的結果。前者成功、後者失敗時，檢查目前配置、規則順序與策略群組目標；兩者都失敗時，再回頭檢查伺服器參數與遠端狀態。使用直連(Direct)進行比對時，請留意它會改變要求路徑，不能把結果當成代理伺服器測試通過。
有效的驗證應記下可重現的條件：當時使用的網路、所選伺服器、Global Routing 值、目標網址與錯誤現象。切換 Wi-Fi 與行動網路有助於區分網路環境，但切換後必須重新測試，不要混合比較不同網路下的結果。到這裡，實際存取正常且處理策略符合預期，才算完成這條連線的基本檢查。
Settings：常見問題與後續設定
先找出問題發生在哪個步驟，再修改相應設定。每次只改一項，並保留可還原的原始設定。
匯入失敗：先檢查連結與內容
如果在 Subscribe 儲存或更新時失敗，請先確認裝置本身可連上網路，再檢查連結是否完整、憑證是否仍有效。在取得訂閱時發生錯誤，尚不能據此判斷清單中的所有伺服器都不可用。請確認服務供應商提供的連結用途與內容格式，不要將規則配置網址當成伺服器訂閱。需要更新連結時，優先編輯原有訂閱；更新後再檢查項目變化。
測試逾時：核對參數與測試方式
如果伺服器已匯入，但 Connectivity Test 沒有回應，請前往 Settings 查看 Test Method，了解目前採用的測試方式，再檢查 Type、Host、Port、驗證資訊及相應的 TLS、傳輸參數。測試方式不同，結果也可能不同；不要只為了取得回應就反覆修改不明欄位。裝置日期與時區應設定正確，尤其在驗證憑證時更要檢查系統時間，不要直接放寬驗證條件。
同一台伺服器在一個網路下失敗、另一個網路下正常時，請記錄兩邊結果並檢查目前網路是否另有限制。所有參數均符合原始資料卻仍無法連線時，請向自己的服務供應商確認伺服器狀態與資料有效性。向他人回報前，請遮蔽 Password、身分憑證、訂閱連結及其他可用來存取服務的資訊。
已連線但部分要求失敗：檢查規則與紀錄
若開關維持啟用，卻只有部分頁面異常，請先查看 Data 中相應的要求紀錄，再核對 Global Routing 與目前 Config。確認是否符合預期的 PROXY、DIRECT 或 REJECT，以及策略群組是否選取可用目標。若涉及網域解析，請記錄具體失敗網域與錯誤，不要同時更換 DNS、規則檔與伺服器。DNS 與規則欄位的詳細說明請參閱配置欄位參考；先依現象定位，再閱讀對應章節。
Diagnostics 與 On Demand：基礎連線正常後再使用
Settings 中的 Diagnostics 可用於進一步查看診斷資訊。診斷紀錄只能輔助判斷，不能取代有效的伺服器資料；分享紀錄前，先確認其中是否含有私密位址或憑證。遇到持續發生的問題，保留操作順序、錯誤提示與網路環境，比只描述「無法使用」更有助於排查。完整的逾時排查順序請參閱連線失敗檢查清單。
手動連線已確認成功後，再設定 On Demand。啟用前先了解觸發條件，確認哪些網路情境需要自動建立連線；它無法修正錯誤的訂閱或伺服器參數。如果關閉連線後又自動連上，請檢查 On Demand 及相關觸發設定。背景連線與耗電之間的取捨，請參閱On Demand 使用時機說明；初次使用時不必一次完成所有設定。
完成後保留一組已確認有效的設定：伺服器、Global Routing 與目前配置。之後調整前先備份，每次只修改一個欄位，並重複「連線、實際存取、查看紀錄」的檢查流程。即使結果異常，也能還原到上一組已知可用的設定，不必從頭重新匯入所有內容。
