官方手冊 · iPhone / iPad

Shadowrocket 使用教學

先新增既有連線資訊,再選擇路由方式。連線成功後,透過實際存取情況與連線記錄確認結果。

首次操作請依序閱讀;若已連線但存取異常,可直接前往確認結果與檢查問題。

步驟 01 · 準備連線資訊

Add Server 新增與匯入訂閱

手動填寫、訂閱與掃描 QR Code 是不同入口。選擇符合手上資訊的一種即可,不必重複匯入。

先確認手上資訊的類型

開啟 Shadowrocket,前往 Home,查看下方的 SERVER 分組。若手上有一組伺服器位址、連接埠與認證參數,請用 Add Server 手動新增;若有既有服務提供的訂閱連結,可用來更新多個伺服器項目,請使用 Subscribe 對應入口;若是單一伺服器的分享連結或 QR Code,則使用相應的匯入入口。不要只因連結以 https:// 開頭,就認定它是訂閱;一般說明網頁無法作為訂閱內容載入。

手動新增:先選 Type,再填寫欄位

在 Home 點選 Add Server,先開啟 Type,選擇與既有伺服器資訊相符的協定。Type 會決定後續欄位:截圖顯示的表單包含 Host、Port、Password、Method,不同協定不一定使用相同欄位。將伺服器位址填入 Host,連線埠填入 Port,再依原始資料填寫認證資訊;Host 通常只填網域或位址,不應連同網頁路徑一起貼上。Method 必須與既有設定一致,不要因名稱相近就任意替換。

若選擇的 Type 是 Trojan、VMess 或其他協定,請接著核對該類型實際顯示的認證、傳輸及 TLS 相關參數。不要把某種協定的 Password 當成另一種協定的識別欄位。填寫完成後使用頁面上的儲存功能,返回 Home,確認 SERVER 下方出現新項目,再檢查顯示名稱是否對應所需伺服器。若不清楚欄位的意義,請先查閱術語手冊中的協定與介面用語,不要反覆試填猜測。

訂閱與掃描 QR Code:匯入後確認內容

若已有訂閱連結,請在 Add Server 的 Type 中選擇 Subscribe,依表單填入訂閱網址並儲存。伺服器訂閱與 Config 頁面管理的遠端設定用途不同:若在 Config 看到 Subscribe 入口,請先確認它接受的內容類型,不要混用伺服器清單訂閱與完整設定檔網址。入口名稱或位置若有差異,請以目前頁面的提示為準。匯入後應確認 Home 是否顯示預期的伺服器,而不只是網址是否成功儲存。

若已有 QR Code,請使用 Scan QR Code,依系統提示允許所需的相機權限,再核對辨識出的內容。Import from Cloud JSON 適用於符合其要求的 JSON 內容,不是通用的訂閱連結匯入入口。若已有分享連結,可依 App 提供的剪貼簿匯入提示操作;辨識前請確認剪貼簿中只有完整連結,沒有說明文字、換行截斷或聊天標點。不要將含有認證資訊的連結貼到公開頁面。

完成後返回 Home,展開對應分組並選取伺服器。若清單仍是空的,請先確認訂閱是否成功傳回可辨識的內容、是否已過期,以及分組是否收合。重複新增相同位址通常無法解決內容格式錯誤;各入口的差異請參閱訂閱匯入方式說明。確認有可選擇的伺服器後,再進行下一步。

Shadowrocket 的 Add Server 頁面,顯示 Type、Host、Port、Password、Method 與 Scan QR Code 等入口
Add Server:先確認 Type,再依既有資料填寫。所選協定不同,表單欄位也可能不同。

步驟 02 · 決定流量處理方式

Global Routing 與 Rule 設定

伺服器決定「透過哪裡連線」,Global Routing 則決定「以什麼方式處理流量」。兩者需要分開檢查。

返回 Home,點選 Global Routing,查看目前選擇的模式。三種選項分別是設定 (Config)、代理 (Proxy)、直連 (Direct)。初次設定時,建議先確認自己的需求,再選擇相應項目;Home 中選取了伺服器,不代表所有請求都已透過該伺服器。

模式處理方式檢查重點
設定 (Config)依目前設定的規則決定請求採用的策略。已啟用的設定、規則順序與最終策略。
代理 (Proxy)以代理模式處理流量,不以逐條規則分流作為主要判斷方式。所選伺服器是否可用,以及實際存取是否成功。
直連 (Direct)讓流量直接連線至目標。無法據此證明所選代理伺服器運作正常。

若要依規則區分請求,請選擇設定 (Config),再前往底部的 Config 頁面確認目前使用的設定檔。開啟設定編輯頁後,可看到 General、Rule、Hosts 等區段;截圖顯示的是設定編輯內容,不是伺服器訂閱清單。既有服務提供的伺服器資訊不一定包含完整規則,因此「已匯入伺服器」與「已設定好規則分流」是兩回事。

先檢查既有 Rule,不急著新增

進入 Rule 查看既有項目。規則通常依序判斷,特定網域或位址條件應放在兜底規則之前;FINAL 用於前面的規則都未命中的情況。PROXY、DIRECT、REJECT 是策略關鍵字,不是三台伺服器。以下僅以保留的示範網域說明語法,不是可連線的伺服器資訊;若不熟悉原有設定,也不建議直接覆寫整個 Rule 區段。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

若只是想先確認既有伺服器能否建立連線,可暫時切換至代理 (Proxy) 進行對照測試,測試後再切回原本的設定 (Config)。若 Proxy 可存取、Config 卻無法存取,應優先檢查規則與設定中的策略引用,而不是立刻重新匯入訂閱。DOMAIN-SUFFIX、IP-CIDR 與 FINAL 的詳細說明請見術語手冊;本頁先完成連線與驗證,不延伸介紹複雜的規則撰寫。

修改既有設定前請先備份,每次只調整一個條件。儲存後返回 Home,再確認 Global Routing 顯示的是剛才選擇的模式,接著進行連線。

Shadowrocket 的 Config 設定編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config 設定編輯頁:規則內容位於 Rule 區段。從 Home 進入 Global Routing 選擇模式。

步驟 03 · 建立連線

Home 開啟連線與首次授權

選取伺服器、確認路由模式,再開啟連線開關。系統授權與服務認證是兩回事。

返回 Home,在 SERVER 中點選要使用的伺服器,確認選取標記位於目標項目上。若匯入了多個訂閱項目,不要只看分組名稱;實際選取的伺服器才是接下來要連線的對象。若剛修改過參數,請先儲存再返回 Home 操作,以免誤以為尚未儲存的表單內容已生效。

確認 Global Routing 後,開啟頂端 Not Connected 旁的連線開關。首次連線時,系統可能會提示新增 VPN 設定,這是用戶端使用系統網路功能所需的授權。確認提示來自目前操作的 Shadowrocket,再依系統要求確認;裝置可能會要求輸入密碼或使用生物辨識。這項授權不是登入既有服務的帳號,也不需要將訂閱密碼輸入系統裝置密碼欄位。

完成授權後返回 Home,等待 App 更新狀態。顯示 Connected 代表已建立連線,但不能據此認定所有目標都能存取;下一步仍須確認伺服器、目標與規則的組合。若開關立刻回到 Not Connected,請先確認是否取消授權、系統中是否有其他正在使用的 VPN 設定,以及裝置管理政策是否限制變更設定。請勿反覆快速切換開關,以免難以分辨每次操作的結果。

iPad 的畫面配置可能與截圖寬度不同,但操作順序相同:確認所選伺服器、確認 Global Routing,再操作連線開關。若要修改伺服器參數或更換設定,可先中斷連線,儲存後再重新連線,並記下變更內容。暫時停止使用時,在 Home 關閉連線開關即可;正常中斷連線不需要刪除訂閱或清除設定。

若已啟用 On Demand,連線行為也可能受其觸發條件影響。首次確認時,建議先採用明確的手動連線流程;了解結果後,再單獨設定 On Demand,避免同時引入多個變因。保持目前連線狀態,進行下一步的實際存取檢查。

Shadowrocket 的 Home 頁面,頂端顯示 Not Connected 開關,下方有 Global Routing、Connectivity Test、SERVER 與 Add Server
Home:連線開關、Global Routing 與 Connectivity Test 位於同一頁面;SERVER 分組可用來選取伺服器。

步驟 04 · 確認實際結果

Connectivity Test 與存取確認

在 Home 點選 Connectivity Test,等待目前測試完成。測試用於觀察指定方式下的連線情況,結果會受測試目標、Test Method、目前網路與伺服器狀態影響。單次逾時不足以證明所有服務都無法使用;同樣地,出現測試結果也不代表每個 App、每個網域都採用相同路徑。先確認結果是否穩定,再用瀏覽器實際存取,不要只根據清單中的單次數值判斷。

先確認基本存取情況

在瀏覽器開啟一個已知可存取的頁面,再開啟這次需要確認的目標。比較頁面是否能完整載入,而不只是曾經顯示內容;網路異常時,快取頁面仍可能出現。

再確認流量處理路徑

重新查看 Global Routing 與已啟用的設定。若要確認特定請求是否依預期走 PROXY 或 DIRECT,請搭配相應的連線記錄與命中規則檢查,不要只看系統 VPN 標示。

在設定 (Config) 模式下,不同網域可能命中不同策略,因此一個頁面成功,不代表另一個目標也使用代理。可針對同一目標,短暫比較代理 (Proxy) 與設定 (Config) 的表現:保持伺服器不變,只切換模式,再重新送出請求。若差異穩定出現,記下目標網域與命中規則,再返回 Rule 檢查。確認完成後,請恢復希望長期使用的模式,避免忘記目前仍是測試設定。

若瀏覽器運作正常但某個 App 異常,請檢查該 App 是否需要重新連線,以及是否有獨立的網路設定。若所有目標都無法存取,請進入下一步,從基本網路開始排查。只在自己管理或有權存取的目標上進行確認;不必為了證明連線狀態,就向陌生網站提交訂閱連結、認證資訊或完整設定。

步驟 05 · 一次只調整一個條件

Settings 與常見問題

依照「基本網路 → 匯入內容 → 伺服器參數 → 路由與 DNS」的順序檢查,並保留可重現問題的條件。

清單空白,或訂閱更新失敗

先關閉連線,確認目前網路能正常開啟既有服務所需的頁面,再檢查訂閱網址是否完整、是否多了空格,以及服務端權限是否仍有效。儲存訂閱名稱不代表已成功取得伺服器清單;請查看更新提示,並返回 Home 確認項目。若服務端回傳登入頁面或錯誤說明,用戶端無法將其當成伺服器資料使用。不要將完整訂閱網址貼到公開留言區,其中的認證資訊可能代表使用權限。

清單有項目,但連線逾時或認證失敗

返回 Add Server,對照原始資訊逐項檢查 Type、Host、Port 與認證參數。網域拼字、連接埠位數及密碼前後的空格都應分別核對;TLS 的伺服器名稱也不能憑直覺更換。若同一分組只有一個項目失敗,其他既有項目在相同網路下都能使用,應優先檢查該項目與對應服務的狀態。若更換網路後才恢復,請記下 Wi-Fi 或行動網路的差異,不要一次同時修改協定、連接埠與規則。

已 Connected,但目標無法開啟

先確認目前不是直連 (Direct),再比較代理 (Proxy) 與設定 (Config)。若只有 Config 出現問題,請檢查是否選對設定、規則是否如預期命中,以及策略是否引用了有效項目。兩種模式都無法使用時,再檢查伺服器與 DNS。網域無法存取不一定是 DNS 問題;請根據錯誤提示判斷,別把任意更換 DNS 當成通用解法。

測試結果與實際存取情況不一致

前往 Settings 查看 Test Method。不同測試方法反映的範圍不同,測試目標本身也可能暫時無法連線。請維持相同的測試方法再比較,並以實際存取結果補充判斷。Settings 中的 Proxy、TCP、UDP 等設定涉及不同層面的行為,初次使用時不建議一起修改;變更前記下原值,若出現問題才有明確的還原方式。

開關反覆切回,或需要進一步診斷

若手動關閉後又自動連線,請檢查 Settings 中的 On Demand 條件,不要直接刪除所有設定。若仍無法找出問題,請進入 Diagnostics 查看可用的診斷資訊,記下發生時間、目前網路、Global Routing 模式、所選伺服器與錯誤情況。分享記錄前,請移除訂閱網址、密碼、認證識別資訊與個人網路資訊,只保留排查所需的內容。

以上流程適用於首次連線的快速檢查。若遇到持續逾時、DNS 解析、耗電、更新後異常或 iPad 特定問題,請繼續閱讀疑難排解手冊;若要了解設定欄位,請查閱術語手冊。保留最後一次可正常使用的設定副本,比不斷疊加不明設定更有助於重現問題與還原。

Shadowrocket 的 Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:Test Method 用於查看測試方式,On Demand 可管理觸發條件,Diagnostics 則提供進一步診斷的入口。