Shadowrocket
匯入與連線教學

開啟 Shadowrocket，先停留在 Home，暫時不要開啟頂端的連線開關。確認手邊資料屬於哪一種：用來更新伺服器清單的訂閱連結，或包含協定、位址、連接埠與驗證資訊的單一伺服器參數。兩種資料的輸入入口相關，但用途不同；訂閱網址不能直接當作伺服器的 Host，單一伺服器位址也不等於訂閱連結。

已有訂閱連結：選擇 Subscribe

在 Home 點選 Add Server，也可透過頁面上的新增入口進入。點選 Type，選擇 Subscribe，然後在 URL 欄位貼上已有的完整訂閱連結。問號後的參數也可能用於識別訂閱，複製時請保留完整內容，不要只留下網域，也不要在首尾加入空格或換行。如有名稱或備註欄位，可填入方便自己辨識的名稱，再使用頁面上的儲存按鈕返回。

儲存後等待訂閱讀取完成，返回 Home 查看對應群組及其中的伺服器項目。若只看到訂閱名稱，群組內卻沒有伺服器，就不能直接進入連線步驟；這通常表示尚未成功取得可識別的清單。先確認貼上的內容是否完整，再使用該訂閱項目提供的更新功能重試。訂閱連結含有個人識別資訊，不應貼到公開頁面或放在截圖中；若仍無法更新，請依文末的匯入排查順序檢查。

已有單一伺服器資訊：逐項填寫

仍從 Add Server 進入，先選擇 Type，讓表單與資料中的協定一致。接著依資料填寫 Host、Port 及所需的驗證欄位。官方截圖中的表單包含 Password 和 Method；切換協定後欄位也會不同，因此不要將此截圖視為所有協定通用的固定表單。Method、傳輸方式、TLS 與其他選項，應以已有資料為準，不要只因名稱相似就自行替換。

Host 填寫伺服器網域或位址，Port 填寫資料所列的連接埠。若資料將位址與連接埠分開列出，請分別填入對應欄位，不要將完整網頁網址貼到 Host。填妥後儲存，返回 Home 的 SERVER 群組確認項目。若資料是 QR Code，可在 Add Server 使用 Scan QR Code；只有手邊資料明確為適用的 Cloud JSON 時，才使用 Import from Cloud JSON。掃描後仍須檢查辨識出的 Type 與位址。

完成這個步驟的標準是：Home 已顯示匯入的伺服器，且可以開啟其詳細資料核對欄位。此時僅代表資料已儲存，不表示伺服器一定連得上。下一步先決定這些資料要如何參與連線，再選擇具體伺服器。

返回 Home，點選 Global Routing。此處決定流量的處理方式，不會建立伺服器，也無法修正錯誤的伺服器參數。三種模式分別為設定檔(Config)、代理(Proxy)、直連(Direct)。先確認目前要使用規則，還是進行連線對照，再做選擇；不要因為某個名稱看起來較完整就反覆切換。

設定檔(Config)：依目前設定檔處理

選擇 Config 時，連線會依目前設定檔中的規則與策略處理。切換至 App 的 Config 頁面，確認選取的是準備使用的設定檔，再開啟其內容查看。截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定檔編輯的不同區段；首次連線只要核對目前設定檔與 Rule，不必逐一修改所有區段。

訂閱主要用於維護伺服器清單，設定檔則主要用於描述處理方式，兩者並非同一種資料。匯入訂閱後，不要直接假設所有存取都會依預期分流；應檢查選取的設定檔是否包含所需規則，以及規則引用的策略是否可用。已有可用設定檔時請先保留原狀，需要編輯前先儲存副本。首次連線測試不必為了「完整設定」而啟用 HTTPS Decryption，或加入用途不明的規則。

代理(Proxy)與直連(Direct)：確認連線路徑

選擇 Proxy 時，相關連線會以代理模式處理，可用於檢查選取的伺服器是否能連線至目標；結果仍取決於伺服器本身及目標的可連線性。選擇 Direct 時，相關連線會走直連路徑，無法藉此驗證伺服器是否有效。若要確認剛匯入的伺服器，在 Direct 模式下看到網頁成功開啟，不能據此認定伺服器運作正常。

設定檔中的規則通常依序比對，具體條件應放在兜底規則之前。例如下方範例表示比對指定網域後綴，其餘流量交由 FINAL 處理；其中 example.com 僅為範例網域，並非可用的伺服器。此處用於理解規則含義，首次連線時不必複製並覆蓋現有設定檔。

DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

完成此步驟後，返回 Home 再確認一次 Global Routing 顯示的模式。若要使用現有規則，請確認選取 Config 與對應設定檔；若要單獨測試伺服器，可先記下原本模式，再暫時使用 Proxy，測試後恢復原設定。規則順序與策略群組的詳細說明請參閱功能與設定；本教學將繼續完成首次連線。

在 Home 的 SERVER 或訂閱群組中，點選本次要使用的伺服器。確認項目左側是否出現圓點標記，並確認預設選取的是正確項目。開啟伺服器詳細資料檢查資料，與選取伺服器是兩件不同的事；從詳細資料返回後，仍須確認選取標記。清單中有多個項目時，先固定一個作為測試對象，不要一邊切換伺服器一邊修改規則，否則無法判斷結果是由哪項變更造成。

預設伺服器的選取主要適用於需要使用該預設項目的連線。若 Config 中的策略群組有個別選取，實際存取仍可能依對應群組執行；因此看到某個項目已選取，不代表所有規則都一定會使用它。首次操作先沿用已知設定，記下本次選取的項目即可；複雜策略群組的行為可在基本連線驗證後再檢查。

確認 Global Routing 後，開啟 Home 頂端的開關。首次連線時，系統可能會提示是否允許新增 VPN 設定。確認提示中的 App 為 Shadowrocket，再依系統要求確認，並完成裝置要求的身分驗證。此授權是為了在裝置上建立相應的網路連線設定，不是匯入訂閱，也不是再次購買；若取消，App 可能無法建立連線。

完成授權後返回 Home，查看頂端狀態是否從 Not Connected 轉為已連線，並確認開關沒有立即關閉。系統顯示 VPN 狀態僅代表裝置已建立相應連線，不能單獨證明遠端伺服器、DNS 和每條規則都正常。若開關立即關閉，先保留目前項目與模式，記下系統提示，再於最後一步依連線失敗處理；不要連續重複授權。

需要停止時，可關閉同一個連線開關。首次測試期間，建議先瞭解手動開關的效果，再設定 On Demand 自動連線條件；若手動關閉後又自動連線，請一併檢查 On Demand 與系統中的相關連線設定。現在請維持一次穩定連線，進入下一步進行實際驗證。

排錯前先關閉連線，確認裝置原有的 Wi-Fi 或行動網路可正常存取日常使用的目標。需要登入驗證的網路，請先完成其網路登入程序。若原有網路本身無法使用，繼續修改伺服器密碼或規則通常無法解決問題。恢復基本網路後，再重新開啟連線，並從下列環節選擇符合目前狀況的項目。

匯入後沒有伺服器項目

先確認 Type 是否為 Subscribe、URL 是否完整，再確認該網址確實是已有的訂閱連結，而非帳號管理頁面或一般網頁。若回傳內容是登入提示、錯誤頁面或空白內容，用戶端就無法將其當作伺服器清單處理。不要反覆新增相同訂閱，造成多個重複群組；請先檢查現有項目的更新結果。若涉及連結有效期限或存取權限，請向提供該資料的服務商確認；本教學不提供替代資料。

項目存在，但測試或連線失敗

開啟該伺服器的詳細資料，依原始資料逐項核對 Type、Host、Port、Password 及該協定所需的其他參數。密碼前後空格、連接埠抄錯或 Method 不一致，都可能導致驗證或連線失敗。若資料要求 TLS 或特定傳輸欄位，請保持欄位內容一致，不要為了測試而任意關閉驗證相關設定。若項目來自現有訂閱，可先更新再重新選取；確認項目仍存在後再測試。

在 Settings 查看 Test Method 時，先瞭解目前測試方式測量的對象。不同方式的結果不能直接混合比較，某一種測試失敗也不一定代表實際存取完全無法使用。使用 Diagnostics 時，請針對同一次失敗收集資訊，保留錯誤類型與發生環節即可。對外提供記錄前，請遮蔽訂閱連結、密碼、驗證資訊及個人連線記錄中的敏感內容。

開關已開啟，但只有部分目標失敗

先檢查 Global Routing。若目前是 Direct，實際請求不會因清單中有伺服器就自動改走代理；若目前是 Config，請確認目標是否匹配到與預期不同的規則。檢查是否選錯設定檔、較早的規則是否已匹配，以及策略群組是否使用了其他伺服器。只有部分網域異常時，再檢查 DNS 與 Hosts 的相關設定；不要一開始就同時修改 DNS、TCP、UDP 和 Proxy 連接埠。

Settings 中的 On Demand 用於設定自動連線條件；Today Widget 與顯示及快捷操作有關，不能取代伺服器參數；Proxy、TCP、UDP 則涉及不同的連線設定。首次連線不必把這些項目全部調整一遍。確有證據指向某項設定時再修改，並記錄原值以便還原；詳細說明與適用範圍請參閱Settings 設定項目參考。

每次只修改一個變數，再對同一目標重複驗證。若修改無效，先還原原值再繼續。這樣可判斷問題來自基本網路、匯入資料、伺服器連線或規則選擇，也能避免一次排查引入多個新問題。更多訂閱更新、系統授權與連線狀況說明，請參閱問答頁；已完成基本連線驗證的使用者，可繼續閱讀規則語法與匹配順序。