Shadowrocket 使用教學

開啟 Shadowrocket，進入 Home。首次使用時，SERVER 群組可能還沒有任何項目。點選右上角的新增按鈕，開啟 Add Server。接著擇一匯入方式：已有訂閱連結就依訂閱流程操作；已有單一伺服器的完整欄位資料，就手動填寫。訂閱網址與伺服器位址是不同資料，不要填入同一欄位。

已有訂閱連結：選擇 Subscribe

在 Add Server 中點選 Type，選擇 Subscribe，再將完整的個人訂閱網址填入 URL 欄位。為這筆訂閱設定容易辨認的名稱，並確認複製內容沒有多出空格、換行或引號，再儲存。訂閱網址通常包含存取憑證，請妥善保密，不要張貼在公開討論區，也不要用截圖展示完整連結。

儲存後返回 Home，等待讀取訂閱內容。讀取成功後，會顯示該訂閱中的伺服器項目。確認名稱符合預期，並選擇其中一筆做為後續測試對象。如果只看到訂閱群組，卻沒有伺服器，請先不要開啟連線；確認連結可正常讀取且服務有效後，再嘗試更新。訂閱用於管理伺服器清單，不代表已選好分流用的 Config。

已有伺服器欄位資料：依 Type 逐項填寫

手動新增時，先在 Type 選擇與資料相符的協定，再填寫 Host、Port 及該協定要求的認證欄位。截圖中顯示 Password、Method 等欄位，但各 Type 的表單不盡相同。例如，使用 UUID 的設定不能套用密碼欄位的填法；TLS、傳輸方式或伺服器名稱等資料也應逐項依照原始資料填寫，不要憑經驗自行補上。

Host 填入伺服器網域名稱或位址，不要附加網頁路徑；Port 依資料填寫。Password、UUID 等認證內容請留意大小寫與前後空格。除非原始資料明確要求，否則不要修改其他選項。若取得的是 QR code，可在 Add Server 使用 Scan QR Code 掃描，並在儲存前核對辨識出的欄位。Import from Cloud JSON 是另一種設定來源，不要將一般訂閱網址任意填入。

本步檢查重點：返回 Home 後能看到伺服器項目，而且選取的項目來自剛匯入的資料。如果不清楚 Type、Subscribe 與 Config 的差異，請先查看名詞解說。確認項目資料完整後，再進入下一步選擇 Global Routing，不要直接同時變更多項連線設定。

匯入伺服器後，返回 Home 並點選 Global Routing。這裡決定連線開啟後如何處理流量，與在 SERVER 中選擇哪部伺服器是兩回事。三種模式分別是設定檔 (Config)／代理 (Proxy)／直連 (Direct)。測試時記下目前的選擇，才能對照後續的連線結果。

設定檔 (Config)：依設定檔中的規則處理

日常使用若需要依網域或位址分流，請選擇設定檔 (Config)。進入 Config 頁面，確認已有要使用的設定檔且已選取。開啟設定檔後，可檢查 General、Rule、Hosts 等區段；Rule 中的規則會決定要求符合條件後採用的策略。將設定檔匯入清單，不代表它已成為目前使用的設定；請返回清單確認選取狀態。

如果尚未準備好 Config，不要以為匯入訂閱時會自動產生適用所有情境的規則。先確認既有設定的來源與用途；首次檢查伺服器可用性時，可暫時使用代理 (Proxy) 做為比較，確認後再切回設定檔 (Config)。不要為了完成教學而直接覆寫既有檔案，首次連線也不必開啟 HTTPS Decryption 或新增 URL Rewrite。

代理 (Proxy) 與直連 (Direct)：用來比較流量處理路徑

代理 (Proxy) 會讓由用戶端處理的流量經過代理路徑，適合用來檢查伺服器本身是否可用。這不代表能統一驗證每個 App 的所有要求，也不能取代伺服器端的能力檢查。直連 (Direct) 則直接連線；選擇此模式時，網頁能開啟不代表所選伺服器已生效。需要比較時，請在相同網路、相同測試頁面下只切換這個選項，並記錄結果差異。

理解規則時，先看比對條件，再看最後的策略。以下是規則語法範例，不是可直接覆寫目前 Config 的完整設定。PROXY的實際目標仍須符合設定中的策略定義與目前選取的伺服器。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY

規則通常依序檢查，前面的比對結果會影響後續規則是否參與判斷；FINAL用於未符合前面規則時的處理。因此，同一部伺服器在不同 Config 下，可能會有不同的網站連線結果。初次使用時，先保留少量且明確的驗證目標，不必急著擴大規則範圍。更多規則問題請參閱問題診斷。

本步檢查重點：確認目前使用的 Global Routing 模式；若選擇設定檔 (Config)，也要知道目前選取的設定檔。記下這兩項後，再進行連線授權。

返回 Home，在 SERVER 清單中點選要使用的伺服器。如果清單中有多筆紀錄，先選一筆資料完整且服務有效的項目，初次測試時不要頻繁切換。確認 Global Routing 仍是上一步選好的模式，再開啟 Home 頂端的連線開關。截圖中的 Not Connected 表示尚未建立連線，並非伺服器名稱。

首次建立連線時，iPhone 或 iPad 可能會顯示新增 VPN 設定的系統提示。這是 App 設定網路連線所需的系統授權步驟。閱讀提示內容，確認操作是由剛才開啟 Shadowrocket 開關所觸發，再依系統指示完成裝置驗證。若取消提示，返回 App 重新連線即可；不要因開關未能維持開啟，就立刻刪除伺服器或重置所有設定。

系統授權與伺服器認證是兩回事。前者允許裝置使用相應的 VPN 設定；後者仍取決於 Host、Port、認證資料與伺服器設定是否正確。完成授權後返回 Home，觀察頂端連線狀態是否改變，以及開關能否維持開啟。各裝置的 VPN 標示位置與呈現方式可能不同，不必只憑某個狀態列圖示判斷。

如果開關剛開啟就關閉，先確認系統授權已完成，並檢查是否有其他正在管理連線的 VPN 設定、裝置管理限制或 On Demand 設定影響操作。首次手動驗證時，先記下現有的 On Demand 設定，避免自動觸發行為干擾判斷。不了解用途時不要移除裝置上的其他設定，尤其是受管理裝置中的設定。

如果開關能維持開啟，先保留目前選取的伺服器與模式，不要立即調整 DNS、TCP 或 UDP 選項。連線狀態只表示本機連線流程已有進展，不代表網頁一定能正常瀏覽。接下來使用 Connectivity Test 並實際開啟網頁，分別檢查才能判斷問題出在哪個環節。

本步檢查重點：SERVER 中已明確選取項目、系統授權已完成，且連線開關維持開啟。若每次都停在授權或開關階段，請直接前往本頁的常見問題排查，先解決連線建立問題。

發生異常時，先停止連續變更設定。關閉 Shadowrocket 連線，確認裝置的基本網路本身能開啟平常可用的網頁；若公共 Wi-Fi 需要登入網路，請先完成登入。接著重新連線，依照下列對應現象繼續排查。每次只變更一個條件，並重複第四步的同一項驗證。

訂閱已儲存，但沒有伺服器項目

重新確認 URL 是否完整複製、訂閱是否仍有效，以及目前網路能否讀取訂閱內容。不要把一般網頁網址誤認為訂閱連結，也不要重複將同一連結新增成多個群組。若先前已有可用清單，更新失敗時請先保留紀錄，查明原因後再整理。若連結權限、有效期限或回傳內容異常，請依據既有服務提供者提供的資訊確認；用戶端無法自行補上缺少的伺服器資料。

伺服器測試逾時，或連線後無法瀏覽

先依原始資料檢查 Host、Port、Type 與認證欄位，再確認 TLS、傳輸方式等附加項目是否一致。逾時通常表示需要進一步檢查連線狀況，但不能只憑這項結果判定密碼錯誤。切換 Wi-Fi 與行動數據進行比較時，請維持其他條件不變；如果只有某種網路無法連線，記錄差異，不要立即覆寫 Config。系統化排查流程請參閱伺服器逾時排查。

如果 Connectivity Test 有結果，但網頁仍無法開啟，請確認 Global Routing 是否誤選直連 (Direct)，或設定檔 (Config) 是否將目標交給不符合預期的策略。確認規則後，再檢查 DNS。不要一開始就同時更換 DNS 設定與伺服器，否則即使恢復連線，也無法判斷是哪項變更發揮作用。

設定變更後，測試結果不一致

前往 Settings 檢查 Test Method；變更測試方法後，前後結果不能直接視為相同指標進行比較。Diagnostics 可用來進一步蒐集排錯線索，但初次使用不必任意修改 Proxy、TCP、UDP 等區段中的選項。如果剛調整某項設定就出現異常，優先還原該項，再重複原本的測試，不必清除整個 App。

On Demand 可能依條件觸發連線，因此手動關閉後又自動連線的情況，須配合相關設定判斷。先完成手動連線驗證，再設定自動觸發條件。iPad 也依照相同順序操作；視窗大小或直橫向切換可能影響功能入口位置，但不會改變訂閱、伺服器與 Config 各自的用途。

整理診斷資訊時，保留錯誤提示、操作步驟與發生條件，並移除訂閱 URL、Password、UUID、真實伺服器位址等敏感內容。截圖也要確認沒有包含這些資訊。App 更新後若出現問題，先記錄目前設定並核對 App Store 中的 App 資訊，再逐項重新測試，不要因單次失敗就認定設定已失效。

本步檢查重點：能夠說明問題發生在匯入、授權、伺服器連線能力、規則或實際瀏覽哪個階段。基本問題請參閱常見問答；若需逐章檢查 DNS、耗電或更新後的異常，請前往問題診斷，初次使用時不要一次調整所有進階選項。