官方手冊首次連線

Shadowrocket 快速入門

新增既有連線資訊,選擇 Global Routing,再驗證實際存取。依五個步驟完成一次可供複查的連線流程。

準備一個可用的訂閱網址,或一份完整的伺服器參數即可,不必兩種方式都操作。以下官方截圖用於辨認介面位置;伺服器名稱與可用項目請以自己的設定為準。

01 / ADD

新增伺服器 / 匯入訂閱

先將資訊新增至 Home 的 SERVER 分組,再決定要使用哪個項目。

開啟 Shadowrocket,進入 Home。首次使用時,SERVER 分組可能尚未包含伺服器。點選 Add Server 進入新增頁面,先查看 Type,再選擇與手邊資訊相符的類型。訂閱網址、單一伺服器分享連結與一般網頁網址並非相同內容;如果無法確認手邊資訊的用途,請先查看服務商提供的參數說明,不要反覆切換類型嘗試。

已有訂閱連結:選擇 Subscribe

在 Add Server 中開啟 Type,選擇 Subscribe,將完整訂閱網址填入相應的 URL 欄位,並填寫方便辨認的名稱。複製時保留網址中的路徑與查詢參數,移除前後空格或換行,不要只複製網域。儲存並等待訂閱內容取得完成,再返回 Home,確認訂閱分組下已出現伺服器項目。若只看到訂閱名稱卻沒有伺服器,請先依第五步檢查取得結果,而不是直接開啟連線。

訂閱通常用於批次管理伺服器。後續更新應在原訂閱項目上進行,不必每次重新新增相同網址。伺服器數量或名稱有所變動時,請先確認更新是否成功,再重新選取可用項目。訂閱成功取得只代表網址傳回可匯入的內容,並不代表其中每台伺服器都能連線。

已有單一伺服器:逐項核對參數

若服務商提供的是單一伺服器參數,請在 Type 選擇相應協定,再填寫 Host、Port 以及該協定要求的驗證資訊。以 Shadowsocks 為例,必須正確填寫 Password 和 Method;其他協定可能使用不同欄位,請勿將一種協定的參數套用至另一種類型。不要自行在 Host 前加上網頁網址前綴,Port 應與提供的資訊一致,Password 則須留意大小寫與複製時多出的空白。

如果已有 QR code,可在 Add Server 底部使用 Scan QR Code,並依系統提示允許存取相機。Import from Cloud JSON 僅適用於符合該入口格式的設定資料,並非所有訂閱網址都適用。無論透過哪種方式匯入,儲存前都要檢查 Type 與重要欄位;儲存後返回 Home,點選預計使用的伺服器,確認選取標記位於正確項目上。

完成此階段的標準是「看得到並選取伺服器」,而不是「已成功連線」。下一步將決定請求如何交由這台伺服器處理。協定參數的完整說明請參閱從入門到進階的官方手冊;首次操作時先保留服務商提供的參數即可。

Shadowrocket Add Server 頁面,顯示 Type、Host、Port、Password、Method 與底部匯入入口
Add Server:先確認 Type,再填寫相應欄位。截圖中的欄位組合不代表所有協定都相同。

02 / ROUTING

選擇 Global Routing 模式

伺服器決定連線目的地;Global Routing 決定請求的處理方式。

返回 Home,點選 Global Routing,查看設定(Config)、代理(Proxy)、直連(Direct)三個選項。首次連線時,先確認本次要驗證的是伺服器本身,還是既有規則的分流結果。若不清楚目前的模式,不要同時修改伺服器、規則與 DNS,否則發生問題後很難判斷是哪個步驟造成變化。

設定(Config):依設定檔中的規則處理

選擇設定(Config)時,請求會依目前設定檔中的規則決定處理策略。進入 Config,確認正在使用的設定檔;開啟設定檔編輯頁面,可看到 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 等區段。首次使用時請優先查看 Rule,確認既有規則符合自己的存取需求。若沒有明確需求,不必為了連線而啟用其他區段,也不需要先修改所有設定。

以下片段僅用來說明順序:符合 example.com 及其子網域的請求會走 PROXY,其他未符合的請求則由 FINAL 交給 DIRECT。example.com 是範例網域,不代表需要連線的伺服器,也不是可直接符合個人需求的完整設定。規則由上而下比對,FINAL 應放在最後的兜底位置;若目標請求已符合前面的規則,後面的規則不會再替它重新選擇。

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

代理(Proxy)與直連(Direct):用於明確的驗證目的

代理(Proxy)會將交由用戶端處理的請求依代理模式轉送,適合首次檢查已選取的伺服器能否完成目標存取。直連(Direct)則會讓請求直接連線至目標,不經代理伺服器;需要比較目前網路本身能否存取時,可將其作為對照。Global Routing 並非特定應用程式專屬的開關,而是描述目前用戶端處理請求的方式。

如果尚未確認規則是否正確,可先使用代理(Proxy)完成一次連線與存取驗證。確認伺服器可用後,再切換至設定(Config),檢查預期的分流是否成立。若只有設定(Config)存取異常、代理(Proxy)正常,應優先檢查目前的設定檔、規則順序與比對策略,而非立刻刪除伺服器。更完整的規則說明請參閱系統化使用手冊。

Shadowrocket Config 設定檔編輯頁面,顯示 General、Rule、Hosts、URL Rewrite、HTTPS Decryption 與 Add Rule
Config:在設定(Config)模式下,檢查目前使用的設定檔與 Rule。此圖為設定檔編輯頁面,並非 Global Routing 選擇頁面。

03 / CONNECT

開啟連線開關

確認伺服器、模式與系統權限,完成首次啟動。

返回 Home,先查看 SERVER 分組,確認選取的是本次預計使用的項目;再確認 Global Routing 是否維持第二步所選的模式。截圖頂部的 Not Connected 表示尚未連線。開啟頂部連線開關,等待狀態變化;操作期間先不要切換伺服器或重複點選開關,以便觀察完整的連線結果。

首次啟動時,系統可能會要求允許新增 VPN 設定。確認這是由 Shadowrocket 發起的操作後,依提示允許並完成裝置密碼或生物辨識驗證。此權限用於建立系統網路延伸連線,並非訂閱登入流程,也不會代為補齊伺服器資訊。如果先前取消授權,請返回用戶端重新發起連線,並依系統提示檢查是否已新增 VPN 設定。

如果裝置上已有其他正在運作的 VPN 連線,請先停止該連線,再重試目前流程,避免同時占用系統連線。受管理的工作裝置也可能受到組織限制;若看到無法新增或啟用 VPN 設定的提示,應檢查裝置管理規範,不要將所有權限問題都歸因於伺服器故障。

頂部顯示已連線後,也不要只憑狀態就結束檢查。連線狀態表示系統中的連線已啟動,並不能證明每個目標網站、每條規則與所有網路條件都正常。保持目前的伺服器與模式不變,進入下一步進行實際存取測試。如果開關立即返回關閉狀態,請記下當時的提示文字,再依第五步從系統權限與伺服器參數開始排查。

Shadowrocket Home 頁面,頂部為 Not Connected 開關,下方有 Global Routing、Connectivity Test、SERVER 分組與 Add Server
Home:先選擇伺服器與 Global Routing,再開啟頂部連線開關。接著可使用 Connectivity Test 檢查連線狀況。

04 / VERIFY

驗證連線是否生效

綜合檢視測試結果、實際存取與規則比對。

在 Home 執行 Connectivity Test,觀察所選伺服器是否有測試結果。測試反映目前測試方式與目標下的連線狀況,不能直接等同於瀏覽器、影片或其他應用程式的實際使用體驗。顯示延遲數值不代表驗證參數、目標網站存取與所有請求都正常;逾時也不一定表示伺服器完全無法使用,應搭配測試方式與網路環境判斷。

接著開啟瀏覽器,瀏覽自己明確需要使用的目標網站,確認頁面確實完成載入,而不只是顯示快取中的標題。盡量選擇可重複操作的頁面,並重新整理一次。返回 Shadowrocket,搭配 Data 中的流量變化或可用的連線記錄,檢查剛才的瀏覽是否產生新請求;流量增加只能作為線索,仍須一併判斷目標請求的策略。

使用設定(Config)時,應分別驗證預期走 PROXY 的請求與預期走 DIRECT 的請求。若只有其中一類異常,請檢查相應規則的條件與順序。網域解析產生的請求、頁面中的圖片與其他資源可能涉及不同網域,因此「主頁面能開啟」並不能證明頁面內所有資源都使用相同策略。

需要比較網路環境時,先在 Wi-Fi 下記錄結果,再切換至行動網路重複相同的存取操作。維持伺服器、模式與目標不變,一次只改變一個條件。測試完成後,將 Global Routing 還原為日常所需的模式。若只有在代理(Proxy)下正常,請繼續檢查設定;若兩種網路下都失敗,則將檢查重點轉回伺服器參數、服務狀態與錯誤提示。

05 / DIAGNOSE

依失敗階段檢查設定

停在發生錯誤的步驟,先縮小範圍,再修改參數。

匯入後沒有伺服器

先確認複製的是完整訂閱網址,而不是服務商的帳戶網頁。核對連結是否已過期、查詢參數是否遺漏,以及目前網路能否取得訂閱內容。如果傳回的是登入頁面或錯誤訊息,用戶端就無法據此產生伺服器項目。向既有服務商確認訂閱狀態與格式後,在原訂閱上重新更新;不要連續建立多個相同訂閱,否則之後難以分辨各項目屬於哪次匯入。

開關無法維持連線

先確認系統是否已完成 VPN 設定授權,再確認沒有其他連線正在使用而造成衝突。接著返回 Add Server,對照原始資訊檢查 Type、Host、Port 與驗證欄位;尤其留意遺漏連接埠、密碼尾端空格和選錯協定。需要 TLS 等參數的連線也應核對服務商要求的相關欄位,不要為了測試而任意關閉驗證。修改後儲存,再返回 Home 重新選取該項目測試。

顯示已連線,但頁面無法開啟

先區分「所有目標都無法開啟」與「只有某個網站異常」。保持伺服器不變,比較代理(Proxy)與設定(Config)的存取結果。只有設定(Config)失敗時,請檢查 Rule 順序、FINAL 的兜底策略,以及目前實際使用的設定檔;兩者都失敗時,重新核對服務狀態與協定參數,再檢查 DNS 或目前的網路條件。沒有記錄前,不要同時更改多項設定。

使用 Settings 收集必要資訊

進入 Settings,可看到 Test Method、On Demand、Diagnostics 等項目。Test Method 會影響連線測試的判斷方式,不應為了取得較小的數值而頻繁切換。首次排查時,可先停止 On Demand 的自動觸發,手動完成一次連線與中斷,排除自動重新連線對觀察結果的干擾;確認基本流程正常後,再恢復自己的隨選連線設定。

需要進一步定位時,可在 Diagnostics 查看可用的診斷資訊,記錄問題發生時間、網路類型、Global Routing 模式與錯誤文字。分享截圖或記錄前,請遮蔽訂閱網址、密碼、驗證欄位與其他帳戶資訊。只向相關支援人員提供必要片段,不要公開完整設定。更多問題請查看FAQ 分類說明;參數、規則與日常維護的系統說明請參閱從入門到進階的官方手冊。

完成排查後,再重做第四步的實際存取測試。還原日常設定前,確認臨時修改的模式、測試方式與 On Demand 設定是否仍符合需求。如此下次遇到問題時,就能從明確且已驗證的狀態開始,而不必重新猜測所有設定。

Shadowrocket Settings 頁面,顯示 Language、Test Method、Today Widget、On Demand、Diagnostics、Proxy、TCP 與 UDP
Settings:排查時請留意 Test Method、On Demand 與 Diagnostics;其他設定依實際需求調整。

首次連線後的下一步

保留已驗證的設定;再依實際需求了解規則、自動連線與維護。