準備 / 用戶端與網路範圍
通用準備：確認設定來源與流量接管方式
先分清用戶端、核心與連線設定
v2rayN 是桌面圖形化用戶端，可儲存伺服器資料、管理訂閱、產生執行設定，並控制系統代理等功能；實際建立連線的是它呼叫的核心。Project V 是相關代理技術的專案背景，V2Fly 與 Xray 則是常見的核心系列。Android 可選用以 Xray 為核心的 v2rayNG，或以 V2Fly 為核心的 v2flyNG。用戶端名稱相似，不代表支援的參數完全相同。取得連線資料後，先確認協定、傳輸方式與安全設定，再確認所選用戶端及核心是否支援。
安裝用戶端不會自動取得可用的伺服器。開始前，請準備可信來源提供的訂閱網址、單一分享連結，或完整伺服器參數。訂閱網址通常含有可識別帳戶的資訊，取得網址的人可能因此拿到相同的連線資料，請勿公開貼在截圖、論壇或共用筆記中。也請確認系統日期與時區正確，且網路能正常連線至必要服務。時間差異過大會影響憑證驗證，也可能導致部分依賴時間的驗證失敗，容易被誤認為節點無法使用。
確認處理器架構，再選擇安裝方式
桌面平台建議使用 v2rayN，並在下載頁面依作業系統與處理器架構選擇。Mac 可在「關於這台 Mac」查看晶片；Windows 請查看「系統資訊」中的系統類型；Linux 則要確認處理器架構與發行版套件格式。Android 通常選擇 arm64，只有不確定裝置架構或安裝時出現不相容提示，才考慮通用套件。不要只看檔名中熟悉的字眼猜測架構，也不要混用不同作業系統的套件。若已安裝用戶端，請先記錄目前的運作模式與必要設定，再安排升級，避免同時變更版本與網路設定。
| 方式 | 接管入口 | 主要限制 |
|---|---|---|
| 系統代理 | 作業系統的代理設定 | 應用程式必須支援並使用這項設定 |
| 應用程式手動代理 | 應用程式本身的 HTTP 或 SOCKS 設定 | 只影響已設定的應用程式 |
| TUN | 虛擬網路介面與路由 | 受權限、排除規則與核心實作影響 |
建立可復原的初始狀態
初次設定請從系統代理開始，不要同時啟用 TUN、第三方網路加速工具、其他代理用戶端或自訂 DNS。系統代理只是將遵循設定的應用程式導向本機監聽連接埠，不代表所有網路連線都會經過代理。TUN 則透過虛擬介面接管符合規則的流量，涉及路由與權限，排查範圍更廣。若只需要讓瀏覽器連線，先使用系統代理即可；只有在應用程式不使用系統代理時，再評估手動代理或 TUN。將需求對應到模式，才能判斷哪些情況屬於正常限制。
記下用戶端顯示的實際監聽位址、連接埠與目前伺服器，不要把範例連接埠當成本機設定。若預設只供本機使用，請保留迴環監聽位址，避免直接開放給整個區域網路。測試前選一個一般 HTTPS 網頁，並準備另一個獨立服務作為對照；單一網站的帳戶限制、地區政策或服務異常，不能證明用戶端整體故障。變更設定時一次只改一項，儲存後觀察記錄與連線結果，再決定保留或還原。
安裝前也要確認儲存位置可寫入、沒有舊程序占用監聽連接埠，以及公司或學校裝置是否由管理政策統一控管網路。受管理裝置上的代理、憑證與虛擬網路權限可能無法自行變更。此時請遵循裝置管理規範，不要反覆嘗試繞過政策。若裝置已有可用設定，請先匯出必要資料並妥善保存；匯出的設定可能包含存取憑證，不能當成一般無敏感資訊的檔案分享。
平台 / macOS
macOS：安裝 v2rayN 與設定系統代理
依晶片選擇安裝套件，並固定應用程式位置
開啟 Apple 選單中的「關於這台 Mac」：若顯示 Apple 系列晶片，請選擇 Apple Silicon 安裝項目；若顯示 Intel 處理器，則選擇 Intel 安裝項目。前往macOS 下載區取得對應安裝套件，開啟磁碟映像檔後，將 v2rayN 拖曳至「應用程式」，再從該資料夾啟動。不要長期從磁碟映像檔執行，也不要將程式放在可能遭清除的暫存資料夾。固定應用程式位置有助於保留權限並方便後續更新；首次啟動後若要退出，可退出安裝磁碟映像檔，不影響已複製的應用程式。
若系統提示無法開啟，請先確認下載來源、晶片選擇與安裝是否完成，再查看「系統設定 → 隱私權與安全性」是否提供允許這次啟動的選項。確認來源可信後，再使用系統提供的單次允許方式；不要為了開啟單一程式而關閉整套系統防護。若裝置由組織管理，權限可能受到政策限制。反覆點兩下通常不會改變結果，請保留提示的完整內容，分辨是系統安全性封鎖、應用程式損壞提示，還是處理器不相容；不同問題需要不同的處理方式。
匯入訂閱後，先確認目前伺服器可用
前往訂閱群組設定，新增群組並貼上完整訂閱網址。儲存群組後，還要執行訂閱更新；出現群組名稱不代表伺服器已成功下載。更新完成後，檢查伺服器清單並選取其中一項作為目前伺服器。若收到的是以協定前綴開頭的單一分享連結，請使用剪貼簿匯入功能，不要貼到遠端訂閱網址欄位。不同版本的選單配置可能有所變動，操作目標始終是「儲存訂閱來源 → 更新 → 選擇伺服器」，不要只依照截圖尋找按鈕。
接著啟用「自動設定系統代理」，並確認用戶端核心已啟動。這會寫入系統網路代理設定，讓遵循這些設定的應用程式連線至本機代理。切換 Wi-Fi、改用有線網路或新增網路服務後，若連線狀況不同，請查看目前使用中的網路服務代理頁面，確認其指向用戶端正在監聽的位址與連接埠。不要不加判斷地勾選所有代理協定；是否需要設定 HTTP、HTTPS 與 SOCKS，應以用戶端的自動設定及所用應用程式需求為準。
TUN、睡眠喚醒與退出後的網路
系統代理正常運作後，再評估是否需要 TUN。啟用前請閱讀目前版本的權限提示，依照要求授權輔助元件或網路相關權限，並確認沒有其他虛擬網路工具同時接管預設路由。啟動 TUN 後若一般網路反而失效，請先關閉 TUN，確認系統代理模式是否仍正常。開關顯示啟用，不代表虛擬介面、路由與 DNS 都已成功建立；請查看記錄，確認核心是否回報權限不足、介面建立失敗或路由寫入失敗。
Mac 從睡眠喚醒、切換網路熱點或接上擴充基座後，原有連線可能已失效。先確認目前網路正常，再重新連線用戶端；若只有個別應用程式異常，請完全結束後重新開啟，避免舊連線池繼續使用已中斷的連線。瀏覽器正常但終端機失敗並不少見，許多命令列程式不會使用系統代理，需要另外指定代理參數。反過來說，終端機可用也不能證明瀏覽器沒有獨立代理設定或擴充功能干擾；測試時請分清連線入口。
正常結束前，先清除系統代理並關閉 TUN。若應用程式意外退出後網頁無法開啟，請前往目前網路服務的代理設定，檢查是否仍指向已停止的本機連接埠；確認是本次用戶端寫入的項目後再移除。不要刪除不明的組織代理設定。若要讓同一網路中的其他裝置共用代理，只傳送本機迴環位址並不足夠，還須處理監聽範圍與防火牆，詳情請參閱允許區域網路連線說明。
平台 / Windows
Windows：桌面版、WPF 與代理接管
選擇介面版本，避免共用執行資料夾
Windows 下載區提供 v2rayN 桌面版與經典 WPF 版。桌面版採用新一代跨平台介面，WPF 版則保留經典 Windows 介面；兩者都是圖形化用戶端，介面差異不代表伺服器協定本身不同。請依裝置架構與安裝套件說明選擇；若缺少執行元件，依明確的啟動提示處理。不要根據其他使用者的截圖推斷本機一定缺少某項相依元件，更不要為了測試啟動而大量安裝來源不明的執行元件套件。
安裝或解壓縮位置應可寫入，避免直接在唯讀資料夾或壓縮檔暫存檢視中執行。若要同時比較兩種介面，請使用各自獨立的程式與資料位置，先匯出必要設定，不要讓兩個程序直接共用並修改同一份資料。確認工作列或系統匣沒有舊執行個體仍在運作；重複啟動可能造成連接埠占用，也可能讓人誤以為變更沒有生效，因為實際接管系統代理的可能是另一個執行個體。關閉視窗是否會結束程式，請以系統匣狀態和程序為準。
訂閱更新與系統代理是不同步驟
新增訂閱群組後執行更新，再到伺服器清單選擇目前伺服器。先查看更新記錄是否成功取得內容，再判斷伺服器本身能否連線。從其他裝置複製連結時，特別留意換行、空格與結尾的查詢參數；通訊軟體有時會將顯示文字與實際連結分開。匯入後若名稱正常但無法連線，請檢查協定、安全層與傳輸欄位是否完整，不要只看伺服器名稱就認定設定相同。手動修改前請先保存原始資料，以便還原。
啟用「自動設定系統代理」後，遵循 Windows 使用者代理設定的應用程式會嘗試使用本機代理。瀏覽器可以連線，不代表系統服務、背景更新程式或所有命令列工具都走相同路徑；部分程式使用獨立代理設定或不同網路介面。首次測試使用預設使用者權限即可，只有 TUN 或明確要求系統權限的操作才需要提高權限。長期以系統管理員身分執行，無法修正錯誤的訂閱或不相符的伺服器參數，反而會混淆權限與設定問題。
處理防火牆、TUN 與連接埠衝突
若記錄顯示連接埠繫結失敗，先停止其他代理程式並檢查是否有舊的 v2rayN 程序，再考慮更換本機連接埠。更換連接埠後，所有曾手動設定代理的應用程式也要同步修改；系統代理同樣需要重新套用。防火牆提示應依程式來源、網路類型與使用範圍判斷；單機使用通常不需要主動開放區域網路的連入連線。不要關閉整套防火牆來測試，應找出遭封鎖的特定程式或連線，再新增範圍明確的規則。
TUN 涉及虛擬網路介面、路由與權限，啟用前請先確認系統代理模式正常。裝置上同時執行其他虛擬網路工具時，可能發生預設路由、DNS 或網段衝突。若啟用 TUN 後完全無法連網，先停用 TUN 並恢復一般連線，再查看介面建立與路由相關記錄。若停用其他工具後恢復正常，請逐一比較它們的流量接管範圍，不要反覆重裝用戶端。遠端桌面環境尤其要謹慎，路由變更可能中斷目前的管理連線。
還原網路時，先在用戶端清除系統代理，再結束程式；若用戶端已當機，請在 Windows 代理設定中檢查是否殘留手動代理。自動設定指令碼與手動代理是不同入口；若裝置原本使用組織提供的指令碼，不應一併清除。系統休眠或切換網路後，可以先重新啟動連線，不必重裝應用程式。升級前保存訂閱來源與自訂路由；升級後先重新測試原有的系統代理流程，再啟用其他功能，才能在發生異常時判斷是升級變更還是新設定造成。
平台 / Linux
Linux：軟體套件、桌面代理與權限範圍
確認處理器架構與發行版套件格式
安裝 Linux 前需要確認兩件事：處理器是 x86_64 還是 aarch64，以及發行版使用 deb 或 rpm 套件。前者決定程式能否執行，後者決定系統套件管理工具能否安裝，兩者不能互相取代。前往Linux 下載區，依架構與格式選擇 v2rayN。若圖形安裝程式無法處理套件，請先查看具體錯誤訊息，分辨是架構不相符、缺少相依套件，還是系統環境不符合需求；不要把所有安裝失敗都當成檔案損毀。
可在終端機執行以下唯讀指令確認環境。uname -m 顯示 x86_64 通常對應 x64，aarch64 通常對應 arm64；發行版名稱與版本資訊有助於判斷套件管理系統，但不代表任意同格式套件都一定相容。安裝相依套件時，請使用發行版提供的軟體來源與套件管理流程，避免從多個不明來源拼湊底層程式庫。若程式啟動後立即結束，可從桌面應用程式啟動記錄或終端機輸出查看錯誤，先確認是圖形環境問題，還是核心未能啟動。
uname -m
cat /etc/os-release匯入訂閱後，檢查桌面環境的代理設定
啟動 v2rayN 後建立訂閱群組、儲存網址並更新伺服器清單，再選取目前伺服器。Linux 剪貼簿由桌面工作階段管理；遠端工作階段、不同顯示協定或權限變更都可能導致讀取失敗。若從剪貼簿匯入沒有反應，請先確認連結確實位於目前使用者的剪貼簿中，必要時改用用戶端提供的手動輸入方式。不要把剪貼簿讀取失敗誤認為不支援協定，也不要因此以高權限執行整個用戶端，以免資料歸屬與桌面工作階段脫節。
不同桌面環境的系統代理實作並不相同。用戶端完成自動設定後，請前往目前桌面環境的網路代理頁面確認，不要假設所有發行版的行為都一樣。瀏覽器可能會讀取桌面代理，終端機程式則經常仰賴自身參數或代理環境變數；已啟動的程序也不一定會重新讀取環境變更。測試時可暫時為特定指令明確指定代理，將「核心能否連線」與「桌面代理是否被使用」分開判斷。故障章節會說明下方的診斷指令。
了解迴環監聽與 TUN 權限
本機使用時，建議優先繫結迴環位址。繫結至所有網路介面不只是方便本機連線，也可能將連接埠暴露給同網段的裝置，因此須一併考量防火牆與存取控制。伺服器清單中的遠端位址與本機連入監聽位址，是兩種不同的參數，請勿互換。連接埠遭占用時，先檢查是否有舊用戶端或其他代理程序；更換連接埠後，重新套用桌面代理並更新終端機或應用程式中寫死的位址，否則新核心雖正常監聽，應用程式仍會連到舊位址。
TUN 通常需要建立虛擬介面並變更路由，所需權限取決於發行版與用戶端版本。請依用戶端的明確說明完成授權，不要隨意授予整個程式資料夾廣泛權限。先以一般使用者管理訂閱與設定，再處理明確需要的網路權限；若改用不同使用者啟動，可能會使用不同資料目錄，造成「伺服器清單消失」的情況。遇到這種情況，先確認執行使用者與資料位置，不要立刻覆寫原資料夾，也不要將空白畫面誤認為原始資料已被刪除。
網路異常時，檢查是否同時使用容器網路、其他隧道或自訂路由，它們的接管範圍可能與 TUN 重疊。若關閉 TUN 後恢復正常，請從路由與 DNS 著手，而非修改遠端伺服器參數。退出前還原桌面代理；若程式意外結束，再檢查啟動指令碼是否仍持續設定代理環境變數。維護時保留可用設定的副本，安裝更新後依序確認程式啟動、訂閱更新、系統代理與 TUN 四個環節，避免將桌面環境變更誤認為用戶端本身的問題。
平台 / Android
Android：v2rayNG、v2flyNG 與 VPN 權限
先選擇核心，再選擇安裝套件架構
Android 下載區優先推薦 v2rayNG，採用 Xray 核心；v2flyNG 則採用 V2Fly 核心，可作為需要相應相容性的替代選擇。請依伺服器協定與傳輸參數選擇，不要只因名稱相似就反覆切換。多數較新的主流裝置可選擇 arm64；通用套件支援更多架構，但檔案通常較大。若安裝程式提示解析失敗或不相容，請確認系統需求、套件是否下載完整及裝置架構，不要一概歸因於手機效能不足。
從瀏覽器或檔案管理工具開啟安裝套件時，Android 可能會要求允許從該來源安裝應用程式。請只授權實際使用的來源，安裝完成後可依個人安全習慣撤銷權限。更新現有用戶端時，系統可能因簽章、安裝來源或套件身分不同而拒絕覆蓋；請先保存需要保留的訂閱與自訂設定，再判斷是否需要移轉。直接解除安裝會影響應用程式內的資料，不應作為第一步。尤其不要把彈出視窗中的「更新失敗」解讀為既有伺服器設定也一定失效。
匯入、更新與啟動服務
在 v2rayNG 的訂閱群組設定中新增網址，儲存後執行訂閱更新，再返回伺服器清單選取一項。若收到的是單一分享連結，可透過剪貼簿或 QR Code 匯入；QR Code 只是傳遞設定的媒介，不會自動包含比文字連結更多的參數。請確認目前選取的是剛匯入的伺服器，避免清單更新後仍連線到舊項目。v2flyNG 的入口名稱可能不同，但同樣要分清遠端訂閱更新與單一設定匯入，不要把一般網頁網址當成訂閱。
啟動連線時，系統會要求授權建立 VPN 連線。這項授權允許用戶端透過 Android 虛擬網路介面接收流量，不代表已連上伺服器，也不表示所有應用程式都會經過遠端代理。狀態列出現連線圖示，只能表示流量接管機制已啟用；仍須搭配用戶端記錄與實際連線結果判斷。不要直接套用桌面版「寫入系統代理」的做法：Android 用戶端通常透過系統 VPN 服務建立入口，路由規則仍可將部分請求導向直連。
依應用程式分流與背景執行
依應用程式代理通常有「只代理選取的應用程式」和「略過選取的應用程式」兩種相反邏輯，請以介面說明為準。修改後應停止並重新啟動服務，再測試目標應用程式，避免舊連線仍沿用原路徑。排查時先關閉應用程式篩選，確保接管範圍明確；確認基本連線正常後，再逐一加入例外。網頁可開啟但特定應用程式無法使用，也可能與該應用程式的獨立 DNS、長連線、帳戶狀態或服務政策有關；不要只憑一次失敗就變更整個用戶端的協定設定。
若螢幕亮著時運作正常，鎖定後卻中斷，請檢查電池最佳化、背景活動與廠商的自動啟動管理。只為確有需要的用戶端放寬限制，不必關閉所有系統省電功能。若系統限制用戶端的常駐通知，也可能影響背景服務持續運作。Wi-Fi 切換至行動數據後，先等系統完成切換，再重新啟動連線測試；若只有某類網路失敗，請比較網路權限與伺服器可連線性，不要立刻刪除訂閱。行動網路訊號、流量限制與熱點環境也會影響連線結果。
初期不要立即啟用「一律開啟 VPN」或「封鎖未經 VPN 的連線」等系統政策。先確認用戶端在重新啟動、鎖定螢幕與切換網路後都能恢復，否則強制封鎖會讓一般網路也無法使用。若完全無法連線，先停止連線並還原系統網路，再查看用戶端記錄。改用 v2flyNG 並非通用的修復方式，只有確認問題源自協定或核心相容性差異時，才值得比較；移轉時也要重新檢查路由、DNS 與應用程式規則，不能只複製伺服器項目就當作完整移轉。
設定 / 訂閱與節點資料
訂閱管理：格式、更新與跨裝置同步
辨識遠端訂閱、分享連結與完整設定
遠端訂閱網址是用戶端取得設定內容的入口，通常是 HTTPS 網址。單一分享連結則以 vmess://、vless:// 等協定前綴表示一項連線資料。完整 JSON 設定還可能同時包含入站、出站、DNS 與路由，不能將三者視為可以任意互換的文字。即使看到很長的編碼字串，也不能只憑外觀判斷它是訂閱還是單一連結；請依來源說明與用戶端支援的匯入方式處理，避免反覆轉碼而破壞原始資料。
部分訂閱使用 Base64 封裝多個分享連結，另一些則直接提供用戶端可讀取的結構化內容。Base64 是編碼方式，不是保護存取權限的加密方式。用戶端能否處理某個訂閱，取決於回傳格式與核心相容性，不只取決於能否在瀏覽器中開啟連結。更多匯入方式比較請參閱訂閱匯入、Base64 與 URI 格式說明。若服務回傳登入頁、錯誤頁或驗證頁，用戶端通常無法將其解析為伺服器清單。
將更新失敗分為請求與解析兩個階段
成功儲存訂閱群組，只表示網址已寫入本機設定。執行更新後，先確認用戶端是否取得遠端回應，再確認回應內容能否解析。連線逾時、憑證驗證錯誤屬於請求階段；若提示格式不支援或內容為空，則要檢查回傳內容與訂閱類型。更新失敗時，不要先刪除原有可用項目；保留目前群組與記錄，確認網址未過期、查詢參數未遺失，並檢查系統時間。公開分享記錄前，請遮蔽完整訂閱網址與帳戶識別資訊。
是否透過代理更新，取決於用戶端的更新選項與實作方式。只有確認目前網路無法直接連線至訂閱入口，而且現有代理確實可用時，才嘗試相應的代理更新選項。若沒有任何可用伺服器，啟用這項功能可能造成依賴循環：需要更新才能取得伺服器，卻又需要伺服器才能更新。此時應恢復可直接存取的更新路徑，或向設定提供者確認適用於目前網路的取得方式，不要不斷切換不明節點並重複請求。
管理群組與手動修改的生命週期
依來源或用途分類訂閱群組，有助於確認各伺服器由哪個網址維護。訂閱更新可能重建項目、更新名稱或覆寫欄位，因此不要預設手動修改的伺服器會永久保留。需要測試參數時，先複製成獨立設定，清楚標示不再自動同步原訂閱，並記錄修改原因。更新訂閱後，請重新確認目前伺服器；名稱相同也可能代表位址或傳輸參數已變更。舊連線是否重新建立，則取決於用戶端的運作方式。
跨裝置共用訂閱主要同步伺服器資料，不保證路由、DNS、應用程式篩選、系統代理與 TUN 權限也會一併移轉。Mac 上的程序規則也不能直接當成 Android 的應用程式規則。QR Code 適合傳送少量單一資料，完整匯出則較適合移轉本機設定，但須確認目標用戶端能否匯入相同格式。可參考多裝置同步方案，先確認要同步的是伺服器來源，還是整套用戶端行為，再選擇適合的方法。
更新頻率也應符合實際需求，不要用頻繁重新整理代替故障排除。若多台裝置同時出現空白清單，先確認來源狀態與回傳格式，再分別檢查用戶端相容性；若只有一台失敗，優先比較本機網路、代理更新選項與系統時間。設定提供者撤銷或替換項目後，舊用戶端仍顯示名稱不代表它還能連線。清理前先確認群組歸屬，避免一併刪除手動設定，並保留足以還原的資訊，不要只記得容易重複的伺服器顯示名稱。
設定 / 入站、出站與解析
路由與 DNS：依請求路徑理解設定
從入站到出站理解流程，不要只靠按鈕猜測
一個請求通常先進入本機入站，再由路由規則決定交給哪個出站。inbounds 描述本機監聽方式，outbounds 描述實際連線目的地，routing 則負責在兩者之間做選擇。系統代理與 TUN 解決的是流量如何進入用戶端；路由解決的是進入後如何處理。「全域」通常表示盡可能將已接管的請求送往代理出站，不代表強制所有應用程式使用用戶端；「規則」則依條件區分代理、直連或封鎖。介面上的選項最終都會反映在設定內容中。
以下是用來檢查本機入站與標籤關係的最小 V2Ray 設定。內容只有直連與封鎖出站，不提供遠端代理連線，也不是要取代用戶端自動產生的執行檔案。兩個連接埠僅供教學示範；若本機已被占用，就無法同時啟動。迴環監聽僅允許本機存取；direct 與 block 是自訂標籤，實際行為分別由 freedom 與 blackhole 協定決定。理解這一點，才能避免把標籤名稱誤認為核心預設功能。
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
},
{
"tag": "http-in",
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"settings": {}
}
],
"outbounds": [
{ "tag": "direct", "protocol": "freedom", "settings": {} },
{ "tag": "block", "protocol": "blackhole", "settings": {} }
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["domain:example.com"],
"outboundTag": "direct"
}
]
}
}規則依序比對，資源檔案也會影響結果
常見路由設定會依規則順序比對，由第一條符合的規則決定處理方式，因此特定例外通常應放在範圍較廣的條件之前。outboundTag 必須對應實際存在的出站標籤，拼字不符不會自動修正。沒有符合規則時的預設出口，須依核心設定與用戶端產生方式確認。閱讀config.json 結構解析時，請一併檢視完整出站清單與規則，不要只截取單一行就判斷最終流向。
geosite 代表網域集合，geoip 代表 IP 位址集合；它們並非對任何目標都有效的萬用關鍵字。使用相關規則前，請確認目前核心支援相應語法，且所需資源檔案存在並能載入。網域集合與 IP 地理位置也不能取代特定服務的策略；多位址服務、內容傳遞網路與規則資料變動都會影響比對結果。設定中國大陸直連等方案時，先界定目標範圍，參考geosite 與 geoip 分流說明，再透過記錄確認實際結果。
分清系統 DNS、核心 DNS 與遠端解析
DNS 查詢可能發生在應用程式、作業系統、用戶端核心，或遠端連線的另一端。只修改系統 DNS，不代表所有代理請求的解析路徑都會改變；應用程式若啟用獨立的加密解析，也可能略過系統設定。domainStrategy 會影響路由判斷何時需要解析網域，並非「設定某個值就全部改為遠端解析」的總開關。常見的 IPIfNonMatch 會在網域規則未符合時，嘗試透過解析補充 IP 比對；實際互動方式仍應以所用核心的設定語義為準。
排查 DNS 時，先判斷網域是否解析成功，再確認取得位址後能否建立連線。若憑證名稱不符，不應關閉憑證驗證來掩蓋問題；請核對目標網域、安全層伺服器名稱，以及網路是否出現驗證頁面。使用 TUN 時，還要留意 DNS 請求是否被接管、解析伺服器本身是否可連線，以及是否形成遞迴依賴。每次只調整一個解析入口，並記錄變更前後的結果；若同時更換 DNS、規則與伺服器，即使連線恢復，也無法確認是哪項設定生效。
排查 / 從現象找出問題層級
常見設定問題：分層驗證與復原
先確認基本網路與本機監聽
遇到無法連線時，先關閉 TUN、清除系統代理並停止其他流量接管工具，確認一般網路是否正常。飯店或公共網路可能需要先完成網頁認證；基本網路尚未連線時，持續更換伺服器通常沒有幫助。恢復一般網路後，再啟動用戶端並確認核心狀態。若記錄顯示「連線遭拒」且目標是本機迴環位址，通常應優先檢查監聽是否存在、連接埠是否填錯，而不是檢查遠端伺服器密碼。同一錯誤訊息因目標位址不同，排查方向也會不同。
若用戶端顯示正在執行，但所有應用程式都無法連線，請先核對本機監聽連接埠，再使用明確指定的代理請求排除系統設定因素。以下指令適用於提供 curl 的桌面環境，範例假設本機 SOCKS 連接埠為 10808，使用前務必替換成用戶端實際顯示的連接埠。socks5h 會將網域交由代理端解析；指令中的範例網站只是一般 HTTPS 測試目標。測試成功僅能證明這條連線路徑可用，不代表所有應用程式或協定都已由用戶端接管。
curl --proxy socks5h://127.0.0.1:10808 \
--connect-timeout 10 \
--max-time 20 \
--head https://example.com/若明確指定代理後連線成功，但瀏覽器仍失敗，請檢查系統代理是否套用至目前網路、瀏覽器是否設有獨立代理，以及擴充功能是否覆寫設定。若明確指定代理也失敗，請查看核心記錄，分辨是本機入口、遠端連線還是握手錯誤。不要將終端機的測試結果直接套用至 Android；行動裝置應透過用戶端記錄與應用程式連線結果交叉判斷。測試時保持相同伺服器與目標，先控制變因，再更換對照項目，才能避免網路波動造成誤判。
依錯誤類型決定下一步
連線逾時時，優先檢查目標位址、連接埠、目前網路的可連線性與伺服器狀態；驗證失敗時，優先核對憑證與協定欄位；TLS 握手失敗時，則檢查系統時間、安全層伺服器名稱、傳輸設定與伺服器端要求。欄位留白不一定是錯誤，也不應隨意從其他設定複製欄位值。傳輸參數必須成組搭配，通常只修改其中一項會造成更難判斷的失敗。記錄有助於縮小範圍，但通常無法只憑單行文字判定唯一原因；還須搭配變更記錄與對照測試。
訂閱可以更新但所有伺服器都連線失敗，表示取得資料的路徑至少部分可用，不代表代理連線參數已通過驗證。若只有部分伺服器失敗，優先比較這些項目的協定與傳輸差異；若全部同時失敗，再檢查共同因素，例如系統時間、核心啟動狀態與網路環境。若只有某個網站異常，則應分別考量 DNS、規則比對、目標服務狀態與帳戶限制。不要因單一服務就變更全部流量模式，也不要把用戶端顯示的連線測試當成實際服務連線的完整替代。
分開處理 TUN 故障與網路復原
系統代理正常、TUN 異常時，通常不必先懷疑遠端連線資料。請先檢查權限、虛擬介面、路由、DNS 與其他隧道的重疊狀況；若關閉 TUN 後立即恢復，請保留這項對照結果。需要遠端管理裝置時，避免直接修改預設路由，並先準備本機復原方式。切換網路後發生錯誤，可先停止並重新啟動流量接管服務，不必立即清除所有設定。重新安裝可能保留或變更部分資料，不能作為判斷設定是否正確的可靠測試。
正常結束後無法連網，請檢查系統代理是否殘留；TUN 停止後發生異常，則檢查其他網路工具是否仍在執行，並先還原系統的一般網路連線。回報問題前，請記錄系統與架構、用戶端名稱、接管模式、失敗時間、是否可重現，以及最近一次變更。記錄只保留與故障相關的片段，並遮蔽訂閱網址、使用者識別資訊與伺服器憑證。提供「明確指定代理成功、系統代理失敗」這類對照資訊，比只說「不能用」更容易找出排查方向。
需要重新依照操作流程設定時，請返回使用文件，依序匯入、選擇模式並驗證；若要改用其他平台，請前往用戶端下載頁面確認作業系統與晶片。日常維護時，將訂閱更新、用戶端升級與網路政策調整分開進行，並保留可還原的記錄。這樣能減少設定彼此影響，也能在發生問題時明確判斷故障層級，不必反覆重裝或同時切換多個選項。