官方手冊 / 首次連線

Shadowrocket 使用教學

匯入現有訂閱 → 選擇 Global Routing → 連線授權 → 確認結果 → 排查故障。先完成一次可重現的連線，再調整規則與自動連線設定。

  • 操作範圍 Home / Config / Data
  • 先確認手動連線
  • 每次只修改一項設定

STEP 01 / 匯入現有資料

Add Server：新增伺服器或選擇 Subscribe

先確認手上的資料類型，再選擇匯入方式。訂閱連結用來取得一組伺服器資料，並非單一伺服器的網址；單一伺服器資料通常包含協定、位址、連接埠與驗證參數。兩者不可混填。開啟 Shadowrocket，進入 Home（首頁），點選右上角的新增按鈕，再進入 Add Server（新增伺服器）。以下兩種方式擇一即可，不必重複新增。

已有訂閱連結：選擇 Subscribe

在 Add Server 的 Type（類型）中選擇 Subscribe（訂閱），將完整的訂閱連結填入 URL，並填寫方便辨識的備註。貼上後，先檢查開頭與結尾是否完整，以及內容是否夾帶換行、空格或聊天文字，再儲存。連結中的查詢參數可能用於身分驗證，請勿為了縮短網址而自行刪除。此處應填入現有訂閱的取得網址，不是服務介紹頁或帳戶登入頁。

儲存後返回 Home，等待資料取得完成，再檢查對應群組下是否出現伺服器項目。看到訂閱名稱不代表內容已成功取得，請確認群組可以展開，且內含可選取的伺服器。若匯入後清單為空，先保留提示訊息，檢查連結是否有效及目前的基礎網路，不要立刻重複建立相同訂閱。後續更新可直接重新整理原有訂閱，通常不必每次都重新新增。

已有單一伺服器資料：依協定填寫

同樣從 Add Server 進入，在 Type 中選擇資料指定的協定，再逐項填寫伺服器位址、連接埠與對應的驗證欄位。例如 Shadowsocks、VMess、VLESS、Trojan 的欄位不盡相同，請以自己的伺服器參數為準。位址欄只填資料要求的主機名稱或位址，不要貼入完整訂閱連結。不要只憑名稱猜測協定，也不要把其他項目的參數拼在一起建立新記錄。

如果資料還包含 TLS、伺服器名稱或傳輸相關選項，也要一併核對；只有位址和連接埠未必足夠。透過 Scan QR Code（掃描 QR Code）匯入現有連線資料時，儲存後也應檢查解析出的類型與位址，而非只確認掃描成功。QR Code 只是輸入方式之一，不能取代參數核對。若原始資料未明確提供對應欄位，請先確認說明，不要自行更改加密或驗證選項。

完成本步的標準是：Home 中有一筆來源明確、參數完整且可選取的伺服器記錄。記下它的備註與所屬群組；下一步將選擇 Global Routing（全域路由），決定連線後如何處理流量。暫時不要啟用 On Demand（隨需連線），以免自動觸發影響首次手動測試。

STEP 02 / 確認流量去向

Global Routing：設定、代理與直連

新增伺服器不代表所有存取都會經過該伺服器。返回 Home，點選 Global Routing，查看目前模式。三個選項分別是設定(Config)、代理(Proxy)與直連(Direct)。先確認測試目的，再選擇對應項目；不要把「連線開關已開啟」與「所有流量都經過所選伺服器」視為同一件事。

模式說明首次檢查重點
設定(Config)依目前啟用設定中的規則與策略處理請求。檢查 Config 中已啟用的檔案及規則去向。
代理(Proxy)讓流量經由代理路徑處理，用來對照伺服器連線狀況。確認目前選取的伺服器或相關策略。
直連(Direct)讓流量經由直連路徑處理。適合檢查基礎網路，但不能據此證明伺服器可用。

日常依規則使用：先確認 Config

準備使用設定(Config)時，請進入 Config（設定）頁面，確認目前啟用的設定，並查看其中的規則與策略。匯入 Subscribe 與啟用 Config 是兩回事：訂閱主要用於更新伺服器清單，設定則決定匹配條件與流量去向。Home 中出現現有伺服器，不代表它會自動取代設定中的所有策略引用。對於不熟悉的設定，請先確認來源與內容，再套用。

例如，DOMAIN-SUFFIX,example.com,PROXY 表示網域後綴符合 example.com 時，採用 PROXY 所指定的代理處理方式；IP-CIDR,192.168.0.0/16,DIRECT 則將對應的位址範圍交由 DIRECT 處理。這些只是規則語法範例，完成入門教學不需要照抄到目前的設定中。規則會依匹配順序生效，請求若先符合某項規則，後續規則不一定會參與處理。

暫時使用 Proxy 對照，結束後切回原模式

若要先確認現有伺服器能否連線，可以暫時使用代理(Proxy)，減少規則選擇對測試結果的影響。測試前記下原本的模式，並確認 Home 中已選取要測試的伺服器；測試結束後再切回設定(Config)。直連(Direct)適合對照裝置本身能否存取原本可連線的目標，不能用來取代遠端伺服器檢查。

完成本步時，應能說清楚「目前使用哪種模式、哪份設定或哪台伺服器」。如果還無法確認，先不要同時修改 DNS 與 On Demand。規則優先順序、策略引用等較詳細內容，請參閱規則分流設定說明；此處先確認路徑，再進入連線步驟。

STEP 03 / 建立手動連線

Home：開啟開關並允許 VPN 設定

返回 Home，再確認伺服器選取狀態與 Global Routing。伺服器名稱相似時，請一併核對群組與協定，避免選錯記錄。準備就緒後，開啟頂端的連線開關，觀察 App 顯示的連線狀態。首次連線可能會先出現系統授權提示；完成授權前，不要把開關短暫變化判定為伺服器故障。

首次出現新增 VPN 設定提示

系統要求新增 VPN 設定，是為了允許 Shadowrocket 建立處理裝置網路流量所需的系統連線。確認剛才確實是由自己在 Shadowrocket 中發起連線後，依照系統提示允許，並完成裝置要求的驗證。這與新增伺服器屬於不同層級：系統授權決定 App 能否建立連線，伺服器參數則影響後續通訊能否成功。

允許後返回 Shadowrocket，確認連線是否繼續。若先前選擇取消，App 尚未取得所需授權，請重新發起連線並依提示操作，不要反覆更換伺服器密碼。系統設定中的 VPN 項目可用來查看相關設定狀態；不同系統版本的設定路徑可能不同，可透過系統設定搜尋 VPN。不要一開始就刪除系統設定，以免增加復原步驟。

區分連線狀態與實際存取結果

開關維持開啟或系統顯示 VPN 狀態，表示系統連線已建立，但還不能視為驗收完成。所選伺服器可能無法連線、特定目標可能解析失敗，或目前規則可能讓目標走直連。因此連線後應維持目前設定繼續測試，不要只看狀態標示就結束，也不要在結果尚未明確時連續切換多種模式。

首次手動測試期間，請暫停其他正在管理 VPN 連線的設定，並維持相同的網路環境。如果裝置上已有 On Demand 條件會自動觸發，請先記下條件，再暫停自動連線。否則手動關閉後又自動開啟，容易誤以為開關失效。不要只為了讓測試「看起來成功」就刪除用途不明的系統設定。

此時建議記錄三項基本狀態：目前使用 Wi-Fi 或行動網路、Home 中選取的伺服器，以及 Global Routing 模式。進入下一步後，即使存取失敗，也能依據明確的測試條件縮小問題範圍。連線穩定後再逐步加入自動化設定，比一次調整多個選項更容易找出原因。

STEP 04 / 分層驗證

Connectivity Test 與實際存取檢查

驗證時分別檢查三件事：系統連線是否建立、所選伺服器在目前測試方式下是否可連線，以及實際目標是否能依預期存取。三者不能互相取代。先在 Home 使用 Connectivity Test（連線測試），留意所採用的測試方式與對應結果，再用日常 App 或瀏覽器開啟要存取的目標。

先查看測試結果，再測試實際請求

Connectivity Test 的結果會受測試方式、測試目標、目前網路與伺服器處理方式影響。出現數值只代表這次測試取得相應結果，不保證所有網頁或 App 都能正常使用；逾時也應配合測試目標判斷，不要直接推斷所有通訊都已失敗。比較兩台現有伺服器時，應使用相同測試方式與網路，否則兩次結果無法直接比較。

實際存取時，先選一個自己熟悉且原本就能正常開啟的頁面作為基準，再測試真正需要使用的目標。如果只有某個 App 失敗，可嘗試用瀏覽器開啟同一服務的頁面，以區分 App 本身狀態與連線問題。請使用相同測試目標，不要每次換不同頁面；也不要只根據已開啟的舊頁面判斷新連線是否成功，快取內容可能沒有產生新的網路請求。

在 Data 中確認連線紀錄

進入 Data（資料）查看目前可見的請求或連線資訊，尋找剛才測試目標的對應紀錄。請確認請求是否出現、目標網域或位址是否符合預期，以及紀錄中可見的策略或處理去向。實際可見欄位以 App 內顯示為準；如果目前沒有足夠資訊，請重新發出明確的新請求，不要從歷史紀錄中任意挑選一筆下結論。

使用設定(Config)時，應確認匹配結果是否符合預期規則。如果目標原本應直連，卻命中代理策略，請檢查啟用的設定與規則順序；如果原本應走代理，卻命中 DIRECT，請先找出符合條件的規則。不要只把 FINAL 改成其他去向，因為請求可能早已由更前面的規則處理，修改預設規則未必會產生影響。

驗證通過的標準是：連線狀態正常、實際目標產生新的請求並取得預期結果，且可見的處理去向符合目前的路由選擇。若測試時暫時使用代理(Proxy)，切回設定(Config)後也應對相同目標再次測試。之後再依使用習慣設定 On Demand；詳細條件與優先順序請參閱On Demand 設定說明。

STEP 05 / 單一變數排查

連線失敗：從基礎網路檢查到規則

發生問題時，先記下現象，再決定要檢查哪個環節。「無法取得訂閱」、「開關無法維持開啟」、「測試逾時」、「只有一個目標無法開啟」各有不同原因，不宜用同一種方式處理。保留目前設定與錯誤提示，每次只變更一項條件，並使用相同目標重新測試。以下依由外而內的順序檢查，可減少重複操作。

第一層：基礎網路與訂閱內容

先關閉目前的連線，確認裝置能否存取平時可開啟的頁面。Wi-Fi 若需要登入網路，請先完成登入；行動網路則先檢查網路服務與 App 使用權限。如果基礎網路本身無法使用，應先排除該問題。切換 Wi-Fi 與行動網路可作為對照，但請分別記錄結果，不要將切換前後的測試混在一起比較。

若問題出在 Subscribe 更新，請確認網址是否完整、現有訂閱是否仍有效，以及目前網路能否取得該網址。訂閱更新成功只代表清單已取得，不保證其中每台伺服器都正常；更新失敗也不一定會讓已儲存的記錄立即失效。先查看具體提示，再核對自己的訂閱資料。請勿在公開求助內容中分享含身分驗證參數的完整連結。

第二層：伺服器參數與系統授權

清單中已有伺服器項目但測試失敗時，請逐項確認協定、伺服器位址、連接埠與驗證欄位。若記錄包含 TLS 或傳輸選項，也要確認參數是否與原始資料相符。裝置日期與時間錯誤可能影響安全連線，請一併確認系統時間正確。若同一訂閱中還有其他自己的伺服器，可選一台在相同條件下對照，但不要據此改寫原記錄中不明的參數。

如果開關才剛開啟就關閉，或一直停留在授權階段，請先確認系統是否允許新增 VPN 設定，以及是否有其他連線管理設定介入。只有在確認系統設定已刪除或需要重建時，才依 App 提示重新建立。不要混淆系統授權失敗與遠端驗證失敗：前者通常發生在建立連線之前，後者則需繼續檢查實際連線資料與錯誤紀錄。

第三層：路由、規則與 DNS

若目標在代理(Proxy)模式下正常，但在設定(Config)模式下失敗，請優先確認目前設定、規則匹配結果與策略引用；若直連(Direct)正常而代理路徑失敗，則繼續檢查所選伺服器與遠端通訊。這類對照有助縮小檢查範圍，但不能直接判定故障原因。每次切換後都應重新發出請求，避免沿用舊連線而影響判斷。

只有部分網域無法存取時，再配合 Data 中的資訊檢查 DNS 與目標相關紀錄。不要同時更換 DNS、關閉驗證檢查、修改規則和切換伺服器，否則即使問題暫時排除，也無法確認是哪項變更生效。DNS 運作方式與更詳細的故障提示說明，請參閱常見問題；商店帳號、已購項目復原與購買確認，請參閱App Store 取得指南，連線排查時不必重新處理購買流程。

至此，首次使用已完成完整流程：成功匯入現有資料、明確選擇路由、完成系統授權，並確認實際請求結果。後續調整也沿用相同做法：先記錄原始狀態，每次只修改一項，再檢查相同目標。若需繼續設定，可前往設定說明查看相關項目，不必重做所有入門步驟。