官方手冊 · iPhone / iPad 入門
Shadowrocket 匯入與連線教學
依序完成「新增 → 選擇路由 → 連線 → 驗證 → 疑難排解」。首次使用時，先確認一台既有伺服器可以連線，再調整規則與自動連線條件。
以下截圖為 App Store 官方截圖。介面配置可能因裝置與 App 更新而有所不同；找不到入口時，請先依英文介面名稱尋找，不要只照著截圖中項目的位置操作。
步驟 01 · Add Server / Subscribe
新增伺服器或匯入既有訂閱
訂閱連結、單一分享連結與手動輸入的資訊是不同類型。先確認手上的資料屬於哪一種，再選擇相應的入口。
使用 Subscribe 匯入訂閱
開啟 Shadowrocket，進入 Home（首頁），點選右上角的新增入口或清單中的 Add Server（新增伺服器）。在 Type（類型）中選擇 Subscribe（訂閱），將向自己的服務商取得的完整訂閱連結填入 URL 欄位，然後儲存。連結的路徑與參數都必須完整保留；複製時若混入空格、換行或說明文字，用戶端便可能無法正確讀取內容。
儲存後返回 Home，等待訂閱內容載入，並確認 SERVER（伺服器群組）下方是否出現伺服器項目。只看到訂閱名稱、沒有伺服器項目，不代表匯入成功：先確認裝置目前的網路可以連線至訂閱網址，再檢查連結是否仍有效。需要更新訂閱時，使用該訂閱群組的更新功能；不要重複新增相同連結，以免產生多個難以辨識的群組。
訂閱網址可能包含存取憑證，請勿將完整網址貼到公開頁面，也不要放進本教學的範例文字中。若服務商提供的是單一伺服器的分享連結，請使用用戶端對應的匯入功能，不要直接將它當作 Subscribe 網址填入。不確定資料類型時，請先向自己的服務商確認格式。
使用 Add Server 手動填寫
如果手上已有伺服器位址、連接埠與認證資訊，請在 Add Server 中先選擇 Type，再依該類型顯示的欄位填寫。以 Shadowsocks 為例，請核對 Host（主機）、Port（連接埠）、Password（密碼）與 Method（加密方法）。其他協定會顯示不同的認證與傳輸欄位，請勿將某個類型的欄位值直接套用到另一個類型。
Host 僅填入服務商提供的主機名稱或位址，請勿自行加上網頁路徑。Port 必須與伺服器設定一致；密碼及其他認證資訊請照原文複製，並留意大小寫。若資訊還包含 TLS、傳輸方式、路徑或伺服器名稱等要求，也要一併核對；不要只填入位址與連接埠後就反覆嘗試。
已有 QR Code 時，可使用 Scan QR Code（掃描 QR Code），並依系統提示允許存取相機。Import from Cloud JSON（從雲端 JSON 匯入）適用於相應格式的資料，不是可匯入任意網頁網址的通用入口。完成任一匯入方式後，都請返回 Home 確認新項目是否出現；此時先不要開啟連線開關，下一步先確認流量的處理方式。
步驟 02 · Global Routing / Config
選擇 Global Routing
伺服器項目決定連線至哪裡，Global Routing 則決定哪些流量採用哪種處理方式。兩者都需要確認。
返回 Home，點選 Global Routing（全域路由）。入門時先了解三種基本模式：Config（設定）／Proxy（代理）／Direct（直連）。選擇後返回 Home，查看 Global Routing 右側顯示的目前模式。修改設定檔後若仍處於 Proxy 或 Direct，就不能據此判斷設定檔中的規則是否正確，因為目前模式並未依設定檔規則處理流量。
Config（設定）：依目前規則分流
選擇 Config 後，流量會依目前設定檔中的規則比對。前往 Config（設定檔）頁面，確認目前正在使用的設定檔，而不只是確認清單中有某個檔案。開啟設定檔後，在 Rule（規則）區段查看規則及其順序；截圖中的 General、Hosts、URL Rewrite 與 HTTPS Decryption 是其他設定區段，首次連線時不必逐一修改。
規則通常由上往下比對，最先符合的規則會決定流量去向。例如，以下教學片段會將指定網域後綴交由 PROXY（代理策略）處理，其餘流量則交由 DIRECT（直連策略）處理。範例網域僅用來說明寫法，不是用來判斷連線狀況的測試目標。實際設定檔也可能引用策略群組，因此不能只看最後一行就推斷所有請求的去向。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT使用 Add Rule（新增規則）時，應核對類型、比對內容、策略與插入位置，再儲存。不要為了首次連線就覆寫整份既有設定檔；若要嘗試修改，請先保留原設定檔副本。首次匯入伺服器，不代表也匯入了適合自己的分流規則；訂閱中的伺服器清單與 Config 中的設定檔應分別檢查。
Proxy（代理）與 Direct（直連）：指定流量處理方式
選擇 Proxy 時，交由用戶端處理的流量會依代理模式轉送，可用來縮小排查範圍，暫時排除複雜規則的影響。選擇 Direct 時，流量會依直連模式處理，不應預期使用所選的遠端代理伺服器。此處的「代理」也不代表裝置上所有類型的通訊都必定經過同一路徑，仍須依系統與個別連線狀況判斷。
若只是想先確認既有伺服器是否可用，可以暫時選擇 Proxy，完成後續連線與測試，再切回 Config 檢查分流。不要同時更換伺服器、規則與 DNS 設定，否則很難判斷是哪一項造成結果改變。若介面還有 Scene（場景）入口，本教學暫不說明；相關差異請參閱術語表，完整規則說明請見使用手冊。
步驟 03 · Home / SERVER
選擇伺服器，開啟連線開關
先選擇預設伺服器，再開啟頂端開關。進入項目詳細資料與選取項目是兩種不同操作。
在 Home 的 SERVER 清單中找到要使用的伺服器，點選項目左側的圓點，將它設為預設伺服器，並確認選取標記已變更。點選右側的詳細資料入口通常是編輯參數，不等同於選取伺服器。若使用的 Config 引用了獨立策略群組，還要核對群組內實際選取的項目；不能只憑 Home 上的預設圓點，就認定所有流量都會使用這台伺服器。
清單中有多台伺服器時，先選一台資料完整、狀態明確的項目進行測試。可執行延遲測試作為參考，但延遲數字只反映該測試方法下的回應，不代表網頁一定能開啟，也不代表持續傳輸速度。首次驗證前不要啟用複雜的自動選擇條件；先固定測試對象，之後更容易重現並比較結果。
確認 Global Routing 的值後，開啟 Home 頂端的連線開關。首次建立連線時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。請確認提示中的 App 名稱，選擇允許，並依裝置要求完成密碼或生物辨識認證。這是授權用戶端透過系統網路介面處理流量，不需要在系統提示中輸入伺服器密碼。
返回 Home 後，查看頂端狀態是否已從 Not Connected（未連線）變更。若開關立即關閉，先確認是否已完成系統授權，再檢查是否有其他 VPN 連線正在運作。不要反覆快速切換開關來處理授權問題；請先停止這次嘗試、讀清楚提示，再依最後一節的順序找出原因。
系統顯示 VPN 狀態或用戶端開關維持開啟，只能表示連線設定已啟動，不能單獨證明遠端伺服器可用，也不能證明某個網站符合預期規則。現在請維持伺服器與路由模式不變，進入下一步進行實際驗證。測試完成後若要中斷連線，返回 Home 關閉頂端開關，再確認連線狀態已變更。
步驟 04 · Connectivity Test / Data
確認連線狀況與規則去向
在 Home 點選 Connectivity Test（連線測試），等待結果。此功能用來檢查所選測試目標是否可連線，並不代表所有網站都能正常使用。若測試逾時，先記下目前的伺服器、Global Routing 值與使用的網路，不要立刻清除設定；這些資訊有助於區分伺服器、規則與本機網路問題。
先確認能否連線，再判斷結果是否符合預期
開啟瀏覽器，造訪一個平常會使用、且知道應如何連線的網站，然後重新載入頁面。確認本次請求確實完成，不要只看已快取的文字或圖片。若只有單一網站無法使用，再換另一個已知可連線的目標交叉測試；若僅一個目標異常，先將問題範圍限縮在該目標，不要直接判定整個連線都失效。
處於 Proxy 時，可以先確認目前伺服器的基本連線是否可用；切回 Config 後，再對照同一目標的網域與規則順序，檢查預期流量去向。網站頁面可能同時要求多個網域的資源，因此「頁面只載入一部分」不一定表示開關未生效。需要更精確判斷時，應搭配可用的連線或診斷記錄，查看實際請求採用的策略，而不只是看頁面能否開啟。
前往 Data（流量統計）查看上傳與下載數據是否隨測試變化，可作為流量經過用戶端的輔助線索。數字增加不代表流量一定經由遠端代理；直連請求與背景通訊也可能影響數據。不要將 Data 數字直接當成規則命中的證明，也不要與服務商帳戶或電信業者帳單的數字逐一對照。
每次只變更一項條件
若結果不符合預期，先維持同一台伺服器，只將 Global Routing 從 Config 暫時切換為 Proxy，再重複相同的瀏覽測試。Proxy 可用、Config 卻異常時，優先檢查目前設定檔、規則順序與策略選擇；兩者都失敗時，再檢查伺服器參數、目前網路與 DNS。完成比較後，恢復日常使用的模式，避免長期沿用排查時的暫時設定。
至此，基本匯入與首次連線流程已完成。若要了解 DOMAIN-SUFFIX、FINAL 或策略群組的含義，請前往術語表；若要進一步編排規則與設定檔，請閱讀完整使用手冊，不必在首次連線時一次修改所有選項。
步驟 05 · Settings / Diagnostics
依照失敗環節逐項排查
保留目前設定，從發生問題的步驟開始檢查。每次只檢查或修改一項，接著重新測試。
匯入失敗：先檢查輸入內容與訂閱回應
若 Home 中沒有伺服器項目，先返回 Add Server 確認 Type 是否正確，再確認輸入的是完整訂閱連結還是單一分享資訊。訂閱更新出錯時，檢查裝置目前的網路、連結是否有效，以及自己的服務商提供的使用說明。重複新增無法修復已失效的連結；請保留原項目，確認原因後再決定是否替換。
開關無法啟用：先檢查系統權限
若頂端開關無法開啟，或開啟後立即關閉，請確認首次新增 VPN 設定的授權已完成，並檢查是否有其他 VPN 連線占用目前的連線狀態。開啟系統設定，查看 Shadowrocket 的 VPN 設定與提示，再返回 App 重試。不要先刪除所有伺服器或重設整份 Config，因為開關授權失敗與伺服器清單是否完整是不同層面的問題。
已連線但無法使用：核對伺服器、路由與網路
若狀態已變更但仍無法連線，請依序檢查預設伺服器、Global Routing 與該伺服器的參數。手動新增的項目應優先核對 Type、Host、Port、認證資訊及服務商指定的傳輸要求；訂閱項目則先確認已更新且服務仍有效。若自己另有一台伺服器，可在其他條件不變時交叉測試，但不要同時修改規則與測試方法。
只有部分網域無法連線時，再檢查目前設定檔中的 DNS 與規則去向。網域解析失敗與遠端連線失敗是不同問題；不要一看到逾時就更換所有 DNS 設定。在條件允許時，可使用同一項目分別透過 Wi-Fi 與行動網路測試，確認問題是否只發生在特定網路；測試時留意流量用量，並維持相同目標與路由模式。
前往 Settings 檢查測試與診斷條件
進入 Settings（設定），先查看 Test Method（測試方法）。不同方法測試的環節不同，因此清單測試有回應、實際瀏覽卻失敗，兩者並不矛盾。比較前後結果時，應盡量使用相同方法；不要只憑單一延遲值判定伺服器所有功能正常，也不要把測試失敗直接歸因於帳戶或 App 購買問題。
接著查看 On Demand（隨選連線）。若手動中斷後連線總是再次出現，請檢查是否有隨選連線條件正在觸發。首次排查時可先暫停相關條件，透過 Home 開關手動測試，確認基本連線後再恢復。On Demand 用於依條件發起連線，無法修正錯誤的伺服器參數，也不能取代連線驗證。
需要記錄問題原因時，查看 Diagnostics（診斷）中可用的檢查項目與輸出內容。記錄錯誤類型、發生步驟、路由模式，以及是否更換過網路，比只說「無法連線」更有幫助。向自己的服務商說明問題前，請遮蔽訂閱網址中的憑證、密碼、認證識別資訊與個人網路資訊；不要公開整份設定檔或完整診斷內容。
入門時不需要逐項調整 Settings 中的 Proxy、TCP、UDP 等選項。先維持目前設定，只有確認與特定協定或網路條件相關時，再依具體說明修改。接著可閱讀常見問題分類說明，或在使用手冊中查找更完整的設定與維護步驟。恢復日常使用前，記得還原測試期間暫時修改的路由模式與隨選連線條件。
