官方手冊 · 依操作階段查閱

Shadowrocket 完整使用手冊 安裝、訂閱與規則分流

先建立可驗證的連線,再調整規則與設定。本頁涵蓋各平台取得方式,後續操作以 iPhone / iPad 介面為例;其他平台的欄位位置請以實際介面為準。

iPhone / iPad:在 App Store 一次性付費 $2.99;Mac(Apple 晶片與 Intel)、Windows、Android、Linux:免費。

  • 取得 → 權限 → 匯入 → 分流
  • 驗證 → Data → Settings → 維護
  • 使用者已有的訂閱或伺服器資訊

快速入門依首次連線的順序帶你完成一套操作流程;本頁是系統化查閱手冊,說明每個步驟的前提、判斷方式與故障處理分支。初次使用可先完成教學,再依下方目錄查閱。已安裝的使用者可直接前往目前問題所在的章節。

01 / GET & INSTALL

取得 Shadowrocket 與允許安裝

先依裝置選擇安裝管道,再準備連線所需資訊。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費;電腦與 Android 安裝檔由本站 /dl/shadowrocket/ 路徑提供。請統一從下載頁的全平台清單選擇,不要只憑搜尋結果中的相似名稱判斷檔案。安裝應用程式、匯入伺服器資訊與建立連線是三個獨立步驟;安裝完成不代表已具備可用的代理連線。

iPhone / iPad:先核對 App Store 項目

在 App Store 產品頁核對名稱 Shadowrocket、開發者 Shadow Launch Technology Limited、App ID 932747118,並比對官方圖示。系統需求請以 App Store 頁面標示為準。商店顯示的幣別與供應狀態取決於帳號所屬店面;若搜尋不到,請先確認帳號地區、內容存取限制與付款狀態,勿將名稱相近的應用程式視為同一項產品。如需調整帳號地區,請透過系統帳號設定操作,並先閱讀其中關於餘額、訂閱與付款方式的提示。

若已有購買紀錄,先確認目前登入的是當初購買時使用的 Apple ID,再到已購項目中搜尋。更換裝置或重新安裝不代表需要再次購買,但能否找到項目仍取決於帳號紀錄及目前商店的供應狀態。iPhone 和 iPad 使用同一購買帳號時,可依商店規則重新下載。查找紀錄的詳細步驟請參閱已購項目還原說明。安裝完成後先不要匯入所有設定,請先確認應用程式能正常啟動。

電腦與 Android:選擇相符的安裝檔

Mac 提供 Apple 晶片版與 Intel 版兩種安裝選項。請在系統「關於這台 Mac」中查看晶片或處理器資訊,選擇相符的檔案,不要依裝置外觀或購買年份猜測。Windows 請使用相應的安裝程式;Android 請確認裝置架構符合下載頁標示。Linux 請依系統的套件管理方式選擇 deb、rpm 或 AppImage。不同格式用途各異,不可只更改副檔名互相替代;企業或學校管理的裝置也可能受到安裝政策限制,請先確認是否允許自行安裝。

系統提示處理位置操作前提
macOS 無法驗證開發者系統設定 → 隱私權與安全性 → 仍要打開確認檔案來自本站下載頁
Windows SmartScreen更多資訊 → 仍要執行確認所選安裝檔
Android 限制安裝允許安裝未知應用程式僅允許本次使用的安裝來源
Linux AppImage 無法執行授予檔案執行權限確認檔案架構與系統相符

這些電腦與 Android 安裝檔沒有程式碼簽署,首次開啟時可能出現系統提示。請先確認下載來源,再依表格中的位置處理;不要只為了開啟單一應用程式,就長期關閉整套系統防護。Mac 若提示應用程式「已損毀」,請確認檔案已完整下載並移至 Applications,再使用下方指令清除該應用程式的隔離屬性,然後重新嘗試開啟。指令僅作用於列出的應用程式路徑,不應擴及整個磁碟;輸入前請確認路徑中的名稱與實際安裝位置相符。

xattr -cr /Applications/Shadowrocket.app

Linux 使用 AppImage 時,可在檔案屬性中授予執行權限,或對實際下載的檔案使用 chmod +x;deb 與 rpm 應交由系統套件管理工具處理相依項目。安裝失敗時,請優先記下系統提示、處理器架構與安裝格式,再查閱安裝允許方式說明。不要接連嘗試不同架構的檔案碰運氣。安裝完成後,保留下載來源與安裝格式紀錄,方便日後沿用相同管道更新。

02 / FIRST LAUNCH

首次啟動與權限確認

首次啟動時先熟悉各功能入口,再決定何時授權。以下以 iPhone / iPad 為例:Home 用於查看伺服器與連線狀態,Config 用於管理規則設定,Data 用於查看連線與流量,Settings 用於調整用戶端行為。不同系統或介面更新可能改變項目位置,但伺服器參數、分流模式與系統連線權限的用途仍須分開理解。暫時找不到選項時,請先依功能類別尋找,不要直接刪除應用程式來重設介面。

連線權限與伺服器資訊是兩回事

首次啟動連線時,系統可能會要求允許新增 VPN 設定。只有在 Shadowrocket 剛發起連線,且系統對話框顯示的應用程式名稱符合預期時才確認,並依系統要求驗證裝置。這項權限用於建立系統層級的網路接管,不會自動補上伺服器位址、密碼或訂閱內容。若選擇取消,通常可返回應用程式重新發起連線,再依提示處理;不要把權限遭拒誤判為伺服器失效,也不要反覆修改協定欄位。

若系統中已有其他網路設定,請先確認目前究竟由哪一項建立連線。多個接管網路的設定、裝置管理政策或系統層級的過濾設定可能互相影響。為了取得可重現的結果,首次測試時只保留目前需要的連線方式,記下原有設定後再調整。受管理的裝置可能不允許新增或修改 VPN 設定,這類限制應由裝置管理方處理;在應用程式內更換伺服器通常無法改變系統政策。權限問題與網路連線問題應分開排查。

依實際操作授予其他權限

只有使用 Scan QR Code 時才需要相機存取權限;從照片辨識 QR Code 時,請依系統提示選擇必要的照片存取範圍。QR Code 中的連線資訊可能包含密碼、金鑰或訂閱憑證,不應將掃描畫面傳到公開討論區。拒絕相機權限不會影響手動填寫 Add Server,因此可先手動驗證欄位。若先前拒絕存取,請前往系統中該應用程式的權限頁面調整,再回到原本操作,不要反覆重試掃描。

本機網路權限取決於要存取的目標。若要連線至區域網路中的伺服器或存取家中裝置,請確認系統是否允許相關存取;若只是在處理遠端連線,不要將所有失敗都歸咎於這項設定。若只有區域網路位址無法連線,可先確認裝置位於相同網路、目標裝置已開機且服務連接埠正在監聽,再檢查規則是否將本機位址導向錯誤策略。分別驗證權限、位址與規則,才能避免一次改動太多條件。

首次設定前先建立最簡要的紀錄

開始匯入前,記下目前使用 Wi-Fi 或行動網路、系統是否已有 VPN 設定、應用程式的連線開關是否關閉,以及準備使用手動伺服器或既有訂閱。無須記錄密碼,只要記下資訊來源與操作順序。發生錯誤時,這些紀錄有助於判斷問題出在新增權限、儲存資料或實際連線階段。若介面中已有舊項目,請先確認用途;不清楚的舊設定可暫時停用,確認不再需要後再刪除,以免遺失仍有用的規則。

建議先維持預設設定,不急著啟用 On Demand、不一次新增多份 Config,也先不要更換 DNS。先讓一台參數完整且已知的伺服器成功連線,再逐項新增功能。每次調整前記下原值,調整後只進行一輪相同的驗證。若出現明顯異常,請還原剛才變更的項目,不要再疊加其他設定。依此順序操作,可將問題縮小到較容易排查的範圍,也能避免把權限、設定與遠端服務問題混為一談,籠統地判定為「無法使用」。

03 / SERVER & SUBSCRIBE

新增既有伺服器與訂閱

先判斷取得的是單筆伺服器資訊、單筆分享內容,還是包含多台伺服器的訂閱網址。單筆資訊通常對應一種協定與一組驗證欄位;訂閱則是用來取得並更新一組項目的入口。兩者外觀可能都是連結,但不可隨意填入同一個輸入欄位。所有資料都應來自使用者自己的既有服務資訊。首次匯入前,請確認內容沒有因通訊軟體換行、插入空格或遭截斷,尤其要確認網址結尾完整;複製後也不要公開顯示其中的憑證。

Add Server:依協定逐項填寫

在 Add Server 中先選擇類型,再填寫對應欄位。伺服器位址應填主機名稱或 IP,連接埠填入服務提供的數字,不要把協定前綴、網頁路徑或連接埠一併填進位址欄。備註僅供辨識,可依用途命名;備註正確不代表連線參數正確。選錯協定類型時,其他欄位即使看起來相似也不能通用。填妥後逐項核對,再儲存為獨立項目;先不要同時新增多筆相似設定,以免測試時選錯。

協定重點核對欄位常見注意事項
Shadowsocks位址、連接埠、加密方式、密碼加密方式必須與伺服器端一致
VMess / VLESS位址、連接埠、UUID、傳輸參數傳輸與 TLS 參數不可憑經驗套用
Trojan位址、連接埠、密碼、TLS 參數驗證密碼與憑證名稱用途不同
WireGuard金鑰、端點、位址、路由範圍區分本機私鑰與對端公鑰
Hysteria2位址、連接埠、驗證資訊、TLS 參數網路必須允許相關 UDP 通訊

啟用 TLS 的連線中,連線位址與憑證驗證名稱不一定相同,請依既有設定提供的資訊填寫。使用 WebSocket 傳輸時,路徑與 Host 也是協定約定的一部分,少一個字元就可能導致交握失敗。不要為了讓測試數字出現而關閉憑證驗證,也不要把所有空白欄位都填成伺服器位址。缺少重要參數時,請回到原始設定確認;用戶端無法只憑協定名稱推斷伺服器端的所有設定。

Subscribe:保留群組與來源關聯

新增既有訂閱時,選擇相應的訂閱類型,將完整網址填入 URL 欄位並儲存,接著執行更新並等待清單載入。替訂閱設定容易辨識的備註,方便日後區分來源與批次管理。更新後先確認是否新增伺服器項目,再選取其中一筆驗證。若清單為空,請先確認網址仍有效、網路能取得訂閱回應,以及內容是否為用戶端可辨識的資料;網頁能開啟,不代表回傳內容就是可匯入的訂閱。

訂閱更新通常會重新產生其管理的項目,因此直接修改訂閱中的某台伺服器欄位,可能在下次更新時被覆蓋。需要暫時進行對照測試時,請保留原訂閱,並在可清楚區分的獨立項目中修改;測試完成後再清除暫存項目。多份訂閱出現相同名稱時,不要只憑名稱刪除;應核對所屬群組、位址與協定。相關整理步驟請參閱多訂閱管理說明,避免誤刪仍在使用的群組。

QR Code、匯入結果與憑證保護

Scan QR Code 適合匯入既有單筆資訊,但必須檢查辨識後的類型與欄位,不能只看「匯入成功」。QR Code 也可能包含訂閱網址,因此匯入後要確認取得的是獨立伺服器,還是訂閱群組。Import from Cloud JSON 等入口只適用於對應格式,不可將任意文字更改副檔名後匯入。無論使用哪種方式,儲存後都應重新開啟項目檢查重要欄位,確認沒有因格式不相容而遺漏驗證或傳輸參數。

訂閱網址可視為存取憑證;螢幕截圖、記錄檔與匯出的設定都可能包含敏感資訊。向他人說明錯誤時,只保留協定名稱、錯誤類別與已隱去敏感內容的欄位結構。若網址曾意外公開,請在原資訊管理處理憑證變更,再更新用戶端中的紀錄。匯入完成只代表資料已儲存;接下來還要選擇正確的伺服器與 Global Routing 模式,並實際驗證連線,才能確認這些資料在目前網路下可用。

04 / GLOBAL ROUTING

Global Routing 三種模式與規則順序

Global Routing 決定由用戶端接管的連線要採用哪種策略。配置、代理、直連分別對應 Config、Proxy、Direct。它們不是三台伺服器,也不是三種協定:伺服器項目說明「如何連線至遠端」,模式則說明「何時使用哪條路徑」。排錯時必須同時記錄目前模式與所選伺服器,否則同一網站在不同模式下結果不同,容易被誤認為連線不穩定。先了解三者用途,再新增複雜規則,通常比反覆切換模式更容易取得穩定結果。

介面模式判斷依據適合的驗證方式
Config · 配置依目前啟用的設定中的規則決定策略檢查目標命中的規則與最終策略
Proxy · 代理將接管的連線交由代理路徑處理驗證所選伺服器能否實際連線
Direct · 直連將接管的連線交由直連路徑處理建立本機網路存取的對照結果

選擇 Config 不等於已啟用某份檔案

選擇 Config 後,還要確認 Config 頁面中實際啟用的是哪份設定。匯入檔案、編輯檔案與選取啟用是不同操作。設定中可能包含規則、策略群組、DNS 等內容,其中的策略名稱必須對應到可用策略。若檔案使用自訂策略群組,但本機沒有相應定義,即使語法看起來完整,也可能無法依預期執行。初次使用時應先閱讀設定的主要內容,避免不了解預設策略便整份取代現有設定。

從具體規則到兜底規則

規則通常依序比對,較具體的條件應放在較寬泛的條件之前,FINAL 則作為最後的兜底規則。DOMAIN 比對完整網域名稱,DOMAIN-SUFFIX 依網域後綴比對,DOMAIN-KEYWORD 依網域中的關鍵字比對;關鍵字涵蓋範圍容易過廣,不要只因一筆請求異常就加入常見短詞。IP-CIDR 與 IP-CIDR6 用於位址網段,GEOIP 則依賴 IP 位址歸屬資料。網域比對與位址比對的輸入條件不同,兩者不能視為完全等同。

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

上例只是用來說明順序的規則片段,並非可涵蓋所有網路需求的完整設定。第一行將範例網域交由 PROXY 處理,第二行讓列出的區域網路網段使用 DIRECT,接著依位址歸屬判斷,最後由 FINAL 接手尚未比對的連線。PROXY 與 DIRECT 是規則策略關鍵字,介面中的 Proxy、Direct 則應保留原本的大小寫寫法。複製時不要混入全形逗號或多餘引號;儲存後先確認檔案正常載入,再測試對應目標。

區域網路位址不只範例中的一個網段,實際規則應依網路架構安排;IPv6 位址也須另外考量。若請求透過網域名稱發出,DNS 解析結果可能影響後續位址規則判斷。因此看到某個 IP 直連時,不能只憑網域後綴推斷比對過程。排查時應查看實際連線記錄中的目標、命中規則與策略,確認是已命中網域規則,還是進入位址判斷或 FINAL。若缺少記錄,請先用少量明確規則建立對照。

用三種模式隔離問題

某個目標在 Proxy 下可存取、在 Config 下失敗時,請優先檢查規則順序、策略群組選擇與目前設定中的 DNS,而不是立刻重建伺服器。若 Proxy 下也失敗,再檢查伺服器參數、目前網路與遠端服務。Direct 僅用來建立直連路徑的對照,不保證所有目標都能連線。測試時一次只變更模式,維持相同伺服器、網路與存取目標,才能讓結果具有可比性;測試完成後再切回日常使用的模式。

修改規則前先複製一份設定作為還原點;每次只新增解決目前問題所需的規則,並記下修改目的。規則越多不一定越準確,重複項目與互相覆蓋的寬泛條件反而會增加維護成本。USER-AGENT 等條件也有適用範圍,不要假定所有加密連線都會提供可供比對的應用層資訊。不要為了命中某項條件就隨意啟用額外的解密設定;先確認現有網域、位址與策略規則是否已足以解決問題。

05 / CONNECT & VERIFY

建立連線與分層驗證

連線驗證應從最短路徑開始:確認本機網路正常、選定一台伺服器、記錄目前模式,再開啟連線開關。首次出現系統權限提示時,請依第二章處理。觀察應用程式是否維持連線狀態,以及是否立即出現錯誤;但不要把連線開關保持開啟當成驗證完成。完整路徑還包括伺服器交握、網域解析、目標連線與應用程式請求;任何一層出錯都可能讓網頁持續等待,因此應逐層定位,而不是反覆切換連線開關。

先判斷測試數字代表什麼

解讀 Connectivity Test 結果時,應一併考量所選的測試方式。不同測試可能只涵蓋網路往返、連接埠連通或某項 HTTP 請求,不一定會執行與實際使用相同的完整流程。顯示延遲不代表驗證欄位全部正確,也不代表持續傳輸速度、影片載入或特定應用程式一定正常。沒有結果也可能與測試目標或方式有關。請保留測試方法與網路環境,在相同條件下比較結果;不要直接將不同類型的數值放在一起排名。

首次驗證建議先使用一台設定明確的伺服器,在 Proxy 模式下開啟日常能辨識結果的網頁,確認看到的是新內容而非快取頁面。接著測試實際需要使用的應用程式,最後切回 Config 檢查規則路徑。每次切換模式或伺服器後,都應重新發出請求;部分應用程式會沿用既有連線,即使設定已變更,舊連線仍可能繼續使用先前路徑。必要時關閉目標應用程式再重新開啟,但不必每次測試都重開整台裝置。

依照現象分別檢查

若開啟連線後所有目標都失敗,先關閉連線,確認基礎網路是否正常,再檢查所選伺服器、驗證參數與系統 VPN 狀態。基礎網路本身無法使用時,修改規則並不能解決問題。若只有部分網域失敗,請查看是否有錯誤的網域規則、DNS 回應異常或目標服務本身故障。若網頁可存取但特定應用程式失敗,請進一步確認該應用程式使用的網域、協定與既有長連線,不要用瀏覽器一次成功取代對目標應用程式的實際驗證。

連線逾時與驗證失敗應分開處理。逾時時應優先檢查位址、連接埠、網路連通性及遠端服務是否正在監聽;驗證錯誤則應重新核對密碼、UUID、金鑰或協定欄位。TLS 相關錯誤應檢查裝置時間、憑證名稱與傳輸設定,不可一概透過關閉驗證來處理。若訂閱剛更新,也要確認目前選取的項目是否已變更,避免排錯時一直修改舊項目,實際連線卻使用另一筆紀錄。

可重現的現象優先檢查項目下一步對照
關閉連線後仍無法上網基礎網路、登入入口恢復基礎網路後重試
Proxy 成功,Config 失敗規則、策略、DNS查看目標連線的命中結果
Wi-Fi 失敗,行動網路成功網路限制、解析、UDP 連通性維持相同伺服器重新測試
網頁成功,特定應用程式失敗目標請求與長連線重新建立目標應用程式連線並查看記錄

切換網路時維持其他條件一致

在 Wi-Fi 與行動網路之間切換,有助於判斷異常是否與目前網路有關。切換時請維持相同伺服器、模式與目標,並等待系統網路狀態穩定後再測試。公共 Wi-Fi 可能要求先透過登入入口驗證,請依網路要求完成登入,再建立用戶端連線。登入入口尚未完成時,不要連續更新訂閱或更換 DNS;這會讓原本屬於基礎網路的問題看起來像多項功能同時故障,也會增加無效的錯誤記錄。

驗證結果也應考量連線是否持續穩定。網頁成功開啟一次,只能證明當時有一條路徑可用;還可觀察一段正常使用過程,確認是否反覆重新連線、是否只在鎖定螢幕後中斷,或是否只有大型檔案及 UDP 應用程式異常。不同現象可能指向不同層面:鎖定螢幕後的問題可檢查系統與隨選連線行為,特定傳輸問題則可檢查協定與網路支援。不要只以單次延遲高低作為判斷依據;測試限制請參閱延遲測試與實際存取說明。

06 / DATA & CONNECTIONS

Data 流量與連線記錄

Data 用於了解連線期間發生的狀況,不能取代遠端服務的帳戶紀錄。查看流量前,先確認頁面顯示的是即時速率、累計流量或單筆連線資料,以及統計從何時開始。不同介面或統計項目的涵蓋範圍可能不同,不能直接將某個數值視為整台裝置在電信業者處的計費流量。正確做法是固定時間範圍與操作條件,觀察某次請求是否留下記錄、採用何種策略,以及資料是否持續傳輸。

區分速率、累計量與連線數

速率反映短時間內的傳輸變化,累計量表示某個統計週期的總量,連線數則描述請求或工作階段的數量,三者沒有簡單的一對一關係。持續下載可能只建立少量連線,卻傳輸大量資料;單一網頁也可能因多個網域、圖片與背景介面而產生許多連線。連線數較多不代表一定異常;應結合當時執行的應用程式與請求目標,確認是否符合實際使用情境,再決定是否需要排查。

上傳與下載方向通常以本機為基準,但閱讀特定統計時仍應確認標籤與統計口徑。背景相片同步、系統更新、雲端儲存與媒體預載,都可能在沒有明顯前景操作時持續產生流量。懷疑統計異常時,先暫停已知的大流量工作、關閉無關應用程式,再單獨開啟一個目標觀察增量。不要只憑瞬間峰值就認定流量外洩,也不要把頁面重新整理後顯示歸零,解讀為先前資料沒有經過網路。

透過連線記錄驗證規則結果

排查規則時,連線記錄比「網頁是否開啟」更能說明原因。依介面實際提供的欄位,查看目標主機或位址、比對規則、最終策略、所選伺服器與錯誤訊息。先發出容易辨識的新請求,再回到記錄中找出對應項目。若同一個應用程式同時連線多個網域,應逐一確認用途,不要看到其中一筆是 DIRECT 就推斷整個應用程式都在直連。應用程式登入、內容載入與媒體播放可能分別連到不同目標。

每筆記錄中不一定都會完整顯示網域名稱。部分請求會直接使用 IP,或因解析與連線之間存在快取,記錄中可能主要顯示位址資訊。此時應結合請求時間、目標應用程式與規則條件判斷,不要只憑陌生位址就新增大範圍封鎖規則。若已修改設定卻仍看到舊策略,請先確認目前啟用的檔案、儲存結果及是否建立了新連線。沿用舊連線會讓最新規則尚未參與該工作階段的判斷。

理解用戶端與其他統計的差異

用戶端累計量、系統網路用量與遠端帳戶流量不同,不一定代表記錄錯誤。統計起訖時間、是否計入直連流量、協定封裝、重試,以及遠端的計量方式都可能造成差異。比較時應先對齊統計週期,並確認只比較相同範圍。尤其不要用用戶端顯示的總量推算遠端帳戶的剩餘額度;後者應以使用者自己的帳戶紀錄為準。Data 主要用於觀察行為與定位問題,不是結算依據。

若要驗證某條規則,可先記錄測試前狀態,接著只執行一個動作,例如重新開啟某個網頁,再觀察新產生的連線。判斷完成後,恢復正常使用。與背景工作繁多時翻找記錄相比,這種短時間測試更容易釐清狀況。若懷疑正在循環重試,應先停止目標應用程式或關閉連線,避免繼續產生大量重複請求,再檢查錯誤原因。不要放任異常持續重試,又不斷清除記錄,否則很難保留真正有用的脈絡。

分享記錄前先處理敏感資訊

連線記錄可能暴露存取目標、內部網路位址、伺服器資訊與使用時間;詳細記錄也可能包含設定中的憑證。傳送螢幕截圖前,先裁切無關區域並遮蔽敏感內容,只保留必要錯誤與欄位。完成排錯後,依實際需要關閉額外的詳細記錄,避免長期累積日常使用不需要的資料。若要重設累計統計,請先記下統計範圍與重設時間;重設只會改變本機記錄,不會改變已發生的網路傳輸或遠端帳戶用量。

07 / SETTINGS

Settings、DNS 與 On Demand

Settings 中的選項可調整用戶端行為,但不能取代正確的伺服器參數與規則。進入設定前,先明確定義目標:是否要在特定網路自動建立連線、修正網域解析,或變更測試方式。若無法說明要解決的現象,請先保留目前設定。不同平台與介面中的項目位置可能不同,設定檔也可能包含相關設定;修改前應確認目前值由何處控制,避免在設定頁變更後又被已啟用的設定覆蓋。

DNS:先查看解析結果,再更改解析路徑

DNS 負責將網域名稱轉換為位址,代理則負責後續連線路徑,兩者相關但不相同。網域無法解析時,即使伺服器連線正常,也可能無法完成存取;解析出位址後,連線仍可能因規則或遠端問題而失敗。排查時先分清楚是沒有解析結果、結果不如預期,還是已有結果但連線逾時。不要把所有載入緩慢都歸咎於 DNS,也不要因某個解析位址在其他網路可用,就假定它適用於目前的網路與規則組合。

選擇解析方式時,還要考量解析請求本身經過哪條路徑、解析服務是否可連線,以及後續位址比對會受到什麼影響。若使用必須經代理才能存取的解析服務來進行建立代理前必要的解析,可能造成相互依賴。為避免此問題,請先確認伺服器位址在目前網路下可解析,並從簡單明確的設定開始驗證。每次只變更一項解析相關設定,重新發出請求並查看記錄;必要時等待快取更新後再判斷。

混用網域規則與 IP 規則時,DNS 回傳的 IPv4、IPv6 位址與快取狀態都可能改變比對結果。若只有某個位址族失敗,應檢查目前網路是否能連線,並核對設定中的位址規則,不要直接對所有請求套用同一種解法。修改後應驗證常用網頁、區域網路裝置與目標應用程式,確認沒有修好一個目標卻改變其他目標的路徑。能還原的原始設定,比毫無紀錄地連續嘗試更有價值。

On Demand:先驗證手動連線

On Demand 會依設定條件觸發連線,無法自動修復錯誤的伺服器資訊。請先確認手動連線穩定,再逐項設定隨選連線行為。設定時檢查條件範圍與先後關係,例如網路類型或指定網路是否符合預期;不要只開啟總開關,就認定所有情境都會自動連線。儲存後,分別在預期應觸發與不應觸發的網路環境中測試,並查看系統 VPN 狀態與實際請求,確認動作符合條件。

啟用隨選連線後,手動關閉連線時,系統可能在條件再次符合時重新觸發連線。這不一定代表開關故障;請先查看 On Demand 是否仍啟用及其比對條件。若要暫時排錯或恢復基礎網路,請先停用隨選連線,再手動中斷連線;完成後依原紀錄還原。切換網路、鎖定裝置螢幕與退出應用程式是不同事件,只驗證其中一種,不能據此認定所有情境都可靠。遇到管理政策限制時,應分辨是系統限制還是應用程式條件設定。

測試方式、記錄與其他開關

Connectivity Test 相關設定會影響測試目標與結果代表的意義。變更測試方式後,應重新建立比較基準,避免將前後不同口徑的數字拿來下結論。只有在需要時才開啟詳細記錄;先記下異常發生順序,再重現一次並查看對應錯誤,完成後恢復日常記錄層級。與憑證、解密或請求改寫相關的項目不是首次連線的必要設定;未確認明確需求與權限前,不應只為了「讓規則更完整」就啟用,更不可安裝來源不明的憑證。

完成設定調整後,回到 Home 確認所選伺服器與模式沒有變更,再驗證一組固定目標,並在 Data 查看實際策略。若新設定沒有改善原問題,應先還原再嘗試下一項,不要把一次測試的變更留作長期設定。建議保留簡短的變更紀錄,只記下原值、修改目的與驗證結果,不要記錄任何憑證。需要排查特定問題時,可前往常見問答頁依症狀比對,不要一次修改所有看似相關的開關。

08 / MAINTENANCE

訂閱更新、備份與日常維護

日常維護的目標是保留一份容易理解且可還原的設定,而非不斷增加伺服器與規則。建立穩定連線後,記下目前有效的訂閱群組、啟用中的設定、常用模式與少量必要的設定差異。紀錄中只需保留用途與關聯,不要將驗證資訊寫進一般筆記。每次準備大幅修改前,先確認現有連線仍可使用,再建立還原點;如此即使後續更新發生異常,也能判斷問題是原本就存在,還是由這次變更造成。

分別更新訂閱與應用程式

訂閱更新會取得使用者既有訂閱中的伺服器清單與相關資訊;應用程式更新則會更新用戶端本身,兩者是不同操作。訂閱更新失敗時,先保留現有項目,不要急著刪除整個群組再重新新增。請檢查目前網路能否連上訂閱網址、原網址是否仍有效,以及回傳內容是否正常。若原有伺服器仍可使用,可先維持目前連線,再處理更新入口;刪除訂閱可能一併移除其管理的項目,使排錯失去可用的對照。

更新後請檢查群組數量、常用項目是否仍存在,以及目前選取項目是否已被替換。名稱相同的項目也可能變更位址或協定參數,因此應重新實際存取一次進行驗證。自行新增的暫存測試項目應及時標記,並在測試完成後刪除,以免與訂閱項目混淆。管理多份訂閱時宜依來源分組,不要只用地區名稱作為辨識依據。遇到重複項目時,先核對所屬群組與用途,再進行清理,不要依名稱批次刪除所有相似項目。

更新用戶端時保留可還原資料

iPhone / iPad 的應用程式更新由 App Store 管理;Mac、Windows、Android 與 Linux 請從本站下載頁取得相應的新安裝檔。更新前先備份必要設定並確認原有資訊可還原,不要為了更新就刪除應用程式與所有資料。電腦安裝前應先退出正在執行的用戶端,並使用正確的架構與安裝格式;首次開啟新版時若再次遇到系統阻擋,仍請依第一章核對來源並允許安裝,不要因曾經安裝過就省略來源確認。

備份內容應包含伺服器資訊、既有訂閱入口、目前啟用的 Config 與重要設定;但實際匯出範圍仍應以匯出介面為準,不要假設單一檔案包含所有內容。匯出後請確認檔案可辨識,並妥善保存於自己掌控且受保護的位置。設定檔可能含有密碼、私鑰與訂閱憑證,不應放在公開雲端硬碟連結或討論區。移轉至另一台裝置時,應先還原最低限度的必要資料並驗證連線,再移轉其餘規則,避免一次匯入後難以定位相容性問題。

更換裝置、還原與長期失效處理

更換裝置後,先取得應用程式,再還原使用者資料。iPhone / iPad 版在 App Store 一次性付費 $2.99;Mac / Windows / Android / Linux 版免費。已有購買紀錄的使用者,請使用原購買帳號前往已購項目搜尋;其他平台則從本站重新下載即可。購買紀錄只能協助恢復應用程式的取得資格,不會自動還原所有本機設定,也無法恢復使用者自己的遠端服務資訊。應用程式安裝、資料備份與遠端帳戶應分開管理,不要將它們視為同一份資料。

若問題持續發生,請依固定順序回溯:先檢查基礎網路與系統時間,再確認連線權限、目前伺服器、Global Routing、啟用中的設定與 DNS,最後核對遠端參數是否有所變更。每一步都保留可重現的現象;若剛完成更新或修改規則,先還原至最後一個已知有效狀態進行對照。不要同時重新安裝應用程式、清除資料並替換所有參數;即使恢復連線,也無法得知真正原因,還可能遺失之後仍需要的資訊。

日常檢查不必頻繁清除統計、反覆測速或不斷切換伺服器。只有出現新現象、網路環境變更或完成設定更新後,才需要進行有明確目標的驗證。需要尋求協助時,請整理系統類型、網路環境、所選模式、錯誤類別與已完成的對照步驟,並隱去敏感資訊。想依操作流程重新核對,可返回快速入門;想排查 App Store 搜尋問題,可參閱App Store 搜尋問題排查;其他常見狀況請查閱分類問答。