Shadowrocket 使用教學

Step 01 / Add Server

新增伺服器或匯入 Subscribe

開啟 Shadowrocket 後進入 Home，在 SERVER 分組附近找到 Add Server。先確認手上的資料類型：若是用來取得伺服器清單的訂閱連結，請選 Subscribe；若是伺服器位址、連接埠、協定與驗證資料，請手動新增。這兩種方式都是將現有資料儲存至 App，不會因儲存而自動建立新服務。

已有訂閱連結：選擇 Subscribe

進入 Add Server，點選 Type 並選擇 Subscribe，將完整的現有訂閱連結填入 URL，再儲存。貼上後請檢查開頭、結尾與查詢參數，特別留意複製時是否帶入空格、換行或漏字元。訂閱網址通常包含存取憑證，請勿當作一般網頁網址公開分享，也不要將完整網址貼到公開討論區。

返回 Home 後，等候訂閱內容載入；若已顯示訂閱分組，但尚未出現伺服器項目，請使用該分組提供的更新功能，並留意是否出現失敗提示。URL 能儲存，只表示輸入內容已被接受，不代表遠端內容已成功取得。若發生錯誤，先檢查原始連結是否完整、目前網路能否取得內容，以及現有服務是否仍有效；請勿反覆新增相同訂閱。

已有單一伺服器資料：逐項填寫

在 Add Server 中依資料選擇正確的 Type，再填寫 Host 與 Port。畫面會依協定顯示不同欄位，截圖中的 Password、Method 只是其中一種表單範例，並非所有協定都使用相同欄位。請將服務資料中的驗證方式、加密方式及其他必要參數逐項填入；不要只憑名稱相似就選擇協定，也不要把連接埠填入 Host。

若已有可匯入的 QR Code，可使用 Scan QR Code；只有資料格式確實相符時，才使用 Import from Cloud JSON。匯入後仍須檢查 Type、位址與連接埠；QR Code 能成功讀取，不代表每個欄位都正確。儲存後返回 Home，點選準備測試的伺服器，並確認選取標記。接著先選擇 Global Routing，再開啟連線，以免誤將模式問題當成匯入失敗。

Step 03 / Home

開啟連線並確認系統授權

在 Home 再次確認伺服器選取標記，以及目前顯示的 Global Routing。截圖頂端的 Not Connected 表示尚未連線；點選頂端開關即可開始連線。初次使用時，系統可能會要求允許新增 VPN 設定。此 VPN 設定是讓裝置將相關請求交由 Shadowrocket 處理，並非購買或續訂程序。

確認提示來自目前的操作後，依系統要求完成確認；系統可能會要求輸入裝置密碼或進行身分驗證。完成後返回 Shadowrocket，查看開關與狀態文字是否變更。若先前取消授權，請回到 App 重新發起連線，並依系統提示檢查權限；不要為了處理同一授權問題而反覆刪除 App。

分別判斷開關狀態與服務可用性

連線開關能維持開啟，表示裝置已啟動相應的連線程序，但不能單憑此點確認伺服器可連線、驗證資料有效、DNS 正常或規則命中正確。即使系統顯示 VPN 狀態，仍須進行下一步的實際連線測試。若狀態立即恢復為未連線，請先記下畫面提示，確認系統授權與目前設定是否能載入，再進行後續排查。

第一次測試時，盡量維持網路環境不變，也不要同時切換 Wi-Fi、修改規則或更換伺服器。如此一來若結果有變化，就能將原因縮小到剛才的操作。iPad 與 iPhone 的版面可能不同，但仍可沿著 Home、Global Routing、連線開關的順序檢查。連線建立後，先不要調整 On Demand；手動連線驗證成功後，再決定是否需要自動觸發。

Step 05 / Settings

依序找出常見問題

排查時請遵循「先基本、後規則；一次只改一項」的原則。每次變更後，重新進行相同測試，確認結果後再繼續。若同時更換訂閱、切換伺服器、修改 DNS 與規則，即使恢復連線，也難以判斷真正原因，日後更難維護。

資料未顯示：檢查匯入結果

若 Home 沒有預期的伺服器，請先檢查已儲存的訂閱 URL 與更新提示。確認服務資料仍有效，且目前網路能取得內容。手動新增的項目則返回 Add Server，檢查 Type、Host、Port 與驗證欄位。特別留意 Password 前後是否有空格，也不要把顯示名稱誤當成伺服器位址。訂閱問題詳情請參閱常見問題。

開關已開啟但無法連線：先區分網路與模式

先暫時中斷連線，使用同一個網路造訪已知可正常開啟的頁面，確認基本網路正常；若有需要透過網頁完成的網路登入程序，請先完成。接著重新連線，確認目前選擇的伺服器與 Global Routing。若誤選直連 (Direct)，就不能用這個結果證明代理可用；若選擇設定 (Config)，請檢查是否啟用了其他設定檔，以及目標是否命中 DIRECT 或 REJECT。

在條件允許且了解影響的情況下，可暫時切換至代理 (Proxy)，以相同目標進行對照，再恢復原模式。若 Proxy 可以連線但 Config 不行，應優先檢查設定與命中策略；若兩者都失敗，仍須檢查伺服器、驗證資料或目標服務，不能僅憑對照結果就認定 DNS 有問題。

只有部分目標失敗：再檢查 DNS 與測試方法

若只有部分網域連線失敗，請先確認目標服務本身是否正常、規則範圍是否過廣，再檢查設定中的 DNS 相關參數。不要直接以網路上看到的位址覆蓋原設定；請先保留原值，單獨修改後再測試。Settings 中的 Test Method 會決定測試方式，不會改變所有網站的實際請求方式，因此不能只靠切換測試方法來修復瀏覽器連線問題。

連線自動恢復：檢查 On Demand

若手動中斷後又自動連線，請檢查 Settings 中的 On Demand 及目前設定的觸發條件。排查期間可先暫停相關自動觸發，再進行手動測試。Today Widget 是快速入口，不能取代在 Home 確認最終狀態；Proxy、TCP 與 UDP 區域包含更細部的行為設定，初次連線若無明確需求，請保留原設定。

仍無法找出問題：保留必要診斷資料

使用 Diagnostics 或相關記錄功能時，請盡量在問題發生後立即查看，並記下時間、目標、模式與錯誤提示。儲存或提供記錄前，請遮蔽訂閱 URL、伺服器驗證資料及可識別個人的內容。只提供判斷問題所需的片段，不要公開完整設定。記錄與設定項目的系統說明請見設定手冊；若已確認是哪一類問題，再到 FAQ 查閱相應的處理方法。