官方手冊 · iPhone / iPad 操作範例
Shadowrocket 使用教學
匯入訂閱、連線與驗證
依照五個步驟完成首次設定:先將既有資料加入 Home,再選擇請求路徑,最後透過測試與實際連線確認結果。首次操作可預留約十分鐘;若遇到失敗,直接跳至對應的檢查項目。
STEP 01 / IMPORT
Add Server:新增伺服器或匯入訂閱
開啟 Shadowrocket 後進入 Home,先辨認下方的 SERVER 區域。這裡會顯示可供選取的伺服器項目;清單中出現名稱,只代表資料已儲存,不代表伺服器目前可用。備妥自己的服務資料後,再進入 Add Server。首次匯入建議只選擇一種方式,完成並確認結果後再新增其他資料,避免同名項目混在一起,難以判斷正在測試哪一個。
有訂閱連結:選擇 Subscribe
- 在 Home 點選新增入口以開啟 Add Server,進入 Type 並選擇 Subscribe。訂閱應使用服務商提供的完整連結,而不是其網站首頁、登入頁面或帳戶管理頁面。
- 將連結貼到對應的 URL 輸入欄位,檢查前後是否混入空格、換行或聊天文字。連結中的參數屬於位址的一部分,不要為了縮短顯示內容而刪除。
- 填寫方便辨認的備註並儲存,等待訂閱讀取完成,再回到 Home 檢查 SERVER 清單。若未產生項目,先查看讀取失敗的提示,不要立刻連續匯入多次。
訂閱是批次讀取伺服器資料的入口。後續更新可能會調整名稱、位址或項目數量,手動修改訂閱產生的內容也可能在更新時被覆寫。因此,第一次應先確認訂閱能正常讀取,再考慮整理分組。訂閱連結通常包含存取憑證,不要將完整連結放在公開截圖、留言或共用文件中;向他人說明錯誤時,應遮蔽驗證資訊。
有單一伺服器資訊:依 Type 逐項填寫
再次進入 Add Server,Type 必須與既有服務資料一致。以截圖中的表單為例,Host 填入伺服器主機名稱或 IP 位址,Port 填入服務連接埠,Password 與 Method 依原始資料填寫;Host 不應混入完整網頁路徑。選擇其他協定後,欄位會隨 Type 改變,不能直接套用某個協定的填寫方式。涉及 TLS、傳輸方式或額外驗證欄位時,應逐項對照伺服器端資料,不要依名稱推測值。
如果已有資料是 QR Code,可使用 Scan QR Code;Import from Cloud JSON 則用於相應的 JSON 資料,並非任意訂閱位址的替代入口。不要為了讓某個連結匯入成功而反覆更換不相符的 Type。儲存後回到 Home,選取本次新增的項目並記下備註,下一步將為這個選取的項目決定請求路徑。
還不清楚訂閱、伺服器與設定檔的差異,可先查閱術語手冊。本步的完成標準是:在 Home 中找到預期項目,而且其協定與連線參數都有明確來源。
STEP 02 / ROUTING
Global Routing:選擇設定檔、代理或直連
新增伺服器項目後,回到 Home 開啟 Global Routing。這裡決定請求依照什麼策略處理,不負責補齊伺服器資料,也不會自動讓無法連線的伺服器恢復可用。三種模式應區分為設定檔(Config) / 代理(Proxy) / 直連(Direct)。選擇前先確認目的:是要驗證既有伺服器能否運作,還是依自己的規則進行日常分流。
- 設定檔(Config):依照目前設定檔中的規則決定請求去向。同一次連線中,不同網域可能分別使用 PROXY、DIRECT 或 REJECT 等策略,結果取決於具體規則及其順序。
- 代理(Proxy):主要請求路徑使用代理策略,適合在排查時減少規則分流造成的變因,但仍須搭配實際設定與系統流量範圍理解結果。
- 直連(Direct):主要請求路徑直接連線至目標,不適合用來證明選取的代理伺服器已生效。開關開啟與請求使用代理是兩項不同的判斷。
使用設定檔(Config)前,先確認目前檔案
進入底部的 Config,查看目前使用的設定檔;需要檢查內容時再進入編輯頁面。官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是不同的設定區段,初次使用時先關注目前檔案與 Rule,不必同時修改所有區段。先備份既有檔案,再查看是否有與目標網域相關的規則。Add Rule 用於新增規則,不是新增伺服器的入口。
以下片段僅用於說明規則順序,並非完整設定,也不包含任何伺服器資料。DOMAIN-SUFFIX 比對指定網域及其子網域,FINAL 則接收前面未命中的請求。若將最終規則放在前面,後續規則可能沒有機會參與比對。範例中只有符合 example.com 的請求使用 PROXY,其餘會進入 DIRECT,不能據此推斷所有連線都應經過代理。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
完成檢查後回到 Home,再確認 Global Routing 顯示的是剛才選擇的模式。首次測試時不要同時切換模式、更換伺服器並替換整份設定,否則即使結果改變,也難以判斷是哪個項目造成影響。規則關鍵字的含義請見術語手冊;DNS、規則引用與更多設定請繼續閱讀Settings 設定參考。
STEP 03 / CONNECT
Home:開啟頂端開關並完成系統授權
回到 Home,先查看 SERVER 中目前選取的項目,再確認 Global Routing。兩者都符合預期後,才開啟頂端連線開關。截圖中的 Not Connected 表示尚未連線,可作為操作前的狀態參考;不要把截圖文字當成操作完成後應維持的結果。如果先前已連線,修改重要參數後應視需要先中斷連線,再重新建立連線,以便觀察新設定的效果。
- 點選 Home 頂端開關。首次使用時,系統可能會要求新增 VPN 設定,確認提示屬於 Shadowrocket 後繼續,並依裝置要求完成密碼或生物辨識確認。
- 授權結束後返回 Shadowrocket,觀察開關是否維持開啟,以及連線狀態是否有所變化。如果取消授權,應重新發起連線,不要略過系統授權就直接修改伺服器密碼。
- 若開關立即回到關閉狀態,先記下提示文字,再檢查系統授權、目前設定與參數。若開關維持開啟但網頁無法瀏覽,繼續下一步驗證,不要將兩類失敗混為一談。
系統 VPN 標示代表裝置已建立相應的網路設定狀態,但不能單獨證明遠端伺服器、網域解析與目標服務都正常。同樣地,Home 的連線狀態與 SERVER 項目是否可用也不是同一件事。必須分別確認「設定已啟用」、「伺服器能回應」與「實際請求使用正確路徑」,避免只看到開關開啟就結束檢查。
測試期間暫時不要啟用複雜的 On Demand 條件,也不要讓其他 VPN 設定同時接管網路。如果關閉後又自動連線,應先到 Settings 檢查 On Demand 條件,而不是反覆切換頂端開關。初次設定的目標是完成一次可重複的手動連線;確認基本路徑可用後,再新增自動連線行為。
到這裡,先保留同一台伺服器、同一種模式與同一份 Config,進入下一步進行驗證。如此一來,若出現問題,後續測試結果才有比較的依據。
STEP 04 / VERIFY
Connectivity Test:測試後再驗證實際連線
保持連線,點選 Home 中的 Connectivity Test,等待測試完成。測試結果有助於判斷目前測試方式下的連線狀況,但測試目標未必與實際要使用的服務相同。不要只依清單中的某個數值判斷所有服務是否正常,也不要把一次逾時直接視為訂閱失效。先確認本次測試的是剛才選取的項目,並留意測試期間網路是否從 Wi-Fi 切換到行動網路。
接著開啟瀏覽器或目標應用程式,發出一次新的請求。優先選擇自己知道正常、且確實需要檢查的服務頁面;若只開啟先前已載入的頁面,快取可能讓結果失去參考價值。可以重新載入頁面,或前往該服務中尚未造訪的內容。實際連線成功後,還應確認目前的 Global Routing:在直連(Direct)下能開啟的頁面,不能用來證明代理路徑已生效。
| 觀察到的結果 | 下一項檢查 |
|---|---|
| 測試失敗,實際連線也失敗 | 檢查裝置網路、伺服器參數與服務狀態,先排除基本連線問題。 |
| 測試成功,只有部分服務失敗 | 確認目標網域的規則、DNS 與目標服務本身的狀態。 |
| 測試失敗,實際連線正常 | 檢查 Settings 中的 Test Method,區分測試條件與服務請求。 |
| 連線已開啟,但請求路徑不符合預期 | 確認 Global Routing、目前 Config 與具體規則比對結果。 |
如果使用設定檔(Config),應搭配可用的記錄檢查目標請求比對到的規則與策略。一個頁面可能會呼叫多個網域,主頁面開啟不代表所有附屬請求都使用相同路徑。排查時只追蹤一個具體的失敗請求,記錄目標主機名稱、使用的網路與目前模式,再回頭查看對應規則。需要調整規則時先備份,修改後重新發出請求,不要依賴舊連線的結果。
本步的完成標準不是某個固定測試數值,而是:連線能維持、自己需要的服務能正常請求,而且規則去向符合預期。若測試結果與實際狀況矛盾,保留這些觀察並進入最後一步,不要直接重新安裝用戶端。
STEP 05 / DIAGNOSE
Settings:依失敗階段逐項檢查
先判斷失敗發生在匯入、連線還是實際請求階段,再進入 Settings 檢查相關項目。截圖中的 Test Method、On Demand、Diagnostics、Proxy、TCP 與 UDP 屬於不同設定範圍,不應為了排錯而全部修改。每次只變更一項,重新連線並重複相同測試;如果沒有改善,就還原原值。保留目前的 Config 與原始服務資料,比盲目清除設定更有助於找出問題。
訂閱讀取失敗,或匯入後清單空白
回到 Add Server 檢查 Type 是否為 Subscribe、連結是否完整,以及是否誤用了網頁位址。確認裝置在目前網路下能存取訂閱位址;讀取訂閱本身也需要網路,不能因為尚未建立代理連線就預設一定能更新。若出現驗證或權限錯誤,應向自己既有的服務商確認資料狀態。不要反覆匯入同一個連結來取代檢查,也不要公開完整的訂閱位址。先前已有可用項目時,先保留它們,避免刪除後失去比對依據。
項目已儲存,但連線或測試失敗
逐項確認 Host、Port、驗證欄位與 Type,特別留意複製時產生的空格和協定不相符。如果資料包含 TLS、傳輸路徑或其他擴充參數,必須與伺服器端一致。再確認裝置本身能正常連網,並在條件允許時更換網路重複相同測試。只有更換網路後結果才改變,表示應繼續檢查網路條件;如果所有網路都失敗,應優先回頭確認伺服器資料與服務狀態,而不是先修改規則。
測試結果異常,或只有部分請求失敗
在 Settings 查看 Test Method,先了解所用的測試方式,再比較 Connectivity Test 與實際連線。某些測試條件下的逾時,不代表所有協定都無法使用。只有特定網域異常時,檢查 Config 中規則的先後順序、是否符合 REJECT,以及 DNS 是否能取得有效結果。TCP 與 UDP 的差異也需要依具體服務判斷,不建議在尚未確認失敗請求類型時任意切換相關設定。
關閉後自動連線,或需要收集診斷資訊
檢查 On Demand 是否有符合目前網路條件的規則,先暫停自動觸發因素,再手動測試頂端開關。需要進一步分析時,可進入 Diagnostics 查看可用的診斷資訊;分享前請遮蔽伺服器位址中的私人資訊、訂閱驗證參數與其他憑證。描述問題時,寫清楚失敗發生的步驟、使用的網路、目前的 Global Routing 及已完成的單項測試,比只提供一張開關截圖更有幫助。
若排查涉及 DNS、Proxy 連接埠或 On Demand 的具體選項,請前往Settings 設定參考繼續閱讀;協定欄位或規則關鍵字可查閱術語手冊。確認可用後儲存目前的設定備份,再整理訂閱與自動連線條件,避免將首次連線與進階調整混在同一輪操作中。