官方手冊Home · Config · Data · Settings

Shadowrocket 完整使用手冊

依照取得、授權、匯入、分流、驗證與維護的順序查閱。操作以 iPhone / iPad 介面為例,安裝說明涵蓋所有平台。

本頁供系統化查閱,說明操作所需條件、設定間的關聯,以及發生問題後的檢查順序。若要先完成一次連線,可從使用說明中的快速入門流程開始,再回到相關章節了解原理。已完成初始設定的使用者,可直接透過目錄找到問題,不必反覆重設所有項目。

閱讀前請備妥已有的訂閱網址或伺服器資訊;相關資料請向你的服務商取得。本文範例中的網域、位址與憑證皆為教學用假資料,無法用於連線。各平台介面配置可能不同,請以裝置上實際顯示的名稱和選項為準。

取得 → 授權 → 匯入 → 分流 驗證 → Data → Settings → 維護
01 / ACQUISITION

取得與安裝

先確認裝置適用的取得管道,再處理系統安裝提示。iPhone / iPad 版在 App Store 售價 $2.99,為一次性購買;Mac / Windows / Android / Linux 版免費。Mac 提供 Apple 晶片與 Intel 兩種安裝檔;其他電腦與 Android 安裝檔請從本站全平台下載頁取得,下載網址位於本站 /dl/shadowrocket/ 路徑下。不同處理器適用的檔案不可任意互換。

iPhone / iPad:確認 App Store 項目

開啟下載頁提供的 App Store 產品頁,確認開發者為 Shadow Launch Technology Limited、App ID 為 932747118,並核對官方圖示。系統需求請以 App Store 頁面標示為準;購買前先確認目前裝置是否符合需求。中國大陸商店可能不會顯示此項目,請先確認 Apple ID 所屬地區;變更地區可能涉及帳戶餘額及現有訂閱等條件,請依帳戶設定中的系統說明操作。搜尋不到項目不一定代表裝置故障。

安裝完成後,請保留原購買帳戶的存取權限。更換裝置或重新安裝時,請使用原購買帳戶至已購項目中尋找,避免只依名稱重新搜尋。同一購買帳戶在 iPhone 與 iPad 上重新下載時,可先參閱iPad 使用與已購項目說明,確認帳戶是否一致;家庭共享等資格則以 App Store 實際顯示為準,不應據此推論其他帳戶也必然享有相同權益。

電腦與 Android:先確認架構再開啟

在 Mac 的「關於這台 Mac」查看晶片資訊:顯示 Apple 晶片時選擇相應安裝檔,顯示 Intel 處理器時則選擇 Intel 版。將應用程式移至 Applications 後再開啟。Windows 請使用下載頁列出的安裝程式;Android 請依下載頁的架構說明選擇檔案;Linux 則依發行版的套件格式選擇 deb、rpm 或 AppImage。副檔名相似不代表適用平台相同;若無法啟動,先檢查架構與套件格式,不要立即更改網路設定。

桌面版與 Android 安裝檔沒有程式碼簽章,首次開啟時可能遭系統攔截。解除封鎖前,請確認檔案確實來自本站下載頁,且檔名與所選平台相符;若來源不明、下載中斷或系統明確警告風險,請先停止操作。以下列出各系統的相關位置,項目名稱可能因系統語言和版本而略有不同。僅處理已確認來源的 Shadowrocket 檔案,不必關閉整個系統的安全防護。

系統安裝或允許開啟的位置
macOS若出現「無法驗證開發者」,請前往「系統設定 → 隱私權與安全性」尋找這次遭攔截的項目,再選擇「仍要打開」。
WindowsSmartScreen 顯示提示時,先確認檔案來源,再選擇「更多資訊 → 仍要執行」;若受組織原則限制,請聯絡裝置管理員。
Android只為這次開啟安裝檔的瀏覽器或檔案管理員啟用「允許安裝未知應用程式」,完成後即可關閉此權限。
Linuxdeb / rpm 請使用相應的套件管理員安裝;AppImage 可在檔案屬性中設為可執行程式,或對實際檔案執行 chmod +x。

若 Mac 提示應用程式「已損毀」,請先刪除未完整下載的檔案,再從下載頁重新下載。確認應用程式完整、已放在下列位置且來源可靠後,才考慮在終端機執行移除隔離屬性的命令。此操作無法修復真正損毀的檔案,也不能取代來源確認。若路徑不同,請先確認實際位置,不要遞迴處理整個資料夾。

xattr -cr /Applications/Shadowrocket.app
02 / PERMISSIONS

首次啟動與授權

首次開啟後,先了解 Home、Config、Data 與 Settings 各自的用途。Home 用來選擇伺服器、Global Routing 與連線開關;Config 管理分流所使用的設定;Data 用於查看流量與連線資訊;Settings 集中管理測試、連線及其他行為設定。不同裝置的導覽位置可能有所不同,請依頁面名稱尋找,不必依照固定螢幕座標找按鈕。沒有伺服器或尚未授權,都不代表安裝失敗。

系統 VPN 設定的用途

首次嘗試連線時,系統可能會要求允許 Shadowrocket 新增 VPN 設定。這項授權是讓應用程式建立系統網路通道,並不會替你新增訂閱,也不會補上伺服器位址、密碼或協定參數。確認提示來自目前正在操作的 Shadowrocket 後,依系統要求使用裝置密碼或生物辨識完成授權。授權後仍須選擇有效伺服器;只有權限而沒有正確參數,連線仍無法正常運作。

VPN 設定項目與應用程式內的 Config 檔案並非同一項目。前者是由系統管理的網路連線紀錄,後者則保存應用程式使用的規則與設定。刪除系統項目可能導致下次連線時再次要求授權;刪除某份 Config 則可能改變分流方式。排查時請先確認要處理的是哪一層,不要為了修改一條規則而清除系統所有 VPN 項目,也不要把應用程式內的訂閱更新當成修復系統授權。

若不慎點選拒絕,請回到 Home 再嘗試啟動連線,確認是否再次出現授權要求;必要時前往系統設定中的 VPN 管理位置查看現有項目。若裝置由學校或公司管理,描述檔可能限制新增 VPN,請先確認管理政策,不要反覆解除安裝。系統提示與設定項目的詳細說明,請參閱新增 VPN 設定提示說明。

依實際操作授予其他權限

使用 Scan QR Code 時,相機權限用於讀取 QR Code;拒絕後可前往系統的應用程式權限設定重新允許,也可改用現有分享連結匯入。剪貼簿提示與貼上操作有關,請先確認其中是你準備匯入的資料。涉及照片、檔案或區域網路的請求,應依目前操作判斷用途。不必為了「設定完整」預先授予所有權限,也不要把拒絕某項輔助權限誤認為伺服器無法使用。

QR Code 與剪貼簿內容可能包含密碼、使用者識別資訊或完整訂閱網址。掃描後先核對產生的項目類型、位址與連接埠,再決定是否儲存;辨識出文字不代表來源已經驗證。拍照、截圖與螢幕共享也可能留下憑證,向他人求助前請遮蔽完整內容。若需保留錯誤提示,優先記錄文字與操作步驟,不要上傳整個伺服器編輯頁面。

先排除其他連線與自動觸發

建立首次基準連線前,檢查系統是否還有其他 VPN 正在連線,以及 On Demand 是否會自動重新連線。一般建議先停止其他相關連線,讓測試只針對目前這一份設定。若開關剛關閉又自行開啟,先檢查自動觸發設定與系統狀態,不要立即認定應用程式無法關閉。系統狀態圖示只代表通道狀態,無法單獨證明遠端伺服器或目標網站可連線。

首次建立基準時,建議使用穩定的 Wi-Fi,先不要切換行動網路、啟用額外自動化或同時修改 DNS。記下當時選擇的伺服器、Global Routing 模式與設定名稱,之後每次只變更一個條件。這樣才能分辨結果來自權限恢復、網路切換還是參數變更;若一開始同時啟用多項功能,發生問題時便難以判斷是哪一步造成影響。

03 / SERVER & SUBSCRIBE

新增伺服器與訂閱

先判斷手上的資料類型,再選擇匯入方式。單一分享連結通常包含一台伺服器的資訊;訂閱網址用於取得可更新的伺服器清單;設定檔還可能包含規則、DNS 等設定。不能只因為它們都是一段網址,就認為彼此可以替代。資料請向你的服務商取得;若只有說明圖片,先確認其中提供的是訂閱入口還是單一伺服器參數,避免把網頁網址填入伺服器位址欄位。

Add Server:逐項確認欄位含義

在 Home 使用 Add Server 時,先選擇資料指定的協定,再填入位址、連接埠及相應的驗證資訊。位址欄位通常不應包含網頁路徑,連接埠必須與伺服器端一致;顯示名稱僅供本機辨識,改名不會改變實際連線位置。貼上後請留意前後的空格與換行,尤其不要把中文標點、說明文字或連接埠前的冒號一併貼進不相符的欄位。

不同協定中同樣稱為「密碼」的欄位,用途不一定相同。Shadowsocks 需要相符的加密方式與密碼;VMess、VLESS 通常涉及使用者識別資訊;Trojan 使用其驗證資訊,並須留意 TLS 相關參數。WireGuard 則使用金鑰與對端設定,不能以一般密碼代替。不要任意切換協定試錯,請先對照服務端提供的完整欄位;若缺少參數,應回頭確認原始資料,而非猜測常見值。

參數組確認要點常見混淆
位址 / 連接埠連線目標與伺服器監聽的連接埠相符。將訂閱 URL 誤當成伺服器位址。
驗證資訊密碼、使用者識別資訊或金鑰須符合協定。複製到備註欄,驗證欄位仍是空的。
TLS / SNI依資料確認啟用條件與伺服器名稱。任意將用於憑證驗證的名稱改成連線 IP。
傳輸設定類型、Host、路徑等設定必須彼此相符。只複製路徑,漏掉相應的傳輸類型。

Subscribe:匯入後確認更新結果

新增訂閱時,請在應用程式中選擇相應的 Subscribe 或訂閱類型入口,貼上完整網址並填寫易於辨識的名稱。儲存後執行一次更新,確認是否出現預期的伺服器清單。更新成功不代表清單中的每台伺服器都能連線,只表示此次資料已成功取得並解析。若顯示成功卻沒有項目,請檢查回傳內容、篩選條件與服務狀態,不要立刻清空原有清單。

以下僅展示訂閱網址的結構,並非可用服務。問號後的參數可能包含存取憑證,複製時漏掉其中一段會造成驗證失敗;完整 URL 也不應公開在求助內容中。範例網域僅供說明,頁面上的範例網址不是外部存取入口。

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

訂閱更新失敗時,先確認目前網路能否存取該網址,再檢查原始資料是否更換入口、是否有到期提示,以及複製內容是否遭聊天工具截斷。若回傳的是登入頁面、驗證頁面或錯誤說明,就不能當成伺服器清單匯入。請暫時保留上次正常的訂閱項目,避免在取得新清單前刪除所有可還原資訊;反覆重新整理也無法修復已失效的憑證。

分開管理分享連結、QR Code 與設定檔

ss://、vmess://、vless://、trojan:// 等分享連結通常包含單一伺服器資訊,可使用應用程式支援的匯入入口或 Scan QR Code 識別。匯入後仍須開啟項目核對欄位,尤其是經過文字轉傳的連結。詳細差異請參閱分享連結與訂閱連結說明。不要只依連結長短判斷內容是否完整。

從 Config 匯入設定時,還需確認其中是否包含遠端規則、重寫或其他設定。匯入前先備份目前設定,匯入後確認目前啟用的是哪一份;新檔案出現在清單中,不代表它已生效。訂閱中的項目可能在更新後遭覆寫,直接修改其中一台伺服器前,請先了解其維護方式;若要長期保留個人修改,應使用可獨立管理的副本並記錄來源。

04 / GLOBAL ROUTING

Global Routing 與規則

Global Routing 決定連線採用哪一種整體處理方式。日常依規則使用時,選擇 Config 模式;暫時比較伺服器連線路徑時,可使用 Proxy 模式;需要建立直連基準時,則可使用 Direct 模式。這裡的中文僅說明用途,介面名稱仍為 Config、Proxy、Direct。模式與目前選擇的伺服器是兩個獨立項目:更換伺服器不代表某條規則已命中,選擇 Config 也不表示設定內容必然符合預期。

模式主要用途檢查重點
Config依目前設定決定連線去向。已啟用的設定檔、規則順序與最終策略。
Proxy讓受接管的連線經由代理路徑進行比較。目前伺服器與遠端可連線性;不據此推斷系統保留的流量。
Direct讓受接管的連線經由直連路徑進行比較。目前網路本身是否能存取目標。

使用 Config 的前提是選對設定檔

進入 Config 後,先確認目前選取的檔案,再查看其中的規則。匯入太多檔案時,名稱相近容易讓人誤以為「改了卻沒有變化」。編輯前先備份,修改後儲存並確認仍啟用這份檔案;必要時先停止再重新連線,讓後續新連線使用更新後的設定。既有連線可能仍沿用原本路徑,因此不要只靠一個持續開啟的網頁判斷修改是否生效。

規則通常依序檢查,第一條符合的規則會決定處理策略。範圍較小的例外應放在涵蓋範圍較大的規則之前;兜底規則則放在最後。若某個精確網域規則排在已匹配該網域的後綴規則之後,通常無法達成覆蓋效果。規則不是互相投票,也不是越後面優先級越高;排查時應從上往下找出第一條可能命中的項目。

先看懂條件,再看策略

DOMAIN 用於精確比對網域,DOMAIN-SUFFIX 依網域後綴比對,DOMAIN-KEYWORD 則依網域中的關鍵字比對。關鍵字條件的涵蓋範圍可能很大,不了解影響範圍前不適合大量新增。IP-CIDR 與 IP-CIDR6 用於比對位址範圍,GEOIP 則依相應的地理資料判斷;網域比對與位址比對屬於不同層次,不能只看目標名稱就推斷最後會命中哪一項。

[General]
bypass-system = true
dns-server = system

[Rule]
DOMAIN,example.com,PROXY
DOMAIN-SUFFIX,example.org,PROXY
DOMAIN-KEYWORD,example,DIRECT
IP-CIDR,192.168.0.0/16,DIRECT
IP-CIDR6,fc00::/7,DIRECT
GEOIP,CN,DIRECT
FINAL,PROXY

以下片段僅供理解語法,不是建議直接覆蓋現有設定的通用方案。規則末尾的 PROXY、DIRECT 代表處理策略,REJECT 表示拒絕;它們都不是伺服器位址。FINAL,PROXY 會接收前面規則都未匹配的連線;改成 FINAL,DIRECT 則會改變這部分流量的去向。不了解兜底行為前,不要只複製最後一行。

透過比對結果縮小問題範圍

若某個目標在 Proxy 下可用、在 Config 下無法使用,先檢查設定與命中策略,不要立即更換伺服器。反過來,若 Direct 可用而 Proxy 無法使用,代表應優先檢查代理路徑,但仍不能只憑一次結果斷定是驗證或伺服器端故障。測試時應使用相同目標、相同網路與新連線,並維持其他條件不變,結果才有比較價值。

DNS 會參與網域到位址的轉換,因此某些位址規則的實際效果也會受到解析結果影響。若無法存取區域網路裝置,請檢查私有位址範圍、區域網路名稱與目前路由,不要將所有流量都改為直連。USER-AGENT 等條件各有適用範圍,不能假設所有加密連線都能讀取相關請求資訊;若要依網域分流,請優先確認是否已有可匹配的網域條件。

05 / CONNECTION CHECK

連線與驗證

連線驗證分為三個層次:系統通道是否建立、伺服器路徑是否可用,以及目標請求是否依預期規則處理。三個層次都要檢查,不能以其中一項成功代替全部結論。開始前,在 Home 確認目前的伺服器、Global Routing 模式與 Config 檔案,並停止無關的測試工作。首次排查請先選擇一台資料完整的伺服器,維持同一網路,測試途中不要連續切換多個項目。

啟動連線後先查看系統狀態

開啟 Home 的連線開關,完成系統要求的授權並等待狀態變化。若立即中斷,先記下提示原文,再檢查權限、伺服器欄位與設定解析錯誤;反覆開關通常只會重複相同錯誤。若開關維持開啟但網頁無法開啟,表示還需檢查網路路徑,此時不應反覆刪除系統 VPN 設定。若停止後自動恢復,請重新檢查 On Demand 與其他自動連線條件。

系統狀態圖示出現,表示裝置存在相應的網路通道,不代表訂閱期限、遠端驗證與目標存取都正常。有些請求也可能未進入目前正在觀察的連線路徑。驗證時請主動產生新請求並記錄發出時間,再查看 Data 中同一時段的紀錄。若將很久以前保留的頁面重新整理結果當成新測試,容易受到快取、舊連線或背景請求影響。

分別進行 Connectivity Test 與實際存取

在 Home 使用 Connectivity Test 前,先了解目前選用的測試方法。不同方法檢查的層次不同:有些著重於建立連線,有些還會涉及應用程式層級的請求。不同方法的數值不可直接比較,也不能據此保證所有網站都能存取。某項測試失敗時,應搭配實際目標的存取結果判斷,不要只依清單排序決定可用性,更不可將測試結果視為服務品質保證。

接著開啟一個你平常能正常存取的頁面作為基準,再前往實際遇到問題的目標。盡量讓兩次測試都建立新連線,並觀察是所有請求都失敗,還是只有單一網域、登入流程、圖片或影片資源異常。同一頁面可能依賴多個網域,主頁能開啟不代表所有附屬請求都採用相同策略;記錄具體失敗的資源,比籠統地說「網路不通」更有助於排查。

依照現象選擇檢查方向

現象優先檢查下一步比對
一啟動就中斷系統授權、設定錯誤、伺服器欄位。還原已知正常的設定,記錄新的提示。
連線維持中,但所有存取都失敗目前伺服器、基礎網路、驗證、DNS。中斷連線後的基礎網路存取,以及另一台已新增的伺服器。
Proxy 正常,但 Config 異常目前設定、匹配規則、最終策略。查看目標連線實際採用的策略。
只有一個網站異常相關網域、網站本身狀態、登入與地區限制。在相同網路下發出新請求,並測試網站其他頁面。
切換網路後發生異常Wi-Fi 登入頁、行動網路權限、網路重新建立。在穩定網路中停止後重新連線。

遇到網域解析錯誤時,先判斷是所有網域都失敗,還是只有特定網域異常,再檢查設定中的 DNS 與目前網路。不要直接把網址列中的網域改成 IP,當作最終解決方式:TLS 憑證驗證、伺服器名稱與網站虛擬主機設定可能都依賴網域,直接連到位址並不等同原始請求。若解析結果來自快取,也要確認重新測試時確實觸發了新的解析。

若只有行動網路無法使用,先確認系統允許應用程式使用行動數據,並檢查是否受到流量限制或網路連線問題影響;公共 Wi-Fi 則可能需要先完成網頁驗證。切換網路會使既有連線失效,短暫中斷不一定代表參數錯誤。回到穩定網路後重新連線,再以相同目標重測,避免混用兩種網路的結果。

整理可重現的故障紀錄

有效的紀錄應包含裝置系統、網路類型、執行的操作、目前模式、設定名稱與錯誤原文。伺服器名稱可使用自己的簡稱,不必公開位址、密碼、訂閱連結或金鑰。說明「某個目標在 Proxy 可用、在 Config 不可用」,比連續提供多張沒有脈絡的截圖更容易縮小問題範圍;若已進行比對,也請說明每次只變更了哪個條件。

06 / DATA & OBSERVATION

Data 流量與連線紀錄

Data 用來解讀已發生的網路活動,不是訂閱服務的帳單頁面。請先確認目前頁面統計的對象、時間範圍,以及數值是否從上次重設後累計,再查看上傳、下載或連線紀錄。應用程式顯示的流量可能與服務商計算的用量不同,兩者的計量位置、週期與統計方式未必一致;不要只因數字不相同,就認定其中一方出錯。

區分裝置活動、應用程式統計與伺服器端計量

裝置在背景中仍可能同步照片、接收通知、更新內容或維持應用程式工作階段,因此沒有主動開啟網頁時出現流量並不罕見。Data 的流量變化須搭配具體時間與連線紀錄判讀,不能直接推斷某個伺服器項目正在「自行下載」。若要觀察單一操作,請暫停明顯的背景工作、關閉無關頁面,並在短時間內只執行一項明確操作。

請依目前統計的對象理解上傳與下載方向。網頁請求通常同時會產生少量上傳與較多下載,但視訊通話、雲端同步和傳送檔案可能完全不同。加密、協定封裝、重傳,以及通道外的網路活動,都可能造成不同統計層級顯示的位元組數不一致。若服務商依自己的週期計費,請以其提供的計量說明為準;用戶端顯示無法取代帳戶端紀錄。

還要區分訂閱項目附帶的資訊與本機即時統計。某些訂閱會回傳帳戶流量或期限文字,這些內容來自訂閱回應,並非 Shadowrocket 獨立核驗伺服器端餘額。更新訂閱後文字有所變化,也不代表目前裝置剛好產生了相同用量。閱讀時請先確認資訊來源,再判斷應更新訂閱、查看 Data,或核對服務商帳戶。

比對請求、規則與策略

排查特定網站時,先記下開始存取的時間,再到 Data 尋找相應網域或位址的連線紀錄。若目前介面支援搜尋或篩選,可縮小到相關內容;若找不到紀錄,先確認請求確實重新發出、目前連線仍在執行,以及是否使用了應用程式快取。沒有新連線紀錄,不能單獨證明規則有誤,也可能是頁面沒有產生新的網路活動。

找到紀錄後,對照目標、匹配規則與實際策略。預期為 PROXY 卻顯示 DIRECT 時,請回到 Config 從上往下檢查較早命中的規則;預期匹配特定網域,卻只看到位址時,則應連同解析流程與紀錄顯示方式一起判斷。不要看到一個位址就立即新增位址範圍規則;大型網段可能服務多個完全不同的網域,影響範圍可能超出目前問題。

同一頁面通常會有多筆連線,登入、圖片、API 與媒體請求可能各自連到不同網域。若主頁正常但內容空白,應找出失敗的那組請求,不要反覆新增主網域規則。對於持續連線或重用連線的應用程式,修改規則後可能需要關閉相關頁面或應用程式再試;如此觀察到的才是新設定的行為,而非舊工作階段的延續。

以短時間觀察取代長期盲目記錄

若要分析流量異常增加,先記錄目前統計範圍,再執行一項可描述的操作,例如重新整理單一頁面或上傳已知檔案。接著比較前後變化,並核對該時段的連線紀錄。每次只測一種操作,避免將系統更新、照片同步與網頁測試混在同一時間範圍內。若要重設本機統計,請先儲存需要的摘要;重設只會清除觀察基準,不會恢復服務商帳戶的流量額度。

連線失敗時仍可能產生流量,因為建立連線、驗證與重試本身都需要通訊。反過來,流量增加也不代表目標內容已完整載入。判斷可用性應回到上一章進行實際存取驗證,Data 的作用是提供判讀線索。若要排查耗電,還須搭配系統電池用量與背景活動判斷;流量少不代表無線網路喚醒次數少,流量多也不能單獨說明設定有問題。

07 / SETTINGS

Settings 常用項目與注意事項

適合在連線已可正常使用的情況下,逐項調整 Settings;不適合一次嘗試所有開關。進入設定前先釐清問題:要自動重新連線、變更測試方式,還是處理特定解析狀況。只修改與目標直接相關的一項,保留原值並重新驗證。不同平台與應用程式版本顯示的項目可能不同;若找不到某個項目,先確認目前介面,不要照搬其他裝置的操作路徑。

On Demand:依觸發條件決定行為

On Demand 會依條件觸發連線,實際效果取決於目前啟用狀態與相關條件,並不等於「只有開啟特定網頁時才會產生流量」。啟用前先確認手動連線正常,再查看應用程式提供的條件與系統行為。若希望手動停止後維持中斷,先確認自動觸發是否仍開啟;否則網路變化或符合條件的請求可能再次建立連線。

測試自動連線時,先在穩定網路中觀察,再依計畫切換 Wi-Fi 與行動網路,並在每個步驟確認系統連線狀態。不要透過快速連續鎖定螢幕、切換網路和開關連線來判斷,因為多個觸發條件可能同時作用。若裝置暫時不需要自動連線,可先關閉相關設定,再確認手動控制是否恢復預期;這比直接刪除所有設定更容易還原。

耗電沒有適用於所有人的單一開關解法。背景請求頻率、網路訊號、重新建立連線及其他應用程式活動都會影響電池表現。請在系統電池頁面查看同一時段的前景與背景活動,再依使用方式判斷,不要只根據 On Demand 是否開啟下結論。詳細取捨請參閱On Demand 與背景耗電排查。

DNS:確認設定位置與測試方式

DNS 相關選項可能來自目前的 Config,也可能與應用程式全域設定共同作用。修改前先查看設定中的 [General] 等相關內容,確認實際要變更的是哪一層;若多處出現同名選項,應先弄清楚實際優先順序,不要留下兩套互相矛盾又無人記錄的設定。使用 dns-server = system 的範例只表示採用系統解析設定,不代表適用於所有網路環境。

遇到解析失敗時,先檢查基礎網路是否已完成連線,再確認是否只有特定網域異常。更換解析方式前先記錄原值,並以相同目標重新測試;變更 DNS 無法修復密碼錯誤、伺服器失效或傳輸參數不符。企業內網與區域網路名稱尤其需要謹慎處理,任意改變解析路徑可能導致原本可用的內部服務無法解析。

快取也會影響觀察結果。修改解析設定後,舊連線與既有解析結果可能使第一次測試看起來沒有變化,因此需要主動建立新連線並搭配紀錄確認。不要為了追求「立即更新」而每次都刪除所有應用程式資料;先使用目前介面提供的相關操作,並確認清除解析快取、停止連線與刪除設定各自會造成什麼影響。

測試、背景行為與診斷設定

Connectivity Test 的方法與目標應前後一致。切換測試方法後,結果的意義也會改變,不能直接和先前數值比較;自訂目標時,也要確認目標本身可靠且符合測試用途。測試只用於提供排查線索,並非在背景執行得越頻繁越好。大量頻繁測試可能產生額外請求,也會讓原本要觀察的實際連線更難辨識。

只在需要時啟用適當詳細程度的記錄或診斷選項,重現問題後應盡快恢復日常設定。詳細紀錄可能包含位址、路徑或驗證相關內容,匯出前請先自行檢查。系統的行動網路權限、低耗電狀態、通知與背景管理也可能影響使用體驗,但不一定都在 Settings 內;排查時請區分應用程式設定與系統設定,避免在錯誤的位置反覆尋找。

08 / MAINTENANCE

日常維護與還原順序

日常維護的目標是讓設定來源可追溯、修改可還原、故障可重現,而非頻繁更改所有設定。保留一份已知可用的設定與必要操作紀錄,通常比堆積多份同名檔案更有價值。整理前先確認目前使用的伺服器、訂閱群組與 Config,避免清理時刪除正在使用的資料。含有驗證資訊的備份應以敏感資料方式管理。

分別備份三類資料

第一類是伺服器與訂閱來源,第二類是規則設定,第三類是個人設定與診斷紀錄。三者可能需要透過不同入口儲存,匯出一份 Config 不一定能完整保存所有伺服器與憑證。備份後請檢查檔案實際包含的內容,並記下還原步驟;不要等到舊裝置已清除後,才發現只存下一個檔名或一張沒有完整網址的截圖。

備份檔案可能包含密碼、金鑰、使用者識別資訊,以及帶有憑證的訂閱 URL,應存放在自己可控且受保護的位置。透過雲端或裝置間傳送時,先確認帳戶與接收裝置,不要在公開討論區上傳原始檔案。若憑證確實外洩,請向你的服務商取得更換或撤銷方式,再更新本機項目;只刪除已傳送的圖片,並不能保證憑證已失效。

分開驗證訂閱更新與設定更新

更新訂閱前,先確認目前仍有可用的還原方式;更新後檢查項目名稱、數量變化,以及目前選取的項目是否仍存在。名稱變更可能讓原本熟悉的項目變得不易辨識,但不能只靠名稱猜測設定相同。若更新後全部異常,先對照原始資料與錯誤提示,保留舊紀錄以便判斷;不要連續刪除並重建,造成前後差異遺失。

遠端 Config 更新可能覆蓋本機規則修改,手動維護的例外應在更新前另外記錄。更新後重新檢查啟用的檔案、規則順序與 FINAL 策略,再以少數固定目標驗證。訂閱更新成功不代表設定更新成功,兩項操作應分別確認結果;同樣地,一台伺服器正常不代表整份清單都正常,不必為了「全面檢查」而頻繁測試所有項目。

應用程式更新與換機還原

iPhone / iPad 透過 App Store 管理應用程式更新;Mac、Windows、Android、Linux 請從本站下載頁重新取得相應安裝檔。更新前先停止連線並儲存需要的設定,安裝時依第一章的系統允許開啟說明操作。尚未確認備份內容前不要先解除安裝;部分系統在解除安裝時會刪除本機資料,重新安裝後能否自動還原不可只憑經驗假設。

更換裝置時,先安裝應用程式,再確認系統授權,接著匯入伺服器與設定,最後還原自動連線等個人選項。依此順序逐階段驗證,不要將舊裝置的所有設定一次套用到新裝置後才開始測試,因為網路、系統權限與背景管理條件都可能已經不同。先建立手動連線可用的基準,再逐項恢復其他行為。

依由簡到繁的順序排除故障

先檢查基礎網路,再確認權限、伺服器欄位、Global Routing 與目前的 Config;接著使用已知正常的伺服器或設定進行比對,最後才考慮重新匯入或重新安裝。每個步驟都保留錯誤原文與結果,避免只剩下「已經試過很多次」卻沒有可比較的資訊。刪除系統 VPN 項目只應用於明確需要重建的紀錄,清除所有設定不應成為一般存取故障的第一步。

若問題發生在某次更新後,先確認更新的是應用程式、訂閱、設定還是裝置系統,再檢查相應變更。若只有單一目標異常,優先回到第五章觀察實際請求;若只有背景自動連線異常,則回到第七章檢查觸發條件。依問題所屬層級回查,比從頭重做每個步驟更有效率,也能減少引入新的不確定因素。

需要進一步求助時,請整理裝置系統、網路類型、操作順序、目前模式、錯誤提示與已完成的比對,移除所有憑證後再描述問題。常見狀況可先到常見問題查找,介面含義可查閱術語表;若只想重新走一次最短連線流程,回到使用說明即可,不必開啟完整手冊中的所有進階選項。