官方手冊 · 首次設定

Shadowrocket 使用教學
訂閱匯入與連線驗證

依新增、模式、連線、驗證、排錯的順序操作。先完成一次可重現的連線,再調整規則與隨選連線設定。

STEP 01 / ADD SERVER

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

先確認手上的資料屬於哪一種:包含 Host、Port、Password 等欄位的是單一伺服器資訊;可更新一組伺服器的網址則是訂閱連結。兩者不能只靠連結長度區分,也不要把服務商的登入頁面網址當成訂閱網址。請先從自己已有的服務商提供的設定說明確認匯入類型,再進入 Shadowrocket 操作。

單一伺服器:核對 Type 與欄位

開啟 Home,點選右上角的新增入口或清單中的 Add Server。進入後先點選 Type,選擇與既有伺服器相同的協定,再逐項填寫 Host、Port 和必要的驗證欄位。右側官方截圖顯示包含 Password 與 Method 的表單;選擇不同 Type 後,欄位也會有所不同,不要為了符合截圖而變更協定。

Host 通常只填寫伺服器網域名稱或 IP 位址,不要附上網頁路徑;Port 填寫服務商提供的連接埠號碼。密碼大小寫、Method,以及協定要求的 TLS、伺服器名稱等參數都必須一致。若未提供某個欄位,請先查看服務商說明,不要依照他人的設定猜填。填寫完成後,使用頁面上的儲存或完成按鈕,返回 Home,檢查 SERVER 群組中是否出現新項目。

訂閱:選擇 Subscribe 後儲存

如果已有的是訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,將完整網址貼到對應的 URL 欄位,再儲存。複製時需包含網址尾端的所有參數,並清除前後空格與意外換行,但不要自行刪除問號後的內容。訂閱網址可能包含身分憑證,請勿將完整網址貼到公開截圖或排錯記錄中。

儲存後返回 Home,等待訂閱內容載入;需要更新時,使用該訂閱項目的更新操作。確認訂閱群組下確實出現伺服器,而不只是儲存了群組名稱。若清單仍是空白,請先跳至常見問題檢查網址,不必反覆開啟連線開關:沒有可選伺服器時,切換模式無法補齊訂閱內容。

若既有設定以 QR Code 提供,可在 Add Server 使用 Scan QR Code,依照系統提示允許存取相機,辨識後檢查內容再儲存。Import from Cloud 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。這裡是在選擇路由方式,不是執行伺服器連線測試,也不會因為選擇某種模式就自動修復伺服器參數。

Config:使用目前規則

日常依規則分流時選擇 Config。用戶端會依照目前設定中的規則處理請求;規則中的 PROXY、DIRECT 與 REJECT 分別代表對應的代理、直連與拒絕策略。開啟底部的 Config,確認目前實際選取的設定檔;進入檔案可看到官方截圖中的 General、Rule、Hosts 等區段。匯入訂閱主要是更新伺服器項目,不代表已切換此處的設定檔。

如果服務商提供符合使用情境的完整設定,請先依照其說明核對並選用,首次連線前不要同時變更 DNS、Rule 和其他進階設定。設定中的具體規則通常應排在兜底規則之前;例如以下片段僅用來說明比對順序,不是需要整段貼上的完整設定檔。

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

Proxy 與 Direct:用於比較

Proxy 會讓通常由此模式處理的請求經由所選代理,適合暫時判斷問題是否與 Config 規則有關。Direct 則使用直連路徑,適合比較本機網路本身是否可用。兩者都不是固定「較快」的選項;存取結果也與目標服務、伺服器狀態和目前網路有關。不要把 Direct 模式下頁面能開啟,誤認為代理伺服器已正常運作。

本教學建議先保留一份明確的既有設定,以 Config 作為日常起點。如果之後需要比較 Proxy 與 Config,只變更這一項並重複相同測試,測試完成後恢復原模式。規則比對、FINAL 與 DNS 的深入檢查,請參閱故障排查手冊。現在返回 Home,準備選擇伺服器並連線。

Shadowrocket Config 設定檔編輯頁,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config 檔案編輯頁:此處管理規則內容;Global Routing 模式選擇位於 Home。

STEP 03 / CONNECT

選取項目並開啟連線開關

返回 Home,在 SERVER 群組中點選準備使用的伺服器,確認選取標記位於目標項目上。訂閱下可能有多個伺服器,新增或更新後應再次確認實際選取的項目。首次操作只選一個項目進行驗證,不要在測試過程中連續更換多個項目,否則很難分辨結果是受到伺服器切換還是設定變更影響。

確認 Global Routing 是剛才選擇的模式,再開啟 Home 頂端的連線開關。官方截圖顯示連線前的 Not Connected 狀態。首次連線時,系統可能會詢問是否允許新增 VPN 設定;請確認發起要求的應用程式確實是 Shadowrocket,再依照系統提示確認,必要時使用裝置密碼或系統驗證完成授權。若取消授權,用戶端將無法依照此設定建立系統連線。

完成授權後返回 Home,觀察開關與連線狀態是否維持。系統狀態區域中的 VPN 標示可協助確認系統連線狀況,但不同裝置、顯示區域和系統版本的呈現方式可能不同,不能只憑某處是否顯示圖示判斷所有請求的路徑。VPN 設定已啟用,也不代表遠端伺服器一定可以存取,因此接下來仍須進行實際驗證。

如果開關剛開啟就恢復關閉,請先記錄是否出現系統提示,查看系統 VPN 設定中是否存在目前設定,以及是否有其他 VPN 連線正在使用。不要反覆重複授權或立即刪除所有設定。由組織管理的裝置可能會限制 VPN 設定,請依照裝置管理要求處理,不要嘗試繞過限制。

首次測試建議暫時維持網路環境不變,不要在連線過程中同時切換 Wi-Fi 與行動網路,也先不要調整 On Demand。需要停止連線時,返回 Home 關閉開關;如果之後發現連線再次啟動,再到 Settings 核對 On Demand 的條件。維持「同一網路、同一項目、同一模式」的基準後,下一步的檢查才有比較價值。

Shadowrocket Home 頁面,頂端顯示 Not Connected 開關、Global Routing 和 Connectivity Test,下方為 SERVER 與 Add Server
Home:確認所選伺服器與 Global Routing 後,再操作頂端的連線開關。

STEP 04 / VERIFY

驗證連線與規則是否生效

先在 Home 點選 Connectivity Test,等待測試結束,查看所選伺服器對應的結果。測試失敗或逾時表示目前測試未完成預期通訊,應先檢查網路與伺服器;測試有結果則表示該測試方式收到回應。這不代表所有網站、所有協定或所有應用程式的請求都可使用,也不能單獨證明 Config 的每條規則都依預期比對。

再以實際請求驗證

保持連線開啟,使用瀏覽器造訪一個平常熟悉、內容明確的頁面,再檢查實際需要使用的目標頁面。盡量開啟新頁面,避免將既有快取誤認為新請求成功。若只有某個應用程式異常,請先比較瀏覽器的存取結果,不要直接將問題歸因於整條線路。應用程式本身的登入狀態、遠端服務故障也可能影響顯示結果。

需要核對分流時,返回用戶端查看可用的連線或診斷記錄,搭配目標網域、命中規則與執行策略判斷。Data 中的流量變化可以作為請求經過用戶端的輔助線索,但流量增加不代表該目標一定使用 PROXY;應搭配實際策略一起檢查。區域網路存取依規則使用 DIRECT 時,出現直連結果本身也不是故障。

進行一次單變數比較

若 Proxy 下可以存取而 Config 下失敗,在伺服器不變的情況下,優先檢查目前 Config 的規則與 DNS;若兩者都失敗,則優先重新檢查伺服器參數、服務有效狀態與目前網路。若 Direct 下也無法存取一般頁面,先恢復本機網路,再回到代理測試。比較結果只用來縮小問題範圍,不據此認定某項設定一定有誤。

只需記錄本次使用的網路類型、伺服器顯示名稱、Global Routing 模式及具體故障現象。不要記錄完整訂閱網址、密碼或驗證參數。確認常用頁面與預期分流都可使用後,再逐項恢復 On Demand 等日常設定;每恢復一項就重新測試一次,方便找出條件變更造成的影響。

STEP 05 / SETTINGS

依症狀檢查常見問題

排錯順序是先檢查本機網路,再檢查匯入內容與伺服器,最後檢查規則和其他設定。每次只變更一項,重複相同的實際請求。進入 Settings 後,可以看到官方截圖中的 Test Method、On Demand 與 Diagnostics 等入口;不要因測試失敗就同時重設 Proxy、TCP、UDP 等設定,否則會失去原本可供比較的基準。

訂閱儲存成功,但清單空白

先返回訂閱編輯頁面,核對 Type 是否為 Subscribe、連結是否完整、是否多了空格。接著確認網址仍有效,且傳回的內容確實是用戶端可辨識的訂閱,而不是登入頁面或錯誤訊息。避免在短時間內連續更新;如果服務商設有更新頻率限制,請依照其說明等待。若有關於網址有效性、權限或內容的問題,向自己已有的服務商確認即可,不要公開完整訂閱連結。

出現伺服器,但 Connectivity Test 逾時

確認一般直連頁面可以開啟,再檢查所選伺服器的 Host、Port 與驗證資訊。訂閱項目先正常更新一次,手動項目則逐一對照原始資料。Settings 中的 Test Method 會影響測試方式與結果的可比較性,因此比較不同伺服器時請維持相同測試方式。若某種測試沒有回應,也要搭配瀏覽器的實際存取結果判斷,不能把單一測試值視為整條線路的狀態。

開關正常,但部分頁面無法開啟

先確認目前模式不是 Direct,再依照上一節的方法比較 Proxy 與 Config。如果只有 Config 失敗,請檢查是否選錯設定檔,以及目標網域是否命中 REJECT 或不適合的 DIRECT 規則。網域解析異常需要進一步檢查 DNS,而非只修改規則順序。暫時不要啟用或變更 HTTPS Decryption、URL Rewrite 來解決一般連線問題;它們不是首次連線的必要步驟。

開關反覆變化,或切換網路後異常

檢查系統 VPN 權限與其他連線是否占用,再到 Settings 查看 On Demand 是否設定自動連線條件。若問題只發生在 Wi-Fi 或行動網路其中一種環境,請分別記錄結果,避免同時變更伺服器和網路。iPad 使用相同的檢查順序;橫向畫面時版面位置可能不同,但仍以 Home、Config、Settings 的入口名稱為準。

需要進一步分析時,使用 Diagnostics 查看可用記錄。分享記錄前,請刪除訂閱網址中的憑證、伺服器驗證資訊及其他個人資料,只保留錯誤現象、發生條件與已嘗試的步驟。系統性的 DNS、耗電、更新後異常和 iPad 專項流程,請參閱Shadowrocket 故障排查;若只是忘記首次操作順序,可返回新增與匯入重新逐步核對,不必先清除所有設定。

Shadowrocket Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:排錯時核對 Test Method、On Demand 與 Diagnostics,每次只調整一項。
Shadowrocket 全平台下載