Add Server:新增伺服器或匯入訂閱
訂閱連結與單一伺服器參數是兩種不同的輸入方式,請依手邊資料選擇一種,不必重複新增。
先確認現有資料的類型
開啟 Shadowrocket,進入 Home,找到 SERVER 分組及 Add Server 入口。先確認手邊資料的類型:若是用來更新伺服器清單的連結,請選擇 Subscribe;若資料分別列出 Host、Port、Password 等參數,請選擇單一伺服器並逐項填寫。不要把整段訂閱連結填入 Host,也不要只憑連結外觀猜測協定。若無法判斷,請先查看現有服務的說明,再繼續操作。
已有訂閱連結:選擇 Subscribe
進入 Add Server,點開 Type,選擇 Subscribe,再將自己的完整訂閱連結填入該類型顯示的網址欄位。貼上後檢查前後是否多出空格、換行或引號,並確認保留問號後的連結參數。確認內容完整後儲存,等待清單載入完成,再回到 Home 查看是否出現相應分組及伺服器項目。儲存訂閱網址不代表清單已成功載入;若清單空白,應先排除載入問題,不要立即開啟連線開關。
更新訂閱會重新取得該網址所提供的內容。首次匯入成功後,可從相應訂閱項目的操作選單執行更新,不必每次都新增相同網址。若現有訂閱仍可使用,調整前請先保留原項目,以免誤刪後無法復原。訂閱連結可能包含存取憑證;截圖或向他人描述問題時,請遮蔽完整連結及其中可識別身分的參數。
已有伺服器參數:逐項填寫 Add Server
在 Type 中選擇與資料相符的協定,再核對 Host、Port,以及該協定要求的身分驗證或加密欄位。官方截圖顯示的是包含 Password 與 Method 的表單,不代表所有協定都需要相同欄位。Shadowsocks、VMess、VLESS、Trojan 等類型應依各自的現有參數填寫;若看到 TLS、傳輸方式或其他選項,也應與原始資料一致,不要照著其他類型的截圖補填。
Host 通常填寫伺服器網域名稱或位址,Port 填寫相應連接埠;不要將網頁路徑附加在 Host 後方。Password 及其他身分欄位須完整複製,並保留大小寫。若持有可辨識伺服器資料的 QR Code,可使用 Scan QR Code 匯入;匯入後仍應檢查 Type 與重要參數。Import from Cloud JSON 是另一種匯入方式,並不等同於 Subscribe。儲存後回到 Home,確認可以選取該項目,再選擇模式。
Global Routing:選擇模式並確認 Config
伺服器決定可用的連線對象,Global Routing 則決定流量如何處理;兩者須分別檢查。
新增完成後回到 Home,點開 Global Routing。請區分三種模式:設定 (Config)、代理 (Proxy)、直連 (Direct)。切換模式不會替你修正伺服器參數,也不會自動取得新的伺服器。首次使用時,先記下目前選擇;後續測試一次只調整一項,才能判斷變化是來自伺服器、模式還是規則。
設定 (Config):依目前設定處理請求
選擇設定 (Config) 時,請求會依目前啟用設定中的規則與策略處理。進入 Config,確認正在使用哪一份檔案,再開啟該設定查看 Rule。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯頁面中的不同區段,Add Rule 用於新增規則。首次連線不必為了「設定完整」而逐一修改這些區段,也不應開啟與目前目的無關的設定。
規則通常依序比對,較前面的符合項目可能先決定請求的處理方式。DOMAIN-SUFFIX 用於比對網域後綴,IP-CIDR 用於比對 IP 網段,FINAL 則用於處理未符合前述規則的請求。PROXY、DIRECT、REJECT 代表不同的處理策略,不是不同的伺服器名稱。排查特定頁面時,須同時考量該頁面使用的網域、比對順序與最終策略,而非只確認某條規則是否存在。
代理 (Proxy):用於比對伺服器連線
代理 (Proxy) 會依此模式處理流量,適合在確認參數後進行一次簡化的連線比對。若同一台伺服器在 Proxy 下可用,切回 Config 後特定頁面卻無法開啟,排查重點應轉向設定、規則與解析流程。這只是縮小檢查範圍的方法,不代表 Proxy 適合所有日常使用情境;測試完成後,請切回所需模式。
直連 (Direct):勿誤當成代理驗證
直連 (Direct) 用於直接存取。在 Direct 模式下頁面可以開啟,並不足以證明剛新增的伺服器可用。連線前請再次確認 Global Routing,避免將直連結果當成代理結果。現有設定檔也不同於 Subscribe:Subscribe 主要用來取得伺服器清單,Config 則負責設定與規則;匯入訂閱不代表已切換至特定規則檔。若想進一步了解比對方式,請閱讀功能與設定說明;特定故障情況請參閱疑難排解。
Home:選擇伺服器並開啟連線開關
先選取項目,再開啟開關;首次連線還須完成系統 VPN 設定授權。
回到 Home,在 SERVER 清單中選取要使用的伺服器,確認目前選取的是預期項目。若清單中有多個分組,請特別核對名稱與來源,以免誤用舊項目。接著再次確認 Global Routing:使用 Config 時,確認已選取設定;使用 Proxy 比對時,確認選取的是本次測試的伺服器。確認以上兩項後,再開啟 Home 頂端的開關。
首次出現系統提示時的處理方式
首次連線時,系統可能會詢問是否允許新增 VPN 設定。這是系統為 App 建立網路連線設定的授權步驟,不是再次購買 App,也不會自動匯入伺服器。確認提示由目前操作的 Shadowrocket 發起後,依照系統指示允許並完成裝置驗證。若先前取消提示,請回到 Home 再次嘗試開啟開關,確認是否重新出現授權流程。
完成授權後回到 App,查看頂端狀態是否從 Not Connected 變為已連線,並留意狀態是否立即恢復原狀。系統中的 VPN 狀態可作為連線設定正在執行的參考,但不能只憑此判斷伺服器、DNS 或特定網頁已可正常使用。連線開關反映用戶端連線流程的狀態;實際請求是否如預期完成,仍須進行下一步驗證。
開啟開關後,先不要繼續變更設定
保持目前的伺服器、Global Routing 與設定不變,先進行一次 Connectivity Test 並實際開啟網頁。首次排查時,可暫停其他正在管理 VPN 連線的設定,再重新連線,避免系統切換連線後誤以為目前項目失敗。不要同時切換伺服器、匯入新設定並修改 DNS;多項變更疊加後,即使恢復正常,也難以判斷真正原因。
若開關立即關閉、反覆跳回,或系統提示未完成,請先處理授權與連線狀態,不必立刻編輯 Rule。若需修改重要連線參數,建議先關閉開關、儲存變更,再重新連線並驗證。既有連線與新儲存的參數可能不屬於同一輪測試;重新連線有助於明確判斷測試對象。完成這些檢查後,再確認實際請求結果。
Connectivity Test:確認回應與實際連線
測試有回應、已建立連線、目標請求成功,是三項須分別確認的結果。
先確認測試結果代表什麼
在 Home 使用 Connectivity Test,等待目前測試完成,並查看所選伺服器是否有回應。測試結果反映的是目前測試方法下的可連線狀況,無法涵蓋每個網站的 DNS、TLS、規則路徑及伺服器處理結果。出現延遲數值,只代表相應測試收到回應,不能據此推論所有網頁都能正常開啟。若要比較兩次結果,請維持相同的網路環境與 Test Method。
再以實際請求確認結果
開啟瀏覽器,重新載入實際需要使用的頁面,並發出一個新的請求。已載入的頁面可能來自快取,只看螢幕上有內容並不可靠;可前往該網站的另一個頁面,或重新嘗試存取。測試時記下目前使用的伺服器與 Global Routing,必要時查看 App 中可見的請求記錄,確認目標網域及採用的策略。若記錄中沒有相應請求,也要先確認是否使用了快取,或測試目標是否一致。
使用 Config 時,一般頁面與目標頁面可能分別透過 DIRECT 和 PROXY 處理,因此一個成功、一個失敗並不矛盾。先確認失敗請求符合哪條規則,再決定是否需要調整設定。若 Proxy 可用而 Config 不可用,請保留伺服器參數,集中檢查規則與 DNS;若兩種模式都失敗,再回頭核對伺服器資料與基本網路。如此可減少不必要的變更,也更容易重現問題。
完成比對後,將 Global Routing 切回日常使用的模式,再對相同頁面測試一次。若只在暫用 Proxy 時成功,切回 Config 後還須驗證規則路徑。到此才算完成從「已匯入項目」到「所需請求可正常完成」的驗證流程;若問題仍在,請依照下一步順序排查,不必重新執行整套匯入流程。
Settings:依故障情況逐項排除
先檢查基本條件,再檢查參數與規則。每次只變更一項條件,並重複相同測試。
清單空白:先檢查匯入與更新
若儲存 Subscribe 後沒有伺服器,請先關閉連線,確認目前網路可正常存取,再檢查連結是否完整、訂閱是否仍有效,以及更新操作是否回報錯誤。清單空白時,變更 Global Routing 通常無法找回項目。不要反覆新增相同連結,造成重複分組;請先保留一筆待確認的項目,再透過現有服務的支援管道確認回傳內容與連結狀態。
項目存在但無法連線:核對欄位與授權
開啟項目編輯頁,對照原始資料檢查 Type、Host、Port、身分欄位、Method,以及所需的 TLS 與傳輸參數。部分欄位只會在特定 Type 下顯示,不要因為截圖中看不到某個欄位就自行更換協定。接著確認系統 VPN 授權已完成,且裝置目前未切換至其他連線設定。若只有一台伺服器連線失敗,請先檢查該項目,不要立刻替換整份 Config。
測試正常但網頁無法開啟:檢查規則與解析
先確認目前不是 Direct,再以同一台伺服器比較 Proxy 與 Config 的存取結果。若只有特定網域無法使用,請檢查是否符合 REJECT、是否被前面的規則提前比對,以及最終策略是否符合預期。DNS 解析失敗也可能出現延遲正常但網頁無法開啟的情況;請檢查目前設定使用的解析方式與可見錯誤,不要只因為逾時就連續更換多組 DNS。更多情境說明請參閱疑難排解。
連線狀態自動變更:檢查 On Demand
前往 Settings,確認 On Demand 是否已啟用及其條件。此功能與按需連線有關,可能影響連線建立時機;首次手動驗證時,請確認設定符合目前測試目的,避免自動連線干擾判斷。Settings 中的 Test Method 會影響測試結果的意義;變更後,不要直接將新舊數值視為同一項比較。TCP、UDP 等區段也不必在首次故障時全部調整,應依實際症狀決定檢查範圍。
保留診斷資訊,不要清除設定
若需進一步釐清問題,請前往 Settings 中的 Diagnostics 查看可用診斷資訊,並記錄錯誤訊息、發生階段及當時使用的模式。準備分享記錄前,請確認內容是否包含伺服器位址、訂閱連結或身分憑證,並予以遮蔽。保留原始設定,記錄每次變更;若操作失敗,先還原上一項變更再嘗試其他方法。App Store 取得、已購項目復原及購買範圍相關問題,請改閱App Store 指南;這些問題與伺服器連線排查是不同流程。
同一台伺服器在相同模式下能重複成功完成實際存取,即可結束本輪排查。之後若要設定 On Demand 或細調 Rule,請先保存目前可正常使用的狀態,再分別調整。如此一來,後續遇到問題時便能回到已驗證的基準,而不必從多項不確定設定重新開始。
完成後的三項確認
- Home 中選取的是預期伺服器,訂閱或手動輸入的參數來自自己的現有資料。
- Global Routing 已切回日常所需模式,Config 使用的是已確認的設定。
- 已重新送出實際頁面請求並成功完成,而非只確認開關已開啟或出現測試數值。
後續可按需閱讀功能與設定或疑難排解。若問題與購買、商店頁面顯示或換機復原有關,請閱讀App Store 指南,不必變更目前已驗證可正常使用的連線參數。