官方手冊 / 首次連線
Shadowrocket
匯入訂閱與首次連線教學
先將現有伺服器加入 Home,再選擇 Global Routing、開啟連線開關,最後驗證實際連線。首次操作可依照下方五個步驟逐項完成,不必同時變更所有設定。
準備資料:區分訂閱、伺服器與 Config
先確認手上的資料屬於哪一種。訂閱連結通常用於一次匯入並更新一組伺服器;單一伺服器資料則包含協定類型、位址、連接埠與驗證欄位;Config 設定檔主要決定規則、DNS 與策略等行為。三者用途不同,若將設定檔網址當作伺服器訂閱填入,可能導致匯入失敗或沒有伺服器項目。
請將服務提供者給的原始說明保存在方便核對的位置。訂閱連結可能包含帳戶憑證,應完整複製,不要公開於留言、截圖或聊天室。手動填寫時,協定類型必須與資料一致;只有伺服器位址和連接埠通常不足以完成設定。資料不完整時,請先向原服務提供者確認欄位含義,不要自行猜測補齊。
開始前也應確認裝置本身可以正常連線。如果目前的 Wi-Fi 需要網頁認證,請先完成認證;若關閉 Shadowrocket 後仍無法開啟一般網頁,請先處理基本網路問題。如此一來,後續發生失敗時才能區分裝置網路與伺服器設定問題。以下從在 Home 建立第一個可選項目開始。
01 · Add Server:新增伺服器或匯入訂閱
已有訂閱連結:選擇 Subscribe
開啟 Shadowrocket,進入底部的 Home,點選右上角加號進入 Add Server。在類型選擇中找到 Subscribe,再將現有訂閱連結完整貼到 URL 欄位。若有備註欄位,可填入方便自己辨識的名稱,以利日後區分來源;備註僅供本機辨識,無法修復連結本身的問題。
儲存前請檢查連結首尾是否混入空格、換行或說明文字,尤其不要只複製聊天介面中遭截斷的顯示文字。確認後點選頁面上的儲存按鈕,返回 Home,等待讀取訂閱內容。判斷是否匯入成功,應以清單中出現實際伺服器項目為準,而不只是出現訂閱名稱。此時可繼續關閉連線開關。
如果只看到訂閱群組,卻沒有伺服器,請先使用該訂閱項目提供的更新功能,並查看是否顯示錯誤。連結失效、驗證資訊不完整、基本網路無法連線至訂閱網址,都可能導致讀取不到內容。不要重複新增相同連結,造成多個重複群組;保留一份,核對原始 URL 與原服務提供者的使用說明即可。
已有單一伺服器資料:依協定填寫
如果收到的是單一伺服器參數,同樣從 Home 的加號進入 Add Server,但類型應選擇資料指定的 Shadowsocks、VMess、VLESS、Trojan 或其他對應協定,而不是 Subscribe。依原始資料填寫位址、連接埠及驗證資訊,再逐項核對 TLS、傳輸方式等附加欄位。欄位是否需要填寫,取決於協定與伺服器端設定,不能因為介面允許留白就一律省略。
如果服務提供者提供可供客戶端辨識的 QR Code,可以使用 Scan QR Code。首次掃描時,請依系統提示允許存取相機;掃描後仍須檢查辨識出的類型與欄位,再儲存。QR Code 也可能包含連線憑證,不宜展示給他人。如果掃描後得到的只是一般網頁網址,請回到原始說明確認用途,不要勉強將它當作伺服器資料匯入。
完成其中一種匯入方式後,返回 Home,確認找得到要使用的伺服器。這只表示「資料已儲存」,還不能證明伺服器已連線。下一步需要指定預設伺服器與請求的路由模式,這兩項會決定連線後如何處理流量。
02 · Global Routing:先選伺服器,再選模式
在 Home 的伺服器清單中,點選目標伺服器左側的圓點,將其設為目前選取的伺服器。點選伺服器名稱或詳細資料入口可能會進入編輯頁面,不一定代表已完成選取;返回 Home 後,請再次確認圓點位置。訂閱中有多個項目時,首次先選定一個,不要一邊切換伺服器,一邊修改其他設定。
接著開啟 Home 中的 Global Routing。三種常見模式分別是配置(Config) / 代理(Proxy) / 直連(Direct)。它們會影響請求採用的策略,不會變更伺服器帳戶本身,也無法讓已失效的伺服器資料恢復使用。
配置(Config):依目前設定檔分流
配置(Config)適合需要依目標分流的日常使用。選擇後,請前往 Config 頁面確認目前啟用的設定檔,並了解它會將哪些請求交由 PROXY 處理、哪些交由 DIRECT 處理。只在 Config 頁面看到檔案,不代表該檔案已啟用;請確認目前選取的狀態。若資料中提供了相應設定檔,請先閱讀用途,再決定是否匯入並啟用。
規則會依比對順序處理,特定目標可能在遇到 FINAL 前就已符合其他規則。因此,使用 Config 模式時,某個網站可以開啟,不代表該網站一定經過代理。初次使用不必立刻撰寫完整規則,只要了解目前使用的設定檔及其大致分流方式即可。若要深入了解設定檔修改與協定欄位,請參閱協定參考;相關操作也可在設定說明中核對。
代理(Proxy)與直連(Direct):用於區分連線路徑
代理(Proxy)主要讓客戶端處理的請求採用代理路徑,方便初步檢查所選伺服器是否可用。這不代表「速度更快」,伺服器無法使用時也不能正常連線。完成驗證後,若需要依規則區分目標,請返回配置(Config),並重新驗證實際連線。
直連(Direct)主要用於直接連線,不宜用來證明「伺服器已可用」。即使連線開關維持開啟,Direct 模式下可以瀏覽網頁,也可能只代表基本網路正常。切換模式後返回 Home,再確認目前顯示的值符合預期,接著進行連線授權。
03 · Home:開啟連線開關並完成系統授權
返回 Home,最後檢查兩項:圓點選取的是準備測試的伺服器,Global Routing 顯示的是剛才選擇的模式。確認後開啟頂部的連線開關。首次使用時,iPhone / iPad 可能會顯示新增 VPN 設定的系統提示;請確認發起的應用程式是 Shadowrocket,再選擇允許,並依系統要求完成裝置身分驗證。
此授權用於在裝置上建立網路處理設定,不是要求使用者提交訂閱密碼,也不需要將裝置解鎖密碼告訴任何人。完成系統對話框後返回 Shadowrocket,觀察開關是否維持開啟,以及連線狀態是否穩定。系統授權視窗尚未處理完時,請勿連續點選開關,以免混淆目前操作是否生效。
如果先前拒絕過授權,再次開啟開關時請依實際提示處理。也可以在系統 Settings 中搜尋 VPN,檢查是否有 Shadowrocket 對應的設定。裝置受管理政策限制時,可能無法新增 VPN 設定;請依裝置管理要求處理,不要反覆刪除其他系統設定。
若同時有其他 VPN 設定正在連線,請先中斷其他連線,再返回 Shadowrocket 重試,避免系統切換設定導致狀態反覆。連線開關剛開啟就關閉、返回應用程式後發現未連線,與「連線維持但網頁無法開啟」是不同問題,後續排查順序也不同。開關維持開啟後,請繼續執行 Connectivity Test,不要只停留在狀態圖示這一步。
04 · Connectivity Test:驗證連線與實際存取
在 Home 找到 Connectivity Test 並執行測試,等待操作完成。測試結果可提供目前連線的診斷線索;如果失敗或逾時,請先記下當時選擇的伺服器與 Global Routing,再進行下一步排查。本教學不預設固定延遲或成功結果,實際狀況取決於裝置網路、伺服器與目前策略。
接著開啟瀏覽器,前往實際需要使用的目標,確認頁面能否完整載入,而不是只看到快取標題或舊內容。必要時重新整理頁面,再檢查圖片、後續請求或登入流程是否正常。單次測試通過只表示該次測試目標可連線,無法保證所有網站和應用程式都採用相同路徑,也不能取代實際使用驗證。
若要區分伺服器連線問題與規則問題,可以先記錄目前設定,在代理(Proxy)模式下測試相同目標,再切回配置(Config)重複測試。兩次結果不同時,應優先檢查 Config 中針對該目標的規則、策略與 DNS,而不是立刻更換整套伺服器資料。比對時請維持基本網路和測試目標不變,結果才有參考價值。
若要進一步確認請求的處理方式,可查看目前可用的連線或請求紀錄,依目標網域與測試時間尋找對應項目,並核對實際策略。Data 中的流量變化可用於輔助確認是否有活動,但流量增加本身無法證明特定目標經由 PROXY 傳送。紀錄可能包含個人瀏覽資訊,對外尋求協助前應刪除訂閱憑證、帳戶資訊及不必要的目標紀錄。
當開關可以維持開啟、Connectivity Test 有可用結果,且實際目標也能依預期存取時,首次連線才算完成。之後若變更伺服器、Global Routing 或 Config,請重複相同的驗證步驟,不要將上一次的成功結果視為新設定的驗證結論。
05 · 常見問題:一次只變更一個項目
匯入後清單為空
先返回訂閱編輯資訊,檢查類型是否為 Subscribe、URL 是否完整,以及儲存後是否成功讀取內容。確認裝置在未連線時可以正常上網,再嘗試更新該訂閱。如果原始連結需要帳戶驗證或已失效,請向原服務提供者確認。訂閱名稱存在與伺服器內容存在是兩回事;反覆開啟連線開關無法解決清單空白。
開關無法維持開啟
先檢查新增 VPN 設定的系統授權是否完成,再查看系統 VPN 設定中是否有其他連線正在接管。若為受管理裝置,請確認相關限制。此類問題應優先處理系統授權與連線狀態,不要先修改 DNS 或大量更換規則,因為請求可能尚未進入預期的網路處理流程。
開關已開啟,但 Connectivity Test 失敗
返回 Home,確認圓點仍選取預期伺服器,再核對位址、連接埠與驗證欄位。手動新增的項目尤其要檢查協定類型是否與 TLS、傳輸參數相符。若訂閱提供多個現有項目,可只切換伺服器並重複相同測試,其他設定維持不變;如果只有一個項目,不要靠猜測連接埠或密碼嘗試修復。
也可以在 Wi-Fi 與行動網路之間進行一次比較,但切換前後應維持相同伺服器與模式。如果只有某一種基本網路失敗,請先確認該網路是否需要認證或設有本機連線限制。每次比較都記錄變更項目,避免同時切換網路、伺服器及設定,最後無法判斷是哪項變更發揮作用。
測試有結果,但特定網站無法開啟
先查看 Global Routing。如果代理(Proxy)模式下可用、配置(Config)模式下失敗,請檢查目標是否符合預期規則,以及規則中的策略是否可用。若直連(Direct)模式下可以開啟,也不能據此證明伺服器正常。排查單一目標時應針對該目標進行,不要將某個網站的故障直接歸因於整個客戶端。
DNS 也可能造成「連線已建立,但網域無法存取」。請先記錄目前的 DNS 設定,再依現有設定說明核對解析行為;不要任意混用來源不明的位址。如果請求紀錄顯示網域解析異常,應優先處理解析問題,而不是重複匯入相同訂閱。協定連線與網域解析是不同環節,需分別驗證。
原本可用,更新訂閱後失效
更新訂閱可能會變更伺服器清單,請先檢查目前圓點是否仍指向存在且有效的項目,再核對 Config 中引用的策略是否仍有可用目標。更新伺服器資料不等於更新整份設定檔;只完成其中一項時,另一項仍可能保留舊設定。確認原服務提供者是否調整過欄位後,再依資料修正。
仍未解決時,請整理基本網路類型、選取的協定、Global Routing 模式、測試狀況,以及已進行的單項變更,再參閱協定參考與欄位說明。若要重新確認操作順序,可從Add Server 步驟查看。尋求協助時,描述具體失敗環節,比只說「無法使用」更容易找出問題。
完成後確認三個項目
日常使用前,先確認 Home 選取的伺服器、Global Routing 目前的模式,以及 Config 中啟用的設定檔即可。更新訂閱或切換網路後,若連線狀況改變,請依本頁順序重新測試。暫時不需要連線時,可以在 Home 關閉連線開關,再確認基本網路狀態。
後續學習不必從大量規則開始。先熟悉一次完整的「匯入 → 選擇 → 連線 → 驗證」流程,再前往設定說明了解 On Demand 等選項,或前往協定參考核對現有伺服器欄位的含義。保留原始連線資料,變更前記錄目前狀況,發生問題時才有明確的復原依據。