官方手冊 / 首次連線
Shadowrocket 使用說明
先匯入既有伺服器,再選擇分流模式並啟用連線。最後透過測試結果和實際存取,確認設定是否生效。
01 / SERVER
新增伺服器或匯入訂閱
先判斷手上的資料是訂閱連結還是單一伺服器資訊。兩者都從 Home 開始,但輸入方式不同:訂閱連結用來取得一組伺服器,單一伺服器資訊則用來建立一個項目。先完成其中一種即可,不必對同一台伺服器重複匯入。
訂閱連結:選擇 Subscribe
複製向服務商取得的完整訂閱連結。在 Home 的 SERVER 分組點選 Add Server,開啟 Type 並選擇 Subscribe,將連結貼到網址欄,再儲存。貼上後檢查開頭、結尾和查詢參數是否完整,尤其不要把連結旁的說明文字一起複製。返回 Home,等待訂閱載入後展開對應分組,確認展開後看得到伺服器項目。若只看到分組名稱但沒有內容,就還不能算匯入完成。
單一伺服器:依 Type 填寫欄位
在 Add Server 中,先依服務商提供的協定選擇 Type,再填寫 Host 和 Port。Host 是主機名稱或 IP 位址,Port 請單獨填寫,不要將訂閱連結或連同連接埠複製的位址填入 Host。截圖中的 Password 和 Method 是目前 Type 的欄位範例;切換協定後欄位可能不同。介面要求密碼、加密方式或其他參數時,請依服務商提供的原始資料填寫,不確定的項目不要用另一種協定的欄位代替。
如果已有服務商提供的伺服器 QR Code,可以在 Add Server 使用 Scan QR Code。辨識後先確認 Type 和位址,再儲存。完整訂閱連結、伺服器密碼和 QR Code 都可能包含憑證,請勿貼到公開貼文,也不要用來製作求助截圖。
返回 Home,在 SERVER 分組選擇本次要驗證的項目。若匯入了多組資料,先比對分組名稱和伺服器名稱,避免接下來測到另一個同名項目。需要整理多個訂閱、處理分享連結或設定更新時,請參閱訂閱與伺服器管理手冊;本次先保留一個明確的測試對象,再進入分流設定。
02 / GLOBAL ROUTING
選擇分流模式
伺服器決定代理連線的目的地,Global Routing 則決定哪些連線交由代理處理。在 Home 點選 Global Routing 進入選擇清單。首次設定只需認識三種模式,依照想驗證的行為選擇:
- 設定(Config):依目前設定中的規則決定連線策略。需要讓不同目標分別走
PROXY或DIRECT時,請選擇此模式。 - 代理(Proxy):讓交由用戶端處理的連線透過代理傳送。適合暫時檢查所選伺服器的代理路徑,不必先判斷測試目標命中了哪一條規則。
- 直連(Direct):讓交由用戶端處理的連線直接傳送,不使用所選的代理伺服器。可用來比對目前網路能否直接存取相同目標。
使用 Config 時,先確認目前設定
選擇設定(Config)後,再到 Config 頁面確認正在使用的檔案。Global Routing 中的 Config 是一種運作模式,底部的 Config 則是檢視和管理設定的入口;選取模式不代表已切換設定檔。開啟目前檔案後,可進入 Rule 檢查測試目標可能符合的規則及其策略。本教學不要求新增規則,先了解既有設定即可。
檢查某個網域時,除了尋找直接寫出該網域的項目,也要查看前面是否有涵蓋該網域的網域後綴規則;若沒有符合前面的條件,再查看最後的 FINAL。若預期行為和既有設定不同,先記下目標、可能符合的規則和策略,不必修改截圖中的其他設定區段。
返回 Home 後,再確認一次 Global Routing 顯示的模式。如果只是暫時使用代理(Proxy)進行比對,請記下原本的模式,驗證完成後再切回。測試時盡量保持伺服器不變,切換模式前後的差異才容易判讀。
03 / HOME
在 Home 啟用連線
啟用開關前,先確認裝置本身能透過目前的 Wi-Fi 或行動網路連線。如果使用需要先完成網頁認證的 Wi-Fi,請先保持 Shadowrocket 關閉,完成該網路的登入後再繼續。這樣可將基礎網路故障和代理連線故障分開,不必在尚未連網時反覆更換伺服器。
確認系統提示,再返回 Home
在 Home 確認 SERVER 中選取的項目和 Global Routing 模式,然後啟用頂端開關。關閉時,截圖中的狀態會顯示 Not Connected。首次啟用時,系統可能詢問是否允許 Shadowrocket 新增 VPN 設定;確認提示是由這次操作觸發且應用程式名稱正確後,再依系統要求確認。完成後返回 Home,等待狀態更新,請勿連續切換開關。
如果先前取消了系統提示,請返回 Home 再啟用開關,留意提示是否重新出現。如果裝置由組織管理,或另一個 VPN 正在使用,請勿直接刪除既有設定。先確認該連線的用途;工作或學校裝置上的限制應由裝置管理員處理。只要開關仍回到 Not Connected,就先處理連線未建立的問題,不必先修改 Rule。
區分連線狀態與存取結果
開關保持啟用,只代表用戶端進入連線狀態,不表示某個網頁一定能開啟,也不表示所有請求都會經過代理。例如,使用直連(Direct)時,開關仍可保持啟用,但這並不能驗證代理伺服器。啟用後先記下目前伺服器、分流模式和使用的網路,再進行下一步的實際測試。
如果裝置在測試過程中切換了 Wi-Fi 和行動網路,請等網路穩定後再測一次。兩次結果對應不同網路時,請先分別記錄,不能直接將差異歸因於設定。首次驗證盡量在同一個網路下完成,確認連線和存取結果後,再檢查網路切換時的行為。
04 / CONNECTIVITY TEST
驗證連線與分流結果
先在 Home 執行 Connectivity Test,再使用平常的瀏覽器或應用程式發出新的請求。兩項都需要進行:Connectivity Test 的結果會受到目前 Test Method 和測試條件影響,不能取代對實際目標的驗證。測試前記下選取的項目和 Global Routing 模式;如果介面列出多筆測試結果,只將目前使用的那一筆記錄為本次結果。
透過實際存取比對設定預期
使用設定(Config)時,從自己的設定中挑選兩個熟悉的目標,一個依規則應走 PROXY,另一個應走 DIRECT。分別重新載入或發出新的請求,避免把先前已開啟的頁面當成本次結果。自行挑選目標時,優先使用能穩定重測的位址,不要只用本身經常逾時或有登入限制的頁面來判斷連線。
如果兩個目標都能開啟,只能表示存取有成功,不能據此判定策略符合預期,因為有些目標透過兩種路徑都能存取。需要進一步確認時,可在 Settings 的 Diagnostics 查看用戶端提供的紀錄;如果有對應請求,請用目標和時間找到同一次存取,再確認紀錄中可見的符合規則或策略。不要把測試完成前就已存在的紀錄當成本次結果。
如果只有一個目標失敗,請保持伺服器和網路不變,在代理(Proxy)與直連(Direct)模式下分別重測相同目標。某個模式能開啟,但在設定(Config)下無法開啟時,優先查看該目標在設定中實際符合的規則;若兩種模式下都失敗,再檢查目標本身和基礎網路。比對結束後恢復原本的模式,再進行一次實際存取,確認日常使用的設定也能正常運作。
05 / SETTINGS
常見連線失敗排查
優先檢查最早出現異常的環節。SERVER 沒有項目時,不必修改分流規則;連線可以啟用但只有部分目標失敗時,也不必先重新匯入整個訂閱。每次只修改一項,使用上一步的相同目標重測,確認這次變更是否真的影響結果。
匯入後沒有可選的伺服器
確認訂閱使用了 Subscribe、連結沒有被截斷,而且目前網路可以連線至服務商提供的位址;若分組存在但沒有項目,先查看訂閱更新是否回報錯誤。手動輸入的項目則檢查 Type 是否與原始資料一致、Host 和 Port 是否填反,以及協定要求的欄位是否齊全。若服務商通知訂閱連結已更換,請向服務商取得新連結後更新原訂閱,避免重複儲存同一個失效位址。
已連線,但測試或存取失敗
先確認 Home 選取的伺服器就是本次要測試的項目,再到 Settings 查看 Test Method。若兩次使用不同的測試方式,結果不宜直接比較。如果 Connectivity Test 失敗但實際存取成功,先確認差異是否只出現在測試目標,不要因此刪除伺服器。若只有少數網域無法開啟,返回 Config 查看符合的規則是否指向 REJECT 或目前無法使用的策略,再到 Diagnostics 尋找同一時間的請求紀錄。看到網域解析錯誤時,再確認目前設定中的 DNS 設定。
切換網路後開關自行變更
如果問題只在 Wi-Fi 和行動網路切換後出現,請到 Settings 查看 On Demand,確認目前網路是否符合既有的連線條件。先記下設定,再選擇在穩定的網路下手動連線並重新測試;手動連線成功後,再單獨檢查隨選條件。若系統持續不允許連線,請返回前一步檢查 VPN 設定確認流程及裝置管理限制,不要以關閉系統保護作為排查方式。
仍無法找出原因時,可在常見問題依下載安裝、匯入訂閱或分流排查尋找相關說明。若要向服務商描述問題,只需說明故障發生在匯入、連線或存取階段,並附上已去識別化的錯誤文字、觸發條件和重測結果。