OFFICIAL MANUAL / QUICKSTART
Shadowrocket
匯入、連線與驗證
依五個步驟完成初始設定。先讓一台既有伺服器正常運作，再檢查規則；不要同時修改伺服器、DNS 與分流設定。
建議預留約 10 分鐘依序操作；實際所需時間取決於資料是否完整、網路狀態及系統授權。配圖皆為 App Store 官方截圖，供辨識介面位置；欄位請以裝置上實際顯示為準。
STEP 01 / SERVER INPUT
Add Server：新增伺服器或匯入訂閱
先依手邊資料選擇匯入方式。若有單一伺服器的完整參數，請手動新增；若有訂閱連結，則使用 Subscribe。兩種方式都是為了讓 Home 的 SERVER 區域出現可選取的伺服器，首次連線不必兩種都操作。
手動新增：欄位須與既有資料相符
前往 Home，點選 Add Server，或點選新增項目的加號進入新增頁面。先開啟 Type，選擇資料中註明的協定類型，再填寫該類型所需欄位。Type 會影響後續顯示的選項，請勿先照截圖填寫，再任意更換類型。
例如，官方截圖顯示 Host、Port、Password、Method 等欄位：Host 填入伺服器主機名稱或位址，Port 填入相應連接埠，Password 與 Method 則依原始資料逐項核對。其他協定可能使用不同的身分識別、傳輸或安全設定，不能將某一類型的 Password 當成所有協定通用的欄位。密碼大小寫、尾端空格，以及複製時帶入的換行，都可能造成連線失敗。
確認資料後，使用頁面上的儲存或完成操作返回 Home，查看 SERVER 中是否出現新增項目。若資料是 QR Code，可使用 Scan QR Code，並依系統提示授予相機權限。Import from Cloud JSON 是另一種結構化資料匯入方式，請勿將一般訂閱連結當成相應的 JSON 內容使用。
Subscribe：匯入完整的個人訂閱連結
若有訂閱連結，請在 Add Server 開啟 Type 並選擇 Subscribe，將完整的個人連結填入相應的 URL 欄位，輸入方便辨識的備註後儲存。連結應來自你自己的服務商資料；複製時請保留完整路徑與參數。訂閱連結通常包含身分資訊，請勿貼到公開討論區，或放入分享截圖。
儲存後，等待訂閱請求完成，再返回 Home 查看訂閱群組及其中的伺服器項目。若只看到群組名稱，底下沒有可選取的伺服器，請勿立即開啟連線開關：先嘗試更新訂閱，並確認回傳內容是用戶端可辨識的訂閱資料，而非登入頁面、錯誤頁面或一般網頁。
匯入成功後，先選取其中一台伺服器作為本次測試對象。後續排查都以這個項目為準，避免每次失敗就同時更換多項設定。訂閱與 .conf 設定檔並非同一回事；如需了解兩者差異，請參閱概念速查中的訂閱與設定說明。
STEP 02 / ROUTING CHOICE
Global Routing：選擇本次流量的處理方式
先確認本次要測試伺服器，還是驗證日常規則。在 Home 開啟 Global Routing，可選擇設定檔 (Config)、代理 (Proxy) 或直連 (Direct)。此處調整的是流量處理方式，無法修正錯誤的伺服器密碼，也不會補上缺少的連線資料。
首次檢查選 Proxy，規則分流選 Config
代理 (Proxy)適合將本次測試集中至目前選取的伺服器。首次匯入後，可先選擇 Proxy 再進行下一步連線，減少規則命中差異造成的干擾。但這不代表所有服務都一定能存取，實際結果仍受伺服器、目標服務與網路狀況影響。
設定檔 (Config)會依目前啟用設定檔中的規則處理請求。使用前請前往 Config 頁面，確認目前生效的設定檔；開啟檔案查看內容時，請留意 General 與 Rule。僅開啟或編輯某個檔案，並不代表它已成為目前使用的設定，還須確認設定檔列表中的選取狀態。
直連 (Direct)會直接存取目標，不經所選代理伺服器轉送。這有助於進行對照：同一目標在 Direct 與 Proxy 下結果不同，表示需要進一步區分網路路徑或伺服器問題，不應直接歸因於 App 開關。若希望流量經由既有伺服器傳送，不能只看頂端顯示已連線，還要確認目前沒有選擇 Direct。
在 Config 中先確認，不急著修改規則
右側官方截圖顯示設定檔的各個區段及 Add Rule 入口。初次使用時，先確認現有規則的策略含義，不必修改 Hosts、URL Rewrite 或 HTTPS Decryption。以下是獨立的語法範例，並非可直接取代現有設定的完整設定檔，也不包含任何伺服器資料。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXYRule 通常依序判斷，前面的具體比對可能先於後續規則決定結果。範例中的 DOMAIN-SUFFIX 比對網域後綴，IP-CIDR 比對 IP 位址範圍，FINAL 處理前面未命中的請求；PROXY、DIRECT、REJECT 是策略關鍵字，需與 Global Routing 中的介面選項分開理解。
確認模式後返回 Home，保留選取的伺服器。若要進一步設計規則、了解 DNS 或調整設定檔區段，請閱讀系統教學；此處先以明確的模式完成連線，避免測試時同時重寫整份設定檔。
STEP 03 / CONNECTION
Home：開啟開關並完成系統授權
確認伺服器與 Global Routing 後，再開啟 Home 頂端開關。連線前最後確認一次選取的伺服器，尤其是訂閱中有多個名稱相近的項目時；群組名稱與實際選取的伺服器不一定位於同一層級。
首次連線時先處理 VPN 設定提示
首次開啟時，系統可能提示 Shadowrocket 要求新增 VPN 設定。此提示是為了允許用戶端透過系統網路功能處理流量；確認 App 名稱與提示內容後，依系統畫面確認並完成裝置要求的驗證。若暫時取消，返回 App 後須再次觸發授權；未完成授權不代表遠端伺服器故障。
完成授權後返回 Home，查看頂端狀態是否從 Not Connected 變為已連線。不要只看開關剛亮起的瞬間：若開關很快關閉或狀態反覆變動，請先記錄情況，再到第五步排查。系統授權成功表示本機設定獲准建立，不代表遠端交握、DNS 查詢及目標存取都已成功。
連線後先維持設定不變
開關保持開啟時，先不要再切換多台伺服器或連續更改 Global Routing。保留目前的組合，前往下一步執行 Connectivity Test，再開啟一個實際需要存取的目標。即使測試失敗，也能判斷問題出在哪組條件。
在 iPad 上依相同步驟完成選擇與授權。螢幕方向及視窗寬度可能影響列表與詳細資訊的位置，請依 Home、Config 等介面名稱尋找入口，不要只憑截圖中的按鈕座標操作。若頁面配置與截圖不同，請先確認目前所在頁面及操作對象。
若要停止本次連線，返回 Home 關閉頂端開關，再確認連線狀態是否結束。如果先前設定了 On Demand，系統可能依條件再次觸發連線；此時應先檢查觸發條件，而不是反覆刪除設定。初次使用不必額外啟用 On Demand，先手動驗證一輪較容易找出問題。
STEP 04 / VERIFY REQUESTS
Connectivity Test：分別確認測試結果與實際存取
驗證時要確認三件事：測試是否有回應、實際目標能否存取，以及請求是否依預期策略處理。三者彼此相關，但不能互相取代。測試有回應，只表示在該測試方式下取得結果，不能據此推論所有協定、網站與規則都正常。
先執行測試，再發出實際請求
維持第三步的連線與伺服器選擇，在 Home 點選 Connectivity Test，等待結果並記錄目前使用的網路、伺服器及 Global Routing，不必追求特定的延遲數值。若顯示逾時，也先不要刪除項目，因為測試目標、測試方式與伺服器狀態都可能影響結果。
接著切換至需要連線的 App，開啟明確的目標頁面或重新載入實際內容。盡量發出新的請求，避免把已快取的頁面誤認為連線正常。若目標需要登入帳號，或服務本身發生問題，也應與網路連線問題分開判斷。
使用 Data 對照規則，不只看總流量
返回 Shadowrocket，在 Data 中查看可用的請求或連線記錄，比對剛才存取的目標、時間及策略資訊。使用 Config 時，請確認請求是否依預期走向 PROXY、DIRECT 或 REJECT。總流量增加只表示有資料活動，不足以證明某個網域命中預期規則。
若目標在 Proxy 下可存取，切換至 Config 後卻失敗，請先確認目前啟用的設定檔、具體規則順序與 FINAL，不要立刻重新輸入伺服器密碼。反之，若 Proxy 下也失敗，應優先檢查伺服器參數、網路路徑及實際目標。只有在同一台伺服器、同一網路與同一目標下比較模式，結果才有參考價值。
若只有網域存取異常，再進一步檢查 DNS；症狀尚未確認前，不要同時更換多個 DNS、協定參數與規則。每次只修改一項，儲存後重新連線並發送新請求，記錄結果。快取及既有連線可能暫時保留舊結果，因此重新整理一次不一定能判斷修改是否生效。
STEP 05 / ISOLATE FAILURE
Settings：依症狀找出常見問題
先分類問題，再調整設定。保留原有設定及可還原的記錄，不要一開始就清除所有項目。以下依序檢查匯入、本機連線、遠端測試及規則；找到相應症狀後，每完成一項修改就返回第四步重新測試。
匯入後沒有伺服器：先確認輸入內容
訂閱無法更新或群組為空時，重新確認完整連結是否複製成功、是否已失效，以及目前網路能否連至訂閱網址。若回傳的是帳號登入頁或錯誤訊息，須先處理訂閱本身的存取問題。再次點選連線不會自動補齊既有伺服器，反覆開關也無法修正不符合預期的訂閱內容。
手動新增的項目雖已儲存但無法使用時，逐項比對 Type、Host、Port，以及該協定要求的身分識別與安全欄位。特別要確認資料沒有混用：不能任意將一台伺服器的主機名稱搭配另一個項目的密碼或傳輸設定。不了解的欄位請先查閱原始資料，不要只憑名稱猜測填寫。
開關無法保持開啟：先確認本機授權與觸發條件
若開關一開就關，先確認系統 VPN 設定授權是否完成，以及是否有其他設定正在影響系統 VPN 連線。返回 Settings 查看 On Demand；若先前設定了依網路觸發的條件，請先記錄原設定，暫停自動觸發後手動重新測試，分辨主動連線失敗與條件規則反覆觸發。
若要檢查系統中的 VPN 設定，可在系統設定中搜尋 VPN，並確認相應項目。未備份前請勿批次刪除設定，也不要只憑狀態列圖示推斷遠端伺服器已通過驗證。
測試逾時且結果不一致：檢查 Test Method
在 Settings 找到 Test Method，確認目前的測試方式。不同方式驗證的對象與階段各異，測試結果不能直接等同於實際 App 的完整存取能力。先以相同方式比較，再搭配實際目標請求判斷；不要因為單次逾時，就認定所有項目都發生相同故障。
必要時比較原有網路與另一個可用網路，每次維持伺服器與模式不變。若只有某個網路失敗，請繼續檢查該網路的限制、驗證或連線狀態；若多個網路都在同一項目上失敗，則重新確認伺服器資料與服務狀態。
只有部分請求失敗：再檢查規則與診斷資訊
只有特定目標失敗時，在 Data 找出相應請求，檢查是否遭到 REJECT、是否意外走向 DIRECT，以及是否已命中較前面的 Rule。修改前先記錄規則位置與原值；不要為掩蓋問題而將所有請求改用同一策略，暫時比對完成後應恢復預期模式。
Settings 中的 Diagnostics 可用來進一步收集資訊。診斷內容可能包含目標位址、訂閱資訊或連線參數，分享前請檢查並遮蔽身分資料。初次設定時，不要隨意調整 Proxy、TCP、UDP 中不熟悉的項目；應依明確症狀逐項驗證。
排查完成後，返回 Home 選取確認可用的伺服器，還原預期的 Global Routing，再重做測試與實際存取。日常維護、訂閱更新、Data 閱讀及 Settings 的進一步說明，請參閱Shadowrocket 系統教學。本頁的目標是建立一組經過驗證且可還原的基本設定，而非一次調整所有進階選項。
