Shadowrocket 使用教學
匯入既有設定,選擇流量處理方式,再完成連線驗證。
本頁依照 iPhone 與 iPad 的實際操作順序編排。先完成一台伺服器的連線與驗證,再設定其他規則或自動連線;不必一開始就弄懂所有選項。截圖為 App Store 官方展示圖,供辨識介面區域使用;實際入口位置與可選欄位請以目前 App 內顯示為準。
操作流程:Home → Add Server / Subscribe → Global Routing → 連線開關 → Connectivity Test。若某一步沒有出現預期結果,先停在該步檢查,不必繼續修改後續設定。
Add Server 與 Subscribe:新增既有連線資訊
開啟 Shadowrocket,先進入 Home,找到下方的 SERVER 群組。伺服器項目儲存連線至遠端所需的資訊;訂閱則是取得及更新一組伺服器資訊的來源。兩者最後都會影響 Home 中可選取的項目,但新增方式不同。先確認你手上的資料是單一伺服器參數、單筆分享資訊,還是訂閱連結;不要將訂閱網址直接填入 Host。
手動填寫 Add Server
在 Home 點選 Add Server,進入伺服器編輯頁面。先選擇 Type,再依照對應協定填寫欄位;變更 Type 後,所需參數也可能不同。右側官方截圖展示的是包含 Host、Port、Password、Method 的一種表單,不代表所有協定都使用相同欄位。請依照你的伺服器資訊逐項填寫,不要照著截圖補滿所有空欄。
Host 填寫伺服器位址,Port 填寫連線埠。Password、Method 或其他驗證欄位必須與既有資訊相符;若需要 TLS、Server Name、傳輸方式或路徑,也應依原始參數填寫。協定名稱相近不代表參數可以互換,請勿只憑名稱猜測選項。儲存前檢查複製的內容是否包含空格、換行或標點;儲存後返回 Home,確認項目已出現在 SERVER 群組中。
若拿到的是 QR Code,可使用 Scan QR Code 讀取既有連線資訊,再檢查辨識出的 Type、Host 與 Port。Import from Cloud JSON 是另一種匯入方式,只有在你已有符合該入口格式的 JSON 設定時才使用;一般訂閱連結不能因為同樣是網址就填在這裡。匯入成功只代表完成參數輸入,後續仍須選取伺服器並連線。
透過 Subscribe 匯入訂閱
已有訂閱連結時,進入 Config 查看 Subscribe 入口,並依頁面提示新增訂閱來源;若目前介面將訂閱類型放在 Add Server 的 Type 中,請在該入口選擇 Subscribe 後填寫。將完整連結貼入訂閱網址欄位,確認儲存後再執行更新。這裡匯入的是你已有的訂閱,不是向本站取得伺服器。若選單位置不同,請以介面上的 Subscribe 標示及網址欄位用途為準。
等待更新完成後返回 Home,展開相應群組,確認是否出現伺服器項目。只有群組名稱、沒有伺服器,不能算匯入完成;請檢查連結是否複製完整、存取憑據是否仍有效,以及更新時是否顯示錯誤。訂閱內容可能包含多筆記錄,首次驗證只要選一筆參數明確的記錄即可,不要同時編輯整個群組。
訂閱更新通常用於同步遠端提供的記錄,不等於備份本機設定。手動修改過的名稱或參數,之後更新時可能有所變動,因此請先保留原始資訊,避免反覆刪除再匯入。本步完成的標準是:Home 中至少有一台可選取且資訊來源明確的伺服器。訂閱、伺服器與規則檔的差異,請參閱概念速查;確認清單正常後,再進入下一步選擇流量處理方式。
Global Routing:設定檔(Config)、代理(Proxy)、直連(Direct)
伺服器資料新增完成後,返回 Home,點選 Global Routing,查看目前選取的模式。這裡決定流量的處理方式,不會補上伺服器密碼,也無法修復失效的訂閱。請先分清「有可用伺服器」與「流量交由哪種策略處理」這兩件事,後續驗證才有明確依據。
- 設定檔(Config):依目前啟用的規則檔判斷。不同請求可分別交由 PROXY、DIRECT 或其他已定義的策略處理,適合已有規則設定檔的情況。
- 代理(Proxy):將用戶端接管的流量統一交由代理策略處理,可用於暫時確認代理路徑。此模式仍依賴所選伺服器及其參數正常。
- 直連(Direct):將用戶端接管的流量統一以直連方式處理,可用來檢查目前網路的存取情況;選取伺服器不代表此時的流量會經過該伺服器。
若已有用途明確的規則檔,選擇設定檔(Config)前,請先進入 Config 確認該檔案已啟用。開啟檔案可查看 General、Rule、Hosts 等區段;官方截圖展示的是設定檔編輯頁,而非 Global Routing 的模式選擇頁。檔案中出現 General 或 Rule,只代表有相應的設定區域;實際流量去向仍取決於具體內容與順序。
伺服器訂閱與規則檔用途不同:前者主要提供連線記錄,後者決定請求如何比對與分流。匯入訂閱後,不要只因清單中已有伺服器,就認定規則也已準備完成。若暫時沒有可確認的規則檔,可先使用代理(Proxy)進行一次受控的連線驗證,確認伺服器可用後,再切回設定檔(Config)檢查分流。驗證時請留意目前模式,避免將暫時測試設定當成最終設定。
閱讀規則時,先看比對條件,再看策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示依網域後綴比對後交由 PROXY;其中的 example.com 只是語法示例網域,並非連線服務。FINAL,DIRECT 表示前面的規則都未比對成功時交由 DIRECT,通常應放在規則末尾。不要只看到 PROXY,就認為整份檔案中的請求都會經過代理。
首次操作不必同時編輯 DNS、Hosts、URL Rewrite 與 HTTPS Decryption。先保留既有可信設定的內容,確認目前啟用的檔案符合預期,再儲存並返回 Home。協定欄位與傳輸參數的詳細說明請參閱協定參考;本頁只處理完成首次連線所需的選擇。完成本步後,應能清楚說明目前使用的模式,以及接下來的測試請求預期會走代理還是直連。
Home:選取伺服器並開啟連線開關
完成匯入與 Global Routing 設定後,返回 Home,在 SERVER 群組中點選本次要使用的伺服器。請分清「開啟項目編輯頁」與「選取項目」:本步須看到伺服器旁的選取圓點或標記,而不是只進入參數詳細資料頁。群組中有記錄,不代表已實際選取;若有多個訂閱群組,更要確認目前沒有選到其他群組中的舊記錄。
接著再次確認 Global Routing 是否維持上一步選擇的模式。確認無誤後,開啟 Home 頂端的連線開關。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定;這是 Apple 系統為網路接管設定提供的授權流程。確認彈出視窗中的 App 名稱後,依系統提示完成授權;裝置可能要求進行本機身分驗證。尚未完成授權時,請先處理該提示,再返回 App 查看狀態。
此處的 VPN 設定授權與訂閱身分驗證不同:系統授權允許用戶端建立網路通道,伺服器憑據則決定遠端是否接受連線。允許系統彈出視窗,不代表伺服器參數已正確;伺服器密碼正確,也不能取代裝置上的授權。若先前取消了彈出視窗,可再次嘗試開啟開關,依目前系統提示完成操作;請勿為了排除問題而連續新增重複記錄。
授權後返回 Home,觀察頂端狀態是否從 Not Connected 轉為已連線,並確認開關維持開啟。系統的 VPN 標示可作為輔助資訊,但不能作為成功存取的最終證明。如果開關隨即關閉、狀態持續變化或出現明確錯誤,請記下錯誤內容並前往本頁的排查問題,暫時不要同時修改多個進階選項。
連線期間也要留意裝置上是否已有其他啟用中的 VPN 設定,或是否有自動連線設定正在改變連線狀態。首次驗證時,盡量簡化操作條件,先使用手動開關建立穩定連線,再考慮 On Demand。不要只因開關成功開啟就繼續匯入更多訂閱;先完成下一步的 Connectivity Test 與實際瀏覽,確認這筆記錄確實可用。
iPad 上的頁面配置可能因螢幕寬度而有所不同,但操作順序相同:在 Home 選取伺服器、確認 Global Routing,再開啟開關。請依據選取狀態、授權結果與連線狀態這三項判斷本步是否完成,而非要求畫面位置與截圖完全一致。
Connectivity Test:確認連線與分流是否生效
連線狀態穩定後,在 Home 點選 Connectivity Test,等待測試結果。測試可協助判斷目前條件下的連線狀況,但只涵蓋測試採用的目標與方法。單項測試通過,不代表所有網頁和 App 都能正常使用;測試失敗時,也須依所選伺服器、測試方式與目前網路綜合判斷,不能直接歸因於用戶端本身。
接著開啟瀏覽器,前往平常可正常開啟的頁面,確認裝置具備基本網路存取能力,再測試一個依目前設定預期會經過代理的目標。若使用設定檔(Config),還應分別確認預期直連與預期代理的存取結果;若使用代理(Proxy),本次主要驗證代理路徑,不宜據此判斷規則是否依預期命中。在直連(Direct)模式下存取成功,同樣不能證明代理伺服器可用。
為確保比較有效,每次測試盡量維持相同網路、伺服器與目標,只變更一個條件。切換伺服器或 Global Routing 後,可重新發起連線,必要時先關閉舊頁面再重新開啟,減少既有連線與快取造成的干擾。不要同時變更 Wi-Fi 與行動網路、伺服器、DNS 和規則;否則即使恢復存取,也難以判斷是哪一項發揮作用。
若要確認分流情況,可搭配用戶端提供的連線記錄或相關日誌,查看請求命中的規則與策略。先確認請求對應的網域,再確認是否交由預期的 PROXY 或 DIRECT 處理。只看頁面開啟速度、裝置上出現 VPN 標示,或某個測試數值,都不足以單獨判定流量去向。日誌中的網域與瀏覽紀錄可能涉及個人資訊,分享前請適當遮蔽。
若基本存取正常,只有特定目標失敗,請先檢查該目標相關規則與 DNS;若所有存取都失敗,優先檢查伺服器與目前網路。將問題分類到具體環節,比反覆切換整份設定更容易找出原因。其他常見情況請參閱常見問答,不必只為排查單一目標而重做全部匯入步驟。
無法連線:依網路、參數、模式與規則排查
遇到「開關已開啟卻無法存取」時,先保留目前設定與錯誤提示,不要立刻刪除所有伺服器。請清楚記錄狀況:是開關無法保持開啟、Connectivity Test 失敗,還是只有部分頁面無法開啟;問題發生在 Wi-Fi、行動網路,還是兩者皆然。這些資訊有助判斷應從哪個環節開始檢查,也能減少重複操作。
先確認網路與伺服器資訊
暫時關閉連線開關,確認目前網路能否正常存取網頁。如果裝置本身尚未連上網路,請先處理網路登入、訊號或路由器連線,再返回用戶端。基本網路恢復後,重新選取一台既有伺服器,核對 Type、Host、Port 與驗證資訊。使用 TLS 或特定傳輸方式的記錄,也要檢查相應欄位是否完整,不能只確認位址和連接埠。
使用訂閱時,請查看最近一次更新是否成功,以及伺服器是否仍在目前群組中。如果訂閱連結已失效或存取權限有變,請向你的服務商確認既有訂閱狀態。App 購買紀錄無法證明遠端服務仍有效。更新失敗時,先保留舊記錄並檢查錯誤;不要重複建立多個相同來源的群組,以免難以辨認目前選取的項目。
再透過 Global Routing 縮小問題範圍
若在設定檔(Config)模式下連線失敗,可暫時切換至代理(Proxy),維持相同伺服器與目標重新測試。若代理(Proxy)下可以存取,但設定檔(Config)下失敗,應優先檢查啟用中的設定檔、規則順序及相關策略;若兩種模式都失敗,則繼續檢查伺服器參數與遠端連線狀況。這種比較僅用於定位問題,不能只憑一次結果就認定某個環節完全正常。
若在直連(Direct)模式下可以存取某個目標,但代理(Proxy)模式不行,表示兩條路徑的結果不同;應檢查代理路徑,而不是把直連成功當成伺服器測試成功。完成比較後,記得恢復原先預定使用的模式。修改過的規則也應逐項記錄,避免臨時排查設定留在日常設定中。
最後檢查 DNS、設定與診斷記錄
網域存取失敗可能與 DNS 解析有關,但 DNS 並非所有連線問題的通用解法。先確認啟用中設定檔的 DNS 設定是否符合預期,以及最近是否曾修改,再配合錯誤記錄判斷。不要為了快速測試而連續填入多個來源不明的位址,也不要以停用憑證驗證的方式處理驗證或參數錯誤。
進入 Settings 可找到 Test Method、On Demand、Diagnostics,以及 Proxy、TCP、UDP 等相關設定。查看 Diagnostics 中目前可用的診斷項目或記錄,並將錯誤與實際操作時間對照;若調整 Test Method,請留意新舊結果的意義可能不同。首次手動連線尚未穩定前,先不要同時設定 On Demand,以免自動連線條件影響判斷。
若問題只在特定網路或某類請求中出現,請記錄相關條件,再參閱協定參考,了解目前協定的傳輸與參數需求;介面用語不清楚時,可使用概念速查。本頁不要求逐一修改所有進階開關,而是建立可重複的排查順序:基本網路 → 伺服器與訂閱 → Global Routing → DNS 與規則 → 診斷記錄。
需要向你的服務商說明情況時,只提供必要的錯誤文字、使用的協定類型與重新測試條件。傳送截圖前,請移除密碼、完整訂閱網址、驗證識別資訊及其他個人憑據。恢復正常後,再執行一次 Connectivity Test 並進行實際瀏覽驗證,同時記下最終有效的伺服器與模式;確認無誤後,首次設定流程即告完成。