官方手冊 / 首次連線

Shadowrocket 使用教學

依照「匯入 → 選擇模式 → 連線 → 驗證 → 排查」的順序操作。先完成一次可核對的連線,再整理規則與自動連線設定。

01Add Server / Subscribe:匯入既有資料

先確認手邊資料的類型,再選擇匯入方式。訂閱連結用於取得及更新一組伺服器;單一伺服器分享連結用於匯入一個項目;伺服器位址、連接埠與認證資料則須手動填寫。不要只因連結以 https:// 開頭,就認定它是訂閱;帳戶管理頁面、說明頁面與訂閱網址並非同一種內容。若不清楚連結用途,請先查閱原服務說明。

已有訂閱連結:使用 Subscribe

開啟 Shadowrocket,進入 Home,點選右上角的新增按鈕,開啟 Add Server。進入 Type,選擇 Subscribe,返回填寫頁面後,將完整訂閱連結貼到 URL。若需區分多個訂閱,可在 Remarks 填入自己容易辨識的名稱,再儲存。訂閱網址通常含有個人存取憑證,請勿張貼於公開討論區,也不要為了展示操作而公開完整連結。

儲存後等待訂閱請求完成,再返回 Home 查看是否出現相應的群組與伺服器項目。若看得到訂閱名稱,卻沒有伺服器,請勿直接進入連線步驟:先確認請求是否成功、連結是否仍有效,以及回傳內容是否為應用程式支援的訂閱資料。顯示訂閱名稱不代表已成功取得所有伺服器。

請區分 Subscribe 與 Config:前者用來匯入及更新伺服器資料,後者用來管理影響規則等行為的設定檔。初次使用不必先匯入陌生設定;已有訂閱,也不代表已取得符合需求的規則設定。伺服器清單出現後,先完成本頁的連線驗證,再依需要整理設定。

已有伺服器資料:使用 Add Server 手動填寫

若持有單一伺服器的資料,請在 Add Server 的 Type 選擇實際協定,例如 Shadowsocks、VMess、VLESS 或 Trojan,再依照現有資料填寫相應欄位。通常需要確認 Address 與 Port;認證欄位則依協定而異,可能是 Password 或 UUID。請勿將一種協定的欄位套用到另一種協定,也不要單憑連接埠號碼推測協定。

若現有資料包含 TLS、傳輸方式、Host、Path 或其他附加項目,請逐項對照填寫。伺服器位址與 TLS 使用的名稱可能各有不同用途,不要為了「看起來一致」而自行替換。資料不完整時,先停下來核對原始資料,比儲存猜測填寫的項目更容易找出問題。

已有分享連結或 QR Code:匯入後仍須核對

若有 QR Code,可使用 Scan QR Code,並在系統詢問時依需要允許相機權限;若有分享連結,可複製完整內容,再使用應用程式提供的剪貼簿匯入功能。掃描或解析成功,只表示資料可讀取,不代表伺服器目前可連線。儲存後仍須開啟項目,確認協定與位址,避免匯入過期資料或選錯項目。

本步完成條件:Home 中已有明確的伺服器項目,並已選定此次要使用的項目。此時先不要連續匯入更多資料;下一步確認 Global Routing。訂閱更新、多個群組與備份的詳細作法,請參閱節點管理手冊的 Subscribe 章節。

02Global Routing:選擇連線模式

伺服器決定連線目的地,Global Routing 則決定如何分配連線。返回 Home,點選 Global Routing,先查看目前選項,再依此次用途調整。入門時先認識三種模式:Config(設定)、Proxy(代理)、Direct(直連)。這些是路由選擇,不是三種不同伺服器,也不會改變既有訂閱的有效狀態。

Config(設定):依目前設定規則處理

Config(設定)適用於需要依規則分流的情況。應用程式會根據目前啟用設定中的規則,決定使用 PROXY、DIRECT 或 REJECT 等策略,因此並非所有連線都會經過所選伺服器。進入 Config 時,請分清「清單中已有的檔案」與「目前實際啟用的檔案」;只匯入檔案但未啟用,不能據此判定規則已生效。

選擇 Config 後,若部分網頁能開啟、部分無法開啟,先記錄差異,不要立刻認定訂閱無效。規則通常由上而下比對,符合條件後套用相應策略;前面都未符合時,才由 FINAL 作為後備。特定網域採用 DIRECT 還是 PROXY,須查看目前規則,不應只憑連線開關狀態判斷。

Proxy(代理):用來檢查代理連線路徑

Proxy(代理)可作為初次確認所選伺服器的簡易對照。在此模式下檢查通常由應用程式接管的代理流量,可減少一般規則分流對判斷的干擾。若日常打算使用 Config,可先用 Proxy 確認基本連線,再切回 Config 比較同一網頁。Proxy 不是修正伺服器資料的開關,也不代表所有應用程式的網路行為都一定以相同方式處理。

Direct(直連):作為直接連線對照

Direct(直連)用於直接連線,不適合拿來驗證代理伺服器是否可用。若 Direct 能開啟某網頁而 Proxy 無法開啟,表示兩條連線路徑的結果不同,需進一步檢查所選伺服器及相關設定;反之,也不能因 Direct 失敗就認定整台裝置已無網路。比較時請使用同一個測試目標。

本步完成條件:能說明此次選擇的模式及原因。初次確認伺服器時可先使用 Proxy;已有明確規則需求時則使用 Config。選擇後返回 Home,繼續完成連線授權。規則與設定項目的詳細說明,請參閱功能說明。

03Home:開啟連線開關並授權

在 Home 再次確認:所選項目是剛匯入的伺服器,Global Routing 也是剛才選定的模式,接著開啟頁面上方的連線開關。首次啟用時,系統可能提示 Shadowrocket 要新增 VPN 設定。這是將網路設定交由系統管理的授權步驟,不是訂閱付款提示,也不代表伺服器已通過可用性檢查。

確認系統提示中的應用程式名稱,確定操作是由自己剛開啟的 Shadowrocket 發起,再選擇允許,並依系統指示完成裝置驗證。驗證應在裝置的系統介面中完成;教學與匯入訂閱都不需要將裝置解鎖憑證交給他人。授權完成後返回 Shadowrocket,確認開關是否維持開啟,以及應用程式是否顯示相應的連線狀態。

若先前拒絕新增設定,或開啟開關後立即關閉,先留意系統是否還有待處理的提示。必要時前往系統 Settings 查看 VPN 設定狀態,再返回應用程式重試。不同系統版本的設定路徑可能不同,請以裝置目前顯示的選單為準。請勿為了嘗試連線而任意刪除不熟悉的受管理設定。

若裝置上已有其他 VPN 連線,請先確認目前實際啟用的是哪一項,避免另一項仍在運作時測試 Shadowrocket。初次操作也請先維持 On Demand 設定不變;自動觸發連線會增加觀察變因,待手動連線與中斷都確認正常後,再設定自動連線。

本步完成條件:已完成系統授權,且應用程式開關能維持開啟。此處只確認本機連線流程已啟動,不應以系統 VPN 標示或開關開啟,當作遠端存取成功的證明。下一步須以實際連線請求驗證。

04Connectivity Test:搭配實際瀏覽驗證

先在 Home 使用 Connectivity Test 檢查既有伺服器,再切換到 Safari,開啟平時使用且可正常存取的網頁。測試結果與網頁載入情形各自反映不同環節:前者協助判斷測試目標是否可達,後者才是此次實際瀏覽的結果。不要將單次測試成功解讀為所有網站、協定與規則都正常。

確認網頁是否完整載入、頁面中的連結是否能繼續開啟,不要只看先前快取的標題或圖片。可以重新載入頁面,或開啟該網站中先前未瀏覽過的頁面。若只因舊頁面仍顯示就下結論,瀏覽器快取可能會掩蓋實際連線問題。

接著返回應用程式檢查 Global Routing。若目前使用 Config,請查看連線記錄,確認測試網域套用的是 DIRECT、PROXY 還是 REJECT。網頁成功開啟不一定代表流量經過代理,因為規則可能讓它直接連線;網頁無法開啟,也可能是該網域符合 REJECT,而不是伺服器中斷。

需要比較模式時,維持同一台伺服器與同一個測試網頁,只切換 Config 或 Proxy 其中一個變因,再重新發出請求。若 Proxy 正常而 Config 異常,優先檢查目前啟用設定中的規則與 DNS 設定。若兩種模式都失敗,先回頭檢查伺服器與基本連線,不要立刻重寫整份設定。

Data 中的變化可作為應用程式曾處理流量的輔助線索,但有流量記錄不代表目標網頁已正常回應。較可靠的判斷方式是同時核對開關狀態、實際網頁載入情形、目前模式與相關連線記錄,並確認這些資訊彼此吻合。

本步完成條件:實際網頁可依預期存取,且能說明目前模式採用的連線路徑。驗證後請恢復日常使用的模式;更換網路或伺服器後若發生異常,再重做此步驟即可,不必從購買與安裝重新開始。

05常見問題:依發生環節排查

排查時每次只調整一項,並記錄修改前後的結果。可記下「所選伺服器、Global Routing、測試網頁、是否出現系統提示、失敗發生在哪個步驟」,但不要記錄或公開完整認證資料。這樣便於自行複查,也能避免反覆切換設定後忘記最初的問題。

匯入後沒有項目

先回到第一步確認連結類型。若將帳戶網頁當成訂閱網址,即使應用程式能開啟該網頁,也無法從中取得正確的伺服器資料。檢查貼上內容是否漏掉開頭、結尾或查詢參數,是否多了空格,以及訂閱是否仍有效。手動新增項目時,請確認已儲存,而非只退出編輯頁面。不要為了取代錯誤檢查而反覆新增相同連結。

開關無法維持開啟

先檢查系統授權與本機設定狀態,確認新增 VPN 設定的步驟已完成,並查看是否有其他連線影響目前狀態。此階段尚未完成本機連線流程,優先調整 DNS 或規則通常無法解決問題。若裝置受管理,請依裝置管理規定處理,不要任意移除設定。

開關已開啟,但所有測試都失敗

確認目前選取的伺服器是否正確,再檢查位址、連接埠、協定與認證欄位是否符合既有資料。訂閱能更新,與其中某台伺服器可正常使用是兩回事;Connectivity Test 失敗時,也應搭配實際連線請求再次確認。若自己的訂閱中還有其他已知可用項目,可維持相同模式與測試網頁,只更換伺服器進行比較。項目是否有效,請依自己的服務資料確認。

Connectivity Test 正常,但網頁無法開啟

先確認測試目標與實際瀏覽的網頁並不相同,再檢查問題是否只在 Config 模式發生。網域解析、規則比對、遠端回應及測試方式差異,都可能造成這種情況。前往相關設定前,先記下原本的值,並確認 DNS 是否設為自訂,以及設定是否針對該網域套用特殊規則。尚未找出原因前,不要同時更換 DNS、伺服器與整份設定,否則無法判斷是哪項調整發揮作用。

只有部分網頁或功能無法使用

保留可正常存取的頁面作為對照,再檢查無法使用的頁面涉及哪些網域及其套用策略。同一網頁可能會連線至多個網域,因此即使首頁能開啟,圖片或登入功能失效時,仍須檢查相關請求,而不只是網址列中的單一網域。比較 Proxy 與 Config 有助縮小範圍,但最後仍須核對實際記錄與設定內容。

中斷連線後又自動連線

檢查是否已啟用 On Demand,以及觸發條件是否符合目前網路狀況。若初次使用就設定自動連線,手動中斷後的狀況容易被誤認為開關故障。先恢復為可手動觀察的狀態,確認連線、瀏覽與中斷三個動作都符合預期,再單獨設定 On Demand。

本頁供初次操作與快速查找問題使用。遇到狀況時,可從上方目錄直接返回相應步驟,不必反覆重新安裝應用程式,也不要在尚未確認問題環節前一次更改所有設定。