Shadowrocket 使用教學
從已有資料開始，依序完成新增、選擇模式、連線與驗證。先建立一條可重複測試的連線，再調整規則與自動化設定。
開始前 / 準備事項
準備 App 與現有連線資料
本文只介紹 iPhone 與 iPad 的首次使用流程。裝置相容性與系統需求請以 App Store 頁面標示為準；若尚未完成購買與安裝，請先閱讀正版辨識與安裝說明，再回到本頁。操作前請保留原始資料；修改現有設定時，先備份一份，避免覆蓋原本可用的設定。
訂閱連結是用來取得伺服器清單的網址；單筆伺服器資料通常包含協定、位址、連接埠與驗證欄位。兩者的輸入入口相近，但填寫方式不同。先確認手上是哪種資料，再選擇下方相應的步驟。不要把整段訂閱網址填入伺服器的 Host，也不要把單筆參數當成設定檔匯入。
本頁圖片均為 App Store 官方截圖，供辨認頁面與欄位使用。App 內項目可能因目前設定、協定與介面語言而異，請以裝置實際顯示為準。完成前四個步驟後，再設定 On Demand 等自動化功能；首次排查問題時，盡量不要變更網路環境。
01 / Add Server · Subscribe
Add Server：新增伺服器或匯入訂閱
開啟 Shadowrocket 並停留在 Home。下方的 SERVER 分組會顯示伺服器項目，點選 Add Server 進入輸入頁面。接下來請選擇一種匯入方式：已有訂閱連結就選 Subscribe；已有完整的單筆伺服器參數，則選擇相應協定。QR code 也必須來自自己已有的資料；掃描後仍應檢查內容，不要只憑顯示名稱判斷參數是否正確。
已有訂閱連結：選擇 Subscribe
- 進入 Add Server，點選 Type，並在類型清單中選擇 Subscribe。
- 在 URL 欄位貼上完整的訂閱連結。貼上後檢查開頭、結尾與查詢參數，避免複製時一併貼入說明文字、換行，或遺漏字元。
- 儲存並返回 Home，等待訂閱內容載入完成，再確認 SERVER 分組下是否出現項目。
訂閱網址可能包含存取憑證，請勿將完整連結貼到公開討論區或截圖中。若儲存後沒有出現項目，先查看是否有載入失敗提示，再向提供原始資料的一方確認連結是否有效，以及內容是否適用於 Shadowrocket。單純重新命名訂閱無法修正錯誤網址；反覆新增相同訂閱也會增加辨識難度，請先檢查現有項目。
日後需要更新訂閱時，更新現有訂閱即可，再檢查清單中的伺服器是否有變化。更新訂閱可同步清單，但不代表所有連線問題都已修復。更新後若原先選取的項目已被移除，請重新選擇現有項目，再繼續測試連線。
已有伺服器參數：逐項確認 Type
在 Add Server 中先設定 Type，再填入 Host、Port 與該協定要求的驗證欄位。官方截圖示範的表單包含 Password、Method；選擇其他 Type 時，欄位也會不同，請勿將截圖當成所有協定通用的填寫範本。Host 請填伺服器網域名稱或位址，Port 則依原始資料填寫，不要自行猜測或沿用其他項目的數值。
例如，Shadowsocks 的 Method 與 Password 必須符合原始參數；Trojan、VLESS 等類型若有 TLS、SNI 或其他傳輸欄位，也應逐項依資料確認。不要為了避開錯誤而任意關閉憑證驗證。若看不懂協定欄位，請先查閱概念速查，確認意思後再修改。
若資料是 QR code，可使用 Scan QR Code；Import from Cloud JSON 則是另一種結構化資料匯入方式，不是輸入一般訂閱連結的替代入口。儲存後返回 Home，確認 SERVER 中已有可選項目。此時僅完成資料輸入，尚未確認伺服器可用；下一步先決定要以哪種模式處理請求。
02 / Global Routing · Config
Global Routing：先了解三種模式
返回 Home，點選 Global Routing。這裡設定的是請求處理方式，不是新增伺服器，也不能取代伺服器驗證。首次使用時，請分清設定檔（Config）、代理（Proxy）與直連（Direct），否則容易把「模式與預期不符」誤判為「匯入失敗」。
| 模式 | 處理方式與確認事項 |
|---|---|
| 設定檔（Config） | 依目前啟用設定檔中的規則與策略處理請求。請先確認 Config 頁選用了哪個檔案。 |
| 代理（Proxy） | 以代理方式處理請求，適合暫時檢查目前的代理路徑。實際處理範圍仍受 App 與系統限制。 |
| 直連（Direct） | 採用直連方式，不應以預期的代理效果作為此模式的驗證目標。 |
使用 Config 前，先確認目前的設定檔
若已有要使用的設定檔，請進入底部的 Config 頁，確認檔案已存在且已選用；將檔案加入清單，不代表它已成為目前生效的設定檔。若要查看內容，請開啟相應檔案的編輯頁面，辨認 General、Rule 等區段。右側官方截圖顯示的是設定檔編輯內容，不表示首次使用就必須逐段手動編寫。
伺服器訂閱與規則設定是兩種不同資料：前者主要提供連線項目，後者則決定 DNS、比對規則及相關行為。匯入訂閱後，不代表已取得完整的分流規則。若尚未準備設定檔，可暫時使用代理（Proxy）檢查連線，確認伺服器路徑可用後，再回到設定檔（Config）整理規則；測試結束後，請切回原本需要的模式。
先掌握基本規則，不必急著增加複雜設定
以下兩行是閱讀範例，不需要在首次連線時貼上。範例用來說明，同一條連線可能因請求目標不同而套用不同策略。修改任何檔案前，請先確認現有設定的策略安排。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT第一行以網域後綴比對 example.com 及其子網域，符合時使用 PROXY；第二行 FINAL,DIRECT 表示前面的規則都未符合時使用 DIRECT。example.com 僅為語法範例。Rule 的順序會影響結果，因此要確認某個網站是否經過代理，不能只看選取了哪台伺服器，也要確認該請求符合哪條規則。
這個階段只要記住目前的模式與設定檔名稱即可。若要了解 General、Rule、Host 與 URL Rewrite 的完整寫法，請接著閱讀規則與設定參考；現在先返回 Home，保留已確認的選項，準備建立連線。
03 / Home · SERVER
Home：選取伺服器並開啟連線
返回 Home，在 SERVER 分組點選這次要使用的伺服器，確認選取標記位於目標項目上。清單中有某個項目，不代表目前正在使用它；尤其訂閱包含多個項目時，請先確認本次選擇，避免測試時反覆切換而無法比較結果。
- 確認 Global Routing 是否設為上一步選定的設定檔（Config）或代理（Proxy）。若選擇設定檔（Config），請再次確認 Config 中目前使用的檔案。
- 開啟 Home 頂端的連線開關。首次建立連線時，系統可能會提示新增 VPN 設定，請閱讀提示後允許，並依裝置要求完成身分驗證。
- 返回 Shadowrocket，確認頂端狀態是否從 Not Connected 變為已連線，並查看開關是否維持開啟。
VPN 設定授權是 App 建立系統網路連線所需的步驟，不會自動補齊伺服器欄位，仍須使用自己已有的連線資料。若剛才選了取消，請返回 Home 重新開啟連線開關，並完成系統提示。不要因為一次取消授權，就刪除所有伺服器或重建設定檔。
若開關立刻關閉，請先確認系統授權是否已完成，再檢查是否有其他正在運作的 VPN 設定影響目前連線。只需確認現有設定，不要直接大量刪除裝置的網路設定。若系統畫面仍顯示異常，請先中斷連線、返回 App 確認資料，再重新連線一次。
開關維持開啟，只能表示連線流程已進入相應狀態，不能單獨證明目標網站可正常瀏覽，也不能證明每項請求都依預期分流。請先維持目前的伺服器、模式與網路環境，再使用 Connectivity Test 和瀏覽器交叉驗證。
04 / Connectivity Test
驗證連線：分別確認測試結果與實際瀏覽狀況
在 Home 點選 Connectivity Test，查看測試是否有結果。這項測試可提供連線狀況的線索，不代表已完整驗證所有網站、協定與規則。若測試失敗，仍需繼續排查；即使測試有結果，也應開啟瀏覽器檢查實際使用的目標。
- 先瀏覽一個在目前網路環境下原本就能開啟的頁面，確認基本網路正常。若基本網路本身中斷，應先恢復網路，不要繼續修改代理參數。
- 接著瀏覽一個依目前模式或規則預期應使用代理的目標頁面。重新整理頁面或發出新請求，不要只根據先前載入或快取的頁面判斷。
- 若使用設定檔（Config），請依規則確認該目標應使用 PROXY、DIRECT 還是 REJECT。必要時查看 App 可用的請求記錄，再與預期結果比較。
「頁面能開啟」和「頁面經過代理」並不是同一回事。設定中的 DIRECT 本來就允許部分請求直連；若目標符合直連規則，即使頁面可瀏覽，也不能據此證明代理路徑正常。同樣地，頁面載入不完整，可能是不同網域分別符合不同規則所致。請先找出失敗的請求，不要立刻替換全部規則。
若要進一步區分伺服器問題與規則問題，可記下原本的模式，暫時切換為代理（Proxy），中斷連線後重新連線，再瀏覽同一個目標。Proxy 可用但 Config 不行時，優先檢查目前的設定檔、DNS 與規則；兩者都失敗時，優先檢查伺服器參數與網路狀況。這只是縮小排查範圍的方法，不能據此定論原因。
驗證完成後，請切回日常所需的 Global Routing 模式，並再次實際瀏覽。若問題仍在，請歸類為以下階段：資料未匯入、無法建立連線、連線後所有目標都失敗，或只有部分目標失敗。依階段排查，比反覆切換開關更容易找出原因。
05 / Settings · Diagnostics
常見問題：依故障階段排查
先記下問題發生在哪個步驟，再到 Settings 找相關診斷入口。Test Method 會影響測試方式，不同方法可能得到不同結果；On Demand 則用於依條件連線，並非首次手動連線的必要步驟。首次排查時，先用手動開關重現問題，避免自動連線行為影響判斷。
匯入後沒有項目：檢查資料類型與連結
若 Home 的 SERVER 分組沒有新增內容，請回到訂閱項目確認 Type 是否為 Subscribe、URL 是否完整，以及是否出現內容載入失敗提示。確認目前的基本網路可正常使用，並向原始資料提供者確認資料是否有效。若是手動新增，請確認已儲存，而非仍停留在編輯頁面；欄位缺漏時，應依原始資料補齊，不要猜測數值填入表單。
開關無法維持開啟：先確認系統授權
確認系統新增 VPN 設定的提示已完成，裝置並未停留在待驗證狀態，再返回 Home 重新操作。若裝置受管理政策限制，請依裝置管理規定處理。這類問題發生在建立連線階段，應優先檢查系統狀態，而非先修改 Rule 或 URL Rewrite；調整規則無法取代系統授權。
已連線但所有目標都無法瀏覽：檢查伺服器與 DNS
重新開啟所選伺服器的編輯頁面，依序比對 Type、Host、Port、驗證欄位及 TLS 相關項目。網域無法解析、伺服器暫時無法連線或驗證資料不符，都可能導致連線後無法使用。訂閱使用者可先更新現有訂閱，再確認選取的項目仍存在；若原始資料已有變動，請以目前有效的資料為準。
接著檢查 Global Routing 與 Config 中的 DNS 設定。若先前手動修改過 DNS，請先記下變更，再恢復到已知可用的設定進行比較；不要同時新增多個未確認的解析位址。DNS 只負責解析流程的一部分，修改解析設定無法修復錯誤的密碼、連接埠或伺服器憑證問題。
只有部分目標失敗：檢查規則與測試範圍
若代理（Proxy）可以瀏覽而設定檔（Config）不行，請先檢查目標符合的規則、規則順序與最後的 FINAL 策略。較寬泛的規則若排在前面，後續的具體規則可能無法比對；REJECT 也可能是設定明確指定的結果。請先在副本中做最小幅度的調整，再重新發出目標請求驗證，不要直接清空原始檔案。
若 Connectivity Test 與瀏覽器結果不一致，請到 Settings 確認 Test Method，並確認兩次測試的目標與網路環境是否一致。若要進一步分析，可查看 Diagnostics；診斷內容僅供參考，仍須搭配伺服器參數與規則判斷。分享前，請移除完整訂閱 URL、Password、驗證參數與可辨識個人身分的資訊，只保留錯誤現象及必要欄位名稱。
若仍無法找出原因，請整理「目前模式、是否完成授權、測試結果、失敗目標、最近一次修改」等資訊，並接著查看疑難解答。若要逐行檢查設定，請閱讀規則參考。先保留一組可重複驗證的設定，再逐項增加功能，避免讓入門問題變成多項設定彼此影響。
