Shadowrocket 快速上手

01 · Add Server / Subscribe 匯入資料

開啟 Shadowrocket 後，先進入 Home。這裡用來檢視及選擇伺服器；Config 則用來管理配置檔，兩者用途不同。匯入訂閱後，應先在 Home 看到伺服器項目，而不是只在 Config 看到檔案名稱。依照手邊資料選擇以下其中一種方式即可，初次操作不必重複匯入同一份資料。

已有訂閱連結：選擇 Subscribe

在 Home 點選右上角的新增入口，進入 Add Server。開啟 Type，選擇 Subscribe，再將完整的訂閱連結填入 URL 欄位。名稱或備註可用來區分來源，填寫容易辨認的文字即可；請勿將備註當作認證欄位。儲存後等待讀取完成，返回 Home，確認訂閱分類及其伺服器已出現。

貼上前先確認取得的是訂閱網址，而非帳戶頁面、說明頁面或單一伺服器分享連結。複製時可能漏掉網址尾端的參數，也可能帶入換行、空格或聊天訊息中的標點。請保留原網址的大小寫與參數，不要自行刪除查詢字串。訂閱下載成功只表示客戶端讀取到內容，不代表其中每台伺服器都能成功連線。

訂閱是一份可更新的伺服器清單。日後需要更新時，在 Home 找到相應的訂閱項目，透過編輯或操作入口執行更新；請更新原有項目，不要每次都重新新增同名訂閱。更新後再確認目前選取的伺服器仍在清單中。若讀取失敗，先保留現有項目，再檢查連結與網路，不要立刻清除所有資料。

已有單一伺服器資料：確認 Type 與欄位

同樣從 Home 進入 Add Server，先在 Type 選擇與伺服器資料相符的協定，再逐項輸入位址、連接埠及該協定要求的認證資訊。不同協定所顯示的欄位各有不同，密碼、UUID、TLS、傳輸方式等不能互相代用。位址欄請填伺服器位址，不要將連接埠、路徑和整段分享文字一起填入。

如果已有適用於 Shadowrocket 的完整分享連結，可使用 App 提供的匯入入口；如果已有 QR Code，可使用 Scan QR Code，並在系統詢問時依需求允許相機存取。匯入後仍應檢查項目的 Type、位址、連接埠及認證欄位。自動讀取只能減少手動輸入，無法判斷伺服器資料是否過期，也不能保證傳輸參數與伺服器端設定一致。

儲存後返回 Home，確認已出現可選擇的伺服器名稱。名稱僅供辨識，真正決定連線方式的是項目內的參數。到這裡完成的只是「將資料加入客戶端」，尚未決定請求如何路由。下一步先選擇 Global Routing，再開啟連線開關。訂閱、分享連結與配置檔的差異，請參閱術語表。

02 · Global Routing 選擇模式

在 Home 找到 Global Routing，開啟後選擇這次需要的模式。三種選項為配置 (Config)／代理 (Proxy)／直連 (Direct)。它們會改變請求的路由方式，不是三種不同的伺服器。切換模式不會自動修正伺服器位址或認證欄位，也無法讓失效的訂閱恢復。

配置 (Config)：依目前配置套用策略

配置 (Config) 會依目前配置處理請求。進入 Config 頁面，確認所需配置已選取，而不只是出現在檔案清單中。返回 Home，再確認 Global Routing 設為 Config。初次使用若尚未準備好規則，先不要匯入多份來源不明的配置來回切換；應先確認目前配置的用途，再決定是否使用。

規則中常見的 PROXY、DIRECT、REJECT，分別表示使用代理策略、直接連線及拒絕請求。請求是否經過伺服器，取決於比對到的規則與策略設定，因此 Config 模式下部分請求直連是正常的。不能因為某個網頁能開啟，就認定所有請求都使用代理；也不能只憑一次直連結果，就判定配置失效。

代理 (Proxy)：先測試所選伺服器

初次測試時可使用代理 (Proxy)：先在 Home 選好自己的伺服器，再將 Global Routing 設為 Proxy，減少規則分流對判斷的干擾。這是排查方式，不代表所有情況都應長期使用此模式。App 與系統保留的必要例外仍可能影響部分請求，不應將 Proxy 理解為裝置上的所有通訊都會採用完全相同的路徑。

若 Proxy 模式下可以正常瀏覽，但 Config 模式下失敗，下一步應檢查目前配置、規則比對與 DNS，而不是立刻重新輸入伺服器密碼。測試完成後切回日常所需模式，並記下使用的配置。如此便能分開判斷「伺服器是否可用」與「規則是否符合預期」。

直連 (Direct)：作為原始網路的對照

直連 (Direct) 會以直接連線方式處理請求，適合用來確認目前網路本身能否存取目標。選擇 Direct 後，伺服器仍可能保留在 Home 清單中，但有伺服器項目不代表請求正在使用它。比較時請使用相同網路、相同目標及相近時間；若切換網路，結果也可能受到網路變化影響。

選好模式後，無須繼續調整進階欄位。先返回 Home 確認模式文字，再進行下一步。配置檔中的 General、Rule、Host、URL Rewrite，以及規則順序的詳細說明，請參閱配置欄位參考；本頁僅說明首次連線所需的判斷方式。

03 · Home 開啟連線

返回 Home，點選這次要使用的伺服器項目，確認已選取，再開啟連線開關。若訂閱中有多台伺服器，初次先測試一台，避免同一輪測試中反覆切換。需要修改項目時，先中斷連線，再編輯並儲存，之後重新選取該項目建立連線。

首次開啟連線時出現 VPN 設定提示

首次開啟連線開關時，系統可能會詢問是否允許 Shadowrocket 新增 VPN 設定。請確認提示中的 App 名稱，允許後依系統要求完成裝置驗證，再返回 Shadowrocket 查看狀態。這項授權允許 App 建立用於網路處理的系統連線；它不是購買確認，也不會匯入訂閱或補齊伺服器資料。

若先前取消授權，連線可能無法完成。請重新開啟開關，依實際出現的系統提示操作；若提示不再出現，可前往系統設定中的 VPN 管理位置檢查 Shadowrocket 項目。系統設定路徑與介面配置可能隨系統版本改變，不必為了尋找特定選單名稱而任意刪除其他設定。

iPad 的操作順序相同：先選伺服器，再開啟連線，最後處理系統授權。橫向畫面或不同裝置版面可能讓入口位置有所不同，請依 Home、Global Routing、Config 等介面文字尋找，不要只憑按鈕在螢幕上的左右位置判斷功能。

分清開關狀態與實際可用性

開關維持開啟且系統顯示 VPN 圖示，只表示連線設定處於相應狀態，不能證明伺服器認證成功、DNS 正常或所有網頁都能瀏覽。有些問題只有在實際送出請求時才會出現，因此下一步必須測試實際連線。若開關剛開啟就自動關閉，先處理授權或連線建立問題，不要直接開始修改 Rule。

首次連線時先不要設定 On Demand。它用來依條件觸發連線，並非手動連線成功的必要條件。若先前已設定相關條件，請留意切換網路或手動中斷後，可能會再次觸發連線。排查時先檢查這些條件，再觀察手動開關的結果；待手動流程穩定後，再另行設定及測試自動觸發行為。

04 · Connectivity Test 確認是否生效

連線後先檢查所選伺服器，再測試實際網頁。進入 App 的 Connectivity Test，確認測試對象是這次選取的項目，並查看測試結果。清單中某個項目有測試結果，不代表目前連線一定選中了它；尤其更新訂閱或切換伺服器後，請返回 Home 再確認一次。

先查看測試結果，再送出實際請求

Connectivity Test 可協助判斷測試請求是否收到回應，但結果會受到測試方式、目標與目前網路影響。測試逾時值得進一步檢查，但測試成功也不能取代瀏覽器驗證。測得的時間不代表所有 App 的實際瀏覽速度，也不要只憑一次結果就刪除伺服器項目。

開啟 Safari，前往熟悉、可正常存取且適合用來確認的網頁，檢查頁面文字及必要資源是否完整載入。最好準備兩個不同網站，避免將單一網站維護或存取限制誤判為客戶端故障。保持目前網路不變並重新載入頁面，不要只查看已開啟的舊分頁；瀏覽器快取可能讓舊內容看起來像是新請求已成功。

網頁正常載入後，接著確認結果是否符合 Global Routing 的選擇。Proxy 模式用來檢查伺服器路徑，Direct 模式用來檢查原始網路，Config 模式則須配合規則判斷。Config 允許部分目標直接連線，因此「頁面能開啟」與「頁面經過代理」是兩個不同問題。需要確認分流時，請查看相應請求記錄中實際採用的策略，再與配置預期比較。

在相同條件下進行對照

結果不明確時，記下目前的伺服器、Global Routing、所選配置與測試目標。中斷連線後，檢查相同目標在原始網路上的情況，再重新連線比較。每輪只改變一個條件，才能判斷伺服器、模式或網路是否與問題有關。不要同時更換伺服器、切換網路又修改 DNS，最後只記下「好了」。

完成測試的標準不只是看到某個圖示，而是所選伺服器符合預期、模式符合用途、實際請求能完成，且 Config 模式下的策略符合規則設定。符合這些條件後，即可保留目前設定繼續使用。若要進一步設定分流，請參閱Rule 配置參考；若仍然失敗，請依下一節定位，不必從安裝步驟重新開始。

05 · 常見問題 逐項排查

先確認問題發生在哪個環節：訂閱尚未讀取、連線開關無法維持開啟，還是開關已開啟但網頁無法載入。這三種情況需要檢查的項目不同。保留能正常運作的項目與原有配置，修改前先記下原值；每修正一項，就重做上一節的測試，不要一次重設所有設定。

Subscribe 讀取失敗或清單空白

返回 Home，進入該訂閱的編輯入口，檢查 URL 是否完整，尤其是尾端參數、空格與換行。確認連結仍有效，且內容是可辨識的伺服器訂閱，而非帳戶登入頁面或網頁說明。能在瀏覽器開啟網址，不代表回傳內容符合訂閱格式；含有認證資訊的連結也不應放到公開工具中測試。

若原始網路可讀取訂閱，請優先在該網路環境下更新。若讀取需要特定連線條件，先使用自己已有且可用的伺服器，再依 App 目前的設定嘗試更新。不能把「尚未匯入的伺服器」當成取得同一份訂閱的前提。若對連結有效性、帳戶狀態或伺服器資料有疑問，請向你原有服務的提供者確認；本網站不提供替代訂閱。

開關立即關閉或無法建立連線

先確認系統 VPN 設定的授權，再確認 Home 中確實選取了可用項目。進入項目檢查 Type、位址、連接埠及認證欄位是否與原始資料相符。使用 TLS 或傳輸設定的協定，請核對伺服器名稱、路徑及其他指定參數；不要透過關閉憑證驗證來繞過未知錯誤，也不要將其他協定的參數套用到目前項目。

若系統中有另一個 VPN 連線正在使用，先停止該連線，再單獨測試 Shadowrocket，以免將連線接管或狀態切換誤判為伺服器故障。確認裝置日期與時間正確；時間明顯錯誤可能影響安全連線。修改後重新建立連線並觀察狀態是否維持；若仍無法維持，優先檢查連線層，而非分流規則。

開關已開啟，但所有目標都無法連線

先使用 Direct 模式或中斷連線，確認原始網路是否正常。若原始網路本身無法連線，先處理 Wi-Fi、行動網路或目前網路的登入要求。原始網路正常時，選一台自己的伺服器，以 Proxy 模式進行對照並執行 Connectivity Test。若兩項測試都失敗，請優先檢查伺服器是否可用、認證資訊與傳輸參數。

若測試有結果但瀏覽器仍無法連線，接著檢查 DNS 設定與實際目標。過時的自訂 DNS 設定可能影響網域解析；先記下原值，再與已知正常的設定比較。不要只因網頁無法開啟就認定是 DNS 問題，也不要任意新增多個自訂位址。完整的 DNS 處理方式涉及 General 與其他配置項，請參閱配置欄位參考。

Proxy 正常，Config 失敗或只有部分目標無法連線

進入 Config，確認目前選取的配置，再檢查相關 Rule。規則通常依序比對，範圍較大的規則若排在前面，可能先於後面的具體規則命中；FINAL 用於最後的兜底處理。也請確認命中的策略是 PROXY、DIRECT 還是 REJECT，而不只是檢查規則中是否出現目標網域。

只有部分網站無法連線時，也要考慮目標網站本身的狀態、網頁涉及的其他網域及目前網路環境。不要只為了一個頁面就將所有請求改用同一種策略。使用相同目標比較 Proxy 與 Config，並查看實際請求記錄，有助縮小問題範圍。DOMAIN-SUFFIX、IP-CIDR 與 FINAL 的含義請參閱術語表；完整寫法及排序方式請參閱Rule 配置參考。

整理問題重現資訊，再進一步排查

記下裝置類型、目前網路、Global Routing、問題發生的步驟，以及是「全部失敗」還是「部分失敗」。分享錯誤資訊時，請遮蔽訂閱 URL、密碼、UUID 及其他認證資料；保留協定類型、錯誤文字與已完成的檢查即可。配置中也可能包含私人位址，分享前請逐項確認，不要只遮住伺服器名稱。

最後還原排查期間暫時修改的模式與設定，重新選取日常使用的伺服器及 Config，再測試一次實際網頁。若問題仍未解決，請依已確認的失敗環節繼續排查。首次連線只需逐步確認資料、路由、授權與請求結果；規則調整、On Demand 及其他配置欄位，應等基本流程穩定後再逐項新增。