官方手冊首次連線

Shadowrocket 使用說明

先匯入現有的連線資料,再選擇分流模式。開啟連線後,透過實際瀏覽確認設定是否生效。

01 準備連線資料

新增伺服器或匯入訂閱

開啟 Shadowrocket,先在 Home 找到 SERVER 分組下的 Add Server。接著依照手邊資料選擇操作方式:若有單一伺服器的協定、位址與連接埠,請手動新增;若有用來取得伺服器清單的訂閱連結,請使用 Subscribe。兩種資料用途不同,訂閱連結不能填入單一伺服器的 Host。

只有一台伺服器:先選 Type,再填寫欄位

在 Add Server 中先開啟 Type,選擇資料上註明的協定,再填寫 Host 和 Port。不同協定會顯示不同欄位;若看到 Password 或 Method,請依照現有資料填寫,不要用另一台伺服器的值補空。舉例來說,若位址和連接埠分開提供,就分別填入對應欄位,不要把連接埠重複加在位址末尾。儲存前請檢查位址前後是否混入空格或換行。

有訂閱連結:使用 Subscribe 匯入

在 Add Server 的 Type 中選擇 Subscribe,將完整的現有訂閱連結貼到位址欄位,再儲存。不必將連結拆成主機名稱和連接埠,也不要刪除問號後面的參數。返回 Home,等待訂閱分組載入後展開查看。連結中的參數可能包含存取憑證,請勿將完整連結貼到公開貼文或放入截圖。

進入下一步前:在 SERVER 下方找到實際可選的伺服器並點選。手動設定請確認項目已出現在清單中;訂閱設定則要確認分組內確實有項目。儲存成功只代表資料已寫入,不能證明伺服器可連線。若清單仍是空的,請先依照第五步檢查匯入,不必反覆開關連線。

Shadowrocket 的 Add Server 介面,顯示 Type、Host、Port、Password 和 Method 欄位,以及 Scan QR Code 和 Import from Cloud JSON 入口
官方截圖 · Add Server。先選擇 Type,再依目前使用的協定填寫對應欄位。
02 確認流量走向

選擇 Global Routing 模式

選好伺服器後,留在 Home,點選 Global Routing,再依本次操作目的選擇模式。這裡決定的是流量如何處理,而不是選擇哪台伺服器。例如在 SERVER 選好一個項目後,切換為直連(Direct),一般瀏覽仍不會因為清單中選取了該項目就改走代理。

設定(Config)
依照目前啟用的設定檔比對規則。命中 PROXY 的請求會走代理,命中 DIRECT 的請求會直接連線,命中 REJECT 的請求則依規則攔截。若已有可用規則,並希望日常依規則使用,請選擇此模式。
代理(Proxy)
使用目前選取的伺服器處理進入代理路徑的流量。首次測試時,可暫時切換到這裡確認伺服器能否連線至一般網頁;驗證完成後,若日常使用需要依規則分流,請切回 Config。
直連(Direct)
以直接連線作為比較。例如同一個網頁在 Direct 下能開啟、在 Proxy 下無法開啟,下一步應優先檢查所選伺服器與測試結果,而不是先編輯規則。

兩個 Config 的差異:Global Routing 中的 Config 是模式;底部的 Config 是管理設定檔的介面。需要檢查規則時,請在底部 Config 找到目前使用的檔案,開啟其編輯頁並查看 Rule。截圖中的 Add Rule 用來新增規則,首次連線不需要點選。若有多個檔案,請先記下目前啟用的是哪一個,避免用另一個檔案中的規則解釋測試結果。

不確定規則是否正確時,先使用 Proxy 測試一個目標,再切回 Config 比較結果。規則順序、預設策略與網域比對方式可參閱代理模式,首次連線時不必一併調整。

Shadowrocket 的 Config 設定檔編輯頁,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段和 Add Rule 入口
官方截圖 · Config 設定檔編輯頁。此處用來檢查規則;切換模式請返回 Home 的 Global Routing。
03 建立系統連線

在 Home 開啟連線

返回 Home,依序檢查兩個位置:一是 Global Routing 右側顯示的模式,二是 SERVER 下方目前選取的項目。若要驗證代理,模式應為 Proxy,且已選好一台伺服器;若要驗證現有規則,則應為 Config,並確認前一步查看的是目前使用的設定檔。確認這兩項後,再開啟頂端 Not Connected 旁的開關。

首次開啟時,系統可能會提示新增 VPN 設定。這是系統授權 Shadowrocket 建立網路通道的必要步驟,與在 Add Server 儲存伺服器是兩回事。請確認彈出視窗緊接在剛才的操作之後出現,且應用程式名稱為 Shadowrocket,再依系統提示允許。若系統要求驗證裝置身分,完成後返回 Home。若剛才取消授權,請先不要修改伺服器密碼或連接埠;重新開啟頂端開關發起連線,確認系統是否再次提出請求。

返回 Home 後,等待頂端狀態切換完成,確認沒有立即恢復為 Not Connected。若開關跳回,先記下發生的時間點:是在點選系統提示之前、授權返回之後,還是連線維持一段時間後。前兩種情況請優先檢查授權是否完成,以及系統是否已有其他生效中的 VPN;後一種情況則要確認中斷前是否從 Wi-Fi 切換到行動網路,或裝置是否剛從鎖定畫面恢復。

頂端顯示已連線,只代表系統連線已建立,不代表每個請求都會走代理,也不能證明所選伺服器一定能連上目標網站。此時先保留目前選取的伺服器與模式,直接進入下一步測試。若同時切換網路、更換伺服器並修改模式,即使網頁恢復,也無法判斷是哪項變更發揮作用。

Shadowrocket 的 Home 介面,頂端顯示 Not Connected 開關,下方有 Global Routing、Connectivity Test,以及 SERVER 分組中的 Add Server
官方截圖 · Home。先確認 Global Routing 與目前使用的伺服器,再開啟頂端開關。
04 比較測試結果

確認連線與分流是否生效

先在 Home 點選 Connectivity Test,查看目前選取項目的結果。結果正常只能表示測試使用的方法與目標當時可連線,不能取代瀏覽器或其他 App 中的實際請求。反過來說,單次逾時也不一定代表伺服器無法使用:若測試目標當下無法連線,實際要使用的網站仍可能正常。記錄結果即可,不要依據一次測試立即更改多項設定。

接著開啟平常能瀏覽的網頁,實際重新整理或進入尚未開啟的頁面。只查看已載入的分頁,可能看到的是瀏覽器快取。若主要目的是確認伺服器能否使用,請維持同一個網路與伺服器,分別在 Direct 和 Proxy 下重新開啟同一個目標。等待每次模式切換穩定後再瀏覽;正在進行的下載或已建立的長連線不適合作為此次比較。

兩種模式都能開啟同一個網頁,只能表示這個目標在兩種條件下都可連線,不能只根據頁面內容判斷它走了哪條路徑。若兩種模式都失敗,先檢查裝置本身能否連線至另一個平常可用的目標;若只有 Proxy 失敗,返回 Home 查看伺服器測試結果,並核對手動填寫的協定、連接埠與驗證參數。若 Proxy 正常而 Config 下異常,請先檢查啟用中的設定檔,不必重新匯入伺服器。

使用 Config 時,最好從現有規則中各挑選一個預期命中 PROXY 與 DIRECT 的目標,逐一發出新請求。記錄完整的瀏覽網域,留意網頁是否跳轉到另一個網域,以及實際失敗的是主頁面還是頁面載入的其他資源。若要確認具體命中的項目,請將瀏覽時間與目標網域和診斷紀錄對照。測試結束後,恢復預計日常使用的 Global Routing 模式。

05 依症狀排查

排查匯入、連線與規則問題

訂閱可以儲存,但分組中沒有伺服器

返回第一步,確認是否選擇了 Subscribe,再確認貼上的是完整連結,而不是訂閱名稱或服務商網頁網址。請留意聊天 App 複製時可能附帶句尾標點,長連結也可能只複製了一部分。使用目前裝置確認基本網路可用,重新匯入一次並等待清單載入;若仍是空的,請向你原有的服務商確認連結是否有效以及回傳格式,不要將含有憑證的網址交給公開測試工具。

開關立即跳回,或中斷後又自動連線

若開關立即跳回,先確認首次 VPN 授權與系統連線狀態;若裝置由公司或學校管理,請勿移除組織下發的設定,先向管理員確認。若問題是手動關閉後又自動連線,請到 Settings 查看是否已啟用 On Demand。排查時先記錄原有設定,在允許的情況下暫時停用隨選連線,使用 Home 開關進行一次手動測試。記錄結果後,恢復所需設定,不必一開始就刪除系統設定。

測速與實際瀏覽結果不一致

到 Settings 查看 Test Method,先記錄目前使用的測試方法,再返回 Home 重新執行 Connectivity Test。瀏覽器可以連線但測試失敗時,請優先區分測試目標與實際瀏覽目標;測試成功但網頁失敗時,先使用 Proxy 與 Config 比較。不要同時更換測試方法、伺服器和網路,否則前後結果無法直接比較。

只有個別目標未依預期分流

在 Config 開啟目前生效的檔案,查看 Rule 中是否有更前面的規則先比對到該網域,或請求最後套用了預設策略。重現問題後,可在 Settings 查看 Diagnostics,將瀏覽時間與目標網域和紀錄對照。修改前先記下原有規則與位置,每次只改一處,再發出新請求重新測試。需要分享排查結果時,只保留必要的模式、時間與錯誤文字,遮蔽伺服器位址、密碼及完整訂閱連結。

連線已能穩定使用後,再依需要閱讀設定詳解,了解 DNS、On Demand 與診斷相關選項;首次連線時不必逐一修改 Settings 中的項目。

Shadowrocket 的 Settings 介面,列出 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
官方截圖 · Settings。遇到自動重新連線時先查看 On Demand;測試方式與診斷入口也在此頁。