Shadowrocket 使用教學

使用訂閱連結：選擇 Subscribe

進入 Home，點選新增入口開啟 Add Server，再於 Type 中選擇 Subscribe。將向服務商取得的訂閱連結完整貼到 URL 欄位，填寫方便自己辨識的備註，然後儲存。貼上前後請檢查是否包含空格、換行或聊天軟體附加的說明文字；連結中的查詢參數也是網址的一部分，不要自行刪除。

儲存後等待訂閱載入，返回 Home 查看 SERVER 區域是否出現伺服器項目。出現名稱代表資料已讀入，不代表每部伺服器都能連線。點選要使用的項目，讓它成為目前選取的伺服器；僅將訂閱加入清單而未選取伺服器，不能取代後續連線步驟。如果匯入後清單是空的，請先檢查訂閱是否回傳有效內容，不要立刻修改 Config 規則。

之後需要更新訂閱時，請在對應訂閱項目的操作選單中執行更新，並等待結果回傳。更新會重新讀取遠端提供的伺服器資訊，項目名稱或參數可能改變，因此更新後應再次確認目前的選取項目。訂閱連結常包含存取憑證，分享排錯截圖時應遮住完整連結及驗證參數，不只是備註。

使用單筆資料：核對 Type 與驗證欄位

如果已有一部伺服器的參數，請在 Add Server 的 Type 中選擇對應協定，再填寫 Host 與 Port。Host 是伺服器位址，不應把連接埠、網頁路徑或整條訂閱連結一併填入；Port 請依服務商提供的數字填寫。Password、Method 及協定所需的其他欄位都必須與伺服器端一致。截圖展示的是特定協定的欄位，切換 Type 後顯示的項目會不同，不必刻意填入截圖中的每個欄位。

使用 Trojan 等涉及 TLS 的協定時，也應核對服務商提供的 SNI 與 TLS 相關設定；不要為了繞過錯誤而任意降低憑證驗證要求。已有 QR code 時可使用 Scan QR Code 匯入，已有單一分享連結時則使用對應的匯入入口。Import from Cloud JSON 僅適用於相應格式的資料，並非所有連結都能使用的通用入口。儲存後返回 Home，選取剛新增的項目，再繼續下一步。

手動輸入最常見的錯誤是 Type 選錯、Port 少輸一位數或複製了多餘字元。請對照原始資料逐項檢查，而不是連續嘗試不同協定。有關分享連結、Subscribe 與 Config 的差異，請參閱術語手冊。

新增並選取伺服器後，返回 Home，點選 Global Routing。三種基本模式分別是配置(Config)、代理(Proxy)、直連(Direct)。不要因為名稱中都有 Config，就把 Home 中的模式選擇與底部 Config 設定檔管理視為同一個頁面：前者決定是否依規則處理，後者用於選取和編輯特定配置。

配置(Config)：依目前配置分流

日常需要依規則分流時，請選擇配置(Config)。接著進入 Config，確認已選取準備使用的設定檔，再檢查其中的 Rule 區段。規則依排列順序比對，命中後採用相應策略；PROXY 表示依代理策略處理，DIRECT 表示直接連線，REJECT 表示拒絕。配置中引用策略群組時，也要檢查群組內實際選取的項目，不能只因伺服器清單中已有項目，就認定規則一定會使用它。

以下是「指定網域及其子網域經過代理，其餘直接連線」的最簡語法範例。這只用來說明規則關係，初次使用不必覆蓋現有配置。example.com 是示範網域，實際使用時應替換為明確需要處理的目標；編輯前請保留原配置副本，避免訂閱已成功匯入，卻因覆蓋規則而造成新問題。

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

第一條規則會比對 example.com 及其子網域，FINAL 則處理前面未命中的請求。如果將 FINAL 放在特定網域規則之前，後續規則就無法依原本預期執行。截圖中的 General、Rule、Hosts、URL Rewrite 等區段各有用途，初次驗證連線時不必同時修改；需要逐條編寫時，再閱讀Rule 規則參考。

代理(Proxy)與直連(Direct)：用來區分問題

代理(Proxy)適合在排查時暫時檢查所選伺服器的代理路徑，以減少規則分流造成的變因，但不應將它理解為任何網路條件下所有系統流量都必定經過同一條路徑。直連(Direct)讓請求不經代理伺服器轉送，可用來觀察目前網路直接存取目標的情況；這並不能證明伺服器已成功連線。

首次測試可先用代理(Proxy)確認代理存取，再切回配置(Config)驗證規則。切換後請重新送出請求，必要時關閉並重新開啟測試頁面，避免沿用舊連線。確認模式與 Config 後，下一步才是開啟 Home 頂端的開關。

返回 Home，在 SERVER 區域確認目前選取的是剛匯入或填寫的伺服器，並核對 Global Routing 的設定值。頂端顯示 Not Connected 時，表示尚未建立目前的連線。開啟頂端開關；首次使用時通常會出現系統新增 VPN 設定的提示，請依提示允許，並在裝置上完成密碼或生物辨識驗證。請勿將裝置解鎖密碼填入 Add Server 的 Password 欄位，兩者用途不同。

完成授權後返回 Shadowrocket，等待 Home 狀態變更。系統 VPN 設定是讓裝置將相關網路請求交由用戶端處理，並不代表遠端伺服器已可連線。即使開關維持開啟，仍需進行下一步的存取驗證；反之，若系統授權遭取消，用戶端可能無法維持連線，應先處理授權問題，而不是反覆更新訂閱。

如果開關剛開啟就自動關閉，請檢查系統是否還有其他正在使用的 VPN 連線、是否受到裝置管理政策限制，以及 Shadowrocket 的 VPN 設定是否遭停用。排查時先停止互相衝突的連線，再重新操作；由組織管理的裝置應遵守管理要求，不要嘗試繞過限制。若出現具體錯誤，請記錄錯誤原文與觸發步驟，再依錯誤所在環節處理。

正常中斷連線時，也請在 Home 關閉頂端開關。若之後出現自動重新連線的情況，再檢查 Settings 中的 On Demand 及其觸發條件，而不是直接刪除伺服器。此時請先維持一次手動連線，完成下方驗證後，再決定是否啟用自動連線。

匯入失敗：檢查連結與資料格式

訂閱無法更新或清單為空時，先確認使用的是訂閱網址，而不是服務商的管理頁面。檢查複製的內容是否完整、訂閱是否仍有效，以及目前網路是否能取得訂閱內容。有些更新請求本身仰賴特定網路條件，請向服務商確認，不要將訂閱更新失敗與伺服器連線失敗混為一談。若伺服器已顯示但無法使用，再檢查參數與連線。

連線失敗：檢查伺服器與測試方法

對照原始資料檢查 Type、Host、Port、Password 及協定要求的欄位。若發生 TLS 相關錯誤，請檢查裝置時間與伺服器要求的名稱是否一致，不要直接將驗證選項改成較寬鬆的設定。開啟 Settings 查看 Test Method，了解 Connectivity Test 目前使用的方式；不同方法的結果不能直接視為相同指標比較，更不能把單次回應時間當成穩定性保證。

如果某部伺服器失敗，但同一訂閱中的其他伺服器可用，請記下失敗項目的名稱與錯誤，再向服務商確認該伺服器狀態。如果所有伺服器只在同一種網路下失敗，應優先檢查該網路的驗證、連線條件與解析情況。不要因一次測試失敗就刪除所有項目，刪除後會失去可供比對的資訊。

已有連線但分流不正確：返回 Global Routing

檢查是否誤留在直連(Direct)、是否使用了另一份 Config，以及較前面的規則是否先比對到目標。需要檢查規則時，請只保留明確的測試目標，從特定網域規則逐項檢查到 FINAL。DNS、URL Rewrite、HTTPS Decryption 等功能各有適用條件，首次連線失敗時不應一併開啟；更深入的語法與優先順序說明請見規則參考。

自動連線與診斷：最後再調整

On Demand 用於依條件觸發連線，無法補全錯誤的伺服器參數。請先確認手動連線正常，再進入 Settings 檢查 On Demand 的條件與預期行為。如果手動中斷後又自動連線，請先核對這裡的設定。Settings 中的 Proxy、TCP、UDP 等項目屬於更細部的網路選項；尚未釐清問題原因前，請先保留現有設定，避免增加額外變因。

若要進一步找出問題，可使用 Diagnostics 中與問題相關的工具，並記錄錯誤發生時的網路類型、目標與操作順序。診斷記錄可能包含網域、伺服器位址或驗證相關資訊，分享前請檢查並遮蔽敏感內容。排查完成後，還原暫時修改的模式與測試設定，再重複一次「連線—存取—核對規則」，完成整體驗證。更多常見情況請見常見問題，不熟悉的欄位可在術語手冊查閱。