操作前提：已從 App Store 安裝 Shadowrocket，並備有自己的訂閱連結或伺服器資訊。本網站不提供、不販售、不推薦節點或訂閱。App 一次性買斷 ≠ 連線方案；購買 App 不會自動產生伺服器資料。
尚未安裝時，請先查看下載指南與正版確認。系統需求請以 App Store 頁面標示為準。訂閱連結與伺服器憑證屬於敏感資料，請勿放入公開截圖或公開訊息。
步驟 01 / 先將資料匯入清單
Add Server 與 Subscribe 匯入
手動參數、訂閱連結與 QR Code 是不同形式的資料，請依現有資料選擇相應的入口。
Add Server：新增單一伺服器
開啟 Shadowrocket 後進入 Home，找到 SERVER 區域與 Add Server 入口。進入 Add Server 頁面後，先確認 Type。Type 會決定接下來需要填寫哪些欄位，不能只因地址相同就沿用預設類型。若資料標示為 Shadowsocks、VMess、VLESS 或其他協定，請選擇相應的 Type，再逐項核對，不要靠反覆嘗試猜測類型。
在 Host 填入現有資料中的伺服器網域名稱或地址，在 Port 填入對應連接埠。Password、Method 等欄位是否出現及填寫方式，取決於所選協定。截圖顯示的是包含這些欄位的一種頁面狀態，並不表示每種 Type 都需要相同參數。請勿將整段訂閱連結填入 Host，也不要把網址中的路徑當成伺服器網域名稱。貼上後請檢查首尾是否有空格或換行，再儲存並返回 Home。
若資料還列有 TLS、Server Name、傳輸方式或路徑等資訊，請繼續核對相應選項。地址與連接埠正確，只能表示已填入連線目標，不能證明認證與傳輸參數都已填妥。若暫時不了解某個欄位，請保留原資料中的對應值；協定欄位的詳細說明請參閱技術參考中的協定說明。
Subscribe：匯入現有訂閱連結
若已有完整訂閱連結，請進入 Config，找到 Subscribe 入口，新增連結並儲存，再更新訂閱。不同頁面狀態下，按鈕位置可能略有不同，請以 Subscribe 這個入口名稱為準。訂閱用於讀取並管理一組伺服器項目；設定檔則可包含規則與其他設定，兩者用途不同，不要只因名稱都含有「設定」就互相取代。
更新完成後返回 Home，檢查 SERVER 區域是否出現相應項目。只看到訂閱名稱，不代表已成功讀取訂閱內容；請進一步確認群組中確實有可選擇的伺服器。若結果為空或出現更新錯誤，請先檢查連結是否完整、是否仍有效，以及目前網路能否完成讀取。此時尚未進入連線步驟，不必先修改 Global Routing 或 DNS。
Scan QR Code 與剪貼簿資料
若資料以 QR Code 提供，可使用 Scan QR Code，依系統提示允許相機存取；掃描後請核對辨識出的類型與參數，再儲存。若已有分享連結，也可使用 App 提供的剪貼簿匯入提示或入口；剪貼簿中應只有要匯入的完整內容，請勿混入說明文字。Import from Cloud JSON 適用於相應格式的資料，並非所有連結都能使用的通用匯入入口。
本步完成標準：Home 的 SERVER 區域已出現與資料相對應的項目，開啟項目後可以核對類型與地址。請先選定一個明確的目標供後續測試，暫時不要同時匯入多份來源不明的設定，以免難以判斷目前生效的是哪一份設定。
步驟 02 / 決定如何處理請求
Global Routing 模式選擇
配置(Config) / 代理(Proxy) / 直連(Direct)
完成匯入後返回 Home，點選 Global Routing，先確認目前選取的模式。SERVER 清單決定可使用哪個伺服器，Global Routing 則決定請求的處理方式。這是兩項獨立選擇：選取伺服器，不代表所有請求都會經過該伺服器；切換為直連(Direct)，也不會刪除已儲存的伺服器資料。
配置(Config)：依設定檔規則處理
日常需要區分代理與直連請求時，請選擇配置(Config)。在此之前，請進入 Config 確認使用中的設定檔；請確認已選取設定檔，而不只是將它儲存在清單中。設定檔編輯頁中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分別屬於不同設定範圍；本次請先關注 Rule，不必為完成初次連線而逐一啟用其他功能。
Rule 中的規則通常會依序檢查，請求符合哪一條，就採用該條指定的策略。DOMAIN-SUFFIX 用於比對網域後綴，FINAL 則處理前面未符合任何規則的請求。以下片段僅示範「指定網域走代理，其餘直連」的意思；example.com 是範例網域，不是伺服器地址，也不是需要實際使用的規則目標。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT若要新增自己的規則，請在設定檔編輯頁找到 Rule 與 Add Rule，依目標網域與策略填寫，並將具體規則放在 FINAL 之前。也請核對目前設定檔中的策略名稱及其指向；不能只複製一段文字，就認為已選好代理伺服器。若已有可用設定，初次測試時請優先維持原樣，連線成功後再逐項調整。
代理(Proxy)與直連(Direct)：用於比較
選擇代理(Proxy)時，請求會依此模式透過目前的代理路徑處理，適合用來暫時判斷問題是否來自 Config 中的分流規則。選擇直連(Direct)時，請求不會經過選取的代理伺服器，可用於檢查目標在目前網路下能否直接連線。直連能開啟某個網站，不代表代理伺服器正常；代理能開啟網站，也不代表 Config 中的特定規則一定正確。
本教學先維持一個明確的模式，完成下一步的連線與測試。若目標是設定規則分流，測試後請切回配置(Config)，避免將暫時使用的代理(Proxy)當成長期規則設定。若 Global Routing 仍顯示 Scene 等選項，本次不必設定，先比較這三種模式即可。
步驟 03 / 建立 App 連線
Home 開關與 VPN 設定權限
現在返回 Home，在 SERVER 清單中選擇本次要使用的伺服器，確認選取標記位於預期項目上，再檢查一次 Global Routing。訂閱中可能有多個名稱相近的項目，更新後位置也可能改變，因此請以目前的選取狀態為準，不要只憑上次使用的印象判斷。
找到頁面頂端 Not Connected 旁的開關並開啟。首次建立連線時，系統可能會要求新增 VPN 設定。此系統提示用於允許 App 建立相應的網路連線設定；確認提示所指的 App 後，依系統要求完成確認，必要時進行裝置身分驗證。若拒絕或取消，App 就無法完成此步驟；請重新觸發連線並處理權限要求，而不是返回 Add Server 重新輸入密碼。
允許後返回 Shadowrocket，查看頂端連線狀態是否有所變化。若開關立即關閉或反覆停留在未連線狀態，請先留在目前頁面記錄情況，不要快速連續切換。系統設定建立、遠端伺服器認證與目標網站連線是不同環節；開關維持開啟，表示可以繼續測試，不代表所有網站都能正常連線。
若裝置上還有其他正在使用的 VPN 設定，請先在系統設定中確認目前實際連線的項目，避免將其他連線的狀態誤認為 Shadowrocket 的結果。若裝置受管理，相關權限也可能受管理政策限制，請在裝置允許的範圍內操作，不要刪除用途不明的系統設定。
本步完成標準：已處理系統權限，Home 顯示連線狀態有所變化，且目前選取的伺服器與 Global Routing 都符合預期。接下來維持這些選擇，進行 Connectivity Test 與實際連線測試；初次連線時先不要啟用 On Demand，以免自動連線條件影響結果。
步驟 04 / 分別檢查狀態與實際連線
Connectivity Test 連線測試
在 Home 點選 Connectivity Test，等待本次測試完成。測試會依所選方式檢查相應的連線條件，結果適合用來辨識明顯異常，但不等同於各網站的實際回應速度。測試方式、測試目標與當下網路環境都會影響結果，不宜將不同條件下的數值直接排列成固定的優劣順序。
若測試逾時，請先不要立即刪除項目。原因可能是伺服器無法連線、目前網路、測試方式或測試目標。請先維持相同伺服器與模式，開啟實際需要連線的網站，觀察是否能載入；反過來說，即使測試有結果但網站無法開啟，也應繼續檢查網域解析、規則比對與目標網站本身的狀態。
透過實際請求確認分流
使用配置(Config)時，請分別選擇一個預期走代理的目標，以及一個預期直連的目標進行測試。兩者都能開啟，只能證明連線成功；若還要確認連線路徑，請配合目前設定檔中的規則及 App 內可查看的請求記錄核對，不能只憑網頁載入速度推斷採用哪項策略。若設定檔只代理少數網域，尤其要檢查 FINAL 是否仍指向預期策略。
若實際連線失敗，可暫時從配置(Config)切換至代理(Proxy)，維持相同伺服器再試一次。若代理可用但配置不可用，請優先檢查規則順序、策略指向及相關設定；若兩種模式都失敗，再檢查伺服器參數與目前網路。完成比較後，請恢復原定模式並重新測試，避免將診斷時的暫時狀態保留為最終設定。
測試時一次只變更一項條件。不要同時更換伺服器、切換網路、修改 DNS 並更新設定，否則即使恢復正常，也難以確認是哪一項發揮作用。若網站快取影響判斷，可重新載入頁面，或關閉頁面後再開啟；DNS 的系統說明請參閱技術參考中的 DNS 章節。
建議記錄三項結果：Home 是否維持連線、Connectivity Test 的結果，以及目標網站能否正常連線。這三項資訊分別對應不同環節，比只描述「連不上」更容易找出問題。
步驟 05 / 從最早發生問題的環節回查
Settings 與常見問題排查
只檢查與目前症狀相關的設定，不要以反覆重新安裝代替問題定位。
清單為空，或訂閱更新沒有結果
先回到第一步，分清「已儲存訂閱記錄」與「已讀取伺服器內容」。確認連結沒有漏掉查詢部分、沒有貼成多行，並檢查現有訂閱是否仍有效。若更新會覆蓋同一群組中的項目，請勿將手動修改當成長期保存方式；需要保留的設定應先明確記錄，再依原資料還原。尚未產生伺服器項目時，切換連線模式無法解決匯入問題。
開關無法維持連線
先確認是否已允許系統 VPN 設定權限，再檢查目前實際使用的系統連線。若權限已處理，請回到選取的伺服器，逐項核對 Type、Host、Port 與認證欄位，尤其留意協定相關選項是否完整。不要只修改 Password 而忽略 Type，也不要把訂閱存取憑證當成單一伺服器的認證資料；兩者不一定相同。
已連線，但目標網站無法開啟
先完成上一節的模式比較，再決定是否進入 Settings。若只有特定目標失敗，請檢查相應規則、解析與目標網站是否可用；若多個目標都失敗，再檢查所選伺服器與目前網路。Settings 中的 Proxy、TCP、UDP 各有特定用途，不能當成通用的修復開關。若不確定某個項目，請先保留原值，避免基本連線尚未確認就大幅修改設定。
測試異常，或需要查看 Diagnostics
進入 Settings，找到 Test Method 並確認目前的測試方式，再返回 Home 重新執行 Connectivity Test。變更測試方式後，結果代表的意義也可能不同，因此請記錄測試方式，而不只是數值。若需要進一步定位，可查看 Diagnostics 提供的資訊，留意問題發生在哪個環節；向他人描述問題前，請先遮蔽伺服器地址、訂閱連結與認證資料。
Settings 中的 On Demand 用於依條件觸發連線，無法修正錯誤的伺服器參數，也不會決定某個網域符合哪條規則。手動連線穩定後，再依自己的網路條件考慮設定。若發現連線在未手動操作時重新建立，可檢查 On Demand 的相關條件，不要只是不斷關閉 Home 開關。
完成後的保留步驟
最後返回 Home，確認目標伺服器、Global Routing 與連線狀態，再重新測試一次實際連線。保留這次確認可用的組合，之後修改規則或設定時以此為起點，每次只調整一項。訂閱內容更新後，也應重新確認選取的項目，避免因名稱變更而使用非預期的伺服器。
至此，基本流程已完整走完：現有資料已匯入 SERVER 清單、模式符合用途、系統允許連線，且實際請求已完成測試。若要進一步了解協定欄位、規則與 DNS 的運作方式，請前往技術參考；若只想重新確認操作順序，可返回本指南的匯入步驟，不必一次調整所有進階設定。
