官方手冊 · 首次設定

Shadowrocket 使用說明 從匯入到連線驗證

依序新增資訊、選擇模式、連線與驗證。首次設定時,先讓一條已知可用的連線通過驗證,再調整規則與自動連線設定。

Add Server Global Routing Connectivity Test

STEP 01 / 準備連線資訊

新增伺服器或匯入訂閱

完成標準:Home 的 SERVER 分組出現可選取的伺服器,而不只是儲存了一條連結。

開啟 Shadowrocket 後,先確認手邊取得的是什麼:一條可返回多個伺服器項目的訂閱連結,或是某個伺服器的完整參數。兩者的入口和用途不同。訂閱用於批次取得並更新項目;手動新增則會將指定伺服器儲存在本機。第一次操作只需選一種方式,不必用所有入口重複匯入同一份資訊。

有訂閱連結:使用 Subscribe

從你的服務商複製完整訂閱連結,開啟 Config,找到 Subscribe 入口,依提示貼上連結、填寫方便辨識的名稱並儲存,再執行更新。入口位置可能隨應用程式介面調整,請以目前顯示的 Subscribe 為準。連結中的查詢參數也是網址的一部分,不要刪除問號後的內容,也不要把說明頁網址當成訂閱網址。

匯入完成後返回 Home,檢查 SERVER 分組。如果只顯示儲存成功,卻沒有出現伺服器,先查看訂閱更新結果,確認伺服器確實傳回可辨識的資料。訂閱與設定檔不是同一種內容:訂閱主要提供伺服器項目,設定檔還可能包含規則和其他設定。不要為了匯入訂閱而直接取代現有設定。

https://example.com/sub?token=xxxx

以上僅為格式範例,並非可用訂閱。真實連結通常含有個人憑證,不要貼到公開留言、截圖或共用文件中。

有伺服器參數:使用 Add Server

返回 Home,在 SERVER 分組點選 Add Server。先選擇與伺服器端一致的 Type,再填寫 Host 和 Port;接著依該類型需求填寫 Password、Method 或其他驗證欄位。截圖展示的是其中一種欄位組合;選擇 VLESS、Trojan 等其他 Type 後,欄位會有所不同,不能將截圖中的欄位直接套用到所有協定。

Host 通常填寫服務端提供的網域或 IP,不要自行加上網頁網址的路徑;Port 必須與伺服器的監聽連接埠一致。若類型涉及 TLS、傳輸方式、路徑或伺服器名稱,也應逐項核對服務商提供的參數,不能只填網址和密碼就認定設定完成。儲存後返回 Home,選取剛新增的項目,留意目前的選取標記。

如果已有個人 QR Code,可使用 Scan QR Code;Import from Cloud JSON 則用於匯入相應格式,並非通用的任意網頁連結入口。匯入後仍須檢查 Type、Host 和 Port。儲存伺服器只代表資訊已寫入客戶端,是否能連線仍須經過後續驗證。需要比較幾種入口時,可繼續閱讀訂閱與伺服器匯入的四種方式。

Shadowrocket 的 Add Server 官方介面,顯示 Type、Host、Port、Password、Method 及掃描匯入入口
Add Server:先選擇 Type,再依自己的伺服器資訊填寫對應欄位。

STEP 02 / 決定請求路徑

選擇 Global Routing 模式

完成標準:能區分目前伺服器與路由模式,並確認正在使用的設定檔。

新增伺服器後,返回 Home,點選 Global Routing。這裡決定請求如何處理,與在 SERVER 中「選哪一台伺服器」是兩項獨立設定。只切換伺服器而未確認模式,可能使實際請求仍以原本方式處理。首次使用時,請先了解配置 (Config)/代理 (Proxy)/直連 (Direct) 三種模式;若介面還顯示 Scene,先維持現狀,等基本連線驗證完成後再研究場景設定。

配置 (Config):依目前檔案分流

日常需要依規則分流時,選擇 Config。客戶端會依目前啟用設定檔中的規則,判斷請求應使用 PROXY、DIRECT 或 REJECT。開啟 Config,確認目前使用的檔案,再進入 Rule 查看內容。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同的設定區段,首次連線不需要逐一修改,更不必為了完成本教學啟用 HTTPS Decryption。

Rule 中的規則通常依由上而下的順序檢查,第一條符合的規則會執行對應策略,最後的 FINAL 負責處理此前都未符合的請求。以下片段僅用來理解順序,不需要直接取代你的設定。修改前先保留原始檔案,避免無法還原原有規則。

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

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

Proxy 會將需要代理處理的請求交由所選伺服器處理,可用來比對「伺服器是否可用」以及「規則是否讓請求走錯路徑」。這不代表所有應用程式或網路環境都一定可用,也不能取代正確的伺服器參數。Direct 則不經代理伺服器,用於直連存取或排除代理連線的影響;選擇 Direct 後,即使連線開關已開啟,也不能因此認定請求正經由代理伺服器傳送。

如果已有可信任的設定檔,先用 Config 完成連線。若之後發現只有部分目標異常,再短暫切換至 Proxy,針對相同目標進行比對;測試結束後恢復原模式。關於 DOMAIN-SUFFIX、FINAL 與策略的詳細意義,請參閱術語手冊;若異常與規則順序有關,請前往疑難手冊繼續檢查。

Shadowrocket 的 Config 官方設定編輯介面,顯示 General、Rule、Hosts 等區段與 Add Rule
Config:Config 模式使用目前設定;在 Rule 區段檢查規則內容。

STEP 03 / 建立系統連線

開啟 Home 頂部的連線開關

完成標準:已完成系統授權,返回 Home 後開關維持開啟,連線狀態不再停留於 Not Connected。

現在返回 Home,再次檢查 SERVER 中選取的伺服器與 Global Routing。確認這兩項後,開啟頂部 Not Connected 附近的連線開關。首次連線時,系統可能會要求新增 VPN 設定;閱讀提示並允許,依系統要求使用裝置密碼或生物辨識完成確認。這項授權用於建立系統網路通道,與訂閱是否有效是兩回事。

授權結束後返回 Shadowrocket,觀察開關和狀態是否維持不變。若剛開啟就自動關閉,先看清楚系統提示,不要立刻重複匯入訂閱或連續新增多個伺服器。裝置上的其他 VPN 連線、受管理裝置的限制或未完成的系統確認,都可能影響這個步驟。可以先中斷其他 VPN,再返回本應用程式重試;受組織管理的裝置應依管理員要求處理,不要刪除不明的管理設定。

iPad 的版面可能因螢幕尺寸或分割畫面狀態而與截圖略有不同,但操作順序相同:先選伺服器,再確認 Global Routing,最後開啟連線開關。找不到某個入口時,先返回 Home,必要時退出分割畫面再確認;不要將系統網路設定中的其他開關當成應用程式內的連線按鈕。

連線狀態出現後,先不要更改 On Demand 或同時調整多個選項。頂部開關開啟只代表系統通道已建立,伺服器仍可能驗證失敗,規則也可能將目標導向 Direct。保留目前狀態,繼續進行下一步的實際存取驗證,才能確認完整連線是否可用。

Shadowrocket 的 Home 官方介面,顯示 Not Connected 開關、Global Routing、Connectivity Test 與 SERVER 分組
Home:確認 SERVER 與 Global Routing 後,再操作頂部連線開關。

STEP 04 / 檢查實際結果

驗證連線與規則是否生效

完成標準:實際目標可正常存取,且請求採用的策略符合預期。

讓連線開關維持開啟,先執行 Home 中的 Connectivity Test,作為目前測試方式下的連線參考。出現測試結果不代表任何網站或協定都正常;即使顯示逾時,也應搭配測試目標、測試方式和實際存取情況一起判斷。不要只依據一次測試數值就大幅修改設定。

  1. 先確認基本網路。用瀏覽器開啟平時可正常瀏覽且自己有權存取的頁面。若關閉連線後仍完全無法瀏覽,先處理 Wi-Fi、行動網路或網路登入頁,而不是繼續修改伺服器參數。
  2. 再測試實際目標。開啟預期由代理處理的目標並重新整理一次,避免把瀏覽器快取誤認為新的連線結果。若只有某個應用程式失敗,再用瀏覽器開啟同一服務中可存取的頁面進行比對。
  3. 最後確認請求策略。在應用程式可用的請求記錄或 Data 資訊中,找到剛才的目標,檢查符合的規則及 PROXY、DIRECT、REJECT 結果。不同介面的記錄欄位可能不同,重點是「同一個目標是否走預期路徑」。

在 Config 模式下,一個目標正常、另一個失敗時,通常需要進一步區分規則匹配、DNS 解析和目標服務本身的限制。可以暫時切換至 Proxy,維持伺服器與目標不變再測一次:若 Proxy 正常而 Config 失敗,優先檢查規則;若兩者都失敗,優先檢查伺服器與目標之間的連線。這只是定位方式,不代表 Proxy 是所有故障的固定解法。

不要把網頁顯示的出口 IP 當作唯一證據。Config 模式下,不同目標可能採用不同策略,某個查詢頁面直連不代表所有請求都直連。驗證時記錄目標、模式、所選伺服器與結果即可;每次只變更一個條件,結束後恢復預定使用的 Config 模式。

STEP 05 / 依故障位置回查

常見故障點與 Settings 檢查

先確認故障發生在哪個步驟,再修改對應設定;不要同時重設所有選項。

已儲存訂閱,但沒有伺服器

返回訂閱入口檢查更新結果。確認貼上的是完整訂閱連結,沒有多餘空格、換行或遺漏參數,再檢查目前的基本網路能否存取該網址。連結失效、傳回登入頁面或傳回不支援的格式,都可能導致清單未建立。此時可向自己的服務商確認連結狀態;不要將含有憑證的完整網址交給公開檢測頁面。詳細操作請參閱訂閱更新說明。

開關可以開啟,但伺服器逾時

先確認選取的是否為剛新增的項目,再逐項檢查 Type、Host、Port、驗證欄位、TLS 和傳輸參數,並確認裝置系統時間設為自動。開啟 Settings 查看 Test Method:不同測試方式評估的環節不同,變更方式後不能直接將數值與先前結果混為一談。伺服器端沒有回應時,反覆修改本機規則通常沒有幫助。

部分網頁無法瀏覽,或連線自行恢復

部分目標異常時,沿用上一步的 Config 與 Proxy 進行比對,檢查是否符合較前面的規則。若手動中斷後連線又自動恢復,查看 Settings 中的 On Demand,並檢查是否設定相應的觸發條件。初次使用建議先完成手動連線驗證,再設定自動連線;需要變更自動連線行為時,先記下原設定,避免測試後忘記還原。

Settings 還包含 Proxy、TCP、UDP 等分組,並非遇到故障就必須修改的項目。只有某個應用程式的即時語音或特定功能失敗時,再依實際使用的傳輸類型檢查對應項目。不要為了通過某項測試而任意更改所有設定,否則會失去可供比對的基準。

需要進一步排查時,保留哪些資訊

在 Settings 的 Diagnostics 中查看可用的診斷資訊,搭配實際故障時間和操作步驟進行定位。記錄「是否匯入成功、開關是否維持開啟、Connectivity Test 結果、哪些目標失敗、Config 與 Proxy 是否有差異」,通常比只說「無法使用」更有幫助。分享記錄前,請遮蔽訂閱網址、密碼、個人伺服器網址和其他驗證資訊。

本頁的首次設定流程到此完成。若持續遇到逾時、DNS 異常、耗電變化或更新後問題,請繼續閱讀依症狀整理的疑難手冊;若只是不清楚某個設定名稱,請先查閱術語手冊,不必重新匯入整份設定。

Shadowrocket 的 Settings 官方介面,顯示 Test Method、On Demand、Diagnostics、Proxy、TCP 與 UDP 分組
Settings:依症狀檢查 Test Method、On Demand 或 Diagnostics,保留原設定以便比對。
免費下載 Shadowrocket