官方手冊 · 入門指南

Shadowrocket 匯入與首次連線

先準備連線資訊,再選擇流量分流方式。依照五個步驟完成設定,每一步確認結果後再繼續。

Add Server Global Routing Connectivity Test
步驟 01 · 準備連線項目

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

開啟 Shadowrocket 後,先停留在 Home,暫時不要開啟頂端開關。下方的 SERVER 區域可用來查看及選擇伺服器。剛安裝 App 時,這裡可能還沒有可選項目;須先匯入現有資訊,連線開關才有明確的連線目標。新增伺服器與新增設定檔是兩回事:前者儲存連線位址和身分資訊,後者主要用來描述如何處理請求。

手動填寫:先選擇 Type

在 Home 點選 Add Server,先開啟 Type,選擇與現有資訊相符的協定。不同協定所需欄位各異,不要只憑伺服器名稱猜測。以 Shadowsocks 為例,請核對 Host、Port、Password 與 Method;其他協定則依畫面顯示的欄位填寫。位址欄通常填寫主機名稱或 IP,不要將整串網頁網址貼入。

逐項複製時,留意開頭與結尾的空格、連接埠號碼、密碼大小寫,以及加密方式是否完全一致。若涉及 TLS、傳輸方式或其他擴充參數,請依原始伺服器資訊設定,不要隨意切換參數來試錯。填寫完成後使用頁面上的儲存功能,返回 Home,確認新項目已出現在清單中。若仍停留在編輯頁,請先檢查是否漏填必填欄位。

匯入訂閱:分辨伺服器訂閱與設定檔

若已有伺服器訂閱連結,請從 Home 進入 Add Server,將 Type 設為 Subscribe,在相應的 URL 欄位貼上向服務供應商取得的完整連結,再儲存並等待匯入完成。匯入後,應可在 Home 看到相應的分組與伺服器項目。若只看到訂閱名稱,分組內卻沒有項目,就還不能算匯入完成;請繼續檢查回傳內容及錯誤訊息。

Config 頁面用於管理設定檔。若持有的是設定檔網址,請在該頁使用相應的遠端設定檔入口;看到 Subscribe 時,也要先確認目前頁面處理的是哪一種內容。不要將包含伺服器清單的訂閱網址當作規則檔使用,也不要將只含規則的檔案匯入為伺服器資訊。若不確定,請先確認原始說明中的內容類型,再繼續操作。

若已有 QR Code,可使用 Scan QR Code 掃描,並在儲存前核對解析出的協定與欄位;Import from Cloud JSON 適用於相應格式的內容,不代表任何訂閱都能透過此入口匯入。訂閱連結可能包含存取憑證,請勿將完整連結貼在公開截圖或問題記錄中。格式差異請參閱術語表。

繼續前請確認:返回 Home 後看得到實際伺服器項目,而且項目不是空白。接著再選擇如何使用這些項目處理請求,不要馬上反覆點擊連線開關。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON
Add Server:先選擇 Type,再填寫該協定所需欄位。截圖中的欄位不代表所有協定都相同。
步驟 02 · 確認請求策略

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

匯入完成後,返回 Home 並點選 Global Routing。這裡決定請求採用哪種整體處理方式,不會建立伺服器,也不會替你補齊缺少的連線資訊。三種模式分別是設定(Config)/代理(Proxy)/直連(Direct)。先了解目前的選擇,再觀察後續結果,才能避免誤以為「開關已開啟,就代表連線方式符合預期」。

  • 設定(Config):依照目前設定檔中的規則決定策略。請求可能使用 PROXY、DIRECT 或 REJECT,因此並非所有請求都會走同一條路徑。
  • 代理(Proxy):讓流量以代理方式處理,適合在排查時與 Config 作比較。此模式不會自動修正錯誤的伺服器參數,也不能取代伺服器選擇。
  • 直連(Direct):以直連方式處理請求。選擇此模式後,即使連線開關維持開啟,也不能據此判斷請求使用了代理伺服器。

準備使用規則分流時,請選擇 Config,再進入底部的 Config 頁面,確認目前選用的是預計使用的設定檔。檔案存在與已選用檔案是兩種不同狀態;編輯了其他檔案,也不代表目前連線會套用那些修改。請先確認選用的檔案,再查看其中的 General、Rule 等區段。

官方截圖中的 Hosts、URL Rewrite 與 HTTPS Decryption 是其他設定區段。首次連線只需了解目前規則的用途,不必為了入門而逐項啟用。Add Rule 可用來新增規則,但尚未確認伺服器可用前,不建議一開始就大量新增規則,否則連線問題與規則比對問題會混在一起。

規則通常會依序檢查,較前面的符合項目可能決定最終結果。例如 DOMAIN-SUFFIX 用於處理網域後綴,FINAL 用於處理先前未符合規則的請求。以下片段僅供說明語法,並非可直接套用的完整連線方案;其中的網域僅為示例,策略也須依實際設定理解。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

若只想先確認現有伺服器是否可用,可暫時選擇 Proxy 進行連線測試,再切回 Config 比較同一個請求。每次只變更這個項目,並維持相同伺服器與測試目標。規則類型與策略的進一步說明,請參閱功能與設定;關鍵字說明請見術語表。

繼續前請確認:記下目前的 Global Routing 模式;使用 Config 時,確認已選用預期的設定檔。

Shadowrocket Config 設定檔編輯官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:檢查設定區段與規則。Global Routing 的入口位於 Home,不在這張編輯頁截圖中。
步驟 03 · 建立連線

Home:選擇伺服器並開啟開關

返回 Home,在 SERVER 分組中點選要使用的伺服器,確認選取標記位於目標項目上。若訂閱匯入了多個項目,請先固定使用其中一個完成驗證,測試期間不要連續切換。名稱只方便辨識,能否建立連線仍取決於實際位址、協定參數、憑證及目前的網路狀態。

確認 Global Routing 後,開啟頁面頂端的連線開關。首次建立系統連線時,裝置可能會顯示新增 VPN 設定的授權提示。請閱讀系統說明,確認此操作是由你剛才使用的 Shadowrocket 發起,再依提示允許,並按照裝置要求完成身分驗證。此步驟僅用於授權新增系統網路設定;伺服器憑證應在 App 內的對應伺服器項目中確認。

若先前拒絕了授權,請返回 App 重新發起連線,並留意系統提示是否再次出現;若裝置由組織管理或受到使用限制,請先確認相關限制,不要反覆切換 App 內的參數來處理系統權限問題。iPhone 與 iPad 的系統提示版面可能不同,請以實際顯示的 App 名稱與操作內容為準。

完成授權後,等待頂端狀態從截圖中的 Not Connected 轉為連線狀態,再開始驗證。開關開啟表示本機連線已啟動,但不保證所選伺服器一定可連線,也不代表每個網域都會採用代理策略。若開關立即關閉,請記下當時的提示;若開關維持開啟但頁面無法載入,則進入下一步檢查請求結果,不要將這兩種情況混為一談。

首次驗證期間,建議暫時維持相同的網路環境。切換 Wi-Fi 與行動網路會改變連線條件;若確實需要比較,請先記錄原網路下的結果,再切換網路並重做相同操作。這樣才能判斷變化是否來自網路,而不是剛好同時修改了伺服器或規則。

繼續前請確認:已選定伺服器、完成系統授權,且開關能維持連線。接著進行驗證,不要只憑開關狀態下結論。

Shadowrocket Home 官方截圖,顯示 Not Connected 開關、Global Routing、Connectivity Test、SERVER 分組與 Add Server
Home:選擇伺服器、確認 Global Routing,再開啟頂端開關。下一步使用 Connectivity Test 進行測試。
步驟 04 · 比對實際請求

Connectivity Test:驗證連線與規則

建立連線後,在 Home 點選 Connectivity Test,等待測試完成。先查看測試是否有回傳結果,再確認目前使用的測試方式。測試結果只能提供特定方法下的連線線索,不代表所有網站或所有協定都已正常運作。若測試失敗,也須配合測試方式判斷,不能只憑單一結果就認定所有訂閱都已失效。

接著開啟一個需要使用、且能確認是否成功載入的頁面。已有快取的頁面可能在連線異常時仍會顯示,因此可重新整理,或開啟該網站中尚未載入過的頁面。先測試一個目標,確認能否取得新內容,再逐步增加其他請求。不要一次開啟太多 App,否則難以將記錄中的請求與實際操作對應。

分開檢視三個層面

  1. 系統連線層:Home 頂端開關是否維持連線,系統是否接受 VPN 設定。若此層失敗,請先處理授權或啟動問題。
  2. 伺服器測試層:Connectivity Test 是否有結果,測試方式是否適合目前條件。此層正常,只代表在相應測試條件下有回應。
  3. 個別請求層:目標頁面是否成功取得內容,請求記錄顯示的策略是否符合 Global Routing 與規則設定。這一層才對應實際使用結果。

需要核對規則時,請查看 App 中的請求記錄,依剛才瀏覽的網域找到項目,檢查其符合的規則與策略資訊。若使用 Config,目標符合 DIRECT 可能正是設定預期;若符合 REJECT,請先確認是否由規則主動封鎖,而不是直接修改伺服器密碼。頁面成功開啟也不一定代表使用了代理,請一併檢查實際策略。

若同一台伺服器在 Proxy 下可以存取目標,切回 Config 後卻失敗,請優先檢查該網域符合的規則、策略引用與設定檔選擇。反之,兩種模式都失敗時,應先查看伺服器參數、網路連線狀況及名稱解析。對照測試結束後,記得切回日常使用的模式,避免長期保留臨時排查設定。

完成標準:開關狀態穩定、目標內容可正常取得,而且實際策略符合預期。確認這三點後,再考慮新增規則或調整自動連線。

步驟 05 · 依階段排查問題

Settings:檢查常見問題

遇到問題時,先找出最後一個成功的步驟:訂閱尚未匯入、開關無法維持連線、測試沒有結果,還是只有目標頁面無法載入。接著開啟 Settings,核對與該現象相關的設定。截圖中的 Test Method、On Demand 與 Diagnostics 分別涉及測試方式、自動連線條件與診斷,請勿同時變更。

訂閱未匯入或分組為空

先確認貼上的是完整訂閱連結,而不是服務管理頁面的網址。檢查連結是否多了空格或換行,或缺少查詢參數,並確認原始連結目前仍有效。訂閱請向服務供應商取得;若回傳內容或使用權限有問題,請依原始說明確認。再次匯入前,先查看現有分組,以免重複新增後誤將舊項目當成新結果;請勿公開含有憑證的連結。

連線開關立即關閉

返回 Home,確認已選擇實際伺服器,再檢查是否完成系統授權。記下畫面上的錯誤提示,並留意是否有其他連線正在使用系統 VPN 設定。不要直接刪除所有設定或重置整部裝置的網路;先讓目前連線單獨運作,才能判斷問題是否來自權限、設定載入或系統連線衝突。

測試失敗或頁面載入失敗

先在 Settings 查看 Test Method,記下目前使用的方法,再於相同條件下測試一次。若只有一個項目失敗,請著重核對該項目的協定與欄位;若多個項目同時失敗,也要考慮目前網路與訂閱狀態。測試正常但網頁無法載入時,請重新檢查網域解析、Global Routing 與規則比對結果,不要只是不斷重跑測試。

必要時可透過 Diagnostics 查看診斷資訊,並記錄問題發生的階段。分享記錄前,請先遮蔽訂閱 URL、密碼、身分識別資料及其他敏感欄位。保留錯誤提示、目前模式、測試方式與網路類型,通常更有助於排查,不必公開整份設定。DNS、逾時與更新後異常的完整排查流程,請參閱問題診斷。

手動連線正常後,再檢查 On Demand

On Demand 用於依條件啟動連線,無法修正錯誤的伺服器資訊。初次使用時,請先確認手動連線正常,再設定自動連線條件;若發現連線會自動恢復,或中斷後再次啟動,請回到此項檢查目前的條件。修改後重現預期情境,確認實際行為符合條件,不要只依據開關短暫變化來判斷結果。

保留可重現的設定:每次只變更一項,並記錄修改前後的結果。手動連線正常且規則符合預期後,本次入門設定即完成;之後再依需要了解設定檔與診斷細節。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:依問題檢查 Test Method、On Demand 與 Diagnostics,不要同時變更所有設定。
前往 App Store