官方手冊 · 首次使用

Shadowrocket 使用教學
匯入與首次連線

依五個步驟完成基本操作:新增現有資料、選擇 Global Routing、開啟連線,再透過實際瀏覽確認結果。適用於 iPhone 與 iPad;截圖供辨識介面,實際畫面請以裝置上的 App 為準。

先確認一部伺服器及一種明確的路由方式都能正常運作,再調整其他設定。操作前保留原始資料,請勿將密碼、訂閱網址或 QR Code 公開張貼。

步驟 01 · 匯入資料

Add Server:新增伺服器或匯入訂閱

兩種方式擇一即可。伺服器參數與訂閱網址的填寫位置不同,請勿將訂閱連結填入 Host。

開啟 Shadowrocket 後進入 Home,先找到 SERVER 分組與 Add Server 入口。已有項目時也請先確認來源,避免將同名項目誤認為本次要使用的伺服器。手動填寫者需備妥協定類型、伺服器位址、連接埠及該協定要求的驗證資料;只有訂閱連結者,直接依下方 Subscribe 流程操作,不必逐一抄寫伺服器參數。

手動填寫:先選 Type,再填入相應欄位

點按 Add Server 進入新增頁面後,先開啟 Type,選擇與現有伺服器資料相符的協定。變更 Type 時,可填寫的欄位也可能隨之改變。官方截圖展示的是含有 Host、Port、Password、Method 的其中一種新增頁面,並不代表每種協定的欄位都完全相同。請以自己的資料為準,逐項確認後再儲存;缺少參數時不要自行猜填。

Host 通常填入伺服器網域名稱或位址,Port 填入連接埠數字。Password 與其他驗證欄位請依原始資料完整輸入,留意大小寫、前後空格及複製時夾帶的換行。只有相應協定需要時才設定 Method;不要因截圖出現某個選項,就將它套用到其他協定。若資料包含額外的傳輸或加密參數,也應逐項填妥;只填最上方幾個欄位並不代表設定已完成。

Subscribe:匯入自己的訂閱

如果取得的是訂閱連結,請在 Add Server 的 Type 選擇 Subscribe,再將完整網址貼到 URL 欄位,確認後儲存。訂閱網址通常含有用於識別帳戶的參數,應視為敏感資料。請勿刪除問號後的內容,也不要連同通訊軟體包在連結外的引號、空格或說明文字一起貼上。匯入後返回 Home,確認相應分組中已出現伺服器項目;若只有訂閱名稱而沒有實際伺服器,請檢查更新結果。

若持有相容的伺服器 QR Code,可使用 Scan QR Code;Import from Cloud JSON 則用於相應的 JSON 匯入方式,兩者都無法取代所有類型的訂閱匯入。若不確定資料格式,請先向自己的服務提供者確認格式名稱,再選擇匯入入口。如需了解 Subscribe 與 Config 的差異,請參閱術語表,不要反覆嘗試不同欄位碰運氣。

儲存後選取本次要使用的伺服器,確認名稱、位址與連接埠是否相符。訂閱更新可能會改變項目清單,之後重新連線前也應再次確認目前選取的伺服器。此時只是將資料匯入用戶端,尚未證明連線可用;接下來先決定要求應如何處理,再開啟連線。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method,以及 Scan QR Code 和 Import from Cloud JSON
新增資料時先確認 Type;各協定的欄位請以實際頁面為準。
步驟 02 · 要求處理方式

Global Routing:選擇設定檔、代理或直連

伺服器決定可使用哪條連線,Global Routing 則決定要求如何處理;兩者都需要分別確認。

返回 Home,點按 Global Routing 查看目前模式。三種模式分別是設定檔 (Config)、代理 (Proxy) 與直連 (Direct)。選擇前先釐清目的:要依規則區分網站、暫時測試已選伺服器,或在目前模式下直接連線。模式只會改變要求的處理方式,無法修正錯誤的密碼,也不會補齊缺少的伺服器資料。

設定檔 (Config):確認目前生效的規則

設定檔 (Config) 會依目前設定檔中的規則決定要求採用哪種策略。若已有自己的設定檔,請進入 Config 頁面,確認要使用的檔案已選取,而非僅存在清單中。開啟編輯頁面可看到 General、Rule、Hosts 等區段;本教學只需了解 Rule 與目前設定檔的關係,不必同時調整 URL Rewrite 或 HTTPS Decryption。

Rule 中的項目有比對順序,已先符合前面規則的要求,通常不會再交由後面的後備規則處理。下方範例表示 example.com 及其子網域使用 PROXY,其餘未符合規則的要求使用 DIRECT。這只是兩條規則的寫法示例,不是完整設定,也不含伺服器資料。修改前請保留副本,確認語法與策略可用後再儲存,並重新確認目前生效的檔案。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

代理 (Proxy) 與直連 (Direct):依目的選擇對照

代理 (Proxy) 會讓採用此模式處理的要求經由代理連線,可用於短時間確認所選伺服器能否正常瀏覽;但仍須留意系統及設定中的略過選項。直連 (Direct) 則讓相關要求直接連線,不使用所選代理伺服器。因此,Home 中選取了某部伺服器,不代表 Direct 模式下的瀏覽也會經過該伺服器;請依驗證目的選擇相符的模式。

首次排查時,若不確定現有規則會將目標網站交由哪種策略處理,可先記下目前模式,暫時切換至 Proxy 作對照,再還原原設定。若 Proxy 可以瀏覽而 Config 不行,下一步優先檢查規則與 DNS,不必立刻重新匯入訂閱。更多規則、DNS 與 Settings 說明請參閱設定詳解;確認模式後,繼續完成系統授權與連線。

Shadowrocket 的 Config 設定編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 和 Add Rule
Config 編輯頁用於查看設定檔區段;Global Routing 的模式選擇入口位於 Home。
步驟 03 · 系統授權

Home:開啟連線開關並確認狀態

先確認伺服器與模式,再開啟頂端開關。首次系統授權與伺服器驗證是兩回事。

完成前兩個步驟後返回 Home。先確認 SERVER 分組中本次要使用的伺服器,再查看 Global Routing 顯示的模式。若剛更新訂閱、切換設定檔或從其他頁面返回,請重新確認一次。確認無誤後點按頂端連線開關;截圖中的 Not Connected 表示用戶端尚未建立系統連線狀態。

首次開啟時,系統可能會提示新增 VPN 設定。此提示是允許 Shadowrocket 在系統中建立相應網路設定,並非要求再次輸入伺服器密碼。請先閱讀系統提示中的 App 名稱與說明,確認正在進行本次操作後再允許,並依裝置提示完成驗證。若取消授權,可返回 Home 再試;不要將未完成授權造成的連線失敗誤認為訂閱失效。

完成授權後返回 App,觀察頂端狀態是否改變。如果開關立即關閉或仍顯示 Not Connected,請先確認系統授權是否確實完成,再檢查是否有其他正在運作的 VPN 連線影響目前操作。若系統中的相關設定曾遭移除,下次開啟連線時可能需要重新授權。更換裝置後,也請依新裝置上的實際提示操作;不能因舊裝置曾成功授權就跳過此步驟。

iPad 上同樣從 Home、SERVER 與 Global Routing 開始確認。介面空間及系統提示的位置可能不同,但新增資料、選擇模式、授權與驗證的順序不變。操作期間盡量維持同一種本機網路;若在切換開關的同時更換 Wi-Fi 與行動網路,之後便難以判斷結果變化是由哪項操作造成。

開關維持開啟,只能表示用戶端的系統連線已啟動,無法據此判斷每部伺服器、每條規則或每個網站都能正常運作。先維持目前選擇不變,繼續執行下一步的 Connectivity Test 與實際瀏覽;如此若發生問題,才能沿著已確認的設定逐步定位,而非將前面的設定全部重做。

Shadowrocket 的 Home 頁面,頂端顯示 Not Connected 開關,下方有 Global Routing、Connectivity Test、SERVER 分組與 Add Server
Home 集中顯示連線開關、Global Routing 與伺服器選擇,是首次連線前的確認位置。
步驟 04 · 實際驗證

Connectivity Test:測試後確認網站瀏覽結果

請分別確認「開關已開啟」、「伺服器測試有回應」及「目標網站可瀏覽」這三件事。

在 Home 點按 Connectivity Test,查看本次選取的伺服器是否有測試結果。測試結果會受 Settings 中的 Test Method 等選項影響;有一次回應不代表所有網路要求都能完成,沒有回應也無法單憑這點證明伺服器在所有情況下都不可用。請先維持測試方式不變,記錄是所有項目都沒有結果,還是只有目前項目失敗,避免直接比較不同測試方式的結果。

接著開啟瀏覽器,先瀏覽一個你明確知道應如何處理的網站,再開啟實際要驗證的目標網站。不要只查看已開啟很久的頁面,因為沒有送出新要求時,快取內容仍可能顯示。可重新載入頁面,並確認頁面中確實需要連線的內容已載入。測試期間維持伺服器、Global Routing 與本機網路不變,結果才有比較價值。

若使用設定檔 (Config),請先確認目標網域應符合哪條規則。網站可以開啟,並不能單憑頁面內容證明流量經過 PROXY;該網域也可能符合 DIRECT。若需進一步確認,請搭配 App 提供的連線紀錄或日誌,核對目標網域及其處理策略。日誌可能包含瀏覽紀錄與伺服器資料,查看後請勿直接公開分享整份紀錄。

若開啟與關閉連線時目標頁面都能開啟,請先確認目前是否使用 Direct,以及 Config 是否將該網域交由 DIRECT 處理。若只有部分圖片、登入要求或附屬頁面失敗,請留意同一網站可能會存取多個網域,主網域的規則未必涵蓋所有資源。此時請記下具體失敗的網域或頁面現象,再檢查規則,不要直接擴大所有規則的適用範圍。

實際瀏覽結果符合預期後,即可保留這組已驗證的設定。之後若需切換伺服器或調整規則,每次只變更一項,再以相同方式重新測試。若結果不符預期,請依下一步順序檢查,先找出問題所在,再考慮修改設定。

步驟 05 · 逐項檢查

Settings 與常見問題排查

保留可還原的起始設定,先檢查輸入資料與模式,再檢查 DNS、測試方式及診斷紀錄。

匯入失敗或伺服器測試失敗

訂閱沒有產生項目時,先確認網址是否完整、是否貼入 Subscribe 的 URL 欄位,再確認自己的訂閱狀態與更新提示。訂閱網址可以開啟,不代表傳回的內容就是用戶端需要的格式;若顯示登入頁面或說明頁面,請向自己的服務提供者確認正確網址與格式。請勿將含有驗證參數的網址交給公開工具測試。

手動新增的項目失敗時,返回 Add Server 對應的編輯頁面,依原始資料逐項確認 Type、Host、Port 與驗證欄位。尤其留意協定選擇、密碼中的空格,以及是否漏填額外參數。同一分組有多部伺服器時,可選擇另一個現有項目作對照,但請勿在切換項目的同時修改 Test Method,否則無法判斷變化來自伺服器還是測試方式。

開關已開啟,但實際瀏覽失敗

先確認目前不是直連 (Direct),再檢查設定檔 (Config) 中目標網域對應的策略。暫時切換至代理 (Proxy) 作對照時,請記下原模式,驗證後再還原。若 Proxy 正常而 Config 失敗,請優先檢查規則順序、目前生效的檔案及後備策略;若兩者都失敗,再檢查伺服器參數、本機網路與 DNS。

DNS 問題可能表現為無法解析網域,也可能只影響部分網站。先記錄設定檔中現有的 DNS 設定,不要一次加入多組來源不明的位址。維持其他設定不變,確認目前設定檔是否覆寫相關選項;必要時參照Settings 設定項目參考逐項測試。連線失敗也可能出在本機網路層;條件允許時可改用另一種本機網路作對照,但請將此操作與切換伺服器分開進行。

進入 Settings 時,針對問題檢查相應項目

Settings 中可查看 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 等項目。各項目用途不同,並不是每項都必須開啟的檢查清單。Test Method 會影響測試方式;On Demand 涉及依條件啟動連線,首次手動驗證時請先確認它是否影響開關運作;Diagnostics 可協助進一步定位問題。不要為了「試試看」而同時修改連接埠、協定相關設定及自動連線條件。

需要使用診斷資料時,先重現一次問題,再記下發生時間、目前模式、所選伺服器與具體失敗情況。分享日誌或截圖前,請移除訂閱 URL、密碼、驗證參數及不必要的瀏覽紀錄;描述「在 Config 下失敗,切換至 Proxy 後恢復」通常比只說「無法連線」更有助於定位。測試完成後還原暫時變更,並保留最終確認可用的設定檔副本。

至此,基本流程已完成:資料存在且欄位可確認、模式符合目標、系統連線可以啟動,實際要求也有驗證結果。若仍不確定某個英文項目的意思,請先查閱術語表;遇到購買、匯入或連線方面的具體問題,可查看常見問題。待基本連線穩定後再進一步調整,不必在首次使用時同時設定所有功能。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings 可用來針對性檢查測試與連線行為;修改前先記下原值,每次只調整一項。