Shadowrocket 使用教學

先確認手上的資料類型，再選擇新增方式。用來更新伺服器清單的完整連結，通常應透過 Subscribe 匯入；若資料列出明確的協定、位址、連接埠與驗證參數，則應手動新增單一伺服器。訂閱連結和 Config 檔案連結用途不同，不能只憑連結外觀互換入口。若無法判斷類型，請先查看這份資料附帶的說明。

透過 Add Server 手動新增

開啟 Shadowrocket 的 Home，在 SERVER 區域找到並點選 Add Server。進入後先選擇 Type，再填寫 Host、Port 和相應的驗證欄位。Type 會決定後續顯示哪些欄位；例如圖中的 Password 和 Method 對應目前選取的類型，並非每種協定都使用相同欄位。請依照自己的參數逐項填寫，不要為了填滿畫面而補上不需要的資料。

Host 填入伺服器網域名稱或位址，Port 填入伺服器提供的連接埠。請勿將網址路徑、完整訂閱連結或多餘空格填入 Host。密碼、加密方法及其他協定參數都必須與既有資料一致，不要自行猜測補齊。若原始資料缺少必填項目，請先向資料提供者確認，再返回填寫。

完成後使用頁面上的儲存功能，返回 Home。確認 SERVER 下方出現新項目，且名稱與自己的紀錄相符，再點選該項目。若已有符合格式的 QR Code，可在 Add Server 使用 Scan QR Code 匯入，並於儲存前確認解析結果；Import from Cloud JSON 僅適用於相應格式的資料，並非通用連結入口。

透過 Subscribe 匯入完整連結

持有訂閱連結時，從 Home 進入 Add Server，將 Type 設為 Subscribe，依頁面欄位填入完整訂閱網址，並設定方便辨識的備註。複製時請保留所有查詢參數，尤其不要漏掉問號後的內容。連結可能含有存取憑證，貼上後只在裝置上確認，勿將完整網址放入公開截圖或聊天紀錄。

儲存後返回 Home，等待訂閱讀取完成；必要時使用該訂閱的更新功能。確認清單中已產生伺服器項目，而不只是留下訂閱名稱。若沒有新增項目，先確認連結回傳的是用戶端可解析的訂閱內容，而非登入頁面、提示頁面或一般網頁。訂閱成功儲存只代表輸入資料已記錄，不代表讀取與解析也已成功。

完成這一步後，至少應有一個可明確選取的伺服器項目。保留原始資料以便核對，但不要反覆新增相同訂閱來取代故障排查。接著先選擇 Global Routing；只有確認請求會如何處理，後續的連線測試才有判斷依據。

返回 Home，點選 Global Routing，查看目前選取的模式。三種模式為Config、Proxy、Direct。它們決定請求的處理方式，並非伺服器協定的其他名稱。切換模式不會替你補齊伺服器參數，也不會自動修復已失效的訂閱。

使用 Config 前先檢查目前檔案

若要依規則分流，請進入 Config，確認目前使用的 Config 檔案及其內容。官方截圖展示 Config 檔案編輯頁中的 General、Rule、Hosts、URL Rewrite 與 HTTPS Decryption 區段，Rule 下方可見 Add Rule。首次連線不需要修改所有區段；先保留已確認的內容，避免將連線參數問題與複雜設定混為一談。

訂閱主要用來取得或更新伺服器清單；Config 則用來管理規則及相關設定，兩者不能視為相同內容。成功匯入訂閱後，仍須確認目前的 Config 是否符合預期。來源與用途不明的 Config，不要只因項目多就直接啟用；沒有明確需求時，也不要調整 HTTPS Decryption。

以下範例僅說明如何閱讀規則，不代表需要直接取代目前的 Config。第一行讓 example.com 及其子網域使用 PROXY，第二行讓列出的本地網段使用 DIRECT，最後一行則處理前面未符合規則的請求。規則順序與最終處理方式會影響實際結果。

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

初次驗證時，先記下本次選擇的模式。若要依既有規則使用，請選擇 Config 並確認檔案；若要單獨檢查伺服器連線，可暫時使用 Proxy 進行比對。測試完成後，請恢復日常使用的模式，避免一直保留臨時檢查設定。規則匹配的詳細說明請參閱系統教學。

完成新增與模式選擇後，返回 Home。在 SERVER 下方點選本次要使用的伺服器，確認選取標記位於正確項目上。訂閱群組與群組內的伺服器是不同項目；看到群組標題不代表已選取實際連線目標。若清單中有多個名稱相近的項目，請先透過備註加以區分。

點選 Home 頂端的連線開關。首次建立連線時，系統可能會提示新增 VPN 設定；這是為了讓用戶端透過系統網路延伸功能處理相關流量。確認提示是由本次操作觸發，再依系統指示完成授權或裝置身分驗證。系統授權只代表允許建立設定，不能證明伺服器驗證、DNS 或規則已正確設定。

完成授權後返回 Shadowrocket，確認頂端是否仍顯示 Not Connected，以及開關是否維持開啟。若仍未連線，先確認授權流程已完成、伺服器已選取，再重新連線一次。尚未確認狀態前，請勿連續點按開關，以免無法判斷操作是在啟動還是停止連線。

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

開關維持開啟，表示用戶端的連線流程已開始運作，但目標網頁仍可能因伺服器、網域解析或規則處理而無法載入。系統中的 VPN 狀態也無法單獨證明特定請求經過所選伺服器。下一步應實際送出請求，並對照模式、測試結果與連線紀錄。

若連線剛開啟就關閉，或很快返回 Not Connected，請記下目前選取的項目、模式與錯誤訊息，再前往排查問題。iPad 的版面配置可能不同，顯示位置也會改變；請以 Home、SERVER 和 Global Routing 為線索確認，不要只依截圖中的絕對位置尋找按鈕。

完成這一步後，請暫時維持網路環境不變，不要同時切換 Wi‑Fi、修改 DNS 並更換伺服器。固定條件能讓下一步的驗證結果更容易判讀；若一次變更多個項目，即使網頁恢復，也難以確認是哪項調整發揮作用。

遇到問題時，先保留目前設定並記錄狀況，再從最接近輸入資料的環節開始檢查。每輪只調整一項，修改後重做相同的測試與網頁請求；若沒有改善，先還原原值，再檢查下一項。這樣可避免排查過程本身引發新問題。

訂閱無法讀取：先確認連結與回傳內容

返回既有訂閱的編輯資料，檢查連結是否完整、前後是否有空格，或是否誤複製說明文字。確認基本網路可連線至訂閱網址，並留意錯誤是請求逾時、驗證失敗還是內容解析失敗。這三種狀況分別指向網路路徑、存取憑證與內容格式，不能一概以「再更新一次」處理。

若回傳內容不是伺服器清單，請向原資料提供者確認連結用途與有效狀態。不要反覆新增重複項目來重試，也不要將完整訂閱網址貼到公開求助頁面。修正後只更新對應的訂閱，再返回 Home 確認是否產生實際伺服器項目。

連線失敗：確認伺服器與模式

手動新增的項目先檢查 Type、Host、Port，再確認驗證資料和協定附加參數。由既有訂閱產生的項目，先確認是否需要更新；不清楚作用時，不要批次修改。接著檢查 Home 目前選取的伺服器，以及 Global Routing 是否仍為本次測試預計使用的模式。

若連線狀態穩定，但特定網頁無法開啟，請利用上一節 Proxy 與 Config 的比對結果縮小範圍。只有特定網域出錯時，優先檢查該網域的解析與匹配規則；大多數請求都失敗時，再檢查伺服器連線或目前網路。修改前先記下原值，以保留可供比較的基準。

分別檢查 DNS、Test Method 與 On Demand

若懷疑 DNS 有問題，先確認失敗是否集中在網域存取，再檢查目前 Config 的 DNS 設定及可用診斷結果。不要隨意填入 DNS 位址並將其當成通用解法。網域解析、伺服器連線與規則處理彼此相關，但屬於不同環節，請依錯誤訊息逐項定位；詳細設定說明請參閱Shadowrocket 系統教學。

進入 Settings 查看 Test Method，確認 Connectivity Test 使用的方法，再據此判讀測試結果。Settings 中也能查看 On Demand，可依條件建立連線；若手動關閉後又自動連線，或切換網路後狀態改變，請檢查既有條件。初次手動驗證時，先確認 On Demand 目前的狀態，不要同時新增多組條件。

TCP 與 UDP 的表現也可能不同。網頁能開啟，不代表依賴 UDP 的 App 請求一定正常。此時請確認伺服器與協定參數是否符合實際需求，再搭配相關紀錄判斷；不要因網頁可用，就排除其他傳輸路徑的問題。

保留必要的診斷資料

若需要進一步定位問題，可在 Settings 使用 Diagnostics，記下錯誤訊息、發生時的網路類型、所選模式與重現步驟。比較 Wi‑Fi 與行動網路時，只變更網路這一項，再重做相同的目標請求。若結果不同，將差異視為網路條件的線索，不要立即重置所有設定。

分享診斷資料前，請移除密碼、訂閱網址中的存取參數，以及不必要的個人請求紀錄。描述問題時，說明「在哪個步驟、使用哪種模式、出現什麼錯誤、已進行哪些比對」即可，不必公開完整連線資料。問題解決後，請恢復日常設定、刪除重複測試項目，並再次確認一般請求可正常使用。