官方手冊 · 首次連線

Shadowrocket 使用教學

依新增、模式、連線、驗證、排查五個步驟操作。先完成一次可重現的連線,再逐步調整規則與自動連線設定。

畫面截圖為 App Store 官方展示圖,用於辨識頁面與欄位,不是需要照著填寫的設定。實際操作入口與欄位請以裝置上目前顯示的 App 為準。

步驟 01

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

先確認手上的資料是單筆伺服器資訊,還是會傳回伺服器清單的訂閱連結。兩者都從新增入口開始,但選擇的 Type 不同。

已有伺服器資訊:依實際協定填寫

在 Home 下方找到 Add Server,點開後先查看 Type。將 Type 設為資料中明確標示的協定,再核對 Host、Port 及該協定要求的驗證欄位。不要只因幾個欄位看起來相似就選擇其他類型;協定不符時,即使能儲存,也不代表可以成功連線。

以 Shadowsocks 為例,Host 填寫伺服器位址,Port 填寫連接埠,Password 與 Method 必須和伺服器端完全一致。其他協定可能使用不同的驗證方式,或需要 TLS、傳輸方式等額外參數,請依照既有資訊逐項填寫。Host 通常只填主機名稱或位址,不要把整段訂閱連結貼進 Host,也不要自行加上路徑。

填寫完成後使用頁面上的儲存功能,返回 Home,確認 SERVER 清單中已新增項目。名稱只是方便辨識的備註,不能取代位址與連接埠。若要新增多筆資料,建議使用能區分用途的備註,避免之後測試時選錯項目。

已有訂閱連結:選擇 Subscribe

在 Add Server 的 Type 中選擇 Subscribe,進入相應頁面後,將自己的完整訂閱連結填入 URL,設定方便辨識的備註後儲存。連結中的路徑和查詢參數可能用來辨識訂閱,複製時務必保留完整內容,尤其確認結尾沒有遭截斷,也沒有多出空格或換行。

返回 Home 後,確認相應訂閱群組是否已載入伺服器項目。若沒有顯示清單,先查看是否出現更新失敗提示,再透過該訂閱群組的更新功能重試。成功讀取訂閱只代表已取得清單;每台伺服器是否可用,仍須在後續測試中確認。更新訂閱也不代表已替換 Config 中啟用的規則檔。

單筆分享連結或 QR Code,請使用 App 支援的相應匯入功能;Scan QR Code 用於掃描既有 QR Code,Import from Cloud JSON 則用於相應的 Cloud JSON 資料,並非通用的訂閱匯入入口。匯入完成後,仍應開啟項目確認 Type 和主要參數,再進入下一步選擇路由模式。

Shadowrocket Add Server 頁面,包含 Type、Host、Port、Password、Method 與底部的匯入入口
Add Server:先確認 Type,再依自己的伺服器資訊填寫。欄位會隨所選協定而變化。
步驟 02

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

Global Routing 決定如何處理請求,不會補上伺服器資訊。先了解目前的路由模式,再啟用連線。

在 Home 點開 Global Routing,確認目前選項。三種基本模式為設定 (Config)、代理 (Proxy) 與直連 (Direct)。選擇後返回 Home,確認 Global Routing 旁顯示的是預期模式;不要只憑上次使用的印象,排查過程中可能已經變更設定。

設定 (Config):依目前設定決定連線路徑

Config 適用於需要依規則分流的情境。它會根據目前啟用設定中的 Rule 等項目,決定請求使用 PROXY、DIRECT 或其他已定義的策略。要使用此模式,請先前往底部的 Config 頁面,確認目前使用的設定檔,再查看其中的 Rule;只在 Home 匯入訂閱,並不代表規則已按預期設定。

官方截圖中的 Config 編輯頁包含 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。初次使用只要確認目前設定檔與 Rule,不必為了連線而修改所有區段。Add Rule 是新增規則的入口;若不清楚比對對象和策略的意義,請先保留原設定,避免混淆匯入問題與規則問題。

代理 (Proxy):作為短暫對照

Proxy 會將一般請求交由所選的代理路徑處理,適合在排查時與 Config 短暫對照。若 Proxy 可以存取、Config 下相同目標卻失敗,應優先檢查設定中的規則比對結果及相關設定,而不是立刻重建伺服器。Proxy 無法絕對保證所有系統流量或 App 行為;測試結束後,請恢復符合實際需求的模式。

直連 (Direct):區分基本網路與代理路徑

Direct 用於直接連線至目標,不是切換伺服器的按鈕。若要測試所選伺服器,請勿停留在 Direct 模式後就據此判定伺服器是否有效。Direct 較適合用來區分基本網路問題與代理路徑問題。選好模式後,下一步返回 Home 選取伺服器並啟動連線。

初次連線時,不必一次掌握規則關鍵字、協定參數與效能取捨。若要確認所選 Type 的欄位意義,請參閱協定參考;若要了解路由與 On Demand 的差異,請查看設定說明。

Shadowrocket Config 設定編輯頁,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 區段及 Add Rule
Config:檢查目前設定中的 Rule。Global Routing 的模式選擇入口位於 Home。
步驟 03

Home:選擇伺服器並啟用連線

清單中有項目,不代表目前已使用該項目。先選擇伺服器,再開啟頂端開關,最後確認系統授權與連線狀態。

返回 Home,在 SERVER 清單點選準備使用的伺服器,確認選取標記位於目標項目上。若清單來自多個訂閱群組,先核對群組名稱和備註,不要把清單排序變動誤認為已切換伺服器。接著再次查看 Global Routing,確認模式與上一步的選擇一致。

開啟 Home 頂端的連線開關。未連線時,頁面會顯示 Not Connected;開啟後請等待狀態變更,不要連續快速切換。首次啟動連線時,系統可能會提示新增 VPN 設定。確認提示來自剛才操作的 Shadowrocket 後,依系統指示允許,並視需要完成裝置驗證,再返回 App 查看狀態。

VPN 設定授權可讓 App 透過系統網路延伸功能處理流量,不是訂閱登入,也不會替你產生伺服器。若取消授權,請返回 App 再次嘗試連線並處理提示。若裝置由組織管理、受到系統限制或已有其他 VPN 設定,請先確認裝置政策是否允許建立這類連線;不要反覆刪除設定盲目嘗試。

連線狀態變更只代表連線流程有所進展,不能單獨證明遠端伺服器可用,或所有請求都依預期分流。保留目前的伺服器與模式,繼續完成下一步測試。若開關立即關閉或出現錯誤,記下錯誤原文與發生階段,再前往排查問題,避免同時修改多處設定而無法還原。

Shadowrocket Home 頁面,頂端顯示 Not Connected 開關、Global Routing 和 Connectivity Test,下方為 SERVER 與 Add Server
Home:選擇伺服器、確認 Global Routing,再操作頂端的連線開關。
步驟 04

Connectivity Test:驗證連線與實際存取

驗證分為兩個層面:伺服器測試提供參考,實際請求則確認使用效果。請一併查看兩者結果。

在 Home 點選 Connectivity Test,等待清單中的測試結果更新。測試方法會影響結果的意義,可前往 Settings → Test Method 確認目前方法。某筆記錄出現結果,只代表相應方法在當時完成測試;逾時也不一定表示該伺服器在所有情境下都無法使用,仍須搭配實際請求判斷。

接著保持連線,在瀏覽器開啟一個平常用來確認連線的網頁,先確認頁面能完整載入,再測試原本要確認的目標。盡量送出新的請求,避免只查看已快取的頁面。若只有某個 App 異常,但瀏覽器可以存取,請勿直接判定整體連線失敗,並記錄該 App 與目標之間的差異。

若要確認規則分流,請在相同網路、相同伺服器和相同目標下,對照 Config 與 Proxy 的結果,每次只變更 Global Routing。若兩種模式的結果不同,再回到 Config 檢查 Rule 與相關設定。規則通常依序比對,較早符合的項目可能決定後續路徑;檔案中存在某條規則,不代表實際請求一定符合該規則。

Data 中的流量變化可作為請求活動的參考,但不能只根據累計流量判斷某個網頁使用了哪條路徑。完成驗證後,恢復打算長期使用的模式,並記錄所選伺服器、設定名稱和測試目標。之後若發生異常,以這組固定條件重新測試,比不斷更換項目更容易找出變化原因。

步驟 05

Settings:依序排查常見問題

從基本網路開始,再檢查伺服器、模式、DNS 與規則。每次只修改一項,並在修改前記下原設定。

第一層:先區分網路、訂閱與伺服器問題

暫時關閉 Shadowrocket 連線,確認裝置的基本網路可正常使用,尤其檢查目前的 Wi-Fi 是否需要先登入網路。若基本網路本身無法使用,請先處理這個問題;更改代理協定或規則無法修復尚未建立的網路連線。

若訂閱沒有載入項目,返回訂閱記錄確認 URL 是否完整、有無更新提示,並檢查連結是否仍有效。若已有項目但連線失敗,開啟該伺服器確認 Type、Host、Port 與驗證欄位,並檢查訂閱中的資訊是否已變更。先確認自己的資料仍有效,再決定是否更新訂閱;不必每次失敗都重新匯入。

第二層:先比對模式,再檢查 DNS 與 Rule

確認 Home → Global Routing 沒有誤選 Direct,並確認目前選取的伺服器就是剛才核對的項目。使用 Proxy 短暫對照:若相同目標恢復存取,應著重檢查 Config;若仍然失敗,再檢查伺服器參數、基本網路與目標本身。對照時不要同時切換網路和伺服器,否則無法判斷是哪一項造成影響。

網域無法存取時,DNS 是需要檢查的環節之一,但並非唯一原因。先記下目前設定中的 DNS 設定及相關提示,再確認是否輸入錯誤或發生衝突。不要連續套用來源不明的設定,也不要把任意固定位址當成適用所有網路的通用解法。若 Proxy 正常但 Config 異常,請繼續檢查 Rule 的順序、目標比對範圍與最終策略。

第三層:確認 On Demand 與 Diagnostics

若連線關閉後又自動開啟,請前往 Settings → On Demand 確認是否啟用了觸發條件。On Demand 控制何時建立連線,Global Routing 控制如何處理請求,兩者並非同一個開關。初次排查時,先記下 On Demand 原有設定,必要時暫時停用以減少變數,確認手動連線穩定後再恢復。

如需進一步診斷,請查看 Settings → Diagnostics,保留錯誤原文、發生時間、網路類型與重現步驟。不要為了嘗試修復而隨意調整不熟悉的 Proxy、TCP、UDP 選項。分享診斷資料前,請遮蔽訂閱 URL、伺服器驗證資訊與其他敏感內容;通常保留協定類型與錯誤階段,就足以協助判斷方向。

若問題只發生於某種協定,請前往協定參考確認該協定的必要欄位與傳輸條件;若要重新整理操作順序,請回到本頁的新增與匯入步驟,從有效資料開始逐項確認。排查完成後,請還原暫時變更,避免長期忘記診斷用的 Proxy 模式或已停用的自動連線條件。

Shadowrocket Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 和 UDP
Settings:排查時優先確認 Test Method、On Demand 與 Diagnostics,不必逐項修改所有選項。
前往 App Store