官方手冊 · 首次連線
Shadowrocket 使用教學匯入訂閱與確認連線
先匯入現有資訊，再選擇 Global Routing，最後確認實際請求。以下步驟適用於 iPhone 與 iPad；首次操作請依序閱讀，遇到問題時再跳至相應階段。
- 匯入現有資訊
- 選擇連線方式
- 確認實際請求
STEP 01 / IMPORT
Add Server 與 匯入 Subscribe
開啟 Shadowrocket 後，先停留在 Home，暫時不要開啟頂端的連線開關。備妥向服務商取得的原始資訊，再依內容選擇匯入方式：會傳回伺服器清單的訂閱連結，請使用 Subscribe；明確列出協定、位址與驗證參數的資訊，則選擇相應的伺服器 Type。兩種方式需要填入的內容不同，將訂閱連結填入 Host 通常無法建立連線。
已有訂閱連結
在 Home 點選 Add Server，進入新增頁面後開啟 Type，選擇 Subscribe。在該類型的 URL 欄位貼上完整訂閱連結，再依頁面指示儲存，返回 Home 等待內容載入。如果輸入欄已有文字，請先清除再貼上，避免兩段網址連在一起。連結可能包含帳號憑證，複製時請保留完整參數，並檢查開頭與結尾是否多了空格、換行或聊天文字。
返回 Home，查看 SERVER 中是否出現訂閱傳回的項目。清單已有項目時，先選取要使用的伺服器，不必立即重複更新訂閱。儲存後仍是空白，請先確認連結是否有效、訂閱是否允許讀取，以及目前網路能否連上訂閱網址。訂閱是否有效，請向服務商確認；只儲存訂閱名稱，不代表伺服器已成功匯入。
已有單一伺服器資訊
再次進入 Add Server，依服務商提供的協定選擇 Type，再填寫 Host 與 Port。驗證欄位會因協定而異：例如 Shadowsocks 需確認 Password 與 Method；其他協定則應依要求確認相應參數，不可混用不同協定的欄位。官方截圖展示其中一種填寫畫面，各 Type 的欄位不一定相同。Host 通常填寫伺服器網域或 IP，請勿自行加上網頁路徑。
若已有 QR Code，可使用 Scan QR Code 匯入，再逐項確認；Import from Cloud JSON 是另一種輸入方式，只有在資訊來源明確提供相應內容時才使用。儲存後返回 Home，確認選取的是剛匯入的項目。至此只是將連線資訊加入用戶端，接下來還要選擇請求的路由方式。
STEP 02 / ROUTING
選擇 Global Routing 模式
匯入完成後返回 Home，點選 Global Routing 查看目前的選擇。三種模式分別為設定 (Config)、代理 (Proxy) 與直連 (Direct)。這些模式決定請求如何選擇連線路徑，並非三種伺服器協定；修改模式也無法修正錯誤密碼、失效訂閱或無法連線的伺服器位址。
| 模式 | 操作前需了解的意義 |
|---|---|
| 設定 (Config) | 依目前啟用的設定與規則選擇策略，適合已有明確分流需求的情況。 |
| 代理 (Proxy) | 主要透過代理路徑處理，可用來確認所選伺服器的實際連線情況；仍須一併考量系統與設定中的特殊處理。 |
| 直連 (Direct) | 使用直接連線路徑，可用來確認目前網路的瀏覽基準，但不能用來驗證代理伺服器是否正常。 |
若有可信來源提供的設定檔，請進入 Config 頁面，先確認準備啟用的設定檔，再檢查其中的 Rule 與策略安排。訂閱與設定檔用途不同：訂閱主要提供伺服器資訊，設定檔則說明如何處理請求。匯入 Subscribe 後，不代表已自動備妥符合需求的分流規則。
官方截圖展示 Config 編輯頁中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule。首次連線不必逐一修改每個區段，也不需要啟用 HTTPS Decryption。請先保留自己理解的設定，尤其不要為了「連上」而同時調整多項無關設定。若只想確認伺服器能否正常運作，可暫時使用代理 (Proxy) 檢查，再切回設定 (Config) 查看分流差異。
在 Rule 中，請求通常由上而下比對，命中第一條規則後便採用相應策略；FINAL 用於處理未命中前面規則的請求。以下片段會將範例網域交給 PROXY，其餘請求則交給 DIRECT。這段內容僅用於說明比對方式，並非建議用來覆蓋現有設定的完整檔案，也不保證適合所有情境。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT若設定引用了策略組，還需確認組內選擇指向有效伺服器。規則命中 PROXY，不代表伺服器本身可用。規則優先順序、DNS 與各區段語法，請參閱設定詳解；本教學先使用清楚且可重現的模式，再進入連線步驟。
STEP 03 / CONNECT
在 Home 開啟連線開關
確認已匯入項目並選好 Global Routing 後，返回 Home。在 SERVER 中選取本次準備使用的伺服器，再開啟頂端的連線開關。官方截圖中的 Not Connected 表示截圖當時尚未連線，並非伺服器名稱。操作時請留意頂端連線狀態與清單中目前選取的項目，避免匯入新資訊後仍使用原先選取的伺服器。
首次建立連線時，系統可能會提示確認新增 VPN 設定。這是授權用戶端透過系統網路延伸功能處理流量的步驟，並非要求重新購買 App。請閱讀提示中的 App 資訊，依系統要求確認並完成裝置身分驗證，再返回 Shadowrocket 查看狀態。若先前已完成授權，之後連線不一定會再次出現相同提示。
若取消授權，連線開關可能會回到關閉狀態。此時請重新嘗試連線，並依提示完成確認，不要藉由修改伺服器密碼來處理授權問題。若裝置由組織管理，系統限制也可能影響新增 VPN 設定，請依裝置管理規定處理。系統設定中的 VPN 設定與 App 內的伺服器項目屬於不同層次，刪除前者無法取代修正後者。
Home 顯示已建立連線後，先保持目前的伺服器與模式不變，再進行下一步測試。連線狀態主要表示本機處理請求的通道已啟動，不代表所有遠端請求都成功，也不表示設定中的每條規則都符合預期。伺服器驗證、DNS 解析與目標網站回應，都可能在後續瀏覽時發生問題。
結束使用時，可返回 Home 關閉頂端開關。若關閉後又自動連線，請先查看 Settings 中是否設定了 On Demand，不要反覆切換開關。排除問題時請保持手動操作流程清楚，確認基本連線正常後，再依需求設定自動連線條件。
STEP 04 / VERIFY
使用 Connectivity Test 確認結果
保持剛才選取的伺服器，在 Home 使用 Connectivity Test，並等候測試完成。請參考 Settings 中的 Test Method 解讀結果：不同方法檢查的環節不同，有些只反映特定網路探測是否收到回應，不能將單一回應時間直接視為所有網站的實際連線速度。測試失敗也應搭配實際瀏覽結果判斷，不要立刻認定伺服器所有功能都已失效。
接著開啟瀏覽器，前往平時熟悉且目前應能正常回應的網站。盡量送出明確的新請求，必要時重新載入頁面，避免只看到瀏覽器快取的內容。先觀察頁面是否能開啟，再留意是否持續載入失敗、只有部分資源未顯示，或首次瀏覽特別緩慢。記下具體狀況，比只記錄「能用」或「不能用」更有助於找出問題。
若目前使用設定 (Config)，還要分別確認一個預期走 DIRECT 的請求，以及一個預期走代理的請求。網站能開啟，可能只是剛好命中 DIRECT，不能因此認定代理路徑正常；反之，代理 (Proxy) 下可瀏覽、設定 (Config) 下失敗，通常值得進一步檢查規則與策略組。比對時只切換 Global Routing，保持伺服器與測試目標一致，完成後再切回原本要使用的模式。
若要了解流量變化，可查看 Data；統計數據只適合輔助確認是否產生流量，無法最終證明某條規則正確。一次測試也不能代表所有目標、時段或協定都正常。完成基本確認的標準是：連線開關狀態穩定、預期目標可實際瀏覽，而且目前模式符合預期路徑。若其中任一項不符，請依下方失敗階段逐步排查。
STEP 05 / DIAGNOSE
常見問題與 Settings 檢查
排查時先找出流程停在哪一步，再修改相應設定。不要同時重建訂閱、切換協定、更換 DNS 和重寫規則；即使問題因此消失，也無法判斷是哪項調整有效。建議先保留必要的設定記錄，使用固定的測試目標，每次修改後重複相同的確認流程。
未能成功匯入項目
若 Home 中沒有預期的伺服器，請返回 Add Server 檢查 Type 與輸入內容。Subscribe 使用的是訂閱網址，不是服務商網站的登入網址；連結中的完整參數也不可任意刪除。若讀取結果為空白、顯示驗證失敗或內容無法解析，請向服務商確認連結狀態與回傳格式。此時還不用檢查連線開關，因為可用的伺服器資訊尚未備妥。
有項目，但測試或驗證失敗
手動新增的資訊應逐項確認 Host、Port、Password，以及相應協定所需的 Method、TLS 或其他選項。欄位內容應以服務商提供的資訊為準，不要憑經驗猜測。裝置日期與時間不正確，也可能影響依賴憑證有效時間的連線。涉及 TLS 時，請確認伺服器名稱與憑證資訊，不要將關閉憑證驗證當成通用解決方法。
前往 Settings 查看 Test Method，確認測試方式符合要判斷的問題。若某種探測失敗但實際瀏覽正常，先記下這項差異，不要只為取得測試數據就反覆修改連線參數。反過來說，測試有回應但頁面無法開啟，也應繼續檢查 DNS、路由與目標回應，不能就此結束排查。
開關無法保持開啟，或會自動重新連線
若開關一開就立即關閉，請優先檢查系統 VPN 授權是否完成、裝置是否受到管理限制，以及 App 顯示的錯誤訊息。若手動關閉後又重新連線，請檢查 Settings 中的 On Demand 條件。排查期間可暫時關閉已啟用的自動連線條件，再手動連線一次；測試完成後依原本需求恢復設定，勿將自動連線行為與伺服器驗證問題混為一談。
已連線，但部分請求失敗
先比較代理 (Proxy) 與設定 (Config) 的結果。若差異明顯，返回 Config 檢查命中的規則、策略組選擇與 FINAL 後援規則。若網域無法解析，但直接連線位址有回應，則需進一步確認 DNS；不過，單憑某個錯誤頁面無法確定問題一定出在 DNS。TCP 與 UDP 也可能受不同環節影響，請依目標 App 與服務商提供的支援資訊判斷，避免在 Settings 中漫無目的地逐項切換。
若需要更多線索，可在 Settings 找到 Diagnostics，針對剛才發生的錯誤收集診斷資訊。分享診斷資料前請先檢查內容，遮蔽訂閱網址、驗證參數及可識別個人使用情況的資訊，只保留排查所需部分。複雜規則、DNS 與設定區段的原理，請參閱設定詳解；若要重新走過最精簡的操作流程，可回到本教學的匯入步驟，逐步確認，而非一次重設所有設定。
