Shadowrocket
使用教學

開啟 Shadowrocket，進入 Home，找到 Add Server。操作前先確認手邊的是訂閱網址、單一伺服器分享資料，還是完整設定檔：訂閱可用來管理一組伺服器項目；單一伺服器參數用來建立一個連線；設定檔則可能包含規則及其他設定。三者用途不同，請勿將整份設定內容填入 Host，也不要把網頁說明網址誤填為訂閱網址。

已有訂閱：選擇 Subscribe

在 Add Server 中點選 Type，選擇 Subscribe，再將完整的個人訂閱連結貼到對應的網址欄位，確認後儲存。網址中的路徑、參數和大小寫都應依照原始資料保留；特別留意複製時是否混入空格、換行或中文標點。訂閱網址可能包含存取憑證，請勿將它貼到公開留言、截圖或公開記錄中。

儲存後返回 Home，等待取得訂閱內容。查看相應群組中是否出現伺服器項目；如果只看到訂閱群組，卻沒有可選取的項目，請先檢查訂閱更新結果。僅顯示「儲存成功」不代表已取得伺服器。之後更新訂閱前，請留意自行修改過的本機項目；重新取得遠端內容後，項目和參數可能會隨之變動。

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

如果手邊是單一伺服器參數，請在 Add Server 的 Type 中選擇與原始資料相符的協定，再填入 Host、Port 和必要的認證欄位。官方截圖展示的是包含 Password、Method 的其中一種表單；不同 Type 所需欄位不同，並非每種協定都要填入相同內容。Host 通常是伺服器網域或位址，不應自行加上網頁路徑；Port 請依原始數字填寫，並逐項核對 Password、Method 等資料。

如果所選 Type 還需要 TLS、傳輸方式或其他參數，也應依照既有資料填寫，不要只憑名稱猜測。遇到 WireGuard 等欄位結構不同的協定時，請勿直接套用截圖中的 Password、Method。若手邊資料是 QR Code，可使用 Scan QR Code；Import from Cloud JSON 僅適用於格式相符的既有內容，並非可貼上任意連結的通用入口。

儲存後返回 Home，在 SERVER 或相應訂閱群組中找到新項目，點選準備使用的伺服器。此時先不要連續匯入大量重複項目，也不要同時修改所有參數。保留一筆來源清楚、欄位可核對的設定，方便接下來驗證連線。如果匯入結果不符合預期，請先確認資料類型或欄位是否正確，再進入路由模式設定。

新增伺服器後，返回 Home 並點選 Global Routing。常用的三種模式是設定檔 (Config)、代理 (Proxy)、直連 (Direct)。先確認這次測試的目的，再選擇模式；不要把「已選取伺服器」和「所有請求都經過該伺服器」當成同一件事。模式會改變請求的處理方式，也是後續排查時需要記錄的關鍵設定。

Config：依照目前設定檔中的規則處理

日常需要依規則分流時，選擇設定檔 (Config)，再進入 Config 頁面確認目前使用的設定檔。設定檔清單與檔案編輯頁面屬於不同層級：先確認目前使用的檔案，再開啟查看內容；編輯其他檔案不一定會影響目前的連線。官方截圖展示的是設定檔編輯頁面，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段，以及 Add Rule。

入門階段先留意 Rule 中的規則內容。規則通常由上而下比對，命中後便採用該條策略；FINAL 用於前面的規則都未命中時。PROXY、DIRECT、REJECT 分別代表透過代理處理、直接連線和拒絕請求。設定檔可能包含更多選項，但「看到許多設定」不代表每項都需要修改；尤其首次測試連線時，不要開啟與測試目標無關的處理功能。

# 獨立教學範例，理解後再合併至自己的設定檔
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
FINAL,DIRECT

上述範例會讓 example.com 及其子網域使用 PROXY，讓列出的本機網段使用 DIRECT，其餘請求則交由 FINAL,DIRECT 處理。此範例僅用來說明比對順序，不建議直接取代整份現有設定檔。範例網域不是連線伺服器，PROXY 也不會自動建立伺服器項目。修改前請先備份現有檔案，以免覆蓋原有規則。

Proxy 與 Direct：了解差異並進行對照測試

代理 (Proxy) 會以代理方式處理路由，適合暫時排除一般分流規則對測試結果的影響；但不能因此認定所有系統流量必定都經過代理。直連 (Direct) 會以直接連線方式處理請求，不能用來證明所選的代理伺服器正常。如果 Proxy 可以存取、Config 卻不行，請優先檢查目前設定檔與命中規則；若兩者都失敗，再檢查伺服器參數和網路狀況。

選好模式後，記下目前使用的設定檔、伺服器和 Global Routing 模式。後續測試每次只改變一個條件，才容易判斷原因。如需深入了解規則類型、優先順序和設定檔區段，請參閱規則與設定檔參考；本頁先以最少的調整繼續完成連線。

完成前兩步後返回 Home，再次確認目前選取的伺服器項目和 Global Routing。訂閱中有多個項目時，匯入完成不代表已選取預期的伺服器；點選後確認選取狀態，再操作頂端的連線開關。不要同時更換伺服器、編輯規則並反覆開關連線，否則很難判斷是哪個步驟造成變化。

首次連線時的系統提示

頂端顯示 Not Connected 時，開啟連線開關。首次使用時，系統可能會提示新增 VPN 設定；請確認這是剛才在 Shadowrocket 中主動執行的操作，閱讀提示後允許，並依系統要求完成裝置驗證。這項授權用於建立 App 所需的網路隧道，不代表訂閱已成功取得，也不代表伺服器已通過驗證。如果先前曾取消授權，再次開啟連線時請留意系統是否重新提示。

如果開關立即回到關閉狀態，先查看是否有尚未處理的系統彈出視窗，再確認目前項目是否有效。也可前往裝置系統設定中的 VPN 相關位置，檢查設定是否存在或是否受到裝置管理限制；請勿任意刪除不熟悉的其他設定。受管理的裝置應依照裝置管理規定處理，單靠反覆開關無法解決權限問題。

分別確認連線狀態與可用性

完成授權後，等待狀態變更，避免在建立連線的過程中連續點按。系統顯示 VPN 狀態、App 顯示連線已開啟，只能說明隧道處於相應狀態，並不能證明所有目標都可存取。代理認證錯誤、目標 DNS 解析失敗或規則選擇不符預期，都可能在開關保持開啟時發生。因此，下一步仍須執行 Connectivity Test，並實際測試存取。

首次驗證時請保持目前網路穩定，暫時不要主動在 Wi-Fi 與行動網路之間來回切換。如果裝置上還有其他會建立 VPN 連線的功能，請先確認系統目前實際使用的是哪一項，避免把連線遭取代誤認為伺服器失效。測試結束後若要關閉連線，請返回 Home 關閉頂端開關，並確認狀態已回到未連線。

如果連線可以維持開啟，請進入下一步檢查實際請求；如果始終無法維持，請直接前往排查問題，從授權和基本設定開始。此時大幅修改 Rule 通常不是有效的第一步，因為連線尚未建立，還無法判斷規則分流是否符合預期。

排查前先確認問題發生在哪個環節：沒有匯入項目、開關無法維持開啟、測試與存取都失敗、只有部分目標失敗，或切換網路後中斷。將不同現象分開處理，比反覆刪除後重建更容易保留線索。以下依照由基本到具體的順序檢查；已確認正常的環節不必每次重新調整。

匯入失敗：先確認原始資料

Subscribe 儲存後沒有項目時，請檢查連結是否完整、對應網址是否仍有效，以及目前的基本網路能否存取訂閱內容。取得訂閱與連線至伺服器是兩個獨立流程，舊項目可以連線，不代表更新網址一定可連線。手動新增後無法使用時，請逐項對照原始資料中的 Type、Host、Port、認證欄位與傳輸參數；不要憑記憶重新填寫，也不要隨意切換 Method 嘗試修復。

連線失敗：先檢查授權、基本網路與參數

開關立即關閉時，先處理系統 VPN 授權或設定限制。開關維持開啟但所有測試都失敗時，先關閉連線，確認裝置本身的網路是否可用，再重新連線測試。情況允許時，可改用自己能使用的另一種網路進行對照；若只在某個網路環境失敗，請記下這項差異，不要因此修改所有原本正確的參數。伺服器認證與傳輸條件仍須依照自己的資料確認。

部分目標失敗：檢查模式與規則

只有個別目標異常時，先檢查 Global Routing，再比較 Config 與 Proxy 的結果。查看目前檔案中相關 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 及 FINAL 的順序與策略，特別留意前面的規則是否已先行命中。若涉及 DNS，先記錄目前設定與錯誤現象，再檢查相關選項；更換 DNS 並非適用於所有故障的通用解法。

Settings：確認測試條件與自動連線行為

進入 Settings，查看 Test Method，確認測試使用的方法是否適合目前的排查目標。不同方法可能產生不同結果；切換方法後，應註明測試條件已改變，不能直接將兩次結果視為相同測量。Language 可用於確認介面語言；Today Widget 並非基本連線成功的必要條件，入門測試不必先調整。

On Demand 用來決定符合條件時如何觸發連線，無法取代伺服器參數或 Rule。如果問題是在切換網路後，自動連線行為不符預期，請檢查現有的 On Demand 條件；先以手動連線確認基本連線正常，再調整自動觸發設定。不要只為了修復一次連線失敗，就同時開啟所有自動功能，造成無法判斷是哪項設定觸發重新連線。

Diagnostics 可協助查看排查資訊，分享前請確認內容是否包含伺服器位址、存取目標或認證資料。Settings 中的 Proxy、TCP、UDP 是進一步檢查時可用的入口，不代表每項都需要修改。涉及特定協定的選項，應依自己的設定條件判斷；不要只因截圖中出現某個選項，就修改預設值。

恢復正常後再整理設定

每次修改後，以先前相同的目標和方法重新測試；若沒有改善，請還原設定，再檢查下一項。找到有效調整後，記錄原因、清除測試時建立的重複項目，並確認 Global Routing 與 On Demand 已恢復預期狀態。若要進一步了解設定檔區段、規則優先順序和策略寫法，請參閱規則與設定檔參考；若需要重新走過操作流程，可返回新增與匯入，依照本頁順序逐步核對。