Shadowrocket 使用教學

已有訂閱連結：選擇 Subscribe

開啟 Shadowrocket，停留在 Home，點選 SERVER 分組附近的 Add Server，進入新增頁面。在 Type 中選擇 Subscribe，再將現有的完整訂閱連結填入對應的 URL 欄位。訂閱連結是用來取得伺服器項目的網址，不是一般的服務介紹網頁；請向服務提供者確認原始連結，勿將瀏覽器網址列中的任意頁面網址當成訂閱連結。

貼上後，從頭到尾檢查一次：連結前後是否有空格、是否多複製了引號或中文說明，以及換行是否截斷內容。訂閱連結可能包含存取設定的憑證，請只儲存在信任的裝置中，勿放入公開截圖、聊天室或排錯記錄。確認填寫無誤後儲存，返回 Home，檢查是否出現訂閱對應的分組，以及分組中是否已有伺服器項目。

如果只看到訂閱名稱，卻沒有可選的伺服器，先不要開啟連線開關。這通常表示「儲存訂閱網址」與「成功取得並解析內容」尚未同時完成。請檢查目前網路能否存取該網址，並確認訂閱仍有效、回傳內容符合要求，再嘗試更新。重複新增相同訂閱只會增加重複項目，無法修正無法取得的網址。

已有伺服器參數：依 Type 逐項填寫

如果取得的是單一伺服器資料，同樣從 Add Server 進入，先選擇與資料相符的 Type，再填寫 Host、Port 及該協定要求的驗證欄位。以截圖中的欄位為例，Password 與 Method 必須和伺服器端一致；改用其他協定時，介面會顯示不同欄位，請勿沿用上一種協定的填寫方式。Host 通常填寫伺服器網域名稱或 IP 位址，不可自行加上網頁路徑。

連接埠、加密方式、Password、UUID、TLS 與 SNI 等參數各有用途，只填寫目前 Type 要求的項目。若缺少某項資料，請回頭核對原始資訊，不要自行猜測常見值。若已有 QR Code，可使用 Scan QR Code 掃描，再檢查辨識出的 Type 與參數是否完整。Import from Cloud JSON 適用於相應格式的資料，並非通用的訂閱連結匯入入口。

儲存後返回 Home，確認新項目位於預期的 SERVER 分組，點選準備使用的伺服器。名稱僅供辨識，不能證明連線有效；此時只代表「資料已加入且可選取」。下一步先決定如何使用這些資料，再開始連線。不熟悉協定欄位時，可參閱協定術語表，初次設定不必同時學會所有協定。

返回 Home，點選 Global Routing，查看目前的選擇。三種模式分別為設定(Config)/代理(Proxy)/直連(Direct)。請勿將 Global Routing 中的 Config 與底部用來管理設定檔的 Config 頁面混淆：前者用來選擇路由模式，後者用來檢查設定檔內容。選對伺服器不代表已選對請求處理方式，這兩處都需要確認。

若已有明確可用的設定檔，準備依網域或 IP 分流，可選擇設定(Config)。接著進入 Config 頁面，確認目前使用的檔案是預期的那一份，再查看其中的 Rule。設定檔與訂閱是不同類型的內容：訂閱主要提供伺服器項目，設定檔還可能包含規則、DNS 及其他處理設定。訂閱更新成功，不代表規則也已自動切換至所需的檔案。

截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定編輯頁面中的不同區段。初次連線只需確認目前檔案及 Rule 的用途，不必為了「完成設定」而逐項修改。Add Rule 用於新增規則，但規則會受到排列順序及策略名稱影響；尚未了解這些關係前，請勿直接拼接網路上找到的多段內容，也不必為一般連線驗證啟用 HTTPS Decryption。

如果目前只是要確認剛新增的伺服器，可暫時選擇代理(Proxy)，讓後續測試先聚焦在伺服器連線路徑；確認可用後，再切回設定(Config)檢查分流。若維持直連(Direct)，網頁能開啟也不能證明所選代理已正常運作。選擇完成後返回 Home，再確認一次 Global Routing 顯示的模式。規則的具體寫法與命中順序請參閱規則關鍵字與策略；設定檔管理請參閱Config 設定詳解。

現在返回 Home。連線前請確認兩項設定：SERVER 中選取的是否為準備測試的項目，以及 Global Routing 是否仍是上一步決定的模式。若剛更新訂閱，項目名稱或分組可能有所變動，請重新確認選取項目，不要沿用更新前的印象。首次驗證建議固定使用一台伺服器，避免測試期間頻繁切換，導致結果無法對應至特定參數。

點選 Home 頂端的連線開關。尚未連線時，頁面頂端會顯示 Not Connected。首次使用時，系統可能提示允許 Shadowrocket 新增 VPN 設定；這是 App 建立系統網路延伸連線所需的授權步驟。請確認提示是由剛才的操作觸發，再依系統流程允許並完成裝置要求的驗證。此處驗證的是裝置授權，不是要求輸入伺服器的 Password。

授權後返回 Shadowrocket，確認開關與狀態是否維持連線。若開關立即恢復原狀，先確認系統授權是否已完成，再依後文排查連線問題；不要在沒有任何回饋依據時反覆刪除訂閱。即使已出現系統 VPN 狀態標示，也應繼續進行下一步測試：該標示代表系統連線狀態，不表示每台伺服器都可連線，更不代表所有網頁都已依預期策略處理。

連線期間若要修改伺服器參數或設定檔，先確認變更屬於哪一層。為方便比較，可先中斷連線、修改並儲存，再重新連線，使用同一個目標進行驗證。使用完畢後，可透過 Home 頂端的開關中斷連線；若發現連線再次自動建立，請檢查是否啟用了 On Demand，相關設定請參閱On Demand 設定說明。請勿將按需連線觸發誤認為開關操作未儲存。

匯入後沒有項目：先檢查訂閱內容

返回 Add Server 中的訂閱設定，確認 Type 是否為 Subscribe，以及 URL 是否完整。確認訂閱仍可使用，且回傳的是可解析的設定內容，而非登入頁面、提示頁面或錯誤訊息。若原始連結已變更，請使用現有服務提供者提供的有效資料更新。此時問題發生在取得伺服器資料之前，通常不應先調整 Global Routing 或 DNS。

已有項目但連線失敗：接著檢查伺服器參數

開啟所選項目的編輯頁面，逐項比對 Type、Host、Port 與原始資料，再檢查驗證及傳輸層欄位。特別留意複製時是否漏字、選錯協定、填入其他用途的連接埠，以及 TLS 或 SNI 是否與資料一致。不要為了取代憑證與主機名稱檢查而隨意啟用 Allow Insecure；若出現相關錯誤，應先確認伺服器提供的資料與裝置時間是否正確。

若同一項目在目前網路下始終無法連線，可在自己有權使用的另一種網路環境中重新測試，並保持其他參數不變。這有助於區分問題是「只在某個網路發生」還是「在所有測試環境都發生」，但結果本身仍不足以判定確切原因。若需進一步確認伺服器狀態，請向現有服務的提供者回報必要的錯誤資訊，不必附上完整憑證。

開關無法維持開啟：檢查授權與自動連線

若一開啟連線開關就立即關閉，先確認系統 VPN 設定授權是否完成，再檢查系統中是否有其他 VPN 連線正在使用。若是手動中斷後又自動連線，請前往 Settings 查看 On Demand。排錯時可暫時停用已設定的按需觸發，改為手動控制連線；先記下原設定，測試結束後再還原。相關選項的條件與觸發邏輯，請參閱On Demand 參考說明。

連線維持但存取異常：分別檢查規則與 DNS

先依照前一步的方法比較設定(Config)與代理(Proxy)。若只有設定(Config)模式異常，請返回 Config 確認目前的檔案、Rule 順序及策略引用。較寬泛的規則若排在前面，可能先於後續的精確規則命中；FINAL 則用於處理未命中前置規則的請求。新增一條規則，不代表請求一定會使用它。

若問題表現為網域解析錯誤，請檢查目前設定中的 DNS 設定及其可連線性。DNS 影響網域如何解析為位址；代理伺服器參數則影響如何建立連線，兩者無法互相取代。不要一次貼上多組來源不明的 DNS 設定；先保留原值，每次修改後使用相同網域重新測試。完整設定說明請參閱DNS 設定詳解。

需要更多資訊：使用 Diagnostics

在 Settings 中查看 Diagnostics 相關診斷入口，並透過 Test Method 確認測試前提。記錄目前模式、是否已連線、發生問題的目標及大致操作順序，比只說「不能用」更有助於釐清問題。截圖中的 Today Widget、Proxy、TCP、UDP 等屬於不同設定範圍，不應為了排除單一問題而全部修改。只有在確認某項設定與現象有關時，才前往相應章節查看說明。

到這裡，應能分辨問題出在「資料尚未匯入」、「伺服器無法連線」、「系統連線尚未建立」，還是「特定請求的規則或解析異常」。若仍無法判斷，請保留可重現問題的最精簡操作流程，前往常見問題依照現象繼續查找。初次使用只需完成一條可驗證的連線路徑；Widget、iCloud 同步及更細部的參數調整，可等基本流程穩定後，再依Settings 設定詳解逐項處理。