Shadowrocket 使用教學
訂閱匯入、連線與驗證

先確認手上的資料類型：訂閱連結、伺服器分享連結，或逐項列出的伺服器參數。訂閱連結用於取得一組項目，手動參數則描述單一伺服器；兩者入口相近，但不能混用。開啟 Shadowrocket，在 Home 的 SERVER 分組附近找到 Add Server，或使用頁面上的新增入口。進入後先查看 Type，不要直接把整條訂閱連結貼進 Host。

已有訂閱連結：選擇 Subscribe

在 Add Server 中開啟 Type，選擇 Subscribe，再將既有的完整訂閱連結填入相應的 URL 欄位。複製時保留問號後的參數，不要連同訊息中的引號、空格或換行一起複製；若連結已遭截斷，請回到原始來源重新複製，不要憑印象補齊。備註僅供辨識來源，可填寫容易區分的名稱，請勿當作驗證資料。

儲存後返回 Home，更新該訂閱並等待清單載入。取得成功後應能看到實際伺服器項目，而不只是訂閱名稱。若只看到名稱，沒有展開項目，請先確認是否已完成更新，再前往本頁的故障點排查。日後更新訂閱可能會新增或移除項目，因此更新後也要確認目前選取的伺服器仍存在。

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

手動新增時，先依資料選擇 Shadowsocks、VMess、VLESS、Trojan 等相應的 Type，再逐項核對 Host、Port 及該類型顯示的驗證欄位。官方截圖展示其中一種欄位組合；並非每種協定都會同時出現 Password 與 Method，也不能將一種協定的參數套用到另一種。若有 TLS、傳輸方式或其他附加欄位，請依既有伺服器資料填寫，不確定的欄位不要任意切換。

若已有 QR Code，可使用 Scan QR Code 匯入，辨識後仍須核對 Type 與目標位址。Import from Cloud JSON 是另一種匯入入口，僅在已有相容資料時使用，不應視為通用的訂閱輸入欄位。伺服器分享連結也應使用對應的匯入方式處理，不要拆解成猜測的參數。儲存前再次核對連接埠、驗證資料與空格，儲存後返回 Home，選取準備使用的項目。

本步完成條件：Home 中已有可選取的伺服器，且能明確指出目前選取的項目。暫時不必開啟連線開關；下一步先決定請求要依規則分流或統一處理。訂閱連結可能包含存取憑證，分享截圖或診斷記錄前請遮蔽完整連結及驗證欄位。

返回 Home，開啟 Global Routing。這裡的三種模式為設定(Config) / 代理(Proxy) / 直連(Direct)。它們決定請求如何進入後續處理，並非三種伺服器協定。選取伺服器是在決定「使用哪一組既有連線資料」，選擇 Global Routing 則是在決定「如何處理請求」，兩者需要分別確認。

一般規則分流：設定(Config)

若要依網域、IP 等規則決定連線路徑，請選擇設定(Config)，接著前往 Config 確認目前啟用的設定檔。匯入訂閱通常是用來管理伺服器清單，不能因此推定規則設定也已完成。開啟目前使用的設定檔，查看 General、Rule 等區段；若有多個檔案，先確認目前選取的檔案，再進入編輯，以免修改了其他檔案卻看不到變化。

Rule 中的項目依序參與比對，最先命中的規則會決定後續策略；FINAL 用於前面的規則都未命中時收尾。若規則引用 PROXY 或某個策略群組，也要確認目前設定中有對應的定義與可用選項。以下僅以一行說明結構，並非可直接取代目前檔案的完整設定：

DOMAIN-SUFFIX,example.com,PROXY

其中 DOMAIN-SUFFIX 是規則關鍵字，example.com 是範例網域，PROXY 是策略引用。新增規則前先保留目前設定檔的副本，不要為了完成首次連線而同時修改 Hosts、URL Rewrite、HTTPS Decryption。初次使用只需確認目前使用的設定檔正確，且規則引用沒有遺漏；關鍵字的具體含義可查看術語表，複雜的比對問題則參閱排錯手冊。

釐清問題：代理(Proxy)與直連(Direct)

代理(Proxy)適合用來短暫比較所選伺服器能否處理實際請求；直連(Direct)會讓請求直接存取，可用來比較本地網路的狀況。切換模式無法修正錯誤的伺服器密碼，也不會自動補上缺少的設定。若 Proxy 可以存取而 Config 不行，應優先檢查規則與策略引用，而不是立刻重新匯入所有伺服器。

本步完成條件：能說明目前的模式，以及 Config 使用的是哪一份設定檔。測試完成後，請切回原先預計使用的模式，避免忘記還原而長期使用臨時的 Proxy 或 Direct 設定。

返回 Home，先查看 SERVER 分組中的選取項目，再確認 Global Routing。初次操作時，建議固定使用一台伺服器完成整個驗證流程，不要每次測試前都更換伺服器，否則無法判斷變化來自伺服器、模式或本地網路。若剛更新訂閱，請再次確認選取項目，尤其留意同名項目或更新後已移除的項目。

頂端顯示 Not Connected 時，開啟連線開關。首次建立連線時，系統可能會要求允許新增 VPN 設定，並要求輸入裝置密碼或進行生物辨識驗證。先確認操作是由剛開啟的 Shadowrocket 發起，再依系統提示完成授權。若取消授權，返回 App 重新操作即可；系統確認視窗尚未處理完畢時，不要連續點按開關。

授權後請等待狀態更新。開關開啟且 App 顯示連線狀態改變，表示本機通道已嘗試建立；這不代表遠端伺服器已能連線至所有目標，也不表示 Config 中的每條規則都正確。狀態改變後，保留目前的伺服器與模式，接著進行下一步測試。若開關立即回到關閉狀態，先記下系統提示，不要繼續修改 Rule。

裝置同時啟用其他 VPN 連線或網路延伸功能時，可能會影響目前的連線。先結束暫時不需要的 VPN 工作階段，再返回 Shadowrocket 進行一次可重複的連線測試。受管理裝置若限制新增 VPN，請查看裝置管理政策或聯絡管理員，不要反覆刪除用途不明的描述檔。

若要主動中斷連線，返回 Home 關閉開關；若關閉後又自動連線，請前往 Settings 檢查 On Demand 是否已啟用及其觸發條件。先確認自動連線的來源，再決定是否暫時關閉此功能。本步完成條件：開關狀態能維持，且已記錄目前的伺服器與 Global Routing，接著透過實際請求驗證。

排錯順序為「能否取得訂閱內容 → 伺服器能否通過測試 → VPN 能否維持連線 → 實際請求能否完成」。先處理最早失敗的環節，再繼續往下檢查。開啟 Settings，可看到 Test Method、On Demand、Diagnostics 等入口；本頁只說明首次連線所需的檢查，不必修改 Proxy、TCP、UDP 的所有選項。

訂閱更新失敗或清單空白

先分辨是下載失敗，還是解析後沒有項目。下載失敗時，檢查本地網路能否正常瀏覽一般網頁、訂閱連結是否完整，以及原有憑證是否仍有效。下載完成但清單空白時，確認連結回傳的是相容的訂閱內容，而不是登入頁面或錯誤說明。不要在公開頁面貼出完整連結求助；若需向原資料提供者確認，僅提供必要的錯誤提示及已隱藏憑證的截圖。

Connectivity Test 逾時

在 Settings 查看 Test Method，確認目前測試的條件，再返回 Home 測試同一項目。逾時可能與測試方式、伺服器位址、連接埠或所在網路有關，不能只憑一次結果認定所有設定都已失效。手動新增的項目應重新核對 Type、Host、Port 與驗證欄位；訂閱項目則先更新，再確認選取項目沒有改變。若改用其他本地網路測試，請另外記錄這項變更。

開關無法開啟或連線後無法存取

若開關立即關閉，先檢查系統 VPN 授權、其他 VPN 工作階段及裝置管理限制。若開關能維持開啟但無法存取，請依前一節比較 Config、Proxy 與 Direct，再決定要檢查伺服器、規則或 DNS。不要只因網域無法開啟就立即修改所有 DNS 選項；先確認錯誤是否僅發生在網域請求，以及是否有規則或策略引用不一致。

自動重新連線、單一 App 異常與診斷記錄

關閉開關後又自動重新連線，先查看 On Demand 的觸發條件；單一 App 異常時，先確認該 App 是否重新建立連線，而非沿用先前的工作階段。若確實需要診斷，開啟 Diagnostics，記錄失敗時的操作、所選模式及錯誤訊息。診斷記錄可能包含目標網域、伺服器位址或驗證相關資訊，分享前請逐項檢查並遮蔽敏感內容。

每次只修改一項設定，並對同一個目標重新測試；若沒有改善，請還原原值，避免累積臨時變更而產生新問題。成功後保留目前可用設定的副本，再逐項加入進階功能。更多症狀的處理流程請參閱排錯手冊，購買與還原問題請查看常見問答，協定及規則名稱請參閱術語表。初次使用到這裡即可，不必一次設定所有功能。