Shadowrocket 使用教學
訂閱匯入與連線驗證

先將現有連線資料儲存至 Home，再處理規則與連線開關。開啟 Shadowrocket，進入 Home，找到 Add Server。接著依手邊資料選擇一種方式：完整訂閱連結用於 Subscribe；單一伺服器的位址、連接埠與驗證資料則用於相應協定的手動新增。兩種方式不必同時操作，以免重複匯入相同資料後選錯項目。

Subscribe：匯入現有訂閱

在 Add Server 中點選 Type，選擇 Subscribe，進入相應表單。在 URL 欄位貼上向服務商取得的完整訂閱連結；若有備註欄位，可填入方便自己辨識的名稱。貼上後先確認連結開頭、結尾及中間沒有混入空格、換行或通訊軟體附加的標點，再儲存。訂閱連結通常含有驗證資料，不應當作一般公開網址分享。

返回 Home 後，等待訂閱內容載入完成，確認是否出現相應群組與伺服器項目。若只看到訂閱名稱，沒有伺服器，先查看錯誤提示，再確認連結及目前網路；不要立刻反覆新增同名訂閱。日後需要同步服務商提供的項目時，使用該訂閱對應的更新功能。更新可能會變更伺服器清單，更新後應再次確認目前選取的伺服器。

Add Server：手動填寫伺服器資料

如果你有單一伺服器的參數，請依資料標示的協定選擇 Type，不要只照著截圖的預設值填寫。Host 填入伺服器網域或位址，Port 填入服務端提供的連接埠；Password、Method 等欄位是否顯示，取決於所選 Type。若資料包含 TLS、SNI 或其他傳輸設定，也應逐項核對原始資料。不同協定的驗證方式不盡相同，不可將一組參數直接套用至另一種 Type。

若已有伺服器 QR Code，可在 Add Server 使用 Scan QR Code，並依系統提示授予所需的相機權限。Import from Cloud JSON 是另一種匯入方式，不是通用的訂閱 URL 貼上位置；只有資料明確採用相應格式時才使用。儲存前請檢查辨識出的 Host、Port 與 Type；掃描成功不代表伺服器資料已經過驗證。

完成後返回 Home，在 SERVER 中點選要使用的伺服器，確認目前的選取標記。此時不必急著開啟連線開關：清單中看得到項目，只代表資料已儲存；下一步還要決定請求要以哪種模式處理。若匯入後清單為空或格式無法辨識，可先參閱疑難排解中的訂閱與節點匯入說明。

儲存伺服器資料後，返回 Home 並點選 Global Routing。這裡決定請求如何進入目前的路由流程，不會替你補齊伺服器參數。入門時先認識三種模式：配置(Config)/代理(Proxy)/直連(Direct)。先選定模式再開啟連線；之後每次排除問題時都記錄目前模式，避免將規則問題誤判為伺服器問題。

配置(Config)：依目前配置中的規則處理

日常需要規則分流時，請選擇 Config，並進入 Config 頁面確認目前使用的配置檔。在配置編輯頁面中，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段；本次入門操作的重點是 Rule。配置中的規則會決定符合條件的請求採用哪項策略，DIRECT 與代理策略的結果不同。只有確認目前配置及規則來源，才能判斷特定請求採用直連是否符合預期。

若要查看規則，先開啟目前配置中的 Rule，閱讀現有項目。不要為了完成首次連線就任意使用 Add Rule，也不要一次修改多個區段。URL Rewrite 與 HTTPS Decryption 並非基本連線的必要步驟，請保留原有設定，熟悉用途後再個別研究。匯入 Subscribe 取得伺服器清單，與取得適合自己的 Config，是兩件不同的事；伺服器數量增加不代表分流規則已設定完成。

代理(Proxy)與直連(Direct)：用於明確比較連線路徑

Proxy 會讓交由目前路由流程處理的請求採用代理模式，適合在基本排查時用來比較所選伺服器的代理路徑。此模式仍需可用伺服器與正確參數；選擇 Proxy 無法修正密碼、連接埠或 TLS 設定錯誤。Direct 則採用直連模式，適合確認本機網路本身能否連線至目標。在 Direct 下連線正常，只能代表這次直連請求成功，不能據此證明代理路徑也正常。

以下片段僅供辨識 Rule 語法，不是要立即貼上的完整配置。第一行依網域後綴比對，第二行是最終處理規則；策略名稱與規則順序都須搭配實際配置閱讀。

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

首次操作可先保留已確認的 Config；若結果不明確，再暫時切換至 Proxy 對照一次，完成後恢復預期模式。不要把「所有請求都走代理」視為唯一正確結果。若要深入了解規則順序、策略引用與 DNS 的關係，請閱讀疑難手冊；本頁先繼續完成連線。

現在返回 Home，進行連線前檢查：SERVER 中已選取伺服器，Global Routing 顯示剛才選定的模式，且目前裝置可正常連上網路。若剛從其他網路切換過來，先等 Wi-Fi 或行動網路穩定後再繼續。如此一來，發生異常時較容易判斷是裝置網路尚未連線，還是用戶端的連線流程出了問題。

使用 Home 頂端的連線開關

點選 Home 頂端的連線開關。首次連線時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定；確認這是剛才主動執行的操作後，依系統提示完成允許與裝置驗證。此授權用於建立系統網路設定，不是購買服務或新增伺服器。若尚未完成系統授權，即使已儲存伺服器參數，App 也無法依正常流程建立連線。

完成授權後返回 Home，查看頂端狀態是否已從 Not Connected 改變。若開關仍然關閉，先確認系統提示是否已處理完畢，再嘗試連線一次；不要連續快速點擊開關。若開關立刻跳回或持續顯示未連線，記下畫面提示，並檢查裝置是否有其他 VPN 設定正在連線，或受到裝置管理策略限制。此時先處理開關與授權問題，不必重新填寫整份訂閱資料。

區分連線狀態與實際可用性

頂端連線狀態與系統的 VPN 標示，反映的是連線流程狀態，並不保證所有目標服務都能使用。伺服器參數錯誤、連接埠無法連線或規則不如預期，都可能在開啟開關後才顯現。因此本步的完成標準是：系統授權已完成、Home 連線狀態穩定，而且伺服器與模式仍是剛才選定的項目。實際請求能否成功，須在下一步另外驗證。

首次使用時先手動開關連線即可，不必同時啟用 On Demand。按需連線條件可能在網路變更時觸發連線；若與手動測試混在一起，會難以判斷「為什麼又連線了」。結束本次測試時，返回 Home 關閉開關，再確認狀態已恢復。不要以強制結束 App 來確認系統連線是否已停止。

iPad 也依相同順序操作：先選擇伺服器與模式，再完成系統授權，最後查看連線狀態。畫面配置或導覽位置可能與 iPhone 不同，但檢查 Home、SERVER 與 Global Routing 的方式相同。連線穩定後先維持目前設定，接著進行 Connectivity Test 與實際連線測試。

先確認流程停在哪個步驟，再只檢查相關資料。匯入失敗、開關無法開啟、伺服器逾時與部分網頁失敗，涉及不同環節。首次排查時不建議同時修改協定、DNS、規則與測試方法；即使恢復正常，也無從判斷是哪項修改發揮作用。以下順序可協助快速縮小問題範圍；詳細原理與進階流程請參閱疑難手冊。

訂閱無法匯入或更新

先確認裝置的基本網路可正常使用，再檢查 Subscribe 的 URL 是否完整。若錯誤提示提及驗證失敗、連結失效或回傳內容格式，請向服務商確認原始訂閱資料。不要將需要登入的一般網頁網址、說明頁面或單一伺服器參數當成訂閱 URL。保留錯誤提示即可，請勿將完整訂閱連結貼到公開討論區。接著可查看訂閱失敗排查，不必先變更 Global Routing。

開關無法開啟或連線立即中斷

先回看第三步，確認系統 VPN 設定授權是否已完成，並檢查是否有其他 VPN 連線正在使用中。若裝置受組織管理，相關網路權限可能由裝置管理策略控制，請依裝置管理規範處理。這類問題發生在建立連線的階段，通常無法透過重新選擇 Rule 解決。保留系統提示原文，再前往疑難排解查閱安裝與首次開啟的相關說明。

伺服器逾時或連線後無法使用網路

重新開啟對應伺服器的編輯頁面，依資料逐項檢查 Type、Host、Port、驗證欄位，以及 TLS 和傳輸設定。不要只因名稱相似就認定參數相同，也不要以降低安全性驗證來取代正確設定。確認參數後，以同一目標進行一次測試；若要切換 Wi-Fi 與行動網路，請維持伺服器與模式不變。若只在其中一種網路下失敗，記錄這項差異，再從本機網路與伺服器可連線性繼續排查。

只有部分請求失敗或速度不如預期

先確認 Global Routing，再比較 Config 與 Proxy 對同一目標的結果。若只有 Config 下失敗，優先檢查目前配置、規則順序與策略引用；若兩種模式都失敗，再檢查伺服器路徑與目標服務。若是網域相關問題，可接著閱讀DNS 排查。不要只因單一目標連線失敗就修改所有 DNS 設定，也不要用單次測試數據推斷長期速度。

Settings：保留必要的診斷資料

進入 Settings 後，先找到與目前排查環節相關的項目。Test Method 用於確認測試方式，Diagnostics 可作為進一步檢查的入口；On Demand 涉及自動連線條件，Proxy、TCP、UDP 等設定則應在了解用途後分別處理。首次連線不必將這些項目全部修改。截圖展示的是可辨識的設定入口，不是一組必須照抄的參數。

若要向服務商確認問題，請提供錯誤提示、發生條件與已完成的對照測試；分享截圖或診斷記錄前，請移除 Password、訂閱驗證資料及其他個人資訊。若仍無法定位，請依疑難手冊中的症狀章節繼續排查。完成基本流程後，可前往功能說明了解 On Demand 與診斷功能，再逐項擴充設定。