官方手冊 · 首次設定
Shadowrocket 使用教學 訂閱匯入與連線驗證
先匯入現有資料,再選擇 Global Routing,最後透過實際連線確認結果。本頁說明 iPhone 與 iPad 的首次設定流程;規則語法請參閱規則手冊。
01 新增伺服器或匯入訂閱
先確認手上的資料是哪一種:用於批次讀取伺服器的訂閱連結,或包含協定、位址、連接埠及驗證參數的伺服器資料。兩者在 App 中的輸入方式不同。不要因為資料都是一串文字,就把訂閱網址填進伺服器位址欄;也不要只看網址開頭判斷協定,請以現有資料的說明為準。
透過 Subscribe 匯入現有訂閱
開啟 Shadowrocket,進入 Home,點選右上角的新增按鈕,前往 Add Server。在 Type 中選擇 Subscribe,將自己的完整訂閱連結填入 URL,再替這組項目設定方便辨識的名稱並儲存。貼上後請檢查網址開頭、結尾及參數是否完整,尤其留意聊天訊息中夾帶的空格、換行或標點;這些字元可能使原本有效的網址變成另一個請求。
儲存後返回 Home,等待訂閱讀取完成,再確認是否出現預期的伺服器項目。看得到訂閱名稱,不代表其中的伺服器已成功讀取;請展開對應群組,確認裡面確實有可選取的項目。若清單為空,先確認訂閱連結是否仍有效、目前網路能否讀取該網址,以及服務提供者給的連結是否供用戶端訂閱,而非帳號管理頁面。
訂閱內容可能會隨服務提供者調整而變動。需要重新取得項目時,請更新該訂閱,再確認目前選取的是否仍為預期伺服器。不要反覆新增相同訂閱來取代更新,以免留下多個名稱相似的群組。更新會重新載入訂閱提供的內容,因此不應將對訂閱項目的暫時修改視為長期保存的唯一依據。
透過 Add Server 手動填寫
若持有獨立伺服器資料,同樣進入 Add Server,但此時應在 Type 選擇資料所對應的協定,而非 Subscribe。接著依照該協定顯示的欄位,填寫伺服器位址、連接埠與驗證資訊。Shadowsocks、VMess、VLESS、Trojan 等協定所需參數各不相同,通常不能只填位址和連接埠;請逐項確認加密方式、驗證識別碼、傳輸方式及 TLS 相關設定。
不要將多個欄位合併填寫。例如伺服器位址通常不應包含網頁路徑,連接埠也應分開填寫;TLS 伺服器名稱可能與連線位址不同,請保留資料指定的值。儲存後返回 Home,確認項目名稱和協定符合預期,再點選所需項目。如果有多台伺服器,首次驗證時先固定使用其中一台,避免排查過程中同時更換連線對象。
02 選擇 Global Routing 模式
返回 Home,開啟 Global Routing。這裡的設定檔(Config)、代理(Proxy)、直連(Direct)決定整體連線處理方式,不是三種伺服器協定,也不是速度等級。請先確認這次驗證的目標,再選擇相應模式;若要依網站分流,也須確認 Config 中實際啟用的設定檔包含相應規則。
設定檔(Config):依目前設定檔比對
日常需要依設定檔分流時,請選擇設定檔(Config)。App 會依據目前設定檔中的規則,決定請求使用的策略。進入 Config,確認目前使用的是預定採用的設定檔;若有多份名稱相近的設定檔,不能只因清單中「有這份檔案」就認定它正在生效。請進一步查看規則,確認目標網域對應的策略與預設規則符合需求。
例如,下列片段表示 example.com 及其子網域使用 PROXY,其餘未符合規則的請求則使用 DIRECT。這只是規則語法範例,不含伺服器資料,也不需要為了完成本教學而直接覆寫現有設定檔。使用前請先了解它會改變哪些請求的連線方式。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
規則通常依序比對,具體條件應放在預設規則之前。規則中的 PROXY 代表透過代理處理,DIRECT 表示直接連線,REJECT 表示拒絕;它們與 Global Routing 選單中的模式屬於不同層次。若要深入了解設定檔結構、策略引用與比對順序,請參閱設定檔參考;本頁不展開複雜的規則編輯。
代理(Proxy)與直連(Direct):確認本次驗證目的
選擇代理(Proxy)時,所有請求都會依代理模式處理,而不是逐條依一般分流規則決定連線方式。這適合用來暫時確認目前的代理連線是否可用,但不要把「切換到 Proxy 後可以連線」直接當成「原設定檔沒有問題」:兩種模式的處理路徑不同,結果有差異正好表示需要檢查規則。
選擇直連(Direct)時,請求會直接連線至目標,不使用目前選取的代理伺服器。即使清單中已選取某台伺服器,也不能據此判斷網站是透過它連線。完成一次暫時性比對後,請回到日常使用的模式:需要分流時恢復設定檔(Config),並再次確認目前設定檔,不要長期保留僅供測試而選取的模式。
03 開啟開關並完成連線授權
開始連線前,返回 Home 簡單確認一次:所選伺服器是否正確、Global Routing 是否符合預期,以及使用設定檔(Config)時是否已確認目前設定檔。確認這三項後,再開啟頁面頂端的連線開關。如此一來,之後遇到問題時便能分辨是匯入、選擇,還是連線過程本身出了問題。
首次建立連線時,系統可能會跳出新增 VPN 設定的授權提示。這是允許 App 建立系統網路設定的步驟,不是重新購買 App。請確認這次操作是由剛開啟的 Shadowrocket 發起,再依照系統提示完成授權;若系統要求裝置驗證,直接在系統介面完成即可,不必將裝置驗證資訊填入任何伺服器欄位。
完成授權後返回 Shadowrocket,查看開關與連線狀態。若剛才拒絕授權,或在系統介面中途取消,連線可能無法繼續;請返回 App 重新啟動連線,並依提示完成操作。若裝置上已有其他 VPN 連線,請先確認目前實際啟用的是哪個網路設定,以免將其他連線的狀態誤認為 Shadowrocket 的狀態。
開啟連線開關,只能表示已發起或建立相應的系統連線,不能單獨證明所選伺服器能連線至每個目標。系統的 VPN 狀態標示也不能取代網站連線測試。請維持目前伺服器與模式不變,接著分別使用 Connectivity Test 和實際連線進行驗證,並一併檢視這兩類結果。
首次設定時不必同時調整 On Demand 等自動連線設定。先透過手動開關建立一套可重複驗證的流程,確認連線、規則與目標網站都符合預期後,再考慮自動連線需求。若關閉開關後又自動連線,請檢查是否有自動連線設定正在作用,而非反覆刪除伺服器項目。相關設定可參閱On Demand 功能說明進一步確認。
04 驗證伺服器與實際連線結果
驗證分成兩個階段:先確認所選伺服器是否能回應測試,再確認目標請求是否依預期處理。只看一個測試數值,或只確認某個網頁能否開啟,都不足以判斷整套設定是否正確。前者不能代表所有目標都能連線,後者也可能只是該網站本來就能直接開啟。
先執行 Connectivity Test
在 Home 使用 Connectivity Test,查看所選伺服器的測試結果。測試結果有助於判斷伺服器是否可連線,但不同測試方式測量的對象不盡相同,不宜因一次測得的數值較低,就認為所有網站都會更快。若顯示逾時,先記下目前伺服器與測試方式,再進入下一節排查,不要立刻同時修改協定、規則與 DNS。
若訂閱中有多個項目,請先使用目前項目完成一次測試與實際連線,再決定是否更換。切換伺服器後,應重新查看連線狀態並再次驗證,不能沿用上一個項目的測試結果。測試期間請維持網路環境穩定,避免一邊切換 Wi-Fi、一邊更換伺服器,以免失敗現象失去比較基準。
接著連線至目標,並確認規則與策略
保持 Shadowrocket 連線,開啟瀏覽器前往自己需要使用的目標網站。先確認頁面能否載入,再進行一項實際操作,例如開啟網站中的另一個頁面;舊頁面可能來自快取,無法完整代表新請求的連線結果。不必將教學中的範例網域當作測試網站,範例僅用於說明規則語法。
返回 App,在可用的連線記錄或連線資訊中查看目標請求,重點確認網域、符合的規則及最終策略。使用設定檔(Config)時,應將記錄中的結果與目前規則比對:預期透過代理的請求是否套用 PROXY,預期直連的請求是否套用 DIRECT。若出現 REJECT,應先找出觸發拒絕的規則,而不是直接判定伺服器失效。
也可以進行一次控制變因的比對:固定目標網站與伺服器,只將 Global Routing 從設定檔(Config)暫時改為代理(Proxy),重新連線後再恢復原模式。若兩次結果不同,優先檢查目前設定檔與比對路徑;若兩次都失敗,則繼續檢查伺服器參數、基本網路與目標服務狀態。每次只變更一項條件,排查結果才有參考價值。
05 依照失敗現象逐步排查
排查時先保留目前設定,並記下問題發生在哪個步驟。訂閱讀取失敗、伺服器測試逾時、連線授權失敗、特定網站無法開啟,是四種不同問題。不要用同一個「重新匯入」動作處理所有狀況,也不要一次修改多個參數;每完成一項檢查,就重做原本的驗證步驟,確認現象是否有所改變。
訂閱無法讀取或清單為空
先檢查裝置的基本網路,必要時暫時關閉目前的連線,確認一般網路連線是否正常。接著檢查訂閱 URL 是否完整、是否包含空格,以及手上的連結是否仍有效。若已有部分伺服器項目,先不要刪除整個群組;請先確認更新失敗是否只是這次請求未完成。只有資料確實有變動時,才依照服務提供者最新提供的資訊修改網址。
訂閱連結可能包含個人存取憑證。向他人說明問題時,請優先提供錯誤提示與操作步驟,不要直接傳送完整連結或含有連結的截圖。若需請服務提供者檢查訂閱狀態,可透過既有服務管道確認;本教學不提供替代訂閱,也不會將更換來源列為排查步驟。
Connectivity Test 逾時或伺服器連線失敗
先維持目前網路不變,確認伺服器位址與連接埠,再檢查協定、驗證欄位、傳輸設定及 TLS 參數。欄位看起來相似,不代表可以互換;尤其不要為了讓測試通過而任意關閉驗證相關設定。若只有在特定網路環境下失敗,可改用另一個自己能使用的網路,重複相同測試,以區分環境影響與資料錯誤。
也請確認 iPhone 或 iPad 的日期與時間是否正確。系統時間明顯有誤,可能影響憑證驗證或依賴時間的驗證流程。更新訂閱後若伺服器資料已變動,請重新確認目前項目,再執行測試。重複點選測試無法修正錯誤參數;若無法確認資料是否正確,請保留錯誤訊息並向自己的服務提供者確認。
已建立連線,但目標仍無法開啟
返回 Global Routing,確認沒有誤選直連(Direct)。若代理(Proxy)可以連線,但設定檔(Config)不行,請進入 Config 檢查實際啟用的設定檔、目標網域規則及規則順序。請求可能符合了排序更前面的規則,也可能最後套用 FINAL;只確認規則檔中有某一行,並不足以證明該規則確實被套用。
若只有部分網站無法連線,也請根據連線記錄檢查目標網域、DNS 結果及目標服務本身是否正常。不要因為「某個網站連不上」就直接推斷「所有連線都失敗」。若曾修改設定,請優先還原至最近一次驗證可用的狀態,再逐項恢復變更;更詳細的連線與解析問題請參閱Shadowrocket 連線失敗排查說明。
再次確認並記下可重複執行的步驟
修正完成後,依照「選取伺服器 → 確認 Global Routing → 開啟連線 → Connectivity Test → 實際連線」重新操作一次。成功後只需記住使用的訂閱群組、伺服器名稱與設定檔名稱,不必記錄敏感連結。日後更新訂閱或修改規則,也沿用相同驗證順序,方便判斷變化出在哪個環節。
至此,首次設定的重點已完成:連線資料、處理模式與連線結果能相互對應。若要繼續編輯 DOMAIN、DOMAIN-SUFFIX、GEOIP 或 FINAL,再參閱規則手冊;若問題仍未解決,請依照具體現象查閱常見問題,入門階段不必同時調整所有進階設定。