先選擇作業系統，再確認處理器架構與安裝方式。桌面版和安卓用戶端的設定入口不同；訂閱網址通常可以共用，但應用程式權限與代理接管方式須分別設定。
v2rayN 提供 Desktop 與傳統 WPF 兩種介面。首次安裝時先確認系統與執行環境需求；已有設定時先備份，再決定是否切換介面，不必同時執行兩套用戶端。
前往下載 →v2rayN 依 Apple Silicon 與 Intel 晶片提供下載入口。可在「關於這台 Mac」查看晶片或處理器名稱，選擇相符的安裝套件；首次啟動時依系統提示處理應用程式權限。
前往下載 →建議優先選用採用 Xray 核心的 v2rayNG；需要 V2Fly 核心時再考慮 v2flyNG。依裝置架構選擇 arm64 或通用版，連線時並確認系統的 VPN 授權提示。
前往下載 →v2rayN 提供 deb 與 rpm 安裝套件，並區分 x64 與 arm64 架構。先依 Linux 發行版選擇套件，再確認桌面環境的系統代理是否指向用戶端的監聽位址。
前往下載 →安裝套件只決定用戶端能否執行，不包含可直接使用的遠端連線設定。請準備有權使用的訂閱網址或分享連結；匯入後還要選取作用中的伺服器，並確認應用程式有使用本機代理。
查看所有用戶端 →可將用戶端分成三個層次：訂閱提供連線參數，核心負責連線與分流，代理模式則決定應用程式流量如何進入核心。先確認問題所在層次，再調整相應設定。
系統代理模式會將本機代理位址寫入作業系統設定，適合瀏覽器等會遵循系統代理的應用程式。選好作用中的伺服器後，在底部的系統代理選單中選擇「自動設定系統代理」，再用瀏覽器測試。系統代理與路由各有用途：前者決定流量是否進入用戶端，後者決定流量進入後的出口路徑。有些程式使用自訂代理設定，須另外指定監聽位址；結束用戶端前可清除系統代理，避免應用程式繼續連線至已停止的本機連接埠。
系統代理：自動設定系統代理
應用程式代理位址：127.0.0.1
應用程式代理連接埠：以目前的本機監聽設定為準
路由：略過區域網路Tun 模式透過虛擬網卡接收流量，適合無法個別指定代理的應用程式。先透過一般系統代理確認節點可用，再依目前平台的要求授予權限並啟用 Tun。啟用後應一併檢查路由、DNS 與既有虛擬網卡，避免和其他網路接管工具衝突。Tun 並非提升節點頻寬的開關，也無法修正錯誤的伺服器參數。若啟用後無法正常存取區域網路，先關閉 Tun 進行比對測試，再逐項檢查略過規則與名稱解析設定。
啟用前：確認一般代理連線正常
權限：依作業系統提示授權
檢查項目：虛擬網卡 / 路由 / DNS
測試：分別確認目標應用程式與區域網路訂閱分組用來儲存訂閱網址，並集中更新該來源的伺服器設定。先開啟訂閱分組設定，填入容易辨識的分組名稱與完整網址，儲存後再更新該分組。分享連結包含單一連線的參數，不應當成訂閱網址反覆更新。更新後若清單空白，先確認請求是否成功，再檢查回傳格式；請求失敗與內容無法解析是兩種不同問題。訂閱網址可能含有存取憑證，排除問題時請遮蔽完整網址，勿放入公開截圖。
訂閱分組
名稱：依設定來源命名
網址：貼上完整訂閱網址
儲存後：更新目前的訂閱分組
分享連結：使用從剪貼簿匯入的功能路由規則會決定進入核心的連線要直連、代理或阻擋。比對條件可使用網域、目標 IP 與連接埠，通常依規則順序比對，實際行為則以所選核心為準。下方是 Xray 的區域網路位址直連規則片段，並非完整設定；使用前必須確認目前設定中有名為 direct 的出口。初次設定建議從內建路由開始，只加入確實需要的例外。規則範圍過廣或順序不當，可能使後續規則無法生效；修改後應分別測試目標網站與區域網路裝置。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}真實連線測速會透過代理發出實際請求，比單純檢查連接埠更接近日常使用情境；不過結果也會受到測試網址與當下線路影響。先選取伺服器，再從右鍵選單執行測試；批次比較時應使用相同的測試網址。TCPing 主要顯示是否能連上目標 TCP 連接埠，無法證明協定驗證與代理請求都已成功。測試通過後，仍須設定作用中的伺服器，並在目標應用程式中確認。若只有特定測試網址失敗，可改用可信的測試目標比對，避免將單一網站的問題誤判為節點失效。
TCPing：檢查 TCP 連接埠是否連通
真實連線測試：透過代理向測試網址發出請求
應用程式測試：確認系統代理與實際連線
比較速度：使用相同下載目標與測試時段用戶端介面負責編輯設定，核心則處理協定、建立連線並執行路由。v2rayN 可依支援情況設定不同核心，但協定名稱相同，不代表所有擴充參數都能互換。切換前先確認核心是否支援協定、傳輸方式與安全參數，並保留原設定以供比對。排查逾時問題時，不要同時更換核心、DNS 與路由；一次只調整一項，再查看記錄中的具體錯誤。安卓端的 v2rayNG 與 v2flyNG 則分別採用不同核心。
用戶端：管理設定與操作介面
核心：處理協定與轉送流量
切換依據：協定 / 傳輸 / 安全參數
排除問題原則：一次只調整一項選單文字可能隨桌面版介面調整。若名稱不同，先依「系統代理、路由、訂閱、核心」辨認功能，再尋找對應入口；不要直接用其他用戶端的設定片段覆蓋目前設定。依症狀查閱故障排除手冊 →
先完成最基本的連線流程，再逐步加入分流與網路接管設定。安裝完成、清單顯示伺服器、瀏覽器能正常連線，分別是三個不同的檢查點。
v2rayN 可在「訂閱分組」中新增訂閱網址，儲存後更新該分組；若取得的是單一分享連結，請複製完整內容，並使用伺服器選單中的剪貼簿匯入功能。v2rayNG 則在訂閱設定中新增網址，再返回主畫面更新訂閱。兩種入口不可混用；匯入 QR Code 內容前，也應先確認是訂閱還是單一連線。
匯入後確認協定類型、伺服器位址與連接埠是否齊全。手動補上參數時，傳輸路徑、服務名稱、伺服器名稱等欄位必須與提供的設定相符，不能只憑名稱猜測。清單空白時先查看更新提示；若清單已有項目但無法連線，則進入下一步測試，不必反覆刪除訂閱。
從伺服器清單選取一筆設定，執行真實連線測試，再將它設為作用中的伺服器。測試時先保留預設路由與 DNS，避免多項變更互相影響。若連接埠測試正常但真實連線失敗，應檢查驗證、傳輸與安全參數；若所有設定都失敗，先確認本機網路與用戶端核心是否正常啟動。
桌面端先使用「自動設定系統代理」測試瀏覽器連線，再考慮啟用 Tun。安卓端點選連線後，請接受系統 VPN 授權，並留意是否有其他應用程式正在使用 VPN 連線。依應用程式代理先維持簡單設定，確認基本連線正常後，再決定要加入或排除哪些應用程式。
在目標應用程式中發出一次請求，同時查看用戶端記錄。若瀏覽器正常但另一個應用程式失敗，優先確認該應用程式是否讀取系統代理；若所有應用程式都失敗，再檢查核心啟動、監聽連接埠與作用中的伺服器。分享記錄排除問題前，請先遮蔽其中的位址、訂閱內容與驗證資訊。
最後進行一次可復原的對照測試：記錄原設定，暫時關閉代理接管，以相同目標比較連線結果，再還原設定。不要只憑介面上的開關或一次測速，就判定所有應用程式都已正常連線。確認後再逐項啟用自訂路由、Tun 或依應用程式代理；每次調整都應保留明確的復原方式。
若要處理首次啟動提示、本機連接埠衝突或背景連線中斷，可沿著教學中的檢查點逐步排除，不必從頭重新安裝。保留原設定與錯誤提示，通常比同時修改多項設定更容易找出原因。
查看完整教學 →先分清專案、核心、用戶端與訂閱來源，才能判斷更新究竟改變了哪些內容。用戶端名稱相近，不代表設定檔和所有功能都能直接互換。
Project V
模組化代理工具生態系
V2Fly / V2Ray
持續演進的核心實作
Xray
從 V2Ray 發展而來的核心分支
圖形化用戶端在核心之上提供設定介面；連線參數則由訂閱或分享連結提供。
Project V 是以網路代理工具為核心的專案生態系，V2Ray 是其中的重要實作。它將入站、出站、路由與傳輸等功能拆分為可設定的模組，因此同一個圖形介面可以提供不同協定，也能依規則為不同目標選擇出口路徑。此處的「協定」描述連線雙方如何溝通，「傳輸」則描述資料如何承載，兩者不應視為同一項設定。
日常使用通常不必從頭撰寫完整設定。圖形化用戶端會依訂閱參數產生核心所需的設定，但不代表用戶端能自動補齊缺少的資訊。伺服器位址、驗證參數、傳輸選項與安全設定仍須彼此相符。了解這層關係，可避免將訂閱內容問題誤認為安裝問題，也能理解為何重新安裝用戶端不一定會改變連線結果。
V2Fly 社群持續維護 V2Ray 相關實作；Xray 則從 V2Ray 發展而來，並形成自己的功能與發佈節奏。兩者有共同的技術背景，但支援的協定擴充、傳輸細節與設定欄位可能不同。閱讀教學時，應同時確認用戶端名稱與實際執行的核心，不要只看到「V2Ray 設定」就認為所有實作都適用。
遇到不支援的欄位或無法辨識的傳輸選項時，先查看核心啟動記錄，再對照連線設定需求。切換核心是為了選擇相容性，並非萬用修復方式。節點能否使用，取決於用戶端能否設定相關參數、核心能否處理這些參數，以及伺服器端是否提供相應功能；其中任一環節不相符，都可能導致連線失敗。
v2rayN 是桌面圖形化用戶端，提供伺服器管理、訂閱分組、代理模式與路由設定等功能。v2rayNG 適用於安卓，採用 Xray 核心；v2flyNG 同樣適用於安卓，採用 V2Fly 核心。這三款用戶端皆以開源方式發佈。選擇時先確認裝置系統，再看設定需求；不必為了同一份訂閱把所有用戶端都安裝一遍。
桌面系統代理與安卓的 VpnService 接管方式不同，因此也應依平台理解「已連線」的介面提示。安卓應用程式透過系統 VPN 服務接收流量，不代表遠端設定必須使用傳統 VPN 協定；桌面應用程式遵循系統代理，也不代表每個背景處理程序都會自動使用代理。平台權限決定流量接管範圍，核心與節點參數則決定後續的連線過程。
開源代表原始碼依相應授權條款提供；使用、修改與再散佈仍須遵循各專案的授權規定。用戶端、核心與隨附元件可能採用不同授權；部署或重新散佈時應分別閱讀相關說明，不要將單一專案的條款套用至所有元件。一般使用者則應留意應用程式要求哪些權限、設定檔儲存位置，以及記錄中可能包含哪些連線資訊。
用戶端負責管理並執行設定，訂閱來源則提供遠端伺服器參數，兩者的角色不同。開源不代表訂閱來源可信，也不代表遠端服務一定可用。儲存設定、分享截圖或回報問題時，盡量只保留重現問題所需的資訊；訂閱網址、使用者識別資訊與驗證內容應妥善保管，避免在公開記錄中洩漏存取憑證。
用戶端更新、核心更新與訂閱更新，分別影響介面功能、協定實作與伺服器參數。更新訂閱不會自動升級用戶端；升級用戶端也不代表訂閱中的遠端設定會隨之變更。更新前先備份訂閱分組、自訂路由與重要設定，記下目前使用的核心類型；更新後再以原本的目標重複測試，避免只憑介面變化判斷結果。
更新後若出現異常，先查看發佈說明中的相容性變更，再確認記錄是否指向核心啟動、設定解析或網路請求。保留一份已驗證的簡易設定作為基準，再逐項還原自訂設定，更容易找出差異。速度變慢時，應分別比較節點負載、線路品質與本機設定；一次修改多項參數，往往會讓偶然的改善被誤認為長期有效的解決方式。
不確定「訂閱」、「節點」、「路由」與「DNS」的差別時，先查術語表；若已出現明確錯誤訊息，直接前往故障排除手冊。前者協助理解設定，後者依現象逐步縮小問題範圍，兩種閱讀方式不必混在一起。
內容聚焦實際操作：如何匯入訂閱、首次啟動要檢查哪些項目，以及安卓連線為何會在背景中斷。每篇處理一組相關問題，方便依目前介面逐項確認。
分別示範 v2rayN 訂閱分組與 v2rayNG 訂閱設定的匯入入口，說明 Base64 訂閱和分享連結的格式差異，以及更新訂閱後節點清單空白時的排除方向。
閱讀訂閱匯入指南 →整理 v2rayN 在 Windows 與 macOS 首次啟動前的準備事項，包括執行環境、核心檔案、本機連接埠與系統代理模式，並說明啟動失敗和權限提示的處理方式。
閱讀初始設定指南 →介紹安卓系統上 v2rayNG 的三項重要設定：VPN 連線授權、各品牌系統的背景省電白名單，以及如何選擇要透過代理連線的應用程式。
閱讀安卓設定指南 →