OFFICIAL MANUAL / GETTING STARTED
Shadowrocket 使用教學：匯入與連線
先匯入現有資料，再選擇路由方式；連線後透過實際請求確認是否生效。本頁依首次操作順序編排，適用於 iPhone 與 iPad。
首次操作建議依序閱讀；若已能連線但存取異常，可直接前往測試與排查。介面項目保留英文，實際位置與可用選項請以 App 目前顯示為準。
STEP 01 / ADD SERVER
新增伺服器或匯入現有訂閱
先確認手上的資料是哪一種：可取得伺服器清單的訂閱連結，或單一伺服器的完整連線參數。兩者使用相同的新增入口，但填寫方式不同。訂閱連結不是一般網站首頁，也不是帳戶管理頁面；若無法判斷用途，請先向原資料提供者確認，不要反覆修改網址測試。
已有訂閱連結：選擇 Subscribe
開啟 Shadowrocket，進入 Home，點選右上角的加號進入 Add Server。點選類型選項，選擇 Subscribe，將現有訂閱連結完整貼入 URL。如需備註，請使用方便自己辨識的名稱；備註僅用於區分來源，不會改變伺服器的連線方式。
貼上後，先檢查網址的開頭、結尾和中間內容是否完整。聊天訊息中的換行、複製時帶入的空格，或遺漏查詢參數，都可能造成讀取失敗。訂閱連結中的認證資訊通常屬於存取憑證，請保留原樣，不要任意刪減，也不要將完整網址貼到公開討論區。確認無誤後，使用頁面上的儲存功能，返回 Home 等待讀取訂閱。
成功讀取後，確認 SERVER 清單中出現訂閱內的伺服器項目，而不只是訂閱名稱。若只看到來源紀錄，沒有可選伺服器，請先檢查訂閱更新結果與錯誤提示。資料尚未載入前，請勿開啟連線開關；路由設定無法補足缺少的伺服器資料。
已有單一伺服器資料：依相應類型填寫
若已有伺服器分享連結，可先複製完整連結，再依 App 內出現的匯入提示確認項目；若有 QR Code，可使用 Scan QR Code 讀取。辨識後仍須檢查類型與位址，不要只因匯入成功就認定參數正確。QR Code 中的認證資料同樣需要妥善保管。
手動填寫時，在 Add Server 選擇與資料相符的類型，例如 Shadowsocks、VMess 或 Trojan，再逐項輸入位址、連接埠與認證資訊。各協定所需欄位不同；加密方式、傳輸方式及 TLS 相關參數應與原始資料一致，不要將某種協定的填寫方式套用到其他協定。
儲存後返回 Home，在 SERVER 中選取要使用的伺服器。先用一筆已核對的資料完成整個流程，之後再整理名稱與分組。此時只完成「將資料加入 App」，尚未建立連線；下一步要決定如何處理這些資料所產生的請求。
STEP 02 / GLOBAL ROUTING
選擇 Global Routing 模式
返回 Home，點選 Global Routing，依用途選擇配置 (Config)、代理 (Proxy) 或直連 (Direct)。此處決定 App 如何處理請求，而不是選擇另一台伺服器。修改後返回 Home，確認目前顯示的模式，再進行下一步，避免混淆「已選取伺服器」與「已選好路由」。
配置 (Config)：依目前設定檔處理請求
需要依規則區分請求時，請使用 Config。先進入 App 的 Config 頁面，確認所需設定檔已存在且已選取。清單中看得到檔案，不代表它就是目前使用的設定；請以 App 顯示的選取狀態為準。此模式下，請求路徑取決於檔案中的規則、策略及相關設定。
例如，規則可能使用 DOMAIN-SUFFIX 比對網域後綴，使用 IP-CIDR 比對位址範圍，並以 FINAL 處理前面未匹配的請求。初次使用不必馬上編輯這些內容，但請留意：同一台伺服器可正常連線，不代表所有規則都會如預期運作。設定檔引用的策略也必須有效，不能只檢查規則關鍵字。
代理 (Proxy)：先確認代理路徑
若要單獨檢查目前的代理路徑，可暫時選擇 Proxy，確認 SERVER 中已選取要測試的伺服器，再連線並存取相同的測試目標。這有助於分別確認「伺服器連線是否正常」與「規則是否匹配預期策略」。但在此模式下，也不能據此推論每個 App、每種流量都會採用相同處理方式。
若 Proxy 可以存取目標，換回 Config 後卻失敗，請優先檢查目前設定檔、匹配順序與最終策略，而不是立刻刪除伺服器。排查完成後，記得切回日常所需模式；未確認用途前，不要一直保留暫時使用的排查設定。
直連 (Direct)：檢查直接連線情況
Direct 會直接連線，不會透過已選取的代理伺服器轉送相關請求。此模式可用來觀察原始網路的存取情況，但不能作為「代理已成功」的證據。選擇此模式後，即使系統顯示 VPN 狀態，也不代表請求經過代理伺服器；系統連線狀態與請求採用的策略屬於不同層面。
準備繼續前，請確認兩件事：目前的 Global Routing 是否符合需求；若選擇 Config，設定檔是否已選取。規則語法與設定檔各區段的詳細說明，請參閱完整官方手冊；本頁先帶你完成一個可驗證的連線流程。
STEP 03 / VPN PERMISSION
開啟開關並授權 VPN 設定
現在返回 Home。開啟連線開關前，再確認 SERVER 中的選取項目與目前的 Global Routing 模式。若頁面顯示 Not Connected，表示 App 尚未建立相應連線；此時點選連線開關，依序完成 App 與系統顯示的操作提示。
首次出現新增 VPN 設定提示時
首次連線時，系統可能會提示新增 VPN 設定。請閱讀提示中的 App 名稱與權限說明，確認目前操作的是 Shadowrocket 後，再依系統要求允許並完成裝置驗證。這項授權是讓 App 建立所需的系統 VPN 設定，不會替你產生伺服器、修復訂閱網址，也不代表連線資料已通過可用性測試。
完成授權後，返回 Shadowrocket，查看連線開關與狀態是否有所變化。若系統顯示拒絕，請返回 App 再次嘗試連線，並依實際提示處理；必要時可至系統設定中的 VPN 相關項目，確認是否已有對應設定。排查時不要刪除裝置上的所有 VPN 設定，尤其是另有工作或管理用途的設定。
分辨系統連線狀態與伺服器可用性
系統出現 VPN 圖示且開關維持開啟，表示相關系統連線處於啟用狀態，但遠端伺服器認證、網域解析及目標存取仍可能失敗。反之，若開關立即關閉或出現設定錯誤，應先處理授權、目前設定與 App 顯示的錯誤；不要立刻反覆重新整理瀏覽器，以免把多個問題混在一起。
第一次測試建議先維持手動連線方式，不要同時調整 On Demand 等自動連線選項。自動觸發條件會影響連線恢復時機，基礎連線尚未確認前不適合一併修改。完成下一步後，再依實際需求了解這些設定。
離開 App 測試存取時，請維持目前選取的伺服器與路由設定。若要更改重要參數，請先中斷連線，再修改、儲存並重新連線，才能清楚確認後續測試使用的是哪一組設定。接下來要確認的不是「開關有沒有開」，而是「目標請求是否確實完成」。
STEP 04 / CONNECTIVITY TEST
使用測試與實際請求確認是否生效
驗證可分為三個層面：App 或伺服器的測試結果、系統連線狀態，以及實際目標的存取結果，三者都要一併確認。單項測試成功，不代表所有 App 都能正常存取；單一目標失敗，也不足以證明所有連線資料都無效。
先執行 Connectivity Test，再存取實際目標
在 Home 找到 Connectivity Test，使用目前介面提供的控制項執行測試，並確認測試對象就是目前要檢查的項目。若 App 提供多種測試方式，前後比較時應使用相同方式；不同測試條件下的結果不宜直接比較。
測試有回應後，開啟瀏覽器或實際要使用的 App，前往明確的目標頁面並重新載入一次。不要只查看先前已開啟的內容，因為頁面可能是從快取載入。先完成一個目標的測試，再檢查其他用途；同時開啟太多頁面會讓請求紀錄難以對照，也不利於判斷哪些變更造成影響。
在 Data 中核對請求與策略
返回 Shadowrocket，進入 Data，查看與剛才操作時間及目標相符的請求紀錄。若紀錄詳細資訊包含匹配規則、策略或連線資訊，可據此判斷請求採用的路徑。使用 Config 時，請重點確認匹配的規則是否符合預期，而不是只根據總流量變化下結論。
例如，某個請求原本應使用代理，但相關紀錄顯示 DIRECT，就應檢查規則匹配與先後順序；若策略符合預期但連線失敗，再檢查該策略實際使用的伺服器與相關參數。請注意，紀錄中出現請求，只代表 App 偵測到這次活動，不一定表示遠端已傳回完整內容。
建立可重複的測試方式
確認目標可完成實際操作，例如重新載入頁面，或讓 App 正常取得所需內容；接著記下本次使用的模式、伺服器選擇與測試目標。無須保存完整訂閱網址或認證資料。日後發生異常時，以相同條件重新測試，結果才有比較基準。
若 Connectivity Test 成功但實際存取失敗，請在下一節依序檢查目標解析、規則與伺服器參數。若實際存取正常但某項測試失敗，也請先確認測試方式與對象；不要只為了讓所有測試結果一致，就改動原本正常的設定。
STEP 05 / CHECK ONE CHANGE AT A TIME
依錯誤狀況定位，逐項調整
從最早出現問題的環節開始排查。先記錄目前狀況，每次只修改一個條件，再重做相同測試。若同時更新訂閱、更換伺服器、編輯規則並切換網路，即使恢復存取，也很難找出真正原因；下次遇到問題時仍無從判斷。
訂閱無法讀取，或更新後項目異常
先中斷連線，確認原始網路能正常存取平時使用的頁面，再檢查訂閱網址是否完整、是否仍有效，以及 App 顯示的更新錯誤。若訂閱需要認證，或原服務資料已變更，請向你原有的服務商確認。不要自行修改網址中的認證內容，也不要因讀取失敗就嘗試來源不明的資料。
更新前可記下原本選取的項目名稱；更新後若該項目遭移除或更名，請重新選取目前清單中的有效伺服器。訂閱更新主要會變更伺服器資料，不代表目前 Config 中的規則與策略引用也已同步調整。
開關無法維持開啟，或系統設定發生錯誤
先查看 App 的錯誤提示，確認已完成首次 VPN 設定授權，再檢查系統 VPN 相關設定中的對應項目。若同時啟用了其他會影響系統 VPN 的設定，請先確認目前作用中的連線，減少同時存在的條件後再試。若涉及裝置管理限制，請遵循裝置的管理規範，不要任意移除管理設定。
若需要重新建立 Shadowrocket 的系統 VPN 設定，請先保留 App 中的伺服器與設定資料，並只處理對應項目。系統 VPN 設定與 App 內的伺服器清單並非同一份資料；刪除系統連線項目無法修復伺服器參數。
已連線，但無法存取目標
先確認目前不是為排查問題而暫時選取 Direct，再檢查所選伺服器。手動輸入的項目應逐一核對類型、連接埠、認證與傳輸參數，特別留意複製時遺漏的欄位。不要為了取代參數核對而隨意關閉 TLS 驗證；遇到憑證錯誤時，請參照原始資料與 App 提示查明原因。
接著比較相同目標在 Proxy 與 Config 下的情況。前者正常、後者異常時，請優先檢查是否已選取設定檔、規則順序及策略引用；兩者都失敗時，再檢查伺服器、原始網路與目標本身。比較完成後，請恢復日常所需模式。
只有部分目標失敗，或切換網路後出現異常
部分目標發生問題時，請在 Data 中找到實際失敗的請求，核對網域解析、規則匹配與連線錯誤。不要只根據頁面的主網域，就認定整個頁面都採用相同路徑；同一頁面也可能請求其他網域。先找出失敗的項目，再決定是否需要調整規則。
若問題只在某個 Wi-Fi 或行動數據網路發生，請維持伺服器與設定不變，只切換網路重新測試。切換後可手動中斷並重新連線，觀察錯誤是否再次出現。這項比較可協助縮小問題範圍，不代表特定網路一定有問題，也不表示伺服器能長期維持可用。
完成上述流程後，應能分辨資料匯入、系統連線與實際請求這三個環節。接下來若要了解 On Demand、設定檔各區段與日常維護，請繼續閱讀新手到進階官方手冊；若要重新確認基本操作，請返回本教學的新增與匯入步驟。