官方手冊 入門操作 / iPhone 與 iPad 介面
Shadowrocket 使用教學訂閱匯入、規則與連線驗證
依「新增 → 選擇模式 → 連線 → 驗證 → 排錯」的順序操作。先確認一台既有伺服器能夠連線,再調整規則;每次只修改一項設定,方便判斷結果。
STEP 01 / ADD SERVER
新增伺服器或匯入既有訂閱
先開啟 Shadowrocket 的 Home,找到 SERVER 清單與 Add Server。既有訂閱連結和單台伺服器參數是兩種不同的輸入資料:訂閱連結用於取得並更新一組伺服器;手動新增則需要逐項填寫一台伺服器的資訊。先判斷手上的資料屬於哪一種,再選擇對應的方式即可,不必兩種都操作一次。
已有訂閱:使用 Subscribe
進入 Add Server,開啟 Type 並選擇 Subscribe,在 URL 中貼上你已有的訂閱網址。貼上後檢查開頭、結尾與換行,避免一併帶入聊天訊息中的說明文字、引號或結尾標點。訂閱網址可能包含存取憑據,請勿將完整網址放進公開截圖,也不要傳給無關的人。
儲存後返回 Home,等待訂閱取得完成,再檢查 SERVER 中是否出現相應群組與伺服器項目。訂閱名稱出現不代表內容已成功取得;應展開群組,確認其中確實有可選的伺服器。若沒有項目,先檢查更新提示,而不是立刻開啟連線開關。訂閱匯入失敗與伺服器連線失敗是不同環節,需分別處理。
之後更新訂閱時,請使用既有訂閱項目的更新操作,而不是反覆新增相同網址。重複匯入容易留下同名群組,使實際選取的伺服器與正在檢查的訂閱不一致。更新前記下目前選取的伺服器,更新後重新確認該項目仍然存在;項目名稱與參數可能隨訂閱內容變動。
已有單台伺服器:依 Type 填寫參數
如果取得的是 Host、Port 與驗證資訊,請在 Add Server 選擇對應的 Type。Shadowsocks、VMess、VLESS、Trojan 等協定的欄位各不相同,不能只填寫位址和連接埠就視為完成。請依據原始伺服器資訊填寫;範例截圖中的 Password、Method 只是所示類型的欄位,不代表每種協定都使用相同表單。
確認 Host 沒有多出空格、Port 完整無誤,且 Password、加密方式或其他驗證欄位與原始資訊一致。若提供的資訊包含 TLS、傳輸方式或伺服器名稱,也需要填入對應選項;不確定的參數應向原資訊提供者確認,不要靠更換協定類型來猜測。
若已有 QR Code,可使用 Scan QR Code;只有資料明確符合相應格式時才使用 Import from Cloud JSON。掃描後仍應檢查辨識結果,尤其是 Type、Host 與 Port。儲存並返回 Home 後,先確認 SERVER 中出現項目,再繼續下一步選擇 Global Routing。更多匯入格式問題請見問答,訂閱更新錯誤請見訂閱失敗診斷。
STEP 02 / GLOBAL ROUTING
選擇 Global Routing 與目前設定檔
新增伺服器後,返回 Home,點選 Global Routing。這裡決定連線如何分配,並非用來更換訂閱網址。先分清三種模式:設定(Config)、代理(Proxy)、直連(Direct)。若希望不同請求依既有規則處理,請使用 Config;若為了定位問題而暫時變更模式,測試結束後應恢復原本的選擇。
設定(Config):依目前規則處理
Config 會使用目前設定檔中的規則,為請求選擇 DIRECT、PROXY 或其他已定義的策略。進入底部的 Config 頁,確認目前使用哪一份設定檔,再查看其中的 Rule。訂閱通常負責伺服器清單,設定檔則負責規則等設定;匯入訂閱後,不應直接推定對應的規則設定也已自動選取。
官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯區段。初次使用時先確認目前設定檔與 Rule,不需要修改所有區段,也不需要為了建立連線而啟用 HTTPS Decryption。已有可用設定檔時,修改前先保留副本,避免排錯時失去原本能正常運作的設定。
代理(Proxy)與直連(Direct):用來區分處理路徑
Proxy 會將連線交由目前的代理策略處理,但無法修復不可用的伺服器。Direct 用於直接連線,不經過所選的代理伺服器;切換到 Direct 後某個頁面能開啟,只表示該頁面的直連路徑可用,不能證明代理已正確設定。這兩種模式適合用來對照,不應視為所有問題的固定解法。
規則通常依序比對。以下僅供認識語法:第一行依網域後綴比對,第二行依 IP 地理歸屬比對,最後一行負責兜底。這不是可整段匯入的完整設定,實際策略名稱必須在你的設定檔中有效。不要為了照抄範例而直接覆蓋現有 Rule,也不要將伺服器位址寫成範例網域。
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
確認設定檔與策略後,返回 Home,再確認一次 Global Routing 顯示的選項。此時先維持規則不變,繼續進行連線測試;若之後出現「Proxy 可用、Config 不可用」,再依據實際請求命中的規則排查。規則語法與策略的深入問題可參閱問答和問題診斷。
STEP 03 / HOME
選擇伺服器並開啟連線開關
返回 Home,在 SERVER 中找到剛才匯入或手動新增的伺服器,並點選準備使用的項目。群組標題與群組內的伺服器不是同一個層級;展開群組後,請確認實際選取的伺服器。若設定檔使用策略群組,也要確認負責該請求的策略沒有指向另一台伺服器,避免誤以為「在清單中點選過」就代表所有請求都會使用它。
開啟頂端 Not Connected 旁的開關。首次連線時,系統會要求新增 VPN 設定,閱讀提示並允許,依系統要求完成裝置驗證,然後返回 Shadowrocket。VPN 設定權限用於建立系統網路連線;允許權限不能取代匯入伺服器的步驟,也不代表伺服器位址和密碼已通過驗證。
返回後觀察頂端連線狀態是否變更,以及開關是否維持開啟。若系統提示尚未完成,請先完成提示,不要在彈出視窗開啟時反覆點選。如果先前拒絕過權限,可再次發起連線並依提示操作;仍無法新增時,請檢查系統是否有裝置管理限制,或是否有其他 VPN 連線正在建立。
開關能維持開啟,只表示本機連線已建立至相應階段,不代表每個目標都能存取。先不要同時更換 DNS、規則與伺服器,維持目前設定進入下一步驗證。需要中斷連線時,關閉 Home 頂端的開關;如果中斷後又自動連線,先記下現象,稍後檢查 Settings 中的 On Demand。
STEP 04 / CONNECTIVITY TEST
驗證連線結果,而不只看開關
先在 Home 使用 Connectivity Test 檢查候選伺服器。測試結果會受 Test Method、測試目標與目前網路影響,因此應在相同測試條件下比較。測試有回應可作為繼續驗證的依據,但不能證明所有網站、所有協定或所有應用程式都已正常運作;單次逾時也需要配合實際存取進一步判斷。
接著開啟瀏覽器,前往你實際需要使用的目標,並重新載入頁面。不要只查看已開啟很久的分頁,因為快取內容可能掩蓋新請求是否成功。再前往一個你確認可直接連線的頁面,用來區分基礎網路是否正常。若基礎網路本身無法使用,請先恢復 Wi-Fi 或行動數據,再繼續檢查用戶端。
若目前使用 Config,需確認目標請求符合哪條規則、最後採用哪個策略。可搭配目前版本提供的請求記錄,查看目標網域與處理結果。Config 下部分連線使用 DIRECT 是規則分流中可能出現的正常情況,不能因為它沒有經過代理就直接判定連線失效。相反地,即使連線開關已開啟,DIRECT 規則命中錯誤也可能導致需要代理的目標無法存取。
若出現「測試有回應,但實際目標無法開啟」,先記下目標、使用的網路、目前模式與伺服器,再一次只調整一項進行對照。例如暫時從 Config 切換到 Proxy,再次前往相同目標:若結果有變化,應優先檢查規則或策略;若沒有變化,再檢查伺服器參數、DNS 或目標本身的狀態。完成對照後恢復原設定,避免留下測試模式。
若實際存取符合預期,首次連線流程就已完成。之後再逐項調整規則與 On Demand,每次修改後重新驗證相同目標。若仍然失敗,請依照下方的症狀分支繼續檢查,不要在沒有記錄的情況下清除所有設定。
STEP 05 / SETTINGS
設定檢查與常見故障
排錯時先回答「在哪個步驟發生問題」:訂閱沒有匯入、伺服器測試逾時、連線開關無法維持,還是連線後只有部分請求失敗。不同症狀對應不同檢查項目。先保留目前設定與錯誤提示,再依照以下順序縮小範圍;暫時不要同時修改伺服器、規則與 DNS,否則很難確認是哪個項目改變了結果。
訂閱更新失敗:先檢查取得環節
確認訂閱網址完整,貼上時沒有多餘空格、換行或標點,並向原資訊提供者確認網址是否仍有效。訂閱回傳空清單、驗證失敗與網路逾時不能混為一談。既有項目仍可使用時,可保留它作為對照;不要因為更新失敗就立刻刪除所有伺服器。詳細流程請見Shadowrocket 訂閱失敗排查。
伺服器逾時:核對參數,再比較網路
重新檢查 Type、Host、Port 與驗證欄位,確認 TLS 與傳輸參數沒有遺漏。維持伺服器參數不變,分別使用可用的 Wi-Fi 與行動數據進行測試;若結果隨網路改變,請優先檢查網路環境。如果同一網路下只有某一台伺服器失敗,應核對該項目的狀態,而不是立刻重設所有系統網路設定。
連線後無法存取:區分規則與 DNS
先確認基礎網路能直接存取正常目標,再比較 Config 與 Proxy 下相同目標的結果。若只在 Config 中失敗,請檢查命中的規則與策略;若症狀是網域無法解析,請查看目前設定檔中的 DNS 設定。不要一次填入多組不明 DNS 位址,也不要把更改 DNS 當成伺服器驗證失敗的解決方式。
頻繁重新連線或耗電:檢查 On Demand
進入 Settings,找到 On Demand,檢查是否設定了自動連線條件。若正在排查自動重新連線,可暫時停用相關條件並手動連線,觀察現象是否改變;測試完成後依實際需求恢復。判斷耗電情況應搭配系統電池統計與使用時段,不能只憑狀態列顯示 VPN 就認定為異常。
Settings 中的 Test Method 會影響 Connectivity Test 的判讀,Diagnostics 可用於進一步收集診斷線索。記錄具體操作與錯誤內容,比反覆切換開關更有幫助。不要為了一次連線測試而隨意修改 Proxy、TCP、UDP 的所有進階選項;只有明確知道某個選項與目前症狀有關時才調整,並記下調整前的值。
iPad 可依照相同的 Home、Config、Settings 介面詞定位;橫向使用時,頁面空間與分欄呈現可能不同,不必依照截圖座標尋找按鈕。若完成基本流程後問題仍然存在,請前往問題診斷依症狀繼續排查;協定與設定項目的概念問題請見協定相關問答。