Shadowrocket 使用教學

步驟 01 · 準備連線項目

Add Server：新增伺服器與匯入訂閱

先確認手上的資料是哪一種：完整的訂閱連結，或單一伺服器的協定、位址、連接埠與驗證參數。兩種方式的入口可能相鄰，但填寫方式不同。訂閱可用來取得及管理一組項目；單一伺服器則須依協定逐欄填寫。請勿將訂閱網址中的網域直接當作伺服器的 Host。

已有訂閱連結：選擇 Subscribe

開啟 Shadowrocket 的 Home，在 SERVER 區塊找到並進入 Add Server。若要匯入現有訂閱，請在 Type 選擇 Subscribe，再將完整連結貼入對應的 URL 欄位。確認複製內容沒有多出空格、換行或引號；尤其不要刪除問號後的內容，該部分可能用於驗證訂閱存取權限。填入方便辨識的備註，儲存後等待匯入完成。

返回 Home 後，清單中應會顯示匯入的群組或伺服器項目，而不只是沒有內容的訂閱紀錄。匯入時，當前網路必須能連上訂閱網址。若出現請求失敗，先確認連結是否仍有效，再檢查網路狀況。反覆點選更新無法修復失效的憑證，也不能取代連結檢查。

已有伺服器資料：先確認 Type

如果拿到的是單一伺服器資料，請先在 Add Server 選擇正確的 Type，再依提供的內容填寫 Host、Port 及該類型所需的驗證欄位。截圖中的 Password、Method 是特定協定的欄位，不代表所有類型都使用相同參數。Shadowsocks、VMess、VLESS、Trojan 等類型必須與伺服器端設定一致，不可只因名稱相似就互換。

Host 通常填寫伺服器位址或網域；若現有資料另有傳輸路徑、TLS 名稱或其他擴充欄位，請填入對應欄位，不要併入 Host。也可使用 Scan QR Code 掃描 QR Code，但掃描後仍須確認 Type 與重要欄位。Import from Cloud JSON 僅適用於特定輸入格式，不可用來開啟任意訂閱連結。

儲存後返回 Home，確認項目已新增，再選取準備使用的伺服器。此時只代表資料已匯入，不能據此判定連線成功。若更新訂閱後項目有所變動，請先確認目前選取的項目，再進行下一步。訂閱連結與 QR Code 可能包含驗證資訊，請勿放入公開截圖或公開討論內容。

步驟 02 · 確認流量處理方式

Global Routing：選擇連線模式

儲存伺服器項目後，返回 Home 並開啟 Global Routing。此處設定的是請求的處理方式，不是伺服器協定。三種模式分別為設定(Config)、代理(Proxy)與直連(Direct)。先確認目前選項再開啟連線，可避免將模式不符預期誤判為伺服器故障。

設定(Config)：依目前設定檔套用規則

選擇設定(Config)時，系統會依目前啟用設定檔中的規則處理請求。進入 Config，確認實際使用的設定檔，而非只確認清單中「有一個檔案」。開啟編輯內容後，可看到 General、Rule、Hosts、URL Rewrite 等區段；截圖用於辨識這些位置，首次連線不必逐一編輯所有區段。

Rule 的比對順序會影響結果。前面的規則命中後，後續規則通常不再參與該請求的策略選擇；FINAL 用於處理先前未命中的請求。DIRECT 代表直連，REJECT 代表拒絕；指向代理或策略群組的規則也必須有可用的目標。看到 PROXY 字樣，不代表 App 會自動補齊伺服器或策略群組。

若已有用途明確的設定檔，請先保留內容，確認目前是否已啟用，以及策略是否有對應項目。首次連線時不要同時修改 DNS、Rule 與 URL Rewrite，否則發生異常時很難判斷是哪項變更所致。訂閱與設定檔也不是同一回事：前者可更新伺服器項目，後者主要決定如何處理請求。

代理(Proxy)與直連(Direct)：用於明確比對

代理(Proxy)會讓通常由此模式處理的請求使用所選代理，適合暫時確認「伺服器本身是否可用」。這不代表所有系統流量一定會經過代理；系統保留流量及相關設定仍可能影響連線路徑。若 Proxy 下可正常存取、Config 下卻不符合預期，應優先檢查設定檔規則與策略對應，而非立即重新填寫伺服器參數。

直連(Direct)會讓相關請求直接連線，不經所選代理伺服器。此模式可用來比較目前網路的直接存取狀況，但切換至 Direct 不代表已關閉 Home 頂端的連線開關。若要結束客戶端連線，請返回 Home 關閉開關並確認狀態，而非只切換 Global Routing。

首次驗證時，先固定一種模式並記下選擇，再開始連線。若要深入了解規則，請參閱技術參考；常見的模式判斷問題可參閱常見問題。本教學只要求確認「目前選擇了什麼、原因為何」，不需要一次設定好整套規則。

步驟 03 · 建立系統連線

Home：開啟開關並確認授權

返回 Home，先確認 SERVER 區塊中已選取準備使用的伺服器，再確認 Global Routing 顯示的模式。選取伺服器、選擇模式與開啟連線是三項獨立操作：清單中有伺服器，不代表已選取；已選取伺服器，也不代表系統連線已開啟。

開啟 Home 頂端的連線開關。首次連線時，系統可能會要求允許 Shadowrocket 新增 VPN 設定。請閱讀提示，確認操作是由剛開啟的 Shadowrocket 發起，再依照系統流程允許並完成裝置驗證。此授權用於建立系統網路設定，不會取代訂閱驗證，也不代表伺服器資料已通過驗證。

完成系統提示後返回 Home，查看頂端狀態是否從 Not Connected 變為已連線，並確認開關維持開啟。系統狀態區可能因裝置與目前介面而顯示不同的連線標示，請綜合 App 狀態與實際存取情形判斷，不要只看狀態列是否出現圖示。

若先前取消授權，請返回 App 重新嘗試連線，並依實際出現的系統提示操作。若裝置受組織管理，系統可能限制新增 VPN 設定；這類限制無法透過修改伺服器密碼解決。請先確認裝置是否允許此操作，再繼續檢查 App 內的參數。

若連線開關剛開啟就立即關閉，建議先記錄狀態變化與提示，再區分是系統授權問題還是伺服器連線問題。尚未記錄狀況前，請勿連續切換多個項目。保留目前的伺服器與模式，只重試一次連線，確認錯誤是否相同，再進行後續故障排查。

iPad 可依相同順序操作；版面可能隨視窗大小改變。只要先確認 Home、SERVER、Global Routing 與頂端連線開關，就不必為了配合圖片而調整裝置顯示設定。請維持連線，繼續使用 Connectivity Test 並前往實際目標確認結果。

步驟 05 · 依故障環節排查

Settings：常見故障排查

排查時先確認問題發生在哪個步驟：訂閱未匯入、開關無法維持開啟，或連線已開啟但目標無法存取。這三種情況涉及的條件不同。先返回最近完成的步驟，確認其完成條件仍成立，再往後檢查，比一次重設所有設定更容易找出原因。

匯入失敗：先檢查輸入內容與訂閱回應

訂閱更新出錯時，確認完整連結、目前網路，以及訂閱是否仍有效。若連結可正常請求但沒有匯入項目，請檢查回傳內容是否為 App 支援的訂閱格式；登入頁面、錯誤頁面或僅供瀏覽的說明頁面，都不等於伺服器設定資料。若單一伺服器無法儲存，請重新檢查 Type 所需欄位與 Port 是否填寫正確。

現有訂閱中的伺服器若有變動，更新完成後請再次確認目前選取的項目，避免仍使用舊項目。更新訂閱與更新 Config 檔案應分別確認，不能以其中一項更新成功推定另一項也已同步。若要確認資料是否有效，請聯絡自己現有服務的提供者，並只提供必要的錯誤描述。

連線失敗：檢查授權、驗證資料與裝置時間

開關無法開啟時，先確認是否完成系統授權，以及裝置是否受到管理限制。若開關可開啟但伺服器無法使用，再檢查 Host、Port、驗證資訊、傳輸方式及 TLS 相關欄位。協定要求的名稱或路徑不一致，也可能造成連線失敗。請勿任意關閉憑證驗證來掩蓋欄位錯誤。

若涉及憑證或驗證時效，請確認裝置日期與時間設定正確。若同時啟用了其他網路連線設定，先確認實際運作的是哪一項，再進行比對測試。首次排查時盡量維持網路條件不變，避免連線切換與參數變更混在一起。

存取失敗：檢查 Test Method 與 On Demand

進入 Settings，找到 Test Method 並確認目前的測試方式。不同方法使用的檢查目標不同，因此延遲數值不能直接視為網頁載入速度，也不適合跨測試方法直接比較。若只有測試異常、實際目標仍正常，請優先確認測試條件；若實際目標也無法存取，再檢查規則與伺服器路徑。

若手動關閉後又自動連線，或切換 Wi-Fi 後連線狀態改變，請檢查 On Demand 是否啟用及其觸發條件。首次連線尚未穩定時，可先暫停自動觸發，再依 Home 的手動流程驗證；確認基本流程正常後，再逐項加入所需條件。不要把自動重新連線誤認為開關故障，因而反覆修改伺服器。

若仍無法找出原因，請查看 Settings 中的 Diagnostics，保留與本次故障時間相符的必要資訊。分享前請遮蔽訂閱連結、驗證欄位、QR Code 及可識別個人網路的資訊。描述問題時，列明所選模式、網路類型、失敗步驟與已完成的單項比對即可，不必公開完整設定檔。