Shadowrocket 使用教學
匯入、連線與驗證
以 iPhone / iPad 介面為例，依五個操作環節完成首次使用。先讓一筆既有伺服器資料正常運作，再檢查規則；不必一開始就逐項修改所有設定。
- 01 新增
- 02 選擇模式
- 03 連線
- 04 驗證
- 05 排錯
截圖取自 App Store 官方素材，用於辨識頁面與欄位。實際排列可能隨客戶端調整，請以目前 App 顯示為準；請勿照抄截圖中的伺服器資料。
Add Server：新增伺服器或匯入訂閱
開啟 Shadowrocket，先前往 Home。尚未新增資料時，SERVER 群組中沒有可選伺服器是正常狀況。點選 Add Server 進入新增頁面，再依手上的資料選擇匯入方式：訂閱連結、單筆分享資料、QR Code 和手動欄位並非相同的輸入方式，請勿將完整訂閱連結填入 Host。
使用既有訂閱連結
進入 Add Server 後點選 Type，選擇 Subscribe，在相應的 URL 輸入欄位貼上完整訂閱連結。貼上前後檢查是否帶入換行、空格或聊天訊息中的說明文字，尤其不要漏掉連結末尾的參數。填寫方便自己辨識的名稱後儲存，等待客戶端取得並解析內容，再返回 Home 檢查 SERVER 中是否出現項目。
儲存成功只代表輸入內容已儲存，不代表訂閱一定已下載成功。如果沒有出現項目，先檢查目前網路能否連上訂閱網址，以及連結是否仍有效；不要連續建立多個相同訂閱來嘗試修復。訂閱傳回的內容必須是客戶端能解析的連線資料，網頁提示、登入頁面或錯誤文字不能直接當成伺服器清單。
使用單筆伺服器資料或 QR Code
手動新增時，先在 Type 選擇與資料相符的協定，再填寫 Host、Port 及該協定所需的其他欄位。例如 Shadowsocks 需要確認 Password 與 Method；其他協定可能顯示不同的身分或傳輸設定。欄位不確定時應回頭核對原始資料，不能憑名稱猜測，也不要將某個協定的密碼填入另一個協定的身分欄位。
若已有 QR Code，可在新增頁使用 Scan QR Code，依系統提示授予相機權限，辨識後仍需檢查 Type 與伺服器欄位。Import from Cloud JSON 是另一種匯入入口，不等於 Subscribe，也不適合任意貼上一般訂閱連結。完成一種新增方式即可，不必將所有入口都操作一遍。
最後返回 Home，在 SERVER 中點選一個確實有權使用的項目，確認其選取狀態。清單中出現很多名稱不代表它們全部可用；先保留一個明確的測試對象，下一步再選擇如何處理請求。
Global Routing：選擇三種模式
選好伺服器後，返回 Home 點選 Global Routing。這裡決定請求採用哪一類處理方式，而不是切換伺服器協定。三種模式分別是設定檔(Config)、代理(Proxy)、直連(Direct)。先確認這次測試的目的，再選擇相應項目，避免一邊排錯一邊反覆切換，卻沒有留下紀錄。
設定檔(Config)依目前設定檔中的規則決定請求去向，適合需要規則分流的使用方式。使用前開啟 Config，確認已有並啟用適用的設定檔。匯入訂閱通常是取得伺服器項目，不應因此認定完整的規則設定也已準備妥當；伺服器清單與設定檔需要分別檢查。
代理(Proxy)會依該模式透過所選代理處理請求，可作為短時間的對照測試：若同一目標在 Proxy 下可連線、在 Config 下無法連線，應優先檢查規則與策略。這無法修復錯誤的認證資料，也不能保證所有 App 的行為都相同。完成對照後，應恢復原本需要的模式。
直連(Direct)用於直接連線，不能因為「已開啟開關」就判斷請求一定經過所選伺服器。若原本想測試代理連線卻選了 Direct，即使瀏覽器能開啟一般網頁，也不足以證明伺服器可用。模式、所選項目與實際命中的策略是需要同時確認的三個條件。
首次使用先了解一段規則
在 Config 頁面中可以查看 General、Rule 等區段；本次只需了解 Rule 的比對順序，不必修改 HTTPS Decryption 等無關設定。以下是教學片段，不能直接取代完整設定檔：
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY第一行讓符合 example.com 及其子網域的請求使用 PROXY；符合後續 GEOIP 規則時使用 DIRECT；仍未符合前面規則的請求則交給 FINAL。規則由上而下檢查，符合後採用該行策略，因此 FINAL 放在最後。實際使用的 PROXY 還需要有可用的代理選擇，規則文字本身不會建立伺服器。
本步完成標準是：能說明目前選了哪種模式，以及使用 Config 時啟用了哪個設定檔。規則類型、REJECT 與設定區段的完整說明請參閱設定完整指南，這裡先保持設定穩定，繼續進行首次連線。
Home：開啟頂端連線開關
返回 Home，依序檢查兩件事：SERVER 中已有選取的伺服器，Global Routing 顯示剛才決定的模式。接著開啟頁面頂端、初始顯示 Not Connected 附近的開關。先完成這一步，再觀察瀏覽器；不要將新增成功與連線成功混為一談。
首次連線時，iPhone / iPad 可能會顯示新增 VPN 設定的系統提示。閱讀提示，確認這是剛才由 Shadowrocket 發起的操作，再選擇允許，並依系統要求使用裝置密碼或驗證身分。系統授權用於建立本機網路連線設定，不是購買額外線路，也不需要將訂閱密碼填入系統身分驗證視窗。
如果先前選擇取消，開關未能保持開啟，不一定代表伺服器失效。再次開啟開關，觀察是否重新出現授權提示；必要時前往系統設定搜尋 VPN，檢查既有連線設定與目前狀態。排查時暫停其他正在使用的 VPN 連線，避免另一項連線接管流量；不要在沒有紀錄的情況下大量刪除裝置上的設定。
完成授權後返回 Home，等待頂端狀態變更。開關開啟後又立即關閉時，先停留在目前頁面記下提示文字，再檢查系統授權和伺服器欄位。此時連續切換十幾個項目只會增加變數，不利於分辨是設定問題，還是某筆連線資料有問題。
裝置出現 VPN 狀態圖示，代表系統連線狀態已變更，但不表示所有請求都會走 PROXY，也不表示訂閱中的每台伺服器都可連線。Global Routing 仍可能是 Direct，Config 也可能讓部分請求使用 DIRECT。保持 App 連線開啟，下一步透過測試與實際瀏覽共同驗證，而不是只憑一個狀態圖示下結論。
完成本步後，暫時不要開啟 On Demand。先確認手動連線、中斷與重新連線都正常，再考慮依需求自動連線，方便日後區分手動操作和自動觸發行為。
驗證：測試、瀏覽與規則紀錄
步驟 04 · 分別確認「已連線」與「依預期處理請求」。
先執行 Connectivity Test，再實際瀏覽
保持連線開啟時，在 Home 使用 Connectivity Test。測試反映的是目前測試方法與測試目標下的可連線性，不代表每個網站、每個 App 或所有傳輸方式都正常。測試有回應時，接著用瀏覽器開啟一個自己知道應當可用的頁面；測試逾時時，也先記下結果，不要立即認定整份訂閱都已失效。
實際瀏覽時，盡量開啟新頁面並重新載入，避免瀏覽器快取讓結果看起來沒有變化。先測試一個目標，再測試另一個用途不同的目標，不要一次開啟大量頁面。若某個目標失敗而其他目標正常，應進一步判斷目標本身、網域解析或規則是否有差異，而不是立刻重新安裝客戶端。
檢查請求是否符合預期策略
需要驗證分流時，開啟客戶端的請求記錄或 Data 中可用的記錄檢視，找到剛才送出的請求，確認目標網域、命中規則及策略。若要驗證 PROXY，應看到相應請求使用 PROXY；如果記錄顯示 DIRECT，先返回 Global Routing 與目前設定檔檢查原因。介面未顯示足夠資訊時，可在下一步使用 Diagnostics 收集相關診斷線索。
以相同目標進行一次短時間的對照更有參考價值：保持伺服器不變，只將 Config 切換至 Proxy 再瀏覽。如果結果改變，表示應優先檢查設定檔的分流規則；若兩種模式都失敗，則繼續確認伺服器、網路和目標。完成對照後恢復原本模式，並記下結果，避免長期保留臨時測試模式。
最後中斷連線，再重新連線並重複一次瀏覽。這樣可以確認成功不是先前快取或暫時狀態造成的。確認手動連線穩定後，再開始日常使用；自動連線、複雜規則與更多設定可稍後逐項新增。
Settings：依失敗環節排查
遇到問題時，先定位停在哪個步驟，再前往 Settings 查看相關設定。這裡的 Test Method 會影響測試方式，Diagnostics 用於診斷；兩者都不能取代正確的伺服器欄位。先記下現象、目前網路、Global Routing 和所選項目，修改一個條件後重試，才能確認是哪項變更產生作用。
匯入後沒有出現伺服器
返回 Subscribe 檢查連結是否完整、是否誤複製成網頁網址、是否帶入空白字元，以及訂閱是否仍在有效期限內。若客戶端提示取得失敗，先確認目前網路能連上該網址；若提示解析失敗，請核對傳回內容的格式。必要時向原資料提供者確認連結狀態，不要將連結公開貼到討論區。訂閱連結可能包含存取憑證，應比照密碼妥善保管。
開關無法保持開啟
先查看系統 VPN 設定授權是否已完成，再確認 Type、Host、Port 與協定所需欄位。留意錯誤發生在授權之前、剛連線時，還是等待一段時間之後。若另一項 VPN 正在執行，先暫停後重試；若裝置由公司或學校管理，系統政策也可能限制變更，請遵循裝置管理要求，不要反覆刪除管理設定。
顯示已連線，但頁面無法開啟
確認 Global Routing 沒有誤選 Direct，再透過 Connectivity Test 與實際頁面交叉檢查。保持設定不變，改用另一種可用網路測試，例如在 Wi-Fi 與行動網路間切換；若結果不同，記下相應的網路條件。只有部分網域失敗時，檢查 DNS 與命中規則；兩種模式都失敗時，優先確認伺服器狀態、憑證和目標可連線性。
瀏覽正常，但分流不符預期
返回 Config 確認啟用的是剛才檢查的設定檔。檢查範圍較廣的規則是否排在具體規則之前、FINAL 是否位於末尾，以及規則中的策略是否符合目的。不要為了修正一條比對規則，同時更改 DNS、協定、伺服器和所有規則；先用一個網域重現問題，再依請求記錄調整相應規則。
準備尋求協助時，可整理錯誤提示、重現步驟與已嘗試的對照結果。分享截圖或診斷記錄前，請遮蔽訂閱連結、密碼、身分欄位和伺服器存取憑證；記錄中也可能包含瀏覽過的網域，提交前應先檢查。更多訂閱、網路和帳號問題可依類別查閱常見問題，規則語法則請參閱設定完整指南。
完成首次連線後，保留一份可正常運作的設定記錄。日後更新訂閱、調整規則或啟用 On Demand 時，仍依照「修改一項、測試一次、記下結果」的順序進行；發生問題後即可回復上一份已驗證的設定，不必從安裝開始重做。
