官方手冊 · 入門操作 匯入與使用既有設定

Shadowrocket
匯入與連線教學

依序完成匯入、路由、連線與測試。先確認伺服器可連線，再檢查規則是否符合預期。

01 · Add Server：新增伺服器或匯入訂閱

本教學適用於 iPhone 與 iPad。開啟 Shadowrocket 後，先進入 Home，確認是否已有伺服器項目。若列表是空的，請先不要開啟連線開關；必須先將既有伺服器資料儲存至 App。訂閱連結、單一伺服器分享連結與 Config 設定檔的用途不同，匯入前請先確認手邊資料的類型。

訂閱連結通常由服務商提供，用來取得及更新一組伺服器；單一伺服器資料則包含一台伺服器的連線參數；Config 主要用來設定規則及相關選項。若將訂閱連結填入伺服器位址欄位，或將 Config 檔案網址當作 Subscribe 使用，都可能造成匯入失敗。若無法單憑連結判斷類型，請查閱原始設定說明，不要反覆嘗試不同的匯入入口。

已有訂閱連結：選擇 Subscribe

  1. 在 Home 點選右上角的加號，進入 Add Server，點選 Type 並選擇 Subscribe。
  2. 將使用者已有的完整訂閱連結貼到 URL 欄位。若要新增備註，請填寫容易辨識的名稱；不要把連結貼在備註欄位。
  3. 點選頁面上的完成按鈕儲存，返回 Home，等候訂閱讀取完成，再確認群組中是否出現伺服器項目。
  4. 展開對應群組，點選其中一台伺服器，確認它已成為目前選取的項目。訂閱群組存在，不代表已選取可供連線的特定伺服器。

貼上後請檢查開頭、結尾及查詢參數是否完整，尤其要避免包含聊天文字、換行或尾端標點。訂閱連結可能含有存取憑證，請只填入必要欄位，勿放在公開截圖、網頁或問題描述中。若儲存後顯示讀取失敗，請先保留原始連結，再依本文末的訂閱排查順序處理；重複新增相同訂閱只會增加辨識難度。

訂閱內容有變更時，可在 Home 的對應訂閱群組操作中更新，並留意更新提示。更新完成後，請重新確認目前選取的項目，因為原有項目可能已遭替換或移除。更新訂閱只能刷新伺服器列表，無法保證新項目可連線，也不能取代 Config 中的規則設定。

已有伺服器資料：依 Type 填寫參數

如果只有單一伺服器的參數，請同樣從 Home 的加號進入 Add Server，先在 Type 選擇與原始資料相符的協定類型，再填寫位址、連接埠與驗證欄位。例如 VLESS、Trojan、WireGuard 的欄位各不相同；即使位址與連接埠相同，也不能將一種協定的資料填入另一種類型。填妥後儲存，返回 Home 並選取該伺服器。

請逐項比對原始資料中的欄位值，留意英文字母大小寫、空格及連接埠號碼。若資料包含 TLS、SNI、傳輸方式或路徑，也請填入相應欄位；不要為了簡化表單而省略這些參數。TLS 驗證失敗時，應檢查名稱與憑證是否相符，不要降低驗證要求來規避錯誤。若不清楚欄位用途，可先查閱概念速查，再返回表單繼續設定。

若使用者已有伺服器 QR Code，可使用 Scan QR Code 掃描，並依系統提示授權使用相機。辨識後仍須核對 Type、位址與連接埠，確認內容與原始資料一致。QR Code 只是承載設定的方式，不代表其中的資料已通過連線測試。完成上述任一匯入方式後，下一步是決定如何處理流量。

02 · Global Routing：選擇流量處理模式

返回 Home，點選 Global Routing 並查看目前的選擇。此處決定流量的處理方式，不會提供伺服器。三種模式分別為配置(Config)/代理(Proxy)/直連(Direct)。初次設定時，請先釐清測試目的：要測試伺服器本身，還是驗證既有規則；目的不同，選擇也不同。

配置(Config)：依目前設定檔的規則處理

Config 適合日常使用，可依規則決定哪些請求使用代理、哪些請求直連。選擇前，請先前往 App 的 Config 頁面，確認已選取要使用的設定檔。列表中有儲存檔案，不代表該檔案就是目前使用中的設定；請檢查選取標記，並確認檔案內容來自使用者已知的設定資料。

規則通常依書寫順序比對，命中後再依策略處理請求。以下片段用來說明「指定網域走代理，其餘直連」的意思，並非本教學要求建立的完整設定，也不會提供伺服器：

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

DOMAIN-SUFFIX 用來比對網域後綴，PROXY 與 DIRECT 表示處理策略，FINAL 用於處理未命中的情況。範例網域 example.com 僅用於說明語法。既有 Config 可正常使用時，不要為了首次連線而整份覆寫；如需深入了解規則與設定，請參閱概念速查。

代理(Proxy)：測試目前伺服器的存取能力

Proxy 適合暫時排除規則比對因素，測試由代理處理的連線是否可用。先選取一台伺服器，再切換至 Proxy，使用同一個網頁測試。若 Proxy 可以存取、Config 卻不行，接著應檢查目前設定與規則策略，而非立刻重新匯入所有伺服器。Proxy 無法修正錯誤的驗證參數，也無法讓無法連線的伺服器恢復回應。

直連(Direct)：測試目前網路的直接連線

Direct 會透過目前網路直接連線，方便進行比較。這不是自動挑選伺服器的模式，也不會因為 Home 已選取某個項目，就將直連請求改由該伺服器處理。使用 Direct 時，應測試目前網路原本即可存取的網頁，藉此區分基本網路故障與代理連線問題。

測試完成後，請恢復符合日常需求的模式。需要分流時，請切回 Config 並確認使用中的設定檔；別只記得已開啟連線開關，卻忘了 Global Routing 仍停留在臨時測試模式。確認模式後，再進行系統授權與連線步驟。

03 · Home：開啟連線開關並完成授權

返回 Home，再確認兩項設定：目前選取的伺服器是否正確，以及 Global Routing 是否符合這次的測試目的。初次操作時，建議維持網路穩定；不要同時切換 Wi-Fi 與行動數據、修改伺服器參數，否則發生問題時難以判斷原因。

  1. 開啟 Home 頂端的連線開關。
  2. 首次建立連線時，系統可能會提示新增 VPN 設定。請閱讀提示，確認發起 App 為 Shadowrocket，再選擇允許。
  3. 依系統指示完成裝置密碼或身分驗證，並等候返回 App。
  4. 確認連線開關保持開啟，且系統 VPN 狀態已建立。

此授權是讓系統將相應網路流量交由用戶端處理，不是確認匯入訂閱，也不是新的 App 購買步驟。僅儲存伺服器項目通常不會完成 VPN 設定授權；首次實際開啟連線時，才會進入系統授權流程。若不慎取消提示，連線可能無法繼續；請返回 Home 再試一次並完成授權。

若開關才剛開啟就恢復關閉，請先確認授權流程是否完成，再前往系統 Settings 的 VPN 設定區查看狀態。選單位置可能因系統介面版本而異，請以裝置實際顯示為準。若正在使用其他 VPN 連線，請先停用再測試；受管理裝置的限制也可能影響 VPN 設定，請依裝置管理規範處理，不要反覆重設所有網路設定。

VPN 狀態已建立，只代表系統通道已建立，不代表伺服器驗證、DNS 解析或目標網站存取都已成功。看到系統連線圖示後，仍須進行下一步的網頁存取測試。若先前設定了 On Demand，排查期間請先了解其觸發條件，必要時暫時關閉，以免手動中斷後又自動建立連線，影響比較結果。

04 · Connectivity Test：測試連線與規則

先返回 Home 使用 Connectivity Test，查看目前伺服器的測試結果。有回應可作為伺服器在該測試方式下可連線的線索；若沒有回應，則需進一步檢查網路與參數。測試結果會受測試方式及目標影響，不能只憑單一數值判斷所有網頁是否都能存取，也不應將回應速度視為實際下載速度。

接著開啟瀏覽器，先瀏覽目前網路已知可正常存取的網頁，確認裝置本身可以上網；再瀏覽這次要測試的目標網站。請盡量重新載入頁面並發出新請求，避免將瀏覽器快取的頁面誤認為新連線成功。若只有一個網站異常，請先確認網站本身是否正常，不要立刻歸咎於整個用戶端。

  1. 測試基本網路：關閉用戶端連線後，確認已知可正常存取的網頁能否開啟。
  2. 測試伺服器：重新連線，使用 Proxy 對同一個目標發出請求，檢查目前伺服器能否完成存取。
  3. 測試規則：切回 Config，再瀏覽同一個目標，比較結果是否有所不同。
  4. 檢查處理記錄：在 Data 中查看目前介面提供的連線記錄；若能看到目標與策略，請確認是否符合預期。

查看記錄時，請讓測試動作與記錄時間相互對照。網頁可能同時向多個網域發出請求，主要網域命中規則，不代表圖片、API 或登入請求也採用相同策略。若網頁能開啟但部分內容未顯示，請先確認失敗請求使用的網域與策略，不要只擴大主要網域的規則。Data 中流量有所變化，只能表示有資料傳送，無法單獨證明特定網站命中了預期規則。

每次只調整一個變因：先固定網路、伺服器與目標網站，再切換 Global Routing。這樣才能區分「伺服器無法使用」與「規則未命中」。測試完成後，請恢復日常使用的模式，並記下可用伺服器、目前使用的 Config 及測試結果；日後發生變化時，便有依據可供比較。

05 · 常見問題：依操作順序排查

發生問題時，先確認停在哪個步驟：訂閱讀取不到項目、開關無法保持開啟、Connectivity Test 沒有回應，或只有網頁無法存取。不同狀況涉及的環節不同。建議先保留現有設定與原始資料，再依下列順序檢查，避免尚未找出原因就同時清空列表、替換 Config 和修改 DNS。

Subscribe 已儲存，但沒有伺服器

先確認 URL 是完整的伺服器訂閱連結，而不是服務商的說明頁或帳戶頁面。檢查是否多複製空格或標點、是否漏掉查詢參數，再查看更新時的錯誤提示。目前網路無法存取訂閱網址、伺服器回傳錯誤、存取憑證失效，或回傳內容不符預期，都可能導致列表空白。

「訂閱更新成功」與「伺服器可以連線」是兩個不同的檢查項目。若讀取連結失敗，請向原服務商確認連結狀態與回傳格式；若已出現伺服器項目，則繼續測試伺服器。描述問題時提供錯誤類型即可，請勿公開訂閱連結中的憑證。更多訂閱錯誤類型請參閱FAQ。

伺服器已出現，但 Connectivity Test 失敗

先關閉連線，確認目前網路可正常使用，再檢查伺服器位址、連接埠、Type 與驗證資料。手動新增的項目尤其要核對 TLS、SNI 與傳輸參數；透過訂閱匯入的項目則可先更新一次，確認目前選取的項目仍在列表中。若有其他使用者提供且已知可用的伺服器，可在相同網路及測試方式下進行比較。

伺服器在不同網路中的可連線狀況可能不同。若 Wi-Fi 下失敗、行動數據下成功，請分別記錄結果；切換網路後，先重新連線再測試。不要因一次逾時就認定所有設定都失效，也不要在沒有依據時任意修改加密或驗證欄位。

開關已開啟，但網頁無法存取

首先查看 Global Routing。Direct 模式下的請求不會因為已選取伺服器就自動改走代理；Config 模式則須檢查目前使用的設定檔及目標命中的策略。可暫時切換至 Proxy 測試同一個目標：若 Proxy 可用、Config 不可用，請優先檢查規則順序、策略指向與兜底處理；若兩者都失敗，再檢查伺服器與 DNS。

網域解析異常也可能導致網頁無法開啟。請先保留目前的 DNS 設定並記錄錯誤，確認伺服器資料正確後，再逐項調整。不要為了排查單一網域而同時修改多個 DNS 選項。若對設定檔、App Store 取得方式或使用須知仍有疑問，可分別參閱概念速查與App Store 指南；本頁僅說明首次連線所需的操作流程。

只有部分網頁或 App 異常

這類問題通常需要縮小範圍，檢查特定請求。先用瀏覽器瀏覽相同目標，再比較 Proxy 與 Config；查看 Data 中可取得的目標與策略資訊，確認異常內容是否涉及其他網域。網頁中的登入、圖片與影片可能使用不同網址，因此「首頁能開啟」不代表「所有功能都正常」。

最後，請恢復測試期間變更的 Global Routing、On Demand 與 Config 選擇。若仍需進一步協助，請整理裝置使用的網路、失敗步驟、所選模式、錯誤提示及比較測試結果，並隱去訂閱憑證、密碼與個人資料。提供可重現的操作順序，比只附上連線開關截圖更有助於找出問題。