官方手冊 · 系統導覽

Shadowrocket 完整使用手冊

依照取得、權限、匯入、分流、驗證、流量、設定與維護八個階段查閱。本文主要以 iPhone / iPad 為操作環境,並假設使用者已有自己的訂閱或伺服器資料;App 介面用語與規則關鍵字均保留英文原文。

使用指南帶你依序完成首次連線,本頁則說明各步驟的依據、參數範圍與失敗時的處理方式。初次操作可先閱讀快速指南;遇到特定問題,再依下方目錄查閱相關章節。購買前請先閱讀正版下載與核對說明。

一、透過 App Store 取得與核對購買資訊

先確認取得的是正確的 App,再準備連線資料。Shadowrocket 是 Apple 平台上的閉源商業 App,唯一取得管道為 App Store。購買 App 取得的是用戶端使用資格;使用者既有訂閱或伺服器的使用條件,則須另外確認。將兩者分開檢查,可避免安裝後沒有可用伺服器時,誤以為購買失效,也能區分帳號購買問題與網路連線問題。

核對產品頁上的三項資訊

從本站的正版核對說明前往產品頁,依序核對名稱 Shadowrocket、開發者 Shadow Launch Technology Limited,以及產品頁網址中的 App ID 932747118。也請比對本站頁首使用的官方 App 圖示。搜尋結果中名稱相近的 App 不能取代上述核對;請在同一個產品頁完成檢查,再確認購買按鈕、相容性與 App 說明。

商店頁面上的圖示、開發者與 App ID 是辨識產品的依據,不能只看搜尋排序或名稱中的中文別稱。若頁面顯示的開發者不符,請先返回核對步驟,不要將後續的權限或購買流程當成同一個 App 繼續操作。核對時也要分清 App 名稱與開發者名稱,兩者是不同欄位。

價格、裝置與購買適用範圍

Shadowrocket 採一次買斷制,美國 App Store 的定價約為 2.99 美元,實際金額、幣別與稅金以 App Store 頁面顯示為準。購買前請確認用於 App Store 的 Apple 帳號及所在商店地區,購買後保留系統提供的購買紀錄。價格不是連線品質指標,也不能據此推斷特定伺服器的使用期限、可用流量或可連線地區。

本手冊主要以 iPhone / iPad 為操作環境。Mac、Apple TV 與 Apple Vision 是否相容,也可在同一產品頁的相容性欄確認;系統需求與購買適用範圍一律以 App Store 頁面標示為準。請勿直接從某部裝置已成功安裝,推論另一部裝置也一定適用。準備在第二部裝置使用前,請分別確認裝置系統、帳號購買紀錄與該頁的相容性資訊。

安裝、已購項目復原與更新

購買完成後,請透過 App Store 安裝 App。重新安裝或更換裝置時,先使用原購買帳號查看已購項目,再依商店提供的步驟復原。若頁面仍顯示購買金額,請先核對目前使用的商店帳號、購買紀錄與產品是否一致,不要立即重複付款。用於其他系統服務的裝置帳號,可能與商店購買帳號不同,請以實際購買紀錄為準。

復原 App 與復原連線設定是兩回事。商店可協助找回已購 App,但伺服器位址、訂閱內容、目前選取的設定檔與本機規則,仍須依原先的儲存方式個別確認。不要假設重新安裝後就能復原所有先前的連線資料。是否適用家人共享,也應以 App Store 頁面及帳號實際顯示為準,不要只依其他 App 的購買經驗推斷。

更新同樣透過 App Store 處理。計畫更新前,記下目前使用的伺服器、Global Routing 狀態與 Config 檔案名稱;重要的本機修改請先備份。更新後先驗證原有連線,再調整設定。如此若出現差異,較容易判斷是資料、網路或本次操作造成。商店中的更新紀錄可用來了解變更,本文不固定列出 App 版本號。

進入下一章前,請確認 App 能正常開啟,並已備妥自己的伺服器資料或訂閱。確認購買紀錄、裝置相容性與 App 安裝狀態後,再開始設定權限與匯入資料。帳號復原、購買價格與裝置取得方式的常見問題,請參閱已購項目復原與價格說明。

二、首次啟動與 VPN 設定權限

首次啟動時,先熟悉頁面,再處理系統授權。Home 主要用於查看既有伺服器、選取連線對象與控制連線;Config 用於管理設定檔;Data 用於查看流量與請求;Settings 用於調整 App 行為。不同裝置或 App 更新後,版面可能有所調整,請依英文項目名稱尋找,不要只憑舊截圖中的按鈕位置操作。首次連線的目標是建立可驗證的基本狀態,而不是一次啟用所有設定。

系統 VPN 授權代表什麼

Shadowrocket 建立連線時需要使用系統 VPN 設定機制。首次執行相關操作時,系統可能會要求允許新增 VPN 設定,並要求透過裝置的認證方式確認。這代表允許用戶端在系統網路路徑中運作,不代表伺服器已確認無誤,也不代表遠端服務已成功登入。App 安裝、系統授權與伺服器驗證屬於不同階段,排查時應分別判斷。

授權前請確認提示來自系統,並確認目前開啟的是已核對過的 Shadowrocket。接受授權後,返回 App 查看連線狀態。如果先前取消提示,可再次發起連線,並依系統目前的提示操作;不要為了避開一次取消操作而反覆刪除 App。必要時可前往系統 Settings 中與 VPN 相關的位置查看現有設定,選單層級以裝置目前系統顯示為準。

建立首次連線前的基本狀態

先在未連線時確認裝置本身能連上常用網站,排除 Wi-Fi 尚未完成認證、行動數據未啟用或網路暫時中斷等狀況。若裝置連基本網頁都無法開啟,應先處理目前網路。用戶端需透過現有網路連線至伺服器;系統顯示 VPN 標示,不會取代基本網路連線,也不會自動完成公共 Wi-Fi 的登入程序。

接著查看 Home 是否已有熟悉的伺服器項目。清單空白只表示尚未新增資料,不代表安裝失敗。已有項目也要確認是否來自自己的紀錄,尤其是在復原裝置或匯入舊備份後。先選一個資料完整、用途明確的項目作為測試對象,暫時不要讓多項不確定設定同時影響首次連線。

首次測試時,建議先確認 On Demand 目前的狀態。若已啟用按需連線,系統可能依網路條件再次發起連線,讓手動中斷後的狀態難以判讀。為了讓測試過程更清楚,可先記錄原有設定,再暫時關閉自動觸發條件。測試結束後,再恢復需要的條件;不要在未記錄的情況下變更所有自動化設定。

依用途處理其他權限

使用 Scan QR Code 時,系統可能會要求相機權限;若只透過手動輸入或既有連結匯入,相機權限並非建立連線的必要條件。執行涉及存取本機裝置的操作時,也請留意系統是否顯示相關網路權限提示。處理權限時,應將提示與剛才執行的操作對應,不要把與目前操作無關的權限變更當成通用的連線修復步驟。

VPN 設定授權不等於安裝憑證。一般伺服器連線不應一概視為必須額外啟用 HTTPS 解密。若某份設定涉及憑證、重寫或其他進階處理,請先了解其用途與適用範圍,再個別評估。不要因為網頁無法開啟就直接新增憑證信任,也不要將關閉憑證驗證當成首次連線的例行操作,這會改變原有的安全界線。

若連線開關剛開啟就關閉,先確認是否仍有尚未完成的系統提示,再檢查設定是否完整;若開關維持開啟但網頁沒有回應,請前往連線驗證章節。記下異常發生在授權前、授權後還是送出目標請求時,有助於縮小排查範圍。快速連續切換開關會打亂操作順序,建議每次操作後等狀態穩定,再進行下一項檢查。

本章完成的標準是:App 身分已核對、基本網路可用、系統權限提示已妥善處理、自動連線條件狀態明確。接著再匯入伺服器或訂閱。只想依最短流程操作,可返回使用指南繼續;需要確認匯入欄位與設定關係,則直接閱讀下一章。

三、新增既有伺服器與訂閱

先分清伺服器項目、訂閱與設定檔。伺服器項目描述如何連線至某個遠端;訂閱用於批次取得與更新項目;Config 檔案主要描述流量處理方式及相關參數。三者可以搭配使用,但不能互相取代。清單中出現伺服器,不代表已啟用預期的規則分流;匯入規則檔,也不代表其中一定包含可用的伺服器。

Add Server 與手動填寫欄位

在 Home 開啟 Add Server,先選擇與既有資料相符的協定類型,再逐項填寫。選錯協定時,其他欄位即使看起來相似,也未必能建立連線。位址請填入資料中的主機名稱或 IP,連接埠則依原值輸入;位址欄通常不應包含網頁路徑或說明文字。不要將管理網頁位址直接當成伺服器位址,也不要從名稱中的數字猜測連接埠。

認證欄位會依協定而異。填寫密碼、UUID、加密方式或金鑰時,請使用原始資料,不要仿照其他項目的寫法自行補齊。複製後檢查頭尾是否有空格或換行,但不要擅自改變大小寫或刪除特殊字元。備註僅供辨識,無法修正位址、認證或傳輸參數。若缺少必填欄位,請先核對資料,不要反覆嘗試常見值。

資料類型核對重點常見混淆
Shadowsocks位址、連接埠、密碼、加密方式把備註當成位址,或選錯加密方式
VMess / VLESSUUID、傳輸方式與既有 TLS 參數只填寫 UUID,遺漏傳輸層條件
Trojan / Hysteria2認證資料、TLS 與既有傳輸參數混淆憑證網域名稱與連線位址
WireGuard金鑰、位址、端點與路由相關資料只複製端點,未保留完整設定資訊

涉及 TLS 時,連線位址、憑證驗證名稱,以及傳輸中的 Host 或路徑,可能各有不同用途,應依既有設定逐一對應。這些欄位有時相同,但不能因此認定它們永遠可以互換。若匯入成功卻握手失敗,請先檢查欄位是否完整,不要直接放寬驗證條件。介面出現某項進階選項,不代表所有協定都需要修改它。

Subscribe 與批次更新

已有訂閱可透過 App 中與 Subscribe 相關的入口新增,並完整貼上自己的訂閱網址。訂閱網址通常含有存取憑證,應妥善保密,不要公開截圖或貼到公開筆記。匯入前請確認網址沒有多餘空格、換行或全形標點;訂閱網址與伺服器位址用途不同,不要將整段訂閱內容任意貼入單一伺服器的位址欄。

更新訂閱的本質是重新取得項目資料,不會延長既有服務的使用期限。更新成功後,請再次確認目前選取的伺服器是否仍存在、名稱是否變更,以及手動編輯內容是否被新資料覆蓋。若更新失敗,原有項目可能仍會保留,但不代表參數仍然有效。請區分取得失敗、內容無法解析與伺服器本身無法連線,這三種問題的處理方式各不相同。

訂閱內容為空時,先確認網址是否完整,再檢查目前網路能否連到該訂閱端點,並查看 App 顯示的提示。不要因為結果為空就立刻刪除所有舊紀錄;先保留必要資料,以免失去比對基準。若同一網址在另一個網路下結果不同,應記錄為訂閱取得路徑的差異,不要直接認定所有伺服器都已失效。

掃描匯入與匯入後檢查

透過 Scan QR Code 匯入時,QR Code 可能包含單一伺服器,也可能包含其他設定資料,請以解析結果為準。匯入前確認內容來自自己的紀錄;匯入後開啟項目,核對協定、位址、連接埠與認證欄位。Import from Cloud JSON 等入口也必須使用符合其要求的資料格式,不能只憑檔名或副檔名判定內容一定適用。

匯入後,先確認項目數量與名稱符合預期,再檢查至少一個準備使用的項目,明確選取後進行連線驗證。名稱中的地區描述不代表實際路徑一定符合預期,延遲測試結果也不等於服務可以正常使用。挑選既有項目的方法,請參閱延遲測試與伺服器選擇筆記。

若要保留手動修改,先記錄修改項目,再決定後續是否繼續讓訂閱內容覆蓋。不要在多個同名副本之間來回測試卻不記錄選取對象,否則容易把某個項目的成功結果誤認為另一個項目的表現。完成本章後,應能清楚說明目前使用哪個項目、資料來源為何,以及下次更新會影響哪些內容。

四、Global Routing 與規則比對

Global Routing 決定流量整體採用哪種處理方式。可概括為依設定、代理、直連,對應的介面用語分別是 Config、Proxy、Direct。先選對模式,再檢查個別規則;否則在 Proxy 狀態下修改規則,卻期待分流結果改變,容易得出錯誤結論。伺服器項目決定連線方式,Global Routing 決定整體路由選擇,兩者都需要確認。

Config、Proxy、Direct 的分工

介面用語處理方式適合檢查的問題
Config依目前啟用設定中的規則與相關選項處理目標符合哪條規則、採用哪種策略
Proxy整體以代理方式處理既有伺服器連線是否能處理請求
Direct整體以直連方式處理目前網路直連至目標時的狀況

這三種模式用於比對路徑,不代表三部不同伺服器。切換後應重新送出測試請求,必要時關閉舊頁面再重新開啟,因為已建立的連線不一定會依新選擇重新建立。Direct 不等於關閉 App 的連線開關;系統通道與請求處理方式屬於不同層次。若要比較完全未連線時的基本網路,應另外記錄開關狀態。

使用 Config 前,先前往 Config 確認目前啟用的檔案名稱與內容。清單中有某個檔案,不代表它就是目前使用中的檔案;編輯副本也不代表執行中的設定已同步變更。儲存並依介面要求啟用後,再透過新的請求驗證。檔名相近時,建議加上清楚的備註,避免混淆不同副本的修改狀態。

規則依序比對,FINAL 負責兜底

[Rule] 區段中的規則會由上而下檢查,符合條件後便採用對應策略。因此,範圍較小的例外通常要放在範圍較廣的規則之前,兜底規則則放在最後。DOMAIN 用於特定網域,DOMAIN-SUFFIX 用於網域及其子網域,DOMAIN-KEYWORD 的比對範圍更廣,使用前應考慮是否會匹配到非預期網域。

[General]
bypass-system = true
skip-proxy = 192.168.0.0/16, 10.0.0.0/8, localhost
dns-server = system

[Rule]
DOMAIN-SUFFIX,apple.com,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,ads-example,REJECT
GEOIP,CN,DIRECT
FINAL,PROXY

以上是用來說明語法的範例,並非適用於所有人的完整設定。PROXY 表示以代理方式處理,DIRECT 表示直連,REJECT 表示拒絕。範例中的網域僅用於說明比對方式,不能用來驗證實際服務。兜底規則 FINAL,PROXY 會將前面未符合規則的流量交由代理處理,採用前請先確認這符合自己的預期。

IP-CIDR 與 IP-CIDR6 用於比對 IP 網段;GEOIP 則依 IP 位址歸屬資料判斷,依據與直接比對網域不同。網域請求可能涉及解析程序,no-resolve 用於避免僅為該條位址規則觸發網域解析;不要將它理解為關閉整個 App 的 DNS。歸屬資料也不能取代對實際請求的觀察。

先做最小幅度的修改,再觀察比對結果

排查特定目標時,先在現有設定的副本中新增範圍明確的規則,並將它放在可能涵蓋該目標的廣泛規則之前。每次只調整一個條件,儲存後送出新請求,查看實際目標與策略。不要同時更換伺服器、修改 DNS 又調整規則順序;否則即使問題排除,也無法確認是哪項變更造成,之後更難重現。

理解區域網路相關設定時,也要依實際網段判斷。範例只列出部分私人位址範圍,不代表裝置所在網路一定使用這些位址;請從自己的網路資訊確認。若某個本機服務仍無法存取,還要檢查探索機制、裝置權限與目前網路的隔離狀況,不能只憑一條直連規則推斷所有本機通訊都會恢復。

只有在 Global Routing 為 Config、正確的檔案已啟用,且新請求確實符合規則時,才能評估該規則的效果。需要更詳細的排序範例,可閱讀規則優先順序與 FINAL 兜底;關鍵字說明則可參閱術語表。

五、建立連線與分層驗證

連線驗證應分層進行:基本網路可用、用戶端連線維持、伺服器連線可用,以及目標請求依預期處理。任何單一圖示或測試數字,都無法涵蓋這四個層次。開始測試前,記錄目前網路、選取的伺服器、Global Routing 與 Config 檔案,之後一次只變更一個變數。這樣才能將「剛才可以,現在不行」轉化為可重複驗證的具體條件。

依序完成一次基準測試

先在未連線狀態開啟平時可正常存取的頁面,確認裝置本身已連上網路。接著選取已核對過的伺服器,設定明確的 Global Routing,再開啟 Home 的連線開關。等待狀態穩定,並處理尚未完成的系統提示。若連線立即中斷,先查看這次操作產生的提示或記錄,不要繼續重新整理網頁;問題可能尚未進入存取目標的階段。

連線維持後,開啟新頁面,測試一至兩個用途明確的目標。優先選擇平時會使用且結果容易判斷的頁面,不要同時啟動大量下載或多個影片 App。先確認頁面能否完整載入,再觀察圖片、登入或其他操作是否正常。頁面標題顯示,只能證明部分資源載入成功,不能據此認定整個服務都正常。

測試 Config 時,留意目標實際符合的策略;測試 Proxy 時,確認觀察的是代理路徑;測試 Direct 時,將結果視為目前網路直連的對照。某個目標在直連時成功、代理時失敗,只能說明兩條路徑的表現不同;仍需進一步區分伺服器、認證、解析與目標限制,不能單憑此現象就斷定設定欄位有誤。

Connectivity Test 的意義與限制

Connectivity Test 或相關延遲測試,通常用來觀察特定探測方式下的可達性與耗時,實際測試方法和目標以 App 目前的設定為準。測試回傳數值不代表所有服務都可正常使用,逾時也不一定表示所有連線都失敗。先了解探測目標,再搭配實際網頁存取判斷;不要用不同測試方法的結果直接比較。

延遲較低只反映特定測試過程中的往返或回應特徵,不直接代表持續傳輸速度、連線穩定度或影片載入表現。挑選既有伺服器時,應一併考量測試時間、網路環境、實際用途與協定資料。不要只因單次數值變化就頻繁切換,這會中斷既有連線,也會讓後續紀錄混入不同伺服器的結果。

依異常發生階段縮小排查範圍

現象優先檢查接著比對
開關無法維持開啟系統權限、設定完整性、本次操作提示確認是否已進入伺服器連線階段
網域相關請求失敗DNS、網域拼寫、實際目標紀錄區分解析失敗與解析後連線失敗
出現認證或握手錯誤協定、憑證、TLS 與裝置時間依據原始資料逐項核對
只有部分頁面資源載入失敗資源網域、符合的規則、拒絕策略查看失敗請求,不要只看網址列

遇到解析異常時,不要立刻將所有 DNS 項目改成陌生位址。先確認網域是否正確、基本網路是否需要認證,以及失敗紀錄停在哪個階段。直接連線至某個 IP 並不等同於存取網域,因為 TLS、虛擬主機或內容傳遞可能依賴網域。IP 連線失敗,不足以推論該網域的解析一定有問題。

遇到認證或 TLS 異常,應回頭核對原始伺服器資料,包括密碼、UUID、憑證名稱、傳輸參數與裝置時間。時間明顯不正確可能影響憑證驗證。不要用關閉驗證來掩蓋資料錯誤,也不要把所有握手失敗都歸因於網路速度。若訂閱剛更新,尤其要確認目前選取的項目是否仍是先前測試的那一個。

切換網路後出現問題時,可分別在 Wi-Fi 與行動網路執行相同的一組簡短測試,並記錄切換前後的結果。某個網路失敗、另一個正常,表示基本連線路徑可能不同;比較時仍須維持伺服器與設定不變。公共網路若要求先登入,請先完成網路認證,再重新建立用戶端連線,避免將登入頁面的問題混入伺服器排查。

合格的驗證紀錄應包含測試時間、網路類型、項目備註、模式、目標與可見錯誤,並隱去認證資料。若仍無法定位,保留最近一次最清楚的失敗紀錄,再前往 Data 查看相關請求。不要先清空紀錄再憑印象回想,也不要公開包含完整訂閱網址、密碼或金鑰的記錄。

六、Data 流量與請求檢視

Data 可將「頁面有問題」進一步拆解為特定請求與流量變化。它能協助查看 App 處理的網路活動,但不會自動說明所有服務失敗的原因。閱讀紀錄時,應分辨請求目標、採用策略、連線狀態與傳輸統計;不同檢視畫面顯示的欄位可能不同,請以 App 目前實際呈現為準。帶著明確問題查看 Data,比漫無目的地瀏覽大量紀錄更有效。

透過單一操作定位一組請求

開始查看前,先關閉不必要的背景存取或暫停大量流量工作,記下目前時間,再對目標 App 執行一項明確操作,例如開啟某個頁面。接著查看該時間附近新增的請求。不要一邊重新整理多個 App,一邊猜測哪筆紀錄對應故障;單一服務通常已會產生多個網域請求,額外背景活動只會讓辨識更困難。

若紀錄太多,可依目標網域、發生時間或 App 提供的篩選方式縮小範圍。先找出與問題直接相關的請求,再查看前後活動。網址列中的主網域可能只負責入口,圖片、指令碼、登入與 API 可能使用不同目標。主頁正常但某項功能失敗時,應查看該功能觸發後新增的請求,不要只檢查首次開啟頁面的紀錄。

分開檢視規則比對結果與流量路徑

在可見紀錄中確認目標採用的是 PROXY、DIRECT 還是 REJECT,並與規則預期比較。若目標被 REJECT,先檢查是否受到範圍過廣的關鍵字或既有規則影響;若走 DIRECT、但預期走代理,先確認目前模式與啟用的檔案。不要直接刪除所有拒絕規則,應先用範圍明確的例外進行驗證,再決定是否調整原規則的比對範圍。

同一個頁面同時出現多種策略,可能是規則分流的正常結果。部分資源直連、部分資源走代理,不一定代表設定衝突;關鍵在於選擇是否符合預期,以及服務能否正常使用。相反地,若所有請求都走同一路徑,也不一定是規則失效;目前模式、規則範圍或兜底策略可能原本就會導向相同結果。

看到有上傳或下載位元組,只能說明特定範圍內發生了資料傳輸,不能直接判定服務已成功。認證失敗頁面、重試請求與錯誤回應同樣會產生流量。判斷登入、檔案傳輸或媒體播放是否完成,應同時查看服務畫面與相關請求。紀錄顯示連線已結束,也可能只是正常的短連線,不要只憑結束狀態判斷故障。

了解統計方式與計費範圍

Data 中的累計值、個別連線的數值,以及服務提供者帳號中的用量,可能採用不同統計方式。直連流量是否納入某個檢視、統計從何時開始、是否包含協定額外負載,都要依該檢視的實際定義判讀。不要把用戶端顯示的總量直接當成既有訂閱的剩餘額度,也不要憑單一累計數字推斷遠端帳單一定有誤。

若要觀察某項工作的流量變化,先記錄開始值、結束值與測試時間,並盡量減少其他網路活動。使用清除或重設功能前,先確認會影響哪些紀錄。刪除歷史紀錄不會修正伺服器認證、改變規則比對結果或恢復遠端使用額度;它只會改變本機的觀察資料,因此排查期間應先保留有價值的樣本。

從紀錄回到可驗證的設定修改

例如頁面中的圖片載入失敗,但主頁正常,先找出圖片對應的目標,檢查是否遭到拒絕或採用不同策略。接著只在設定副本中修改這個目標的處理方式,再重試相同操作。若問題改善,表示路徑變更與結果有關;接下來仍應檢查規則範圍是否過廣、是否影響其他目標,不要直接把臨時測試設定當成最終方案。

若紀錄顯示請求已依預期走代理,但服務仍失敗,請繼續檢查遠端連線、TLS 與目標回應,避免反覆修改已正確的規則。若完全找不到對應請求,先確認觀察時間、篩選條件與目前連線狀態。App 快取可能讓某次操作沒有重新送出請求;請觸發新的操作,不要立刻認定用戶端沒有處理該 App 的流量。

匯出或分享診斷資訊前,請移除訂閱網址中的存取憑證、伺服器認證欄位、金鑰,以及不必要的私人存取網域。最有用的回報通常只需一小段時間範圍、一個明確目標、預期策略與實際錯誤,不必提供全部歷史紀錄。保留必要背景並減少敏感資訊,能讓後續排查更聚焦,也方便與修復後的結果比較。

七、Settings、DNS 與 On Demand

調整 Settings 中的選項前,先明確指出要處理的是自動連線、解析、測試還是紀錄保留,再修改對應項目。選項越多不代表連線越穩定;多重自動化與設定覆寫反而會增加判斷難度。開始調整前,先保存目前可用狀態,尤其要記下哪些值來自 Config、哪些來自 App 設定,以及哪些只是目前連線階段的暫時選擇。

On Demand 的觸發條件與手動開關

On Demand 依設定條件觸發連線或中斷連線,不會提供伺服器,也無法修復失效的認證資料。按需條件可能涉及 Wi-Fi、行動網路或網域,實際可選項目以目前介面為準。設定前,先確認手動連線運作穩定;否則自動化只會重複觸發相同的失敗流程,增加耗電與觀察干擾,卻無法解決底層連線問題。

設定 Wi-Fi 條件時,請核對網路名稱與預期動作,特別留意同名網路、網路切換與暫時中斷的情況。行動網路條件則要考量裝置從 Wi-Fi 切換時是否符合預期。網域條件描述的是觸發時機,不應與 Config 中決定請求路徑的規則混為一談:前者負責何時建立連線,後者負責連線後如何處理流量。

完成設定後,分別測試符合與不符合條件的情況,並觀察手動中斷後的行為。若關閉後很快又重新連線,先檢查 On Demand 是否再次觸發,不要直接認定開關故障。測試時每次只保留一組容易理解的條件,確認結果後再增加複雜度。更詳細的條件說明請參閱On Demand 按需連線筆記。

DNS 與設定的作用範圍

DNS 負責將網域解析為位址,但解析成功不保證位址可連線;位址可連線也不代表服務認證成功。遇到網域存取異常時,先區分解析階段與後續連線階段。不要把所有存取問題都歸咎於 DNS,也不要未記錄原始值就連續替換多組解析設定;這會讓相同目標的快取、位址與路徑同時改變。

設定範例中的 dns-server = system 表示使用相應的系統解析設定。實際採用何種方式,應視既有設定、網路條件與信任範圍而定。若 App 設定與 Config 檔案中都有相關選項,請確認目前實際生效的來源;不要只因某處顯示一個值,就假設所有請求都會採用該值。修改後等狀態穩定,再送出新請求驗證。

DNS 解析流程可能與路由判斷互相關聯,例如位址規則需要位址資訊,而網域規則可直接比對網域。若解析結果隨網路改變,最終路徑也可能不同。定位問題時,盡量維持伺服器、設定與目標不變,再比對單一解析選項。不要同時新增位址規則又更換解析方式,否則難以分辨各自造成的影響。

連線測試、記錄與安全界線

若可調整 Connectivity Test 的目標與方法,請記錄變更前後的值。不同方法回傳的耗時不能直接比較,也不要為了取得更小的數字而選擇與實際需求無關的目標。日常測試只需協助判斷既有項目是否值得進一步驗證,最終仍以實際服務表現為準。測試過於頻繁也會增加網路請求,不必把每次輕微波動都當成故障。

記錄相關設定應服務於明確的排查過程。需要詳細記錄時,先啟用適當的詳細程度,重現問題後保存必要片段,再恢復日常設定。長期保留大量紀錄會增加管理負擔,也會累積更多私人網路資訊。分享前請先移除個人資訊,並確認匯出內容是否包含伺服器認證、訂閱存取憑證或不必要的瀏覽紀錄。

涉及 TLS 驗證、憑證、重寫或其他進階處理的選項,應個別閱讀其說明。一般連線不應靠隨意降低驗證要求來維持可用;若必須改變驗證界線才能連線,請回頭檢查伺服器資料、憑證名稱與時間設定。不了解用途的選項,保留目前已確認可用的值,比照著另一份設定逐項啟用更有利於穩定維護。

驗收設定時,應涵蓋首次連線、手動中斷、網路切換與裝置再次使用後的狀態。尤其是 On Demand,不能只在目前的 Wi-Fi 測試一次就視為完成。確認行為穩定後,保存簡潔的設定紀錄,註明用途而非只列數值;下次排查時,才知道該選項為何存在,以及是否仍適合目前環境。

八、設定備份、更新與日常維護

維護的目標是保留可用基準,並為每次變更留下紀錄。用戶端更新、訂閱更新、規則修改、裝置切換網路與帳號復原是不同事件,應盡量分開處理。一次進行多項變更後若出現問題,往往很難找出原因。日常不必頻繁重設所有設定;先保存資訊、縮小範圍並進行小幅驗證,通常更容易復原與理解問題。

建立可復原的基準設定

連線正常時,記錄目前選取的伺服器備註、Global Routing、Config 檔案名稱、重要設定與最近一次驗證方式。將本機修改過的設定另存副本,並以能區分用途的名稱命名。備份不只是複製檔案,也要確認復原時知道該啟用哪份內容。含有憑證的資料應存放於安全的位置,不要為了方便比對而放進公開筆記。

設定備份、訂閱網址與伺服器憑證應分別看待。復原設定檔可能只會復原規則,不一定包含所有伺服器;保留訂閱網址也不代表遠端內容永遠不變。若使用 App 提供的匯出或同步功能,請先核對實際包含的項目,再於第二部裝置確認。匯入時沒有出錯,不代表原裝置的所有狀態都已完整移轉。

分別更新訂閱與規則

更新訂閱前,記錄目前使用的項目與必要的本機修改;更新後檢查項目是否遭到刪除、取代或重新命名,再進行簡短測試。若訂閱內容有變,應優先依新資料核對,不要硬把舊欄位填回去。需要長期保留的手動內容,應明確規劃獨立的維護方式,避免每次更新後都在不知情的情況下遭到覆蓋。

更新規則檔時,應留意比對範圍、順序、兜底策略與新增的進階處理。外部取得的設定不能只因名稱熟悉就直接啟用,應先閱讀與自身需求相關的部分。尤其是最終策略、拒絕規則、DNS 與憑證相關內容,可能大幅改變行為。保留原始檔案,先在副本中驗證後再決定是否取代,出現問題時才能及時復原。

若更新後只有特定目標失敗,先比對該目標對應的規則與紀錄,不要立刻撤銷所有伺服器更新。反之,若多個目標都在認證階段失敗,應優先核對伺服器資料,而不是逐一為網站新增例外。維護時將故障分類為資料、路徑、規則或服務回應,可避免在同一份設定中累積越來越多臨時修補。

更換裝置、重新安裝與移轉至 iPad

更換裝置時,先透過原購買帳號在 App Store 找回 App,再復原自己的資料。系統需求與購買適用範圍以 App Store 頁面標示為準。首次開啟後仍要檢查 VPN 設定授權、目前伺服器與啟用中的檔案,不要因為已復原購買項目就跳過連線驗收。系統備份可能保留部分狀態,但仍應以新裝置實際顯示與測試結果為準。

從 iPhone 移轉至 iPad 時,操作區域可能因橫向顯示、分割畫面或較寬的版面而改變,請依 Home、Config、Data、Settings 等名稱尋找。先驗證單一既有伺服器,再逐步復原規則與按需條件。兩部裝置的網路與使用情境可能不同,不必為了讓介面看起來一致而強制套用所有相同設定。可參閱iPad 已購項目復原與版面說明。

保留故障紀錄,避免連續重設

連線突然異常時,先記下最後一次正常使用與首次失敗之間發生的變化:是否更新訂閱、切換網路、修改規則或調整系統設定。保留目前的錯誤提示與最近請求,再嘗試回復至已知基準。重設所有內容會同時移除線索與可用設定;只有在確認備份可復原,且小範圍排查仍無法解決時,才考慮大幅整理。

確認不再需要後,可清理長期未使用的項目;但請先分清手動新增項目與訂閱管理項目,避免下次更新時再次出現同名副本。也應定期檢查規則是否重複、比對範圍過廣,或保留已無用途的例外。清理時一次處理一類問題,完成後驗證常用目標;刪除數量不是維護成效,真正的標準是行為更明確、復原更容易。

向他人描述問題時,提供裝置類型、目前網路、操作步驟、Global Routing、目標與錯誤類別即可,並將伺服器、訂閱與記錄中的敏感資料去識別化。需要確認欄位含義,可查閱術語表;需要重新完成首次連線,可參閱快速使用指南;新手常見操作疑問則可閱讀新手十問。

完成維護後,以固定的一組簡短測試確認常用頁面、必要的本機存取與網路切換狀況,並更新基準紀錄。未來出現差異時,先比對這份紀錄,不要從頭猜測所有參數。手冊各章可獨立查閱,但操作順序仍建議依取得、權限、資料、路由、驗證與觀察的層次進行,讓每一步都有清楚的輸入與結果。

本手冊保留實際介面用語與規則語法。App 版面、可選設定、價格、系統需求與購買適用範圍,均以目前 App 與 App Store 頁面標示為準。

返回章節目錄 ↑