Shadowrocket 快速上手

開啟 Shadowrocket，進入 Home，在 SERVER 分組中找到 Add Server，或使用頁面上的新增入口。接著先確認資料類型：訂閱連結用於取得及更新一組項目；單一分享連結通常包含一部伺服器的參數；手動設定資料則會分別列出協定、位址、連接埠與驗證資訊。請勿將訂閱網址填入 Host，也不要只憑連結長短判斷類型。

已有訂閱連結：選擇 Subscribe

在 Add Server 中點選 Type，選擇 Subscribe，再將完整的現有訂閱網址填入對應的 URL 欄位。備註可填寫方便辨識的名稱，例如用途或資料來源；請勿在備註中填入驗證資訊。貼上後檢查網址前後是否多出空格、換行或引號，尤其留意複製時是否漏掉網址末尾的參數。確認無誤後儲存，返回 Home 等待訂閱內容載入。

儲存成功不代表訂閱內容已成功取得。返回列表後，應能看到訂閱分組或其中的伺服器項目；若只出現分組名稱，沒有可選項目，請先更新該訂閱，再查看是否有錯誤提示。更新訂閱只會重新取得項目資料，不保證其中每部伺服器都能連線。若訂閱失效、權限變更或內容為空，請向原服務提供者確認資料。

已有伺服器參數：逐項核對 Type 與欄位

手動輸入時，先在 Type 選擇與資料相符的協定，再填寫 Host、Port 及相應的驗證欄位。截圖中的 Password、Method 等項目並非所有 Type 都相同，請勿將同一組欄位套用到所有協定。Host 通常填寫網域名稱或 IP 位址，不應包含網頁路徑；Port 請依原始資料填寫。Password、UUID 等驗證值必須完整保留，勿自行更改大小寫或符號。

若已有可用的 QR Code，可使用 Scan QR Code 掃描，再檢查解析出的類型與位址。Import from Cloud JSON 適用於相應格式的資料，並非通用的訂閱貼上入口。無論使用哪種方式匯入，儲存前都應確認協定與現有資料相符；若格式無法辨識，請先確認資料用途，不要不斷切換 Type 嘗試。

選好項目後返回 Home，點開 Global Routing。這裡要區分三種模式：設定 (Config)／代理 (Proxy)／直連 (Direct)。切換模式不會替你補齊伺服器參數，也無法讓失效的訂閱恢復。初次操作時，重點是確認目前使用的模式，之後才能一致地進行連線與疑難排解。

設定 (Config)：依目前設定處理請求

Config 會依目前選取的設定檔及其規則決定請求的處理方式。在底部的 Config 頁面確認已選取的檔案，並開啟相應設定檢視 Rule 內容。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定檔的不同區段；快速上手時不必逐項修改，尤其不要為了連線而同時啟用與目前用途無關的功能。

匯入訂閱項目，不代表已選取分流規則。伺服器列表與設定檔分開管理：前者提供連線參數，後者決定比對邏輯。使用 Config 前，請確認目前檔案存在，且規則中的策略可對應到可用的伺服器或策略設定。若尚未備妥分流設定，可先用 Proxy 確認基本連線，再返回 Config。

代理 (Proxy) 與直連 (Direct)：指定連線路徑

Proxy 會將可由此模式處理的請求交由所選代理路徑，適合用來確認伺服器能否正常連線及存取。這是疑難排解時的比對條件，不代表所有 App、協定與網路請求都會得到相同結果。Direct 則透過直連路徑處理請求，可用來比較裝置原有網路是否正常；在此模式下開啟連線開關，不代表正在使用所選的代理伺服器。

以下是方便理解的 Config 規則片段：只有 example.com 及其子網域會交由 PROXY 處理，其他未符合規則的請求則由 FINAL,DIRECT 作為預設處理方式。example.com 是示範用網域，不是連線伺服器位址；此片段只用來說明連線路徑，初次操作不必直接取代整份設定。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

規則由上而下比對，符合後依相應策略處理，因此 FINAL 應放在具體規則之後。若要在 Rule 中使用 Add Rule，請先保留原設定，只新增與目前測試相關的規則。完整語法與策略對應方式請參閱系統教學中的 Config 與規則說明；本頁將繼續完成連線驗證。

返回 Home，再次核對兩個位置：SERVER 分組中選取的項目是否為剛才準備測試的伺服器，以及 Global Routing 是否仍是預期的 Config、Proxy 或 Direct。更新訂閱後，列表項目可能改變，請勿只憑先前記憶判斷目前的選擇。首次連線時，先維持目前的 Wi-Fi 或行動網路不變，避免同時切換網路而難以比較結果。

可先執行 Connectivity Test，查看目前測試方法下的連線結果。若測試失敗，先不要反覆開關連線；返回項目檢查資料是否完整，並參考最後一節進行排查。若測試有回應，再開啟 Home 頂端的連線開關。Connectivity Test 的結果只適用於該測試方式，不能只憑一次測試就認定所有網頁、DNS 解析或 App 請求都正常。

首次連線：確認系統 VPN 設定提示

第一次啟動連線時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。這是 App 建立系統網路連線所需的授權步驟。確認提示中的 App 名稱後，依系統說明允許並完成裝置要求的驗證。這項驗證屬於裝置系統流程，不是在 App 中輸入訂閱密碼，也不需要向他人提供裝置解鎖資訊。

完成授權後返回 Shadowrocket，等待頂端的連線狀態變更。若剛才取消授權，連線通常無法完成；可再次開啟開關，依實際提示重新處理。若 App 顯示授權或設定錯誤，請先閱讀提示內容，再檢查裝置是否受管理限制，或是否有其他正在使用的 VPN 設定影響目前連線。受管理的裝置應遵循相關管理規範，不要任意刪除不明設定。

已連線：維持目前測試條件

頂端狀態從 Not Connected 變為已連線後，先維持所選伺服器、模式與網路不變。系統顯示 VPN 狀態，表示相關連線設定已啟用，但無法證明目標網站一定經過代理，也無法證明伺服器能存取所有目標。接下來必須發出新的實際請求，確認結果是否符合目前模式。

本次手動驗證期間，先不要額外調整 On Demand。它會影響後續自動建立連線的行為，不是匯入伺服器參數的步驟。若關閉後 App 又自動連線，請檢查現有的 On Demand 設定，而非立即認定連線開關故障。

訂閱已儲存，但沒有伺服器項目

先確認 Type 是否為 Subscribe、網址是否完整，以及更新時是否出現明確錯誤提示。此時問題發生在取得訂閱內容的階段，尚無法判斷伺服器連線狀況。檢查裝置目前的基本網路是否正常，再確認現有訂閱是否仍有效。請勿把反覆刪除並重新新增當成更新成功的證明，也不要將含有驗證參數的完整網址貼到公開頁面。

Connectivity Test 失敗或結果不一致

前往 Settings 查看 Test Method，先記下目前使用的方法，再判讀測試結果。不同測試方法驗證的內容不同，不能將不同方法的結果直接視為相同的延遲或可用性指標。請針對單一項目重新測試，並檢查 Host、Port、協定類型與驗證資料。若有其他可用項目，可在模式與測試目標不變的情況下切換比較；若只有特定項目失敗，應優先核對該項目的資料。

已建立連線，但頁面無法開啟

先檢查 Global Routing。若目前是 Direct，所選代理伺服器並未以 Proxy 模式處理請求；若是 Config，請確認目前的設定檔與規則策略。接著以 Proxy 作為對照，判斷問題是否只在設定模式下出現。若切換模式後仍無法連線，再檢查網域解析、伺服器狀態與目標本身是否可用，避免同時修改多項設定。

排查 DNS 時，先檢查現有設定，並記錄系統解析方式或設定中的 DNS 項目。不要為了測試一次填入多組來源不明的位址。若部分網域失敗、其他請求正常，可搭配 Data 中的新請求與實際錯誤資訊進一步縮小範圍。完整的解析與規則關聯說明請參閱系統教學；修改後請以相同目標發出新請求，不要只重新整理舊的測試數值。

連線行為與手動開關不一致

在 Settings 檢查 On Demand 是否已設定自動連線條件。這些條件可能影響網路變更後或符合條件時的連線行為，因此手動關閉後若再次連線，請先核對相關條件。初次排查時，分開記錄自動行為與手動測試，確認是何種操作觸發連線，再決定是否調整。不要為了處理尚未釐清的問題，同時修改 Proxy、TCP、UDP 等多個區段。

仍無法定位：整理 Diagnostics 資訊

必要時前往 Settings 的 Diagnostics 查看可用的診斷項目。先記錄問題發生時的網路類型、所選伺服器、Global Routing、Test Method，以及可重現的操作步驟，再蒐集相關資訊。不要假設所有診斷檔案都會自動隱藏敏感內容；傳送給相關支援人員前，請檢查並移除訂閱網址、密碼、驗證參數及不需公開的存取記錄。

若需向原服務提供者確認伺服器狀態，只提交與該項目相關且已移除敏感值的錯誤描述。若問題涉及 App 取得、已購項目復原或裝置相容性，請參閱App 取得說明。基本連線恢復後，返回連線驗證重新測試，最後保留一份可用設定；後續調整時可用來比較，不必從頭開始。