官方手冊 · 從入門到進階

Shadowrocket 完整使用手冊 首次設定與日常維護

本頁供系統性查閱:先建立正確的購買、權限與設定概念,再說明連線後的路由、流量與維護。若尚未完成首次連線,可先依照使用說明中的快速入門流程操作;遇到需要進一步了解的設定,再回到相關章節。本頁與快速入門使用相同的介面用語,不必一次讀完。

01 / 取得應用程式與購買紀錄

透過 App Store 取得正版與買斷範圍

本章完成標準:確認應用程式身分,並了解購買紀錄、伺服器資訊與設定檔各自保存的內容。

先確認應用程式,再確認購買紀錄

取得 Shadowrocket,請從App Store 正版核對頁前往指定產品頁面。不要只憑搜尋結果中的名稱判斷應用程式身分:先確認產品名稱為 Shadowrocket,再核對開發者 Shadow Launch Technology Limited、官方圖示及 App ID 932747118。可在產品連結結尾的 id932747118 中找到 App ID。名稱相似不代表是同一款產品;核對時應一併確認上述資訊,不要只依顏色或搜尋排序判斷。

進入 App Store 後,請先閱讀價格、相容性與購買說明,再依系統購買流程確認。Shadowrocket 主要供 iPhone 與 iPad 使用;Mac、Apple TV、Apple Vision 的適用情況也可在同一產品頁的相容性欄查看。系統需求與購買適用範圍均以 App Store 頁面標示為準。裝置能開啟產品頁,不代表其目前系統版本一定符合執行需求;是否可取得,請以 App Store 對目前裝置顯示的結果為準。

一次買斷包含哪些內容

一次買斷是指應用程式本身的購買方式,不代表持續提供連線資源。美國 App Store 價格約為 2.99 美元,實際價格以商店頁面為準,各地商店會以當地貨幣顯示。付款前請確認目前用於 App Store 購買的 Apple 帳號,以及頁面顯示的金額。購買完成後,用戶端仍需要使用者已有的訂閱或伺服器參數;應用程式購買紀錄不能取代這些資訊,也無法證明特定伺服器目前可用。分開保存兩類費用與紀錄,日後更換裝置或排查問題會更清楚。

伺服器資訊通常包含位址、連接埠、協定與驗證參數;訂閱則是用來取得伺服器清單的位址。設定檔負責規則、部分連線設定與策略引用。這三者與 App Store 的已購項目紀錄各有不同用途:已購紀錄用於重新取得應用程式,訂閱用於維護伺服器清單,設定檔則決定如何處理連線。只還原應用程式,不代表原有訂閱、手動輸入內容或本機修改會自動完整移轉至新裝置;移轉前仍須確認資料來源並備份。

首次取得與已購項目復原的順序

首次購買後,請等候 App Store 完成下載,再從裝置主畫面開啟應用程式。如果商店已顯示已購買或重新下載標記,請先確認該項目對應的帳號,不要立刻重複購買。更換裝置或重新取得時,請使用原購買帳號,在 App Store 帳號頁面尋找已購買的應用程式;入口名稱可能隨系統介面改變。若找不到,請先檢查購買紀錄、隱藏項目與目前的商店帳號,再確認是否受商店地區或購買適用範圍影響。家庭共享是否適用,也應以 App Store 說明及實際帳號狀態為準。

用於裝置雲端同步與商店購買的帳號可能不同,因此排查時應確認 App Store 帳號,而非只看系統設定頂端顯示的名稱。帳號資訊屬於個人資料,不應貼在公開評論或故障排除截圖中。記錄購買情況時,只要留下足以自行辨認的說明即可,請勿記錄帳號密碼。若復原過程遇到付款或帳號限制,請依照 App Store 提供的帳號處理流程辦理;修改 Shadowrocket 的規則、協定或 DNS,不會改變商店購買狀態。

完成取得後的檢查

開啟應用程式後,先確認能進入 Home、Config、Data、Settings 等主要頁面,暫時不要更改進階選項。此時沒有伺服器清單,不代表購買失敗;通常只是尚未匯入自己的資料。接著依本手冊順序處理首次授權,再輸入服務資訊。應用程式更新由 App Store 管理,更新紀錄與適用需求也以商店頁面為準。更換裝置後如何復原,可繼續參閱從已購項目重新取得 Shadowrocket 的說明。

02 / 首次啟動與系統權限

VPN 設定授權與連線準備

本章完成標準:了解系統授權的用途,並能區分權限問題、服務問題與規則問題。

為什麼會出現系統提示

Shadowrocket 需要透過系統提供的網路延伸功能處理連線。首次啟用相關連線功能時,系統可能會提示加入 VPN 設定,並要求輸入裝置密碼或使用裝置支援的身分驗證方式確認。這一步是讓應用程式在系統中建立相應的網路設定,不是購買新服務,也不是向訂閱位址付款。請先閱讀提示中的應用程式名稱與操作說明,確認是自己剛才發起的操作後再決定;不要把所有系統提示都當成同一種訊息接連確認。

授權只是連線準備的一部分。即使系統已允許加入設定,伺服器位址錯誤、驗證參數不符或服務無法使用,仍會導致連線失敗。反過來說,正確匯入伺服器清單,也不能略過系統要求的設定授權。首次使用時,請將「資料已匯入」、「設定已獲准建立」、「連線已啟動」及「目標存取成功」分成四個檢查點,避免只看一個開關就認定整個流程已完成。

拒絕授權後如何繼續

如果先前取消了系統提示,請先回到應用程式檢查目前連線狀態,再由自己重新啟動連線,並留意是否再次出現系統提示。不要連續快速點擊開關,以免授權、啟動與停止流程互相交錯。若系統沒有再次提示,可在裝置設定中尋找 VPN 相關設定,確認是否已有 Shadowrocket 對應項目。系統選單名稱可能隨版本改變;判斷重點是項目所屬的應用程式與狀態,而非死記某一層選單的位置。

若發現多個網路設定,請先確認各自用途。其他 VPN 連線或受管理的網路設定可能影響目前連線;排查時應先停止自己能控制的其他連線,再單獨測試 Shadowrocket。公司或學校管理的裝置可能有額外限制,應向裝置管理單位確認,不要任意刪除管理設定。也不應一開始就刪除本應用程式的系統設定;只有了解影響並保存必要資料後,才考慮重新建立,並重新完成授權。

首次連線前整理網路環境

準備測試時,請選擇一種明確的網路環境,例如已完成驗證的 Wi-Fi。部分公共網路必須先透過系統或瀏覽器完成登入驗證;若基本網路尚未連線,設定正確的用戶端也無法建立遠端連線。請先暫停用戶端連線,確認裝置能正常上網,再回到應用程式繼續。首次驗證期間不要同時切換 Wi-Fi、行動網路與多台伺服器,否則失敗後很難判斷是哪項變更造成影響。

也請檢查裝置的日期與時間。使用 TLS 的連線需要驗證憑證有效期;裝置時間明顯錯誤,可能使有效憑證看起來不符合要求。應先修正系統時間,不要透過降低驗證要求掩蓋問題。若系統出現與憑證、裝置管理或額外描述檔相關的提示,不要因為正在設定用戶端就認為都必須接受;匯入一般伺服器資料與設定規則,並不代表應接受來源不明的系統層級變更。

如何記錄權限問題

權限問題通常發生在啟動連線前後,可能表現為授權未完成、設定無法建立,或開關無法維持預期狀態。記錄時請寫下自己執行的操作、系統是否出現提示,以及確認後應用程式顯示的內容,不要只寫「不能用」。如果開關能啟動,但只有特定目標無法存取,請轉到連線與規則章節繼續分析,避免反覆重建權限。依發生順序記錄,有助於區分系統層與服務層問題。

此階段也請先不要設定 On Demand。先用手動開關完成一次可重複的連線與中斷,再加入自動連線條件,才能判斷後續重新連線是來自手動操作還是自動條件。若每次中斷後都自動連線,請先檢查是否啟用了相關自動行為,而非立刻認定開關故障。確認權限後,再進入下一章新增伺服器或訂閱;若尚未準備好服務資訊,可以先閱讀介面說明,不必為了繼續操作而任意填寫參數。

03 / 伺服器與訂閱資料

Add Server 與 Subscribe匯入與管理

本章完成標準:正確匯入已有資料,並了解更新伺服器清單與更新設定檔並非同一件事。

先辨認手邊的資料

匯入前,先確認服務供應商提供的是訂閱位址、單一伺服器分享內容,還是完整設定檔。訂閱位址通常用來取得一組伺服器資料;單一分享內容只描述一個連線;設定檔則可能包含規則與其他設定。不能因為它們都是一段文字或一個位址,就一律從同一個入口匯入。先閱讀資料來源提供的用途說明,再選擇 Home 中的新增入口或 Config 中的設定檔管理入口,可減少「匯入成功,內容卻不如預期」的情況。

伺服器資料與訂閱位址可能包含驗證資訊,應比照密碼妥善保管。複製時請保留完整內容,不要混入說明文字、空格、換行或中文標點。若透過 Scan QR Code 匯入,也要確認 QR Code 來自自己信任的資料來源;掃描結果不代表設定內容必然可信。不要把 QR Code 上傳到公開討論區求助,也不要為了檢查內容就把完整訂閱位址貼到不明網站。排查時只需說明資料類型、錯誤提示與操作步驟。

手動新增伺服器的核對方法

在 Add Server 中,先選擇與服務資訊相符的類型,再填入位址、連接埠與驗證欄位。協定類型會決定後續參數的意義;不同類型的密碼、識別碼、加密方式與傳輸選項不能互換。位址欄位一般只填伺服器位址,不要自行加上網頁路徑;連接埠則使用資料提供的數值。儲存前請逐項對照原始說明,尤其留意大小寫、末尾字元與數字,不要只憑「看起來差不多」判斷相符。

資料類型檢查重點常見錯誤
Shadowsocks位址、連接埠、密碼、加密方式只複製密碼,漏掉加密方式
VMess / VLESS驗證識別資料、傳輸方式及相應附加參數直接互換不同類型的欄位
Trojan / Hysteria2驗證資料、TLS 與伺服器端要求擅自變更憑證驗證相關選項
HTTP / SOCKS5代理位址、連接埠及是否需要驗證把網頁登入密碼當成代理驗證資料

若資料還提供 TLS、伺服器名稱、路徑或其他傳輸參數,請依照對應欄位完整填寫。伺服器名稱不一定等於連線位址,路徑也不是可以任意補上的說明文字。若無法確認某個欄位,應回到服務資訊來源查證,不要逐一嘗試所有開關。手動新增適合參數完整且數量較少的情況;若已有標準分享內容,匯入可減少抄寫錯誤,但匯入後仍應檢查類型與重要欄位是否符合預期。

匯入訂閱與首次更新

新增訂閱時,請在對應的 Subscribe 類型入口填入完整位址,儲存後執行更新,並確認是否出現伺服器清單。名稱可用來辨認來源,但不是連線參數。若清單為空,請先判斷是位址未儲存、請求失敗,還是取得的內容無法解析;這三種情況的處理方式不同。在瀏覽器中看得到網頁,不代表該位址傳回的是用戶端可用的訂閱內容;有時實際顯示的是帳號登入頁或錯誤說明頁。

訂閱匯入成功後,請選擇其中一台伺服器,再進行後續連線驗證。此時不要立刻逐一編輯訂閱產生的項目,因為下次更新可能會覆蓋變更。若確實需要獨立調整,請先了解項目的來源與更新方式,保留原始訂閱,並以清楚名稱區分自己的副本。更新訂閱主要是更新伺服器資料,不會自動更換目前 Config 中的規則檔;管理伺服器清單與管理分流規則是兩項不同工作。

匯入失敗時先保留原狀

更新失敗時,不必立刻刪除原有訂閱。請先保留現有清單,檢查位址是否完整、服務帳號是否仍有效,以及目前網路能否取得訂閱內容。若先前正常、現在突然失敗,請記錄最後一次成功更新的時間與近期變更,再查看服務供應商提供的狀態說明。連續重複請求通常無法修正格式問題,反而可能觸發存取限制。可依照訂閱解析失敗或清單為空的自我檢查清單逐項排查,確認原因後再決定是否更換位址。

04 / 模式、規則與策略

Global Routing三種模式與比對順序

本章完成標準:了解連線使用的路由模式,並能讀懂規則的條件與結果。

先確認模式,再解讀規則

Global Routing 中的 Config、Proxy、Direct 決定主要路由方式。Config 依目前設定檔中的規則分流;Proxy 將用戶端處理的連線統一交由所選伺服器處理;Direct 則採直連方式。此處「統一」指的是路由模式,不代表對裝置所有系統行為的絕對描述。系統保留行為、既有連線與其他網路設定仍可能影響觀察結果,因此排查時應以新發出的請求驗證,不要只看已開啟的頁面。

介面用語處理方式檢查重點
Config依據生效設定中的規則選擇策略目前檔案、規則順序、比對結果
Proxy將用戶端處理的連線交由所選伺服器伺服器參數與實際連線狀況
Direct採用直連方式基本網路與目標本身的狀態

Config 是設定模式的介面用語,同時出現在底部的設定檔管理入口與 Global Routing 選項中,但兩處用途不同。前者用來管理檔案,後者用來選擇是否依規則處理。已匯入檔案,不代表目前模式一定是 Config;模式選擇 Config,也不代表剛下載的檔案已生效。修改規則前,應分別確認這兩處狀態。許多「規則沒有作用」的情況,其實是目前仍處於 Proxy,或生效的並非剛才編輯的檔案。

一條規則由哪些部分組成

常見規則由類型、比對內容與策略組成,並以英文逗號分隔。DOMAIN 比對完整網域;DOMAIN-SUFFIX 比對網域後綴及相應子網域;DOMAIN-KEYWORD 依網域中的關鍵字比對;IP-CIDR 與 IP-CIDR6 分別表示相應的 IP 位址範圍;GEOIP 則依地理位置資料庫判斷。策略 PROXY、DIRECT、REJECT 分別代表交由代理、直連與拒絕。策略名稱必須符合實際設定的語意,不能用中文說明文字取代規則中的關鍵字。

[General]
bypass-system = true

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

以上是供閱讀的最小規則片段,並非適用所有網路環境的完整設定。範例網域僅用來說明語法,不能用來驗證伺服器。區域網路位址的直連規則用於展示位址範圍比對;GEOIP 判斷依賴資料庫,也不能取代對特定目標的觀察。實際使用前,應確認自己需要的服務、區域網路資源與預設策略,保留原設定檔副本,再逐項調整副本,不要直接覆蓋唯一可用的檔案。

由上往下比對,第一條符合的規則即停止

規則依由上而下的順序檢查;符合某條規則後,就採用該條策略,不會繼續往下尋找所謂更精確的規則。因此,特定網域的例外規則應放在可能涵蓋它的廣泛規則之前。FINAL 是前面的規則都未符合時使用的預設策略,通常應放在最後。若將 FINAL 提前,後面的項目便無法如預期參與判斷。DOMAIN-KEYWORD 的比對範圍也可能比直覺更廣;使用前應考慮是否會誤比對其他網域,能明確使用後綴表示時,就不要任意擴大條件。

網域規則與位址規則比對的是不同資訊。目標最初以網域形式出現,之後還需要解析為位址;部分規則判斷可能涉及 DNS。不能因為目標最後連線到某個位址,就斷定一定先符合了位址規則。分析時應一併查看實際請求紀錄、規則順序與解析結果,而非只查一次位址歸屬。IPv6 環境也要考慮相應的位址規則;只加入 IPv4 範圍,不代表所有同類連線都已涵蓋。

05 / 建立連線與驗證結果

Connectivity Test與實際存取排查

本章完成標準:透過可重複的測試判斷問題所在層級,而不是只看連線開關。

完整驗證應包含哪些項目

完成匯入後,在 Home 選擇一台自己已有的伺服器,確認 Global Routing 模式,再啟動連線並完成必要授權。等狀態穩定後,發出一個新的實際存取請求。完整驗證至少包括四項:開關處於預期狀態、伺服器選擇正確、目標能傳回內容,以及請求所採用的策略符合預期。系統顯示 VPN 標記,最多只能表示相應的網路設定正在運作,不能證明遠端伺服器驗證成功,也不能證明每個網站或應用程式都能存取。

第一次測試應選擇自己熟悉且能判斷結果是否正常的目標,不要同時開啟大量頁面。先測試一般請求,再測試確實需要透過代理處理的請求;若涉及區域網路資源,也要另外測試。不同目標可能採用不同策略,因此一項測試成功不代表所有規則都正確。請記錄測試時的網路環境、伺服器與模式,之後以相同條件重測才有比較意義。驗證途中不要自動更新訂閱或替換設定檔,以免測試條件在不知情的情況下改變。

如何解讀 Connectivity Test

Connectivity Test 可協助判斷伺服器或測試目標是否可連線,但結果會受測試方式、測試位址與當時網路狀態影響。測試成功不代表所有實際服務都正常;測試失敗也不一定表示所有連線都無法使用。請將它視為其中一項證據,並與實際存取結果一併判斷。若能設定測試方法,請先確認目前使用的方式,再比較結果;不同測試方式的耗時不宜直接排序,更不能只憑一個數字推斷長期穩定性。

若測試通過但網頁載入失敗,請先確認問題是否只發生在特定網域、某類請求或某個應用程式。目標服務本身、DNS、TLS、規則比對與遠端存取限制都可能是原因。若所有目標都失敗,請重新檢查伺服器位址、連接埠、驗證參數與基本網路。若只有一個應用程式異常,可先將其完全結束,再重新測試,避免把舊連線或快取誤認為新模式的結果;不要只為清除單一應用程式的連線,就立刻重置所有裝置設定。

分層縮小故障範圍

第一層是基本網路:停止用戶端連線後,裝置能否正常上網,公共網路登入驗證是否已完成。第二層是伺服器連線:在可控條件下使用 Proxy,確認所選伺服器能否處理實際請求。第三層是設定分流:若 Proxy 正常而 Config 異常,應優先檢查生效檔案、規則順序與相關解析設定。第四層是目標本身:若只有一個目標持續失敗,而同類請求正常,應檢查目標服務狀態與具體錯誤,不要把所有問題都歸咎於用戶端。

暫時切換模式是定位問題的工具,不是最終修正方法。測試結束後,應恢復日常所需模式並再次驗證。Proxy 與 Config 的結果不同,可能代表規則路徑不同,也可能與 DNS 或既有連線有關;不能只憑這項比較就斷定某條規則寫錯。測試 Direct 時,也應選擇允許直連的目標。每次只變更一項因素,並記錄變更前後結果,才能逐步排除原因;若同時更換伺服器、模式與網路,即使恢復正常,也無法判斷究竟是哪項變更解決問題。

區分逾時、解析與憑證問題

逾時表示在預期時間內沒有收到所需回應,但無法單憑此資訊判斷是哪個環節未能回應;應配合基本網路、連接埠與目標範圍繼續檢查。解析失敗通常指向網域解析路徑,不應立刻更改驗證密碼。憑證錯誤則應檢查裝置時間、伺服器名稱與伺服器端憑證狀況。關閉驗證會改變連線的信任條件,不應作為一般排錯方式。先核對資料,再向自己的服務供應商確認伺服器端要求,比盲目調整多項進階選項更可靠。

若故障只在切換網路後發生,請記錄切換方向,以及重新建立連線能否恢復;若只在裝置休眠後發生,則比較喚醒後的首次請求與稍後的請求。找到穩定的重現條件後,再調整相關設定;不要一開始就重做系統行為、訂閱格式與所有規則。若仍不清楚首次連線的操作順序,可回到快速入門說明重新完成一次最精簡流程;進階分析應以可重複測試的基本設定為基礎。

06 / 流量與請求觀察

Data 流量統計與紀錄判讀

本章完成標準:了解統計範圍,並以小規模測試核對實際連線;不要把計數當成帳單。

統計反映哪個層級的流量

Data 用來觀察用戶端提供的流量與連線相關資訊;實際顯示項目以應用程式目前介面為準。查看前請先確認統計範圍:是目前連線工作階段、某段期間的累計紀錄,還是特定伺服器的計數。不同範圍不能直接比較。用戶端觀察到的資料,也不同於系統行動網路統計、服務供應商帳號用量或目標檔案大小;若數值不一致,請先確認統計範圍與單位,而不是立刻認定其中一項有誤。

瀏覽一個頁面時,可能會載入正文、圖片、指令碼、字型與背景請求;不能只因網址列顯示一個網址,就推估連線數量。上傳與下載也會同時發生:即使主要是在閱讀內容,裝置仍會傳送請求與協定資料。重新整理頁面、預先載入內容與應用程式背景同步都可能增加統計。若想了解單一操作造成的變化,請先記下操作前的計數,再執行一個明確動作,最後觀察增量;不要只盯著持續增加的總數猜測來源。

用戶端統計不等於服務供應商的計費紀錄

服務供應商可能依自己的計費規則、統計週期與傳輸口徑記錄用量;用戶端紀錄則取決於它能觀察到的連線範圍。傳輸額外負擔、重試與統計邊界都可能造成差異。因此,Data 適合用於本機觀察與輔助排查,不應取代服務帳號的計費依據。買斷用戶端不包含線路服務,應用程式中的流量紀錄也不會增加使用者的服務額度。額度、有效期限與帳號限制,請以自己的服務資料為準。

觀察項目可協助判斷無法單獨證明
流量持續增加用戶端可觀察的範圍內仍有資料活動所有應用程式都能正常存取
單次請求紀錄目標、時間與可能的處理路徑整個頁面的所有請求都採用相同路徑
上傳與下載增量某段測試期間的資料變化服務供應商最後結算的用量
錯誤或重複請求失敗發生的位置與重試情況單一且確定的故障原因

透過單次測試核對規則

準備檢查某條規則時,先記下目前模式、設定檔與測試時間,再只開啟一個目標。若目前介面提供請求或連線詳細資訊,可按相近時間尋找相關紀錄,核對網域、位址與策略資訊。一個頁面可能請求多個不同網域,不能找到第一筆紀錄就停止判斷。主頁面載入成功但部分資源失敗,可能是不同網域套用了不同策略;請將失敗資源與相應規則逐一對照,不要為整個頁面新增範圍過大的例外。

紀錄中沒有出現預期內容,也要審慎解讀。應用程式可能重用了既有連線、目標可能使用快取,或目前顯示範圍未包含該類紀錄。請先發出一個容易辨認的新請求,再確認篩選條件與紀錄範圍。不要不斷重新整理頁面,製造大量重複項目,增加分析雜訊。若要比較修改規則前後的結果,請分別記下兩個時間點,執行相同操作,並確認新設定檔已套用,讓比較確實只對應同一個變數。

背景活動與隱私範圍

停止主動瀏覽後,流量仍有變化並不罕見。系統同步、接收訊息、媒體預先載入與應用程式背景工作都可能繼續使用網路。可先暫停自己能控制的下載與同步,再觀察流量變化是否減少;不要只憑計數增加就推斷異常。若某個應用程式持續失敗並重試,流量也可能一直增加;此時應依錯誤紀錄處理根本原因,而不是只清除統計。清除統計只會重設觀察起點,不會修復連線,也不會重設服務供應商的紀錄。

請求紀錄可能暴露存取的網域、時間、網路位址,以及含驗證資訊的內容。匯出或截圖前,請先確認是否包含訂閱參數、完整存取路徑或個人資料,只保留排查問題所需的最少片段。完成排查後,依自己的隱私需求清除不再需要的紀錄。不要為了取得更多資訊而任意啟用 HTTPS 解密;檢查一般規則時,優先查看目標、時間與策略等中繼資料。若要了解底部各入口的用途,可參閱Home、Config、Data、Settings 介面用語說明。

07 / 自動行為與常用設定

Settings 常用項目與 On Demand

本章完成標準:只調整用途明確的設定,並在每次變更後驗證實際行為。

從穩定的基準設定開始

Settings 用於調整應用程式行為,並非開啟所有選項就能改善連線。首次使用時,請保留一組已驗證可用的基準設定:明確的伺服器、固定的模式、可追溯的設定檔,以及可重複使用的測試目標。之後一次只修改一類設定,並記錄原值與修改目的。應用程式介面可能隨實際版本改變,具體項目請以目前畫面為準;若找不到教學提到的選項,不要以名稱相近的項目代替,更不要透過不明設定強行補上。

有些設定會影響下一次連線,有些會影響目前請求,另一些只會調整顯示或更新行為。因此,儲存後請確認是否需要重新建立連線,再以新請求驗證結果。不能只因畫面上的開關改變,就認定網路已採用新條件。與設定檔相關的設定也可能來自檔案本身;排查時應一併檢查目前檔案與應用程式設定,避免只改了一處,卻受到另一處既有設定影響。

先確認 On Demand 的觸發條件

On Demand 用於依設定條件自動建立連線。使用前,請先明確寫下目標,例如希望在哪種網路環境連線、在什麼條件下保持中斷,再依應用程式實際提供的條件設定。這項功能不會讓伺服器永遠可用,也無法修復驗證失敗。若手動連線尚未確認成功,先不要啟用自動行為;否則重試與網路切換混在一起,很難判斷是條件設定問題還是伺服器問題。

啟用後,請分別測試符合與不符合條件的情境,確認實際結果是否符合預期。手動中斷後又重新連線,可能是自動條件仍成立,而非中斷操作無效。若要暫時停止,請一併檢查自動連線設定。離開原本的網路、返回原網路,以及裝置休眠後喚醒,都值得分開測試;若條件涉及網路名稱,也要考慮名稱相同但實際環境不同的情況,不要把名稱當成可信任網路的唯一依據。

訂閱更新設定的適用範圍

若目前介面提供「開啟應用程式時更新訂閱」設定,可依自己的使用頻率決定是否啟用。此功能可協助更新伺服器清單,但更新仍取決於網路是否可連線,以及訂閱位址是否有效。開啟應用程式後更新失敗,不代表已快取的所有伺服器會立即失效;請分別測試清單更新與既有連線。自動更新也不是持續監控服務供應商的變更,無法保證每次都能在最適當的時間取得最新資料。

變更更新行為前,請先了解訂閱產生的項目會如何處理。若曾修改名稱、排序或連線欄位,應確認下次更新是否保留這些變更。重要調整應另行記錄,不要只留在可能被更新覆蓋的項目中。遇到更新失敗時,先保留可用狀態再查明原因,不要把「自動」理解成可以忽略失敗提示。操作細節可搭配閱讀訂閱手動更新與開啟時自動更新說明,介面入口請以實際應用程式為準。

不要一次嘗試多項 DNS 與連線設定

DNS 會將網域轉換為位址,其請求路徑與結果可能影響後續規則比對及目標連線。變更解析設定前,請先確認問題確實與解析有關,例如同一網域持續解析失敗,但基本網路與伺服器連線已確認正常。不要直接照抄網路上看到的一組解析位址;來源、可連線性與設定用途不明時,增加位址只會增加變因。請保留原設定,並以相同目標比較變更前後的結果。

與 TLS、傳輸、IPv6 或連線重用相關的選項,也應依實際服務要求調整。啟用某項功能需要網路與伺服器端相應支援,並非選項越多越完整。遇到連線問題時,應先核對服務參數,再考慮進階選項;不要透過關閉憑證驗證換取表面上的連線成功。記錄詳細程度也應按需要設定:排查階段收集足夠資訊即可,完成後恢復適合日常使用的狀態,並妥善處理已匯出的紀錄。

08 / 更新、備份與故障復原

日常維護與設定移轉

本章完成標準:維護資料來源清楚、變更可追溯,並能在更新或移轉後恢復至可驗證的狀態。

分開管理三種更新

日常維護至少包含三件不同的事:透過 App Store 更新應用程式、更新訂閱中的伺服器清單,以及更新 Config 中的設定檔。應用程式更新會改變用戶端功能與行為;訂閱更新會變更服務資料;設定檔更新則會變更規則與相關設定。不要在同一次故障排查中同時進行這三項操作。若更新後出現異常,只有清楚知道哪一層發生變更,才能比較前後差異,並向正確的資訊來源查證。

更新前,請確認目前連線是否正在處理重要工作、保存本機變更,並記錄目前使用的設定檔名稱。更新後先檢查伺服器清單與生效檔案,再完成一次實際存取測試,不必立刻調整其他設定。設定檔來源更新可能覆蓋原有內容,訂閱更新也可能改變項目,因此重要的例外規則與手動參數應另存可靠副本。應用程式更新紀錄以 App Store 頁面為準,不要依據網路流傳的編號猜測是否需要更新。

備份需保留內容,也要記錄來源

備份時不只保存檔案,也要記錄檔案來源、適用環境與自行修改的內容。可用簡短名稱區分原始設定檔、測試副本與日常使用副本,並在私人紀錄中說明差異。匯出檔案後,請檢查是否包含訂閱位址、伺服器驗證欄位或其他敏感資訊,再決定存放位置。不要把備份當成一般文件公開分享;即使大部分內容只是規則,只要有一行含驗證資訊的位址,就可能造成資料外洩。

備份是否有效,取決於能否還原,而不只是是否成功匯出。準備移轉前,請確認檔案可讀、來源位址仍可取得,且手動輸入的資料足夠完整。將備份存放在自己能控管的安全位置,並保留清楚的復原順序:先取得應用程式,再完成授權,然後還原服務資料與設定檔,最後驗證連線。若使用同步功能,也要核對實際同步範圍;看到相同檔名,不代表所有設定、紀錄與驗證資料都已一致。

更換裝置後的最精簡復原流程

在新裝置上,先使用原購買帳號從 App Store 重新取得應用程式;系統需求與購買適用範圍以 App Store 頁面標示為準。開啟應用程式後,不要立刻複製所有進階選項;先還原一台可用伺服器或自己的訂閱,選擇明確的模式,並完成系統授權。最精簡流程成功後,再匯入日常規則與自動連線條件。如此若某一步出現異常,就能直接定位到最近還原的內容,而非面對整套設定同時移轉後的未知狀態。

舊裝置上的連線成功,不代表新裝置在不同網路環境下也會有相同結果。請重新檢查區域網路位址、網路登入驗證、裝置時間與自動連線條件。確認新裝置運作穩定後,再處理舊裝置上不再需要的敏感資料;移轉驗證完成前,不要先刪除唯一副本。購買復原有疑問時,可參閱已購項目復原專區;價格與買斷相關常見問題請查看價格與買斷說明,不要透過修改用戶端規則處理帳號問題。

發生異常時,先還原最近的變更

維護期間遇到故障,先確認「上一次正常時的條件」,再確認「之後做了哪些變更」。若只修改過設定檔,先切回備份檔案;若只更新過訂閱,先核對項目參數與選取狀態;若剛啟用 On Demand,先暫停自動行為再手動測試。還原的目的,是恢復可供比較的基準狀態,不代表必須長期使用舊設定。確認差異後再針對特定項目處理,避免每次遇到問題就刪除所有設定重頭開始。

建議保留簡短的私人維護紀錄,寫下變更目的、修改項目與驗證結果,但不要記錄密碼或完整訂閱位址。若問題長期無法重現,也應如實記下發生條件尚不明確,不要為了得到結論而不斷新增規則。如需進一步查閱,可前往部落格說明列表,依規則、訂閱或購買主題閱讀;若只想重新完成首次連線,請回到使用說明。系統手冊的目標是讓每次操作都有依據、每次結果都能解釋,而非把所有選項都設定一遍。