Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面，WPF 版保留熟悉的桌面操作方式；两者的界面布局可能不同，教程中的入口名称需要结合实际菜单查找。首次安装建议只使用其中一版，避免同时运行时出现监听端口冲突。
下载前在系统设置中确认处理器架构，安装后先打开主界面，再导入订阅。若程序打开即退，检查对应的桌面运行库要求、目录写入权限与安全软件记录，不要直接把启动失败判断为节点失效。升级前备份订阅分组和自定义路由，安装包更新不能替代个人配置备份。
前往下载 →常用功能与配置位置
客户端负责保存设置，内核负责处理连接。先分清设置所在的层，再修改对应字段。
按订阅分组维护连接资料
订阅地址保存在客户端分组中，不是内核 JSON 的通用字段。在 v2rayN 的订阅分组设置中填写地址、命名分组，再执行更新订阅；更新后核对服务器列表是否有内容。自动更新间隔应按服务端说明设置，失败时先区分地址失效、网络超时与格式不符。与逐条导入分享链接相比，分组更便于同步资料变化，但不代表订阅会提供路由规则。右侧仅示意内核出站结构，订阅地址不应填入这段配置。
对应配置段 →订阅分组设置 → 自动更新间隔(分钟)
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}按规则顺序选择出站
路由分流将域名、目标地址或入站标签映射到指定出站，不负责创建服务器连接。在路由设置中先确认规则集，再核对规则引用的出站标签是否存在。Xray 与 V2Fly 的常见配置使用 routing.rules，规则从上到下匹配，命中后选择 outboundTag 指定的出口。与让全部连接走同一出口相比，分流可以单独处理局域网与业务域名。使用 geosite、geoip 条目时还需具备相应数据文件，不能只复制规则文字。
对应配置段 →路由设置 → 规则列表 → 出站标签
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}让应用流量进入虚拟网卡
TUN 模式适用于不读取系统代理的应用，通过虚拟网卡接收流量。启用前先用普通代理入口验证节点可用，再检查运行权限、虚拟网卡与 DNS 设置。v2rayN 可借助对应内核实现此能力，具体支持范围取决于客户端与内核组合。它与系统代理的区别是接管位置不同，不代表速度必然提升。右侧为 sing-box 的 TUN 入站片段，不是 Xray 的通用字段；不要把整段直接粘贴到 V2Fly 配置中。
对应配置段 →参数设置 → TUN 模式 · 示例格式：sing-box
{
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"address": ["172.19.0.1/30"],
"auto_route": true
}
]
}按协议能力选择内核
内核选择应以服务器协议、传输方式和安全层要求为依据，而不是只比较名称。在 v2rayN 的参数设置中核对 Core 类型，并查看启动日志确认实际调用结果。Xray、V2Fly 与 sing-box 的功能和配置格式存在差别，同名选项也不保证行为一致。更换内核前保留原设置，先验证单个连接，再恢复复杂路由。右侧是 Xray 与 V2Fly 常见的日志配置形式，Core 类型本身属于客户端设置，不是这段 JSON 的字段。
对应配置段 →参数设置 → Core 类型 → 启动日志
{
"log": {
"loglevel": "warning"
}
}连接系统代理与本地监听
系统代理用于告诉兼容的应用把请求交给本地监听端口，客户端启动成功不等于系统代理已生效。在 v2rayN 主界面的系统代理菜单选择相应操作，并将应用中的代理地址与本地端口保持一致。不读取系统代理的程序需要单独配置入口，或按需求使用 TUN。退出客户端前应清除不再使用的系统代理，避免应用继续访问已关闭的端口。右侧仅示意 Xray 的本地 SOCKS 入站，并不是系统代理开关。
对应配置段 →系统代理菜单 → 设置系统代理 / 清除系统代理
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}客户端与安装平台
桌面端选择 v2rayN，安卓端优先了解 v2rayNG。先确认系统、处理器架构与安装格式，再进入下载页选择文件。
macOS
v2rayN 按 Apple Silicon 与 Intel 提供对应安装入口。在“关于本机”中查看芯片信息后再选择，不能仅凭设备外观判断架构。安装后将应用放在固定位置运行，首次启动遇到系统提示时，先阅读提示内容并确认下载来源，再按系统提供的入口处理。
首次配置先验证订阅导入和本地代理，再考虑登录启动或 TUN。系统代理影响的是遵循系统设置的应用，浏览器扩展中的独立代理设置也可能覆盖它。需要虚拟网卡能力时，按客户端提示完成权限授权；排查期间一次只保留一种流量接管方式，便于确认问题发生在哪一层。
前往下载 →Android
v2rayNG 使用 Xray 内核，作为安卓端首选入口；v2flyNG 使用 V2Fly 内核，可用于有对应兼容需求的配置。主流现代手机通常选择 arm64，架构不明确时查看系统信息和安装说明，再考虑通用包。两个客户端的配置应分别核对，不应把导入成功视为全部选项一致。
导入订阅后选择服务器，首次连接需要确认系统 VPN 授权。后台连接是否持续，还受系统电池策略和应用后台权限影响。若切换应用后连接中断，先检查省电限制，再查看客户端日志。连接资料包含认证信息，向他人求助时只提供脱敏后的错误内容，不公开完整订阅地址或分享链接。
前往下载 →Linux
v2rayN 提供 deb 与 rpm 安装入口，并区分处理器架构。先确认发行版使用的包管理格式，再选择 x64 或 arm64。图形界面运行、桌面系统代理与 TUN 权限是不同问题；软件能够打开，只说明界面已启动，还需要确认内核进程和本地监听是否正常。
桌面环境对系统代理的处理方式可能不同，部分程序仍需在应用内指定代理地址。先使用回环地址与本地端口完成验证，再调整路由和 DNS。启用 TUN 前应检查权限与现有虚拟网卡软件是否冲突。需要路由器或旁路由部署时，阅读内核部署文章，不要把桌面安装包当作路由器固件使用。
前往下载 →Project V 生态与内核分工
客户端名称、内核名称、连接协议分别描述不同层次。理解这些关系，比照搬一整份配置更便于维护。
Project V 是理解 V2Ray 技术生态的起点。早期 V2Ray 将协议处理、传输和路由等能力组合成可配置的网络工具，之后社区围绕不同维护方向形成多个项目。V2Fly 延续 V2Ray 的社区开发，Xray 则在相关技术基础上发展出自己的功能与实现。它们有共同背景，但不是可以随意互换名称的同一个程序，也不保证每一项配置都保持兼容。
图形客户端位于内核之上。用户在界面中保存订阅、选择服务器和修改规则，客户端再生成或组织运行配置，交给相应内核执行。因此，界面中的“更新订阅”不会直接成为内核 JSON 里的同名字段；“设置系统代理”也不是远端服务器的协议选项。查阅文档时先确认当前讨论的是界面设置、内核字段，还是服务端参数，可以减少大量无效尝试。
客户端与内核不是同一层
v2rayN 面向桌面使用场景，集中管理服务器资料、订阅分组、系统代理与路由配置，并提供多内核相关入口。v2rayNG 面向安卓设备，主要使用 Xray 内核；v2flyNG 则提供基于 V2Fly 的安卓客户端选择。三者均属于开源客户端，但项目名称相近不代表菜单、配置存储位置和功能范围完全一致。
选型时先判断设备平台，再判断服务器要求。已有 Xray 特定功能的连接资料，应核对客户端调用的内核是否支持；已有 V2Fly 配置的用户，应先检查字段兼容性再迁移。不能只把一个客户端的配置文件复制到另一个目录，然后假定全部设置会自动生效。
阅读内核与客户端关系 →协议、传输与安全层
VLESS、VMess 和 Trojan 描述连接协议；WebSocket、gRPC 等描述传输方式；TLS 和 REALITY 涉及连接的安全层配置。它们不是同一张列表中的替代选项。阅读连接资料时应逐项确认协议、服务器地址、端口、认证参数、传输方式与安全层，任意一项不匹配都可能导致握手失败。
VLESS 本身不提供数据加密，实际部署需要结合适当的安全层。导入链接通常能自动填入部分参数，但仍应检查服务器名称、传输路径和相关选项是否完整。遇到失败时优先与服务端要求逐项对照，不要同时更换多个开关，否则难以确定哪项修改改变了结果。
查看协议与配置边界 →开源协议与使用边界
开源意味着项目源代码在相应许可证条件下公开，使用、修改和分发应遵循各自的授权要求。客户端、内核及其依赖可能采用不同许可证，不能把整个生态视为同一份授权。普通使用者可以从项目说明中了解功能来源；重新打包或分发软件时，还需要关注许可证文本和版权声明的保留要求。
客户端与远端服务也应分开理解。安装软件不会自动获得服务器、账号或订阅，订阅内容由提供该地址的服务端决定。客户端是否开源与某个远端服务如何记录数据是两个问题。涉及业务资料时，应同时评估服务器来源、访问权限与使用场景，而不是只依据客户端名称作判断。
本站定位与内容范围 →更新机制与配置维护
客户端更新、内核更新、订阅更新和规则数据更新分别解决不同问题。客户端更新影响界面与配置生成逻辑，内核更新影响协议实现，订阅更新同步连接资料，规则数据更新则可能改变域名或地址分类。连接异常时先确认最近变化的是哪一层，不要把四种更新当成同一个操作反复执行。
维护配置应保留可回退的记录。变更前备份自定义规则和必要参数，变更后检查启动日志、本地监听与实际应用访问。自动更新适合减少重复操作，但不能替代结果确认。尤其是长期使用的自定义 JSON，应在内核调整后检查字段是否仍受支持，并清理不再引用的出站标签。
查看 JSON 配置参考 →从导入成功到实际可用
初次配置建议遵循同一条验证顺序：先导入订阅，确认服务器列表出现；再选择一个服务器，启动连接并检查错误日志；随后让应用使用本地代理，验证实际请求；最后增加分流与 TUN。订阅导入成功只说明资料能够被解析，不代表服务器当前可达。内核启动成功也不代表浏览器正在使用代理，这两个结果需要分别确认。
查看日志时关注错误发生的位置。地址解析失败先检查 DNS，连接超时先检查目标地址与端口，握手失败再对照协议和安全层，本地端口被占用则处理重复运行的进程。日志可能包含地址和认证资料，分享前应脱敏。按层定位比连续更换服务器、重装客户端或修改全部设置更容易获得可重复的结果。
配置概念的常见混淆
订阅与分享链接：订阅地址通常用于获取一组连接资料，分享链接通常描述单条连接。应使用对应的导入入口，不能只看链接中是否包含长字符串来判断类型。地址本身可能含访问凭据，应像账号资料一样保管。相关概念见订阅术语说明。
系统代理与分流：系统代理决定兼容应用把流量交到哪里，路由规则决定内核收到流量后如何选择出口。即使选择了直连规则，应用仍可能先把请求送入本地监听；即使启用了系统代理，也不代表所有应用都会遵循它。相关概念见路由与出站标签。
流量嗅探与 DNS：嗅探可以从部分连接中识别域名信息，帮助路由匹配，但不能保证每次连接都能得到域名，也不能替代完整的 DNS 设计。遇到域名规则未命中时，应结合入站设置、解析方式与规则顺序判断，而不是只反复切换嗅探开关。更多字段位置见入站配置说明。
TUN 与连接质量：TUN 改变应用流量进入客户端的方式，不会自动修复服务器超时或协议参数错误。普通代理已经无法连接时，应先解决基础连接，再启用虚拟网卡接管。复杂网络环境中还要留意其他 VPN 软件与虚拟网卡的路由影响。相关概念见TUN 模式术语说明。
安装、订阅与部署文章
从具体入口与错误现象切入。以下三篇按发布日期从新到旧排列，分别对应平台部署、订阅导入与内核生态。
路由器与旁路由部署 Xray 内核概览：硬件要求、透明代理与分流思路
让内核直接跑在路由器或旁路由上，全屋设备免装客户端。本文概述硬件选型、透明代理原理、配置文件放置与常见坑点。
阅读文章 →V2Ray 订阅链接导入方法：v2rayN 与 v2rayNG 入口位置及常见格式
本文给出订阅分组在桌面端与安卓端的入口路径，并解释 Base64 订阅、vless:// 与 vmess:// 分享链接的区别和识别方法。
阅读文章 →Project V 生态图解：V2Fly、Xray 内核与 v2rayN、v2rayNG 的关系
本文梳理 Project V 从单一项目到 V2Fly、Xray 两个内核分支的演变，并说明各图形客户端分别调用哪个内核、彼此如何分工。
阅读文章 →