Shadowrocket 匯入、連線與驗證

開啟 Shadowrocket 後進入 Home，先查看下方的 SERVER 分組。首次使用時，從 Add Server 進入新增頁面；已有記錄時，也可以從這裡繼續新增。進入後先確認手上的資料屬於哪一種：用來取得伺服器清單的訂閱連結，或包含明確位址、連接埠與驗證參數的一組資料。兩種資料的匯入方式不同，不要把整條訂閱連結填入 Host。

已有訂閱連結：選擇 Subscribe

點選 Add Server 中的 Type，選擇 Subscribe，再返回訂閱位址頁面。將從自己的服務提供者取得的完整連結貼到 URL 欄位，確認沒有多餘空格、換行，也沒有被通訊軟體截斷。若有備註欄位，可使用容易辨識的名稱區分用途；備註僅供本機識別，不能取代連結中的驗證資訊。

儲存後返回 Home，等待清單載入完成，再展開對應分組查看伺服器記錄。若只顯示訂閱名稱，卻沒有伺服器項目，應先檢查更新結果，不要反覆切換連線開關。之後更新時，使用 App 提供的訂閱更新功能，完成後再確認記錄是否仍存在。位址失效、服務到期或回傳內容格式不符時，應依原服務資料確認；重新購買 App 無法解決這些問題。

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

手動新增時，先在 Type 選擇與現有資料完全相符的協定，再填寫 Host 和 Port。Host 是伺服器位址，不要加上網頁路徑；Port 是服務端指定的連接埠，不要依協定名稱猜測。以 Shadowsocks 為例，還需要逐字確認 Password 和 Method；其他 Type 可能會顯示不同的驗證、TLS 或傳輸欄位，請依相應資料填寫，不要將一種協定的欄位套用到另一種協定。

頁面底部的 Scan QR Code 可掃描現有 QR Code，Import from Cloud JSON 則用於匯入相應格式的資訊。掃描後仍須檢查 Type、Host、Port 與驗證欄位；成功辨識 QR Code 不代表參數一定有效。若系統要求相機權限，請依是否需要掃描功能決定；選擇手動輸入不需要相機權限。

儲存前再次核對輸入內容，返回 Home 後確認記錄名稱與分組。建議先選一筆資訊完整的記錄完成後續步驟，避免同時匯入多組資料而無法判斷目前使用的是哪一筆。此時先不要變更 Settings 中的進階參數，下一步只處理 Global Routing 與設定檔之間的關係。

返回 Home，點選 Global Routing 查看目前模式。介面中的三種選項在本教學中稱為設定(Config)、代理(Proxy)、直連(Direct)。先確認目前選項，再進行變更；不要假設首次開啟時一定處於某種模式。日常使用建議選擇 Config，但前提是已確認目前設定符合自己的需求。

設定(Config)會依目前生效檔案中的規則決定請求路徑。若已有可用設定，請進入 Config，確認實際選取的檔案，再開啟編輯頁面查看 General、Rule 等區段。Rule 中的規則通常由上而下比對，最先符合的規則會決定策略；FINAL 用於處理前面規則都未符合的請求。只查看檔案內容不代表已切換生效檔案，返回清單後還須確認選取狀態。

代理(Proxy)會讓請求採用代理路徑，首次驗證時可短暫用來對照，協助判斷問題出在伺服器連線或分流規則。它不是自動修復選項：Host、驗證資訊或服務狀態不正確時，切換到 Proxy 仍可能失敗。直連(Direct)則用於直連路徑，可作為基礎網路對照；選擇它之後，不能以目標請求的直連結果證明代理伺服器已生效。

若已有設定，請先維持其他選項不變，在 Config 模式下完成連線；若只有伺服器資料，尚未確認目前設定，可暫時使用 Proxy 進行一次明確的連線測試，測試結束後再整理 Config。不要為了完成首次連線而同時啟用 URL Rewrite 或 HTTPS Decryption；這些區段不是一般連線的必要條件，且各有適用情境。

以下片段僅供辨識規則結構，首次上手時不需要貼上。第一行會比對指定網域後綴，第二行提供最終策略；範例中的網域不是測試服務，也不含連線資料。

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

規則編輯、DNS 與策略的詳細說明，請參閱Settings 與設定選項手冊。本教學只需記下目前模式、目前設定與所選伺服器；記錄清楚後再進入連線步驟，才能在後續排除問題時重現相同條件。

返回 Home，在 SERVER 分組中點選要使用的伺服器，確認選取標記位於預期記錄上。若分組中有多筆記錄，不要依排列順序推斷目前使用的是哪一筆。接著再次確認 Global Routing 的顯示值與上一步相同，再開啟頁面頂端 Not Connected 附近的連線開關。

首次連線時，系統可能會顯示新增 VPN 設定的提示。這是允許 App 建立網路連線設定的系統授權流程，不是要求再次購買 App，也不是訂閱更新提示。閱讀提示中的 App 名稱，確認是目前操作所觸發後，依系統要求完成確認；裝置可能會要求輸入密碼或進行系統驗證。授權後返回 Shadowrocket，查看頂端狀態是否變更。

若選擇取消，App 就無法依此流程完成連線；準備好後，請重新開啟連線開關並完成系統授權。若裝置由組織管理，設定限制也可能影響授權，此時應依裝置管理要求處理，不要反覆變更伺服器密碼。完成系統授權只代表網路延伸功能具備執行條件，尚不能證明遠端伺服器已正確回應。

狀態變更後，先稍候並觀察是否立即中斷，再進行下一步驗證。連線開關維持開啟、系統顯示 VPN 標示，以及目標服務可正常存取，是不同層次的結果；任何一項都不能單獨取代完整驗證。若開關立即關閉，先記下提示內容與目前模式，不要快速反覆切換，以免干擾診斷記錄。

首次手動連線時，建議先不要額外設定 On Demand。此功能會依條件觸發連線，並非首次連線必須開啟的設定。若先前已設定自動連線條件，請先記下狀態，避免手動關閉後又被自動觸發，誤以為開關失效。連線穩定並完成驗證後，再另外設定自動化行為。

先檢查基礎網路與匯入結果

基礎網路是所有連線的前提。先關閉連線開關，在目前的 Wi-Fi 或行動網路下存取原本可以直連的服務；若同樣無法使用，應先處理網路連線。公共 Wi-Fi 可能要求先完成網路登入，未登入時，訂閱更新與伺服器連線都可能受到影響。切換網路進行對照時，記錄切換前後的結果，不要直接比較不同網路下的測試數字。

若 SERVER 中沒有可選記錄，問題仍在匯入階段。重新確認 Subscribe 位址是否完整、更新時是否出現錯誤，以及原服務資料是否仍有效。若清單中有記錄，但其中一筆連線失敗，請開啟該記錄檢查 Type、Host、Port 與驗證參數；若有 TLS 或傳輸設定，也要確認相應欄位。裝置日期與時間明顯不正確時，也應先校正，再重新測試涉及憑證的連線。

接著檢查模式、規則與 DNS

連線狀態維持但目標無法使用時，先確認目前不是 Direct。若 Proxy 與 Config 的結果不同，請檢查目前生效的檔案及 Rule 順序，特別是過早符合的規則與最後的 FINAL。不要只編輯未啟用的檔案，卻用另一個檔案的結果判斷修改是否有效。

DNS 負責解析網域名稱；解析失敗與伺服器交握失敗是不同問題。只有在錯誤提示或記錄指出問題出在解析階段時，才檢查目前設定中的 DNS。不要將網路上找到的位址整批覆蓋到設定中，也不要同時變更 DNS、規則與伺服器。先保留原值，每次只改一項，再對同一目標重新測試；相關欄位與建議值請參閱選項手冊中的 DNS 與診斷說明。

最後檢查測試方式與自動連線

進入 Settings，查看 Test Method 與 Diagnostics。Test Method 會影響測試結果的意義，不要將不同方法測得的耗時視為相同指標。Diagnostics 可用於進一步定位問題；實際入口與可用工具請以目前 App 顯示為準。保留診斷資訊時，重點記錄發生時間、目前網路、所選模式與錯誤文字，不必公開整份設定。

手動關閉後再次連線，或網路變更後的行為與預期不同時，請檢查 On Demand 的觸發條件。此功能可依條件發起連線，排除問題時應區分自動觸發與手動操作。Proxy、TCP、UDP 等區段也不是首次使用時必須調整的項目；沒有明確問題依據時，請保留目前值，預設值以目前 App 顯示為準。

需要向自己的服務提供者確認伺服器狀態時，只提供必要的錯誤資訊，並遮蔽密碼、訂閱位址、驗證識別資訊與 QR Code。若已整理出一組可穩定重現的失敗條件，可繼續閱讀伺服器逾時與連線失敗排除順序；若要了解設定的用途與取值，請參閱Settings 設定項目參考，不要在首次上手時一次變更所有選項。