Shadowrocket Mac版 · 官方手冊

Shadowrocket 使用手冊

想盡快完成首次連線,請先依照快速入門教學完成主要步驟;若要更換裝置、調整規則或排查故障,請從下方目錄前往相關章節。第一章介紹各平台的取得與安裝,後續操作以 iPhone 和 iPad 介面為例。

01 / 取得

取得與安裝

確認裝置、取得管道與應用程式身分

先依手邊的裝置選擇取得方式。iPhone / iPad 版可在 App Store 產品頁以美國商店價格 $2.99 一次性付費取得,兩種裝置可共用同一筆購買紀錄;系統需求請以 App Store 頁面標示為準。Mac(Apple 晶片版與 Intel 版)、Windows、Android、Linux 版免費,請依客戶端下載頁面的裝置卡片選擇,安裝檔由本站透過 /dl/shadowrocket/ 路徑提供。取得方式分為兩種;連線所需的服務資訊則須另行準備。

請先在商店頁面確認開發者為 Shadow Launch Technology Limited,再核對官方圖示及產品連結末尾的 App ID 932747118。搜尋結果中名稱相近的項目不一定是同一款應用程式,名稱和圖示也不能取代開發者及 App ID 的確認。若頁面無法開啟,先確認帳號所屬的商店是否顯示該產品;重新安裝時,優先查看原購買帳號的已購項目。商店可確認購買歸屬,但無法替你還原先前儲存在應用程式中的伺服器或規則。

Mac:先確認晶片,再拖移至 Applications

開啟 Apple 選單中的「關於這台 Mac」。若顯示「晶片」及 M 系列名稱,請在 Mac 下載區選擇 Apple 晶片版;若顯示 Intel 處理器,則選擇 Intel 版。安裝檔應依這台 Mac 的晶片選擇,而非依據目前使用的瀏覽器或另一台電腦上檔案的名稱。開啟下載的磁碟映像,將 Shadowrocket.app 拖移至 Applications;複製完成後,從該資料夾開啟應用程式。確認應用程式已複製完成後再退出磁碟映像;將映像拖進資料夾,或直接從映像中開啟應用程式,都不能取代這個步驟。

首次開啟時,如果系統提示無法驗證開發者,請先確認來源與晶片版本無誤,再前往「系統設定 › 隱私權與安全性」,找到這次的開啟記錄,依提示選擇「仍要打開」。這個選項通常會在嘗試開啟後才出現。若提示檔案損毀、下載中斷或架構不符,請重新取得並核對下載項目;這些狀況不能當作一般的首次開啟確認處理。若裝置由組織管理,且沒有允許開啟的選項,請交由管理員處理,不要變更全域安全性政策。

Windows、Android 與 Linux:依系統安裝

在 Windows 下載區選擇適用於這台電腦的 64 位元安裝項目,再從下載資料夾執行。若出現 SmartScreen 提示,請核對安裝來源與檔案;個人裝置確認無誤後,可透過「更多資訊」查看是否有「仍要執行」選項。若系統明確指出偵測到威脅,請停止安裝,不要把威脅警示當成一般確認。安裝完成後,從系統的應用程式入口啟動;保留安裝時的錯誤提示,以利判斷是執行權限問題還是安裝失敗。

在Android 下載區選擇符合裝置架構的安裝項目。若系統要求允許發起安裝的應用程式「安裝未知應用程式」,請先確認發起安裝的是剛才使用的瀏覽器或檔案管理員,再依系統提示只為該來源開啟權限;安裝完成後可撤銷此權限。若安裝程式回報應用程式不相容,請檢查裝置架構、系統提示,以及是否已有同名應用程式,不要先解除安裝正在使用的版本。確實需要更換先前安裝的版本時,請先備份可匯出的設定。

在 Linux 下載區依發行版與使用方式選擇安裝套件:使用相應套件管理員的系統,優先選擇相符的 deb 或 rpm;選擇 AppImage 時,請先在檔案屬性中授予執行權限,再從檔案所在目錄開啟。若套件管理員提示相依性未滿足,請先記下缺少的套件與發行版資訊,不要強行忽略相依性。系統回報權限不足時,請分辨是檔案沒有執行權限、目前目錄不允許執行,還是安裝軟體需要管理員授權。

02 / 權限

首次啟動與 VPN 設定權限

先認識 Home 上的操作入口

在 iPhone 或 iPad 上開啟 Shadowrocket,先從 Home 認識四個區域:連線開關顯示目前的連線狀態;Global Routing 決定流量如何分流;Connectivity Test 用於測試連線狀況;SERVER 顯示已匯入或手動新增的伺服器。剛安裝時清單可能是空的,顯示 Not Connected 也屬正常。這個頁面不會自動產生可連線的伺服器;請先備妥自己的訂閱或連線參數,再依下一章新增。各區塊的用途可參閱首次開啟與 Home 介面說明。

首次啟動或第一次嘗試建立連線時,系統可能詢問是否允許新增 VPN 設定。這是 iOS 或 iPadOS 顯示的系統授權,用來登錄 Shadowrocket 的網路設定,不是伺服器驗證,也不是輸入訂閱密碼的欄位。請由本人在 Shadowrocket 中發起操作,確認要求的應用程式正確後,再於系統提示中允許;系統可能要求輸入裝置密碼或進行生物辨識。授權完成後回到 Home,並在 Home 查看實際連線狀態。授權成功不代表代理伺服器可連線,也不表示已有流量正在轉送。

可以將這個流程分成三個檢查點:系統是否允許新增設定、應用程式是否已選好要使用的伺服器,以及連線開關是否完成狀態切換。每個檢查點處理的問題都不同。例如,允許設定後開關可以啟用,但清單仍是空的,就應先補上伺服器資訊;若清單已有伺服器,但每次開啟開關仍回到 Not Connected,則應先查看系統提示與應用程式狀態,判斷是否卡在系統授權。不要一看到 Not Connected 就重新安裝,也不要為了通過測試反覆切換多個設定。

取消授權、設定衝突與受管理裝置

若首次在系統提示中選擇取消,請先回到 Home,再由本人發起一次連線,查看是否再次出現授權要求。若沒有出現要求且操作仍失敗,請前往系統「設定」查看 VPN 設定。不同系統的入口位置可能有所變動,可在系統設定中搜尋 VPN。確認現有項目是否屬於 Shadowrocket、是否有其他網路設定正在執行,以及裝置是否受到管理限制。調整前先記下原本狀態;不要只為通過一次測試就刪除無法辨認的 VPN 項目。

裝置可能還有工作或學校安裝的 VPN、網路過濾設定,或公司要求持續連線的管理政策。即使可以開啟 Shadowrocket 介面,系統仍可能不允許新增或啟用個人設定。此時請記下受阻的步驟與提示原文,交由裝置管理員確認。若目前正在使用另一個個人 VPN,只有在確認可以中斷時才暫停測試;測試結束後依需要恢復。如此可分辨是兩個設定競用網路路徑,還是伺服器參數本身有誤。

若允許新增設定後,連線仍立即關閉,可以記下嘗試時間、當時使用的網路、Home 顯示狀態與系統提示,再依連線與驗證一章檢查。若授權成功後介面跳出相機存取要求,請先確認是否點選了 Scan QR Code;相機授權與 VPN 授權是兩回事。不想啟用相機時,可以手動輸入參數或使用已有的訂閱。處理權限時,應先確認要求符合剛才執行的操作,再授予完成該操作所需的權限。

03 / 連線資料

新增伺服器與匯入訂閱

先分清單一伺服器、訂閱與 Config

服務商提供單一伺服器的位址、連接埠與驗證資訊時,請使用 Add Server 手動新增;若提供可定期更新一組伺服器的連結,則使用 Subscribe 匯入。伺服器資訊決定可選用的上游連線;訂閱是取得及更新這些資訊的方式;Config 則用來描述流量如何符合規則及採用哪種策略。三者不是同一種檔案。遇到格式不明的文字時,先向服務商確認它是連線參數、訂閱還是設定檔,不要依序貼到不同入口試用。

手動輸入前,請依服務商提供的協定選擇類型,再填入伺服器位址、連接埠、驗證欄位與指定的傳輸設定。位址通常是主機名稱或 IP,連接埠應填在對應欄位;除非介面欄位明確要求完整網址,否則不要把網頁前綴、連接埠或路徑一併填入主機位址。備註僅供辨識伺服器,修改備註無法修正網路參數。儲存後回到 SERVER 核對新增項目,並確認目前確實選取該項目再進行測試。若清單中有許多同名項目,請先用清楚的備註區分新舊,不要大量刪除舊項目。

了解不同協定所需的參數

常見協定的輸入檢查項目(以服務商提供的參數為準)
協定優先核對項目容易混淆的欄位
Shadowsocks位址、連接埠、加密方式、密碼加密方式須與伺服器端一致,不能依密碼長度推測
VMess / VLESS位址、連接埠、使用者識別碼、傳輸方式路徑、主機名稱與用於驗證的服務名稱不一定相同
Trojan / Hysteria2位址、連接埠、驗證資訊及適用的安全設定依指定協定填寫,不要以其他協定的欄位替代
WireGuard本機與對端設定、金鑰、對端位址本機私鑰與對端公鑰不可互換,私鑰不可轉傳
HTTP / SOCKS5代理位址、連接埠及適用的驗證資訊是否需要使用者名稱與密碼由代理服務決定

上表用來辨識欄位,不代表同一組協定可以互換。實際欄位會依所選類型與傳輸方式而異。最常見的問題是只複製到主機位址,漏填目標連接埠,或貼上時一併帶入欄位末尾的空格與換行。若連線提示身分驗證失敗,請核對服務名稱、裝置時間及服務商說明;不應把關閉驗證當成長期解法。想了解各協定在傳輸與驗證方面的用途,可參閱協定概覽。

匯入後先驗證內容,再決定是否更新

訂閱請向你的服務商取得。在新增入口選擇 Subscribe,貼上完整的原始訂閱網址,儲存後查看 SERVER 是否出現相應群組與可選伺服器。網址中問號後方的查詢參數可能用來識別訂閱權限,手動刪減往往會使連結失效。也不要將完整網址貼到公開討論區或線上檢查工具。QR Code 也可能包含驗證資料;只有在來源明確時才使用 Scan QR Code,掃描後請確認匯入內容符合預期,再儲存。

訂閱可以儲存但清單為空時,先判斷是否只有這個訂閱異常:檢查網址是否遭截斷、目前網路能否連線取得訂閱,以及服務商是否已更換網址或服務狀態是否有變。若清單中有項目但某台伺服器失效,請改測同一訂閱中的另一台已知可用伺服器,並保留原設定作為對照。可以重新整理但仍無法連線時,請繼續檢查目前伺服器的協定、密碼或有效期限;不要把重新整理成功解讀為每個位址都可用。反之,重新整理失敗也不一定會立即影響已儲存的伺服器。

新匯入的訂閱首次更新前,可以先記下目前使用的伺服器備註與所屬群組。更新後,核對清單是否有重新命名、移除或新增項目;若原先選取的項目已不存在,請重新選擇一台再測試。手動新增的伺服器與由訂閱管理的項目應分開維護,以免把單一項目的臨時變更誤以為日後都會保留。收到替換網址時,先確認來源,再驗證新網址與新項目,最後清理舊入口。

04 / 分流

Global Routing 三種模式

分清設定、代理與直連

在 Home 開啟 Global Routing,依目前需求選擇 Config、Proxy 或 Direct。Global Routing 控制已由客戶端接管的連線如何處理;SERVER 選擇代理路徑使用的伺服器;連線開關則決定客戶端是否建立網路設定。三者互相配合,但不是同一個開關。選好伺服器但仍使用 Direct,不會因清單中的選取標記就改走代理;將 Global Routing 設為 Proxy,也無法修正錯誤的伺服器參數。

三種模式的連線路徑與常見用途
介面文字連線處理方式適用情境
Config依目前設定的規則比對目標,並執行相應策略日常分流;驗證特定規則是否命中
Proxy由目前選取的伺服器代理處理流量短時間驗證代理路徑,盡量排除規則影響
Direct已接管的流量走直連路徑,不經所選代理伺服器建立直連對照;與完全關閉客戶端分別測試

Config 既是 Home 上的分流選項,也是管理設定檔的頁面名稱。差別在於:在設定頁面管理並選用設定檔;在 Home 選擇 Config,則是讓客戶端依目前生效的設定檔處理流量。只完成第一件事不會改變目前選取的全域模式;只完成第二件事也不會自動切換至剛匯入的檔案。排查特定規則時,請先記下實際生效的設定檔名稱、Global Routing 選項與目前伺服器,以免查錯檔案。

依序檢查規則與預設策略

常見分流規則會由上往下比對。先放範圍較窄的例外,再放範圍較廣的規則,最後以 FINAL 處理前面都未符合的連線。DOMAIN 適用於精確主機名稱;DOMAIN-SUFFIX 用來表示某個網域及其子網域範圍;DOMAIN-KEYWORD 依關鍵字比對,涵蓋範圍較廣,請留意是否也納入無關網域。使用網域規則時,請填主機名稱,而非包含協定、路徑與查詢參數的網址。服務通常不只使用一個網域,因此首頁可以連線,不代表登入、圖片或上傳要求也都符合同一條規則。

IP-CIDR 和 IP-CIDR6 分別依 IPv4、IPv6 位址範圍比對;GEOIP 依目標 IP 所屬地區比對,不是依使用者所在地或介面語言判斷。依 IP 判斷時,請留意解析結果是否可用,以及同一網域在不同網路下是否會解析到不同目標。PROXY、DIRECT、REJECT 則是比對成功後採取的策略,分別表示使用代理、直連與拒絕。網域與 IP 規則交錯時,應依希望優先符合的條件安排順序,而非單純按字母或類型分組。

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

這段 .conf 範例中,static.example.com 先符合精確規則,因此走 DIRECT;另一個位於 example.com 下的子網域,則符合後面的後綴規則,走 PROXY。若將兩條規則對調,原本的精確例外可能先被後綴規則涵蓋。範例最後一行表示其餘流量預設使用 PROXY,並不適用所有環境。將片段合併至現有設定檔時,請先備份,在原有的 [Rule] 區段選擇插入位置,並確認結尾仍只有預期的兜底邏輯;不要用整段內容覆蓋現有檔案。

驗證修改結果時,請重新發起連線,不要依賴已載入或仍在重複使用的連線。先測試一個應直連的目標,再測試一個應走代理的目標,最後選擇一個不在此次修改範圍內的目標,確認預設處理沒有意外改變。若 Proxy 正常,切回 Config 才發生故障,請優先核對比對順序、DNS 結果與使用中的設定檔。更多範例請參閱規則語法與比對順序。

05 / 驗證

建立連線並分層驗證

先確認目前網路可連線,再驗證代理

開始前,先確認裝置在未連線 Shadowrocket 時可以正常發出網路要求。若 Wi-Fi 有登入頁面,請先依網路業者提示完成登入;若裝置正從 Wi-Fi 切換至行動網路,請等網路穩定後再開始。選擇一個平常可連線的對照目標,並記下手機目前使用的底層網路。如此一來,應用程式內的測試失敗時,便能判斷是基本網路尚未連線,還是只有代理或分流路徑出問題。同一次測試中,不要同時更換網路、伺服器並修改規則。

回到 Home,在 SERVER 明確選取一台資訊完整且已知可用的伺服器,並核對 Global Routing。開啟連線,等狀態穩定後再執行 Connectivity Test。單次測試只能說明特定要求在當時網路與設定下是否成功,不能證明所有應用程式與網站都可用。不同測試目標的回應時間也不適合直接比較。接著使用瀏覽器或目標應用程式發出一個新要求;如果只有舊頁面看似可用,請重新整理或發出新要求,避免把快取內容誤認為連線成功。

顯示 Connected 但測試失敗時,不要立即認定系統授權有問題。Connected 表示客戶端已建立連線狀態,但不保證所選伺服器已完成遠端交握,也不保證網域解析或目標服務正常。反過來,瀏覽器無法開啟某個網站,也不代表整個連線中斷:可能只是目標服務無法使用,或該網站使用的多個網域套用了不同規則。此時請改測另一個已知可用的對照目標,核對時間與狀態,再決定下一步要檢查網路還是規則。

依據症狀,一次只變更一個項目

若關閉連線後一般網路也無法使用,請先處理裝置本身的網路問題;若未使用代理時可連線至對照目標,但 Proxy 下多個目標都失敗,請優先確認目前伺服器是否已選取、位址與連接埠是否正確,以及目前網路是否能連到該伺服器。切換至同一訂閱中一台已知可用的伺服器再測,不要同時修改加密或驗證資訊。若多台伺服器在同一網路下都失敗,再換用另一個可用網路進行相同測試,觀察故障是否隨著網路而變。

若 Proxy 可以正常連線至目標,但 Config 下失敗,請檢查生效中的設定檔是否包含較早比對的寬泛條件、REJECT,或與預期不同的 FINAL。若 Direct 成功而 Config 失敗,也不能只憑這個結果判定是哪條規則出錯:先確認實際命中的目標網域是否為頁面本文中的網址,必要時分別檢查目標應用程式連線使用的其他網域。使用暫時的測試模式後,請恢復平時使用的 Global Routing,再重新測試關鍵要求,避免日常使用時仍保留暫時選項。

遇到間歇性中斷時,還要記下發生前裝置是否鎖定螢幕、剛從 Wi-Fi 切換至行動網路,或剛更新訂閱。切換網路後,舊連線可能需要重新建立;可觀察新的要求是否恢復,不必反覆切換開關。若同一台伺服器在固定網路下穩定,只有自動切換時異常,請沿著這個方向檢查 On Demand、系統網路狀態,以及應用程式是否有重試。問題若無法穩定重現,請記下成功與失敗的兩種情境,通常比只留一張錯誤截圖更有用。

06 / 流量

檢視 Data 流量紀錄

先了解資料的統計範圍

Data 用來檢視客戶端記錄的流量。閱讀時,先確認頁面目前顯示的時間範圍、統計對象與單位,再看數值本身。可以先記下起始值,再進行一次操作,比較前後增量,而不只看累計總量。上行與下行分別代表傳送與接收方向;上傳檔案會主要反映在傳送方向,瀏覽圖片或影片則多反映在接收方向;網頁互動、同步與協定交握仍可能同時產生雙向流量。

裝置系統的行動數據用量、服務商的使用紀錄與 Data 並非同一份帳目。三者從不同位置記錄,統計週期可能不同,是否計入協定負擔、重傳及其他應用程式的活動也可能不同。更換網路後,用量分布會隨之改變,但不代表客戶端既有的累計紀錄會自動歸零。若要核對自己的連線用量,請以服務商採用的統計週期與計算方式為準;若要了解裝置實際使用多少行動數據,請查看系統本身的紀錄。

查看介面上的單位時,請分清累計量與速率:累計量表示一段時間內傳輸了多少資料,速率表示某段時間內傳輸的速度。檔案標示的大小不一定等於一次操作所增加的流量;快取、壓縮、重試及同時進行的背景同步,都可能使結果與預期不同。不同裝置的紀錄也不一定共用同一個計數器。例如在 iPad 上瀏覽的內容,不能因為使用同一份訂閱,就推定已計入 iPhone 的 Data 數值。

透過前後差值觀察單一操作

若要確認一次要求是否產生流量,請先停止不需要的主動下載,再記下目前累計值、網路類型、Global Routing 與伺服器備註。接著進行一項操作,例如開啟先前未載入的頁面;等待載入完成後回到 Data 查看變化。若看不出差異,先確認資料介面的顯示精度與更新時機,並檢查內容是否已存在快取中。在條件相同的情況下進行幾次小測試,通常比一次更改多項設定後觀察大幅變化更能說明問題。

若要比較 Config 與 Proxy 下的表現,請保持伺服器與底層網路一致,分別發出內容與大小相近的新要求。不要只重複開啟同一個已快取的資源,否則第二次增加的流量可能較少,這與分流無關。若介面提供更細的分類,請先確認分類標題的意思,再按相應方向與區間比較。若介面只顯示總量,流量增加只能作為有資料傳輸的線索,不能單憑它判定特定網域走 PROXY 還是 DIRECT;仍須回到規則與連線測試確認。

排查流量突然增加或紀錄未變

發現數值突然增加時,先記下發生時段,檢查是否剛開始播放影片、同步檔案、更新應用程式或執行背景復原工作,再比較主動停止該工作後的變化。若紀錄沒有變動,先確認連線仍然開啟、頁面已完成更新,而且要求不是來自本機快取。若實際連線異常,請依上一章檢查基本網路與連線模式,不要試圖清除統計紀錄來解決問題。清除紀錄前先保留必要的對照資料;之後比較時請寫明前後區間,不要把重新計數誤認為流量減少。

保留排查筆記時,只需記錄有用的範圍,例如操作項目、使用的網路及前後差值約為多少。請將短時間觀察與較長時間的用量核對分開:前者用來定位單次操作,後者則要統一起訖時間、裝置與計量方式。分享截圖或紀錄前,請遮住可辨識的位址、連線名稱、訂閱資訊與個人網路識別資料。如此既能保留分析線索,也不會將設定資料一併提供給無關人士。

07 / 設定

Settings 常用項目與自動連線

先建立手動連線基準,再啟用 On Demand

On Demand 用來依條件決定何時由系統觸發連線;Global Routing 則決定連線建立後如何處理要求。設定自動觸發不會自動選擇更適合的伺服器,也不會改寫規則;若手動連線本來就無法使用,啟用 On Demand 往往只會讓故障在更多時候發生。請先在常用網路驗證手動連線與 Config 路徑,再前往 Settings 尋找 On Demand,依需求選擇適用條件。設定後,分別測試應觸發與不應觸發的情境。

若設定介面提供 Wi-Fi 或行動網路條件,建議先只設定一種情境並記下原值,再讓裝置實際切換一次網路。稍候片刻,讓系統判定新的網路狀態,再回到 Home 查看連線狀況,並以新的簡單要求確認。頁面仍開著且舊要求持續有回應,不一定表示自動連線已在新網路上觸發。若某些情境不應自動連線,也請在這些情境中測試;不要在同一個網路下反覆切換開關,代替條件驗證。

需要暫時停用代理時,若手動關閉連線後又自動開啟,請先檢查 On Demand 是否仍符合觸發條件。排查時可以先暫停相關觸發條件,再中斷連線;測試結束後依照記錄恢復。若開關由系統管理設定控制,或自動連線由裝置的組織政策決定,不要將其視為應用程式偏好而強行覆寫。經常切換網路的裝置,請先測試一次鎖定螢幕後恢復及網路切換,再將自動連線設為日常選項。

確認問題後再調整 DNS 與測試方式

網域解析負責提供目標位址,與代理伺服器能否連線是不同層次。若只有部分網域連線失敗,或同一條規則在不同網路下表現不一,請先確認是否使用目前設定檔指定的 DNS 行為,以及系統或網路是否也提供自己的解析服務。變更 DNS 後,同一網域可能取得不同的 IPv4 或 IPv6 位址,進而影響 GEOIP、IP-CIDR 等規則。請先記下原本生效的設定,再一次只修改一項,使用相同網路與目標重新檢查;不要同時更換解析方式、切換伺服器並重排規則。

若介面允許指定 Connectivity Test 的測試目標或方式,請選擇長期可用且適合對照的目標。修改測試目標是為了取得更容易解讀的結果,不是為了讓逾時數字變得好看。某個目標突然失敗時,應先確認它本身是否可連線,再判斷伺服器是否有問題。切換測試方式後,新舊結果測量的連線路徑可能不同,不能直接用數值判定伺服器變快或變慢。記錄測試條件,比只保留一個孤立數字更方便日後檢視。

分清設定、設定檔與伺服器參數

修改前先確認設定所屬層級:一般行為通常在 Settings 查看,分流規則則查看實際生效的 Config,單一連線的協定參數則查看 SERVER 中對應項目。不同裝置的版面或可用選項可能不同,不要因找不到某個項目就任意替換整份設定檔。遇到權限提示也應依用途判斷:掃描 QR Code 才需要相機存取權;系統 VPN 設定用於建立連線;這些授權都無法修正位址、驗證或規則錯誤。

每次變更一個項目,都記下原值、新值、變更原因與測試結果。重要變更前先建立可還原的副本,並為測試設定檔取一個不同於日常設定檔的名稱。若結果沒有改善,先還原再嘗試下一項,避免留下多處互相影響的臨時變更。更新後若介面位置改變,請依英文項目名稱與設定用途尋找,不要照著舊截圖的位置盲目點選。也可參考設定說明與介面用語速查。

08 / 維護

更新、移轉與故障復原

分開更新客戶端、訂閱與規則

客戶端更新、訂閱重新整理與規則變更各有不同用途。客戶端更新可能改變介面與實作;重新整理訂閱主要會更新由服務商維護的伺服器清單;修改 Config 則可能改變哪些要求走代理或直連。最好不要在同一次維護中一併修改這三項。先記錄目前可正常運作的狀態,再逐項變更、逐項驗證。若出現異常,便可依此還原或檢查最近的變更,而不是在三個方向反覆嘗試,最後無法確認是哪一步造成故障。

iPhone 和 iPad 請在 App Store 查看已安裝的應用程式與更新;Mac、Windows、Android 和 Linux 請透過客戶端下載頁進入對應平台,重新取得本站提供的安裝項目。Mac 更新前仍須確認選擇 Apple 晶片版或 Intel 版;Linux 也要確認是沿用原本的套件格式,還是改用其他格式。不要把切換架構或套件格式當成一般覆蓋更新。若看到新系統的相容性提示,請先了解提示內容並備份設定,再依裝置原有方式完成安裝或更新。

重新整理訂閱前,先記下目前選取的伺服器與群組;重新整理後確認重要項目仍存在且可供選取。若舊伺服器已移除,請從現有清單選擇一台已知參數完整的伺服器重新驗證。保留可還原的設定副本,規則修改先在副本上進行;若只有 Config 會造成故障,請切回最近可正常使用的副本作為對照。維護操作應針對已確認的問題:應用程式無法啟動先檢查安裝,清單有變化先檢查訂閱,比對不符先檢查規則。

換機前整理可取回的資料

更換裝置或重新安裝前,請列出目前生效的設定檔名稱、訂閱的重新取得管道、是否有手動輸入的伺服器,以及正在使用的 On Demand 條件。重要資料請依介面提供的匯出或備份方式保留副本,並確認目標裝置能找到及讀取。訂閱網址、驗證資訊與私鑰都可能讓他人使用你的連線,副本應存放於只有本人或獲授權人員能存取的位置。截圖只能協助記憶介面,不能取代設定檔與完整連線參數。

移轉時,請分開處理還原應用程式與還原設定。在 iPhone 或 iPad 上使用原購買帳號取回應用程式後,先確認可以啟動並完成系統授權,再逐項還原訂閱、手動伺服器與設定檔。若已看到應用程式但設定清單為空,不代表購買失敗;請從備份或服務商提供的資訊繼續還原。新裝置連線前,先確認舊裝置仍可恢復使用。待新裝置完成手動連線、重要規則與自動連線的驗證後,再決定是否清除舊裝置上的憑證與備份。

保留最精簡的可用狀態與複測清單

遇到無法定位的功能退化時,先回到一台已知可用的伺服器、一份已驗證的設定檔與手動連線狀態。依序確認系統能建立連線、代理路徑能處理一個對照要求,以及 Config 能分別符合預期的直連與代理規則。這個順序能分別檢查系統權限、伺服器與分流。基準狀態恢復正常後,再逐項恢復訂閱更新、其他規則與 On Demand;恢復到哪一步再次出現異常,就從該步驟開始排查。

日常只需定期複測少數重要情境:常用 Wi-Fi 與行動網路各一次、一個預期直連的目標、一個預期走代理的目標,以及實際使用的自動連線條件。問題重現後,記下發生時段、觸發操作與最後一個明確成功的步驟,不要附上完整訂閱或驗證資訊。若要重新走過一次設定流程,請返回快速入門;若已能說明故障發生在哪一步,請依照疑難排解中的相似狀況繼續檢查。