iPhone / iPad · 初次設定
Shadowrocket 快速入門
依照「新增資料 → 選擇路由 → 連線 → 確認結果」的順序操作。先確認每個步驟的介面狀態，再繼續下一步；遇到問題時，從最近變更的項目開始檢查。
本頁介紹初次操作流程。訂閱管理、欄位說明與更新方式請參閱伺服器管理手冊。
以下截圖取自 App Store，按鈕的實際位置與文字請以目前的應用程式畫面為準。建議先完整讀完一個步驟，再對照自己的畫面操作。
步驟 01 / 準備連線資料
新增伺服器或匯入現有訂閱
先確認手邊的資料類型：如果是個別伺服器參數，請使用 Add Server；如果是由你使用的服務商提供、用來更新伺服器清單的連結，請使用 Subscribe。兩者是不同的輸入方式，不要把訂閱連結填入單一伺服器的地址欄位。開始填寫前，請保留原始資料以便逐項核對，尤其留意連接埠、驗證欄位及協定附加選項。
手動輸入時，請在伺服器清單中找到 Add Server，進入後先選擇 Type，再依照現有資料填寫地址、Port 及相關驗證資訊。不同 Type 顯示的欄位可能不同：例如某些設定需要 Password 和 Method，另一些則需要與伺服器端一致的傳輸或安全設定。截圖中的地址欄位標示為 Host；輸入時請以目前頁面上的欄位名稱及手邊資料為準。若暫時看不到某個欄位，請勿將該欄位的值填到其他欄位。
若手邊有訂閱連結，請進入 Subscribe 的新增入口，完整貼上連結，儲存後執行更新，再返回伺服器清單確認是否出現預期項目。若連結含有查詢參數，請從開頭到結尾一併複製；空格、換行或聊天工具截斷的尾端字元都可能影響讀取。訂閱更新只會讀取現有資料，無法取代服務商端的有效狀態。匯入後先確認清單中有內容，再選取自己的伺服器；不要只因「已儲存訂閱」就認定連線已設定完成。
若有 QR Code，可在 Add Server 頁面查看 Scan QR Code；若有適用的設定檔，可確認 Import from Cloud JSON 入口及檔案格式。這些入口適用於不同形式的現有資料，並非所有文字都能互通。初次操作建議只選擇符合手邊資料的一種方式，儲存並確認清單後再進行下一步。單一欄位的詳細對照與多份訂閱的管理方式，請參閱伺服器管理手冊。
步驟 02 / 決定流量處理方式
選擇 Global Routing 模式
伺服器加入清單後，先別急著反覆切換連線。返回 Home，找到 Global Routing，確認目前採用的模式。這項選擇會決定連線建立後如何處理流量，與「選取哪台伺服器」是兩回事。先決定要依設定檔分流，還是統一處理流量，之後才能有依據地確認結果。
常見的三種模式為設定（Config）、代理（Proxy）和直連（Direct）。Config 依照目前設定檔中的規則處理不同請求；Proxy 適合暫時檢查流量經所選伺服器處理時的狀況；Direct 則可用來確認直連狀態。日常依規則分流時，請先選擇 Config，並確認使用的是預定的設定檔。切換模式後，先前的測試結果可能不再適用，請重新確認。
選擇 Config 時，請前往設定相關頁面，確認規則檔案是否存在，以及規則是否依預期排列。官方截圖中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 是不同的設定區段；初次連線只需找到 Rule 的位置，不必逐項修改。Add Rule 用來新增規則，填寫前應先確認比對條件與處理方式。例如 DOMAIN-SUFFIX,example.com,PROXY 僅用於展示規則語法，其中 example.com 是範例網域，不是要照抄的目標。
先使用現有設定完成一次連線與測試，再決定是否調整規則。若一次修改多條規則，發生異常時便難以判斷原因是伺服器資訊、路由模式還是比對條件。PROXY、DIRECT 等規則關鍵字及比對順序可參閱術語表；設定檔的管理與備份方式請參閱伺服器管理手冊。確認 Global Routing 後，返回 Home 開啟連線。
步驟 03 / 建立連線
在 Home 開啟連線開關
返回 Home，先確認伺服器清單中選取的是剛才核對過的項目，再確認 Global Routing 是否仍為預期模式。Home 截圖可用來辨認頂端連線開關、SERVER 分組及 Connectivity Test 的相對位置；截圖中的 Not Connected 代表當時尚未連線，不表示你操作後也必須看到這個狀態。請以裝置上的即時狀態為準。
確認選取的項目後，開啟 Home 頂端的連線開關。初次建立連線時，系統可能會顯示新增 VPN 設定的授權提示；請閱讀系統對話框並依提示完成授權，應用程式才能向系統請求建立連線。這是系統層級的提示，並不代表訂閱匯入或伺服器參數已正確。完成授權後返回 Shadowrocket，觀察 Home 上的連線狀態是否變化，待連線程序結束後再進行測試。
如果開關很快又關閉，先不要連續快速點按。請檢查是否已選取伺服器、資料是否完整，以及目前網路是否可用，再依第五步的順序排查。若 Home 顯示已連線，這只代表目前連線狀態有所變化，不能只憑開關判斷目標存取一定符合預期。請保持伺服器選擇與 Global Routing 不變，繼續檢查連通狀況及實際存取結果，才能分辨「已連線」與「運作符合預期」。
在 iPad 上也依相同順序尋找 Home、SERVER、Global Routing 與連線開關；畫面配置可能和 iPhone 不同，不必依照截圖中的像素位置逐一尋找。初次操作的重點是記下選取的伺服器與路由模式，測試失敗時才能在相同條件下重新檢查。應用程式取得方式與初次開啟說明，請參閱iPhone 說明或iPad 說明。
步驟 04 / 區分連線狀態與實際結果
使用 Connectivity Test 確認是否生效
連線狀態穩定後，返回 Home 使用 Connectivity Test。先記下測試前的條件：使用哪台伺服器、Global Routing 選的是 Config 還是 Proxy，以及裝置當時連接哪個網路。判讀測試結果時，應一併考量這些條件，而不只記得成功或失敗。若剛修改伺服器或規則，請重新執行測試，避免將修改前的結果當成目前狀況。
連通測試完成後，再開啟原本需要存取的目標，觀察實際使用狀況。Connectivity Test 檢查的是測試項目的連通情形，無法取代所有應用程式和網站的實際使用結果。尤其在 Config 模式下，不同請求可能符合不同規則；某項測試有結果，不代表每個目標都會以相同方式處理。若某個目標未如預期運作，請記下目標、當時的 Global Routing 模式，以及是否使用自訂規則，再檢查相關 Rule，不要立刻重新填寫所有伺服器欄位。
若要縮小問題範圍，可暫時選擇 Proxy 進行比對，測試後再恢復原本的 Config。若兩種模式的結果不同，請優先檢查設定檔、規則比對與規則順序；若兩種模式都無法正常存取，則先重新檢查伺服器資料與連線狀態。Direct 可用來確認直連時的狀況，但切換至 Direct 後，不能將測試結果視為流量經所選伺服器處理的證據。每次切換模式後，都要重新測試。
排查時盡量一次只變更一個條件：例如保持伺服器和網路不變，只切換 Global Routing；或保持路由模式不變，只重新確認一個伺服器欄位。這樣才能判斷是哪項變更影響結果。規則關鍵字、測試意義與常見狀態的說明，可分別參閱術語表與常見問題。若已得到預期結果，初次設定到此即可完成，暫時不必修改其他 Settings 選項。
步驟 05 / 由輸入資料到系統逐層檢查
連線失敗時依序排查
先檢查輸入資料。手動輸入的項目請逐一比對 Type、地址、Port、驗證欄位及該 Type 所需的附加設定，並留意數字、大小寫與前後空格。訂閱則需確認連結是否完整、是否成功更新，以及更新後伺服器清單中是否確實出現項目。清單空白與清單有內容但無法連線是兩種不同問題：前者先檢查連結與更新結果，後者再檢查選取的伺服器及其參數。訂閱更新失敗的逐項檢查清單，請參閱訂閱更新排查文章。
接著檢查選取狀態。Home 的 SERVER 分組中應選取預定使用的項目；新增、儲存或更新資料，不代表已自動選取伺服器。確認 Global Routing 設為 Config、Proxy 或 Direct，並依照目前模式判讀測試結果。如果只有 Config 模式下的特定目標異常，而 Proxy 的比對測試正常，請檢查目前設定檔中的 Rule；不要將所有異常都歸因於訂閱本身。若剛修改規則，請先恢復至可確認的狀態，再一次只調整一條規則。
最後檢查系統連線狀態與 Settings。確認 Home 開關狀態及系統授權程序都已完成，再查看 Settings 中與目前排查相關的 On Demand、Diagnostics、Test Method 等項目。On Demand 會影響符合條件時的連線行為；若不確定現有規則如何生效，請先記下原設定，再進行比對測試。Diagnostics 可提供排查線索，但仍須配合 Home 狀態、實際存取結果與自己的伺服器資料一併判斷。截圖中的其他 Settings 分類並非初次連線的必要清單，不必逐一修改。
如果更換網路後結果不同，請分別記錄兩種網路下的測試結果，避免同時更換網路和修改伺服器欄位。若服務商端更新了資料，請以服務商提供的最新資訊重新核對；本網站僅說明應用程式中的填寫與檢查位置。完成排查後，請將伺服器選擇、Global Routing 模式及變更過的 Settings 項目恢復至日常使用狀態，再重新執行 Connectivity Test 並確認實際存取結果。依不同情況分類的更多步驟，請參閱常見問題。
