官方手冊 · 首次連線流程

Shadowrocket 使用教學

依序完成「新增 → 模式 → 連線 → 測試 → 排錯」。先用一筆既有伺服器資料確認能否實際存取,再處理規則細節。

以下以 App 內的英文介面名稱指引操作。官方截圖可協助辨認頁面;實際畫面會因裝置與 App 介面而異,請以目前 App 顯示的項目為準。完整設定說明請參閱完整手冊。

Add Server:新增伺服器或匯入訂閱

先確認取得的是訂閱連結,還是單筆伺服器參數。訂閱連結通常用來取得一組伺服器項目;單筆參數則需要逐一填入連線欄位。兩種方式擇一即可,不必重複匯入同一份資料。操作前請保留原始資料;複製時留意不要一併帶入說明文字、前後空格或換行。

已有訂閱連結:選擇 Subscribe

在 Home 找到 Add Server,也可以從新增入口進入。開啟後點選 Type,選擇 Subscribe,再將完整訂閱連結貼到該類型的 URL 欄位。名稱或備註僅供辨識,填入方便自己區分的名稱即可;它不能取代訂閱連結,也不會影響連結是否有效。

確認連結完整後儲存,返回 Home 並等待內容載入。成功時應會看到訂閱群組及其中的伺服器項目,而不只是群組名稱。若群組是空的或出現載入失敗訊息,請先確認連結、目前網路和服務狀態,不要立刻修改 Global Routing。尚未取得訂閱內容時,切換連線模式也無法補上伺服器資料。

已有單筆參數:依 Type 填寫

同樣進入 Add Server,在 Type 中選擇服務商明確提供的協定類型,再逐項輸入 Host、Port 和相應的認證參數。官方截圖示範其中一種類型的欄位,包括 Password 和 Method;不同類型顯示的欄位各異,請勿照著截圖為所有協定填入同一組參數。

Host 是伺服器位址,Port 是連接埠;密碼、加密方式及其他協定參數都應與原始資料一致。不要將訂閱 URL 填入 Host,也不要因為某個選項看起來較常見就自行更換。如果取得的是可辨識的 QR Code,可以使用 Scan QR Code;掃描後仍須確認類型與位址再儲存。

儲存並返回 Home 後,請在 SERVER 清單中確認剛新增的項目確實出現。此時只完成資料輸入,尚未確認伺服器能否連線。先選定一筆準備測試的項目,再設定路由模式;訂閱與設定檔的差異請參閱術語表。

Shadowrocket 官方 Add Server 頁面,顯示 Type、Host、Port、Password、Method 與掃描 QR Code 匯入入口
App Store 官方截圖:Add Server。先選擇 Type,再確認該類型所需欄位;Subscribe 的欄位請以實際選取後的頁面為準。

Global Routing:選擇設定檔、代理或直連

Global Routing 決定流量的處理方式,不會補齊伺服器參數。返回 Home 並開啟 Global Routing。本教學先透過設定檔(Config)、代理(Proxy)和直連(Direct)三種模式建立判斷方法;選擇前,先確認這次要測試伺服器還是規則分流。

設定檔(Config):依目前設定檔處理

選擇設定檔(Config)後,流量會依目前設定檔中的規則決定處理方式。請前往 Config 確認實際啟用的設定檔,而不只是確認清單中有某個檔案。匯入訂閱不代表已設定好分流規則:訂閱主要提供伺服器資料,設定檔則定義比對方式與處理策略,兩者用途不同。

官方截圖中的設定檔編輯頁包含 General、Rule、Hosts、URL Rewrite 和 HTTPS Decryption 等區段。初次使用只要先了解 Rule 中的目標與策略,不必逐一修改其他區段。規則通常依序比對,較前面的規則可能先決定結果;更完整的語法與設定檔維護方式請參閱完整手冊。

代理(Proxy):用來測試所選伺服器

選擇代理(Proxy)時,可先針對目前選取的伺服器檢查連線與存取,不把分流規則同時當成主要變因。這適合初步排查,但不保證所有目標都能連線,也不能取代正確的伺服器參數。若 Proxy 可以存取、Config 卻不如預期,下一步應優先檢查設定檔和規則命中情況,而不是一再匯入同一筆伺服器資料。

直連(Direct):不以代理出口作為測試目標

選擇直連(Direct)時,流量會以直連方式處理。因此,即使網頁能開啟,也不能據此判定所選代理伺服器已生效。完成基本連線測試後,若要使用日常規則分流,請返回設定檔(Config),確認目前使用的檔案,再測試特定目標。

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

以上僅以保留的示例網域說明規則結構:PROXY、DIRECT 是策略名稱,FINAL 用來處理先前未命中的流量。這不是要你直接覆寫目前的設定檔。現在先確認模式符合使用目的,再繼續選取伺服器並連線。

Shadowrocket 官方 Config 設定檔編輯頁面,包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
App Store 官方截圖:Config 設定檔編輯頁。請在 Home 選擇 Global Routing;Config 中的規則則決定設定檔(Config)模式下的處理方式。

Home:選取伺服器並開啟連線

先選取伺服器,再開啟頂端開關。在 Home 的 SERVER 群組中,點選這次要使用的伺服器項目,確認左側出現選取圓點。開啟項目的編輯畫面不等於選取該項目;如果進入參數頁面,儲存或返回後仍須確認清單中的選取標記。

確認頁面上的 Global Routing 與上一步的選擇一致,再開啟頂端的連線開關。首次連線時,系統可能會要求允許新增 VPN 設定;這是 App 建立系統網路通道所需的授權步驟。請閱讀彈出視窗內容,確認操作對象是 Shadowrocket,再依系統提示允許並完成裝置身分驗證。

若取消系統授權,這次連線就無法完整建立。請返回 App 再次發起連線,並依系統提示完成授權;不要因此去修改伺服器密碼。裝置受管理、系統設定受到限制,或已有其他 VPN 設定正在連線,也可能影響授權或連線;若遇到限制,請先確認裝置允許使用的設定範圍。

授權後返回 Home,查看頂端狀態是否從 Not Connected 變為已連線,以及開關是否維持開啟。若開關立刻回到關閉,先記下是否出現錯誤訊息,以及問題發生在系統授權之前還是之後。兩種情況的排查方向不同,後續步驟會分別說明。

App 顯示已建立連線,只能表示系統通道已啟動,不能據此判定伺服器認證、遠端存取和規則選擇都正確。切換伺服器或變更模式後,也應重新進行下一步測試。初次操作時盡量一次只修改一個項目,並保留可正常運作的狀態;避免同時更換伺服器、模式和設定檔,否則不易找出原因。

Shadowrocket 官方 Home 頁面,頂端顯示 Not Connected 開關、Global Routing 和 Connectivity Test,下方為 SERVER 與 Add Server
App Store 官方截圖:Home。截圖呈現未連線狀態;實際操作時,請先在 SERVER 中選取項目,再開啟頂端開關。

Connectivity Test:測試連線與實際存取

測試結果應搭配實際存取情況一起判斷。保持連線開啟,在 Home 點選 Connectivity Test,等待本次測試結果。此功能用來判斷目前條件下能否連線至測試目標;測試成功不代表所有網站、協定或規則都已通過驗證,測試失敗也不能單憑一次結果斷定整台伺服器完全無法使用。

接著開啟瀏覽器,前往一個你確實需要測試、且已知應可存取的目標。不要只查看已載入的頁面,請重新載入並觀察新的請求。記下測試目標、目前選取的伺服器和 Global Routing;之後比較時保持目標一致,結果才有參考價值。

使用設定檔(Config)時,還須確認目標是否如預期命中規則:預期走 PROXY 的目標,應搭配連線記錄中的目標與策略檢查;預期走 DIRECT 的目標,則不能用來證明代理出口可用。網頁能開啟只是存取結果;要確認實際採用的路徑,還需查看規則和記錄。

若要比較,可先保持使用同一台伺服器,在代理(Proxy)和設定檔(Config)模式下分別存取同一個目標。Proxy 正常、Config 異常時,優先檢查規則順序、策略引用和目前的設定檔;兩種模式都失敗時,則優先確認伺服器參數、服務狀態或目前網路。這種比較有助縮小問題範圍,但不能只憑一次測試就下結論。

Data 中的流量變化可作為輔助參考,但 App 或系統的其他請求也可能產生流量;數字增加不能單獨證明目標使用了預期策略。同樣地,測試顯示的耗時不等於實際下載速度。完成測試後,請保留最終使用的模式和設定檔;若仍無法判斷結果,再進入最後一步逐項排查。

Settings 與常見問題:每次檢查一個變因

依問題發生的階段逐步檢查,先不要重設所有設定。記下問題是「沒有匯入內容」、「開關無法維持開啟」、「測試失敗」,還是「只有特定目標無法存取」。每次只修改一個項目,再對同一目標重新測試,才能判斷是哪項調整造成變化。

匯入後沒有伺服器項目

返回新增資料的步驟,確認訂閱使用 Subscribe 類型、連結完整且仍有效,也確認裝置目前的網路能否取得訂閱內容。不要自行刪改連結中的認證參數;若服務商已更換連結,請向你的服務商取得最新資料。更新前保留必要的自訂內容,避免尚未確認原因就刪除唯一可用的項目。

開關回到關閉,或系統授權尚未完成

先確認系統 VPN 設定授權已允許,再檢查是否有其他 VPN 連線或裝置管理限制影響目前連線。若取消了首次出現的提示,請重新發起連線並完成授權。這類問題發生在建立系統通道的階段,優先檢查授權和裝置狀態,比反覆更換規則更合適。

連線維持開啟,但測試或存取失敗

先確認選取圓點是否位於預期的伺服器旁,再核對 Type、Host、Port 和認證參數。欄位確認無誤後,再確認原有服務是否仍可使用;必要時可在裝置允許的其他網路下重新測試,以判斷問題是否與目前網路有關。記下測試結果的變化,不要把偶然一次成功視為問題已完全解決。

前往 Settings 可找到 Test Method,此設定會影響連通性測試的判斷方式。若某種測試失敗但實際存取正常,請先了解測試條件,再決定是否調整。On Demand 與自動連線條件有關;若手動中斷後又自動連線,請檢查這些條件,不要誤以為開關故障。

只有 Config 或特定目標異常

返回 Config 確認啟用的是預期檔案,並檢查目標之前是否已有更早命中的規則,以及規則引用的策略是否符合目前設定。若懷疑 DNS 有關,只記錄相關現象並逐項確認,不要同時修改 DNS、規則和協定參數。若要調整 Proxy、TCP、UDP 等進階設定,請依完整手冊中的相關章節操作。

Settings 中的 Diagnostics 可協助進一步判斷問題。整理診斷資料時,請保留錯誤現象、使用的模式、重現步驟和測試結果;分享前移除訂閱連結、認證參數、密碼及其他可識別資訊。常見問題的後續處理方式請參閱FAQ,不必為了回報問題而公開整份設定檔。

Shadowrocket 官方 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
App Store 官方截圖:Settings。排查時請依實際觀察到的現象檢查相關項目,不必把所有設定都修改一遍。

首次連線後的延伸閱讀

能穩定重現一次成功存取後,再逐步學習設定檔維護。保留目前有效的設定,比同時嘗試多個新選項更容易判斷問題。