OFFICIAL MANUAL / FIRST CONNECTION
Shadowrocket 使用教學
匯入現有訂閱 → Global Routing → 連線授權 → 生效驗證 → 檢查問題
本頁介紹 iPhone 與 iPad 的首次設定。依序完成一次手動連線，再調整規則或設定 On Demand；若已完成部分設定，可直接前往相應步驟。
STEP 01 / ADD SERVER
新增伺服器或匯入訂閱
開啟 Shadowrocket 後進入 Home，找到 SERVER 群組下的 Add Server。先確認手邊資料的類型：服務商提供、用於更新伺服器清單的連結，應以訂閱方式處理；分別列出的協定、伺服器位址、連接埠及驗證參數，則應作為單一伺服器處理。兩種資料的輸入位置不同，請勿將整個訂閱連結貼到 Host。
已有訂閱連結：選擇 Subscribe
點按 Add Server，開啟 Type 類型選單，選擇 Subscribe，再將完整訂閱連結貼到 URL。為這筆訂閱填寫方便辨識的備註後儲存。連結前後不要加上空格、換行或聊天訊息中的說明文字；查詢參數通常也是連結的一部分，請勿為了縮短網址而刪除。訂閱連結可能包含存取憑證，請妥善保管，不要公開。
儲存後返回 Home，等待訂閱內容載入完成，再確認是否出現相應群組及伺服器項目。如果只看到訂閱名稱，卻沒有可選擇的伺服器，請先檢查該訂閱的更新結果。此時繼續開啟連線開關無法解決匯入問題，應先確認連結完整、訂閱仍有效，以及目前網路能否連線至該網址。如果服務商重新產生了連結，請以新的完整網址更新原有記錄。
已有伺服器資料：依 Type 填寫參數
手動新增時，先在 Type 選擇資料中明確標示的協定，再逐項填寫 Host、Port，以及該協定所需的驗證與傳輸設定。截圖展示的是其中一種伺服器表單，包含 Password、Method 等欄位；切換 Type 後欄位也會改變，截圖中的欄位並非所有協定都必須填寫的固定清單。
Host 通常填寫伺服器網域或位址，Port 填寫對應的連接埠，請勿將含有路徑的完整網址填入位址欄位。Password 與 Method 必須符合現有資料，請勿自行猜測。使用 VLESS、Trojan、WireGuard 等類型時，也應依各自的資料確認參數。只有在資料明確要求時，才調整憑證驗證、伺服器名稱及傳輸路徑等項目；請勿任意關閉驗證來掩蓋參數錯誤。
如果手邊有可辨識的 QR Code，可在 Add Server 使用 Scan QR Code，並依系統提示授予相機權限；Import from Cloud JSON 適用於相應的設定資料，並非通用的訂閱連結匯入入口。匯入後仍須返回項目詳細資料，確認 Type 與位址。若不清楚協定與訂閱的差異，可先參閱概念速查，再繼續設定路由。
STEP 02 / GLOBAL ROUTING
選擇路由模式，確認 Config
伺服器項目出現後，先不要急著連線。在 Home 點按 Global Routing，依目前需求選擇設定檔(Config)/代理(Proxy)/直連(Direct)。這裡決定如何處理請求，不會取得訂閱，也無法修正錯誤的伺服器參數。選擇後返回 Home，確認 Global Routing 顯示的結果，避免以為已切換，實際上仍維持原本的模式。
設定檔(Config)：依目前檔案中的規則處理
設定檔(Config)會依目前設定檔中的規則決定請求的路由。進入 Config，先確認目前使用的檔案，再開啟檢視相關內容。官方截圖顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段及 Add Rule 入口；初次使用不必逐項修改。請先確認 Rule 中是否有符合需求的規則，以及未命中其他規則時的處理方式。
規則會由上而下比對，通常命中第一條適用規則後，就會採用相應策略。以下片段僅用於說明結構，並非可直接取代現有設定的完整檔案。example.com 是教學用網域範例；FINAL 放在末尾，表示前面的規則皆未命中時採用 DIRECT。因此，選擇設定檔(Config)不代表所有請求都會經過已選取的伺服器。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT代理(Proxy)與直連(Direct)：指定明確的處理方向
代理(Proxy)會將通常受此路由模式控制的請求交由目前選取的代理處理，可用來判斷問題是否與 Config 中的分流規則有關。這不代表所有系統流量都一定會以相同方式轉送，仍須搭配實際請求進行驗證。直連(Direct)則會以直連方式處理，適合在相同網路環境下進行對照，但不能據此證明伺服器已可正常使用。
初次排查時，可暫時選擇代理(Proxy)進行連線測試，完成後再切回預計使用的設定檔(Config)。修改設定前先保留原始檔案，每次只改一處；請勿同時更換訂閱、修改規則並更改測試方法，否則發生問題時難以判斷原因。規則關鍵字、PROXY、DIRECT 與 REJECT 的說明請參閱概念速查，其他設定說明請見設定。
STEP 03 / HOME
選取伺服器，開啟連線開關
完成匯入與路由選擇後，返回 Home，在 SERVER 中點按要使用的伺服器，確認選取標記。訂閱群組名稱與實際伺服器項目並非同一層級；只展開群組不代表已選取其中某個項目。如果清單為空，請返回新增步驟檢查，不要反覆切換連線開關。
接著開啟 Home 頂端的連線開關。尚未連線時會顯示 Not Connected；開啟後，等待 App 與系統完成連線程序。初次使用可能會出現新增 VPN 設定的系統提示，這是系統授權 App 建立相應網路設定的步驟。請閱讀提示，確認目前操作的是 Shadowrocket，再依裝置要求完成驗證。
若先前取消了授權，請回到 Home 再次嘗試連線，並留意系統提示。如果裝置受管理或有系統限制，授權結果可能受相關政策影響，請查看裝置上的限制說明，不要試著修改伺服器密碼。若連線開關立即關閉，應先檢查授權或設定錯誤提示，再判斷伺服器是否可用。
返回 Home 後，確認頂端是否維持連線狀態，並再次確認所選伺服器及 Global Routing。這只完成了本機連線設定的檢查，尚不足以判斷目標頁面是否能正常連線。系統顯示 VPN 標記也不代表端對端連線正常，接下來仍須執行測試並實際瀏覽。
iPad 的操作順序相同：先確認項目，再選擇路由模式，最後開啟連線開關。版面或系統彈出視窗可能與截圖不同，請以裝置上的實際畫面為準。初次驗證時先維持手動連線，不必急著設定 On Demand，方便區分自動觸發與手動連線問題。
STEP 04 / CONNECTIVITY TEST
確認是否生效：測試與實際瀏覽
保持連線，在 Home 點按 Connectivity Test，等待目前的測試完成。先確認是否有回應，再參照 Settings 中的 Test Method 解讀結果。不同測試方法檢查的連線環節不同，不能只憑單一結果判斷所有協定、目標頁面或 App 都能正常使用。
接著開啟瀏覽器，造訪已知可正常開啟的頁面，確認內容是否能實際載入。如果測試有回應，但頁面無法開啟，先檢查該頁面在目前 Global Routing 下應採用哪種路徑：設定檔(Config)可能將其交由 DIRECT 處理，也可能命中 PROXY 或 REJECT。此時應查看相應的請求記錄與規則，而非直接認定所選伺服器無法使用。
進行對照時，請保持測試目標不變。可先記錄設定檔(Config)下的結果，再暫時切換到代理(Proxy)，重新造訪同一頁面；若只切換路由模式，結果就有所不同，請優先檢查 Config 的規則順序、最終策略及網域解析相關設定。完成對照後，請恢復原先預計使用的模式，避免長期保留臨時診斷設定。
也要區分「有流量」與「路由正確」。Data 中的流量變化只能表示有相應的統計活動，不能單獨證明某個網域命中了預期策略。如果 App 提供相應的連線記錄，請依目標網域、策略與時間查看；分享排查資料前，請先移除伺服器位址、訂閱連結及驗證資訊。
STEP 05 / SETTINGS & DIAGNOSTICS
常見問題，逐層檢查
遇到 Shadowrocket 無法連線時，先確認問題出在哪個環節：訂閱未匯入、開關無法維持開啟、測試失敗，還是只有特定頁面無法瀏覽。以下依資料到請求的順序逐步檢查。每完成一項，都以相同目標重新測試並記錄變化；比起反覆刪除再新增所有資料，這樣更容易找出原因。
匯入後沒有伺服器：檢查資料與取得狀況
先返回訂閱記錄，確認 Type 是否為 Subscribe、URL 是否完整。連結失效、內容格式不適用，或目前網路無法連線至訂閱網址，都可能造成更新失敗。購買 App 後不會自動出現伺服器清單；必須匯入使用者已有的有效資料。如果原始連結已變更，請向自己的服務商確認，不要從不明內容拼湊網址。
開關已開啟但測試失敗：檢查參數與測試方法
開啟相應伺服器的詳細資料，逐項比對原始資料，特別是 Type、Host、Port、驗證欄位及傳輸設定。進入 Settings 查看 Test Method，確認比較的是相同的測試方式。更改測試方法可能會讓結果不同，但更改方法本身無法修正錯誤的伺服器資料，也不能取代實際瀏覽頁面的驗證。
必要時可使用 Settings 中的 Diagnostics 協助蒐集狀況，先閱讀輸出中與連線、解析相關的資訊。請勿直接公開整段診斷內容，其中可能包含網路位址或其他私密資料。若要切換 Wi-Fi 與行動網路進行對照，請保持伺服器、路由模式及測試目標不變，觀察問題是否只在某一種網路環境下發生。
只有部分頁面無法瀏覽：檢查規則與解析
如果大部分內容都能正常瀏覽，只有少數目標失敗，請先檢查是否命中 REJECT，或被交由不符合預期的 DIRECT 處理。規則中較寬泛的比對條件若排在前面，可能導致後面的精確規則無法生效。確認 FINAL 位於規則末尾，並了解其策略。網域解析失敗與代理連線失敗是不同問題，應依請求記錄加以區分，不要盲目替換所有 DNS 設定。
手動連線正常、自動連線異常：最後檢查 On Demand
確認手動連線正常後，再進入 Settings 檢查 On Demand。確認目前網路是否符合觸發條件，並觀察自動觸發後連線開關是否如預期變化。若設定了多項條件，先簡化為容易驗證的一項，再逐步加入其他條件。若要釐清問題，可暫時停用 On Demand，重新完成手動連線與實際瀏覽測試。
Settings 也包含 Proxy、TCP、UDP 等相關設定。初次排查時不建議同時更改這些項目；確認協定需求或失敗範圍後，再檢查相應設定。TCP 可正常使用不代表 UDP App 一定正常，單一測試失敗也不代表所有服務都會失敗。請具體描述觀察結果，例如「同一伺服器在行動網路下測試失敗，但在 Wi-Fi 下有回應」，比籠統地說「完全不能用」更有助於排查。
至此，應能將問題縮小至資料、系統授權、伺服器連線、規則或網路環境中的某個環節。術語說明請參閱概念速查；若要確認購買帳號、商店地區或重新安裝後如何復原已購項目，請前往正版指南。購買與連線是兩種不同的檢查方向，不要因網路請求失敗而重複購買 App。
