官方手冊 · 初次連線
Shadowrocket 使用教學
本教學以 iPhone / iPad 介面為例。先匯入既有連線資訊,再選擇流量轉送方式,最後以實際存取結果確認設定是否生效。
- 5 個步驟
- Home → Settings
- 以實際存取驗證連線
01 Add Server
新增伺服器或匯入訂閱
開啟 Shadowrocket,從 Home 找到 SERVER 區域,點選 Add Server。先確認手上的資訊類型:單台伺服器通常包含協定、主機位址、連接埠與驗證欄位;訂閱則是用來取得伺服器清單的連結。依照實際取得的資料選擇一種方式即可,不必先手動新增伺服器再匯入訂閱。
已有單台伺服器資訊
在 Add Server 中先選擇 Type,再依服務商提供的資訊填寫。以 Shadowsocks 為例,Host 對應主機位址,Port 對應連接埠,Password 和 Method 分別對應密碼與加密方式。切換 Type 後欄位可能有所不同,請以所選協定顯示的欄位為準,不要照搬其他協定的參數。貼上位址或驗證資訊時,請檢查是否多帶空格、換行或引號;若缺少必填項目,先核對原始資料,不要猜測補值。
已有訂閱連結
在 Add Server 將 Type 設為 Subscribe,將完整訂閱連結貼到連結欄位後儲存。連結中的問號及其後的參數也屬於連結的一部分,不要只複製到網域或路徑。返回 Home,查看 SERVER 下是否出現匯入的訂閱記錄。若只有群組而沒有可選伺服器,可在群組中查看更新或錯誤提示,確認匯入結果後再繼續。提供排查截圖時,請勿包含完整訂閱連結或驗證欄位。
無論使用哪種方式,下一步都相同:在 SERVER 中點選要使用的伺服器,確認選取標記位於該項目上。清單中看得到不代表已選取,已選取也不代表已連線。選定後先維持目前網路,不急著開啟開關,接著確認 Global Routing。
02 Global Routing
選擇流量分流模式
返回 Home,點選 Global Routing。這裡控制連線建立後,進入 Shadowrocket 的請求要如何處理;它不負責選擇伺服器,也不會因切換模式而自動修正伺服器資訊。首次依既有規則使用時,可先選擇設定(Config);若要排查特定請求會走哪條路徑,再短暫使用另外兩種模式進行比對。
- 設定(Config):依目前設定檔的規則決定如何處理請求。有些請求會走代理,有些會直接存取,也可能依設定遭到拒絕。連線後仍有部分流量直接連線,並不代表規則未生效。
- 代理(Proxy):將此模式處理的流量交由所選代理伺服器。適合在伺服器不變時,與設定模式比對,判斷特定目標是否能透過代理路徑存取。
- 直連(Direct):不透過所選代理伺服器轉送。這與關閉 Home 頂端開關不同:連線可以維持啟用,改變的是請求的轉送方式。
若選了 Config,卻不確定目前使用哪份設定,先前往 Config 頁面確認目前啟用的檔案,再開啟檔案查看 Rule。截圖中的 General、Rule、Hosts 等是檔案編輯頁的區段,不是 Home 上 Global Routing 的選項。已有明確可用的設定時,初次連線不必立刻修改規則;若不確定,先記下目前使用的檔案與模式,避免設定與伺服器同時變動。
例如,規則中的 DOMAIN-SUFFIX,example.com,PROXY 表示將符合該網域後綴的請求交由 PROXY 處理;這行範例用來解讀規則,不是要新增的伺服器。想了解規則順序與 FINAL,可查看名詞解釋。選好模式後,返回 Home 檢查 Global Routing 顯示值是否符合預期,再進入連線步驟。
03 Home
開啟 Home 頂端開關
開啟開關前,請在 Home 確認兩處:SERVER 下選取的項目是否為剛才準備使用的伺服器,以及 Global Routing 是否為剛選好的模式。截圖中的 Not Connected 表示尚未建立連線。確認後點選頂端開關,等待連線狀態穩定,切換狀態期間不要反覆操作開關或更換伺服器。
首次建立連線時,系統可能會要求允許 Shadowrocket 新增 VPN 設定。確認提示是由剛才在 Shadowrocket 中發起的操作所觸發,再依系統指示授權;若系統要求進一步驗證,請依裝置提示完成後返回 Home。若先前取消了提示,伺服器資訊填妥後連線也不會自動啟用。可在 Home 再次發起連線;若仍無法完成,先確認系統 VPN 設定與裝置管理限制。
若連線剛啟用就回到未連線狀態,先保留目前的伺服器與模式,並記下當時是否出現提示。檢查系統中是否有其他 VPN 正在運作;在你有權限且不會影響必要網路存取的情況下,再處理衝突。若使用的是工作或學校管理的裝置,請勿移除管理設定,並向管理員確認是否允許新增 VPN。
頂端開關維持開啟,只表示裝置已啟用這次連線,不能證明伺服器可用,也不能證明某個請求符合預期規則。此時請維持相同 Wi‑Fi 或行動網路,進入下一步測試,較容易區分測試結果與之後的比對結果。
04 Connectivity Test
驗證伺服器與實際存取
在 Home 點選 Connectivity Test,查看剛選取的伺服器對應結果,不要將同一群組中其他項目的結果當成此次連線的結果。記錄測試是否有回傳結果、目前使用的網路,以及 Global Routing 的目前值。同一台伺服器在不同網路下可能有不同表現;若要比較前後結果,應先在相同網路、同一台伺服器上完成一次,再決定是否更換網路。
接著開啟平時可存取的頁面,主動重新整理或開啟尚未載入過的頁面。只看到舊分頁仍顯示內容,不能代表新的請求已成功。若使用 Config,盡量分別檢查一個依規則應直接連線的目標,以及一個應透過代理的目標。若目前沒有能辨識這兩種路徑的規則,只記錄實際存取是否成功,不要依一次存取結果判定分流正確。
遇到特定目標無法開啟時,可保留同一台伺服器,暫時切換至 Proxy 並重試相同目標。若 Proxy 下可存取、Config 下失敗,優先確認啟用的設定、網域比對情況與未符合規則時的預設策略;不必立即修改伺服器參數。若同一目標在不同模式下都失敗,也不能只憑這點判定是伺服器問題,還要檢查本地網路與目標本身是否正常。比對完成後,將 Global Routing 恢復為日常使用的模式。
05 Settings
依症狀排查連線失敗
從最早未通過的步驟開始檢查。先留下簡要記錄:網路類型、Home 開關能否維持開啟、是否有選取項目,以及測試結果。接著開啟 Settings 查看 Test Method;若要比較兩次測試結果,先維持測試方式一致。需要進一步確認失敗發生在哪個階段時,再進入 Diagnostics,避免找到原因前同時修改多項設定。
訂閱已儲存,但沒有伺服器
返回 Home 查看訂閱群組是否已有可選項目。若清單為空,檢查 Type 是否為 Subscribe、連結是否完整,以及更新時是否出現取得失敗的提示。若服務商提供了替代連結,先確認不是同一條已過期的連結,再使用新連結更新。若仍無結果,請向自己的服務商確認連結狀態與匯入方式;在清單出現可選伺服器前,調整 Global Routing 無法解決匯入問題。
開關無法維持開啟,或離開 Home 後狀態改變
先分辨是手動開啟開關時就失敗,還是開啟後切換網路才發生變化。前者優先檢查系統 VPN 授權與衝突;後者可前往 Settings 確認 On Demand 是否已啟用,以及目前網路是否符合既有條件。若確認需要排除 On Demand 的影響,可先記錄原設定,再以手動連線進行一次比對,測試後恢復原設定。
伺服器測試失敗,或只有特定目標無法開啟
測試失敗時,先確認裝置在未連線 Shadowrocket 時能否正常上網,再核對所選伺服器的 Type、Host、Port 與驗證欄位是否符合服務商提供的資料。若伺服器測試有結果,但只有特定目標失敗,返回驗證步驟,以相同目標比對 Config 與 Proxy,並依結果檢查規則。每次只修改一項,再重試相同測試;否則即使問題排除,也無法判斷是哪項修改生效。
需要他人協助時,提供錯誤原文、發生步驟與已進行的比對即可,請勿附上完整伺服器憑證或訂閱連結。常見情況請參閱常見問題;若要進一步了解 Test Method、On Demand 或 Diagnostics,可查看選項手冊。