Shadowrocket 使用教學
備妥連線資訊後，依序完成匯入、模式選擇、連線與測試。先確認一條連線正常，再調整規則與 On Demand。
開始前：備妥 App 與連線資訊本教學適用於已從 App Store 安裝 Shadowrocket 的 iPhone / iPad 使用者，並以已有自己的訂閱連結或伺服器資訊為前提。本網站不提供、不販售或推薦節點與訂閱；連線資訊請向您自己的服務供應商取得。
一次買斷 App ≠ 購買連線方案。購買 App 不會自動提供可用伺服器。系統需求請以 App Store 頁面標示為準；若尚未完成購買或正版確認，請先查看取得 App 說明。
下方圖片為 App Store 官方截圖，可用來辨認介面。實際顯示的選項與排列方式請以目前 App 為準；請勿將截圖中的範例當成自己的連線資訊。
新增伺服器或匯入訂閱
先確認資料類型，再選擇匯入入口。訂閱網址、單一伺服器分享資訊與 Config 檔案並非相同內容。
開啟 Shadowrocket 後，先返回 Home。下方的 SERVER 區域可查看伺服器項目；首次使用時，請先透過 Add Server 新增資訊，不要直接開啟頂端的連線開關。匯入前請確認手上的資料類型：可更新伺服器清單的訂閱連結、單一伺服器的分享資訊，或包含規則設定的 Config 檔案。即使看起來都是一串連結，選錯入口仍可能無法解析。
已有訂閱連結：使用 Subscribe
從自己的服務供應商複製完整訂閱連結，開啟 Add Server，在 Type 中選擇對應的 Subscribe 類型，依畫面提示填入網址與方便辨識的名稱，再儲存。不同介面版面的訂閱管理入口可能有所不同，請以目前 App 顯示為準。複製時請保留原有參數，不要加入引號、空格或換行，也別把帳戶管理網頁網址誤當成訂閱連結。
儲存後，請等待訂閱內容讀取完成，再返回 Home 確認 SERVER 中是否出現匯入的伺服器。若只有訂閱名稱，沒有可選取的項目，請先確認更新是否成功，不要連續重複新增相同網址。訂閱更新只會更新該訂閱中的項目，不能據此推斷所有伺服器都能連線；下一步仍須選取有效項目並進行測試。
已有單一伺服器：依 Type 填寫
在 Add Server 中先選擇與資料相符的 Type，再填入 Host 與 Port。驗證欄位與傳輸選項會依協定而異：截圖中的 Password、Method 是特定類型的欄位，並非所有協定都通用的表單。請勿因名稱相似就替換協定，也不要任意變更服務供應商提供的加密、TLS 或傳輸設定。
若手上有 QR Code，確認內容來源後可使用 Scan QR Code；需要相機權限時，請依系統提示操作。Import from Cloud JSON 是另一種特定格式的匯入入口，請勿將一般訂閱網址直接填入。不論使用哪種方式，儲存後都應開啟項目確認欄位，尤其是連接埠、驗證資訊與協定類型。
儲存後的檢查項目
返回 Home，選取準備使用的伺服器，並確認它顯示為目前選取項目。名稱僅供辨識，不能證明連線品質。初次測試請先固定一個明確目標，避免在多個項目間切換，導致無法確認測試對象。訂閱連結通常包含帳戶憑證，請勿公開分享完整網址或匯入 QR Code；術語差異請參閱術語手冊。
完成判斷：SERVER 中已有可選取的項目，且目前選取的伺服器與準備測試的資料相符。接著再決定請求要以哪種模式處理。
選擇 Global Routing 處理模式
伺服器決定「透過哪裡連線」，模式與規則則決定「哪些請求走哪條路徑」。
完成匯入後，在 Home 點選 Global Routing，確認目前模式。本教學將三種模式稱為配置 (Config)／代理 (Proxy)／直連 (Direct)，介面中的英文名稱則維持原樣。這三者不是連線強度或速度等級；切換模式也無法修正錯誤密碼、失效訂閱或無法連線的伺服器。
配置 (Config)：依目前規則處理
若已有可信且適合目前用途的規則檔，請選擇配置 (Config)，再進入 Config 確認目前使用的設定。清單中出現檔案，不代表它已設為目前使用的配置；請確認 App 顯示的選取或使用狀態。伺服器訂閱提供連線項目，Config 則可能包含規則與相關設定，兩者須分別確認。
官方截圖展示 Config 檔案的編輯內容，包括 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption。初次連線不必逐項修改這些區段，也不需要為一般連線測試啟用 HTTPS Decryption 或安裝憑證。請先保留已知設定，再查看 Rule 中與目標請求相關的項目。
規則通常依序比對，符合後套用相應策略。例如 DOMAIN-SUFFIX,example.com,PROXY 表示符合該網域後綴的請求會使用 PROXY 策略；這只是語法範例，不是可用的連線，也不是建議直接加入現有檔案的完整設定。使用 Add Rule 前，請先確認目標、順序與策略引用方式；概念說明請參閱規則關鍵字術語。
代理 (Proxy)：比對代理連線路徑
已選好伺服器，但暫時無法判斷規則是否影響結果時，可短暫切換至代理 (Proxy) 進行比對。此模式會讓請求經由代理路徑處理，但不代表所有網路流量都會得到相同結果。若同一目標在 Proxy 下可用、在 Config 下失敗，請優先檢查規則比對結果、策略選擇與相關設定，而不是立即刪除伺服器。
直連 (Direct)：檢查直接連線路徑
直連 (Direct) 用於直接連線的情境，不會驗證代理伺服器是否可用。以 Direct 比對基本網路狀況後，請恢復實際需要的模式。若目前沒有準備好的規則檔，可先用 Proxy 測試現有伺服器，再另外整理 Config；選擇 Config 不代表會自動取得適用於所有情境的規則。
完成判斷：能清楚說明目前選擇的模式；使用 Config 時，也能確認實際使用的設定檔。保持目前選擇不變，繼續進行連線。
啟用連線與系統授權
首次允許新增 VPN 設定，是授權系統接管相關網路流量的步驟，並非匯入訂閱。
返回 Home，再次確認 SERVER 中已選取預定使用的伺服器，且 Global Routing 符合上一節的選擇。截圖中的 Not Connected 表示尚未連線；頂端開關才是開始或停止連線的入口。項目存在、項目已選取與連線已啟用，是三種不同狀態，不能只因清單中有伺服器就認定設定已生效。
開啟頂端開關。首次使用時，系統可能會提示允許 Shadowrocket 新增 VPN 設定；確認操作的是本機從 App Store 安裝的 App 後，依提示允許並完成裝置驗證。這裡授予的是系統網路設定權限，不代表伺服器資訊已通過驗證，也不會因此自動取得連線資訊。
授權完成後返回 Home，確認開關是否維持開啟，以及連線狀態是否有所變化。若剛才取消授權，重新開啟連線開關並依系統提示操作即可。若需查看系統記錄，可在系統設定中尋找 VPN 相關項目；不同系統版本的入口名稱與層級可能不同，不要只因路徑與截圖不完全一致，就判定設定遺失。
開關已開啟，不代表目標一定能存取
系統 VPN 狀態或 Home 中的連線狀態，首先表示本機網路設定已啟用；遠端伺服器能否完成驗證、目標服務是否可連線，以及規則是否符合預期，仍須進一步測試。若開關立即返回關閉狀態，請先記錄是否出現權限提示或錯誤訊息，不要快速重複點按，也不要在原因不明時建立多份系統設定。
測試期間請維持 Wi-Fi 或行動網路不變，避免同時切換伺服器、網路與模式。若裝置上還有其他會接管網路的 VPN 設定，確認其用途後，再檢查是否正在啟用，以免將彼此影響誤判為伺服器故障。使用受管理裝置或組織網路時，請遵守裝置管理規範，不要任意移除既有設定。
完成判斷：已依系統提示完成授權，且 Home 的連線開關能維持開啟。接下來先不要更動欄位，直接測試實際請求；測試結束後可返回 Home 關閉連線。
測試連線與實際請求
分別確認本機狀態、測試結果與目標操作，不要只憑單一結果下結論。
啟用連線後，在 Home 使用 Connectivity Test，查看目前測試能否完成。測試結果會受測試方法、測試目標、目前網路與伺服器狀態影響，請先記錄結果再判斷原因。測試成功只表示在相應測試條件下收到回應，不代表所有網站、App 或協定都已測試；測試失敗也不能直接證明所有實際連線都失敗。
接著開啟瀏覽器，前往自己熟悉且目前確實需要使用的頁面，重新整理一次；若要檢查特定 App，請在該 App 中發出新請求，而非只查看先前快取的內容。保持伺服器、網路與 Global Routing 不變，才能比較測試結果。既有頁面、離線內容或背景保留的畫面，都不能單獨作為連線生效的證據。
依三層證據確認
- 本機層：Home 開關維持開啟，系統沒有待處理的授權提示。這表示連線入口已啟用。
- 測試層：Connectivity Test 能完成相應測試。記下使用的方法，不要直接比較不同測試方法的結果。
- 請求層：目標頁面或 App 中的新操作能順利完成；使用 Config 時，再確認相關請求的規則與策略是否符合預期。
若只想確認某個請求是否經過代理，頁面能開啟還不夠，因為它也可能透過 DIRECT 完成。請搭配 Config 的比對規則與 App 可用的相關記錄，確認處理路徑；部分請求直連成功是分流設定的正常結果，不必為了讓每個請求都顯示為代理而修改規則。記錄或日誌只能說明其實際涵蓋的請求，不能取代所有情境的測試。
需要比較模式時，固定使用同一伺服器與目標，只將 Global Routing 從 Config 暫時切換為 Proxy，再發出新請求。若結果不同，請優先檢查設定；若兩種模式都失敗，再確認伺服器欄位、網路連線與驗證資訊。每次只記錄一項變更，避免同時更新訂閱、變更 DNS 與重寫規則後，無法找出原因。
完成判斷：目標操作能完成，且處理路徑符合用途。測試結束後，請恢復預定使用的 Global Routing；若仍有異常，請帶著「哪一層發生問題」的判斷進入最後一步。
檢查設定與常見問題
依症狀處理，每次只調整一個條件。先不要靠重新安裝或大量刪除設定來解決原因不明的問題。
開啟 Settings，先找出與目前問題直接相關的項目。官方截圖包含 Test Method、On Demand、Diagnostics，以及 Proxy、TCP、UDP 等設定。畫面中出現這些項目，不代表首次使用時必須逐一修改；測試方式、自動連線行為與協定參數分別處理不同問題，請勿將它們當成通用修復開關。
訂閱已儲存，卻沒有伺服器
先返回訂閱項目，確認讀取或更新是否成功，再檢查網址是否完整、仍有效，且內容可由 Shadowrocket 解析。有些網頁網址開啟後顯示的是登入頁，而非訂閱資料，不能直接當作訂閱連結使用。目前基本網路能否連上該網址，也會影響更新。若連結已失效，請向自己的服務供應商確認原有資訊，不要反覆匯入相同的錯誤內容。
伺服器已新增，但連線或存取失敗
開啟目前的伺服器項目，依序確認 Type、Host、Port、驗證資訊與協定相關參數，特別留意複製時多出的空格或遺漏欄位。接著確認 Home 選取的就是這個項目。若開關無法維持開啟，請優先檢查系統授權；若開關正常但實際請求失敗，再確認 Global Routing、Config 與伺服器連線狀態。不要將「已有項目」、「已授權」與「遠端可用」混為同一項檢查。
Connectivity Test 與實際連線結果不同
在 Settings 查看 Test Method，先確認目前的測試方式，再搭配瀏覽器或目標 App 的實際操作判斷。不同伺服器對不同測試方式的回應可能不同；測試數值僅供相應條件下比較，不應據此保證實際速度。若只有特定目標失敗，請維持其他條件不變，檢查該目標對應的規則、解析與服務狀態；詳細步驟請參閱疑難排解手冊。
關閉後又自動連線：檢查 On Demand
On Demand 會影響按需觸發連線的行為。基本連線尚未確認前，建議先使用手動開關建立明確的測試基準；連線穩定後，再依自己的使用情境設定 On Demand。若關閉後又重新連線，請先檢查是否設定了相關條件，不要立即認定開關故障。On Demand 無法修復伺服器驗證問題，也不會自動恢復失效的訂閱。
需要診斷時，先整理必要資訊
使用 Diagnostics 或查看相關記錄前，先記下問題發生的步驟、目前模式、網路類型，以及變更一項條件後的結果。分享記錄時，請移除完整訂閱網址、驗證欄位、QR Code 與可辨識帳戶的資訊；也請檢查截圖邊緣與展開區域是否包含憑證。完整診斷可能涉及 DNS、規則順序、TCP / UDP 或 iPad 使用情境，本頁不展開批次修改；請繼續參閱疑難排解手冊的症狀章節。
本次完成：能匯入資訊、選取伺服器、啟用連線並完成實際請求，就已建立基本使用流程。接下來先了解術語手冊中的 Config、PROXY、DIRECT 與 FINAL，再逐項調整規則；保留一份已驗證的設定，方便比對與還原。
首次設定完成確認
確認以下五項後，再新增自動連線條件或複雜規則。
- 現有資訊已正確匯入，且 Home 中已選取準備使用的伺服器。
- 確認 Global Routing 目前使用 Config、Proxy 或 Direct；若使用 Config，也已確認目前使用的設定檔。
- 已完成首次 VPN 設定授權，連線開關能維持預期狀態。
- 已執行 Connectivity Test，並在目標頁面或 App 中完成一次新的實際請求。
- 測試後已恢復日常所需模式；若啟用 On Demand，也了解其觸發條件與手動開關的關係。
再次使用時，通常只需確認目前的伺服器、模式與連線狀態，不必重新匯入。更新訂閱或切換網路後若發生異常，從受影響的步驟重新檢查即可；需要更完整的排查流程時，請參閱Shadowrocket 疑難排解手冊。