設定目錄 / CLIENT SETTINGS
圖形化客戶端負責整理設定，核心負責實際連線。先匯入伺服器資訊，再決定哪些應用程式透過代理，最後確認路由與網域解析；不要一次更改所有選項。
訂閱可集中取得伺服器設定，單一分享連結則只會匯入一筆紀錄。v2rayN 可在「訂閱群組設定」中新增網址，儲存後執行訂閱更新；v2rayNG 可從選單進入同名設定。剪貼簿匯入適用於已複製的分享連結，不能把網頁標題當成設定。匯入後先確認群組、協定與位址，再選取要使用的伺服器。訂閱更新失敗時，請保留原有紀錄，先檢查連結是否完整，不要反覆刪除群組；訂閱網址可能包含存取憑證，分享截圖時請先遮蔽。
v2rayN
訂閱群組 → 訂閱群組設定 → 新增
儲存群組 → 更新訂閱
v2rayNG
選單 → 從剪貼簿匯入先匯入，再連線
路由會決定已進入核心的連線使用哪個出口，不會讓應用程式自動接入代理。初次設定可先使用「繞過區域網路」，讓本機裝置位址維持直連，再依需求新增網域規則。規則通常依序比對，條件太寬泛的規則若放在前面，可能會遮蔽後續的精確條件。編輯自訂規則時，出口標籤必須與目前設定一致，不能只複製欄位名稱。系統代理開關與路由的作用範圍不同；應用程式的流量若未經核心，修改規則也不會改變連線路徑。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}先確認流量入口
v2rayN 的「自動設定系統代理」會將系統代理位址指向客戶端的本機監聽連接埠，遵循此設定的瀏覽器等應用程式才會進入核心。「清除系統代理」用來還原系統代理設定，不會刪除伺服器設定。路由中的全域代理則決定進入核心後使用哪個出口，兩者不能互相取代。部分應用程式需要另外設定代理，TUN 也是另一種流量接入方式。初次使用時，先驗證系統代理路徑，避免同時啟用多種接管方式；退出後若網路異常，再檢查是否仍留有系統代理設定。
系統代理 → 自動設定系統代理
路由 → 繞過區域網路
停止使用時：
系統代理 → 清除系統代理入口 ≠ 分流
核心負責協定交握、傳輸與路由執行，客戶端介面只是設定入口。v2rayNG 主要使用 Xray，v2flyNG 則面向 V2Fly 核心生態；v2rayN 可選用的核心則取決於目前的發行版本與協定類型。切換前須一併檢查協定、傳輸方式、安全層與擴充欄位，不能只憑名稱相近就判斷相容性。例如 REALITY 是與安全層相關的技術，不應視為與 VMess 完全同類的獨立協定。更換核心後應重新產生設定並查看記錄，既有的自訂 JSON 也需要另外確認。
確認順序
協定類型 → 傳輸方式 → 安全層
↓
目前核心的支援狀況依欄位判斷相容性
DNS 會將網域名稱轉換為位址，解析所用的伺服器與最終連線的出口並非同一概念。瀏覽器安全 DNS、系統解析器和核心內建 DNS 可能同時存在；只修改客戶端中的某一項，不代表所有應用程式都會使用相同的解析路徑。網域無法連線時，先記錄錯誤訊息並確認應用程式是否進入代理，再檢查 DNS 伺服器是否可連線、路由是否需要解析，以及 IPv6 是否可用。以下片段僅說明內建 DNS 的伺服器欄位，無法單獨構成可連線的設定，也不能取代完整的路由設定。
{
"dns": {
"servers": ["localhost"]
}
}解析成功不代表連線成功
平台選擇 / DOWNLOAD ENTRY
先確認作業系統，再確認處理器架構。以下入口會開啟對應平台的下載頁；桌面版與 Android 版使用不同客戶端，請勿只因名稱相似就選擇安裝套件。
v2rayN 提供 Desktop 與經典 WPF 兩種介面。Desktop 採用跨平台介面方案，WPF 則保留熟悉的桌面操作方式；兩者都需要進一步匯入訂閱並設定代理。初次安裝時，請依下載頁說明確認系統與執行環境，不要將一種介面的設定路徑直接套用到另一種介面。
解壓縮後請將檔案放在可寫入的獨立資料夾，避免直接在壓縮軟體視窗中執行。遷移既有設定前，先結束舊的執行個體並保留設定備份，再檢查本機監聽連接埠是否衝突。若啟動失敗，先查看執行環境提示，再處理代理設定。
先在「關於這台 Mac」查看晶片資訊：Apple 晶片選擇 Apple Silicon，Intel 處理器則選擇 Intel。安裝完成後，將應用程式移至固定位置，再處理系統顯示的安全性與網路授權提示。選錯架構可能導致應用程式無法啟動，無法透過修改訂閱解決。
系統代理與更廣泛的網路接管需要不同權限，初次使用建議先確認基本代理連線正常。遇到開發者驗證提示時，應先確認安裝來源與系統提示內容，再依照相關教學操作；不要只為了消除提示，就全面關閉系統保護設定。
建議優先使用採用 Xray 核心的 v2rayNG；若需要 V2Fly 核心設定，再考慮 v2flyNG。多數較新的裝置可選擇 arm64；若不確定裝置架構，請查看系統資訊或選擇通用版本。兩款客戶端的設定彼此獨立，安裝另一款不會自動遷移原有訂閱。
首次連線通常需要確認系統 VPN 授權。背景連線中斷時，請檢查電池最佳化與背景執行限制，不要先更換協定參數。同一時間應確認由哪個應用程式接管 VPN；測試結束後關閉不使用的連線，以免將應用程式之間的接管衝突誤判為伺服器故障。
依照發行版的套件管理方式選擇 deb 或 rpm，再確認 x64 或 arm64 架構。安裝套件格式、處理器架構與桌面執行環境是不同條件；檔案能下載不代表目前的系統一定可以執行。安裝時若出現相依性錯誤，請先查看套件管理器提供的詳細訊息。
不同桌面環境對系統代理的支援程度不一，部分程式仍須個別設定代理位址。先使用明確支援代理的應用程式，確認本機監聽正常，再決定是否採用其他接管方式。需要額外權限的功能，請先了解用途再啟用；不建議長期以高權限執行整個圖形化客戶端。
開源生態 / PROJECT & CORE
選擇客戶端時要看平台，判斷設定能否執行則要看核心。介面相似、訂閱相同，都不代表功能完全一致。
圖形化客戶端匯入 · 編輯 · 啟動／停止
代理核心交握 · 傳輸 · 分流
伺服器設定協定 · 位址 · 安全層
V2Ray 源自 Project V 的模組化代理工具體系。它將流量入口、出口連線、傳輸方式與路由規則分開組織，讓同一套核心能因應不同使用情境。使用者在圖形介面中輸入的伺服器資訊，最後通常會轉換成核心讀取的設定。因此，「V2Ray」有時指整個技術生態，有時指特定核心，不能簡單視為某個桌面視窗或某款 Android 應用程式。
對初次使用者來說，這種分層最實用之處在於能逐步排查：應用程式是否接入本機代理、核心是否正常啟動、伺服器參數是否相符，分別對應不同環節。先確認故障發生在哪一層，後續修改才有依據。重新安裝介面程式不會自動修復伺服器端的憑證問題，換用其他訂閱也無法排除本機連接埠衝突。
V2Fly 是由社群接續維護的 V2Ray 專案，Xray 則從相關程式碼分支發展，逐步形成自己的功能演進路線。兩者共用部分設定概念，但擴充功能、欄位支援與更新節奏並不完全相同。讀取設定時應以實際使用的核心為準，不能只因客戶端名稱包含相同字母，就判斷支援狀況。技術參考頁會依協定與安全層分別比較，協助確認設定所需的功能。
例如 VMess、VLESS、Trojan 與 Shadowsocks 是協定選項，WebSocket 等則是傳輸方式，TLS 與 REALITY 涉及安全層。這些並非同類且互斥的選項。訂閱中出現熟悉的協定名稱，也不代表整份設定一定相容；還須確認傳輸方式、安全層、伺服器名稱及相關擴充設定。伺服器端與客戶端的參數必須成套相符，單方面更換協定通常無法建立連線。
v2rayN 適用於桌面系統，提供伺服器清單、訂閱群組、系統代理和路由等圖形化操作入口；v2rayNG 適用於 Android 裝置，主要搭配 Xray 核心使用；v2flyNG 則提供使用 V2Fly 核心的 Android 方案。三者都是開源客戶端專案，客戶端本身並不等於伺服器服務。安裝完成後仍須使用有權存取的伺服器設定，客戶端名稱也不能證明訂閱來源可信。
開源授權規範程式碼的使用、修改與散布，不代表承諾在任何網路環境下都能連線。介面程式、核心及其相依元件可能適用不同授權，具體權利義務請查看各自的發行資料。對日常使用而言，開源生態的價值在於實作方式與設定邏輯可以被討論、檢視和改進，而非將某個專案標籤直接等同於效能或隱私結論。
客戶端更新通常涉及介面、設定產生邏輯、相依元件與隨附核心；訂閱更新則會更新伺服器紀錄，兩者解決的問題不同。缺少某項協定功能時，應檢查核心支援與客戶端產生設定的能力；位址過期或伺服器參數變更時，則應檢查訂閱。不要把更新訂閱當成客戶端已升級，也不要認為更新介面後所有自訂設定都會自動相容。
更新前先備份本機設定，並記下目前使用的代理方式與路由規則。更新後先確認原有的基本連線正常，再逐步還原自訂 DNS、規則與進階接管方式。若出現新錯誤，請保留詳細記錄，並比較更新前後的設定差異。下載頁集中提供安裝入口，首頁不固定顯示版本資訊，避免將客戶端選擇與短期發行變動混為一談。
初次設定 / QUICK CHECK
以下依初次使用的順序逐項檢查。每次只修改一項並重新測試，才能保留清楚的排錯線索。
客戶端是管理設定並啟動核心的工具，安裝套件本身不會提供伺服器紀錄。請先匯入完整的分享連結，或在訂閱群組中新增訂閱網址並執行更新。更新後若仍是空白，請檢查群組篩選、連結是否有效，以及回傳格式是否正確；不要把網頁網址或說明文字當成分享連結。查看匯入步驟 →
顯示已連線通常表示客戶端或核心已在執行，但不代表所有應用程式的流量都已接管。桌面端請先確認系統代理已設定，再確認目標應用程式是否遵循系統設定；Android 端還要檢查是否啟用依應用程式分流。路由只會處理已進入核心的流量，單獨切換路由模式無法補上缺少的流量入口。查看代理模式說明 →
先查看記錄中的錯誤階段。連線逾時、網域解析失敗、憑證驗證失敗與設定解析失敗，需要不同的處理方式。請檢查系統時間、伺服器位址、連接埠與安全層參數，再依錯誤訊息排查 DNS。協定必須與伺服器設定相符，不能把隨意更換協定當成通用修復方法。查看 DNS 排查步驟 →
建議先遷移訂閱或相容的分享連結，再分別調整各裝置的系統代理、監聽位址與路由。桌面環境的資料夾、連接埠占用和網路權限與 Android 裝置不同，自訂 JSON 也可能依賴特定核心欄位。遷移後先測試一筆基本設定，確認可用後再還原複雜規則。確認設定相容性 →
使用筆記 / RECENT NOTES
從平台權限、訂閱更新與設定結構三個面向補充操作細節。遇到問題時先保留錯誤訊息原文，再對照相關檢查項目，不必從頭重裝所有元件。
先確認 Apple 晶片或 Intel 安裝套件，再依系統提示處理開發者驗證、系統代理與網路相關權限。請區分安裝階段遭到阻擋與連線階段出現的錯誤，避免透過修改伺服器參數來處理本機授權問題。
閱讀 macOS 權限設定說明 →訂閱更新後清單空白，不一定代表客戶端無法連線。請依序檢查連結是否有效、Base64 編碼格式、更新時是否透過代理、User-Agent 與群組設定，並區分取得失敗、內容解析失敗和清單篩選造成的空白。
閱讀訂閱自我檢查清單 →從記錄、DNS、入站、出站到路由，逐段了解客戶端產生的設定。重點確認 tag 與 outboundTag 的引用關係，掌握規則會影響哪個出口，再決定是否需要手動編輯，而非直接拼接設定片段使用。
閱讀設定結構解析 →