官方手冊 · 初次設定

Shadowrocket 使用說明

依新增、選擇模式、連線、驗證、排查的順序操作。先完成一次可重現的連線,再調整規則與自動連線條件。

請依步驟順序閱讀;已完成匯入的使用者可直接從 Global Routing 開始。截圖用於辨識頁面,實際入口位置以目前 App 顯示為準。

步驟 01 · 連線資料

新增伺服器或匯入訂閱

iPhone / iPad:先讓 Home 的 SERVER 清單出現自己的項目,再選擇連線模式。

開啟 Shadowrocket 後先停留在 Home,不必立即開啟頂端開關。既有資料通常分為兩類:一類是包含多個伺服器的訂閱連結,另一類是單一伺服器的協定、位址、連接埠及驗證欄位。兩者的填寫位置不同;不要將完整訂閱連結當成 Host,也不要將單一伺服器的位址直接填入訂閱位址欄。

使用 Subscribe 匯入既有訂閱

  1. 向自己的服務提供者取得訂閱連結,並複製完整內容。複製時留意開頭和結尾是否混入空格、換行或說明文字,尤其不要只複製聊天工具中遭截斷的可見部分。
  2. 進入訂閱管理入口,找到 Subscribe;若從 Add Server 進入,先選擇訂閱類型,再填入自己的連結。Config 中的設定檔管理與伺服器訂閱用途不同,不能只因連結結尾相同,就認定格式一致。
  3. 儲存並執行更新。等請求結束後返回 Home,展開相應群組,確認 SERVER 下是否出現預期項目。若只看到訂閱名稱,卻沒有任何伺服器,請先檢查更新結果,不要繼續反覆切換連線開關。

訂閱更新會讀取遠端提供的伺服器資訊,不代表已建立代理連線。訂閱網址可能包含個人存取識別資訊,不應貼到公開討論區;排查時只描述錯誤現象,不要公開完整網址。若更新結果是網頁或登入提示,應向原資料提供者確認連結用途,而不是透過修改 Host 或 Port 嘗試修復。

使用 Add Server 手動填寫

  1. 在 Home 的 SERVER 區域點選 Add Server。先選擇 Type,讓表單與既有資料的協定一致,例如 Shadowsocks、VMess、VLESS 或 Trojan。不同 Type 顯示的欄位可能不同。
  2. 依序填寫 Host、Port 及目前 Type 所需的驗證資訊。截圖中的 Password、Method 是對應的表單欄位;不要將它們視為所有協定都必填的通用項目,也不要憑經驗猜測加密方式。
  3. 確認後儲存並返回 Home。若資料來自 QR Code,可使用 Scan QR Code;Import from Cloud JSON 僅適用於相應格式的資料,並非任意訂閱網址的替代入口。

例如 example.com 只能用來理解位址欄位,並非可用伺服器。填寫完畢後應再逐項對照原始資料;即使協定選擇正確,驗證值不一致也可能造成逾時或連線中斷。確認項目已儲存後,繼續下一步選擇 Global Routing。

Shadowrocket Add Server 官方截圖,顯示 Type、Host、Port、Password、Method 及 Scan QR Code 等入口
Add Server:先選擇 Type,再依既有資料填寫對應欄位。
步驟 02 · 請求去向

選擇 Global Routing 模式

iPhone / iPad:伺服器決定連線目標,Global Routing 決定請求如何選擇策略。

返回 Home,開啟 Global Routing,確認目前選取的模式。初次操作最容易混淆「已有伺服器項目」和「所有請求都經過該伺服器」這兩件事:前者只是儲存了連線資料,後者還取決於 Global Routing 與目前設定。先釐清這次要驗證的內容,再選擇模式,可以減少後續排查時的變數。

  1. 設定(Config):根據目前啟用設定中的規則決定請求策略。需要依目標分流時使用,並先確認已選取所需設定。匯入伺服器訂閱不代表會自動取得符合個人用途的規則檔案。
  2. 代理(Proxy):用於集中驗證所選代理伺服器的連線情況。適合暫時區分「伺服器連線問題」與「規則選擇問題」,但無法保證所有 App、所有連線類型都一定成功。
  3. 直連(Direct):請求以直連模式處理。可用來與原本的網路狀態比較;此時存取正常,不能作為代理伺服器可用的證據。

選擇後返回 Home,查看 Global Routing 這一列是否顯示預期值。若要長期依規則使用,請進入 Config,找到並啟用自己的設定檔;需要查看內容時再開啟編輯頁面。官方截圖中的 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 是設定分區,Add Rule 用於新增規則,不是新增伺服器的入口。

在 Rule 中先檢查既有規則,不必為了初次連線立即新增內容。規則通常由上而下比對,較早符合的項目會影響後續判斷;結尾的 FINAL 用作預設處理。以下僅為語法閱讀範例,不是可直接取代個人設定的完整檔案。PROXY 需要對應可用的代理策略,DIRECT 代表直連,策略名稱應以目前設定實際定義為準。

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

初次設定不需要同時調整 DNS、URL Rewrite 和 HTTPS Decryption。保留已知設定,只確認 Global Routing,可讓下一步的結果更容易判讀。若不熟悉規則關鍵字,請先查閱名詞解釋;完整的比對與 DNS 排查內容收錄於疑難手冊,本頁將繼續完成連線流程。

Shadowrocket Config 官方截圖,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 分區與 Add Rule
Config:確認目前的規則檔案;Add Rule 與 Add Server 用途不同。
步驟 03 · 系統連線

選取項目並開啟連線開關

iPhone / iPad:先確認 SERVER 中的選取項目,再處理系統 VPN 設定權限。

此時已儲存伺服器資料,也已確認 Global Routing。返回 Home,在 SERVER 群組中找到這次準備使用的項目並選取。若同一訂閱包含多個項目,先固定其中一個完成測試,避免測試前後切換伺服器,卻誤以為結果變化是某項設定造成的。

  1. 確認 Home 顯示的伺服器選取項目與 Global Routing。若伺服器清單為空,請返回第一步處理匯入,不要用連線開關取代訂閱更新。
  2. 開啟頂端 Not Connected 對應的連線開關。初次建立連線時,系統可能會要求新增 VPN 設定;閱讀提示並確認來源為 Shadowrocket 後允許,再依系統要求完成裝置驗證。
  3. 返回 App,等待 Home 狀態變更。若系統權限視窗仍顯示在前景,請先完成或取消該操作,不要在不同頁面連續重複點選開關。

允許 VPN 設定代表讓 App 透過系統網路機制處理相關流量,不是購買線路,也不會補齊缺少的伺服器密碼。若先前拒絕過權限,請重新開啟開關並依系統提示處理;若裝置受組織管理,系統限制可能需要管理員確認,單純重新安裝 App 未必能解除限制。

連線狀態變更後,先留在 Home 觀察,不要立即啟用 On Demand。手動連線能穩定重現後,再考慮自動連線條件。其他 VPN 設定或具有類似網路接管功能的工具可能會與目前連線互相影響,測試時應確認沒有其他連線正在切換,避免狀態反覆變動。

Home 顯示已連線,只代表目前連線流程進入相應狀態,不能證明每個目標都可存取。接下來必須分別驗證伺服器、目標存取和規則選擇;若開關立即恢復關閉,請直接跳到第五步檢查權限與連線環境。

Shadowrocket Home 官方截圖,頂端顯示 Not Connected、Global Routing 與 Connectivity Test,下方為 SERVER 與 Add Server
Home:確認 SERVER、Global Routing 與頂端連線狀態。
步驟 04 · 確認結果

驗證連線與規則是否生效

iPhone / iPad:分別確認測試結果、實際存取與命中策略。

連線開關保持開啟後,在 Home 使用 Connectivity Test 查看這次的測試結果。測試只能反映相應方法和目標的情況:有結果不代表所有服務都可用,逾時也不必立刻推斷整台伺服器無法使用。先記錄目前網路、選取項目和 Global Routing,再以相同條件繼續驗證。

  1. 先確認基本網路。暫時中斷 Shadowrocket,用瀏覽器造訪平常能開啟的頁面。若原本的網路需要登入或尚未連線,應先完成網路連線;代理設定不能取代 Wi-Fi 或行動數據連線。
  2. 再驗證實際目標。重新連線,開啟自己確實需要使用的頁面或服務,執行一次可重複的操作,例如重新整理同一頁面。不要只憑狀態列的 VPN 標示判斷存取已成功。
  3. 最後確認規則。使用設定(Config)時,在 Data 中搭配目標網域、時間與策略記錄查看這次請求。頁面可能會同時請求多個網域,應找到與失敗操作相關的記錄,而不是只看清單最上方的一筆。

若目標在代理(Proxy)下可存取,在設定(Config)下卻失敗,應優先檢查目前設定與命中策略。常見原因包括目標命中 DIRECT、規則順序不符合預期,或策略引用與目前可用項目不一致。若兩種模式都失敗,再檢查伺服器驗證、基本網路和 DNS,不要先堆疊更多規則。

為減少快取干擾,每次修改後都重新執行相同操作,必要時關閉並重新開啟受測頁面。既有連線不一定會立即依新規則重建,因此「儲存後原頁面沒有變化」不能單獨證明修改無效。一次只變更一個變數,並記錄前後差異,才能將問題定位到特定設定。

若只有個別 App 失敗,而瀏覽器驗證正常,請先確認該 App 實際請求的目標及連線類型。更詳細的 DNS、UDP、速度與 App 差異問題,請參閱疑難手冊;常見的簡短問題可先查閱疑難解答。

步驟 05 · 單點排查

依失敗位置檢查 Settings

iPhone / iPad:從最先失敗的步驟開始,不要同時變更協定、DNS 與規則。

進入 Settings 前,先用一句話描述現象:「訂閱更新失敗」、「開關立即關閉」、「測試逾時」或「只有某個目標無法開啟」。這些現象屬於不同階段,處理方式也不同。Settings 中的 Test Method、On Demand、Diagnostics、Proxy、TCP、UDP 是不同設定項目,並沒有適用於所有故障的通用組合。

  1. 匯入失敗:確認連結是否完整、目前網路能否完成訂閱請求,以及資料是否仍有效。若為手動填寫,請重新檢查 Type、Host、Port 和驗證欄位。伺服器清單已出現時,不要因後續存取失敗就反覆刪除整個訂閱。
  2. 開關無法開啟或立即關閉:先確認系統 VPN 設定權限是否已完成、是否有其他連線同時啟動,再檢查裝置管理限制。若手動關閉後又自動連線,請進入 Settings 的 On Demand 確認條件;排查期間暫時停用自動觸發,再手動測試。
  3. Connectivity Test 逾時:在 Settings 確認 Test Method,釐清目前使用的測試方法,再與實際網頁存取結果對照。可使用自己已有的另一台伺服器進行比較,但測試時應維持相同網路和方法,避免同時更換所有條件。
  4. 已連線但無法存取:先比較代理(Proxy)與設定(Config),再檢查 Data 中相關目標的策略記錄。若網域存取異常而其他連線有結果,再檢查 DNS;不要一開始就隨意更換多項解析設定。
  5. 部分 App 或連線類型異常:先確認問題是否只出現在特定目標、特定網路或特定操作。TCP 與 UDP 的表現可能不同,應依據既有伺服器能力和實際請求判斷,不要將啟用某個選項當成通用修復方式。

需要進一步定位時再使用 Diagnostics。只需保留能說明失敗時間與步驟的片段;分享截圖或記錄前,應遮蔽訂閱網址中的存取識別資訊、驗證資訊及不需公開的存取目標。診斷資訊用來說明現象,不應用來公開自己的完整設定。

若問題只在切換 Wi-Fi 與行動網路後出現,請先回到手動連線條件,在兩種網路分別重做第四步;若只在 App 更新後出現,請保留目前資料並逐項確認設定,不要未備份就刪除所有設定。處理後再次執行「選取項目 → 連線 → 測試 → 實際存取」的完整流程,確認修復並非偶然結果。

仍無法定位時,請前往疑難手冊依症狀繼續排查。記錄裝置系統、目前網路、Global Routing、最先失敗的步驟和已嘗試的單項變更,比只描述「無法連線」更有助於縮小問題範圍。

Shadowrocket Settings 官方截圖,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:依現象檢查 Test Method、On Demand 或 Diagnostics。