Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版使用跨平台界面，WPF 版保留熟悉的窗口与菜单布局。两者都用于管理配置与启动内核，选择时以操作习惯和系统要求为准，不需要为同一条订阅同时运行两套客户端。
安装前在系统“关于”中确认处理器架构。首次启动后先查看本地监听端口和系统代理状态；如已有其他代理程序，先退出再测试，避免端口占用或系统设置互相覆盖。需要 TUN 时，再单独处理权限与虚拟网卡。
前往下载阅读起点 / CONFIG
客户端管理配置，内核执行连接；系统代理决定入口，路由规则决定去向。
V2Ray官方下载按这条链路组织下载与教程。先选择适合设备的客户端，再导入服务提供方给出的订阅或服务器配置，最后确认应用流量确实进入代理。软件安装完成，不等于已经具备可用的连接参数；界面显示已启动，也不等于所有应用都使用了代理。
上方编辑器展示的是 Xray 配置结构节选，用来区分出站协议、传输安全和路由规则。示例域名与标识仅用于解释字段，REALITY 所需的其他参数并未展开。日常使用图形客户端时，通常由界面生成内核配置，不需要把这段内容复制到配置文件。
v2rayN 设置目录
六个常用设置入口，按“配置来源 → 流量入口 → 匹配规则 → 连接诊断”的顺序阅读。不同界面布局的菜单名称可能略有差别，配置字段用于对照概念，不代表所有内核都使用同一写法。
订阅分组 → 订阅分组设置
按来源管理服务器配置
订阅地址是一份远程配置清单的入口，不是单个节点地址。新增分组后填写订阅链接，保存并执行更新，再从列表中选择活动服务器。分组便于区分不同配置来源，也便于分别设置更新周期。与逐条粘贴分享链接相比，订阅可以同步服务器列表的增删；但本地改过的订阅条目可能在更新时被覆盖。更新失败时，先确认链接有效，再比较直连更新与经代理更新的结果，避免依赖尚未可用的节点。
订阅地址自动更新间隔分组备注
主界面或托盘菜单 → 系统代理
先确认应用是否读取系统设置
设置系统代理后，客户端把本地监听地址写入操作系统的代理设置，浏览器等读取该设置的应用才会把请求交给本地入口。它与内核路由中的全局代理不是同一个开关，也不会自动覆盖所有程序。首次连接建议先使用系统代理验证浏览器，再处理其他应用。退出客户端前可清除系统代理；若软件已关闭但浏览器仍指向本地端口，就会出现普通网页也无法打开的现象，此时应先恢复系统网络设置。
本地监听地址HTTP / SOCKS系统代理状态
主界面 → 启用 TUN 模式
通过虚拟网络接口接管流量
TUN 通过虚拟网络接口处理 IP 流量，适合不读取系统代理的应用。桌面端通常需要相应权限，具体接管范围取决于路由、排除项和 DNS 设置。它不是给系统代理加速的开关，也不保证所有连接都走远端。启用前先确认普通代理可用，再观察日志和本地网络访问是否正常。若与其他虚拟网卡、企业网络工具或已有 VPN 冲突，先停用其中一项作对照，避免同时改动多个网络入口导致问题难以定位。
虚拟网卡自动路由排除网段
设置 → 路由设置 → 预定义规则集
按规则顺序选择出站
路由规则把域名、IP 或端口条件映射到代理、直连等出站。多数规则按顺序匹配，较具体的例外应放在宽泛规则之前。GeoSite 提供域名集合，GeoIP 提供 IP 集合，两者用途不同。选择预定义规则集后，应检查局域网、内部域名和目标站点的实际去向，而不是只看模式名称。与全部交给同一出站相比，分流可以保留本地服务的直接访问；规则文件缺失或标签写错时，则需要先修复数据库引用。
domainStrategygeosite:cnoutboundTag
设置 → DNS 设置
区分解析请求与业务连接
DNS 负责把域名解析成 IP，解析请求采用的网络路径不一定等于网页连接采用的路径。浏览器安全 DNS、操作系统缓存和内核 DNS 都可能参与同一次访问。遇到域名无法打开、改用 IP 却可连通的情况，应先确认由谁解析，再检查上游可达性。路由中的域名解析策略也会影响 IP 规则是否参与匹配。不要只更换一个解析地址就判断故障已解决；应使用同一域名复测，并区分缓存结果与新发起的查询。
dns.serversqueryStrategydomainStrategy
主界面 → 日志；设置 → 参数设置 → 日志等级
按错误发生的阶段定位
日志可区分内核启动、域名解析、服务器连接和协议握手等阶段。先记录一次失败访问的时间，再找相邻错误，比整页搜索“失败”更容易定位。连接被拒绝、连接超时与证书名称不匹配并非同类问题，处理方式也不同。诊断时可临时提高日志详细程度，复现后恢复日常等级。分享日志前应移除订阅地址、身份标识及私有服务器信息；日志主要提供线索，仍需结合浏览器访问与活动服务器状态交叉判断。
loglevelaccesserror
设置顺序比开关数量更重要
第一次使用时，先保留默认路由与 DNS，完成订阅导入并选定活动服务器。用真连接测试检查客户端能否通过该服务器完成一次请求，再设置系统代理，用浏览器打开一个已知可访问的页面。只有这条最短链路成立，才继续启用 TUN、添加自定义分流或调整解析策略。否则，多个尚未验证的设置叠加在一起，很难判断故障来自服务器还是本机网络。
“全局代理”需要结合所在位置理解。系统设置中的全局代理通常描述应用如何进入本地代理；客户端路由中的全局模式则描述进入内核后的流量如何选择出站。一个程序没有把流量交给客户端，即使路由设为全局，也不会因此被接管。反过来，应用已进入 TUN，也仍可能被直连规则匹配。判断代理是否生效，应检查入口和出站两端，而不是只看一个状态图标。
如果只遇到某个站点或应用异常，不必立即重装客户端。先用同一服务器访问其他页面，再切换另一条服务器配置作对照；接着检查该域名的规则匹配和 DNS 结果。每次只改变一个条件，保留失败前后的日志，能把“完全无法连接”与“局部规则异常”分开处理。详细流程见故障排查；字段含义可对照术语表。
客户端与平台下载入口
桌面端选择 v2rayN，Android 优先查看 v2rayNG，已有 V2Fly 配置需求时再比较 v2flyNG。下面的入口进入对应平台下载选项；安装包架构、系统要求和文件说明集中放在下载页。
macOS
v2rayN 的 macOS 安装选项按 Apple Silicon 与 Intel 区分。在“关于本机”查看芯片信息，再选择对应架构。配置来源与桌面端其他平台一致，但系统网络设置、启动权限和菜单位置需要按当前系统界面操作。
导入订阅后，先检查活动服务器，再确认当前网络服务的代理设置。浏览器可用而终端命令仍直连，通常说明两者采用了不同的代理入口，不应直接归因于节点失效。切换无线网络后，也应重新确认当前网络环境是否改变。
前往下载Android
v2rayNG 使用 Xray 内核，作为 Android 的优先入口；v2flyNG 使用 V2Fly 内核，适合已有对应配置的情况。主流设备通常选择 arm64，无法确认架构时可查看通用包说明。协议是否可用取决于客户端及内核支持，不能只依据分享链接的名称判断。
首次连接需要确认系统 VPN 授权。若锁屏后连接中断，先检查电池优化、后台运行与网络切换行为，再排查服务器。应用分流也会改变实际接管范围；测试时请确认浏览器没有被放入排除列表，并避免同时启动另一项 VPN 服务。
前往下载Linux
v2rayN 提供 deb 与 rpm 安装选项，并区分 x64、arm64 架构。应先确认发行版的软件包体系和处理器类型，再选择文件。图形客户端适用于桌面会话；系统代理能否被应用读取，还取决于桌面环境和程序自身的实现。
桌面浏览器、命令行工具与后台服务可能分别使用不同代理设置。测试浏览器成功后，不要据此推断所有进程都已接管。启用 TUN 时应关注权限、系统路由与其他虚拟网络接口；如果局域网访问受影响，先检查排除网段，而非反复切换节点。
前往下载下载客户端之后还需要什么
客户端提供本地配置管理、协议处理和流量转发能力，不会自动生成远端服务。连接所需的地址、端口、身份参数及传输设置，应由服务提供方提供。订阅链接可能包含访问凭据，应按私密配置保存，不要粘贴到公开截图或第三方在线转换页面。迁移设备时，也应先分清导出的是单条服务器配置、订阅地址还是客户端整体设置。
已有配置的用户，建议先记录当前活动服务器、路由模式与本地端口，再进行客户端升级或平台迁移。保留一份可恢复的配置，有助于判断新环境中的差异。遇到协议字段无法识别时，应比较内核能力与配置格式；同属 Project V 生态，不意味着所有客户端都能直接读取彼此的完整设置文件。
Project V、V2Fly 与 Xray
开源生态需要分层理解。项目名称、执行内核、图形客户端与远端服务分别承担不同职责，混用这些名称容易造成安装与配置判断偏差。
配置界面 → 内核执行 → 远端服务
同一生态，不同职责
Project V 是理解 V2Ray 相关工具的背景。V2Fly 延续 V2Ray 的社区开发路线，Xray 则在相关技术基础上形成独立的内核发展方向。v2rayN、v2rayNG、v2flyNG 是面向用户的图形客户端，负责把订阅、服务器参数与模式选择转成内核可执行的配置。服务端使用何种协议，仍需与客户端所用内核的能力对应。
Project V · 项目生态V2Fly / Xray · 执行内核客户端 · 配置界面
内核家族与协议支持
内核负责接收入站流量、匹配路由规则，并按出站配置建立连接。V2Fly 与 Xray 共享部分历史背景和配置概念，但各自维护功能与配置演进，不能把二者当成可随意互换的文件。尤其涉及 VLESS、REALITY 与 Vision 等组合时，应先确认当前运行的内核，而不是仅确认客户端名称。
协议、传输与安全层也不是同义词。VLESS 是代理协议，REALITY 属于传输安全机制，Vision 是特定条件下使用的流控方式。填写参数时，应把服务端给出的组合整体对应到客户端设置。只把协议选成 VLESS，而遗漏安全层或流控要求，仍可能在握手阶段失败；单纯更换端口并不能解决这种不匹配。
三款客户端的开源属性
v2rayN、v2rayNG 与 v2flyNG 都属于开源客户端，主要客户端代码采用 GPL 系列许可；V2Fly 与 Xray 内核主要采用 MPL 2.0 许可。客户端界面、内核及随附组件分别受各自许可约束。免费使用、查看代码与再分发的具体权利并不是同一件事，涉及修改、分发或集成时，应以相应项目的许可文本为准。
选型首先看设备与配置。桌面端由 v2rayN 集中管理服务器、订阅和路由；Android 的 v2rayNG 侧重 Xray 生态，v2flyNG 则对应 V2Fly 路线。这里的“优先”与“备选”表示本站的操作入口顺序，不代表另一款客户端已经停止维护，也不表示某一内核在所有网络环境中都具有速度优势。
订阅、客户端与规则更新
客户端升级、订阅刷新与 Geo 数据库更新是三条不同的维护路径。客户端升级改变界面或附带组件；订阅刷新从服务提供方重新读取服务器列表；Geo 数据库更新则改变域名和 IP 集合的内容。订阅成功刷新，不会自动证明路由文件已经更新；更新规则文件，也不会修复已经过期的订阅地址。
更新前后应保留可比较的条件，例如同一活动服务器、同一路由模式和同一个测试域名。若变化后出现异常，先检查启动日志和实际配置，再决定是否恢复设置。日常自动刷新也不宜设置得过于频繁，周期应结合配置来源的要求；请求过密可能触发服务端限制，反而影响正常更新。
下载与教程的阅读边界
配置教程与技术文章
最近三篇按操作问题展开：先判断订阅请求是否成功，再检查规则数据库，最后验证选中的服务器与系统代理。文章中的操作路径与配置解释分开书写，便于按当前问题查阅。
订阅更新失败的常见原因与 v2rayN 自动更新间隔设置
按链接失效、网络不通、代理自循环、内容格式异常四类梳理订阅更新失败的原因，并说明在订阅分组里设置自动更新间隔的方法。
适合“节点仍在，但刷新报错”的情况。先确认请求是否拿到了有效配置内容，再考虑更新方式与周期，避免把远端返回的错误页面当作订阅导入。
阅读订阅排查方法 →geoip.dat 与 geosite.dat 更新方法：路由规则文件的来源与写法
解释 GeoIP、GeoSite 数据库在路由分流中的作用，演示在客户端内更新规则文件，以及在规则里引用 geosite:cn、geoip:private 等常用标签。
适合“客户端能连接，但部分流量去向不符”的情况。先核对标签类型与数据库是否存在，再检查规则顺序；域名集合和 IP 集合不能仅凭名字相近就相互替换。
阅读规则文件说明 →v2rayN 首次连接指南：选节点、真连接测速与代理生效验证
导入订阅后的第一步：用真连接测速挑选可用节点，切换系统代理模式，再用浏览器和命令行两种方式确认流量确实走了代理。
适合已经看到服务器列表、却不确定下一步如何操作的情况。测试结果只反映测试当时的链路，不能代替实际应用验证；选择服务器后，仍需确认流量入口是否设置正确。
阅读首次连接流程 →