Official Manual / Getting Started
Shadowrocket 使用教學
加入既有訂閱、選擇 Global Routing,再進行連線與驗證。
本篇適用於 iPhone 與 iPad 的首次設定。先完成一次可供查核的連線,再調整規則與其他設定;每個步驟都保留明確的檢查結果。
操作順序
Home → Add Server → Global Routing → 連線開關 → Connectivity Test
先核對輸入資料,再確認請求路徑。伺服器項目、設定檔與連線狀態是三種不同的檢查對象。
Step 01 / Add Server · Subscribe
新增伺服器或匯入既有訂閱
完成此步驟後,Home 的 SERVER 分組應會出現可選取的伺服器項目。
開啟 Shadowrocket,進入 Home,在 SERVER 分組中找到 Add Server;也可使用頁面頂端的新增入口。進入 Add Server 後,先查看 Type,不要直接填寫 Host。Type 會決定後續所需欄位,訂閱匯入與手動新增也從此處分開。匯入時可先讓頂端連線開關保持關閉,避免混淆「資料能否匯入」與「伺服器能否連線」這兩項判斷。
已有訂閱連結:使用 Subscribe
在 Type 中選擇 Subscribe,將自己持有的訂閱連結貼到 URL 欄位,並設定容易辨識的名稱。名稱僅供本機識別,不會變更連結內容。儲存前,請檢查連結前後是否多了空格、換行或通訊軟體附帶的說明文字;不要把介紹頁面的網址當成訂閱連結。訂閱網址可能包含個人存取憑證,請保留完整參數,但不要公開分享。
儲存後返回 Home,等待訂閱內容取得完成,再展開相應分組查看伺服器清單。顯示訂閱名稱,不一定代表伺服器已成功載入;請進一步確認分組內是否有實際項目。若清單為空,先檢查網路能否連到訂閱網址、連結是否仍有效,以及回傳內容是否為 App 可辨識的訂閱資料。如需重新取得,請在該訂閱的操作選單中執行更新;不同介面配置的入口位置可能不同,請以目前 App 顯示為準。
已有伺服器資料:逐項填寫
如果持有的是單一伺服器的參數,請在 Add Server 中依照提供的資料選擇 Type,再核對 Host 與 Port。Host 通常是伺服器網域名稱或 IP 位址,不應額外加上網頁路徑;Port 必須與伺服器設定一致。截圖中的 Password、Method 是特定類型使用的欄位;切換到其他 Type 後,驗證與傳輸選項也會改變。不要因為暫時看不到某個欄位,就把資料填進名稱或密碼欄位。
密碼、UUID、TLS、傳輸方式等資料,應逐項對照自己的伺服器資料,不要任意複製其他項目的內容。若資料提供的是受支援的 QR Code,可在 Add Server 中使用 Scan QR Code,並依系統提示授予所需權限。Import from Cloud JSON 適用於相應格式的設定內容,並非通用訂閱入口;已有一般訂閱連結時,仍應使用 Subscribe 流程。
儲存後返回 Home,確認項目已出現,並點選這次要使用的項目。訂閱分組中可能有多個項目,本教學只需選定一個進行後續驗證。此時請勿反覆修改多個伺服器的參數;若有疑問,記下缺少的欄位,再查閱名詞解釋。完成選擇後,下一步請確認 Global Routing,決定請求如何使用這些資料。
Step 02 / Global Routing · Config
選擇 Global Routing 三種模式
伺服器資料決定「連線到哪裡」,Global Routing 與規則則決定「請求如何傳送」。
返回 Home,點選 Global Routing。請在此區分設定 (Config)、代理 (Proxy) 與直連 (Direct)。選擇後返回 Home,確認該列顯示的是剛才選定的模式。切換模式本身不會補齊伺服器資料,也無法修復失效的驗證資訊,因此應先完成第一步再進行。
設定 (Config):依目前設定檔處理
設定 (Config) 會依目前啟用的設定檔進行規則比對。進入 Config,查看實際選用的檔案;開啟檔案後可看到 General、Rule 等區段。Rule 中的具體規則通常應放在兜底規則之前,比對結果會決定請求採用 PROXY、DIRECT 或其他已定義的策略。若設定引用了策略群組,還需確認群組內的選擇;不能只因為在 Home 選過伺服器,就認定所有策略都已正確指向。
以下是用來理解順序的設定語法片段,並非完整設定檔,也不包含伺服器資料。範例中,符合 example.com 的網域請求會使用 PROXY,其餘未符合的請求則由 FINAL,DIRECT 作為兜底。實際測試前,請先查看自己的檔案,不要直接以此教學片段覆蓋原有設定。
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
訂閱清單與規則檔需分開核對:Subscribe 通常用來取得伺服器項目,不代表已啟用適合目前需求的規則。初次使用時,請先確認目前檔案來自自己了解的設定來源,再檢查測試目標會符合哪條規則。不要一次匯入大量不熟悉的規則,否則實際瀏覽失敗時,很難判斷問題出在伺服器還是規則比對結果。
代理 (Proxy) 與直連 (Direct):區分檢查目的
代理 (Proxy) 會讓納入代理處理範圍的請求透過代理路徑,可用於檢查所選伺服器是否可用;系統流量範圍與其他設定仍可能影響結果,不能理解為所有請求必定走同一路徑。直連 (Direct) 則會透過直連路徑處理,不適合用來驗證代理伺服器是否可用。比較兩種模式時,請使用同一個目標與同一個網路,並維持其他條件不變。
如果日常需要依規則分流,確認設定後可使用設定 (Config) 繼續下一步;如果要排除規則的影響,可暫時使用代理 (Proxy) 進行比較,檢查完再恢復原先預定的模式。首次連線時不必調整設定檔中的 DNS、規則與策略群組細節;如需深入核對,請前往Settings 與設定詳解。
Step 03 / Home · Connection
開啟連線開關,完成系統授權
先確認 Home 中選取的伺服器與模式,再處理系統提示。
返回 Home,先進行簡單核對:SERVER 中選取的是準備測試的伺服器,Global Routing 顯示的是上一步確認的模式;若使用設定 (Config),也請確認目前的設定檔。官方截圖頂端的 Not Connected 表示尚未連線,不要因為下方已顯示伺服器清單,就以為連線已建立。
開啟 Home 頂端的連線開關。首次建立連線時,系統可能會提示允許 Shadowrocket 新增 VPN 設定;這是裝置將相關網路請求交由 App 處理所需的系統授權。確認提示中的 App 無誤後,依指示繼續並完成裝置要求的身分驗證。請在系統介面輸入系統驗證資料,不要填入 Add Server 的 Password 欄位。
完成授權後返回 Shadowrocket,查看頂端的連線狀態是否改變。如果取消提示,開關可能會恢復關閉;此時應先重新完成授權,而不是修改訂閱網址。若沒有出現提示,也不一定代表異常,裝置可能已經有相應設定。請依據目前狀態與系統中的 VPN 設定判斷,不要為了等候提示而反覆刪除設定。
開始測試前,也請確認裝置上沒有另一個正在接管相同網路連線的設定。若切換設定可能影響目前連線,請先記錄現況,再到系統設定確認實際生效的項目。由公司或學校管理的裝置可能對 VPN 設定另有限制,請遵守裝置管理要求;不要把系統限制當成伺服器密碼錯誤。
看到連線狀態改變後,先維持 App 中的選擇不變,再進行下一步驗證。連線開關維持開啟,表示本機連線流程已有進展,但無法單獨證明遠端驗證、網域解析與所有目標的瀏覽都正常。必須綜合判斷 App 狀態與實際請求,才能確認這次設定是否符合預期。
Step 04 / Connectivity Test · Requests
驗證測試結果與實際瀏覽
請分別判斷「測試完成」、「已建立連線」與「目標可用」。
在 Home 使用 Connectivity Test,等待目前測試結束,再查看相應項目的結果。測試方法會影響結果的意義:有些著重於連線是否建立,有些則會對指定目標發出請求。結果可用來找出明顯無法連線的項目,但不代表 App 已完成所有瀏覽驗證,也不應只憑單一數值判斷實際使用情況。
接著開啟瀏覽器,前往一個自己確定應可使用的目標網頁,確認頁面主體與必要資源都能載入。如果這次要檢查代理路徑,請選擇在目前設定中確實會走 PROXY 的目標;使用設定 (Config) 時,即使恰好命中 DIRECT 的網頁可以開啟,也無法證明代理伺服器正常運作。測試目標必須符合規則預期。
需要比較時,請維持目標與裝置網路不變,分別記錄連線前後或切換模式前後的狀況。每輪只變更一個條件,例如只將設定 (Config) 切換為代理 (Proxy),接著重新發出請求。不要同時更換伺服器、切換網路、修改 DNS 又更新規則,否則即使情況改善,也無法判斷是哪項調整造成影響。
瀏覽器快取、既有長連線與 App 本身的網路行為都可能影響觀察結果。請重新載入頁面,必要時關閉原頁面後再開啟;不要把仍顯示的舊頁面當成新請求已成功。某個網頁能載入,也不代表所有 App、所有協定的請求都會以相同方式處理。請以目標 App 中的實際功能作為最終檢查依據。
如果 Connectivity Test 有結果,但實際頁面無法開啟,下一步請著重檢查 Global Routing、命中策略、DNS 與目標本身;如果測試與實際瀏覽都失敗,則優先檢查伺服器資料與目前網路。記下問題發生的階段,比反覆切換開關更有幫助。測試方法的詳細差異請參閱測試與 Ping 設定說明;其他術語請參閱名詞解釋。
Step 05 / Settings · Diagnostics
依失敗階段檢查設定
先找出問題所在的層面,再決定是否需要調整設定。
匯入後沒有伺服器項目
回到第一步,檢查 Subscribe 中的 URL 是否完整、是否誤貼了說明文字,以及訂閱是否確實回傳有效內容。取得訂閱資料與連線伺服器是不同的網路操作:無法更新清單,不一定表示已儲存的伺服器都無法使用;反過來,清單能更新,也不代表其中每個項目都能連線。確認連結是否有效時,請只向自己既有服務的資訊提供者查詢,不要公開包含憑證的完整網址。
有伺服器項目,但 Connectivity Test 失敗
手動新增的項目應逐一核對 Type、Host、Port 與驗證欄位,再檢查 TLS 與傳輸相關參數。訂閱項目則先更新一次,確認仍在有效使用期間;不要直接修改自己不了解的欄位。到 Settings 查看 Test Method 時,請先記下目前的選擇;不同測試方法可能得出不同結果。變更方法只會改變檢查方式,不會自動修復伺服器設定。
開關無法維持開啟,或實際瀏覽結果不如預期
如果開關立即關閉,請先確認系統是否已完成 VPN 設定授權,以及裝置目前是否允許啟用該設定。若開關能維持開啟,但部分目標仍無法使用,請依第二步檢查 Global Routing 與目前規則;在直連 (Direct) 模式下的瀏覽結果,不適合用來判斷代理伺服器是否正常。若只有特定目標異常,也應排除目標服務本身的限制或故障,不要直接重設所有設定。
如果連線會因特定網路條件而自動變化,請查看 Settings 中的 On Demand。此功能涉及依條件觸發連線;首次手動驗證時,應先了解現有條件是否會影響觀察,而不是將其視為提升連線效果的通用選項。首次排查時也不宜一次調整 Proxy、TCP、UDP 等多項設定;每次變更前先記下原值,並使用同一個目標重新測試,確認沒有改善後再還原。
使用 Diagnostics 時保留必要背景資訊
需要進一步找出問題時,可在 Settings 查看 Diagnostics 提供的診斷入口,並配合失敗時間與具體目標閱讀結果。記錄目前網路、Global Routing、所選項目的類型,以及畫面上顯示的錯誤文字;若記錄包含網域、位址、驗證資訊或訂閱憑證,分享前請先移除敏感內容。請勿為了尋求協助而傳送完整訂閱連結或未檢查的整份設定檔。
完成基本驗證後,可將 Global Routing 恢復為日常所需模式,並再次確認實際瀏覽狀況。後續調整 DNS、On Demand、記錄或同步時,請沿用「記下原值、每次只改一項、驗證結果」的方法。更完整的設定說明請參閱設定詳解;若要依狀況查找問題,請前往常見問題。本篇到此完成首次操作流程,無須在初次使用時啟用所有功能。
繼續閱讀:先查找具體問題,再深入了解相關設定。