Shadowrocket 使用教學
匯入訂閱與連線驗證
先讓一台既有伺服器成功連線，再檢查規則分流。以下以 iPhone 與 iPad 為例，依實際操作順序說明入口、預期結果，以及失敗後的處理方式。
- 01 匯入資料
- 02 選擇模式
- 03 開啟連線
- 04 驗證結果
- 05 找出問題
新增伺服器／匯入訂閱
完成標準：Home 的 SERVER 分組中出現自己的伺服器項目。
先確認手上的資料屬於哪一類。單一伺服器資料通常包含協定、位址、連接埠與認證欄位；訂閱連結則用來取得並更新一組伺服器項目。兩者不可混用：請勿將完整訂閱連結填入單一伺服器的 Host，也不要把只有網域名稱和連接埠的文字當成完整訂閱。開始前請保留原始資料，避免多次複製時遺漏字元。
手動填寫 Add Server
開啟 Home，在 SERVER 分組找到並進入 Add Server。先選擇 Type，再依該協定顯示的欄位填寫。以截圖中的表單為例，Host 是伺服器位址，Port 是連接埠，Password 與 Method 應與既有資料一致；選擇其他 Type 時，欄位可能不同，請以相應協定資料為準，不要照著截圖填滿所有欄位。
位址與連接埠請分開填寫，並留意複製內容前後是否有空格、換行或全形標點。密碼、認證識別等內容若區分大小寫，務必保持原樣；Method 也不可自行替換成名稱相近的選項。若資料還包含傳輸或安全性參數，請展開相應設定逐一確認，不要為了縮短表單而刪除既有參數。填寫後儲存，返回 Home 檢查項目名稱，確認已儲存剛才輸入的伺服器。
透過 Subscribe 匯入既有訂閱
已有訂閱連結時，請使用 Config 頁面的 Subscribe 入口，確認所選項目接受的是伺服器訂閱還是設定檔網址；在要求輸入 URL 的欄位貼上既有連結，確認後儲存並執行更新。請勿將僅供開啟帳戶頁面的普通網頁網址當作訂閱。若入口因目前頁面狀態而有所不同，請依 Subscribe 項目說明判斷內容類型；最後以 Home 是否出現伺服器項目確認匯入結果。
成功儲存不代表已成功取得資料。返回 Home 後，若分組仍是空的，請先檢查更新結果，再確認連結是否完整，以及目前網路能否取得訂閱。連結可能包含個人存取憑證，請勿在公開截圖或留言中完整顯示。QR Code 資料可使用 Scan QR Code 讀取；讀取後仍須確認產生的伺服器欄位。Import from Cloud JSON 僅接受相應格式的內容，並非通用的訂閱連結匯入入口。
確認清單中已有項目後，先不要連續更新或重複匯入。保留一個容易辨識的項目，接著選擇 Global Routing；重複匯入產生的相似名稱，會增加後續確認伺服器選擇的難度。入口與格式的更多差異，請參閱訂閱匯入常見問題。
選擇 Global Routing 與目前設定檔
完成標準：能說明目前模式，以及請求應採用哪一種連線路徑。
伺服器新增完成後，返回 Home，點選 Global Routing 檢查目前模式。此處決定請求如何分流，不會補齊伺服器資料。初次操作時，最容易混淆的是「已匯入伺服器」和「已啟用設定檔」：前者提供連線目標，後者決定哪些請求使用該目標，兩者都要分別確認。
三種模式的選擇依據
設定檔（Config）會依目前設定檔中的規則，決定請求採用 PROXY、DIRECT 或 REJECT 等策略，適合已有明確分流設定的情況。這不代表「所有請求都會經過目前伺服器」。如果規則將某個網域指定為 DIRECT，即使連線開關已開啟，該請求仍可能直接連線。
代理（Proxy）會讓一般請求採用代理路徑，適合初步確認所選伺服器能否支援實際瀏覽。它無法修正錯誤的伺服器欄位，也不能取代系統授權；系統與應用程式對特定流量的處理仍受相關設定限制。直連（Direct）會直接連線，適合用來與代理路徑進行基本比較；選擇後若存取路徑未經伺服器，不應因此判定為連線故障。
在 Config 頁面檢查什麼
準備使用設定檔（Config）時，請前往 Config，確認目前選用的是預計啟用的檔案。官方截圖展示設定檔編輯器中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段，以及 Add Rule 入口；各區段用途不同，首次連線不必逐一修改。伺服器訂閱更新成功，也不代表目前的規則檔已切換或更新。
例如，下列規則表示依網域後綴比對並選擇 PROXY。這裡僅用來說明語法，example.com 是示範網域；單一規則不構成適用於所有請求的完整設定。規則排列順序、預設策略，以及目前是否選用該檔案，都會影響最終結果。
DOMAIN-SUFFIX,example.com,PROXY初步檢查時，可先使用代理（Proxy）測試既有伺服器，再切換至設定檔（Config）觀察分流差異。每次只切換這一項，並記錄測試目標，避免同時更換伺服器、模式又修改規則，導致結果無法比較。設定檔結構與比對順序請參閱規則手冊；本教學先保留既有設定，繼續進行連線步驟。
選取伺服器，開啟 Home 連線開關
完成標準：明確選中伺服器，完成系統授權，且連線狀態維持正常。
返回 Home，在 SERVER 分組點選此次要使用的伺服器，確認項目旁是否出現選取圓點。清單中有伺服器不代表已選為預設伺服器，開啟項目的編輯頁面也不等於完成選取。若有多個分組，請先記下所選項目的分組與名稱，後續測試時保持不變，方便將結果對應至同一筆資料。
確認 Global Routing 後，開啟 Home 頂端的連線開關。尚未連線時，截圖頂端會顯示 Not Connected；實際操作時，請觀察開關與連線狀態是否隨操作改變，不要只看清單中是否顯示延遲結果。首次啟用時，系統可能提示新增 VPN 設定；請確認提示中的應用程式名稱，允許後依系統要求完成裝置認證，再返回 Shadowrocket。
此授權是讓應用程式建立系統網路連線所需的設定權限，不是匯入伺服器的步驟，也不會自動產生訂閱或補上認證資料。若剛才取消提示視窗，請返回應用程式再次嘗試連線；若裝置受管理政策限制或系統明確禁止修改，請先確認裝置允許的範圍，不要反覆切換開關來猜測結果。
授權後請稍候，觀察連線狀態是否穩定。若開關剛開啟就自行關閉，先記下當時的提示，再確認是否已有其他 VPN 連線正在使用，或系統設定是否尚未完成。請勿立即刪除應用程式與所有設定；先保留原有資料，後續排查時才能區分授權問題與伺服器問題。
開關保持開啟且狀態顯示已連線時，只能確認系統連線通道已建立，不能據此判斷所有網站都能正常瀏覽。接著應透過 Home 的 Connectivity Test 與實際瀏覽交叉驗證。這項區分很重要：系統狀態、伺服器回應與規則命中是三種不同結果，不能互相取代。
使用 Connectivity Test 與實際瀏覽驗證
完成標準：測試結果能與實際瀏覽情況對照，且能說明切換模式所造成的影響。
維持剛才選定的伺服器與 Global Routing，在 Home 點選 Connectivity Test，等待本次檢查完成。測試用於觀察伺服器在目前測試方式下的回應情況，並非對所有協定、目標與網路條件的完整驗證。出現回應數值不代表所有目標都能存取；若逾時，也要搭配 Settings 中的 Test Method 判斷，不要只憑一次結果就刪除伺服器。
接著開啟瀏覽器或需要連網的應用程式，瀏覽平常使用且網址明確的頁面。確認頁面確實重新載入內容，而非只顯示先前的快取；必要時重新整理或重新開啟頁面。先測試一個目標，記錄伺服器、模式、網路類型與結果；確認成功後再擴大檢查範圍，比同時開啟多個頁面更容易判斷。
如果使用代理（Proxy）時瀏覽正常，切換至設定檔（Config）後只有特定目標失敗，應優先檢查目前設定檔及該目標命中的策略，不要立即判定伺服器失效。Config 中 DIRECT、PROXY 與 REJECT 的結果各不相同，連線開關持續開啟也不會消除這些差異。需要進一步確認時，可查看應用程式中的連線記錄，確認目標網域與策略，再參閱規則手冊了解比對順序。
若 Connectivity Test 有回應但實際瀏覽失敗，接著確認協定參數、目標請求類型與目前規則；若測試與實際瀏覽都失敗，請先確認目前網路能否正常連線，再檢查伺服器資料。Wi-Fi 與行動網路的結果可互相比較，但切換網路後必須重複相同測試，不可直接比較兩個不同目標的結果。
常見問題與 Settings 檢查
分層找出問題，每次只調整一項；先保留可用的既有設定。
匯入後沒有伺服器
先返回匯入入口，確認儲存與更新是否都已完成。訂閱內容、設定檔與一般網頁的用途不同；連結能在瀏覽器開啟，不代表它提供了可辨識的伺服器資料。請確認連結完整、未被複製工具插入換行，以及存取憑證仍然有效；若原始資料已有變更，請依自己的最新資料更新。清單為空時，反覆開啟連線開關不會補上缺少的項目。
開關自行關閉，或顯示已連線但沒有回應
開關自行關閉時，優先檢查系統 VPN 授權、應用程式提示，以及目前是否有連線衝突。若開關維持開啟但請求失敗，再確認伺服器選擇、Type、Host、Port、認證與傳輸參數。即使名稱相同，也不應混用不同伺服器的欄位。請一次只測試一個已選取的項目，修改並儲存後重新連線，確保後續結果對應最新設定。
測試逾時或切換網路後發生異常
前往 Settings 查看 Test Method，了解目前採用的測試方式，再判讀 Connectivity Test 結果。測試方式改變可能影響回應表現，但不代表伺服器資料本身發生變化。若切換網路或中斷後重新連線時出現異常，請檢查 On Demand 是否依預期啟用；初步排查時先記下其狀態，避免將按需連線觸發的行為誤判為開關故障。
Settings 中還有 Diagnostics、Proxy、TCP、UDP 等項目。完成基本檢查後，可透過 Diagnostics 蒐集更多線索；Proxy、TCP、UDP 涉及更具體的連線行為，不建議為了測試而同時變更。部分網路對不同傳輸方式的處理各異，單一網頁成功也不能證明所有類型的請求都已通過。請先重現問題，再依實際協定與錯誤資訊檢查相應項目。
準備進一步排查時應保留的資訊
記下問題發生的步驟、目前模式、網路類型，以及可重現的錯誤訊息。若需提供截圖，請先遮蔽伺服器認證資料、個人訂閱網址及其他敏感欄位；不要公開完整設定檔。還原至上一組可用設定後重複相同測試，有助判斷問題是否由本次調整造成，比一次清除所有資料更有依據。
完成首次連線後，日常使用只需依據既有伺服器與明確的分流目標逐步調整。訂閱更新、授權提示與連線問題，請參閱FAQ；General、Rule 與策略關鍵字，請查看規則手冊。若目前已能穩定重現一次成功瀏覽，請先保留目前設定，不必為了完成教學而修改其他進階設定。
