Shadowrocket 使用教學

步驟一：使用 Add Server 與 Subscribe 匯入

開啟 Shadowrocket 後，先進入 Home。此頁可查看現有伺服器、選取目前使用的項目及控制連線。初次使用時，先確認手上的資料是哪一種：用來更新伺服器清單的訂閱 URL，或包含協定、位址、連接埠與驗證欄位的伺服器資料。兩種資料的填寫位置不同，請勿將訂閱 URL 當成伺服器位址，也不要把一般網頁網址填入 Subscribe。

已有訂閱：選擇 Subscribe，填入完整 URL

在 Home 點選右上角的新增按鈕，開啟 Add Server，並在 Type 中選擇 Subscribe。返回填寫頁面後，將向自己的服務供應商取得的訂閱連結完整貼入 URL 欄位。備註可用來辨識來源，填入自己看得懂的名稱即可。儲存前檢查網址首尾是否完整，尤其不要漏掉問號後的參數，也不要連同聊天訊息中的空格、換行或說明文字一起貼上。

以下地址僅用來示範 URL 的格式，不能用來匯入實際伺服器。真正的訂閱 URL 通常含有存取憑證，請視同密碼保管，不要放進公開截圖、群組聊天或故障說明中。

https://example.com/sub?token=xxxx

儲存後回到 Home，等待讀取訂閱完成，再確認相應群組中是否出現伺服器項目。儲存訂閱記錄，不代表已成功取得伺服器清單。如果群組仍是空的，先確認 URL 是否指向訂閱內容、訂閱是否有效，以及本機網路能否連上該網址。若要更新現有群組，請從該群組的操作選單執行更新，再確認清單是否變更；不要重複新增相同訂閱，以免產生多個群組，難以判斷目前使用的是哪一份。

已有伺服器資料：依協定逐項填寫

如果手上是單一伺服器的參數，請在 Add Server 的 Type 中選擇實際使用的協定，再填入相應欄位。Shadowsocks、VMess、VLESS、Trojan 等協定的驗證方式各不相同，請以原始資料為準，不要因欄位留白就自行補上數值。伺服器位址欄位通常只填主機名稱或 IP，連接埠則分開填寫；密碼、UUID、加密方式、傳輸方式及 TLS 相關參數都必須與伺服器端一致。

遇到 SNI、Host 或傳輸路徑等欄位時，請逐項核對提供的資料。這些欄位不一定與連線位址相同，不要把同一個網域名稱照搬到所有欄位。也不要為了排除錯誤而任意放寬憑證檢查。填寫完成後儲存，返回 Home 確認項目已出現，再點選準備使用的伺服器。如果只收到一條伺服器分享連結，可使用應用程式提供的連結匯入入口；QR Code 資料則可透過 Scan QR Code 讀取，匯入後仍須核對欄位。

完成後，應能在 Home 找到訂閱群組及其中的伺服器，或看到手動儲存的獨立項目。暫時不要批次重新命名、合併群組或設定自動切換，先保留一個參數明確的伺服器供後續驗證。協定欄位的說明可參閱概念速查；訂閱用於取得與更新伺服器資料，Config 則負責連線策略，兩者內容不同。

步驟二：選擇 Global Routing 模式

儲存伺服器後，在 Home 開啟 Global Routing。此處決定連線如何處理請求，不能只看目前選取的伺服器，就判斷所有請求會經過哪裡。三種模式分別是設定(Config)/代理(Proxy)/直連(Direct)。先確認選項，再開啟連線，後續測試才有明確的判斷依據。

• 設定(Config)：依照目前啟用的設定檔規則選擇策略。不同請求可能分別符合 PROXY、DIRECT 或 REJECT；選取伺服器不代表每個請求都會經過該伺服器。
• 代理(Proxy)：將請求交由目前的代理策略處理，適合暫時確認所選伺服器能否實際存取；但不能取代對規則命中結果的驗證。
• 直連(Direct)：請求直接連線。即使連線開關已開啟，也不能據此認定請求正在經由所選伺服器傳送。

如果要依規則使用，請先切換到 Config 頁面，查看目前有哪些設定檔，並確認哪一份已啟用。只將設定檔加入清單並不足夠，還須確認實際選取了該設定檔。開啟設定檢查規則時，先確認用途與來源；不要只為了完成首次連線，就匯入整份自己看不懂的設定。設定中的策略引用也必須對應現有伺服器或策略設定，否則即使規則正確，處理結果仍可能不如預期。

對於剛匯入的伺服器，可以先記下原本的 Global Routing 選項，再暫時切換至代理(Proxy)進行基本連線測試。完成後若要使用規則分流，請切回設定(Config)，並重新測試目標請求。依此順序，可分開確認「伺服器能否使用」與「規則是否依預期處理」，避免同時排查兩種問題。

本頁不會完整說明規則寫法。只要理解「Global Routing 決定處理模式，Config 中的規則會在相應模式下參與判斷」即可。需要設定 DOMAIN-SUFFIX、IP-CIDR 或 FINAL 時，請閱讀規則手冊，先了解由上而下的比對順序，再修改設定。調整前請保留原有設定，避免首次測試時同時更動伺服器、規則與 DNS。

步驟三：在 Home 開啟連線

返回 Home，確認目前選取的伺服器，以及剛才設定的 Global Routing。訂閱清單中可能有多個名稱相似的項目，請先選取這次要測試的伺服器，再開啟頁面上的連線開關。如果使用由設定檔定義的策略選擇，也要確認策略實際指向的目標，不要只憑清單名稱判斷。

首次連線時，iPhone 或 iPad 可能會顯示新增 VPN 設定的系統授權提示。這是應用程式透過系統網路功能建立連線所需的確認步驟，不是訂閱帳號登入頁面。確認提示中的應用程式是 Shadowrocket 後，依系統要求允許，並視需要完成裝置身分驗證。授權由系統介面處理，請勿將裝置解鎖密碼填入伺服器密碼或訂閱 URL 欄位。

完成授權後返回 Shadowrocket，確認連線開關與狀態是否維持連線。如果先前取消授權，可再次開啟連線開關並依提示操作。若裝置受到管理政策限制、系統不允許建立設定，或已有其他 VPN 連線正在使用，請先查看系統提示並確認限制來源，不要快速反覆切換開關來掩蓋問題。

系統顯示 VPN 已連線，只代表相關連線已建立，無法保證目標伺服器或每個網站都能正常使用。不同裝置上狀態圖示的位置可能不同，因此接下來仍須在應用程式內確認並發出實際請求。首次驗證期間建議維持手動連線，暫時不要調整 On Demand，以免網路切換時的自動連線行為影響判斷。確認基本連線正常後，再依自己的網路使用習慣設定按需連線。

步驟四：使用 Connectivity Test 與實際存取驗證

開啟連線後，先在 Home 使用 Connectivity Test，確認準備使用的伺服器是否可連線。測試時請確認選取的是目前的項目，而非其他群組或舊紀錄。測試結果有助於縮小排查範圍，但測試方式與實際網頁請求並不完全相同；一次測試成功，不代表所有網站都能正常存取，也不要只依單一延遲數值判斷使用體驗。

接著切換到瀏覽器，開啟一個你熟悉且內容能正常確認的網頁，手動重新整理並繼續開啟其中一個頁面。已載入的舊頁面可能來自快取，不適合作為唯一判斷依據。先選少數穩定的目標完成測試，不要同時開啟許多應用程式，以免產生額外請求。如果只有一個網站無法使用，請保留其他網站的測試結果，不要立即認定整條連線失效。

使用設定(Config)模式時，還須確認請求是否套用預期的策略。返回 Shadowrocket 的 Data 查看可用的連線紀錄，依請求網域、發生時間及紀錄中顯示的策略資訊進行比對。先發出一次明確的存取請求，再查看相應紀錄，比起在大量背景請求中猜測，更容易判斷。實際紀錄欄位請以目前的應用程式介面為準。

如果請求符合 DIRECT，網頁能開啟並不能證明代理伺服器可用；如果符合 REJECT，也不能只因頁面載入失敗就認定伺服器參數錯誤。要驗證代理本身時，可暫時切換至代理(Proxy)，對同一目標重新測試，再切回原本模式。如果 Proxy 模式正常、Config 模式異常，應優先檢查設定與規則，不要反覆重新匯入訂閱。

最後進行一次可重複的檢查：關閉連線，確認本機網路狀況；重新開啟後，使用同一台伺服器、相同模式與同一個網頁測試，並記錄差異。不要把帳號登入狀態、內容顯示地區或單一頁面提示當成唯一依據，這些也可能受到帳號與快取影響。能說明「目前選取的項目、請求符合的策略，以及實際存取結果」，才算完成這次驗證。

步驟五：依故障環節逐項檢查

遇到連線失敗時，先判斷問題出在哪個環節：訂閱尚未匯入、伺服器測試失敗、系統未建立連線，或連線後特定請求異常。每次只修改一個條件，修改後立即重新測試。同時更換網路、伺服器與設定，會讓測試結果失去判斷依據。以下依由近到遠的順序檢查，找到原因後即可停止，不必繼續修改其他項目。

先確認本機網路與訂閱讀取狀況

先暫時關閉 Shadowrocket 連線，並用瀏覽器確認本機網路本身可正常使用。公共 Wi-Fi 可能需要先登入網路；如果切換到其他網路後情況不同，請記錄差異，再使用同一台伺服器重新測試。本機網路尚未連通前，不要反覆重新整理訂閱。

若 Subscribe 儲存後沒有出現項目，請重新確認 URL 是否完整、是否誤填帳號頁面的網址，以及訂閱是否仍有效。如果已有清單但更新失敗，先保留目前可用的資料並查看更新錯誤，不要立刻刪除整個群組。更新訂閱只會重新取得伺服器資料，不能證明其中每台伺服器都可連線，也不代表已切換目前使用的項目。

接著核對協定參數與系統時間

如果 Connectivity Test 持續失敗，請逐項比對 Type、位址、連接埠與驗證欄位，再檢查 TLS、SNI 與傳輸參數。優先對照自己的原始伺服器資料，不要根據伺服器名稱猜測協定。更新訂閱後仍有異常，也要確認目前選取的是更新後的項目。不要隨意更改連接埠、密碼或憑證選項來碰運氣。

確認裝置系統時間是否正確，必要時到系統設定中檢查日期與時間。時間不準可能影響憑證有效期判斷及部分驗證流程。測試逾時也可能是目前網路至伺服器的連線路徑或伺服器本身狀態所致，單次結果無法判定問題來源；使用相同參數在另一個可用網路重新測試，有助於縮小問題範圍。

連線已建立時，檢查模式與啟用的設定

如果連線開關能維持開啟，但網頁結果不如預期，先返回 Global Routing。確認目前不是直連(Direct)，也沒有在暫時測試後忘記切回設定(Config)。接著前往 Config 確認啟用的設定檔，再查看目標請求符合的策略。若只有特定網域異常，應搭配規則與網域解析一併檢查，不要立即重置所有設定。

如果懷疑是設定問題，請保留原始檔案，改用用途明確的設定檔或暫時切換至代理(Proxy)模式進行比較。比較時使用同一台伺服器與同一個目標，測試後恢復原狀。設定區段、策略說明與比對優先順序詳見Shadowrocket 規則與設定參考；Subscribe、Config 與 Connectivity Test 的概念差異可參閱概念速查。

記錄結果，再繼續調整

如果仍無法找出原因，請整理故障發生的具體步驟、本機網路類型、Global Routing 模式、測試目標及畫面上顯示的錯誤訊息。向自己的服務供應商確認伺服器狀態時，只提供排查所需資訊，並隱藏訂閱 URL 中的憑證、密碼與個人資料。請勿將完整訂閱連結貼到公開問題描述中。

穩定連線一次後，再逐項加入自己的規則、訂閱更新習慣與 On Demand 設定。每次調整都保留可還原的設定，並以相同目標重新測試。日後遇到異常時，依本頁「匯入 → 模式 → 連線 → 驗證」的順序逐一檢查，通常比刪除所有項目重新設定更容易找出變化原因。