Shadowrocket 入門指南

STEP 01 / Add Server · Subscribe

新增伺服器或匯入既有訂閱

先確認手上的資料類型，再選擇操作入口。完整訂閱連結用來取得一組伺服器；單一伺服器連結、QR code，或包含協定與連接埠的資料，通常用於新增個別伺服器。訂閱連結與一般網頁網址不同，不能只憑網域名稱判斷用途。若來源說明不清楚，請先向你現有服務的提供者確認，不要反覆更換 Type 嘗試。

手動新增：從 Home 開啟 Add Server

開啟 Home，在 SERVER 區域找到 Add Server，或使用頁面上的新增入口。進入 Add Server 後，先點選 Type，依照既有資料選擇正確的協定，再填寫相應欄位。截圖中的 Host、Port、Password、Method 是特定類型的欄位範例；切換 Type 後表單可能不同，請勿將截圖中的欄位組合視為所有協定的通用要求。

Host 填入資料中的伺服器位址，Port 填入連接埠，Password 和 Method 則逐項對照原始資料。留意複製內容前後的空格、全形符號及遺漏字元；Port 欄位不要包含說明文字。若所選協定還需要其他參數，也請使用原始資料中的對應值。儲存前再次核對，接著返回 Home，確認 SERVER 中已出現新增項目。

匯入訂閱：選擇 Subscribe

若已有訂閱連結，請在 Add Server 的 Type 中選擇 Subscribe，將完整連結填入 URL 欄位後儲存，並等待取得結果。請勿只複製網址前半段，查詢參數也可能是識別訂閱所需的資訊。訂閱連結屬於敏感資料，不應放在公開截圖、留言或傳送給無關人士。此處僅匯入你已持有的連結，不涉及尋找或購買服務。

儲存訂閱項目與成功取得伺服器是兩回事。返回 Home 後，展開相應群組，確認底下確實列有伺服器；若只看到訂閱名稱而沒有伺服器，請先檢查本機網路能否連線取得該連結、連結是否完整，以及訂閱是否仍有效。之後需要更新 Shadowrocket 訂閱時，請使用該訂閱項目的更新功能，並確認清單確實重新整理；不要反覆新增重複項目來取代更新。

若手上的資料是 QR code，可在 Add Server 使用 Scan QR Code，並依系統提示授予相機權限。Import from Cloud JSON 適用於相應格式的資料，不能取代任意訂閱網址的匯入入口。完成這個階段的標準很簡單：SERVER 中有可選取的伺服器，而且資料與你持有的內容一致。Subscribe 與 Config 的差異可參閱名詞解釋。

STEP 02 / Global Routing · Config

選擇 Global Routing 模式

伺服器清單準備就緒後，返回 Home 並開啟 Global Routing。這裡決定請求採用哪種整體處理方式，不會新增伺服器，也無法修正錯誤的伺服器密碼。三種模式分別是設定檔(Config)/代理(Proxy)/直連(Direct)；切換前，先確認這次是要驗證伺服器，還是啟用既有規則。

首次驗證既有伺服器時，可暫時選擇代理(Proxy)，降低設定檔分流結果對判斷的影響。這不保證所有目標都能存取，也不能取代伺服器資料核對。驗證完成後，若要讓不同請求採用不同策略，再切換至設定檔(Config)。請勿只看頂端的連線狀態，就認定目前一定透過代理連線：選擇直連(Direct)時，這些請求不會經由遠端伺服器轉送。

使用 Config 前，確認目前設定檔

進入 Config，確認目前正在使用的設定檔，而不只是查看清單中是否有某個檔案。訂閱通常提供伺服器清單，設定檔則包含規則與其他參數；匯入前者不代表已自動取得符合個人需求的後者。開啟設定檔後，可查看 General、Rule 等區段；截圖展示的是編輯頁面及 Add Rule 入口。若已有可用設定檔，首次連線時請先保留原有內容，避免同時修改多項參數。

規則中的 PROXY、DIRECT、REJECT 是策略關鍵字，不應與 Global Routing 中的 Proxy、Direct 混為一談。例如，下方片段表示符合示範網域時使用 PROXY，其餘請求使用 DIRECT；這只是語法說明，不是本教學要求匯入的完整設定檔。流量是否經過遠端伺服器，取決於目前模式、實際符合的規則及策略指向，不能只因檔案中出現 PROXY 就下結論。

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

若還不熟悉規則順序，請先完成後續的連線與驗證，再閱讀規則與設定參考。若要專門比較三種模式，可前往代理模式說明。這一步只需確認一件事：Home 顯示的 Global Routing 符合本次測試目的，而且設定檔(Config)確實有可供使用的明確設定檔。

STEP 03 / Home · SERVER

選取伺服器，再開啟連線開關

返回 Home，在 SERVER 中展開剛匯入的群組，選取這次要使用的伺服器。查看項目旁的選取標記，確認預設伺服器已切換至預期項目。開啟詳細資料與選取伺服器是不同操作：進入編輯頁面不代表該項目已設為本次連線目標。伺服器較多時，先記下所選名稱，後續排錯才能對應到同一份資料。

確認 Global Routing 後，開啟 Home 頂端的連線開關。尚未建立連線時，頁面可能顯示 Not Connected；開啟後，請觀察狀態是否改變，以及開關能否維持開啟。不要連續快速切換開關，以免無法判斷前一次連線是否仍在處理，或新一次嘗試是否已失敗。若系統顯示授權提示，請先完成授權，再返回 App 查看結果。

首次授權：允許新增 VPN 設定

首次連線時，系統可能會要求允許 Shadowrocket 新增 VPN 設定。此授權是讓用戶端透過系統網路延伸功能處理流量，不是購買確認，也不表示遠端伺服器已通過測試。確認提示來自正在操作的 Shadowrocket 後，依系統指示確認；裝置可能要求輸入密碼或使用生物辨識完成授權。完成後返回 Home，必要時重新開啟連線開關。

若先前拒絕授權，重新匯入訂閱並不能恢復連線。請再次嘗試連線並查看系統提示；若裝置受管理、連線受到限制，或目前已有其他 VPN 連線，還需檢查裝置設定及適用的管理規定。未確認用途前，請勿刪除其他 VPN 設定。iPad 的畫面配置可能與截圖不同，但仍可依 Home、SERVER、Global Routing 和連線開關等名稱找到相應項目。

連線開關維持開啟，只能表示本機連線狀態已建立，不代表伺服器、名稱解析與目標存取都正常。接下來仍須執行 Connectivity Test，並以實際網頁再次確認。若開關立即關閉，請優先至最後一節檢查授權及本機連線；若開關維持開啟但無法存取，請記錄所選伺服器、目前模式和具體失敗情況，不必立即重新安裝 App。

STEP 05 / Settings · Diagnostics

依失敗階段排查，每次只變更一項

從最早失敗的步驟開始排錯。先關閉連線開關，確認裝置本身能正常開啟已知可用的頁面，再重新啟用 Shadowrocket。若公共網路需要先登入才能使用，請先完成網路登入。本機網路若無法使用，修改 Config、重新掃描 QR code 或更換 Test Method 都無法解決根本問題。

匯入失敗：先釐清連結取得與伺服器連線

Subscribe 無法取得清單時，請檢查連結是否完整、是否多了空格，以及提供者是否變更存取條件。訂閱取得失敗與個別伺服器連線失敗是兩種不同問題：前者尚未成功取得清單，後者則是已有項目無法使用。即使清單已存在，也要確認目前選取的項目沒有因訂閱更新而失效。請勿先刪除所有資料再嘗試，以免失去可供比對的記錄。

測試失敗：重新核對原始伺服器資料

逐項核對 Type、Host、Port，以及所選協定需要的驗證與傳輸參數。大小寫、加密方式、伺服器名稱等設定都應以既有資料為準，不要照搬其他類型的填寫方式。裝置日期與時間也應正確，否則可能影響需要驗證憑證的連線。不要為了排錯而任意關閉驗證，這可能掩蓋真正問題；請先確認資料、時間與目標名稱是否正確。

部分存取失敗：檢查模式與規則

若代理(Proxy)可用而設定檔(Config)不可用，請優先檢查目前生效的設定檔、目標符合的規則，以及對應策略是否指向預期伺服器。若直連(Direct)可用但代理(Proxy)不可用，只能表示這次直連的目標可存取，無法證明伺服器資料正確。切換模式時，請使用相同目標進行比較，而且每次只調整一項，才能釐清現象與變更之間的關係。

先檢查 Settings 中的哪些項目

進入 Settings，先確認 Test Method，並了解 Connectivity Test 使用的方法；測試方法變更後，結果不能直接與先前在相同條件下取得的結果比較。On Demand 用於依條件觸發連線；若出現關閉後又自行重新連線等與手動操作不符的情況，請檢查是否設定了相關條件。初次排錯時，先記下原有設定，再暫時排除自動觸發因素；狀況穩定後，再恢復合適的條件。

若要進一步定位問題，可使用 Settings 中的 Diagnostics，並只記錄與目前問題相關的內容。Proxy、TCP、UDP 等項目不是「全部開啟就能修好」的通用開關；沒有明確理由時，請保留原設定。提交記錄前，請遮蔽訂閱連結、伺服器驗證資訊與個人請求內容。說明問題發生在哪個步驟、使用哪種模式、連線是否維持開啟即可，不必公開完整連線資料。

若已確認問題出在訂閱或伺服器本身，請向你現有服務的提供者確認有效性；若問題集中在規則語法，請繼續閱讀設定檔與規則參考；若不熟悉 Settings 中的介面用語，可先查閱名詞解釋。完成一次穩定連線後再逐步加入規則與 On Demand 條件，比首次連線時同時調整多項進階設定更容易檢查。