Shadowrocket · 官方手冊

Shadowrocket 使用手冊

首次設定時,可先依照快速入門教學完成匯入、連線與驗證。本手冊供系統性查閱:除了操作步驟,也說明每個步驟如何確認成功,以及失敗時該退回哪一步。操作範例以 iPhone 和 iPad 介面為主,安裝章節另列其他平台的處理方式。

取得與安裝

iPhone 與 iPad:從 App Store 取得

Shadowrocket 是閉源商業應用程式。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac(Apple 晶片與 Intel)、Windows、Android 和 Linux 版免費。美國商店以外的價格請以各地 App Store 頁面為準;iPhone 和 iPad 的系統需求以 App Store 頁面標示為準。點選下載頁的商店入口即可開啟產品頁,接著核對開發者 Shadow Launch Technology Limited、官方應用程式圖示,以及產品頁網址中的應用程式 ID 932747118。應用程式名稱相同,不能取代這三項核對。

如果其中一部裝置已完成購買,另一部裝置使用相同購買帳號時,可先到 App Store 的已購項目中尋找,再從產品頁安裝。若仍出現購買提示,請先確認目前用於 App Store 的帳號、已購紀錄,以及該商店是否提供此應用程式。帳號可以重新取得應用程式,不代表舊裝置上的伺服器資訊、訂閱或本機設定也會一併還原;更換裝置前,請先保留這些資料。

應用程式一次性買斷 ≠ 連線方案。安裝後不會附帶可連線的伺服器。本網站不提供、不販售,也不推薦節點或訂閱;首次設定前,請備妥你已有的伺服器資訊或訂閱連結。

Mac 與 Windows:確認硬體架構及檔案來源

桌面版與 Android 安裝檔請從全平台下載頁取得,下載網址應位於本站 /dl/shadowrocket/ 下。Mac 請先在「關於這台 Mac」查看硬體資訊:顯示 Apple 晶片時選擇 Apple 晶片版,顯示 Intel 處理器時選擇 Intel 版。開啟對應的安裝檔,將應用程式複製到「應用程式」資料夾,再從該資料夾啟動;直接從磁碟映像檔啟動不代表已完成安裝。若出現無法驗證開發者的提示,請先確認開啟的是本站下載的檔案,再到系統設定的「隱私權與安全性」查看是否有「仍要打開」選項。若系統提示檔案已損毀,請重新下載符合硬體架構的檔案,不要一概把損毀提示當成可以略過的警告。

Windows 請先在系統資訊中確認系統類型,再下載對應檔案。若 SmartScreen 對本站取得的安裝程式顯示警告,確認下載網址與檔案無誤後,可透過「其他資訊」查看是否能選擇「仍要執行」。這只是針對該安裝程式進行確認,不需要關閉系統防護。若組織政策禁止執行,或系統明確提示偵測到惡意內容,請停止安裝;不要把管理員限制或惡意軟體警示當成一般首次啟動提示。

Android 與 Linux:依裝置選擇檔案格式

Android 請先確認裝置是否符合下載頁列出的硬體架構,再開啟安裝檔。若系統要求允許瀏覽器或檔案管理員「安裝未知的應用程式」,只授權這次實際用來開啟檔案的應用程式,安裝完成後即可撤銷權限。允許後仍無法安裝時,先檢查安裝檔是否完整下載、裝置架構是否相符、儲存空間是否足夠,再查看系統是否回報與既有應用程式衝突。移除既有應用程式可能同時刪除本機設定,請勿把解除安裝當成第一步。

Linux 請依發行版與套件管理工具選擇檔案格式:使用對應的套件管理工具安裝本機 deb 或 rpm 套件;使用 AppImage 時,可在檔案屬性中授予執行權限後啟動。缺少相依套件、路徑錯誤與檔案沒有執行權限是不同問題。若套件管理工具明確指出缺少相依套件或架構不符,請依錯誤訊息核對系統與套件,不要反覆以更高權限啟動。各平台的下載入口與解除封鎖說明請見安裝說明;完成本章後,應用程式應能開啟,但不必已經連線。

首次啟動與權限

先確認應用程式介面與系統網路

首次開啟 Shadowrocket 後,可先查看 Home,熟悉連線開關、Global Routing 與伺服器清單的位置,再開啟 Config 查看目前有哪些設定。此時伺服器清單為空,或連線開關仍關閉,都不代表安裝失敗。請先回到系統,確認裝置已連上可用的 Wi-Fi 或行動網路,並且在 Shadowrocket 尚未連線時能開啟平常可瀏覽的網站。若公共 Wi-Fi 需要先完成網頁認證,請先完成認證,否則稍後下載訂閱與連線測試可能都會失敗。

若系統已有其他 VPN 設定,請先確認是否有其他連線正在運作、裝置是否由公司或學校管理,以及停用後是否會影響存取。不要為了讓新設定生效而刪除舊設定或管理描述檔。可關閉你有權操作的其他連線,再返回 Shadowrocket 繼續;受管理的裝置則應依管理單位規定操作。裝置顯示 VPN 狀態,也不代表目前一定由 Shadowrocket 處理流量;必要時可到系統設定確認目前生效的是哪條連線。

首次連線時授權新增 VPN 設定

首次嘗試連線時,iPhone 或 iPad 可能會出現系統確認訊息,詢問是否允許 Shadowrocket 新增 VPN 設定。請先確認這是剛才在 Home 開啟連線後出現的系統提示,再依系統要求驗證身分。授權的作用是讓用戶端建立用來處理網路流量的系統連線;它不會檢查伺服器位址、帳號或訂閱內容。完成授權並返回 Home 後,仍須依連線狀態與實際瀏覽結果判斷是否成功。

先前選擇不允許時,可返回 Home 再次發起連線,依照出現的提示操作。若沒有彈出視窗,而且開關很快又切回關閉,請先檢查系統 VPN 設定中是否已有對應設定,再確認 Home 是否顯示錯誤,以及是否有其他 VPN 正在運作。不要為了重新叫出提示而連續點擊開關,也不必因此清除所有網路設定。若系統按鈕呈灰色或設定無法修改,請區分裝置管理限制與連線失敗;更新訂閱無法變更裝置授權。

區分 QR Code、檔案存取與區域網路權限

只有在使用 Scan QR Code 掃描自己已有的伺服器 QR Code 時,才需要依系統提示授權相機存取。手動輸入伺服器資料或貼上訂閱連結都不需要相機權限。若不想授權掃碼,可改用已有的連線參數手動輸入。選擇匯入檔案時,只挑選自己準備好的檔案;即使檔名看起來熟悉,也要先確認檔案的提供者與用途。設定檔可能變更伺服器選項,也可能影響 DNS 或規則,不宜用來源不明的檔案來排查問題。

如果測試的是同一區域網路中的裝置,而公網存取正常,請先確認測試目標是否仍在線、兩部裝置是否連上同一個網路、訪客 Wi-Fi 是否隔離裝置,再檢查系統是否曾要求所用功能取得區域網路權限。區域網路連線失敗,和代理伺服器登入失敗並非同一回事。同樣地,若某個應用程式暫時未獲行動數據使用權限,離開 Wi-Fi 後就無法更新訂閱,也不代表訂閱已失效。分別記錄問題發生時的網路與提示位置,可避免在錯誤的層面反覆修改。

連線前只需確認三件事:裝置本身可以連上網路、應用程式可以開啟,以及系統允許建立所需連線。伺服器是否可用、規則是否正確,分別在匯入與驗證階段判斷。

伺服器與訂閱匯入

手動新增單一伺服器

從 Home 的新增入口進入 Add Server,先選擇你現有伺服器使用的協定,再依原始資料填寫。選錯協定時,表單欄位會不同;即使位址和連接埠相同,驗證方式也不能互換。位址欄填入主機名稱或服務提供者給的位址,連接埠填入專用欄位,備註則用來辨識項目。不要把整段連結貼到位址欄,也不要把說明文字、協定前綴或複製時帶入的空格一併存進參數。若資料包含傳輸或安全性設定,必須與伺服器端一致,不要只因名稱相近就自行替換。

依協定核對現有資料
協定核對項目
Shadowsocks伺服器位址、連接埠、加密方式與密碼。
VMess / VLESS伺服器位址、連接埠、UUID,以及資料指定的傳輸與安全性參數。
Trojan / Hysteria2依各自的協定核對位址、連接埠、驗證資料與適用的 TLS 設定。
HTTP / SOCKS5位址與連接埠;只有伺服器要求時才填寫相應的帳號與密碼。
WireGuard本機位址、金鑰、對端位址與連接埠、Allowed IPs;公鑰與私鑰不可互換。

儲存後,在 Home 找到新增的項目,先核對備註與協定,再選取該項目。若清單中有名稱相同的項目,可使用容易辨識的備註區分手動輸入與訂閱匯入,避免測速的是一個項目,實際連線卻使用另一個。若出現憑證或身分驗證錯誤,請重新核對伺服器資料與裝置時間,並依實際錯誤檢查主機名稱;不要把關閉驗證當成一般修復方式。若現有連線仍可使用,請保留作為對照,不要用測試值覆蓋原有項目。

匯入與更新現有訂閱

訂閱連結是用來讓用戶端取得一組伺服器項目的網址。若你持有自己的連結,請從 Home 的新增入口進入並選擇 Subscribe,將完整連結貼到對應的位址欄。複製後請檢查開頭與結尾是否混入換行或空格,尤其不要漏掉問號後用來識別訂閱的部分。下方只展示連結格式,不能用來匯入實際伺服器。真實連結應視同憑證妥善保管,不要貼到公開貼文、截圖或線上檢查工具。

https://example.com/sub?token=xxxx

儲存後若沒有展開可選項目,請先使用該訂閱的更新功能取得清單,再判斷是讀取失敗,還是回傳內容不適用。若下載時發生錯誤,請檢查裝置網路、連結是否完整,以及訂閱狀態;若已收到內容但無法辨識項目,請確認該網址提供的是供用戶端使用的訂閱,而非帳號登入頁面或一般網頁。若清單已出現,只是其中一台伺服器無法連線,應改為檢查該伺服器與目前網路,不要將問題歸類為整份訂閱無法更新。

不要混淆伺服器清單與 Config 檔案

伺服器項目提供連線所需的參數;Config 檔案則用來設定規則與相關選項。新增訂閱不代表已選好分流規則,匯入規則檔也不代表其中引用的策略一定能找到可用伺服器。操作前先辨識手上的資料,再選擇對應入口。若同時取得訂閱與設定檔,請先匯入訂閱並確認清單可讀,再另外處理設定檔;這樣遇到問題時,才能分辨是清單取得失敗,還是設定未啟用。

更換訂閱前可暫時保留原有項目作為對照,但不要假設新舊清單中同名的項目完全相同。請重新確認目前選取的伺服器;若設定中有策略群組,也要檢查群組是否仍引用舊項目。更新前可記下原本的選項與測試結果,更新後再測一次。遇到位址變更、回傳空清單,或只在特定網路下更新失敗時,可前往常見問題依症狀尋找處理方式。

Global Routing 三種模式

先選模式,再確認流量路徑由什麼決定

在 Home 開啟 Global Routing。這裡的 Config、Proxy 與 Direct 決定用戶端如何處理流量。它們不是伺服器名稱,也不是三種連線協定。建立常用分流時選擇 Config;若要暫時排除規則的影響,可用 Proxy 或 Direct 作為對照。對照完成後請切回原本的模式,否則即使之後編輯 Config,也可能一直看不到預期的規則結果。

模式、路徑與測試用途
介面項目處理方式適合核對的內容
Config依目前啟用的設定匹配規則。檢查目標請求命中哪一條規則。
Proxy用戶端接管的流量採用代理路徑。暫時排除自訂分流規則的影響。
Direct用戶端接管的流量採用直連路徑。在用戶端仍保持連線時,對照直連的結果。

Direct 不會在 Home 關閉連線;因此,若懷疑裝置的基礎網路本身有問題,仍須實際關閉連線後再測試。Proxy 可以開啟目標,但 Config 不行時,請優先核對目前啟用的設定,以及目標請求實際採用的路徑;兩種模式都失敗,也不能直接斷定是伺服器故障,仍須確認該目標在一般網路下是否有回應。若要確認介面文字的位置,可搭配介面用語對照查閱。

在 Config 中修改規則前,先建立副本

規則通常依書寫順序比對。對目前的請求而言,命中規則後就會採用對應策略,不會為了尋找更精確的規則而從頭重新比對。例如,網域後綴規則若排在前面,同一後綴下的特定主機可能在比對到後面的精確規則前就已被分流。若要新增少數例外,請先檢查前面是否有涵蓋範圍更廣的規則,再將例外放在合適的位置。規則關鍵字代表條件類型,最後一項才是策略;不要把 Home 的模式名稱當成規則條件。

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

這是一段可放入設定副本的規則範例,並非包含所有設定的完整檔案。此例先讓指定主機採用 DIRECT,再比對其他相同網域後綴的目標;交換前兩行會讓精確例外失效。GEOIP 依目標 IP 的分類進行比對,不等同於依網域後綴辨識目標;IP 規則能否命中,也取決於比對時是否取得目標位址。未命中前置規則的請求會落到 FINAL。本例以 DIRECT 作為預設策略;若改成 PROXY,所有未命中的請求都會改走代理路徑,不只正在測試的網站。

依實際請求找出未命中的原因

同一個網頁可能同時請求頁面位址、圖片來源與登入服務等多個主機,網址列顯示的網域不一定代表每一個請求。若只有圖片或登入失敗,請分別確認失敗部分實際連線的主機,再決定使用 DOMAIN 為單一主機設定例外,或使用 DOMAIN-SUFFIX 處理整個後綴。DOMAIN-KEYWORD 的比對範圍更廣,可能同時命中不相關的目標;IP-CIDR 與 IP-CIDR6 則分別適用於相應版本的位址範圍,不應用來取代網域規則。

儲存規則副本後,確認啟用的是剛修改的檔案,並在 Home 選擇 Config。重新發出一個請求進行測試,必要時關閉再重新開啟目標頁面,避免舊連線或本機快取掩蓋變更結果。若修改某一處卻影響不相關的網站,請先還原舊設定,再縮小規則範圍並檢查 FINAL。少量目標的完整範例請見指定網站的規則寫法與順序。

介面項目保留 Proxy 與 Direct 的寫法;設定檔中的策略則寫成 PROXY 與 DIRECT。REJECT 代表拒絕請求,不是連線失敗時自動改用的另一條路徑。

建立連線並驗證結果

在相同網路下建立對照

先使用穩定的 Wi-Fi 或行動網路,在未開啟 Shadowrocket 時瀏覽一個平常可連線的頁面,記錄基準狀況。接著返回 Home,確認選取的伺服器與 Global Routing 模式;若使用 Config,也要核對目前啟用的設定。開啟開關並等待狀態穩定,不要在同一輪測試中同時切換伺服器與網路。若出現系統授權提示,完成授權後再確認連線能否維持。開關保持開啟,表示系統連線已建立,但不能據此確認每一個目標請求都成功。

可先對選取的伺服器執行 Connectivity Test,再實際瀏覽需要驗證的網頁或應用程式。測試結果只代表當時條件下對該測試目標的測量;顯示成功不保證其他目標都能存取,單次失敗也不代表伺服器對所有目標都無效。重試時先維持網路與選項不變,避免把網路切換造成的差異誤認為伺服器效能變化。若要比較兩台既有伺服器,使用相同網路、目標與模式測試,結果更有參考價值。

依影響範圍決定下一步

所有網站都無法開啟:先關閉連線再測一次。若關閉後仍然失敗,優先檢查 Wi-Fi 認證、行動數據權限或裝置的基礎網路。若關閉後恢復正常,請確認另一台原本可用的伺服器是否也有相同問題。只有一台伺服器失敗時,核對其位址、驗證與安全性設定;多台都失敗時,再檢查兩次測試共有的因素,例如目前網路、設定或名稱解析設定。錯誤發生的時間點也很重要:連線剛啟動便中斷,和開關保持穩定後請求逾時,並不是相同症狀。

只有部分目標失敗:保持使用同一台伺服器,對照 Config 與 Proxy。若 Proxy 可以存取而 Config 不行,請檢查失敗的請求是否被範圍過廣的規則提前命中,或被導向不合適的 FINAL。若兩種模式都失敗,而且關閉連線後也一樣,應考慮目標服務或基礎網路是否有問題。若只有代理路徑失敗,請檢查這條路徑是否適用於該目標,而不是直接擴大整份設定的代理範圍。

提示找不到主機或頁面持續等待:記下錯誤原文。找不到主機可能與名稱解析有關;等待後逾時也可能發生在建立連線或傳輸階段,不能只憑等待時間長短就判定是 DNS。可用兩個平常能連線的網域進行對照,確認是否只有特定目標出錯,並核對近期是否修改過 DNS 或相關規則。若出現憑證錯誤,請重新檢查系統時間與連線參數,不要略過驗證繼續瀏覽。逐項排查方式請見已連線卻無法上網的排查說明。

切換網路與恢復後的行為測試

在穩定網路上完成測試後,再驗證需要使用的另一種網路。切換 Wi-Fi 與行動網路時,正在進行的下載、影片播放或工作階段可能需要重新連線;請用新開啟的頁面請求驗證,而不是只看切換前已載入的畫面。若只有一種網路異常,請分別記錄未連線與已連線時的表現,並檢查該網路是否需要認證,以及裝置是否允許應用程式使用行動網路。若兩種網路都穩定,但返回前景時常出現異常,再另外檢查自動連線條件,以及裝置是否有其他 VPN 設定正在接管。

驗證完成的標準,不是開關一直亮著,而是能說明一個代表性請求的結果:目前網路可用、選取的伺服器可用、模式符合預期,且需要分流的目標走上預期路徑。完成對照測試後,請將 Global Routing 與伺服器恢復為日常使用的選項。日後若要重現異常,只需記錄網路類型、模式、規則與錯誤訊息,不必把登入資訊也記下來。

使用 Data 核對流量

先確認統計範圍,再比較數值

Data 用來查看 Shadowrocket 記錄的網路流量。查看數值前,先確認目前頁面顯示的維度與時間範圍:是某一段期間的統計、特定伺服器的流量,還是介面顯示的累計總量;不同維度不宜直接比較。若頁面區分傳送與接收,請分別記錄,不能把一次只看接收的數值和另一次雙向總量相比。剛連線時已有歷史紀錄並不奇怪,請先記下基準值,測試結束後再查看這段期間的增量,不要把目前總數直接當成本次連線用量。

用戶端統計的對象,與系統的行動數據統計及服務提供者帳單並不相同。系統依自己的方式統計裝置或應用程式的行動數據,服務提供者也可能採用不同的統計週期、計量單位與流量方向。用戶端頁面上看似接近的數值,不一定對應同一批流量。看到差異時,請先對齊時間範圍、網路類型、單位與上傳/下載口徑,再判斷是否在比較同一件事。若要核對行動數據用量,請以系統統計為準;若要核對帳戶扣量,請查看你既有服務提供者的紀錄,並用 Data 判斷流量大約在哪個時段發生變化。

用一次短時間測試建立可解讀的流量增量

選擇穩定的網路,並維持相同伺服器與 Global Routing 模式。暫停容易產生大量背景流量的工作,例如正在進行的同步或下載,再記下 Data 中可見的起始數值。接著只執行一個容易重複的動作,例如重新載入較簡單的網頁;載入完成後回到同一個統計畫面,核對數值差異。若頁面來自快取,數值可能幾乎不變;可改用新的請求再查看,或搭配目前連線狀態與診斷資訊判斷,不必刻意下載大型檔案讓數值增加。

若要驗證新規則,不要把總流量增加當成目標已走 PROXY 的證據。瀏覽器可能同時預先載入其他資源,背景應用程式也可能更新,因此期間即使確實有代理流量,也未必來自測試目標。請將測試限制在單一動作;若介面能查看該請求或策略的診斷紀錄,再把時間、目標與策略連在一起核對。若沒有診斷資訊,只能說統計數值在測試期間有變化,不能據此推論某條網域規則必定命中。

判讀流量突然增加或數值沒有變化

若沒有主動瀏覽時流量仍持續增加,請先查看同一裝置是否正在同步、更新應用程式、自動載入媒體,或進行長時間傳輸。使用相近的時間範圍測試兩次:一次暫停已知工作,一次恢復工作,再比較流量增量;這比反覆更換伺服器更容易判斷背景流量來源。若切換 Wi-Fi 至行動網路後才注意到流量增加,也應核對系統的行動數據統計,因為 Data 顯示的總量不一定只來自行動網路。

數值沒有變化時,先重新整理畫面或等待目前請求完成,再確認頁面讀取的是否為快取,並檢查目前查看的統計維度是否涵蓋這次請求。分流採用 DIRECT 時,不能用某台代理伺服器的統計來判斷直連請求是否完成。若曾手動清除紀錄或切換統計範圍,請先建立新的基準值,否則前後數值無法比較。清除紀錄也不能改變規則或減少服務提供者的流量扣量。

保留便於比較的簡短紀錄

需要長期觀察時,只記下測試時段、網路類型、模式、當時的統計維度與大致增量。短時間測試與全天背景用量分開記錄,Wi-Fi 與行動網路的觀察也分開記錄。如此在更新訂閱或修改規則後,就能用相同測試條件比較變化。若要分享 Data 截圖,請先遮住可識別帳戶或伺服器的資訊;描述排查過程時,通常只要區分短時間增量、長期累計,以及異常發生的環境。

Settings 常用項目與調整順序

依設定影響範圍尋找入口

Settings 用來查看與調整用戶端的一般行為,但不是所有選項都在這裡。正在使用哪台伺服器、連線是否開啟,以及 Global Routing 模式,請返回 Home 核對;特定設定中的規則與 DNS 項目,請返回 Config 核對;VPN 授權、Wi-Fi 與行動數據權限則屬於系統設定。請先判斷要變更的是哪一層,再前往對應位置,否則很容易改了通用設定,卻繼續用舊設定測試,或把系統權限問題誤認為應用程式選項衝突。

調整前先保留一個可正常瀏覽的基準,並記下原本選項與準備驗證的目標。每次只修改一項,再以相同網路、模式與伺服器重測。若問題消失,先將該項恢復原值,確認問題是否重現,再決定是否保留變更。若同時修改許多選項,即使短時間內恢復正常,也難以判斷是哪一項生效;下次遇到類似故障時,就無從得知該從哪裡查起。

On Demand:先確認手動連線正常

On Demand 會影響系統在符合條件時是否主動建立連線。準備啟用前,請先在預計使用的 Wi-Fi 或行動網路下手動連線,確認伺服器、模式與目標都符合預期,再依介面提供的條件設定。初次設定時,先選一個容易重複驗證的情境,例如連上已知可用的 Wi-Fi。切換至該網路後發出新請求,觀察是否依預期建立連線;接著再測試不符合條件的情境,不要只測會觸發連線的一側。

公共 Wi-Fi 可能需要先完成網頁認證。若 On Demand 影響認證流程,可暫時停用自動觸發,完成網路登入後再重新啟用並驗證。若關閉後又自動連線,也應先檢查 On Demand 與系統中既有的 VPN 設定,而不是判定開關失效。若不同網路的需求不同,請逐一新增條件,並記錄是哪種網路觸發了連線。自動連線無法取代伺服器可用性檢查;沒有可用伺服器時,反覆觸發也無法修復登入或路由問題。

Connectivity Test 與 DNS:分開檢查測試與解析

Connectivity Test 適合檢查特定測試目標。若測試行為或結果異常,先回想是否修改過測試相關設定。若介面提供測試網址,只使用自己了解用途且平常可正常存取的目標;需要比較變更前後的結果時,請維持網址不變。只換測試網址就恢復正常,不代表其他請求也已恢復。請勿使用需要登入、經常重新導向或受帳戶狀態影響的頁面作為固定對照。

DNS 設定用於名稱解析,不是單純用來加快連線的開關。若症狀明確指向解析問題,請先檢查目前的 Config 與裝置是否已有相關設定,記下正常狀態後,再於設定副本中一次調整單一因素。若某個區域網路名稱只能在所在網路解析,切換至其他解析方式後可能無法使用,但公網網域仍然正常。重新測試時,既要檢查原先失敗的網域,也要檢查一個原本正常的網域,不能只因某個目標恰好恢復就判定問題已解決。

只保留能協助定位問題的診斷資料

若要使用日誌等診斷功能,請先確認本次需要釐清的是解析、規則、連線還是系統觸發,再於短時間內重現問題。記錄錯誤出現的順序與目標的大致類型,不要經常啟用除錯功能並長期保存所有紀錄。回報問題前,請移除伺服器位址、帳戶識別資訊、設定檔中的敏感內容與訂閱參數;日常瀏覽的目標也可能涉及個人隱私。診斷完成後,將僅供測試而啟用的選項恢復原設定,再確認常用網站能正常瀏覽。

更新、備份與日常維護

分別處理三種更新

應用程式更新、訂閱更新與設定更新,分別處理三種不同問題。應用程式更新會替換程式;訂閱更新會變更現有伺服器清單;設定更新則可能變更規則、策略引用或解析設定。iPhone 與 iPad 請在 App Store 檢查應用程式更新;Mac、Windows、Android 與 Linux 請返回全平台下載頁,選擇對應平台與硬體架構的安裝檔。不要為了更新訂閱而解除安裝用戶端,也不要把更新用戶端當成重新整理伺服器清單。若先前修改過系統授權,更新後請先確認原授權是否仍有效,再判斷是否需要重新授權。

條件允許時,請在不同時間分別執行這三種更新:先保存目前可用的狀態,更新一項,確認 Home 可以連線、常用目標能依預期分流後,再繼續下一項。重新整理訂閱後,不要只看清單是否有變化,也要重新確認選取的伺服器,以及設定所引用的策略群組。若只有一台伺服器失效,可用現有項目進行控制對照;若整份清單為空,請先檢查訂閱更新本身,避免在沒有伺服器項目時重新撰寫規則。

備份可還原的設定與選項紀錄

備份不只是記下檔名。至少要清楚記錄目前啟用哪份設定、Global Routing 使用哪種模式、選用哪台伺服器或哪個策略,並記下自行修改過的 On Demand 與 DNS 設定。將需要還原的設定檔儲存在自己可存取的安全位置,並與正在測試的副本區分。若可匯出設定,請確認檔案確實可以取回;妥善保存舊檔案,不要用修改後但未經測試的檔案覆蓋最後一份可用副本。

設定檔不一定包含所有資料。尤其更換裝置時,重新安裝只能還原應用程式本身;伺服器清單、訂閱、設定與系統權限都需要個別檢查。請依首次使用的順序還原:先確認新裝置在一般網路下可以獨立連線,再安裝並完成系統授權,最後匯入自己的資料並進行驗證。若仍保有舊裝置,請在確認新裝置成功之前,保留舊裝置上的設定。檔案、連結與 QR Code 可能包含驗證資訊,不要放在公開目錄或貼到公開討論區。

發生錯誤後,還原至最近一次可用狀態

修改規則後才發生異常時,優先啟用先前可用的 Config,再確認切換設定後異常是否消失。更新訂閱後出錯,先檢查目前選取的項目與策略群組,不要反覆匯入同一連結,讓清單出現多份重複項目。啟用自動連線後出錯,先停用相關條件並驗證手動連線。這是在還原最近一次變更,不是把帳戶、檔案與權限一併重設。若用戶端沒有變更卻突然失效,請先排除目前網路、目標服務或現有伺服器的外部變化。

若還原後仍無法恢復,請整理一份可重現的紀錄:使用哪類裝置、哪種網路與模式時發生,是否影響所有網站,關閉 Shadowrocket 後是否恢復,以及最近更新的是應用程式、訂閱還是設定。移除敏感資訊後,再查閱常見問題。若尚未確認哪些資料已有備份,請勿貿然清除應用程式資料;刪除後重新安裝,可能會失去原本仍可用於比對的設定。

用相同請求檢查維護結果

平時保留兩個預期結果明確的驗證目標:一個應走代理路徑,另一個應走直連路徑,並確認它們在 Config 中分別應命中哪條規則。若主要使用 Proxy 或 Direct,也可保留一個用於確認實際瀏覽結果的對照目標。維護完成後重新發出請求,確認不是沿用舊工作階段,再檢查連線與流量表現是否一致。最後恢復日常使用的模式與自動連線條件。穩定的測試條件比頻繁修改設定更有用,能讓下次遇到故障時從具體變化著手,而非從頭安裝。