官方手冊 / 快速入門
Shadowrocket 快速入門
匯入現有訂閱 → Global Routing → 連線與驗證
依序完成五個步驟。先確認輸入資料，再檢查連線結果；遇到問題時，回到相應步驟核對即可，不必重做所有設定。
- 01 新增
- 02 路由
- 03 連線
- 04 驗證
- 05 排查
步驟 01 / 輸入連線資料
Add Server 新增與匯入
可選擇匯入訂閱或手動新增，視你已有的資料類型而定。儲存後確認清單中出現項目，再進行下一步。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket 的 Home，在 SERVER 區域找到 Add Server，或使用頁面上的新增入口。進入 Add Server 後，點選 Type 並選擇 Subscribe，再將完整的訂閱連結貼到 URL 欄位。不同類型會顯示不同欄位，因此請先選擇 Type 再填寫內容，避免將訂閱網址誤填為單一伺服器的 Host。
貼上後，從頭到尾檢查一次：連結必須來自你現有的服務設定，不可漏掉查詢參數，也不要混入說明文字、空格或換行。訂閱連結可能包含用來辨識使用資格的憑證，請像保管密碼一樣妥善保存，不要貼到公開討論區或截圖中。為項目填上方便辨識的名稱，再使用頁面上的儲存功能返回 Home；如出現更新提示，請依提示取得訂閱內容。
匯入完成後，在 SERVER 確認是否出現訂閱群組與伺服器項目。群組名稱出現，不一定代表內容已成功取得；如果清單仍是空的，請先確認連結是否完整、目前網路能否連至訂閱網址，以及訂閱是否仍有效。此時先不要反覆變更 Global Routing，因為取得訂閱內容與連線模式是兩個不同環節。
已有單一伺服器資料：依 Type 填寫
如果手邊是單一伺服器的參數，請在 Add Server 的 Type 中選擇與資料相符的協定，例如 Shadowsocks、VMess、VLESS、Trojan 或 WireGuard，再填寫該類型所需欄位。官方截圖展示 Host、Port、Password、Method 等項目，但並非所有協定都會用到這些欄位。Host 填入伺服器主機名稱或 IP，Port 填入連接埠；不要將含路徑的完整網頁網址直接當作 Host。
驗證資料、加密方式與傳輸參數都必須逐項符合原始資料。涉及 TLS 的設定，伺服器名稱與憑證相關欄位也須保持一致；不要為了讓測試通過而任意降低驗證要求。若資料只提供 QR Code，可使用 Scan QR Code，辨識後再檢查 Type 與重要欄位。Import from Cloud JSON 是另一種匯入入口，並非通用訂閱連結；只有在已有相應格式的資料時才使用。
儲存後返回 Home，確認項目沒有重複，且協定與名稱清楚易辨。匯入只是將連線資料存入 App，不代表已建立連線，也不能證明伺服器可用。現在保留一個準備測試的項目，下一步先確認它應採用哪種路由模式。
步驟 02 / 確認請求處理方式
Global Routing 三種模式
配置(Config)、代理(Proxy)、直連(Direct)會決定請求的處理方式；伺服器項目與 Config 配置檔並非同一回事。
返回 Home，點選 Global Routing。先依目前的目的選擇模式，而不只是確認伺服器是否已選取。配置(Config)依目前配置檔中的規則決定請求去向；代理(Proxy)會透過所選代理伺服器處理一般請求，適合排除規則因素進行檢查；直連(Direct)則不經所選代理伺服器轉送。這些選項改變的是處理方式，不會替你補齊伺服器參數。
初次使用時，若已有確認過的配置檔，可選擇配置(Config)；若暫時只想檢查剛新增的伺服器能否正常轉送，可先用代理(Proxy)進行一次受控測試。直連(Direct)適合確認本機網路的基本連線情況，不適合用來驗證代理伺服器本身。切換後返回 Home，核對 Global Routing 旁顯示的名稱，避免以為已切換，實際上卻沒有選取。
使用 Config 前，先檢查目前配置
開啟底部的 Config，確認目前使用的配置檔，再進入內容查看 General 與 Rule。官方截圖也展示 Hosts、URL Rewrite、HTTPS Decryption 等區段；完成基本連線不需要逐一啟用這些功能。尤其是涉及憑證與內容處理的項目，不屬於本頁的首次連線流程，請先了解用途，再個別設定。
Rule 中的規則會依序比對。例如 DOMAIN-SUFFIX,example.com,PROXY 表示依網域後綴比對，並交由相應策略處理；FINAL,DIRECT 則將先前未符合規則的請求交由 DIRECT 處理。這裡的規則僅用於說明語法，不必為了跟著本教學操作而加入配置。實際連線是否經過代理，取決於目前的檔案、規則順序與策略指向。
訂閱通常用來提供伺服器項目；它不等同於包含分流規則的完整配置。若只匯入訂閱，卻未確認 Config 的內容，就不應假設所有 App 都已依預期分流。也不要同時匯入多份不熟悉的規則來「補齊」設定，否則驗證時很難判斷是哪個變更影響結果。
本步只完成兩件事：確認 Global Routing 模式，以及確認配置(Config)所依據的檔案。詳細設定等連線成功後再調整；可繼續閱讀Settings 設定詳解。若對規則命中與匯入差異有疑問，可查看FAQ。完成後返回 Home，準備建立連線。
步驟 03 / 建立系統連線
Home 選擇伺服器並連線
先選取項目，再確認 Global Routing，最後開啟頂端開關。系統授權與伺服器驗證是兩回事。
返回 Home，在 SERVER 中點選這次要使用的伺服器。如果有多個群組，先展開正確的群組，再確認選取標記對應的是目標項目。不要只憑清單位置判斷，因為訂閱更新後項目順序可能改變。接著再次確認 Global Routing：所選模式應符合上一步的測試目的。
開啟 Home 頂端的開關。尚未連線時，官方截圖中的狀態為 Not Connected。首次建立連線時，系統可能會提示新增 VPN 配置；這是授權 App 透過系統網路延伸功能處理流量，並非要求你輸入遠端伺服器密碼。請閱讀系統提示，確認目前操作來自 Shadowrocket，再依裝置要求完成身分驗證。若暫時取消授權，App 可能無法進入正常連線狀態。
確認後返回 Shadowrocket，等待頂端狀態更新。狀態切換期間不要連續開關；如果很快又回到未連線狀態，請先查看提示，不要只因開關保持開啟就認定連線成功。系統出現 VPN 標示，只能說明相關網路連線已建立，不能單獨證明所選伺服器、網域解析或分流規則都正常；實際存取情況仍須在下一步驗證。
連線後先維持穩定的測試條件
首次測試時，維持目前網路不變，暫時不要同時切換 Wi-Fi、行動網路和多台伺服器。如果裝置也設定了其他 VPN 連線，請先確認目前實際啟用的是這次要測試的連線，避免混淆不同配置的結果。網路限制、伺服器狀態與驗證參數都可能影響結果，單靠反覆重試無法判斷原因。
在 iPad 上也依 Home、SERVER、Global Routing、頂端開關的順序檢查；螢幕配置不同，不會改變操作流程。連線成功後，可以切換到要測試的 App，但先不要大量修改規則。之後若變更伺服器參數或影響連線的設定，請依介面提示重新連線，再重新驗證，避免用舊連線的結果判斷新設定。
停止使用時，可返回 Home 關閉頂端開關。若關閉後又發生自動連線，請先記錄發生時的網路狀況，之後再檢查 On Demand，不要直接刪除所有資料。現在進入驗證步驟，分別確認「開關已開啟」與「請求依預期處理」。
步驟 04 / 分層確認結果
Connectivity Test 與實際連線
測試結果、系統連線狀態、頁面存取與規則命中各自回答不同問題，請依序核對。
先返回 Home，使用 Connectivity Test 查看項目的測試結果。測試方法會影響結果的意義：偵測到伺服器連接埠，不一定表示驗證、TLS 或後續請求都能完成；某種測試失敗，也不能直接推斷所有實際連線都會失敗。不要將單一數值當成整條連線的完整結論，也不要只憑數值大小判斷伺服器是否適合目前用途。
接著開啟自己需要使用且有權存取的頁面，先檢查一個目標，等待主要內容載入，再嘗試頁面中的一般操作。如果頁面能開啟，但圖片、登入或 API 請求失敗，請記錄出錯的部分；同一頁面可能使用多個網域，在配置(Config)下也可能符合不同規則。反覆重新整理同一個快取頁面，不足以證明連線已依新設定運作。
用三項檢查判斷問題所在
- 連線是否維持：切回 Home，確認開關與連線狀態沒有中斷。如果連線已中斷，優先檢查授權、伺服器參數與網路，不要先修改 Rule。
- 所選伺服器是否有參與：如果目前使用直連(Direct)，頁面能開啟並不能證明代理伺服器可用。切換至代理(Proxy)進行一次對照測試後，再視需要恢復配置(Config)。
- 規則是否符合預期：使用配置(Config)時，搭配目前的 Rule 與相關連線記錄檢查目標請求。不要因為某個頁面成功，就推斷其他網域或所有 App 都會採用相同策略。
需要進一步判斷時，可以查看 Data 中的流量變化，或透過診斷記錄觀察請求處理情況。流量變化只是輔助線索：背景 App 可能也在連線，因此流量增加不代表剛測試的頁面一定經過目標伺服器。請一併記錄目標網域、測試時間與當時的 Global Routing，才方便重現問題。
如果代理(Proxy)測試成功，但配置(Config)下失敗，請優先檢查規則、策略與解析設定；如果兩種模式都失敗，先檢查伺服器資料與網路。驗證通過後，恢復預計長期使用的模式，並簡短複測一次。較複雜的分流問題可查看連線與分流 FAQ；初次使用不必同時處理所有進階功能。
步驟 05 / 逐項排查，減少變更
Settings 與常見問題
每次只變更一項，保留原設定並重新測試。先找出失敗階段，再處理相應設定。
匯入失敗或伺服器清單為空
返回步驟 01，重新確認訂閱連結是否完整、是否選擇 Subscribe，以及目前網路能否取得訂閱內容。連結過期、導向登入頁面或回傳格式不適用，都可能導致清單無法建立。不要把訂閱網址當成一般伺服器的 Host。手動新增時，請對照原始資料檢查 Type、Host、Port、驗證與傳輸欄位，尤其留意貼上內容時是否多了空格或漏掉字元。
如需向原始資料的提供者詢問，請只描述失敗階段與提示內容，必要時附上已遮蔽欄位的截圖。不要將完整訂閱 URL、密碼或私鑰貼到公開位置。刪除並重新建立項目前，先確認仍能取得原始資料，避免遺失唯一保存的連線資訊。
測試失敗或連線後無法存取
先確認裝置本身具備基本網路連線，再檢查目標項目。開啟 Settings 查看 Test Method，了解目前 Connectivity Test 採用的檢查方式；更換測試方式只會改變測試依據，不會修正錯誤參數。如果換用其他網路後結果不同，請記錄網路差異，不要同時修改伺服器設定，否則無法判斷問題出在哪一端。
如果系統連線維持正常，但實際頁面無法存取，請依步驟 04 比較代理(Proxy)與配置(Config)。前者成功、後者失敗時，檢查目前 Config 的規則指向、DNS 與相關設定。若遇到憑證或伺服器名稱相關錯誤，請回頭核對資料中的 TLS 參數，不要把略過驗證當成一般修復方式。TCP、UDP 或特定傳輸方式的細節，等確認問題範圍後再逐項處理。
自動連線異常與診斷記錄
在 Settings 中找到 On Demand，檢查是否設定依網路條件觸發連線。這與手動開啟 Home 開關是不同的控制入口；若要排查意外重新連線，可先記下原設定，再暫時停用相關的自動觸發條件進行對照。Today Widget 是便利入口，不能取代在 Home 確認狀態。
需要更多線索時，可查看 Diagnostics 與可用的記錄，重點保留錯誤類型、發生時的模式與網路狀況。記錄可能包含網域、位址與連線識別資訊，分享前請遮蔽敏感內容；不要為了收集資訊而長期保留不必要的詳細記錄。也不要同時修改 Proxy、TCP、UDP 等多項設定，它們不是通用的「修復連線」開關。
完成一項修改後，返回 Home，視需要重新連線，並以相同目標再次驗證。如果仍然失敗，請將問題歸類為「匯入」、「建立連線」、「伺服器存取」或「規則處理」，再到FAQ查看相應說明。若想了解 DNS、On Demand、測試方式與記錄設定，請繼續閱讀Settings 設定詳解。確認匯入、模式、連線與實際存取四個環節後，本頁的首次入門流程即告完成。
