Windows
v2rayN · Desktop / WPF
桌面版使用跨平台界面，WPF 版保留经典桌面操作方式。首次安装可先查看桌面版入口；已有使用习惯时，再按需要选择 WPF 版。两种界面都要先导入有效配置，安装完成本身不会自动产生服务器。
下载前在系统设置中确认处理器架构与系统要求。初次启动先保留默认监听设置，避免还没建立连接就同时更换端口、内核和路由。若需要启用 TUN，再单独检查运行权限。
前往下载设置目录 / 常用配置
v2rayN 配置的五个入口
客户端负责管理配置，内核负责建立连接。先分清订阅、系统代理和路由各自控制什么，再修改参数，能避免把一个问题拆成多处相互冲突的设置。以下内容按桌面客户端的常见菜单组织；安卓客户端的入口名称可能不同，但导入、选择配置与启动服务的顺序一致。
先保存分组，再更新订阅
订阅地址不是单个服务器配置，而是客户端获取一组配置的入口。在 v2rayN 中打开订阅分组设置，填写分组名称与提供方给出的地址，保存后再执行更新订阅。更新完成后先检查当前分组，确认列表出现可用配置，再选中一项作为活动服务器。与逐条手填参数相比，分组更新更适合持续维护多条配置；但更新失败不一定是节点故障，也可能是地址失效或请求路径不可达。订阅地址可能包含访问凭据，不要放进截图、日志或公开讨论。
订阅分组 → 订阅分组设置 → 添加
填写备注与订阅地址 → 保存
订阅分组 → 更新订阅（不通过代理）
选择分组 → 设为活动服务器按规则顺序决定连接出口
路由分流决定已进入内核的连接走直连、代理还是阻断，不负责让应用流量进入客户端。首次配置可先使用“绕过大陆”预设，确认基本访问正常后再添加自定义规则。规则通常从上到下匹配，具体域名例外应放在宽泛分类之前；否则前面的规则已经命中，后面的设置就不会生效。相比只切换全局模式，按域名与地址分类更便于保留本地服务访问。下方是 Xray 路由规则片段，需要放入完整配置的规则数组，并确保对应数据文件与出站标签存在。
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}为不读取系统代理的应用接管流量
TUN 通过虚拟网络接口接管流量，适合处理部分不遵循系统代理设置的应用。它与路由分流是两个层次：前者处理流量入口，后者决定连接出口。开启前先用普通代理验证所选配置能连接，再按平台要求授予网络或管理员权限。若启动后所有访问都异常，应先检查其他虚拟网卡、VPN 程序和 DNS 设置，而不是反复更新订阅。与手动给每个应用填写代理地址相比，TUN 的覆盖范围更广，但也更需要关注局域网访问、休眠恢复以及退出时的路由清理。
确认普通代理连接正常
→ 按平台要求授予权限
→ 主界面：启用 TUN
→ 检查目标应用与局域网访问根据配置需要选择内核
图形客户端和代理内核不是同一个组件。v2rayN 提供配置管理界面，并可按安装包与版本支持情况使用不同内核；协议、传输方式与扩展字段最终由实际运行的内核解析。导入成功只代表客户端识别了配置，不代表当前内核支持其中全部参数。遇到不支持字段或启动即退出的情况，先在日志中确认内核名称，再核对配置来源的要求。与直接修改生成文件相比，优先在图形界面调整内核设置更容易保留变更，也能减少下次切换服务器时配置被覆盖的问题。
设置 → 参数设置 → Core 类型相关设置
确认协议对应内核 → 保存
重新启动服务 → 日志中确认实际启动的内核先确认应用是否读取系统代理
“自动配置系统代理”会修改系统提供给应用的代理设置，但并不等于接管设备上所有连接。浏览器通常能读取这项设置，部分程序则需要单独填写本地代理地址，或改用 TUN。首次使用时先检查本地监听端口，再选择自动配置系统代理；退出前若仍有访问异常，可检查是否残留了指向本机的代理设置。与路由中的“全局代理”相比，这个选项控制的是流量是否进入客户端，而不是进入后如何转发。排查时把两者分开检查，能更快区分应用设置与服务器连接问题。
主界面 → 系统代理 → 自动配置系统代理
需要停止使用时 → 清除系统代理
手动配置应用时 → 核对本地监听地址、端口与代理类型下载入口 / 按系统选包
V2Ray 客户端平台选择
桌面设备优先查看 v2rayN，安卓设备优先查看 v2rayNG，已有 V2Fly 配置需求时再考虑 v2flyNG。安装包需要同时匹配操作系统与处理器架构；文件能下载，不代表能在当前设备运行。下载中心集中列出安装入口、架构说明与相关要求，首页不固定展示版本信息。
macOS
v2rayN · Apple Silicon / Intel
先打开“关于本机”，查看芯片或处理器字段。Apple Silicon 设备选择对应架构入口，Intel 设备选择 Intel 入口；不要仅凭设备外观或购买年份判断。下载中心将两种安装入口并列，方便按设备信息选择。
首次运行时，留意系统对应用和网络权限的提示。先验证客户端能启动、订阅能导入，再设置系统代理。若其他网络工具正在接管流量，先暂停其中一个，减少路由与 DNS 配置交叉影响。
前往下载Android
v2rayNG 优先 · v2flyNG 备选
v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。先根据配置要求选择客户端，再选择 arm64 或通用安装包。主流较新设备通常使用 arm64；不确定架构时，先查设备信息，必要时使用通用包。
启动服务时需要确认系统 VPN 授权。若锁屏后频繁断开，再检查电池优化和后台运行限制。切换两款客户端进行对照时，先停止原有连接，避免把系统只允许一个活动 VPN 的限制误判成配置故障。
前往下载Linux
v2rayN · deb / rpm
按发行版的软件包体系选择 deb 或 rpm，再核对设备是 x64 还是 arm64。下载中心同时提供这两类架构入口。优先通过发行版的图形软件安装器打开安装包，遇到依赖提示时先记录具体名称。
安装完成后检查桌面环境的代理设置是否被目标应用读取。不同应用对系统代理的支持并不一致，浏览器能访问而其他程序失败时，应先确认流量入口。TUN 还涉及额外权限，不宜与首次订阅导入同时调整。
前往下载快速上手 / 先建立最小可用连接
订阅导入到访问验证
建议一次只改变一类设置。先确认配置能够连接，再优化分流与流量接管范围；出现异常时，就能明确是哪一步引入了变化。以下以 v2rayN 桌面端为主，v2rayNG 安卓端对应执行导入、选中配置与启动服务。
步骤 01 / 配置来源
导入订阅并选中服务器
准备配置提供方给出的订阅地址或单条分享链接。订阅地址放入“订阅分组设置”，分享链接则使用从剪贴板导入的入口，不要把两种内容填进同一个输入框。保存分组后执行更新，检查返回列表，再将其中一项设为活动服务器。安卓端可在添加配置或订阅设置中完成对应操作。
如果更新后没有条目，先切换到正确分组，并检查地址是否完整、是否包含多余空格，以及提供方是否已更换地址。浏览器能打开某个订阅页面，也不代表返回内容就是客户端支持的订阅格式。不要连续重复更新覆盖现场，先记下客户端显示的错误信息。
订阅导入详细步骤 →步骤 02 / 流量入口
设置代理与基础路由
在桌面端先选择“自动配置系统代理”，并使用合适的路由预设。系统代理决定支持它的应用是否将请求送入本地监听端口，路由预设决定进入内核的连接如何选择出口。两项设置不能互相替代，也不需要在首次连接时就编写复杂规则。
若目标应用有独立代理设置，核对它填写的代理类型、地址和端口是否与客户端一致。暂时保留 TUN 关闭状态，先用浏览器验证基本连接。安卓端启动服务时确认系统授权，再检查是否设置了按应用代理；被排除的应用不会按预期进入这条连接路径。
路由与模式设置 →步骤 03 / 连接检查
验证访问，再检查日志
启动服务后，分别检查一个预期直连的地址和一个预期经代理访问的地址。只看到客户端图标变化，不足以证明实际请求已经经过代理；需要结合访问结果与连接日志判断。节点延迟测试也不等于下载速度，单次测试结果不适合直接作为稳定性结论。
若无法访问，按“内核是否启动、本地端口是否监听、应用是否使用代理、远端是否可达”的顺序检查。先保留报错关键词，不要一次重装全部组件。准备分享排查信息时，隐藏订阅地址、服务器凭据和个人网络信息，仅保留操作步骤、错误类型与必要的环境说明。
按症状进入问题诊断 →开源生态 / 客户端与内核
Project V、V2Fly 与 Xray
V2Ray 常被用来统称一类代理工具，但实际配置涉及图形客户端、代理内核、协议与服务端四个层次。下载时看客户端名称，判断参数兼容性时看内核与协议，排查网络问题时再沿着实际连接路径定位。名称相近，不代表所有设置都可以直接互换。
配置层次
界面管理
内核执行
- 图形客户端管理订阅、配置与启动选项
- 代理内核解析规则并建立实际连接
- 协议与传输约定通信方式与必要参数
- 远端服务提供与配置对应的连接端点
Project V 是生态背景，不是单一下载文件
Project V 围绕模块化代理工具形成，V2Ray 是其中广为使用的核心项目。V2Fly 社区持续维护 V2Ray 相关实现，Xray 则从 V2Ray 项目分支发展，形成了自己的功能演进与参数支持范围。理解这段关系，有助于读懂客户端里的内核选项：它们有共同历史，但不能据此假定配置字段、协议扩展和路由行为始终完全相同。
日常使用通常不需要直接编辑完整的内核配置。图形客户端会根据订阅条目和界面设置生成运行配置，再启动相应内核。若手动修改的是生成文件，下次切换服务器或保存设置时可能被覆盖。需要长期保留的变更，应优先通过客户端提供的设置入口完成，并记录修改前后的行为。
三款客户端的开源属性与使用定位
v2rayN、v2rayNG 与 v2flyNG 都是社区维护的开源图形客户端，客户端本身可免费使用。v2rayN 以 GPL-3.0 许可证发布，覆盖桌面配置管理场景；v2rayNG 同样采用 GPL-3.0，面向安卓并使用 Xray 内核；v2flyNG 采用 GPL-3.0，面向安卓并使用 V2Fly 内核。许可证约束的是软件代码的使用与分发，不代表客户端会附带可连接的远端服务。
桌面端优先从 v2rayN 开始，安卓端优先考虑 v2rayNG；如果配置明确要求 V2Fly 的行为，再评估 v2flyNG。三者的设置界面、内核组合和平台权限不同，因此迁移时应重新核对路由、DNS 与应用代理范围，而不是只确认服务器条目已经导入。详细选型可查看客户端横向评测。
内核许可证与协议支持需要分别确认
V2Fly 与 Xray 的核心代码通常采用 MPL-2.0 许可证，和图形客户端的许可证属于不同层次。开源意味着可以按许可证条件查看、修改和分发相关代码；判断一份配置能否运行，仍要查看具体内核支持什么协议与传输字段。VMess、VLESS、Trojan、Shadowsocks 是协议名称，不是服务器地址，也不能单凭协议名推断速度。
例如，配置包含特定 TLS 或 REALITY 参数时，需要完整匹配服务端提供的设置，并使用支持这些字段的实现。不要为消除一个报错而随意关闭证书验证。先确认时间是否准确、域名是否对应、参数是否完整，再判断是否需要更新客户端或更换内核。参数意义不明确时，先查术语说明，比逐个试开关更容易复现结果。
把软件更新和订阅更新分开处理
客户端更新涉及界面、依赖组件与配置生成逻辑，内核更新涉及协议实现和运行行为，订阅更新则只是在刷新服务器配置。订阅刷新成功，不代表软件已经更新；安装新版客户端，也不会自动修复失效的订阅。下载中心集中提供客户端入口，订阅地址和服务状态仍需向配置提供方确认。
更新前先备份现有设置，记录正在使用的内核、监听端口和自定义规则。更新后先验证基本连接，再逐项恢复额外配置。若新环境出现异常，保留日志中的第一处错误以及触发步骤，不要只记录最后一行“启动失败”。对于连接超时、DNS 解析异常或系统代理残留，可以直接进入问题诊断；概念性疑问则先看FAQ，减少不必要的重装。
资讯 / 配置与排查记录
客户端选型与运行日志
基础连接建立后，再根据遇到的具体问题阅读专题。选型文章解释平台与内核差异，日志文章按错误关键词定位故障，启动失败专题则把端口占用、格式错误与字段兼容问题分开处理。每次先确认现象属于哪一层，再决定要改哪项设置。
Xray 内核启动失败怎么办：端口占用、JSON 格式与字段错误排查
内核一启动就退出时，按端口冲突、配置文件格式、字段拼写与内核版本四条线逐一排查，定位出错的那一行。先区分配置解析失败与连接失败，再决定是修改设置还是检查网络。
阅读启动排查步骤 →v2rayN、v2rayNG、v2flyNG 怎么选：内核、平台与功能差异对照
从适用平台、内核家族、协议覆盖和日常操作习惯四个维度对照三款客户端，给出桌面与安卓的选型建议。重点看配置需要哪些能力，而不是仅根据名称相近就互换安装包。
阅读客户端选型说明 →v2rayN 运行日志解读：常见报错关键词与定位思路
按日志级别和报错关键词归类，说明 connection refused、i/o timeout、TLS 握手失败等提示分别指向哪个环节。结合触发时间和目标应用，保留最早出现的有效错误信息。
阅读日志定位方法 →