Shadowrocket 使用手冊
首次連線可先依照使用說明快速上手。本手冊供系統性查閱:除了說明各步驟的操作方式,也會解釋如何確認設定生效,以及發生問題時應回到哪個步驟檢查。安裝章涵蓋所有平台,後續介面操作以 iPhone / iPad 為例。
- 01–03 · 取得與準備
- 04–06 · 路由與驗證
- 07–08 · 設定與維護
依裝置取得與安裝
先確認裝置與安裝管道,再處理系統提示。iPhone / iPad 版請從 App Store 取得,美國 App Store 售價 $2.99,一次性付費;系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片與 Intel 版)、Windows、Android、Linux 版免費,安裝檔可從本站全平台下載頁的對應平台卡片取得,檔案由本站 /dl/shadowrocket/ 提供。客戶端一次性買斷不等於線路方案。本站不提供、不販售或推薦節點與訂閱;第三章使用的是你已有的伺服器資料或訂閱。
在 App Store 核對開發者與購買帳號
開啟App Store 產品頁,核對以下三項:開發者名稱為 Shadow Launch Technology Limited、產品連結中的 App ID 為 932747118,以及 App 圖示與本站頁首的官方圖示一致。只看名稱或搜尋結果縮圖並不足夠;同名項目可能排在前面。確認後再進行購買,最終金額與幣別以帳號所屬商店的結帳頁面為準。
同一購買帳號可在支援的 iPhone 和 iPad 上使用已購項目。若在新裝置上看到購買按鈕,請先確認 App Store 使用的帳號是否為原購買帳號,不要只憑系統設定顯示的姓名判斷。搜尋不到 App 時,先查看商店與帳號地區說明,釐清是商店未顯示、裝置不符合系統需求,還是帳號與原購買帳號不同。這三種情況的處理方式各異,重複搜尋無法解決帳號問題。
選擇正確安裝檔,再處理安全提示
Mac 先開啟「關於這台 Mac」:若看到「晶片」及 Apple 晶片型號,請選 Apple 晶片版;若看到 Intel 處理器,請選 Intel 版。兩版皆為 DMG。Windows 請確認系統類型,並使用對應的 64 位元安裝程式;Android 請先確認裝置支援 arm64。Linux 請先確認發行版與套件格式:使用 DEB 或 RPM 的系統,優先選擇相符套件;若要以獨立檔案執行,再選 AppImage。檔名或圖示相似,不代表架構相容。
| 系統 | 安裝方式 | 出現提示時 |
|---|---|---|
| Mac | 開啟對應的 DMG,將 App 移至「應用程式」,再從該資料夾啟動。 | 確認檔案來自本站,且系統僅提示無法驗證開發者後,再前往「隱私權與安全性」,對該 App 選擇「仍要打開」。 |
| Windows | 執行符合架構的安裝程式,完成後從開始功能表開啟。 | 若 SmartScreen 僅提示發行者未知,且已確認來源與檔案無誤,可選擇「更多資訊」→「仍要執行」。 |
| Android | 從已下載的檔案啟動安裝,並確認安裝提示所列的是 Shadowrocket。 | 依系統提示,為這次用來開啟檔案的瀏覽器或檔案管理員啟用「允許安裝未知應用程式」,完成後關閉此授權。 |
| Linux | 使用系統軟體安裝工具開啟相符的 DEB 或 RPM;AppImage 可在檔案屬性中授予執行權限後執行。 | 若系統提示架構或相依套件不符,請回到下載頁確認套件格式與系統環境,不要強制略過相依性檢查。 |
桌面版與 Android 安裝檔未提供程式碼簽章,系統可能顯示來源確認提示;是否出現允許執行的選項,取決於系統版本與管理政策。若 Mac 一直從已掛載的磁碟映像啟動,退出映像後允許執行的選項可能失效,請先確認 App 是否確實已複製。Windows 若執行後沒有出現安裝畫面,請先確認檔案是否下載完成,以及系統是否明確阻擋啟動。Android 若在安裝完成前取消,回到下載清單重新開啟原檔即可,不必為多個 App 同時開啟安裝權限。
安裝完成的判斷標準,是能從系統正常入口啟動客戶端;此時尚未驗證伺服器或流量路徑。舊裝置已有設定,但在新裝置開啟後清單空白,不代表安裝檔有問題。購買紀錄、App 本身與使用者設定資料應分別處理。確認客戶端可啟動後,再進入下一章設定 iPhone / iPad 的系統授權。
首次啟動與系統權限
能開啟 Home 只代表 App 已啟動;若要讓系統交由 Shadowrocket 處理連線,還需要 VPN 設定檔。首次嘗試連線時,系統可能會顯示新增 VPN 設定檔的確認視窗。請確認要求確實來自剛開啟的 Shadowrocket,再於需要使用時允許。若系統要求解鎖裝置或驗證身分,依照系統提示完成即可,不需要將鎖定畫面密碼填入客戶端的伺服器欄位。若清單為空且開關要求先選擇伺服器,請先完成第三章,再於第五章正式連線時處理授權提示。
分清 VPN 設定檔、規則檔與伺服器資料
系統 VPN 設定檔決定客戶端能否透過系統 VPN 機制接收流量;客戶端 Config 中的規則檔決定流量進入客戶端後依哪些條件處理;伺服器項目則儲存連線至遠端所需的位址、協定與驗證參數。三者缺少任何一項,影響的環節都不同。刪除伺服器不會刪除系統 VPN 設定檔;在系統設定中移除 VPN 項目,也不會一併清除 Config 中的規則檔。看到名稱含有「設定」時,請先確認操作對象。
允許授權只代表系統同意建立或使用該項目,不代表目前伺服器可連線,也不代表測試請求符合預期規則。拒絕授權時,客戶端通常仍可開啟,匯入的資料也會留在清單中,但無法透過這次操作啟用相應的系統連線。若要重新授權,請回到 Home,確認選取的伺服器後再次發起連線。與其先刪除所有項目,不如先確認系統是否曾為這次要求顯示確認視窗。
在系統設定中確認連線所屬項目
可在 iPhone 或 iPad 的系統設定中搜尋 VPN,或在「一般」中的 VPN 與裝置管理相關頁面查看。不同系統版本的選單位置可能不同,請以裝置實際顯示為準。先確認目前顯示已連線的是哪個項目,再回到 Home 對照開關。系統狀態區域顯示 VPN,只代表存在相應的系統連線狀態;不能單憑此標記判定連線屬於 Shadowrocket,也無法據此推斷特定請求是否經過遠端。
若手機上已有工作 VPN 或其他由組織部署的設定檔,請勿為了排查問題而直接刪除。先記下目前連線的項目、是否由組織管理,以及是否啟用自動連線。若允許自行切換,可暫時中斷其中一項,再測試 Shadowrocket,並於測試結束後恢復原本的工作狀態。若系統設定顯示裝置受管理或不允許變更,請先詢問裝置管理員,不要反覆移除現有項目或變更裝置限制。
依需要授予匯入相關權限
使用 Scan QR Code 時,系統可能會詢問相機權限,因為匯入需要讀取鏡頭前的 QR Code。不使用掃描時,可改為手動輸入,或依目前介面支援的方式匯入已有資料。若系統在貼上時要求確認,只有在準備匯入且確定剪貼簿內容是自己的連結時才允許。拒絕相機或貼上權限,影響的是對應的匯入方式,不等於拒絕 VPN 授權。訂閱網址與 QR Code 可能含有存取憑證,請勿為了排查而拍下後交給其他工具辨識。
若確實需要重建系統項目,請先中斷連線、記下目前選取項目並備份本機資料;在系統設定中確認要移除的是 Shadowrocket 對應項目後,再移除並回到客戶端重試。請勿誤刪名稱相似的組織設定檔。權限提示及處理方式也可參閱新增 VPN 設定檔的疑難排解。繼續下一步前,只要先分清三種狀態:App 可以開啟、系統權限尚待確認或已允許、伺服器資料尚未匯入或已準備就緒。
新增伺服器與匯入訂閱
單筆伺服器資料請使用 Add Server;若要透過訂閱網址管理一組項目,則選擇 Subscribe。兩者都需要你已有相關資料。若取得的是單筆匯入連結或 QR Code,應依其實際類型選擇匯入方式;不能因為內容是網址或可掃描,就認定它是訂閱。新增前先確認協定、伺服器位址、連接埠與驗證資料;不確定的欄位請向資料提供者確認,不要輪流嘗試不同協定猜測。
在 Add Server 中逐欄填寫
- 在
Home開啟新增入口,再選擇Add Server。先選擇與資料相符的協定,介面才會顯示對應欄位。切換協定後,請重新檢查已填內容,不要假設原有欄位會自動轉換成等效設定。 - 輸入伺服器位址與連接埠。位址欄通常填主機名稱或位址,不要連同完整訂閱網址、路徑或連接埠分隔符號一起貼上;連接埠請依資料分開填寫。貼上後檢查前後空白,以及是否混入全形符號或錯誤的數字、字母。
- 填入協定所需的驗證資訊與其他參數。若資料有註明傳輸方式、路徑、TLS 或 SNI,請逐項填入對應欄位。未提供的選填項目,不要照抄其他伺服器的設定。最後替項目取一個不含憑證、且能辨認用途的名稱。
- 儲存後返回
Home,在SERVER確認項目已出現,並確認選取的是剛才核對的項目。清單中出現項目不代表系統連線已建立。首次驗證時先確認這一筆,避免在多個同名項目之間反覆切換。
常見協定的欄位差異
| 協定 | 優先核對項目 | 容易混淆之處 |
|---|---|---|
| Shadowsocks | 位址、連接埠、加密方式與密碼。 | 密碼正確,不代表加密方式可以互換。 |
| VMess / VLESS | 辨別兩種協定,核對識別資訊、傳輸方式與所需的 TLS 參數。 | 兩者都可能使用 UUID,但同一個 UUID 不能取代協定選擇。 |
| Trojan | 位址、連接埠、密碼與 TLS 相關參數。 | SNI 用於 TLS 交握時的伺服器名稱,不是項目備註,也不一定與連線位址相同。 |
| HTTP / SOCKS5 | 協定類型、位址、連接埠,以及資料要求的驗證資訊。 | 使用同一台主機,不代表服務使用相同連接埠或接受相同協定。 |
連線失敗時,先比對原始資料中的欄位,不要把顯示名稱當成主機名稱,也不要把訂閱密碼當成個別伺服器的驗證資訊。若 TLS 項目出現名稱或憑證錯誤,優先確認裝置時間、SNI、目標位址與伺服器資料是否一致,不要把放寬憑證驗證當成一般修復方式。若要逐項了解 TLS 參數,可參閱Trojan 參數說明。
訂閱更新後確認清單與選取項目
選擇 Subscribe 後,貼上你已有的完整訂閱網址並儲存,等待客戶端讀取清單。保留網址中的查詢參數,不要隨手刪除看似多餘的字元。匯入失敗時,先分辨三種情況:網址輸入不正確、請求未取得有效回應,或已收到回應但內容未被辨識為伺服器清單。網路正常仍失敗時,可確認訂閱是否已變更或過期,以及取得的內容是否為登入頁;不要將含憑證的完整網址貼到線上檢測服務。
看到清單後,記下訂閱名稱與目前選取的項目,再使用介面提供的更新功能重新整理。更新可能變更名稱、參數與項目數量;更新前後同名的項目不一定是同一份設定,原先選取的項目也可能已不存在。此時先選擇一筆明確可用的項目,再繼續驗證。若舊清單仍可用但更新失敗,先保留舊資料;刪除訂閱再重新新增會減少比對線索,也可能讓仍可用的項目一併消失。
Global Routing 三種模式與規則順序
Global Routing 決定由誰選擇流量路徑。日常依規則分流時選擇設定檔(Config);暫時檢查代理路徑時選擇代理(Proxy);想以客戶端接管後的直連路徑作為對照時,選擇直連(Direct)。切換前先記下原本的選項,完成對照測試後再恢復。此處說明適用於進入客戶端且受該模式影響的連線;系統流量例外、區域網路設定或其他設定造成的差異,不代表規則失效。
三種模式的適用範圍
| 介面選項 | 路徑決定方式 | 使用方式 |
|---|---|---|
| Config | 依據有效設定檔中的規則進行比對,並執行命中的動作。 | 確認目前生效的是哪份設定檔,再判斷特定網域的流量路徑。 |
| Proxy | 採用代理路徑,不依設定檔逐條選擇 DIRECT 或 PROXY。 | 暫時比較代理路徑是否可用,完成後恢復原模式。 |
| Direct | 適用流量採直連處理,不轉送至所選代理伺服器。 | 用於比對路徑;它並不是關閉連線的開關。 |
請留意兩處同名的 Config:一處是 Global Routing 中的模式選項,另一處是管理與選取設定檔的介面。前者只表示依規則運作,後者才決定讀取哪份檔案。編輯副本後請儲存,並再次確認目前選取的是該副本。若使用遠端設定檔,更新也可能覆蓋其中內容;想長期保留本機修改,請先另存副本,並明確指定日常連線使用哪一份。
由上而下閱讀規則片段
以下是用來說明規則順序的 .conf 片段,並非完整的日常設定。請與已有設定檔比對,不要覆寫自己的規則檔;其中的 example.com 僅為範例。符合條件的規則會依序比對,通常由第一條命中的規則決定動作。越具體的例外應放在較廣泛的比對條件之前;未命中前面規則的流量,才會由最後的 FINAL 處理。
[Rule]
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,PROXY
第一條規則只比對 docs.example.com,因此這個特定主機會直連;其他屬於 example.com 的名稱則可能由下一條網域後綴規則送往代理。若將後綴規則移到前面,文件主機也會先符合該規則,後面的精確例外便不會生效。GEOIP 依目標 IP 的地理資料庫分類,與網域後綴、使用者所在地或內容發布地點不同。FINAL 是預設動作,前面已命中的請求不會再交由它處理。
DOMAIN 適用於單一完整主機名稱;DOMAIN-SUFFIX 適用於一組同網域名稱;DOMAIN-KEYWORD 會比對包含指定關鍵字的名稱,關鍵字太短容易涵蓋原本無關的主機。IP-CIDR 和 IP-CIDR6 分別表示 IPv4 與 IPv6 位址範圍。客戶端是否取得目標網域,以及是否需要解析目標位址,都會影響相應條件能否命中。不要把網域規則與位址規則視為同一資訊的兩種寫法。
先確認動作,再判讀結果
PROXY 表示將命中規則的流量交由代理路徑處理,DIRECT 表示不經遠端代理,REJECT 表示拒絕該連線。拒絕不代表遠端離線,直連也不保證目標一定可連線。網頁通常會向多個主機發出請求:若主要內容正常,但圖片或登入失敗,應檢查實際失敗的目標,而不只是網址列中的主網域。測試時請發起新請求;既有連線可能仍沿用原路徑,不能據此判定新規則未生效。
建立連線與分層驗證
連線驗證需確認三件事:系統是否已接管、指定路徑是否可用,以及實際存取的目標是否依預期處理。回到 Home,確認 SERVER 中選取的項目與剛核對的資料一致,再檢查 Global Routing。開啟連線開關;首次出現系統 VPN 設定檔提示時,依第二章處理。待系統狀態穩定後再測試。若開關彈回關閉,先記下從點擊到關閉期間看到的提示,不要快速連按,以免難以辨認第一次失敗時的訊息。
先比對基本網路,再測試伺服器
暫時關閉連線,在同一個 Wi-Fi 或行動網路上開啟平常可直接存取的頁面,作為基本網路對照。若 Wi-Fi 需要先在系統頁面確認已連線,請先完成該步驟。直連對照也失敗時,應優先排除裝置網路問題;此時更換伺服器無法證明基本網路已恢復。對照時保持相同裝置、網路與目標,並盡量連續完成,避免把切換網路造成的變化誤認為客戶端設定的效果。
基本網路正常後,再使用 Connectivity Test 檢查選取的伺服器。單次測試成功只代表該次探測及其目標可用,不代表所有服務請求都正常;單次逾時也可能是測試目標無法連線或目前網路不穩。記下測試時間、伺服器名稱與網路類型,稍候片刻再測一次。若只有這筆紀錄持續失敗,先依原始資料核對位址、連接埠、協定與驗證資訊。多個項目同時失敗時,先確認它們是否共用資料來源、主機或網路環境,再判斷是否需要逐項修改。
以相同目標比對三種結果
- 在原本的
Config模式下發出新請求,記錄實際失敗的網域或可見錯誤;若主頁可開啟,繼續確認失敗的是資源載入還是登入操作。 - 若該目標適用且允許使用代理路徑,可短暫切換至
Proxy,並保持伺服器不變。若相同目標在此模式成功、在Config中失敗,應優先檢查有效設定檔與規則命中順序,不宜先修改伺服器。 - 在目標允許直連的前提下,再使用
Direct或關閉開關作為對照,並記錄兩種操作的差異。不要用原本就要求特定路徑的目標來判斷基本網路是否正常。測試結束後恢復原模式,並重新建立要驗證的實際請求。
盡量從新頁面或 App 的新工作階段發起請求,避免把離線快取、仍存續的背景連線或瀏覽器還原的舊內容當成新請求成功。需要跨網路確認時,先在第一種網路完成對照,再切換至第二種網路,從基本測試重新開始。不要同時更換網路、伺服器與規則;即使恢復正常,也無法判斷是哪一項改動產生效果。
依症狀縮小排查範圍
| 現象 | 優先檢查 | 下一步 |
|---|---|---|
| 開關無法維持開啟 | VPN 授權、選取的伺服器與其他系統 VPN 項目。 | 先讓系統連線成功建立,不要先編輯規則。 |
| 開關已開啟,但測試持續逾時 | 基本網路、伺服器連接埠與協定參數。 | 保持其他條件不變,改用另一筆已核對的紀錄作為對照。 |
| 測試成功,只有特定目標失敗 | 目標解析結果、命中的動作與 App 錯誤訊息。 | 使用相同目標比對不同模式,再判斷要檢查規則或伺服器端。 |
若錯誤訊息顯示網域解析問題,先確認失敗的是伺服器主機名稱還是服務目標名稱:前者可能使遠端連線無法開始,後者則可能只影響部分存取。若顯示驗證失敗,排查重點已不同,應回到第三章核對參數,不要先大量修改規則。若只有特定服務的帳號或工作階段出現錯誤,也應先辨認服務本身的提示,不要把所有訊息都歸類為網路故障。
在 Data 查看與解讀流量
Data 用來查看客戶端記錄到的流量,可協助判斷某段操作是否產生流量,以及哪些變化值得進一步檢查;但它無法單獨指出流量由哪個 App 消耗,也不等於電信帳單或訂閱服務端的用量。使用前先確認目前畫面顯示的是累計值、特定時段的結果,還是某分類的數值。若介面提供分類,前後比較務必使用相同範圍、方向與單位。畫面未顯示的維度,不要由總量推算。
建立短時間基準值
- 記下開始時間、網路類型、選取的伺服器與
Global Routing模式,開啟Data並記錄相關數值。不要急著清除所有統計資料,先前的紀錄可能有助於解釋變化。 - 先觀察一小段時間,不主動存取內容,看看數值是否持續增加。同步、推播與 App 背景活動都可能造成變化;若基準值本身持續增加,之後便不能把全部差值歸因於手動開啟的頁面。
- 只進行一項容易重現的小操作,例如重新開啟內容簡單的文件頁面;等請求完成後回到
Data。以相同口徑的結束值減去開始值,記下該時段的差值。若介面尚未更新,稍候再讀取一次。 - 若要比較另一種模式,先恢復穩定狀態,再進行一輪相同類型的操作。快取、網路檢查與既有連線都可能讓兩次請求的內容不同;差值適合協助排查,不適合作為精確的逐位元組測量。
若頁面看起來已成功開啟,但數值沒有變化,先確認頁面是否直接顯示快取,再檢查統計範圍是否包含目前連線,以及數值是否尚未更新。若介面分別顯示上傳與下載,小型請求可能只有單一方向出現明顯變化。讀數為零不代表目標一定採直連,也不代表裝置沒有連線。要判斷流量處理方式,仍須回到 Global Routing、有效規則與可用的連線紀錄進行確認。
區分客戶端、系統與服務端的統計口徑
客戶端記錄的是它能觀察或歸入相應分類的流量;系統的行動網路用量依裝置系統口徑統計,可能包含未經客戶端處理的連線;訂閱服務端的紀錄則取決於對方的計量與更新方式。三方的統計起點、時間範圍、網路類型與上下載方向都可能不同。比較前先對齊時段,確認單位是否一致、是否將上傳與下載相加,以及是否只查看行動網路流量。僅憑兩個總量不同,不能判斷重複計費或流量遺失。
例如,從 Wi-Fi 切換至行動網路前後,Data 的累計值可能持續增加,但系統的行動網路統計只涵蓋後半段。又例如,同一帳號仍在另一部裝置上使用,服務端的合計用量便可能高於這部裝置所顯示的數值。若要核對帳單,請保留日期範圍、相關數值與當時的網路類型,並向相應計量方確認;調整客戶端的顯示範圍不會改變既有帳單的計算方式。
持續增加、讀數停滯與清除紀錄
沒有主動操作但流量持續增加時,先檢查是否有下載、播放媒體、同步或背景更新;逐項暫停,並留出時間觀察每次變化。不要一次關閉所有背景功能,否則即使數值下降,也難以找出原因。若只在切換網路時增加,請回到連線驗證章,確認網路恢復時是否發生重試或自動重新連線。流量變化只能提示排查方向,不能只憑數值判定是哪個 App 所致。
讀數停滯時,先確認系統連線仍在、頁面不是舊工作階段,以及測量的請求確實是新發出的。若需清除歷史資料,先保存足以比對的時間點與總量,再使用目前介面提供的清除功能。清除客戶端紀錄不會刪除系統 VPN 設定檔,也不會重設電信業者或服務端用量。提供排查資料前,請遮蔽目標網域、不必要的存取時間細節與伺服器資料;多數情況只需提供區間差值與連線現象。
Settings 常用項目與變更範圍
進入 Settings 前,先確認手動連線在常用網路上運作正常。自動觸發、測試參數與匯入偏好都應以這個可重現的基準為前提。記下修改前的值,每次只變更一項,並確認能還原原設定後再測試。若目前介面沒有某個選項,請依裝置實際可用的選項操作;不要照搬另一部裝置的操作路徑,也不要為了尋找開關而清除有效設定。
On Demand 決定何時連線,不負責流量分流
On Demand 用於在符合條件時觸發系統連線。它與 Global Routing 的功能不同:前者關係到系統是否嘗試建立 VPN 連線,後者則決定流量接管後的路徑。啟用按需連線不會自動將 Direct 切換成 Config,也無法讓失效的伺服器恢復連線。設定前先確認希望在哪類網路觸發、在哪類網路維持原狀,再檢查目前介面是否能設定這些條件。
調整後分別測試希望觸發與不觸發的情境。每次切換網路後,等系統網路狀態穩定,再查看系統 VPN 狀態與 Home;不要將切換網路後短暫等待誤認為觸發失敗。若離開客戶端或手動中斷後連線又重新出現,先確認是否符合按需條件,或系統中是否有另一項設定正在自動連線。若正在排查手動連線問題,可暫時停用按需觸發並記下原設定,待手動連線驗證成功後再恢復。
檢查測試目標,區分整體故障與探測失敗
使用 Connectivity Test 時,應保持測試目標不變,再比較不同伺服器。若目前介面允許變更測試目標,優先選擇你有權存取且能穩定回應的目標,並先確認該目標在適用網路上可用。不要只憑多次測試中的單一時間數值判斷伺服器優劣;測試目標、無線訊號與請求類型都會影響結果。實際遇到服務故障時,仍應重現服務本身的請求,不能以探測成功取代實際驗證。
遇到逾時時先檢查目標與目前網路。延長等待時間有時只會讓介面晚一點回報失敗,無法解決位址錯誤、解析失敗或驗證不符。若介面提供診斷記錄,請依單次操作的時間範圍篩選;比較第一次錯誤與後續重試,不要直接把最後一行提示當成根本原因。例如先出現網域解析錯誤,後續逾時可能只是連鎖結果,此時修改規則末尾的預設動作未必有幫助。
判斷應在 Settings 還是 Config 中修改
若要調整特定網域的流量路徑,請到 Config 檢查規則檔;若要修改遠端參數,請回到 SERVER 的對應項目;若要改變系統觸發時機,再查看 On Demand。DNS 相關問題也應先檢查目前生效的設定與系統環境,不要把設定頁中名稱相似的選項視為同一功能。例如,某網域解析成功但遭規則拒絕時,修改 DNS 不會讓拒絕動作變成直連。反之,若目標尚未取得可用的解析結果,也不能只憑預期規則就斷定 App 已連上目標位址。
使用介面中的 Import from Cloud JSON 等匯入功能前,先確認取得的是相應格式的備份,而非一般訂閱網址。匯入後分別確認設定檔、伺服器選取項目與自動連線條件,避免直接將另一部裝置的環境當作目前裝置的基準。若出現覆寫或合併提示,先確認影響範圍再決定;備份檔可能含有連線憑證,請存放於受控位置,不要透過公開連結傳送。
更新、移轉與還原
維護時請分開處理 App 更新、訂閱更新與規則變更。App 更新會變更客戶端程式;訂閱更新會變更目前網址提供的伺服器清單;規則變更則會改變請求的比對方式。應先在原本正常的狀態下記錄基準:設定名稱、Global Routing、選取的伺服器、是否啟用 On Demand,以及一個已驗證的存取目標。每次只進行一種更新,完成對應檢查後再進行下一項。否則一旦連線異常,就必須同時排除三類變更。
更新前保留可還原的資料
iPhone / iPad 請透過 App Store 檢查 App 更新;Mac、Windows、Android、Linux 請從全平台下載頁重新取得對應安裝檔。桌面裝置即使是原本使用的電腦,也不要省略套件格式與架構確認;移轉裝置時尤其要重新確認 Mac 的晶片類型。訂閱更新與 App 更新互不替代,規則副本也不一定會隨訂閱更新。請先確認保存的資料足以還原,而不只是伺服器清單的截圖。
保存本機規則檔的可讀副本,並區分日常使用版本與待驗證版本;訂閱資料只需存放在受保護的位置,不要把伺服器密碼寫進一般維護筆記。若資料提供者已停用原網址,備份只能保留舊狀態,無法讓失效憑證恢復。更新後先進行小範圍檢查:確認客戶端能啟動、選取的伺服器仍有效,且原測試目標符合預期規則動作;確認完成後,再恢復自動連線或進行下一項維護。
換機時分別處理安裝、還原與授權
在新的 iPhone 或 iPad 上,先使用原購買帳號尋找 App,詳見重新下載已購項目的步驟。找回客戶端不等於找回連線資料,也不代表新裝置會繼承舊裝置的系統 VPN 設定檔。接著依保存的資料還原設定或訂閱,確認選取項目,再於新裝置上回應系統授權提示。若舊裝置仍在手邊,請保留其中有效資料,直到新裝置完成實際存取測試。
從一部裝置移轉到另一種系統時,先依該系統取得 Shadowrocket,再確認目前介面是否支援匯入資料。不要假設系統權限、連線觸發條件或所有 App 內偏好都會隨檔案移轉。測試時可讓兩部裝置先連上同一個允許測試的網路,各自使用一筆已確認的資料,從手動連線開始。確認新裝置運作正常後,再清除不再使用裝置上的敏感連線資料,或依管理要求處理舊裝置。
發生異常後,依最近一次變更逐步還原
若編輯規則後發生問題,切回上一份已驗證的設定檔,保持伺服器不變,並以相同目標再次測試;若更新訂閱後出錯,先確認原選取項目是否遭替換或刪除,不要急著覆寫本機設定;若調整按需觸發後出錯,先停用觸發,再以手動連線重新測試。還原時不要把「改用舊設定檔」與「重設所有系統 VPN 項目」混為一談。前者用來檢驗檔案變更,後者涉及重新設定權限,會增加另一個變因。
若無法回到原本狀態,請整理排查紀錄,包含時間、網路類型、系統連線狀態、目前模式、錯誤提示與最近一次變更。如需查看相關問答,可閱讀新手常見十問;若連線異常仍可重現,請依連線與驗證章逐層比對。恢復正常後,將實際有效的設定作為新基準,並確認排查時暫用的 Proxy 或停用的自動觸發狀態沒有在不知情的情況下留在裝置上。
維護常見問題
訂閱更新後,找不到原先選取的伺服器怎麼辦?
先在更新後的清單中核對備註、協定與可辨認的位址,不要依清單位置猜測。同名但參數已變更的項目應視為新項目重新驗證;確認原項目已移除後,請選擇另一筆你已有且已核對的資料。客戶端無法代替資料提供者恢復已停用的項目。
重新安裝能解決規則未命中的問題嗎?
通常應先確認 Global Routing 是否選擇 Config、規則檔是否生效、是否有較寬泛的規則先命中,以及測試是否使用新連線。重複安裝無法解釋規則比對順序,還可能造成現有對照資料遺失。只有確認問題出在 App 安裝或啟動階段時,才回到第一章處理安裝。