官方手冊 · 首次設定

Shadowrocket 使用教學

新增既有訂閱或伺服器,選擇 Global Routing,開啟連線,再透過 Connectivity Test 和實際造訪結果進行確認。

第 1 步 · 準備伺服器項目

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

在 Home 找到 Add Server,先判斷手邊資料的類型。如果服務商提供協定類型、位址、連接埠與憑證,就手動新增單一伺服器;如果提供的是用來取得一組伺服器的訂閱連結,就選擇 Subscribe。同一份資料只使用一種方式。訂閱連結通常以網址形式提供,但它不是伺服器位址,不能直接填入 Host 當成單一伺服器使用。

填寫單一伺服器

進入 Add Server 後,先用 Type 選擇服務商標示的協定,再填寫顯示的欄位。Host 填入提供的主機名稱或 IP 位址,Port 填入對應連接埠。截圖中可見的 Password 和 Method 是此類表單的欄位範例;切換 Type 後,必填項目會依協定改變。不要照抄截圖中的欄位組合,也不要藉由輪換協定補足缺少的資料。

儲存前,請從上到下核對一次原始資料。複製位址時,檢查前後是否有空格或換行;連接埠請依資料個別填寫。若手邊有服務商提供的 QR Code,可在同一頁尋找 Scan QR Code,掃描後仍須核對匯入類型與伺服器位址。Import from Cloud JSON 是 JSON 匯入功能,不是一般訂閱連結的入口。

匯入一組伺服器

在 Add Server 的 Type 中選擇 Subscribe,貼上服務商提供的完整訂閱連結後儲存。複製時不要漏掉連結末尾的參數,也不要把說明文字一併貼上。訂閱位址可能包含存取憑證,回報問題時只保留錯誤訊息與發生時間,不要公開原始連結或包含連結的截圖。

Add Server 頁面顯示 Type、Host、Port、Password、Method,以及掃描 QR Code 和 JSON 匯入入口
Add Server:先選擇 Type,再核對該類型所需欄位。

進入下一步前:返回 Home,確認 SERVER 中出現剛儲存的項目,或展開訂閱群組後能看到實際伺服器。出現群組名稱不代表已取得伺服器清單;如果只有空群組,請先前往常見問題位置排查,不要帶著空清單繼續測試連線。

第 2 步 · 決定要求的處理方式

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

在 Home 點開 Global Routing。這裡決定開啟連線後,客戶端如何處理流量;它與在 SERVER 中選取哪台伺服器是兩項獨立設定。將伺服器設為目前項目,不會自動把 Global Routing 改成 Proxy。先選定要驗證的模式,再用下一步的開關啟動連線。

依本次驗證目的選擇模式

設定檔(Config)
依目前生效的設定檔處理要求。符合網域或網段時,使用規則指定的策略;前面的規則都未符合時,查看 FINAL 指定的去向。已了解設定檔內容、要驗證日常分流時,請選這個項目。
代理(Proxy)
讓客戶端接管的流量經過目前選取的代理伺服器,而不是逐條依照 Config 中的規則分流。首次排查時可短暫使用此模式,分別檢查「伺服器能否處理造訪」與「目標是否符合預期規則」。
直連(Direct)
讓客戶端接管的流量直接造訪目標,不經過選取的代理伺服器。這不會關閉頂端的連線開關;用此模式進行比對時,開關仍可維持開啟。

選擇 Config 時,確認目前使用的檔案

如果選擇 Config,請再進入底部的 Config 頁面,確認目前啟用的檔案。點開對應檔案查看 Rule,先找出與目標相關的條件和策略,再檢查規則排列順序與最後的 FINAL。例如,一條指向 DIRECT 的符合規則,可以解釋為什麼連線已開啟,但該要求仍然直連。

Config 檔案編輯頁面顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config 檔案編輯頁面:可在 Rule 中查看規則條件和策略;首次連線不需要使用 Add Rule。

進入下一步前:返回 Home,確認 Global Routing 旁顯示的模式。首次驗證不必同時修改規則與伺服器;先記下目前模式,取得驗證結果後,再決定是否需要調整。規則關鍵字的意思請見術語手冊。

第 3 步 · 啟動連線

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

確認圓點指向要測試的伺服器

返回 Home,在 SERVER 中找到本次要使用的伺服器,點選項目並確認圓點標記已移至該列。如果匯入了一組名稱相近的項目,請先核對備註或位址,避免選到上次使用的項目。只展開群組或進入詳細頁面,並不代表已選取伺服器。選好後保留目前的 Global Routing,以便下次使用相同模式進行比對。

處理首次出現的系統確認

當 Home 頂端顯示 Not Connected 時,點選同一列的開關。首次開啟時可能會收到系統新增 VPN 設定的提示;確認這是剛才從 Shadowrocket 發起的操作後再允許,並依系統提示完成驗證。若之前已新增相關設定,本次可能不會再次提示。如果不小心取消確認,返回 Home 重新發起即可,不需要再次匯入相同訂閱。

系統確認完成後返回 Home,等待狀態穩定,並確認開關維持開啟。如果開關很快跳回關閉,先不要連續切換開關或更換多台伺服器。記下系統提示與開關變化,再依排除問題一節處理。開關開啟表示本機連線已啟動,但不能單獨證明選取的伺服器可用,也不能代表某個目標已依預期分流。

Home 頁面顯示 Not Connected 開關、Global Routing、Connectivity Test 和 SERVER 群組
Home:在 SERVER 中選取項目,再操作頂端開關;Connectivity Test 也在同一頁。

第 4 步 · 比對兩項結果

Connectivity Test:搭配實際造訪進行驗證

開啟連線後,在 Home 使用 Connectivity Test,等待結果返回。將結果與同一時間使用的伺服器、Global Routing 和網路環境對照,例如記下當時使用 Wi-Fi 或行動網路。測試反映的是當時使用的測試方式所測得的連通情況,不代表所有 App、網域或要求都會得到相同結果。單次測試失敗時,也不必立刻重新安裝或清除設定。

接著用瀏覽器造訪一個平時可用且確實需要驗證的頁面。盡量開啟需要重新載入的內容,不要只查看已顯示的舊分頁;在沒有送出新要求時,快取內容仍可能顯示。驗證 Config 時,可各選一個預期使用 DIRECT 和一個預期使用 PROXY 的目標,分別記錄是否能開啟。頁面能開啟只代表造訪成功,不能單憑這點判斷它使用了哪種策略。

如果測試正常,只有某個目標無法開啟,先保持伺服器不變,確認該目標與 Rule 的符合情況;網頁載入也可能涉及主要網址以外的資源網域,不要只看網址列中的主網域。若要進行比對,可暫時切換一次 Proxy,使用相同網路重新開啟同一頁面。如果使用 Proxy 時可以造訪,但使用 Config 時不行,請優先檢查規則順序與預設策略。比對結束後,恢復日常使用的模式,並返回 Home 確認顯示已恢復。

第 5 步 · 從異常出現的位置回查

Settings:依失敗位置排查

先用 Home 判斷問題出現在哪個環節:清單為空、開關無法維持開啟、測試失敗,或只有目標頁面異常。不要同時修改協定、更換伺服器和調整規則。請依下列情況的發生順序排查;前一個環節未通過前,不必先更動後續設定。

訂閱群組存在,但沒有伺服器

先確認儲存時選擇了 Subscribe,再對照自己的原始訂閱資料,確認連結是否完整,尤其是查詢參數。如果訂閱群組有更新功能,確認網路正常後手動更新一次,再返回 SERVER 查看是否有實際項目。如果清單仍為空,可向提供該訂閱的服務商確認連結狀態與回傳內容;重複新增相同連結只會增加待確認的群組。

開關關閉後又自動開啟,或無法維持開啟

如果開關無法開啟,先確認系統是否允許新增 VPN 設定,並檢查是否有另一個 VPN 連線正在使用;受管理的裝置請遵循裝置管理規定。若問題是手動關閉後又自動連線,請進入 Settings 查看是否啟用 On Demand,以及目前網路是否符合其條件。記下原本設定,再依需求進行一次比對,避免將自動觸發誤認為開關故障。

開關維持開啟,但測試失敗

確認裝置的基本網路可用,再返回 Home 核對圓點指向的項目。如果是手動新增,請逐項核對 Type、Host、Port 與協定所需欄位;不要用猜測的連接埠覆蓋原設定。若曾調整 Settings 中的 Test Method,先記下目前選項。不同測試方式的結果不宜直接比較;重新測試時請維持相同方式。

Settings 頁面顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:排查時優先核對 Test Method 和 On Demand;需要更多線索時可查看 Diagnostics。

測試成功,但日常造訪結果與預期不符

先檢查目前是否仍使用用於比對的 Proxy 或 Direct,再確認 Config 下啟用的是預期檔案。只有部分目標異常時,優先檢查這些目標的規則條件、順序與最終策略,不必先修改 TCP、UDP 或其他設定。需要進一步定位時,可查看 Diagnostics;轉述結果前請遮蔽訂閱位址、伺服器憑證及不必要的造訪紀錄。

下一步:依照驗證步驟重新測試一次。如果已確認失敗環節,請參閱 FAQ 比對具體症狀;需要了解協定欄位或比較協定類型時,請前往技術參考。