官方手冊 / 初次設定
Shadowrocket 使用說明
訂閱匯入、Global Routing 與連線驗證。依序完成設定，再逐項確認結果。
本教學適用於 iPhone 與 iPad。請先準備自己的連線資料，再操作 Home、Config 與 Settings。介面語言或 App 版面可能有所不同，以下以英文介面名稱指引；系統要求以 App Store 頁面標註為準。
閱讀順序：先讓自己的伺服器出現在 SERVER，再選擇模式並建立連線。每完成一步就確認一次，避免同時修改多項設定。
STEP 01 / Add Server · Subscribe
新增伺服器或匯入訂閱
開啟 Shadowrocket 並進入 Home。先查看下方的 SERVER 區域：如果清單仍是空的，開啟連線開關也無法取代伺服器資料。找到 Add Server，或使用頁面上的新增入口進入 Add Server。接著依手上的資料選擇一種方式即可，不必用多種方式重複匯入同一份資料。
已有訂閱連結：選擇 Subscribe
在 Add Server 的 Type 中選擇 Subscribe，找到訂閱網址欄位，貼上服務商提供的完整連結。請勿只複製網域，也不要漏掉網址後面的路徑與參數。填入方便辨識的名稱後儲存，等待訂閱內容取得完成，再返回 Home 查看清單。如果目前介面顯示訂閱群組，請展開群組，確認其中有實際的伺服器，而不只是群組名稱。
訂閱連結可能含有可識別帳戶的參數，應像密碼一樣妥善保管。貼上前後只在自己的裝置上核對，不要將完整網址放進公開截圖或聊天紀錄。儲存網址與成功取得內容是兩回事：若已出現群組但沒有伺服器，請先確認更新是否成功，不要立刻嘗試連線空白清單。之後重新取得訂閱時，伺服器名稱與數量也可能依你現有的服務內容而異。
已有單一伺服器資料：逐項填寫
手動新增時，請先選對 Type，再依該類型顯示的欄位填寫。截圖中的 Host、Port、Password、Method 是特定類型表單的欄位，不是所有協定都通用的固定欄位。Host 填伺服器位址，Port 填連接埠；其他驗證、傳輸與 TLS 等項目，應與自己的資料逐項一致。不要根據名稱猜測協定，也不要把某個協定的密碼填入另一個協定的身分欄位。
如果服務商提供相容的 QR Code，可使用 Scan QR Code，並依系統提示允許相機存取；Import from Cloud JSON 僅適用於相應格式的資料，並非一般訂閱網址的通用匯入入口。匯入後仍須開啟項目，檢查 Type、位址與連接埠。想了解各欄位的差異，可先閱讀概念速查；本步只需確保資料完整，且與原始資料一致。
完成標準：返回 Home 後，SERVER 中出現可辨識的伺服器；開啟項目後，重要欄位與現有資料相符。這只代表資料已輸入，不代表伺服器一定可連線；請繼續選擇 Global Routing，再進行連線與存取驗證。
STEP 02 / Global Routing · Config
選擇 Global Routing 運作模式
伺服器資料輸入完成後，返回 Home 並點開 Global Routing。這裡決定連線採用哪種模式，不會替你取得伺服器，也無法修正填錯的連接埠或驗證資料。三種模式分別是設定(Config)、代理(Proxy)、直連(Direct)。先了解差異，再依目前需求選擇，避免只憑名稱判斷是否已生效。
- 設定(Config)：依目前選取的設定檔處理連線。規則可讓不同目標分別使用 PROXY、DIRECT 或 REJECT；實際結果取決於規則內容與順序。
- 代理(Proxy)：將一般連線交由目前的代理策略處理，適合暫時減少規則差異，以檢查伺服器的存取能力。這不代表所有 App 和流量都一定會如此處理。
- 直連(Direct)：以直連模式處理連線。可用來與原本的網路狀況比較，但不能以直連網頁的開啟結果證明代理伺服器正常。
若要依規則使用，請選擇設定(Config)，再進入底部的 Config 頁面。確認目前選取的檔案確實是打算使用的檔案；匯入或編輯檔案，不代表它已成為目前設定。進入相應檔案後，可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。入門時先查看 Rule，不必為了連線伺服器而修改所有區段。
Rule 中的規則通常依序比對；目標符合前面的規則後，後續的兜底規則便不會再替它作決定。例如，以下教學片段將 example.com 及其子網域交由 PROXY 處理，私有網段交由 DIRECT 處理，其餘連線則使用 FINAL 指定的策略。這只是語法範例，不能直接取代個人完整設定檔，也不包含任何連線資料。
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY初次操作時，請勿急著點選 Add Rule。先保留原設定檔副本，確認目前檔案符合現有伺服器的用途，再決定是否修改特定規則。若設定檔使用了其他策略名稱，也要確認這些名稱是否存在及其指向。規則關鍵字的詳細說明請見概念速查；複雜的命中順序與異常排查，請參閱故障排查手冊。
完成標準：Home 中的 Global Routing 顯示預期模式；若選擇設定(Config)，也能確認目前使用的設定檔。接著返回 Home 選擇伺服器並連線；連線前不要連續修改規則、DNS 與傳輸參數。
STEP 03 / Home · SERVER
選取伺服器，開啟連線開關
返回 Home，在 SERVER 中選擇要使用的伺服器。確認選取標記位於目標項目上，而不只是開啟了該項目的編輯頁面。清單中有多個項目時，先選一個已確認資料無誤的伺服器作為測試對象；尚未驗證前不要頻繁切換，否則難以判斷是哪個項目影響結果。
選好伺服器後，開啟 Home 頂端的連線開關。首次連線時，系統可能會提示新增 VPN 設定；這項權限是讓 Shadowrocket 透過系統網路延伸功能處理連線，不代表系統已確認伺服器可用。請確認提示中的 App 名稱，選擇允許，並依裝置要求完成 Face ID、Touch ID 或裝置密碼驗證。驗證須在系統介面中完成，不需要將裝置密碼填入 Add Server。
如果先前取消了權限要求，請返回 App 再次操作開關，並留意系統是否重新顯示確認畫面。若系統限制不允許新增 VPN 設定，請先在裝置設定中確認相關限制；受組織管理的裝置應遵守管理政策。不要反覆刪除不認識的描述檔，也不要為了測試移除不了解用途的管理設定。
完成授權後返回 Home，查看頂端是否仍顯示 Not Connected，以及開關能否維持開啟。若開關立即關閉，先記下 App 或系統顯示的提示，再進行最後一步排查。若開關保持開啟，仍須繼續驗證：這只表示本機連線流程已建立，無法證明遠端伺服器、DNS 或每條分流規則都正常。
連線期間請保持目前網路相對穩定。剛從 Wi-Fi 切換至行動網路、裝置進入訊號不佳的區域，或個人熱點狀態改變，都可能讓測試結果不同。若要比較兩種網路，請先在一種網路上完成完整驗證，再切換另一種網路並重新測試；不要在同一次測試中同時切換網路並修改協定參數。
若發現關閉後又自動開啟，請檢查是否啟用了 On Demand。此功能與依網路條件自動連線有關，並不會提供新的伺服器來源。初次排錯時，可先記下原設定，再暫時關閉相關自動連線條件，以便手動控制每次測試。App 切到背景不代表連線已關閉，判斷時仍應參考 App 狀態與系統 VPN 狀態。
完成標準：已完成系統授權，Home 頂端不再顯示 Not Connected，且開關沒有立即關閉。保持目前伺服器與 Global Routing 設定不變，下一步檢查實際網頁請求；不要只看開關就認為設定完成。
STEP 04 / Connectivity Test · Data
驗證存取結果與規則策略
保持連線開啟，在 Home 找到 Connectivity Test 並執行測試，等待結果返回。測試可提供連線狀況的線索，結果解讀會受測試方式影響。出現數值不代表所有網頁或協定都正常；測試失敗也須搭配目前網路與測試方式判斷，不能直接認定整份訂閱已失效。請先記錄目前使用的伺服器、網路類型與測試結果，方便前後比較。
接著開啟瀏覽器，前往已確認網址正確且平時可存取的網頁。優先使用一般網頁，不要一開始就用大型下載或長時間播放影片來驗證。先確認網域能否解析、頁面主體能否載入，再查看圖片等資源是否完整。如果仍顯示舊頁面，請重新載入或開啟新頁面發出請求，避免將瀏覽器快取誤當成剛建立的網路存取。
使用設定(Config)時，一次成功存取可能走的是 DIRECT，而非 PROXY。要驗證分流，請分別選擇一個已知應由 PROXY 處理的目標，以及一個預期由 DIRECT 處理的目標進行檢查。不要用陌生網域猜測規則效果，也不要把「網頁能開啟」直接當成「該網頁經過所選伺服器」。是否經過代理，須搭配設定內容與連線紀錄判斷。
返回 Shadowrocket，在 Data 查看目前可用的連線或流量紀錄。不同介面版面可能有不同的紀錄入口，重點是找到剛才發出的請求，並核對目標網域、使用的策略，以及介面提供的規則比對資訊。若紀錄顯示 DIRECT，請回到 Config 檢查該目標為何命中直連規則；若顯示 REJECT，先檢查是否命中封鎖策略，不要只是不斷更換伺服器。
如果紀錄中沒有出現預期網域，先確認查看的是本次請求，且連線仍處於開啟狀態。有些 App 會重複使用已建立的連線，因此變更模式後應重新發出請求再比較。一次只更改一個變因，例如暫時從設定(Config)切換至代理(Proxy)進行對照；測試完成後恢復原模式，再對同一目標重新檢查。如此才能判斷差異是否來自規則。
完成標準：可以重新載入測試網頁，並將這次請求與預期模式或策略對應。若部分網頁仍無法使用，請保留一個成功與一個失敗的例子，進入下一步依症狀排查，不必重新從頭填寫所有資料。
STEP 05 / Settings · Diagnostics
常見問題的排查順序
排錯時，先確認問題發生在哪個步驟。訂閱內容取得失敗、伺服器測試失敗、開關無法維持開啟，以及網頁請求失敗，分屬不同環節。先保留目前設定，記下選取的伺服器與 Global Routing，再依下列順序縮小範圍。每次只修改一處，並重新發出相同請求；沒有改善就還原原值，不要把多次嘗試堆成一份難以判讀的設定。
已儲存訂閱，卻沒有伺服器
返回 Subscribe 對應的項目，確認連結是否完整、有沒有多出空格或換行，以及更新時是否出現錯誤。確認裝置時間正確、目前網路可取得訂閱內容，並確認自己的訂閱仍有效。訂閱網址是用來取得伺服器清單的網址，不應填入一般伺服器的 Host 欄位。若錯誤涉及伺服器端回應或帳戶狀態，請向自己的服務商確認；本說明站無法代為查證。
開關已開啟，但測試或網頁失敗
先確認目前選取的伺服器，再檢查 Type、Host、Port 與驗證欄位。若延遲測試成功但網頁無法存取，還要核對傳輸、TLS 等參數；部分測試結果無法驗證這些欄位是否全部正確。接著檢查 Global Routing：直連(Direct)無法證明代理正常；使用設定(Config)時，則要確認請求是否命中預期規則。可短暫切換至代理(Proxy)測試同一目標，完成後恢復原設定。
部分網域失敗，或載入停在某項資源
在連線紀錄中確認是否出現網域解析失敗，或請求是否被送至 REJECT。DNS 負責將網域名稱解析為位址，不能只憑伺服器測試數值判定 DNS 正常。不要一次替換所有 DNS 設定，也不要直接照抄不了解的完整設定。先用同一個失敗網域重新測試，保留原值，再參閱DNS 排查章節，依症狀繼續檢查。
連線狀態反覆變化，或需要查看診斷資訊
進入 Settings，確認 Test Method 是否符合目前的測試目的；若出現自動連線，請檢查 On Demand。需要進一步定位時，查看 Diagnostics 提供的資訊，先留意錯誤發生時間、目標與類型，不必修改所有 Proxy、TCP、UDP 選項。Settings 中的 Language 與 Today Widget 等項目無法修正伺服器驗證錯誤，排錯應針對故障環節進行。
準備向自己的服務商說明問題時，可整理裝置目前使用的網路、選取的協定、錯誤狀況與已完成的對照步驟。分享前請移除訂閱連結、密碼、身分識別資訊、完整設定中的私密欄位及其他個人資料；不要公開貼上整份設定檔。iPad 也依相同順序排查；螢幕方向或版面變化不會改變伺服器資料必須一致的前提。
下一步：若已能穩定存取，請保留目前可用的設定，並記下選取的伺服器與模式。若仍找不到問題原因，請至故障排除依具體症狀繼續閱讀；若不清楚 Subscribe、DNS、FINAL 等概念，先查閱概念速查，再返回本教學重新測試。
