Shadowrocket
匯入與連線教學

伺服器記錄用來儲存一條連線所需的參數；訂閱則用來取得並更新一組伺服器記錄。先確認手上的資料屬於哪一種：如果是完整的訂閱 URL，請使用 Subscribe；如果有協定、位址、連接埠與認證資訊，請使用 Add Server 手動填寫。兩種方式不必同時使用，也不要將訂閱 URL 填入 Host。

已有訂閱連結：選擇 Subscribe

開啟 Shadowrocket 的 Home，在 SERVER 區域找到並開啟 Add Server。點開 Type，選擇 Subscribe，在相應的 URL 欄位貼上自己的訂閱連結，再填寫方便辨識的備註並儲存。Subscribe 是匯入現有訂閱的入口，不是購買 App 的頁面。儲存後返回 Home，等待訂閱請求完成，再確認是否出現訂閱群組與伺服器記錄；如果只有訂閱名稱而沒有實際伺服器，還需要確認取得結果。

貼上前請確認連結完整，尤其是問號後的參數、大小寫與結尾字元。聊天文字中的換行、前後空格或標點符號不應包含在 URL 中。下方僅示範連結格式，不能用來連線；請使用自己已有的位址，勿將含有實際憑證的連結貼到公開頁面或求助截圖中。

https://example.com/sub?token=xxxx

訂閱能否更新，取決於連結是否有效、目前網路狀況及訂閱位址的回應。若更新失敗，請先保留原有記錄，確認自己的訂閱是否有效，再嘗試重新整理；反覆新增相同 URL 通常只會產生重複群組，無法修復請求失敗。若訂閱也涉及規則設定，請另外確認 Config；出現伺服器清單不代表目前規則已準備就緒。

已有單筆伺服器資訊：填寫 Add Server

在 Add Server 中先選擇 Type，再填寫該協定對應的欄位。以截圖中的頁面為例，Host 是伺服器位址，Port 是連接埠，Password 與 Method 必須符合現有資訊。切換 Type 後欄位可能有所不同，例如 VMess 或 VLESS 會使用不同的認證與傳輸參數，不能將某個協定的欄位照搬到另一個協定。若遇到不熟悉的欄位，請先參閱名詞解釋，再返回本頁繼續操作。

手動填寫時，請逐項確認位址沒有多餘路徑、連接埠完整，且認證資訊未誤複製空格。TLS、傳輸方式及相關主機名稱也要依現有資訊填寫，不要為了填滿表單而自行猜測。資料不完整時，請向原資訊提供者確認缺少的欄位；只切換 Type 無法補齊參數。

若已有相應的 QR Code，可使用 Scan QR Code 匯入，再開啟記錄確認欄位。Import from Cloud JSON 僅適用於已有且格式相符的設定來源，並非一般訂閱 URL 的通用替代方式。儲存完成後返回 Home，確認 SERVER 中看得到該記錄。到這裡只完成了「儲存連線資訊」，下一步仍須決定如何處理流量。

返回 Home，在 SERVER 中選擇剛儲存或從訂閱匯入的伺服器，確認目前選取的是準備測試的項目。若訂閱中有多筆記錄，請先固定一筆進行驗證，不要同時更換伺服器、模式與設定，否則很難判斷是哪項變更影響結果。若 Config 使用策略群組，也須確認實際策略的選擇；Home 中選取的項目不一定是每條規則最終使用的出口。

再次查看 Global Routing 的顯示值，確認與上一階段的選擇一致，再開啟 Home 頂端的連線開關。首次建立連線時，系統可能會提示允許 Shadowrocket 新增 VPN 設定。確認提示是由目前主動操作觸發後，依照系統提示允許，並使用裝置要求的身分驗證方式完成授權。這是建立系統網路連線所需的權限，並非匯入伺服器密碼的步驟。

完成授權後返回 Shadowrocket，觀察頂端是否從 Not Connected 轉為連線狀態。若開關立即關閉，或仍顯示未連線，請先確認系統授權已完成，再檢查目前記錄與設定。關閉系統提示後，不要假設連線已建立；也不要只因開關曾亮起就結束驗證。

iPhone 與 iPad 的操作順序相同，介面配置可能因裝置而異。系統中的 VPN 狀態可作為輔助確認，但只能表示系統連線狀態，無法單獨證明遠端伺服器可連線、網域解析正常或規則匹配正確。之後仍須執行 Connectivity Test 並瀏覽實際頁面。若裝置上已有其他正在使用的 VPN 連線，請先確認系統目前啟用的是哪一項，避免兩種連線操作互相影響。

需要修改伺服器參數時，可先關閉連線再編輯，儲存後重新開啟並測試。初次使用也建議暫緩調整 On Demand：先手動連線並中斷一次，確認基本運作正常，再設定自動觸發條件。現在請保持選取的伺服器與模式不變，進入下一步，透過測試與實際瀏覽一同確認是否生效。

先判斷問題發生在哪個階段，再前往 Settings 調整相關選項。訂閱未取得記錄、開關無法維持連線、測試失敗，以及只有特定頁面異常，都是不同問題。將狀況分開處理，通常比連續修改 Proxy、TCP、UDP 等設定更容易找出原因；不清楚用途的選項請先維持原值。

匯入失敗：先確認 URL 與輸入欄位

如果 Subscribe 儲存後沒有出現伺服器記錄，請先檢查 URL 是否完整複製、訂閱是否仍有效，以及目前網路能否連線至該訂閱位址。更新訂閱時必須先向該位址發出請求，不要假設清單中的伺服器一定能協助完成這項請求。確認後再嘗試更新；已有可用記錄時請先保留，避免讓「更新失敗」演變成「所有記錄都被刪除」。

若是手動新增的記錄，請重新進入 Add Server，對照原始資訊逐項檢查 Type、Host、Port 與認證內容，再確認 TLS 及傳輸相關欄位。密碼、UUID、主機名稱與路徑都不能憑印象補填。匯入 QR Code 後也需要確認結果；記錄可以儲存，只代表 App 接受了表單，不表示遠端參數一定正確。

測試失敗：區分測試方式與實際連線狀況

在 Settings 查看 Test Method，確認目前的測試方式後重新執行 Connectivity Test。某種測試失敗時，仍須搭配實際頁面瀏覽結果判斷，不要立刻認定所有連線都無法使用。也可在自己可用的 Wi-Fi 與行動網路之間進行對照，並保持伺服器與模式不變；若結果隨網路而改變，請著重檢查網路連線能力與相關限制，不要同時修改所有欄位。

如果開關立即關閉，請先完成系統授權並檢查目前設定。如果開關維持連線但多項測試都失敗，請確認現有伺服器是否有效，再查看 Diagnostics 中的相關資訊。Diagnostics 可協助定位問題，但不會自動補齊錯誤參數。請記下完整錯誤內容與發生時間，再依實際狀況繼續排查。

Config 異常：檢查規則順序與策略引用

若代理 (Proxy) 可以瀏覽，但設定 (Config) 不行，請返回 Config 檢查目前使用的檔案、Rule 順序與策略群組。常見原因包括選錯設定檔、請求先匹配到不適用的規則，或規則引用的策略沒有可用伺服器。不要直接刪除整段 Rule 嘗試修復；請先確認測試目標的匹配結果，再修改一項並重新測試。

若只有特定網域無法連線，請搭配連線記錄檢查實際目標、解析結果與匹配策略。DNS 與規則問題有時會出現相似的狀況，難以單憑頁面錯誤區分。可先保留原設定作為對照，逐項檢查，而非反覆更換訂閱。規則關鍵字與協定欄位的詳細說明請參閱名詞解釋，更多狀況分類請查看FAQ。

連線自動變更：查看 On Demand

手動中斷後連線又重新出現，或切換網路時連線狀況改變，可在 Settings 查看 On Demand 是否已啟用及其觸發條件。此功能用於依條件建立連線，不能取代伺服器本身的連線能力。首次排查時，請先記下原條件，再暫時停用相關自動觸發設定，使用手動開關重新驗證；基本連線穩定後，再恢復所需條件。

需要分享排查資料時，請遮蔽訂閱 URL 中的憑證、伺服器認證資訊，以及可識別個人的記錄，只保留問題所需的介面用語、錯誤內容與操作順序。可依「匯入方式 → 目前 Global Routing → 系統連線狀態 → Test Method 與結果 → 實際瀏覽狀況」整理，避免在公開資料中顯示完整連線資訊。

完成這五個步驟後，保留可正常運作的設定，再依需求了解其他功能。購買、商店地區與已購項目還原屬於另一套操作流程，可參閱正版指南完整了解；本頁的目標是確認自己的連線資訊、模式與實際瀏覽結果彼此相符。