Shadowrocket 使用說明匯入、連線與驗證。
以 iPhone / iPad 介面為例,從既有資料開始操作。先確認伺服器可以連線,再檢查規則是否依預期處理請求;遇到問題時,依相同順序逐項檢查。
新增伺服器或匯入訂閱。先讓資料出現在清單中。
開啟 Shadowrocket,進入 Home。先判斷手邊資料的類型:用來取得伺服器清單的完整連結,通常應以訂閱方式匯入;分別列出的伺服器位址、連接埠、協定與驗證參數,則適合手動填寫。兩種方式擇一即可,不必重複新增同一份資料。匯入成功只代表 App 已讀取資料,尚未證明伺服器可用。
已有訂閱連結:在 Add Server 選擇 Subscribe
在 Home 點選 Add Server,進入後開啟 Type,選擇 Subscribe。將個人完整訂閱連結貼到 URL 欄位,確認開頭與結尾沒有空格、引號或換行,再填寫方便辨識的名稱並儲存。連結可能包含較長的查詢參數,請勿為了縮短顯示內容而刪除問號後的部分,也不要把服務商的登入頁面網址當作訂閱網址。
儲存後返回 Home,等待訂閱內容載入,查看 SERVER 區域是否出現相應群組及伺服器項目。如果只看到群組名稱、裡面沒有可選項目,請先檢查訂閱網址和目前網路,不要立刻反覆新增同一個連結。需要更新既有群組時,請在該群組執行更新操作;若更新失敗,先保留原有項目,以免一併刪除仍可供比對的資料。
已有伺服器參數:依 Type 填寫對應欄位
如果資料是單台伺服器的參數,一樣從 Add Server 進入,但 Type 應選擇資料指定的協定。以 Shadowsocks 為例,對照填寫 Host、Port、Password 與 Method。Host 是伺服器位址,通常不需要加上網頁網址路徑;Port 應與資料完全一致,Method 也應照原值選取,不能只憑名稱相似程度猜測。
不同 Type 顯示的驗證欄位並不相同。資料要求的識別資訊、TLS、傳輸方式或其他選項,都應逐項核對;不能把某個協定的密碼直接填入另一種協定的欄位。已有 QR Code 時可使用 Scan QR Code,匯入後仍需再次檢查 Type 與位址。Import from Cloud JSON 僅適用於格式相符的資料,不是一般訂閱連結的通用貼上入口。
儲存後回到 Home,點選準備使用的伺服器,確認選取標記已移至該項目。至此只完成「資料已新增、目標已選取」,下一步還要決定請求採用哪一種處理模式。訂閱管理與重複項目的詳細處理方式,請參閱常見問題;首次連線前不必同時整理所有群組。
選擇 Global Routing 模式。區分伺服器與規則。
伺服器決定「代理連線交給哪個目標」,Global Routing 則決定「請求採用哪種方式處理」。兩者不是同一項設定。在 Home 點選 Global Routing,查看目前選取的設定 (Config)、代理 (Proxy)、直連 (Direct)。如果出現「開關已開啟,但某些請求仍直接連線」的情況,請先檢查這裡,而不是立刻重新匯入訂閱。
設定 (Config):依目前設定中的規則處理
日常希望依規則分流時,請選擇設定 (Config)。接著切換到底部的 Config 頁面,確認已有並選取準備使用的設定檔。這裡的 Config 頁面與 Global Routing 中名為 Config 的模式有關聯,但用途不同:前者用來管理設定,後者表示連線時採用規則處理。只切換模式,不會自動將遠端規則匯入 App。
進入設定編輯頁後,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。首次使用時先確認 Rule 的內容,不必為了建立連線同時修改每個區段。Add Rule 用來新增規則;修改前應保留原設定副本,並記下原本的規則順序。對於來源不明、用途不清楚的附加設定,請先暫停修改,避免將連線問題與設定問題混在一起。
規則會依序比對,前面的規則命中後,後面的規則通常不會再決定同一個請求的結果。以下兩行僅用來說明規則結構:第一行讓區域網路位址採用 DIRECT,第二行是最終匹配項。這不是伺服器設定,也不是建議直接覆蓋現有檔案的完整設定。其中 PROXY 應依實際設定中的策略意義理解。
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
代理 (Proxy) 與直連 (Direct):明確指定路徑並進行比對
代理 (Proxy) 會讓通常可接管的請求採用代理路徑,可暫時用來判斷問題是否與規則選擇有關,但不應將其理解為所有 App、所有系統流量都一定會經過伺服器。直連 (Direct) 則用來比對直接連線;如果停留在 Direct,即使連線開關已開啟,也不能據此認定請求正在使用所選伺服器。
首次排查時,可以先用 Proxy 比對伺服器連線,再切回 Config 檢查日常規則的運作情況。每次切換都記下目前模式,不要同時更換伺服器、修改規則又切換網路。規則關鍵字與設定管理的延伸問題,請參閱常見問題;App Store 取得與帳號問題另請參閱App Store 指南。
開啟連線開關。完成系統授權後再查看狀態。
回到 Home,先檢查 SERVER 中選取的伺服器,再確認 Global Routing 是否為剛才決定的模式。截圖中的 Not Connected 表示當時尚未建立連線,是用來辨識開關位置的初始狀態,不代表你的裝置必須顯示完全相同的清單內容。
開啟 Home 頂端的連線開關。首次操作時,系統可能會要求允許新增 VPN 設定;請閱讀提示,確認要求由 Shadowrocket 發起,再依照系統要求完成裝置驗證。這個步驟是在裝置上授權建立網路連線設定,並不是要將伺服器密碼填入系統帳號驗證欄位。完成授權後返回 App,等待連線狀態變更;提示尚未處理完時請勿連續點選開關。
如果剛才拒絕了授權,請先返回 App 再次嘗試連線,並檢查系統是否顯示新的提示。仍無法建立連線時,請查看裝置是否受到組織管理政策限制,以及是否有其他 VPN 連線正在執行。不要隨意刪除不熟悉的系統設定;受管理的裝置應先確認使用權限,再依管理要求處理。
開關保持開啟、App 狀態發生變化後,才進入下一步驗證。狀態變化表示本機連線流程有所進展,但不能單獨證明遠端伺服器驗證成功、目標網站可以瀏覽,或規則完全符合預期。反之,如果開關立刻跳回關閉,也不必重新購買或重新安裝,請先記錄系統提示並檢查授權與設定。
首次連線期間,建議維持目前的 Wi-Fi 或行動網路,不要同時啟用新的 On Demand 條件。先完成一次手動連線與中斷,確認基本流程正常,再考慮自動觸發連線。如此一來若發生異常,就能區分是手動連線本身失敗,還是自動連線條件造成反覆切換。
驗證連線是否生效。分別檢視測試結果與實際瀏覽情況。
驗證的第一步不是比較數字,而是確認基本網路。必要時先中斷 Shadowrocket,開啟平時可以直接瀏覽的頁面,確認 Wi-Fi 或行動網路本身正常。如果網路仍在等待登入入口、訊號中斷,或系統限制 App 使用網路,伺服器測試也可能一起失敗;此時應先恢復基本連線。
回到 Home,使用 Connectivity Test 檢查候選伺服器。測試會依目前的 Test Method 執行,因此結果反映的是特定測試條件下的可連線狀況。出現回應數值,不代表目標網頁、影片或其他服務已可正常使用;出現逾時,也不宜只憑一次測試就斷定伺服器資料永久失效。請先確認測試方法,再以相同條件重新測試一次。
接著保持連線開啟,開啟實際需要使用的頁面,觀察是否能完成一次新的載入。只看到瀏覽器中原本已開啟的內容並不足夠,因為內容可能來自快取。可以重新載入頁面,或開啟同一服務中的另一個頁面;如果只有某一個 App 異常,應將問題範圍縮小到該 App、目標位址或相關規則,而不是直接判定整個連線失效。
接著比對 Global Routing。處於 Config 時,目標可能命中 DIRECT、PROXY 或其他已定義策略;頁面能開啟,不一定代表使用了代理。如果需要比對路徑,請維持伺服器與網路不變,暫時切換至 Proxy,再測試相同目標,之後切回 Config。如果 Proxy 正常而 Config 異常,應優先檢查規則與設定;如果兩者都失敗,再檢查伺服器參數、驗證資料與基本網路。
驗證通過後,保留這組已確認可用的設定。之後若調整規則或 On Demand 時出現新問題,就能回到這組基準條件進行比對。訂閱更新、連線逾時與規則問題的詳細說明,可依狀況前往常見問題查找;首次連線時不必一次修改所有設定。
排除常見問題。從資料到網路逐項檢查。
匯入後清單空白,或伺服器突然減少
先確認匯入的是完整訂閱連結,而非介紹頁或帳戶頁面。再確認目前網路能取得訂閱回應,以及個人服務狀態是否允許取得內容。訂閱更新可能改變伺服器數量與名稱,這與 App 的連線開關是兩回事。保留既有群組,向自己的服務商確認連結是否有效後再更新,不要反覆建立群組來嘗試修復同一個位址。
看得到伺服器,但連線持續失敗
開啟該項目的編輯頁,逐項確認 Type、Host、Port 與驗證欄位,留意複製時帶入的空格、大小寫錯誤或遺漏的附加參數。再回到 Home,確認實際選取的是剛檢查的項目,而不是另一個群組中名稱相同的伺服器。如果問題只發生在某一種網路,可在允許的情況下切換 Wi-Fi 或行動網路進行比對,但不要同時變更設定,以免失去判斷依據。
測試有回應,實際頁面仍無法開啟
進入 Settings,查看 Test Method,確認剛才執行的測試類型。測試有回應不代表完整協定交握、DNS 解析和目標服務瀏覽都正常。先測試另一個明確的目標,判斷是單一網站異常還是普遍失敗;再檢查 Config 中的規則與目前的 Global Routing。如果暫時使用 Proxy 就能恢復,而 Config 不行,請優先檢查規則順序與最終匹配項,不要直接修改所有 DNS 或 TLS 設定。
連線反覆變更,或只在切換網路後異常
檢查是否啟用了 On Demand,以及裝置上是否有其他會影響 VPN 連線的設定。為了排除自動觸發條件,可先記下原值,再暫時停用 On Demand,返回手動連線流程重新測試。Wi-Fi 切換至行動網路後發生的中斷,應與切換前的狀態分別記錄;重新連線一次後恢復,不能直接證明原規則有誤。
需要進一步查看時,使用 Diagnostics
Settings 中的 Diagnostics 可用來進一步排查。先保留錯誤發生時的時間、目標與狀態,再查看相關診斷資訊;不必為了「全面排查」而同時修改 Proxy、TCP、UDP 等多項設定。對外描述問題時,只提供必要的錯誤文字與操作順序,並遮蔽訂閱 URL、密碼、驗證識別資訊等敏感內容。分享前也應先檢查診斷資訊。
如果完成以上檢查後仍無法連線,請整理出可重現的操作流程:使用哪種網路、選擇哪個 Type、在哪個步驟失敗、系統或 App 顯示什麼提示,以及 Direct、Proxy、Config 的比對結果。伺服器驗證或訂閱內容問題,請向自己的服務商確認;App 取得與復原問題可參閱App Store 指南,其他操作問題可前往常見問題。這些資訊比「無法使用」更有助於定位問題。