官方手冊 · 首次連線

Shadowrocket 使用教學

匯入訂閱 → 選擇 Global Routing → 授權連線 → 驗證 → 排查。先完成一次可重複的連線測試,再逐步調整規則與自動連線設定。

  • iPhone / iPad
  • 使用現有訂閱或伺服器資訊
  • 逐步驗證

本頁僅說明首次操作的必要步驟。訂閱分組、更新與備份等完整流程,請參閱伺服器管理手冊;遇到不熟悉的協定名稱或規則關鍵字,可先查閱概念速查,不必在首次連線前調整所有設定。

步驟 01 · 建立伺服器項目

Add Server / Subscribe:匯入現有資訊

開啟 Shadowrocket,進入 Home。先查看伺服器列表是否已有項目,再決定新增方式。訂閱連結用於取得一組伺服器及後續更新;單一伺服器連結或手動填寫的一組參數則描述特定連線。兩者用途不同,別只因一段文字看起來像網址,就把它當成訂閱填入。

已有訂閱連結時,使用 Subscribe

在 Home 點選右上角的新增入口,開啟 Add Server。在類型選擇中選取 Subscribe,將自己的完整訂閱連結填入 URL。若需填寫名稱,使用容易辨識的備註即可。貼上後檢查開頭與結尾,移除不小心帶入的空格、換行及說明文字,但不要自行刪改連結中的參數。

儲存後返回 Home,等待訂閱內容載入。匯入成功後,列表中應會顯示該訂閱的伺服器項目。備註有助於辨識來源,但備註本身不會影響連線是否可用。若只儲存了訂閱名稱,卻沒有伺服器,請先檢查是否出現取得或解析錯誤,不要立刻開啟連線開關。

訂閱網址可能包含可識別帳號的私密參數。請勿將完整連結貼到公開問答、截圖說明或他人的裝置中。後續整理與更新也應以同一份訂閱為主,避免重複新增相同網址,造成列表重複。更新方式與多份訂閱的整理方法,請參閱伺服器管理手冊。

已有單一伺服器資訊時,使用 Add Server

再次從 Home 開啟 Add Server,依照現有資料選擇正確的協定類型。接著逐項填入伺服器位址、連接埠,以及該協定要求的驗證資訊。Shadowsocks、VMess、VLESS、Trojan、WireGuard 等協定所需欄位各不相同,請勿將其他協定的密碼或識別資訊直接套用到目前表單。

若資料也提供 TLS、Server Name、傳輸方式或路徑等參數,請一併依原始資訊核對。伺服器位址與 TLS 驗證所用的名稱可能不同。不要為了少填幾個欄位,就關閉原本要求的驗證。若不清楚某個欄位的意義,請先查閱協定與網路術語,再向資料提供者確認連線所需參數。

若已有可識別的伺服器分享連結,可使用對應的匯入入口;QR Code 則可透過 Scan QR Code 掃描。掃描前請確認內容來自自己的伺服器資料,並依照系統提示授予相機權限。無論採用哪種方式,儲存後都應返回 Home,確認項目內容完整;「成功辨識連結」不代表「連線已成功」。

完成此步驟後,列表中應有可辨識的伺服器,並已選取其中一個項目。接下來選擇流量處理方式,再開啟連線。

步驟 02 · 決定流量處理方式

Global Routing:選擇三種模式

在 Home 開啟 Global Routing,查看目前選項。三種模式分別是配置(Config)、代理(Proxy)與直連(Direct)。它們決定連線採用的策略,不會補齊伺服器資訊,也無法修復失效的驗證資料。

模式 處理方式 首次驗證時的檢查重點
配置(Config) 依目前啟用的設定檔規則決定策略。 確認目前使用的設定檔,以及測試目標比對到的規則。
代理(Proxy) 讓納入代理處理範圍的流量使用代理。 確認選取的伺服器能否完成請求。
直連(Direct) 使用直接連線。 用來觀察目前網路的直接連線狀況。

準備依規則進行日常使用時,請選擇配置(Config),再進入 Config 檢查實際啟用的設定檔。Config 頁面用於管理設定檔,而 Global Routing 中的 Config 選項則表示依設定檔處理流量;兩者相關,但不是同一項操作。只將檔案匯入列表,不代表已選用該檔案。

若目前目標是先確認伺服器連線,可以暫時選擇代理(Proxy),測試完成後再切回配置(Config)。這樣可減少規則分流對初步判斷的干擾,但不能據此保證裝置上每個 App 的所有請求都會經過相同路徑。系統網路行為及個別設定仍會影響結果,應以實際請求記錄為準。

直連(Direct)不適合用來證明伺服器可用。使用此模式時,即使網站正常開啟,也可能只是目前網路可以直接連線。反過來說,選擇配置(Config)後,某個網站仍透過直接連線,也不一定代表設定檔失效;它可能正好比對到 DIRECT 策略。

首次操作時,先記下所選模式。若使用配置(Config),也記下目前設定檔名稱。暫時保留現有 DNS 與其他進階設定,不必複製一大段看不懂的規則。關於 PROXY、DIRECT、REJECT 與規則比對順序,可參閱概念速查。選好後返回 Home,進入連線步驟。

步驟 03 · 建立系統連線

Home:開啟開關並授權

返回 Home,再次確認伺服器左側的選取標記,並確認 Global Routing 與上一步相同。接著開啟頁面頂端的連線開關。首次建立連線時,系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。這是 App 透過系統網路延伸功能處理連線所需的授權,不是匯入訂閱時已完成的操作。

閱讀系統提示,確認要求來自 Shadowrocket,再依照系統指示允許新增設定。系統可能要求輸入裝置密碼或進行身分驗證。完成後返回 App,確認連線狀態是否持續開啟。若先前已允許新增設定,這次不一定會再次出現相同提示;沒有重複出現提示,不代表連線流程異常。

若剛才選擇拒絕,請返回 Shadowrocket 重新發起連線,並確認系統是否仍有待處理的授權提示。不要連續快速點按開關;等本次操作完成後再判斷。受到裝置管理政策限制的 iPhone 或 iPad,可能無法新增 VPN 設定,請先確認裝置是否允許使用這項系統功能。

為了讓首次測試結果更明確,請檢查系統中是否還有其他 VPN 連線正在使用。不同網路設定可能互相影響,排查時一次只保留本次需要的連線。暫時不要啟用 On Demand,以免自動連線條件與手動操作同時變動。待手動連線穩定後,再另外設定隨選連線。

開關維持開啟且系統顯示 VPN 狀態,只能表示系統連線已建立或正在運作,不能證明所選伺服器可以連線至所有目標。即使遠端伺服器驗證錯誤,系統網路延伸功能仍可能已啟動。因此,此步驟的完成標準是已處理授權,且連線狀態穩定;實際連線是否可用,還要進行下一步測試。

需要結束此次連線時,返回 Home 關閉頂端開關。首次驗證期間,不要以刪除系統設定代替正常中斷連線;否則下次連線可能需要重新授權,也會增加排查變因。

步驟 04 · 以實際請求確認

Connectivity Test:確認是否生效

連線狀態穩定後,執行 Connectivity Test,確認測試是否完成及是否出現錯誤。測試入口的位置與可選項目,請以目前 App 介面為準。保留測試結果,並記下使用的伺服器、Global Routing 模式及目前網路,方便失敗時在相同條件下重試。

接著開啟瀏覽器,前往明確的測試目標並重新整理頁面。先確認目標本身正常提供服務,再檢查新的請求是否完成。不要只依賴已開啟的頁面,因為網路無法使用時,快取內容仍可能顯示。若要比較不同設定,請重複存取同一個目標,不要每次都更換網站。

區分「有延遲結果」與「實際請求成功」

伺服器列表中的延遲測試適合用來初步篩選項目,但測試方式與實際請求並不完全相同。某個項目顯示延遲結果,不代表驗證、TLS 與存取目標的整個流程都已成功。反過來說,某種探測沒有回應,也不能單憑這項結果就認定伺服器完全無法使用。請搭配 Connectivity Test 與實際網頁請求判斷。

使用配置(Config)時,也要檢查策略

使用配置(Config)時,請查看 App 的連線記錄,找到剛才送出的請求,核對目標網域及實際採用的策略。比對到 DIRECT 表示該請求依規則直接連線;比對到 PROXY 才表示規則將請求交由代理處理。若設定檔使用策略群組,也要確認該群組實際選用了哪台伺服器,不能只看 Home 中的預設項目。

不要直接把「對外位址沒有變化」等同於「開關沒有生效」。測試目標可能比對到直連規則,也可能仍在沿用舊連線。先確認請求是新送出的,再查看比對到的規則與策略。若只想分辨伺服器連線與規則的影響,可暫時切換到代理(Proxy)重做相同測試,記錄結果後再恢復原本模式。

當 Connectivity Test、實際連線與預期策略一致時,首次連線驗證即完成。接著保留這組可用設定,再逐項嘗試調整設定檔。修改前請先儲存可還原的設定;確認可用後,不要立刻同時變更 DNS、規則與伺服器,否則出現問題時很難找出原因。

步驟 05 · 依失敗階段縮小範圍

首次連線失敗:逐項檢查

先判斷問題發生在哪個階段:訂閱未匯入、連線開關無法維持開啟、連線已建立但測試失敗,還是只有部分目標無法存取。不同情況的檢查位置各異。每次只調整一項設定,再重做剛才的測試,避免反覆重新安裝或一次修改多個參數碰運氣。

Subscribe 儲存後沒有伺服器

重新檢查 URL 是否完整,確認填入的是自己的訂閱網址,而非說明網頁或單一伺服器連結。查看錯誤是取得失敗還是內容解析失敗。若取得失敗,先確認目前網路可正常連線;若內容解析失敗,請核對資料類型與有效性。訂閱可能含有已過期的驗證參數,這類問題無法靠調整 Global Routing 解決。

若先前已成功匯入,但現在更新失敗,請先保留現有項目,不要立刻清空列表。記下更新時的錯誤訊息,再檢查自己的訂閱狀態。若要整理重複項目、保留備註或備份,請接著閱讀伺服器管理手冊,避免排查時遺失仍可用的資訊。

開關已關閉,授權尚未完成

確認系統授權是否遭拒,以及裝置是否限制新增 VPN 設定。確認目前沒有其他連線反覆接管系統網路狀態。若先前啟用 On Demand,請先檢查觸發條件;首次排查時暫時改用手動連線。只有系統連線能穩定維持,後續的伺服器與規則測試才有明確意義。

已連線,但 Connectivity Test 失敗

先確認 Home 中選取的確實是準備測試的伺服器。手動新增的項目要重新核對協定、位址、連接埠、驗證欄位及 TLS 相關參數,特別留意複製時混入的空格與大小寫差異。不要只修改備註或重新排序,這些操作無法修復連線參數。

若手邊有其他有效項目,可在維持相同模式與測試目標的情況下切換項目比較。也可以在 Wi-Fi 與行動網路之間進行對照;切換網路後,請重新連線並再次測試。對照結果可協助判斷問題範圍,但不代表某個網路或項目在所有情境下都一定可用。

代理(Proxy)可用,配置(Config)異常

優先檢查 Config 中實際啟用的檔案,以及測試請求比對到的規則。設定檔可能將目標交由 DIRECT、REJECT 或沒有可用成員的策略群組處理。這時伺服器本身未必有問題。先還原先前可用的設定檔,再逐條調整相關規則;規則關鍵字的意義請參閱概念速查。

只有部分網域無法使用

留意連線記錄中是否出現解析錯誤、連線逾時或 TLS 驗證錯誤。網域解析失敗不等於伺服器驗證失敗,單一網站無法使用也不代表所有流量都異常。先測試其他目標,再檢查目前設定檔中的 DNS 設定。不要為了嘗試而同時填入多個來源不明的解析位址,也不要關閉憑證驗證來掩蓋名稱或憑證問題。

若需要進一步尋求協助,請整理失敗階段、錯誤原文、使用的協定、路由模式及網路類型。分享記錄前,請刪除訂閱網址、密碼、使用者識別資訊及其他驗證參數。清楚說明「哪一步成功、哪一步失敗」,通常比只說「不能用」更有助於找出問題。

Shadowrocket 正版下載