Shadowrocket 快速入門
以 iPhone / iPad 介面為例，依序完成匯入既有設定、選擇 Global Routing、連線與驗證。首次操作先確認連線正常，再調整規則與自動連線條件。
閱讀順序：先完成第 1～4 步；遇到錯誤時，記下發生在哪一步，再跳至第 5 步。截圖用於辨識介面，實際欄位會依所選 Type 與 App 介面而異。
Add Server：新增與匯入
訂閱連結與單一伺服器資料是兩種輸入方式，請依手邊資料選擇。
已有訂閱連結：使用 Subscribe
開啟 Shadowrocket 的 Home，找到 Add Server；也可以透過頁面上的新增入口進入。開啟後先點選 Type，選擇 Subscribe，再將自己的完整訂閱連結貼到對應的 URL 欄位。此時應選擇訂閱類型，不要把整條連結填入單一伺服器的 Host。備註可填寫方便辨識的名稱，檢查完畢後儲存。
儲存後等待訂閱內容載入完成，再返回 Home 查看 SERVER。一次訂閱可能產生多個伺服器項目，請先展開相應群組，確認清單中已出現項目，再選擇其中一個用於連線。如果只看到群組名稱而沒有伺服器，先確認是否尚未載入完成或連結已失效，不要直接開啟連線開關。更新訂閱會重新取得遠端清單；本機手動修改產生的項目，之後更新時可能會被覆蓋。
已有伺服器參數：依 Type 逐項填寫
在 Add Server 中選擇資料指定的 Type，然後逐項對照 Host、Port、Password，以及目前協定顯示的其他欄位。Host 填入伺服器位址，不要附加網頁路徑；Port 使用資料提供的連接埠，不要根據協定名稱猜測。Shadowsocks 的 Method 必須與伺服器一致；其他協定若有 SNI、傳輸方式或驗證欄位，也請依原始資料填寫，不要混用不同協定的參數。
資料以 QR Code 提供時，可點選 Scan QR Code，依系統提示授予相機權限後掃描。Import from Cloud JSON 適用於相應格式的資料，不是所有訂閱連結都能使用的通用匯入入口。匯入後仍須開啟項目檢查 Type、位址與連接埠。伺服器密碼、完整訂閱連結與 QR Code 都可能包含存取憑證，請勿發布在公開頁面或截圖中。
完成此階段的判斷標準是：SERVER 中出現可辨識的項目，且已選取一台伺服器。訂閱儲存成功只代表資料已加入，不代表伺服器可以連線。下一步先確認 Global Routing，再開始連線，避免以錯誤模式判斷伺服器是否可用。
Global Routing：選擇模式
伺服器決定連線目標；Global Routing 決定請求如何使用這條連線。
返回 Home，點選 Global Routing。首次使用時先分清三種模式：設定(Config)依目前啟用的設定檔決定每個請求的策略；代理(Proxy)用於透過代理路徑進行連線測試；直連(Direct)以直連方式處理流量。三者改變的是路由行為，不會自動修正伺服器密碼、訂閱效期或協定參數。
日常需要規則分流時，選擇設定(Config)，再開啟 Config 檢查目前啟用的檔案。訂閱中有伺服器，不代表已經有符合自身用途的規則設定；Subscribe 管理連線資料，Config 管理設定檔，兩者不能互相取代。切換前先確認檔案名稱與內容；已有可用檔案時，不要為了照著教學操作而直接覆蓋。
進入設定編輯頁後，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。目前只需留意 Rule 的規則順序與最後的處理策略，不需要為了首次連線啟用 HTTPS Decryption，也不要同時修改所有區段。規則由上而下比對，命中第一條後便採用相應策略；FINAL 應放在末尾，處理前面都未命中的請求。
以下是規則語法範例，不是伺服器資訊，也不是可直接取代目前檔案的完整設定。範例表示 example.com 及其子網域走 PROXY，指定的位址範圍走 DIRECT，其他請求交由最後一行處理。範例網域僅用於說明寫法；若要驗證實際請求，必須以自己實際造訪的目標與現有設定為準。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY若只想區分「伺服器連線失敗」與「規則未命中」，可暫時切換至代理(Proxy)，對同一目標進行對照測試，完成後返回設定(Config)。不要把這種暫時測試當作日常設定正確的證明。規則類型、比對範圍與設定檔結構，請繼續參閱規則參考；本頁僅說明首次連線所需的判斷方式。
Home：開啟連線開關
先確認伺服器與模式，再允許系統新增 VPN 設定。
返回 Home，確認 SERVER 中選取的伺服器，以及 Global Routing 顯示的模式。若清單中有多個同名項目，先開啟項目確認位址與群組，避免實際使用的不是剛才檢查的資料。首次連線建議保持目前的 Wi-Fi 或行動網路穩定，暫時不要設定自動切換條件，方便觀察每一步的結果。
點選頂端 Not Connected 旁的開關。首次使用時，系統會要求新增 VPN 設定；確認是由本次 Shadowrocket 操作觸發後再允許，並依裝置提示完成密碼或生物辨識驗證。此處授權的是系統建立 VPN 連線的功能，不會登入或變更已有訂閱。若先前取消過授權，可再次操作開關，觀察系統提示是否重新出現。
返回 App 後，觀察頂端狀態是否從 Not Connected 變為已連線，並確認開關是否保持開啟。系統狀態列或控制中心也可能顯示 VPN 狀態，但這只能表示系統連線狀態，不能單獨證明目標網頁已依預期策略存取。若開關立即關閉，不要快速重複點選；先記下提示文字，再依第 5 步檢查授權與設定。
若已有其他 VPN 連線，先在系統設定確認目前由哪個設定接管，避免把其他連線狀態當成 Shadowrocket 的結果。若裝置由組織管理，VPN 設定可能受到管理策略限制，請依裝置管理要求處理，不要反覆刪除系統設定。連線保持開啟後繼續下一步，以實際請求進行驗證，此時不要同時修改多個設定。
Connectivity Test：驗證是否生效
分開檢查伺服器測試、實際連線與規則，避免只看單一狀態就下結論。
先測試伺服器，再造訪實際目標
在 Home 使用 Connectivity Test，觀察所選伺服器是否能完成目前的測試。不同 Test Method 檢查的對象與方式不同，因此有測試結果不代表所有 App 都能正常存取；測試失敗也需要配合測試方式分析。此處先記錄成功、逾時或錯誤提示，不要只用某個數字判斷整條連線的品質。
接著用瀏覽器開啟自己實際需要造訪的頁面，確認正文、圖片或實際功能是否能載入。優先測試新的頁面請求，避免把瀏覽器快取誤認為連線已恢復。如果只有某個 App 出現問題，再用瀏覽器對照同一項服務；如果所有目標都失敗，先檢查伺服器資料、授權與目前網路，不要立刻新增更多規則。
再核對 Config 中的策略
使用設定(Config)時，頁面能開啟不代表命中了預期規則。可前往 Data 查看目前介面提供的連線記錄，搭配目標網域、時間與可用的策略資訊進行核對。記錄中沒有顯示的細節不要自行推測。若需要記錄，先開始觀察，再送出一次新的請求，避免將先前快取的連線與這次操作混淆。
若代理(Proxy)可以存取，而設定(Config)無法存取，優先檢查 Rule 是否提早命中 DIRECT、目前是否確實啟用該設定，以及 FINAL 的位置。若兩種模式都失敗，再檢查伺服器與網路條件。完成對照後，恢復預期模式並再次造訪同一個目標；恢復後的結果也正常，才算完成本次驗證。
Settings：依問題逐項排查
每次只修改一項，用同一個目標重新測試，並保留修改前的設定。
沒有項目，或連線開關無法保持開啟
匯入後 SERVER 是空的，先返回 Subscribe 檢查完整連結，確認複製時沒有帶入空格、換行或說明文字。瀏覽器能開啟某個連結，不代表它會回傳可辨識的訂閱內容；若回傳的是登入頁或提示頁，請向原始資料提供者確認。不要將同一連結分別填入多個 Type 反覆嘗試，也不要公開連結請陌生人代為測試。
開關無法保持開啟時，先閱讀系統提示，檢查 VPN 設定是否允許新增，以及目前是否由其他連線接管。若能開啟但立即無法存取，再核對伺服器 Type、Host、Port 與驗證欄位。若 Host 使用網域名稱，也應檢查目前網路能否正常解析。缺少協定參數時需要補齊原始資料，修改測試方式無法補上密碼或傳輸設定。
測試失敗，或只有部分目標失敗
前往 Settings 查看 Test Method，確認目前使用哪種測試方式；若更改了設定，應在相同網路下重新執行 Connectivity Test，不要直接比較兩種測試方法的結果。可分別使用自己的 Wi-Fi 與行動網路重新測試，判斷是否與目前的網路有關。切換網路僅用於釐清問題，不保證所有伺服器在各種網路下都可使用。
只有部分目標失敗時，依第 4 步以 Proxy 與 Config 進行對照，再檢查比對順序與網域解析相關設定。HTTPS 頁面出現憑證提示時，不要直接忽略系統警告，也不要為了完成首次連線而隨意啟用 HTTPS Decryption。先還原不必要的變更，確認裝置時間、目標服務狀態與原設定用途，再繼續排查。
自動連線與 Diagnostics
若連線會自動恢復，或網路切換後行為有所變化，請前往 Settings 檢查 On Demand。此功能會依條件觸發連線，可能使手動中斷後的觀察結果與預期不同。基本連線尚未穩定前，先記錄目前條件，確認用途後暫時關閉相關自動連線條件進行測試；恢復時也要逐項驗證，避免同時修改 Wi-Fi 與 Cellular 條件。
需要進一步判斷時，使用 Settings 中的 Diagnostics，並記錄重現時間、網路類型、目前模式與錯誤原文。分享診斷資訊前，請檢查其中的伺服器位址、訂閱連結、密碼與其他驗證資訊，必要時遮蔽敏感部分。詳細規則寫法與設定優先順序請參閱規則與設定參考；重新操作時可直接返回新增與匯入，依相同順序重新測試。
