Shadowrocket 入門指南
匯入訂閱、選擇模式與首次連線。依照五個步驟操作，先驗證一條可用路徑，再調整規則。
本頁僅說明首次使用需要完成的操作；設定欄位與比對順序請參閱設定欄位參考。
新增伺服器與訂閱
先將現有資訊儲存至客戶端。匯入成功只代表項目已新增，能否連線仍需後續驗證。
從 Home 開啟 Add Server
開啟 Shadowrocket，停留在 Home。找到 SERVER 群組下方的 Add Server，點選後進入新增頁面。先確認手邊的是訂閱連結、單一伺服器分享資訊，還是一組需要手動填寫的連線參數。這三種資料用途不同，請勿將訂閱網址填入伺服器的 Host，也不要將單一分享資訊當成設定檔匯入。
如果資料來自自己的服務商，請先閱讀隨附說明，確認通訊協定、有效狀態，以及是否需要補充參數。訂閱連結通常包含存取憑證，請完整複製，並留意聊天軟體可能附加的空格或換行。不要將連結提交至公開頁面，也不要為了檢查格式而貼到不明網站。
已有訂閱：使用 Subscribe
在 Add Server 中點選 Type，選擇 Subscribe，再將自己的完整訂閱連結填入對應的 URL 欄位；如有備註欄位，可填寫便於辨識的名稱。確認連結末尾沒有缺字後儲存，等待客戶端取得內容。完成後返回 Home，檢查是否出現訂閱群組及其中的伺服器項目。若群組名稱存在但沒有項目，請勿反覆開啟連線開關，應先確認訂閱是否成功解析。
更新訂閱會從原始網址重新取得伺服器清單，不代表服務有效期限延長。首次匯入失敗時，先確認裝置本身可以連上網路，再檢查連結是否過期或複製不完整；不要連續建立多個相同訂閱，以免之後選錯群組。更新方式與錯誤原因請參閱訂閱更新說明。
手動填寫或掃描現有 QR Code
如果取得的是伺服器參數，請在 Type 選擇與資料相符的通訊協定，再依要求填寫 Host、Port，以及該通訊協定所需的 Password、Method 或其他欄位。不同 Type 顯示的欄位各異，截圖中的欄位不是所有通訊協定都必須填寫的通用清單。不要只憑伺服器名稱猜測通訊協定，也不要任意更改連接埠、加密方式或傳輸參數。
如有 QR Code，可使用 Scan QR Code 掃描，並依系統提示允許存取相機。掃描後先核對辨識出的類型與位址，再儲存。Import from Cloud JSON 是另一個匯入入口，只有資料明確要求使用此格式時才選擇；不要將一般訂閱網址依序嘗試填入所有入口。儲存並返回 Home 後，在 SERVER 中點選準備使用的項目，再進入下一步選擇模式。
選擇 Global Routing
伺服器決定代理連線使用哪個項目，Global Routing 決定請求採用哪種處理方式。兩者需要分別確認。
辨識三種常用模式
返回 Home，點選 Global Routing，先辨識 Config、Proxy、Direct 三種模式。Config 依目前生效設定中的規則分流；Proxy 讓請求採用代理路徑，方便初步檢查所選伺服器；Direct 則直接連線，不能用來證明代理出口已生效。切換模式不會修正錯誤的伺服器密碼，也不會自動補齊設定檔。
第一次操作時，如果已有明確用途的設定檔，請選擇 Config，並檢查目前選取的設定檔。如果暫時只想確認伺服器能否使用，可短暫選擇 Proxy 做瀏覽對照，測試完成後再切回日常需要的模式。請勿在不清楚目前模式的情況下，同時修改伺服器與規則，否則即使恢復連線，也難以判斷是哪項調整發揮作用。
在 Config 核對目前設定
進入 Config，找到準備使用的設定檔，確認它是目前選用的設定，再查看其中的 Rule。官方截圖展示設定編輯頁中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段；這些區段各有用途，首次連線不需要逐項修改，也不需要為了完成本教學開啟 HTTPS Decryption。設定檔與伺服器訂閱並非同一份資料，匯入訂閱不代表已設定好規則。
以下 Rule 片段僅用於理解語法：瀏覽 example.com 及其子網域時使用 PROXY，其餘請求交由 FINAL 指定的 DIRECT。這不是完整設定檔，也不是適用於所有網路環境的預設規則。規則通常依清單順序檢查，較早符合的規則會影響結果，FINAL 應作為末尾的後備規則。需要新增規則時可使用 Add Rule，但應先了解所選類型的比對範圍。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT請先保留一份可正常使用的原始設定，再進行單項修改。如果不確定 DOMAIN-SUFFIX、IP-CIDR 或策略名稱的含義，請先閱讀規則與設定參考；本頁接下來會先完成連線與驗證，不要求立即編寫一整套分流規則。
開啟開關並連線
完成項目與模式選擇後，再處理系統權限。連線開關與實際瀏覽結果需要分別檢查。
確認 SERVER 與頂端開關
返回 Home，查看 SERVER 中目前選取的項目是否屬於剛才新增的訂閱或伺服器。若訂閱中包含多個項目，先選擇一個已知可用的項目，不要在連線過程中連續切換。再確認 Global Routing 保留的是上一階段選擇的模式。截圖頂端顯示 Not Connected，代表尚未連線的狀態範例，並非匯入失敗的提示。
點選頂端的連線開關。首次連線時，系統可能會顯示新增 VPN 設定的授權提示；閱讀提示後選擇允許，並依系統要求使用裝置密碼或生物辨識完成確認。此處授權是讓 Shadowrocket 建立系統連線設定，並非再次匯入訂閱，也不是購買伺服器服務。授權完成後返回 Home，等待狀態變更，再進入下一步測試。
無法連線時先檢查權限
如果剛才拒絕了提示，請返回 App 重新嘗試連線，並依實際出現的系統提示完成授權。若開關立刻回到關閉狀態，先檢查系統設定中的 VPN 設定是否仍存在，以及是否有其他正在執行的 VPN 連線造成衝突。不要反覆刪除所有系統網路設定；先記下具體提示，再參閱常見問題確認處理方式。
連線狀態變更代表系統連線流程已啟動，但不保證目標伺服器、網域解析與分流規則都正常。系統狀態列的 VPN 標記也不能取代網頁瀏覽測試。請先保持伺服器、模式與設定不變，進行下方的驗證步驟，發生問題時才能有穩定的對照條件。
驗證連線與規則
分別檢查測試結果、實際瀏覽與規則命中狀況，避免將單一狀態標記視為全部結論。
先測試，再瀏覽實際網頁
在 Home 點選 Connectivity Test，等待測試完成。測試採用的方式會影響結果：某項測試沒有回應，不一定代表所有 App 都無法連線；顯示測試結果，也不代表每個網域都會符合預期規則。先記錄這次結果，不要因此立即大量刪除伺服器。如需查看測試方式，可到 Settings 中辨識 Test Method，首次驗證期間盡量不要變更。
接著開啟瀏覽器，先瀏覽平常確定可用的網頁，確認裝置仍具備基本網路連線能力；再瀏覽依目前設定應走代理的網頁，等候頁面實際載入，而非只看舊分頁留下的內容。必要時重新載入或開啟新分頁，減少快取對觀察的干擾。如果使用 Direct，即使該網頁能開啟，也不能證明代理路徑可用，必須配合目前模式判斷。
以單一變更進行對照
如果 Proxy 可以瀏覽，但 Config 不行，請先使用同一個伺服器，檢查目前設定的規則、解析設定與最終策略。如果兩種模式都無法瀏覽，應優先回頭核對伺服器資訊與可用性，而不是繼續增加規則。在 App 提供的連線記錄或 Data 中查看目標請求時，請確認目標網域、命中的規則與策略是否符合預期；如果沒有看到記錄，也不要僅憑猜測認定請求已經經過代理。
完成驗證的標準是：選取的項目正確、連線狀態穩定、實際頁面能夠載入，需要分流的請求採用預期策略。完成這些檢查後，再切回日常使用的 Config 並重新測試一次。之後若要使用 On Demand，請另外設定適用的網路條件；此功能會依條件觸發連線，不是伺服器無法使用時的修復開關。
排查常見問題
每次只變更一個條件。先檢查資料與伺服器，再檢查權限、模式、DNS 與規則。
訂閱沒有內容或伺服器無法使用
如果匯入後沒有出現伺服器，先回到訂閱編輯頁面檢查連結是否完整、資料格式及更新錯誤提示。訂閱已失效、回傳內容不是伺服器清單、裝置無法存取訂閱網址，都可能造成匯入失敗。如果清單正常但某個項目連線失敗，請核對 Type、Host、Port 與驗證資訊；必要時向自己的服務商確認該項目的有效狀態。清單能夠更新和伺服器能夠連線是兩回事，不能互相取代。
開關無法開啟或連線後無法瀏覽
開關無法開啟時，先檢查系統 VPN 授權與 App 提示；開關已開啟但網頁無法瀏覽時，先保持目前伺服器不變，確認 Global Routing 沒有停在與預期不符的 Direct，再分別對照 Proxy 與 Config。如果裝置中斷 Shadowrocket 連線後也無法瀏覽一般網頁，應先處理 Wi-Fi、行動網路或系統網路問題，而不是繼續修改客戶端參數。
只有部分網域或 App 連線失敗
部分目標連線失敗時，請記錄具體網域、發生問題的網路環境，以及是否只在 Config 下出現。檢查目前設定中的 DNS 與 Rule，但不要只因網頁無法開啟，就把所有 DNS 項目改成同一個位址。解析過程與連線過程都可能失敗，需要搭配診斷資訊區分。如果新增規則後才發生問題，請先還原該項修改，再對同一個目標重新測試，同時檢查 FINAL 是否將未符合的請求交給預期策略。
Settings 中可以找到 Diagnostics，以及 Proxy、TCP、UDP 等相關設定入口。首次排錯請先查看現有診斷資訊，不要同時變更多個進階選項；不同通訊協定或目標 App 對傳輸方式的要求各異，任意切換容易引入新的變因。建議先完成手動連線驗證，再設定 On Demand，以免自動重新連線影響測試觀察。
保留有效資訊並遮蔽憑證
需要進一步排查時，請記錄裝置網路類型、目前的 Global Routing、失敗目標與錯誤提示，並註明問題發生在匯入、授權或實際瀏覽階段。分享截圖或記錄前，請遮蔽訂閱連結、伺服器驗證欄位與個人資訊。完整的逐項檢查請參閱開關已開啟卻無法上網；帳號、權限與常見匯入問題請參閱常見問題，不必在本教學中繼續修改所有進階設定。
