Shadowrocket
使用指南

開啟 Shadowrocket 後，先停留在 Home，不要急著開啟頂端的開關。先判斷手邊資料的類型：訂閱連結用於取得一組可更新的伺服器項目；單一分享連結通常對應一台伺服器；分開提供的 Host、Port、Password 等文字則用於手動填寫。三種資料應使用各自的入口，不能把訂閱網址直接填入 Host，也不能把整條分享連結當成 Password。

已有訂閱：使用 Subscribe

在 Home 點選右上角的新增按鈕，進入 Add Server；在 Type 的類型選項中找到 Subscribe，填入自己的訂閱連結和方便辨識的備註，再儲存。不同介面的版面可能會將訂閱列為獨立入口，請以實際顯示的 Subscribe 為準。完整貼上連結，尤其保留問號後的參數，不要連同聊天訊息中的說明、空格或換行一起複製。

儲存後返回 Home，等待項目載入；若尚未出現伺服器，請使用該訂閱的更新功能，再檢查網路和連結是否有效。確認 SERVER 群組中出現可選取的項目，才算完成匯入。訂閱名稱出現不代表內容已成功取得；連結過期、內容格式不符或請求失敗，都可能留下空白群組。不要反覆新增同一連結來解決空白群組問題，應先檢查原項目的更新結果。

手動填寫：逐項對照伺服器資料

若只有個別參數，請在 Add Server 的 Type 中選擇資料指定的協定，再填寫 Host 與 Port。截圖中的 Password、Method 欄位會依目前類型而定；選擇其他協定後，驗證和傳輸欄位也會改變。Host 通常填寫網域名稱或 IP，不需額外加入網頁路徑；Port 填入伺服器提供的連接埠。Password、Method 以及 TLS、傳輸相關參數都應依原始資料填寫，不要因名稱相似而自行替換。

若已有 QR Code，可使用 Scan QR Code 讀取；若已有分享連結，請依 App 出現的剪貼簿匯入提示確認內容，並核對解析後的類型與位址。Import from Cloud JSON 適用於相應格式的設定內容，不是通用的訂閱連結入口。匯入後，為伺服器加上自己能辨識的備註，再返回 Home。此時先選取一個明確要測試的項目，不要同時整理大量群組。

檢查重點：SERVER 中已有項目，且已選取一台伺服器。訂閱更新、批次整理與備份請繼續閱讀伺服器管理手冊；目前先進入下一步選擇流量模式。

新增伺服器後，還需要指定哪些流量要使用它。返回 Home，點選 Global Routing 查看目前模式。初次設定時先區分三種模式：設定(Config)、代理(Proxy)、直連(Direct)。如果介面仍顯示 Scene，可等基礎連線驗證完成後再設定；首次操作時不要同時修改模式、場景和自動連線條件，否則發生問題時難以判斷原因。

Config：依設定規則決定路徑

設定(Config)會依目前設定中的規則處理請求，並不表示所有請求都會經過選取的伺服器。進入底部的 Config 頁面，確認已選取要使用的設定；開啟設定後可查看 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。旁邊的官方截圖是設定編輯頁，用於辨識這些區段，不是 Global Routing 的模式選擇畫面。

初次使用時，先查看 Rule 中的規則與最終處理方式，暫時不要大量修改。規則由上而下比對，最先符合的規則會決定該請求的路徑；PROXY、DIRECT、REJECT 分別代表不同處理結果。Add Rule 用於新增規則，但「新增一條」不代表一定會生效，還要確認它是否已被前面的規則比對。本文不要求啟用 HTTPS Decryption，也不需要為了基礎連線另外設定解密功能。

Proxy 與 Direct：區分測試目的

代理(Proxy)會將用戶端接管的流量交由所選代理路徑處理，適合在排除問題時暫時縮小規則因素的影響，但無法修復伺服器位址、驗證或傳輸參數。直連(Direct)使用直接連線，適合確認本機網路和目標本身是否可連線；在 Direct 下能開啟網頁，並不能證明代理伺服器可用。變更模式後，請重新發出請求，不要只觀察已開啟的頁面。

若已有明確且了解用途的設定，可選擇 Config 繼續。若想先檢查伺服器的基本連線狀況，可暫時使用 Proxy 完成後續連線與瀏覽測試，驗證後再切回 Config。記下切換前的模式，避免排除問題後忘記還原。規則關鍵字、DNS 與策略之間的詳細關係可參閱術語表，初次連線時不必一次掌握所有設定。

檢查重點：確認目前使用的是 Config、Proxy 還是 Direct；使用 Config 時，確認已選取哪一份設定。接著再開啟連線開關。

返回 Home，再確認一次已選取的伺服器和 Global Routing。頂端顯示 Not Connected 時，表示目前尚未建立用戶端連線。點選頂端開關開始連線，首次操作通常會出現系統新增 VPN 設定的提示。此提示由系統顯示，用於允許 Shadowrocket 建立處理網路流量所需的 VPN 設定，不是新增訂閱，也不會取代前面填寫的伺服器資料。

確認提示中的 App 後選擇允許，並依系統要求完成裝置密碼或生物辨識驗證。接著返回 Shadowrocket，觀察頂端狀態是否變更。如果先前拒絕授權，請返回 App 重新嘗試連線；若仍無法建立連線，可到系統設定的 VPN 管理位置檢查是否有 Shadowrocket 的設定。不同系統版本的設定層級和提示文字可能略有差異，請以裝置實際顯示為準。

完成授權只代表允許用戶端接管相應流量，並不表示遠端伺服器已能正常轉送。即使頂端開關維持開啟，伺服器驗證失敗、DNS 異常或規則封鎖仍可能導致網頁無法連線。因此，開啟開關後不要直接結束操作，下一步還需要實際驗證。狀態列是否持續顯示 VPN 標示也會受裝置介面影響，不能只憑單一圖示判斷。

如果開關立即關閉，或長時間停留在連線狀態，請先記下完整提示。檢查系統中是否有其他 VPN 正在連線，避免兩個連線反覆爭用狀態；不要直接刪除所有網路設定。若需要重建 Shadowrocket 的系統 VPN 設定，先停止連線，確認 App 中的伺服器資料仍在，再只處理對應設定，完成後返回 App 重新授權。

首次連線建議先維持目前的 Wi-Fi 或行動網路，不要立即啟用 On Demand。這樣能區分手動連線本身失敗，還是網路切換後的自動連線條件影響結果。若系統授權已完成，開關也能維持開啟，請繼續執行 Connectivity Test 並實際瀏覽，不必重複安裝 App。

檢查重點：完成系統授權，且 Home 的連線狀態已變更。接下來確認「能連線」是否也代表「目標可連線」。

遇到問題時，先保留目前的伺服器和設定，不要一次修改多個開關。建議從本機網路開始，再檢查伺服器、模式、規則與 DNS，最後確認系統連線狀態。每變更一個項目，就對同一個目標重新發出請求。如此每次變更都能對照一項結果，判斷問題是否確實解決，也能在無效時還原原設定。

匯入後沒有項目，或伺服器一直連線失敗

訂閱內容空白時，先確認裝置本身可以連上網路，再檢查連結是否完整、是否仍有效，以及回傳內容是否為用戶端可識別的格式。不要在公開截圖中顯示連結參數。手動新增的項目則重新核對 Type、Host、Port、Password、Method，以及資料指定的 TLS 和傳輸欄位。逾時、驗證失敗和內容解析失敗屬於不同問題，應先記下原始錯誤，再決定下一步。

測試與網頁連線結果不一致

開啟 Settings，查看 Test Method。測試方式不同，實際檢查的網路層級也不同；一項測試失敗，不代表所有實際請求都會失敗；反過來說，有測試回應也不保證目標可連線。必要時使用 Diagnostics 查看相關診斷資訊，並配合失敗時的網路和目標判斷。調整測試參數後，應使用同一台伺服器與前一次比較，避免同時更換伺服器造成混淆。

Proxy 可用，Config 無法使用

先確認 Config 中選取的確實是預期設定，再檢查目標是否符合 DIRECT 或 REJECT，或是否有較前面的規則優先比對。如果網域連線失敗但其他請求正常，也應檢查目前 DNS 設定和設定中的 Hosts 是否影響解析。不要把任意更換 DNS 當成通用修復方式；先保留原值，確認變更目的，再針對同一網域驗證結果。

切換網路後中斷，或開關反覆變化

返回 Settings 查看 On Demand 是否已設定。首次排除問題時，可暫時停用自動連線條件，先在固定網路中手動連線驗證；穩定後再分別設定 Wi-Fi 與行動網路的行為。如果系統中有其他 VPN 正在使用，請先停止不需要的連線。若仍無法連線，請記錄系統提示與 Diagnostics 中的相關錯誤，不要反覆刪除所有設定，以免擴大問題範圍。

整理問題資訊時，只保留裝置系統、網路類型、模式、操作順序，以及移除敏感資訊後的錯誤文字。訂閱完整連結、Password、QR Code 和含驗證資訊的分享連結都應遮蔽。更詳細的更新、刪除和備份步驟請參閱伺服器管理手冊；常見授權與網路問題可到FAQ依現象查找。

排除問題後：還原暫時切換的模式，確認已選取伺服器與設定，再對同一目標重新測試。保留已驗證可用的設定，之後每次只新增一項功能。