- 官方手冊 · 入門教學
- 新增 → 模式 → 連線 → 驗證
Shadowrocket 使用教學
使用已有的訂閱或伺服器資訊完成首次連線。先依照明確的操作步驟連線，再調整規則與自動連線。
建議依序閱讀並逐步確認。截圖為 App Store 官方素材；實際介面請以裝置上安裝的 App 為準，顯示欄位會依所選 Type 而異。
Add Server：新增伺服器或匯入訂閱
訂閱連結與單一伺服器資訊是兩種不同的輸入方式，依手邊資料選擇其中一種即可。
開啟 Shadowrocket，進入 Home，找到 Add Server 或新增項目的入口。先確認手邊資料屬於哪一類：訂閱連結用來取得一組伺服器項目；單一伺服器資訊則需要手動填寫協定與連線欄位。不要把整段訂閱連結貼到 Host，也不要把伺服器網域誤認為訂閱網址。
已有訂閱連結：選擇 Subscribe
進入 Add Server 後，點開 Type 並選擇 Subscribe，在對應的 URL 欄位貼上已有的完整訂閱連結，並視需要填寫方便辨識的備註。貼上後，檢查連結前後是否有空格或換行，以及是否遭聊天 App 截斷。連結中的路徑與參數是一體的，不要為了縮短網址自行刪改。
儲存後返回 Home，等待內容載入完成；如需更新，使用該訂閱對應的更新功能。確認匯入成功時，清單中應出現可選取的伺服器項目，而不只是多出一個訂閱名稱。更新後仍是空白，請先停在這一步檢查連結與訂閱狀態，不必反覆開關連線。訂閱的有效期限、回傳內容與存取權限，請向原本取得服務資訊的來源確認。
已有單一伺服器資訊：逐項填寫欄位
手動新增時，先在 Type 選擇與現有資訊相符的協定，再填寫 Host、Port 及必要的驗證欄位。例如，選擇 Shadowsocks 後會看到 Password、Method 等欄位；其他協定顯示的欄位可能不同，不能套用同一組參數。Host 通常填寫主機名稱或 IP 位址，Port 填寫連接埠；是否需要其他參數，請以現有伺服器說明為準。
若已有可匯入的 QR Code，可使用 Scan QR Code；Import from Cloud JSON 僅適用於符合該入口格式的內容，並非通用的連結匯入方式。匯入後仍應開啟項目，檢查協定、位址、連接埠及驗證資訊。儲存並返回 Home 後，在 SERVER 群組中選擇這次要使用的項目，再進行下一步。
Global Routing：選擇運作模式
新增項目只完成了資訊輸入；請求如何處理，還取決於模式與目前的設定。
返回 Home，點開 Global Routing。三種模式分別是設定（Config）／代理（Proxy）／直連（Direct）。選擇前，先確認這次的目的：依規則日常使用、確認所選伺服器，或暫時檢查直連網路。清單中有伺服器，不代表所有請求都會經過該伺服器。
設定（Config）：依目前規則處理
選擇 Config 後，請求會依目前設定中的規則處理。進入底部的 Config 頁面，確認實際啟用的設定檔；若要查看規則，請開啟對應檔案的編輯頁並找到 Rule。這與 Home 中的 Global Routing 是兩個相關但不同的位置：前者管理設定內容，後者決定是否依照這些內容運作。
規則通常由上而下比對，符合後便採用對應策略。DIRECT 表示直連，PROXY 表示代理策略，REJECT 表示拒絕請求；FINAL 則處理前面規則都未符合的情況。因此，使用 Config 時出現直連請求不一定是故障，應先確認該請求符合哪條規則。初次使用不必同時編輯 General、Hosts、URL Rewrite 或 HTTPS Decryption，這些都不是完成基本連線的必要步驟。
代理（Proxy）與直連（Direct）：明確指定連線路徑
Proxy 使用代理路徑，排查時可暫時減少規則帶來的變數，但仍須有有效的伺服器資訊；切換至此模式不會修復位址、驗證資訊或伺服器狀態。Direct 使用直連路徑，可用來確認目前網路能否直接連線至目標，但不能據此判定所選代理伺服器正常。
若現有設定明確要求使用 Config，請依其說明選擇；若要判斷問題是否來自規則，可暫時切換至 Proxy，對同一目標進行一次比對，再恢復原本模式。修改規則前請保留原始設定，本頁不要求建立複雜規則。更多關於 DOMAIN-SUFFIX、GEOIP 與 FINAL 的說明，請參閱規則分流與問題排查常見問題。
Home：開啟連線並完成 VPN 授權
先確認伺服器與 Global Routing，再操作頂端開關。
返回 Home，確認 SERVER 下已選取這次要使用的伺服器，再檢查 Global Routing 是否顯示預期模式。若上一步只匯入了內容，尚未選取項目，請先完成選取；若訂閱清單仍是空的，請返回步驟一，不要把頂端開關當成更新訂閱的入口。
開啟頁面頂端的連線開關。首次連線時，系統可能會顯示新增 VPN 設定的授權提示，這是 App 建立系統網路連線所需的權限步驟。確認提示是由目前操作觸發後，依系統要求允許並完成裝置驗證，再返回 Shadowrocket。請勿將系統提示與伺服器的 Password 混淆：裝置驗證與伺服器驗證是兩個不同環節。
返回 Home 後，查看頂端是否仍顯示 Not Connected，並確認連線開關與狀態是否維持已連線。若剛開啟就立即關閉，先記下 App 或系統顯示的具體提示，再檢查 VPN 設定授權與現有參數。快速反覆切換開關會讓問題發生的順序難以判斷，建議每次操作後等狀態穩定再繼續。
iPad 的頁面空間與系統提示版面可能和截圖不同，操作順序仍是選取項目、確認模式、開啟連線並完成授權。系統顯示 VPN 狀態，只能表示相關連線已建立；這無法單獨證明遠端伺服器可用，也不代表每個 App 的請求都經過代理。請先維持目前設定，接著進行下一步驗證。
Connectivity Test：測試後再驗證實際使用情境
分別檢查連線狀態、測試結果與實際瀏覽，才能判斷問題出在哪個環節。
在 Home 找到 Connectivity Test 並執行測試，先確認是否能取得測試結果。測試失敗是進一步檢查的線索，不代表所有請求一定失敗；測試成功也只表示目前測試條件下有回應，不能取代實際使用驗證。測試採用的方法或目標可能與日常使用的 App 不同，因此不要只憑單次結果就重建所有設定。
接著開啟需要使用的 App 或頁面，送出新的請求，例如重新載入頁面，或再次執行剛才失敗的操作。只查看已快取的內容，無法確認這次網路請求是否成功。若只有特定目標有問題，記下具體操作與時間；若所有目標都失敗，再回頭檢查整體連線與伺服器資訊。
使用 Config 時，還要根據目前設定判斷請求應走哪條路徑。若 App 內可用的請求紀錄顯示符合 DIRECT，先確認這是否符合規則預期；若符合 REJECT，則檢查是否遭到誤攔。需要比對時，暫時切換至 Proxy，重新送出同一個請求，再恢復原本模式。Config 與 Proxy 的結果不同，是檢查規則的依據，不代表應直接刪除所有規則。
- 連線狀態正常：Home 顯示已建立連線，開關沒有自行關閉。
- 測試結果可判讀：記下 Connectivity Test 的結果和使用的測試方式。
- 實際請求成功：目標頁面或 App 成功完成一次新的網路操作。
- 連線路徑符合預期：Global Routing 與規則決定的去向符合使用目的。
完成以上檢查後，再以目前選項作為日常使用的起點。若只有部分項目符合預期，請不要籠統記為「無法連線」，而應具體記錄為「開關自行關閉」、「測試失敗但頁面可用」或「Proxy 正常、Config 異常」。這些描述能直接對應後續的排查方向，也能避免不必要的設定變更。
Settings：依序排查，每次只變更一項
先處理最早失敗的步驟；每次只變更一個項目，並保留可復原的設定。
匯入後沒有內容，或儲存後沒有可選項目
返回訂閱設定，檢查 Type 是否為 Subscribe、URL 是否完整，以及更新是否已完成。若回傳的是說明網頁、登入頁面或錯誤內容，App 就無法將其作為有效的伺服器清單。確認現有訂閱狀態後再更新；不要透過變更 Global Routing 來處理解析失敗，模式只負責決定請求路徑，無法補齊訂閱內容。
開關自行關閉，或連線後無法瀏覽
先釐清問題出在系統授權還是伺服器通訊。若開關無法維持開啟，檢查 VPN 設定是否已獲授權、有無系統限制或明確錯誤提示；若開關維持開啟但無法瀏覽，再核對所選項目。逐一比對 Type、Host、Port 與驗證欄位，特別留意複製時帶入的空格、Method 不一致及遺漏的協定參數。不要憑經驗更換加密方法或連接埠，欄位內容應與自己的伺服器資訊一致。
測試結果與頁面瀏覽狀況不一致
進入 Settings 查看 Test Method，確認這次測試採用的方式。不同測試方式涵蓋的條件不盡相同，不宜直接比較結果。接著返回 Home，檢查 Global Routing 與目前設定；若只有 Config 異常，優先檢查 Rule、FINAL 及相關解析設定。DNS 設定涉及較多細節，建議先閱讀Shadowrocket DNS 設定與連線問題說明，不要同時變更多個 DNS 選項來試錯。
基本連線正常後，再設定 On Demand
On Demand 會依設定條件觸發連線，無法修復錯誤的伺服器參數。初次排查時請先使用手動開關，避免自動連線觸發後，誤以為 App 沒有記住關閉狀態。基本連線驗證通過後，再視需要進入 Settings 設定 On Demand，並實際測試觸發條件。Proxy、TCP、UDP 等設定也應在有明確需求時才調整，不要同時開啟所有選項。
若仍無法找出問題，可在 Diagnostics 查看可用的診斷資訊，記下失敗步驟、當時的模式與具體錯誤。分享紀錄前，請刪除訂閱連結、驗證資訊及其他敏感內容。購買、系統需求與已購項目復原說明，請參閱App Store 安裝指南；連線與規則相關延伸問題，請查看常見問題。
