官方手冊 · 初次設定
Shadowrocket 快速上手
依序新增連線資料、選擇模式、連線、測試及排查問題。本篇適用於初次在 iPhone 與 iPad 上使用，重點是完成一次完整連線；規則原理與複雜問題另有專頁說明。
以下截圖取自 App Store 官方素材，可用來辨識頁面與欄位。實際顯示的項目會依所選 Type 與 App 介面而異；填入的內容一律以自己的原始連線資料為準。
步驟一 · Add Server / Subscribe
新增伺服器或匯入訂閱
開啟 Shadowrocket 後，先停留在 Home，找到下方的 SERVER 區段。這裡可選擇實際連線的伺服器；剛安裝且尚未匯入資料時，沒有可選項目並不代表 App 異常。進入 Add Server，依手邊資料選擇一種新增方式即可，不必同時手動填寫並匯入訂閱。
已有單一伺服器資料
在 Add Server 中先點選 Type，選擇資料指定的協定，再填寫該協定所需欄位。截圖示範的表單包含 Host、Port、Password、Method；切換 Type 後欄位可能不同，因此不能將這份表單視為所有協定通用的填寫範本。Shadowsocks、VMess、VLESS、Trojan 等協定的參數不能互換，也不能只憑名稱相似就猜測。
Host 填寫伺服器位址，Port 填寫對應連接埠，Password 等驗證欄位依原始資料填入；若需要 Method，也必須逐項相符。複製內容後請留意前後空格、換行，以及輸入法自動替換的符號。若資料還包含 TLS、伺服器名稱或其他傳輸參數，請依資料補齊，不要因常見欄位已填完就直接略過。儲存後返回 Home，確認項目出現在 SERVER 中，再選取預計使用的項目。
若已有 QR Code，可使用 Add Server 頁面的 Scan QR Code 讀取自己的資料；辨識後仍須確認 Type 與位址。Import from Cloud JSON 適用於相應的結構化資料，並非一般訂閱入口；只有資料明確採用此格式時才使用。若不清楚欄位含義，可先查閱術語手冊，不要反覆更換協定類型來碰運氣。
已有訂閱連結
再次進入 Add Server，在 Type 中選擇 Subscribe，將自己的完整訂閱連結填入相應的位址欄位，再依頁面指示完成儲存。訂閱連結通常包含驗證資訊，複製時須包含完整路徑與查詢參數；不要只複製網站網域，也不要自行加上中文引號或說明文字。訂閱連結屬於敏感資料，不應放進公開截圖或疑難排解紀錄。
返回 Home 後，確認對應區段與伺服器項目是否出現；若只儲存了訂閱資料但尚未取得內容，請更新該訂閱並等待結果。匯入訂閱與選擇伺服器是連續的兩個步驟：清單出現後仍須選取一個項目，才能繼續下一步。若匯入失敗，先保留錯誤訊息並檢查連結，不要立刻更改 Global Routing；路由模式無法修復格式錯誤或已失效的訂閱網址。
步驟二 · Global Routing / Config
選擇 Global Routing 模式
新增伺服器後，返回 Home 並點開 Global Routing。這項設定決定請求的處理方式，與「選擇哪台伺服器」不同。初次使用時，請先決定要測試代理連線，還是依現有分流規則處理，再選擇對應模式；頂端開關開啟，不代表所有請求都會經過伺服器。
Config：依目前規則處理
Config 會依目前選取的設定檔規則判斷請求的路由。若要依網站區分 PROXY 與 DIRECT，請使用此模式，並前往 Config 頁確認實際啟用的檔案。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段分別管理不同類型的設定；初次連線不必為了「設定完整」而逐一修改，也不需要啟用與目前目的無關的功能。
尤其要區分伺服器訂閱與設定檔：前者通常用來更新伺服器清單，後者則定義連線與分流方式；匯入伺服器訂閱不代表已切換設定檔。在 Config 頁開啟檔案查看內容後，也要確認該檔案已選取並啟用。若需編輯，請先儲存可還原的副本，再透過 Rule 或 Add Rule 檢查目標網站對應的條件、策略與順序。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT這段範例表示 example.com 及其子網域會比對至 PROXY，其餘請求則由 FINAL,DIRECT 作為預設處理；example.com 僅為範例網域，並非伺服器或訂閱網址。規則會由上而下比對，較早符合的寬泛條件可能使後續規則無法生效。初次使用只要先理解這項關係即可；完整語法請參閱設定檔區段說明。
Proxy 與 Direct
初次排查時使用 Proxy，可減少規則差異，觀察目前伺服器的代理路徑能否正常存取目標；但這不代表所有系統請求都會採用完全相同的路徑。Direct 用於直接連線至目標，可作為基礎網路的對照，但不能用來證明伺服器可用。這兩種模式都不會自動補正錯誤的驗證參數。
若已有明確的設定檔，請選擇 Config 並依既定規則測試；若暫時無法判斷問題出在規則還是伺服器，可暫時使用 Proxy 作為對照，測試後再恢復原本模式。三種模式的適用情況請見代理模式說明，Direct 的細節請見Direct 說明。確認模式後，再開啟連線開關。
步驟三 · Home / VPN 設定授權
開啟開關並完成授權
返回 Home，依序確認 SERVER 中目前選取的項目，以及 Global Routing 模式。若剛更新過訂閱，請先確認原先選取的項目仍存在，且沒有誤選另一筆同名紀錄。連線使用的是目前選取的伺服器，而不是剛才最後開啟查看詳細資料的伺服器。
找到頂端 Not Connected 旁的開關並開啟。首次連線時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。確認提示中的 App 名稱後選擇允許，並依系統要求完成裝置驗證。這是授權 App 在裝置上建立相應網路連線設定，與訂閱效期或伺服器驗證無關。
授權完成後返回 Shadowrocket，查看 Home 頂端狀態是否從 Not Connected 變為已連線，以及開關是否維持開啟。系統確認視窗出現後，請先完成處理再繼續操作；授權尚未完成時不要反覆點按開關。若先前拒絕授權，請重新發起連線並依系統提示處理；必要時前往系統設定檢查 VPN 設定狀態，而非重新匯入相同的伺服器資料。
iPad 的頁面空間與系統提示版面可能不同，但檢查順序不變：「選取伺服器 → Global Routing → 頂端開關 → 系統授權」。若裝置受組織管理，系統政策可能限制新增 VPN 設定，請依裝置管理規定處理。系統需求與相容性請以 App Store 頁面標示為準，不應只根據截圖判斷裝置是否適用。
連線後先維持目前網路環境，暫時不要同時切換 Wi-Fi、伺服器與設定檔。如果狀態很快又變回 Not Connected，請記下問題發生在授權之前還是之後；這有助於後續判斷是系統設定還是連線參數出了問題。若需要更詳細的 Home 區段說明，請參閱初次開啟與 Home 頁面說明。
步驟四 · Connectivity Test / 實際瀏覽
確認連線與規則是否生效
連線狀態穩定後，在 Home 點選 Connectivity Test，查看目前伺服器的測試結果。測試有回應表示在該測試方法下可以連通，但不代表所有網站、協定或請求都正常。測試數值也不等於下載速度；請勿只比較數字而忽略實際瀏覽結果。
接著切換至瀏覽器，開啟一個自己確定正常、且與本次測試目標相關的網頁。優先重新載入頁面或送出新的請求，不要只看連線前已顯示的快取內容。確認文字與必要資源均能載入，再點選一次站內連結；只看到頁面標題，並不代表整個頁面的請求都成功。
依所選模式進行比對
使用 Proxy 時，先確認實際瀏覽是否成功；若測試有回應但網頁仍持續載入失敗，後續可檢查 DNS、目標網站存取與傳輸參數，不要直接判定「伺服器完全正常」。使用 Direct 時，即使連線成功，也只能表示直接存取路徑可用，不能當作代理連線的測試結果。
使用 Config 時，請分別選擇一個預期符合 PROXY 的網站，以及一個預期符合 DIRECT 的網站，並核對目前設定檔中的對應規則。兩類網站都能開啟，不足以判斷它們各自採用哪種路由；須配合規則順序與 App 內可查看的請求紀錄，確認實際符合的規則。若規則使用網域條件，也要留意網頁可能同時載入其他資源網域；主網域符合規則，不代表所有資源都採用相同策略。
初次測試時建議先簡化目標：先確認一條明確的連線路徑可用，再逐步恢復較複雜的分流設定。若要比較不同伺服器，每次只更換一個項目，並重新送出請求；若要比較模式，則維持相同伺服器與網路環境。如此才能判斷變化原因，避免將切換網路後偶然成功誤認為某項設定的效果。
完成後只需記下最後使用的伺服器、Global Routing 模式與目前 Config 檔案名稱，請勿記錄或傳播密碼、完整訂閱連結等敏感資訊。若基本連線與預期瀏覽均正常，快速上手流程到此完成；只有遇到具體症狀時，才需要繼續進行下方的疑難排解。
步驟五 · Settings / Diagnostics
檢查常見問題
先確認問題發生在哪個階段：沒有匯入項目、伺服器測試失敗、開關無法維持開啟，或已連線但網頁無法瀏覽。依序檢查比一次修改多項進階設定更容易找出原因。以下僅說明初次使用最常遇到的情況；若問題持續，請前往疑難手冊依症狀排查。
匯入後沒有伺服器
先確認新增時的 Type 是否選為 Subscribe、連結是否完整，以及更新時是否出現錯誤。一般網頁網址、帳戶頁面與訂閱網址是不同類型的資料。不要自行刪除查詢參數，也不要將含有驗證資訊的網址貼到公開頁面請人確認。若連結無法取得內容或回傳資料無法辨識，請向自己的服務供應商確認原始資料及適用格式；重複儲存相同的錯誤網址不會改變結果。
測試失敗或連線中斷
手動新增時，逐項核對 Type、Host、Port、驗證欄位與所需傳輸參數；匯入訂閱時，先確認內容已成功更新。接著檢查目前的基礎網路是否可用，並在相同環境下測試自己的其他現有項目。若多個項目同時失敗，也應考慮目前網路狀況，不宜立即判定每台伺服器都已失效。
在 Settings 查看 Test Method，確認目前使用的測試方法。更改測試方法後，結果代表的意義也會改變，因此前後數值不能直接比較。遇到 UDP 等傳輸相關問題時，不要將 Settings 中的 TCP 或 UDP 項目任意切換當作通用解法；請先確認伺服器協定要求，再依相應文件檢查。
開關異常或網頁無法開啟
開關無法開啟時，先確認系統 VPN 授權是否完成、是否有其他 VPN 設定正在使用，以及裝置是否受管理限制。若開關能維持開啟但網頁無法瀏覽，再檢查 Global Routing 與目前 Config；若 Proxy 可用但 Config 不可用，請優先檢查規則、目前檔案與 DNS 設定，而非重新填寫所有伺服器資料。連線相關流程請參閱連線問題排查。
若 Connectivity Test 有回應，但網域無法連線，可先參閱DNS 解析失敗說明；不要看到 dns-server 就隨意改成不熟悉的位址。DNS 解析與連線是不同階段，修改前請先保存原值，每次只調整一項，再重新測試。
自動連線與診斷紀錄
手動中斷後又自動連線時，請到 Settings 檢查是否已在 On Demand 設定觸發條件。初次使用建議先確認手動連線穩定，再設定自動行為；若已有 On Demand 規則，請先記下原有設定，再暫時停用觸發條件進行比對。Wi-Fi 與行動網路切換也應分開測試，避免將網路變化與自動觸發混為一談。
若需進一步分析，可查看 Settings 中的 Diagnostics。記錄問題發生時的操作步驟、網路類型與錯誤訊息，比只描述「無法使用」更有助於排查。分享紀錄前，請遮蔽伺服器位址、驗證欄位與訂閱內容。完成排查後，恢復原本需要的 Global Routing 與 On Demand 設定，再進行一次實際瀏覽測試，確認整個流程正常。
