Shadowrocket 官方手冊 / 使用教學

Shadowrocket
匯入、連線與驗證

以 iPhone / iPad 介面為例,依五個步驟完成首次連線。先確認伺服器可連線,再確認規則如何處理請求。

已有可用的伺服器項目時,可以從第二步繼續。尚未完成安裝,請先閱讀下載與首次開啟說明,不要將系統安裝提示與應用程式內的連線錯誤混為一談。

STEP 01 / IMPORT

新增伺服器或匯入訂閱

先分辨手上的資訊類型,再選擇入口。單一伺服器通常包含協定類型、伺服器位址、連接埠以及密碼或身分欄位;訂閱連結則用於取得一組伺服器項目;設定檔還可能包含規則、策略和其他設定。這三者用途不同,不能只憑連結外觀判斷。請依據自己已有服務資訊的說明操作,避免將設定檔位址填入伺服器位址欄,或把網頁介紹位址當成訂閱位址。

使用 Add Server 手動填寫

開啟 Shadowrocket,進入 Home,點選右上角的新增入口進入 Add Server。先選擇與既有伺服器相同的協定類型,再逐項填寫位址、連接埠和驗證資訊。協定類型會決定後續顯示哪些欄位,因此應先選類型再填內容;不要因為某個欄位暫時看不懂,就改用名稱相近的協定嘗試儲存。不同協定的參數不可互相替代。

填寫時請特別確認伺服器位址是否誤帶空格、連接埠是否完整,以及密碼或身分欄位是否保留原有大小寫。若服務資訊還提供傳輸方式、TLS、伺服器名稱或路徑,應依原始說明對應填寫,不能只保留位址和密碼。儲存後返回 Home,在 SERVER 清單中確認新項目已出現。此時只代表完成儲存,尚未證明伺服器可以連線。

使用 Subscribe 匯入既有訂閱

已有訂閱連結時,進入 Config 頁面,找到 Subscribe 對應的訂閱操作入口,依提示貼上完整連結並確認取得。連結經常包含查詢參數,複製時應保留完整內容,不要只複製網域,也不要把聊天訊息中的說明文字一起貼上。若系統要求讀取剪貼簿,請先確認剪貼簿內容是這次需要匯入的資訊,再允許讀取。

取得完成後返回 Home,檢查 SERVER 清單是否出現訂閱對應的伺服器項目。如果只是 Config 中多出一個設定檔,而 Home 中仍沒有可選伺服器,應先核對匯入內容的類型,不能將「檔案已下載」視為「伺服器已匯入」。不同介面配置的入口位置可能略有差異,重點是確認操作對象究竟是伺服器訂閱還是設定檔。

掃描 QR Code 與匯入後檢查

手上已有伺服器 QR Code 時,可以在 Home 的掃描入口使用 Scan QR Code。首次使用時依系統提示授予相機權限,辨識後先檢查解析出的協定與位址,再確認新增。QR Code 和訂閱連結都可能包含驗證資訊,不應發布到公開討論區,也不應將完整內容放入問題排查截圖。匯入後先選取一個明確項目繼續下一步,不必反覆匯入同一份訂閱;重複項目會增加後續判斷的難度。

此階段的完成標準是:Home 中有預期的伺服器,且可以查看其類型和必要參數。訂閱連結無法辨識、更新後項目為空等情況,留到第五步依取得流程排查;入口差異可另參閱四種匯入入口說明。

STEP 02 / ROUTING

選擇 Global Routing 模式

新增伺服器項目後,下一步是決定如何處理請求。返回 Home,開啟 Global Routing,檢查目前選項。此處的三種模式是設定(Config) / 代理(Proxy) / 直連(Direct)。它們控制請求的處理方式,不代表三種連線品質,也不會修改伺服器本身的協定或驗證參數。

設定(Config):依目前設定處理

選擇設定(Config)時,請求會交由目前啟用的設定規則判斷。請前往 Config 檢查實際選取的檔案,而不只是確認檔案清單中有某份設定。下載到本機與設為目前使用的設定是兩件事;編輯另一份未啟用的檔案,也不會改變正在使用的規則。首次使用時,應選擇自己了解用途的既有設定,先保留原始內容,避免同時修改大量規則後無法判斷問題來源。

規則通常由上往下比對,符合後採用對應策略。PROXY 表示交由相應代理策略處理,DIRECT 表示直連,REJECT 表示拒絕;末尾的 FINAL 用於處理前面未符合的請求。策略的實際指向還需配合目前設定檢查,因此「選擇 Config」不等於「所有請求都經過目前的伺服器」。

代理(Proxy):先判斷伺服器路徑

選擇代理(Proxy)適合進行一次範圍明確的連線驗證:在相同網路下選定一台伺服器,再測試一個明確的目標。如果 Proxy 可以存取,而 Config 不行,排查重點應轉向設定檔、規則和策略指向,而不是立刻重新填寫伺服器。測試結束後,依日常用途切回需要的模式,避免長期保留暫時的驗證狀態。

直連(Direct):區分本地網路結果

選擇直連(Direct)時,一般請求不會交由所選代理伺服器處理。這有助於比較基本網路與代理路徑,但不能據此判斷遠端伺服器是否正常。若預期目標請求會經過代理,目前卻選擇 Direct,即使連線開關已開啟,得到的也可能仍是直連結果。記下目前選項後再繼續,後續每次驗證都應明確維持這個條件。

不確定從何開始時,可先用 Proxy 判斷既有伺服器能否處理目標請求,再用 Config 驗證規則。此處不需要編寫完整設定;各設定項用途請見Global Routing 設定說明,協定參數含義請見協定參考。

STEP 03 / CONNECT

選擇伺服器並開啟連線開關

返回 Home,在 SERVER 清單中明確選取準備使用的伺服器。不要把「剛匯入的項目」自動視為「目前已選取的項目」,應再次確認清單中的選取標記。若伺服器較多,先固定一個項目完成驗證,暫時不要切換其他伺服器,才能將連線結果與特定參數對應起來。

連線前可使用 Connectivity Test 觀察測試結果。測試回傳時間值,表示在該次測試條件下收到回應,不代表所有網站、所有應用程式與所有請求都一定成功;出現逾時,也應結合測試方式和實際存取繼續判斷。測試結果可用來縮小排查範圍,不能取代下一步的頁面存取驗證。請避免只比較顯示數值的大小,卻未確認伺服器是否能完成實際請求。

確認伺服器與 Global Routing 後,開啟 Home 的連線開關。首次連線時,系統會詢問是否允許新增 VPN 設定;確認正在操作的應用程式後選擇允許,並依系統要求完成裝置密碼或其他身分驗證。此授權用於建立系統網路連線設定,與伺服器的密碼欄位不是同一項資訊,不要將裝置密碼填入 Add Server。

完成授權後返回 Home,檢查開關是否維持開啟,再查看系統連線狀態。若開關立刻回到關閉狀態,先確認是否有設定錯誤、權限提示或其他連線正在占用,不要連續快速切換。可以先關閉其他正在執行的 VPN 連線,再回到 Shadowrocket 重試;每次只保留一個明確的測試狀態,避免系統連線互相切換造成誤判。

連線開關維持開啟,表示用戶端已進入連線狀態,不等於遠端驗證成功,也不等於目標請求已依預期分流。此時先不要修改 DNS、規則和協定參數,維持目前條件進入下一步,以實際請求進行驗證。若確實需要更換伺服器,請記下更換前的項目和現象,再重新執行相同的檢查流程。

STEP 04 / VERIFY

驗證實際存取與規則結果

驗證分為三個層次:開關是否開啟、目標是否可存取、目標是否採用預期策略。只查看系統 VPN 標記,最多只能確認系統連線處於某種活動狀態;只看某個頁面能開啟,也可能是該目標原本就可以直連。應將實際存取結果與目前的 Global Routing、所選伺服器和請求記錄一起判斷。

重新發出一個明確的請求

在瀏覽器開啟你有權存取、且知道正常狀態的目標頁面,重新載入並等待結果。盡量使用新發出的請求,不要只觀察已載入的頁面或應用程式快取內容。首次驗證時維持相同網路、相同伺服器和相同目標,記錄頁面是正常回應、長時間等待,還是出現明確錯誤。不同結果所指向的排查方向並不相同。

使用 Data 核對請求去向

返回 Shadowrocket,查看 Data 中與這次存取相對應的請求記錄或連線資訊,依請求發生時間和目標網域定位。留意實際採用的策略、可見的規則比對結果及伺服器指向,而不只是查看流量是否變化。裝置背景也可能產生請求,因此總流量增加不能單獨證明剛才測試的目標已經經過代理。

使用 Config 時,若記錄顯示 DIRECT,而預期是 PROXY,應返回目前啟用的設定檢查規則。先確認目標網域是否符合規則,再查看前面是否有更早符合的項目,最後檢查策略指向。一個頁面可能會請求多個網域,首頁文件、圖片與介面不一定符合相同規則;只修改頁面網址對應的規則,不一定能改變所有子請求。

透過單一變因比較縮小範圍

若在 Config 下存取失敗,可維持相同伺服器不變,暫時切換至 Proxy 後重複請求。Proxy 成功、Config 失敗時,優先檢查規則和目前設定;兩者都失敗時,再考慮伺服器參數、網路連線或目標本身。比較完成後恢復預期模式,並再次驗證存取。不要同時切換網路、伺服器與設定,否則即使恢復正常,也無法判斷是哪項變更產生作用。

完成標準是:實際目標存取符合預期,請求記錄中的策略也與預期一致。若需要向他人描述問題,只記錄必要的目標現象、模式和錯誤文字,並隱藏伺服器驗證欄位與訂閱連結。如需進一步了解規則順序,請閱讀自訂規則與 FINAL 後備規則說明。

STEP 05 / TROUBLESHOOT

依問題發生階段逐項排查

發生問題時,先判斷停在哪個階段:訂閱未匯入、伺服器測試失敗、開關無法維持開啟,或是開關正常但目標存取失敗。不同階段不要混用處理方式。尤其不要一遇到逾時就刪除所有設定或重新安裝應用程式,這會失去原有的比較條件,也無法修復失效的伺服器資訊。

基本網路與訂閱取得

先暫時關閉連線,確認裝置目前的 Wi-Fi 或行動網路本身可用;需要登入的網路應先完成登入。基本網路正常後,再檢查訂閱連結是否完整、是否仍有效,以及取得訂閱時是否回報錯誤。匯入後項目為空,應核對服務資訊是否已變更,或回傳內容是否仍為支援的格式。更新失敗時,先保留原有可用項目,不要連續重複新增而產生更多副本。

更新訂閱是取得新的伺服器清單,Connectivity Test 則是測試項目的連線狀況,兩者並非相同操作。更新成功但伺服器仍逾時,應繼續檢查伺服器;更新失敗但舊項目仍可連線,也不能據此判定所有連線都已失效。更新入口和失敗原因另請參閱手動與自動更新訂閱說明。

伺服器逾時或驗證失敗

返回 Add Server 對應的編輯介面,依既有服務資訊逐項核對協定、位址、連接埠和驗證欄位,再檢查 TLS、伺服器名稱、傳輸方式與路徑。不要自行省略看似可選、但伺服器端實際要求的欄位。若系統時間明顯不正確,先校正時間再測試;時間偏差可能影響憑證或驗證判斷。必要時可在自己有權使用的另一種網路下測試同一台伺服器,以區分本地網路差異。

測試持續失敗時,應向你既有服務的提供者確認伺服器狀態及參數是否變更;提供現象與錯誤文字即可,不要公開完整連結或驗證內容。更換密碼、切換協定等操作應有明確依據,不能靠反覆隨機修改尋找可用組合。完整排查順序請參閱伺服器逾時與連線失敗檢查清單。

開關正常但存取結果不符預期

先檢查 Global Routing 是否誤選 Direct,再確認 Config 目前啟用的檔案。若 Proxy 正常而 Config 異常,請依照「目標請求 → 首個符合的規則 → 策略指向」的順序檢查。若只有某個目標異常,核對該目標的網域解析與請求記錄,不要立刻修改所有 DNS 設定;修改前記下原值,每次只改一項,再重複相同請求。

如果頁面文件可以開啟,但圖片或介面失敗,應分別查看失敗資源對應的網域,而不是把整個頁面視為單一連線。若系統授權尚未完成,應先處理授權;若開關穩定但遠端沒有回應,則應檢查伺服器和請求路徑。準確判斷故障所在層級,比同時更改多項設定更容易恢復,也更容易保留可重現的結果。

結束測試並保留可用狀態

連線恢復後,確認目前伺服器、Global Routing 和啟用設定都是準備長期使用的組合,並還原僅為定位問題而新增的暫時修改。不需要連線時,可返回 Home 關閉開關;再次使用時,重新確認伺服器選取狀態並開啟即可。常見入口和權限問題可繼續參閱FAQ,協定欄位的詳細含義請參閱協定參考,首次連線時不必一次調整所有進階設定。