Shadowrocket 使用教學
訂閱匯入與首次連線

已有訂閱連結：選擇 Subscribe

開啟 Shadowrocket，進入 Home，點選新增入口開啟 Add Server。在 Type 中選擇 Subscribe，再將完整訂閱連結填入對應的 URL 欄位。訂閱連結通常包含用於識別帳戶的參數，複製時請從頭到尾完整保留，不要附上聊天訊息中的引號、說明文字或換行，也不要將服務供應商的帳戶管理頁面當作訂閱網址。

使用 App 內的儲存或完成操作，返回 Home 並等待訂閱內容載入。接著查看 SERVER 分組是否出現伺服器項目。匯入成功的判斷依據是清單中出現可選擇的伺服器，而不只是輸入框接受了連結。如果只有訂閱名稱、沒有伺服器，請先檢查更新結果與連結是否完整；不要反覆新增相同連結，造成分組重複。

更新訂閱是重新取得服務供應商提供的清單，不是讓 App 回復購買，也不保證伺服器當下可連線。已有項目時，請先確認剛匯入的分組與目標伺服器，再繼續下一步；若連結解析失敗或清單為空，請直接依本頁第五步檢查，暫時不要修改規則。

已有個別參數：依 Type 手動填寫

如果持有伺服器位址、連接埠與驗證參數，請先在 Add Server 選擇正確的 Type，再依目前頁面顯示的欄位填寫。不同協定的欄位不盡相同，不能只因兩筆資料都有密碼，就選擇相同類型。截圖顯示的頁面包含 Host、Port、Password 和 Method；其他類型可能會顯示不同欄位。

Host 填入伺服器網域或 IP，不要順手加上網頁路徑；Port 填入取得的連接埠數值。請逐字核對 Password 與 Method，特別留意複製時是否多了前後空格。若有 UUID、TLS、SNI 或傳輸層參數，也應依照現有伺服器資訊填寫，不要自行猜測補上。儲存後返回 Home，確認新項目可見，並為它設定容易辨識的備註。

QR Code 與剪貼簿：確認內容後再匯入

若已有 QR Code，可使用 App 內的 Scan QR Code，並依系統提示授予相機權限。若要使用 App 提供的剪貼簿匯入功能，請先確認剪貼簿中是完整的分享連結，而非截圖說明或網頁內文。掃描或匯入後，仍須返回清單檢查項目類型、位址與分組；不可用「掃描完成」取代參數核對。

截圖中的 Import from Cloud JSON 是另一種匯入方式，並不等同於可輸入任意訂閱連結的欄位。初次設定時，選擇符合手邊資料的一種方式即可。訂閱、單一分享連結與 Config 檔案的差異，請參閱術語手冊；大量整理與更新方式請見訂閱與伺服器管理手冊。

本步完成條件：Home 的 SERVER 清單中已有目標伺服器，且可確認其來源與參數。接下來決定這些伺服器在什麼情況下使用。

在 Home 點選 Global Routing，查看目前選項。教學中的三種模式是設定 (Config)、代理 (Proxy) 與直連 (Direct)，介面會以英文顯示。選擇後返回 Home，再確認一次 Global Routing 旁的目前值，避免切換頁面後誤以為設定已變更。

設定 (Config)：依目前設定分流

已有明確可用的設定檔時，選擇設定 (Config)。接著進入 Config，確認目前選取的檔案就是準備使用的那一份。設定中的規則會影響請求採用代理、直連或其他策略；若檔案引用了策略群組，也須確認群組實際使用的伺服器。只有訂閱清單，不代表已有符合自身需求的分流規則。

右側官方截圖為 Config 設定檔編輯頁，可看到 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption。首次連線不必逐一修改這些區段，也不需要為了測試而新增 HTTPS Decryption 設定。先保留已知設定，了解目前 Rule 的作用後再調整；Add Rule 是新增規則的入口，不是新增伺服器的入口。

代理 (Proxy)：用於單獨確認伺服器

若還不確定設定是否正確，可暫時選擇代理 (Proxy)，透過目前選取的伺服器確認代理路徑，減少規則比對造成的變數。此模式不代表伺服器品質有保障；伺服器參數不符、驗證失效或基本網路異常時，仍可能無法連線。確認完成後，若日常需要依規則分流，請切回設定 (Config) 並重新測試。

直連 (Direct)：用於直連比對

直連 (Direct) 會以直連方式處理流量。因此，即使連線開關已開啟，也不能據此認定請求使用了清單中的代理伺服器。此模式可用來比對基本網路狀況，但不能用來確認代理伺服器是否正常。切換模式前請記下原本的選項，測試結束後恢復，避免日後將直連結果誤認為規則效果。

此處先了解各模式的差異即可。規則順序、策略名稱與比對範圍須搭配實際設定閱讀，詳細說明請見Global Routing 功能章節。不清楚規則用途時，不要只複製幾個關鍵字就取代整份設定。

本步完成條件：能說明目前選擇的是 Config、Proxy 還是 Direct；若選擇 Config，也清楚目前使用哪一份設定。接著再開啟連線。

先選擇目標，再開啟開關

返回 Home，在 SERVER 清單中選擇準備使用的項目，並確認目前選取標記。若清單中有多個訂閱分組，請留意備註相似的項目是否來自不同分組。選擇設定 (Config) 且設定引用策略群組時，也應確認群組的實際目標；在 Home 點選某個項目，不一定會覆蓋設定中指定的所有策略。

確認 Global Routing 後，開啟頁面頂端的連線開關。官方截圖在未連線時顯示 Not Connected，僅供辨識開關位置，並非目前操作的即時狀態。點選後請觀察實際裝置上的狀態變化，不要照著截圖尋找完全相同的結果。

閱讀系統 VPN 設定提示

首次建立連線時，iPhone 或 iPad 可能會顯示新增 VPN 設定的系統提示。這是 App 建立系統層級連線所需的授權步驟，不是輸入伺服器密碼的欄位。請確認目前操作由 Shadowrocket 發起，閱讀提示後依系統要求允許，並完成裝置密碼或其他裝置驗證。不要將伺服器密碼輸入裝置驗證畫面。

若暫時取消授權，App 不會只憑現有伺服器項目建立完整連線。請返回 Home 重新發起連線，並依系統實際提示操作。若授權後開關立即關閉，先記下提示內容，再依第五步逐項檢查，不必立刻刪除 App 或重新建立所有訂閱。

維持穩定的測試條件

連線期間先維持同一種網路，不要同時切換 Wi-Fi、行動網路、伺服器與模式。若正在使用其他會管理裝置 VPN 連線的功能，請先確認目前生效的是哪個連線設定，避免將設定切換造成的中斷誤認為伺服器故障。受管理的裝置也可能受系統政策影響，授權時請遵循裝置現有的管理規範。

看到連線狀態變化後，先不要立即開啟 On Demand 或修改其他設定。手動連線成功只代表完成這一步，能否處理目標請求還須進一步確認。使用完畢後可返回 Home 關閉開關；日後若需要依條件連線，再另外了解 On Demand。

本步完成條件：已處理系統授權，連線狀態維持正常，所選伺服器與模式沒有意外變更。接著透過測試結果與實際頁面一併確認。

第一項：關閉連線，確認基本網路

先在 Home 關閉連線，並開啟平時可瀏覽的頁面。若關閉後仍無法使用，請優先處理 Wi-Fi、行動網路或目前網路的登入要求。基本網路恢復後，再重新開啟連線。這項比對可避免將所有瀏覽失敗都歸咎於訂閱；測試期間仍應維持網路條件穩定。

第二項：檢查匯入內容與更新結果

若 SERVER 中沒有可用項目，請回頭檢查訂閱連結是否完整、是否含多餘空格，以及更新時顯示的結果。訂閱連結可能包含帳戶憑據，請勿將完整連結貼到公開討論區。服務狀態、使用期限與帳戶限制，請向服務供應商確認；反覆點選更新不會自動解決帳戶端問題。

手動新增的伺服器則從 Type 開始逐項檢查，再確認 Host、Port、驗證與傳輸參數。尤其不要只修改密碼，卻忽略協定類型。若原始資料缺少必要欄位，請向服務供應商取得完整資訊，不要拼湊其他項目的參數。

第三項：切換模式以釐清規則問題

若連線開關能維持開啟，但實際瀏覽結果不如預期，請先記下目前的設定與模式，再暫時切換至代理 (Proxy)，重新測試相同目標。若 Proxy 可用、Config 卻失敗，請優先檢查目前設定、比對規則與策略群組目標；若兩種模式都失敗，則繼續檢查伺服器與網路。直連 (Direct) 僅用於直連比對，不能證明代理路徑可用。

第四項：確認 Test Method 與 On Demand

進入 Settings 查看 Test Method，確認測試結果使用哪一種方法。不要為了顯示數值而任意修改 Proxy、TCP、UDP 下的多個選項；應先釐清問題與參數用途，再進行調整。每次修改一項後，返回 Home 使用相同目標重新測試，確認結果變化確實來自這次操作。

若關閉後連線又自動恢復，請檢查 On Demand 是否啟用了符合目前網路條件的自動連線規則。排查期間可先關閉按需連線，建立可控制的手動測試流程；測試完成後再恢復需要的條件。On Demand 負責決定何時發起連線，無法修正錯誤的伺服器參數。

第五項：保留診斷資訊，再深入排查

仍無法找出問題時，可查看 Diagnostics 中 App 提供的診斷內容，記錄問題發生時的網路、模式、選取項目與錯誤提示。對外分享前，請遮蔽訂閱 URL、密碼、UUID、帳戶資訊與可識別個人的瀏覽記錄。只分享與故障相關的部分，通常比提供完整設定截圖更容易判斷。

下次重新測試時，請使用相同伺服器、相同模式與相同目標。先還原上一項無效的修改，再檢查下一項，避免修改太多而難以還原。常見錯誤的進一步說明請見疑難排解；訂閱更新、多分組整理、刪除與備份請見伺服器管理手冊。完成基本步驟後，再依需求細部調整規則與自動連線條件。

本步完成條件：能指出問題所在環節，並保留可重複的測試流程。修復後返回第四步，再次確認實際瀏覽結果。