OFFICIAL MANUAL / FIRST CONNECTION

Shadowrocket 訂閱匯入與首次連線

依序完成匯入、模式選擇、授權與驗證。先建立可重複的連線,再調整規則和自動連線設定。本篇以 iPhone 和 iPad 為主,功能名稱保留介面英文原文。

STEP 01 / IMPORT

新增伺服器或匯入既有訂閱

先確認手邊資料是訂閱網址、單一伺服器參數還是 QR Code。一次使用一種匯入方式,避免重複匯入後選錯記錄。

已有訂閱:確認 Subscribe 入口

開啟 Shadowrocket,前往 Config 頁尋找 Subscribe 相關入口。將自己的完整訂閱網址填入對應欄位,確認後匯入或更新。若目前介面在 Add Server 中提供 Subscribe 類型,則從該入口填入相同資料;介面配置可能不同,請以 Subscribe 標示及實際欄位為準,勿將訂閱網址填入單一伺服器的 Host 欄位。

複製網址時請保留完整內容,尤其是問號後的參數。聊天工具可能加入換行或前後空格,也可能截掉尾端字元,導致原本有效的網址無法辨識。網址屬於個人設定資料,請勿貼到公開頁面,也不要為了排錯隨意交給陌生人。匯入後返回 Home,在 SERVER 分組確認是否出現記錄;先核對名稱與數量,再進行下一步。

已有伺服器參數:使用 Add Server

在 Home 的 SERVER 分組點選 Add Server,先選擇 Type,再逐項填入 Host、Port 及相應的認證欄位。官方截圖示範的是含 Password、Method 的一種填寫方式;選擇其他 Type 後,欄位可能不同,截圖中的表單不適用於所有協定。Host 填入伺服器位址,Port 填入對應連接埠,並逐字核對自己的認證方式和加密參數。

若資料包含 TLS、SNI 或其他傳輸設定,請前往相應選項核對;只填入位址和連接埠並不代表設定已完成。請勿憑經驗更換 Method,也不要為了通過測試而任意變更憑證驗證設定。填寫後儲存,返回 Home 再次開啟該記錄,確認重要欄位沒有遺漏,也沒有被自動判定為其他類型。

QR Code 與剪貼簿:匯入後仍須確認

已有 QR Code 時,可使用 Scan QR Code,並依系統提示授予所需權限;QR Code 必須包含可辨識的設定內容。若已有單筆設定連結,可複製後依照 App 提供的剪貼簿辨識提示匯入。Import from Cloud JSON 適用於相應的 JSON 設定資料,不能取代任意訂閱網址。若無法判斷格式,請先確認資料說明,勿在多個入口反覆嘗試匯入同一段內容。

此階段的完成標準是「記錄已儲存且參數可供確認」,而不是「網路已可使用」。訂閱可能包含多部伺服器,也可能只提供伺服器清單而不含分流規則。下一步先決定 Global Routing 的處理方式,再從清單選擇要使用的伺服器。若訂閱更新失敗但舊記錄仍在,請先保留現況,避免刪除後失去比對依據。

Shadowrocket 官方 Add Server 頁面,顯示 Type、Host、Port、Password、Method 及 Scan QR Code 等入口
Add Server 欄位會隨 Type 改變;圖中欄位僅供確認入口,並不表示所有協定都使用相同參數。

STEP 02 / GLOBAL ROUTING

選擇 Global Routing 處理方式

伺服器決定代理請求使用哪個連線;Global Routing 則決定如何處理請求。兩者是不同設定。

返回 Home,點選 Global Routing 查看目前選項。三種模式分別是設定(Config)、代理(Proxy)和直連(Direct)。勿只看連線開關判斷路由是否正確:即使開關已開啟,Direct 或規則中的 DIRECT 仍可能讓相關請求直接連線。開始測試前,先記下目前模式,之後才能比對結果。

設定(Config):使用目前設定中的規則

選擇設定(Config)後,前往 Config 頁確認目前生效的設定檔,再檢查 Rule 區段。官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯區段,並非首次連線時都必須逐一啟用的項目。初次操作時,主要確認 Rule 內容與目前設定;勿順手修改無關項目,也不必為了驗證連線啟用 HTTPS Decryption。

規則通常由上而下比對,符合後依對應策略處理。例如 DOMAIN-SUFFIX 依網域後綴比對,DIRECT 表示直接連線,PROXY 表示交由代理策略處理,REJECT 表示拒絕。FINAL 用於前面的規則都未符合時作為後援。以下僅為語法示例,不是為你的網路準備的完整設定;了解語法即可,無須照抄並取代目前檔案。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

代理(Proxy)與直連(Direct):用於明確比對

選擇代理(Proxy),會讓目前模式處理的請求透過代理連線,適合短暫確認伺服器連線是否正常,但不代表所有網站都一定能瀏覽。選擇直連(Direct),則可用來比對直接連線情況,不能用來驗證伺服器是否有效。切換模式時只調整這一項,並以同一網頁重複測試,才能判斷問題出在規則還是代理連線。

若 Proxy 模式下可正常瀏覽,但 Config 模式下同一網頁無法開啟,請回到目前設定檢查符合的規則與策略,不要立刻重新匯入訂閱。若兩種模式都無法瀏覽,再檢查連線與伺服器參數。比對完成後,請恢復日常使用的模式。規則順序、策略與 DNS 的詳細說明,請參閱名詞解釋與故障排除手冊;本篇暫不深入複雜設定。

Shadowrocket 官方 Config 設定編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config 編輯頁可用來確認設定區段;Global Routing 的選擇入口位於 Home。

STEP 03 / CONNECT

選擇伺服器並開啟連線開關

先選取要使用的記錄,再操作頂端開關。首次連線需要完成系統 VPN 設定授權。

在 Home 的 SERVER 分組中,點選這次要使用的伺服器,並確認選取標記位於正確記錄上。訂閱中若有多個名稱相似的項目,請開啟詳細資料確認位址與類型,不要只憑名稱猜測。接著再次查看 Global Routing,確認模式符合上一步的測試計畫,再開啟 Home 頂端的連線開關。

未連線時可能會顯示 Not Connected 等狀態文字。首次開啟時,系統可能提示 Shadowrocket 要求新增 VPN 設定。這是在裝置上建立供 App 使用的系統網路設定,不是匯入訂閱,也不會替你補齊伺服器參數。確認提示來自目前操作後,選擇允許並依裝置要求完成驗證,再返回 App 查看狀態。

若先前取消授權,請先返回 Home 再嘗試開啟開關,並確認是否再次出現提示。若開關立即關閉或狀態始終未變,請前往系統設定中的 VPN 設定位置,確認是否有相關記錄。不同系統版本的設定層級可能不同,可在系統設定中搜尋 VPN;未記錄原有狀態前,請勿一次刪除多筆既有設定。

iPhone 和 iPad 的系統授權流程相同,較寬的螢幕上,清單與詳細資料的排列方式可能不同。判斷依據仍是選取的伺服器、目前的 Global Routing 及連線狀態,而不是按鈕在螢幕上的位置。若裝置受組織管理,部分網路權限可能受到管理政策限制;請先確認裝置管理要求,不要反覆修改伺服器資料來處理系統權限問題。

頂端狀態改變,只代表 App 與系統的連線流程已往前進行,無法單獨證明目標網頁可正常開啟。開關剛開啟後也不要連續點按,以免連線與中斷操作交錯。請等待狀態變更完成,保持目前伺服器與模式不變,再進行下一步,分別使用 Connectivity Test 和實際瀏覽驗證。

Shadowrocket 官方 Home 頁面,顯示 Not Connected、Global Routing、Connectivity Test、SERVER 分組及 Add Server
Home 集中顯示連線狀態、Global Routing 與伺服器選擇;先確認選項,再開啟頂端開關。

STEP 04 / VALIDATE

透過測試與實際瀏覽驗證結果

分別記錄「開關已開啟」、「測試有回應」和「網頁可瀏覽」,避免把其中一項結果當成完整結論。

先執行 Connectivity Test

保留剛才選定的伺服器與模式,在 Home 點選 Connectivity Test,觀察測試是否有回應。測試逾時可作為排查線索,但不代表所有服務請求都會失敗;測試有回應,也不表示認證、DNS、規則和目標網站都正常。測試方法與目標都會影響結果,請先記錄當下狀況,不要因此一次刪除所有記錄。

接著開啟瀏覽器,前往自己熟悉且目前需要使用的網頁。先確認頁面能否載入,再測試頁面中的一般連結是否也能開啟。只看到快取中的首頁不足以驗證新請求;可重新載入頁面,或開啟同一網站的其他頁面。不要根據只顯示 App 內快取內容的畫面,就判定網路已恢復。

若網頁可瀏覽,但 App 內某項功能仍失敗,請先保留目前設定,分別記錄發生問題的 App、操作及網路環境。單一功能也可能受到登入狀態或目標服務狀態等因素影響,不要立刻把所有異常都歸因於伺服器連線。請在相同網路下重複操作,確認問題是否穩定出現,再進一步排查。

再確認結果是否符合目前模式

在 Config 模式下成功開啟某個網頁,可能是因為符合 DIRECT 規則,因此不能只憑「網頁能開啟」就證明代理連線生效。若要驗證代理連線,請依照上一步的方式暫時切換至 Proxy,並在同一伺服器、同一網路下瀏覽同一目標。比對完成後恢復原模式,並記錄兩次結果是否不同。

若熟悉 App 中的連線記錄,可依請求網域與對應策略進一步確認;只記錄與目前問題相關的內容即可。規則中寫了 PROXY,不代表所有請求都會符合這一行;前面的規則可能已先完成比對。若遇到「測試正常但某個網域無法連線」,請先確認規則比對結果與 DNS,再檢查目標網站,不要反覆開關連線。

此步驟的完成標準是:能說明使用的伺服器、Global Routing 模式及實際瀏覽結果。若要比對 Wi-Fi 與行動網路,請先完成一組記錄,再切換網路並重複相同流程。測試期間若同時更換伺服器、網路和模式,結果將失去可比性。

STEP 05 / SETTINGS & DIAGNOSTICS

依故障階段檢查設定

先找出故障發生的階段,再調整相應項目。Settings 是用來核對設定的入口,不是需要全部修改的清單。

匯入失敗:檢查資料與入口

若沒有產生記錄,先確認資料類型與匯入入口是否相符,再檢查網址是否完整、是否有效,以及目前的一般網路狀態。能開啟訂閱網址,不一定代表回傳的是可辨識的設定內容;若顯示登入頁、錯誤訊息或空白內容,都可能無法匯入。不要將訂閱中的私人參數放入公開截圖;需要確認資料是否有效時,請聯絡既有服務的提供者。

開關無法維持開啟:檢查系統授權

返回連線步驟,確認已完成系統 VPN 設定授權,並檢查其他正在執行的 VPN 連線是否影響此次操作。若系統 VPN 設定先前已刪除,App 可能需要重新要求授權。請先記錄現有設定及提示原文,再依系統流程處理;不要將「重新安裝」列為第一個選項,重新安裝前尤其要確認既有設定可以還原。

測試逾時或網頁無法瀏覽:分別檢查測試與連線

前往 Settings 查看 Test Method,確認目前的測試方式,再於相同條件下重新測試。若某種測試方式沒有回應,仍須配合實際瀏覽結果判斷,不要把單一測試數值當成唯一依據。若多次實際瀏覽都失敗,請返回 Add Server 檢查 Type、Host、Port、認證及 TLS 相關參數,逐項比對原始資料,不要隨意修改連接埠或密碼。

若 Proxy 正常但 Config 失敗,請優先檢查目前設定中的 Rule 與 DNS。若切換網路後才出現異常,記錄 Wi-Fi 或行動網路下的差異,再檢查網路連線狀況。Settings 中的 Proxy、TCP、UDP 等設定各有用途;初次排錯時不建議全部調整。維持預設或原有設定,通常更容易找出真正影響結果的項目。

自動連線與診斷:先記錄再處理

若手動中斷後又自動連線,請查看 Settings 中 On Demand 的狀態與現有條件。On Demand 可依條件觸發連線;首次驗證時,先記錄原有設定值,必要時暫時關閉並進行手動比對,完成後依需求恢復。不要把自動觸發誤認為頂端開關故障,也不要在確認手動連線可用前先新增複雜條件。

需要更多線索時,前往 Diagnostics 查看與這次操作相關的診斷資訊。記錄故障步驟、網路類型、模式、錯誤原文及可重現的操作即可。對外提供截圖或記錄前,請遮蔽訂閱網址、密碼、認證欄位及個人網路資訊。記錄有助於縮小問題範圍,但通常無須公開完整設定。

若仍無法找出原因,請依症狀閱讀連線故障排除手冊;購買、授權與常見操作問題請參閱FAQ;不確定欄位含義時,請查閱名詞解釋。保留這次測試所用的伺服器、模式及結果,進一步排查時就不必從頭重做所有步驟。

Shadowrocket 官方 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
在 Settings 中先確認 Test Method、On Demand 與 Diagnostics;排錯時不要同時變更多項設定。