Windows
v2rayN 首推Desktop / WPF
适合需要订阅分组、路由管理和图形设置的桌面用户。下载页同时提供 Desktop 与经典 WPF 入口：前者采用跨平台界面，后者延续熟悉的桌面操作方式。两种界面不等于两种代理协议，实际连接能力还要看内核与配置。
先核对系统和处理器，再按说明安装。已有配置时先备份，尤其不要让两个实例同时占用同一个监听端口。程序启动后先导入订阅并选中服务器，再设置系统代理；仅打开窗口不会自动让所有应用接入。
前往下载 →V2Ray 订阅与代理设置
先把连接配置导入，再决定哪些流量交给客户端。五类常用设置，按实际操作顺序展开。
订阅地址与单节点链接分开导入
订阅适合持续维护一组连接。先在订阅分组中添加地址，保存后执行更新，再查看分组是否出现服务器条目。单节点分享链接则从剪贴板导入，不要填进订阅地址栏。与逐条手工录入相比，订阅能减少重复修改，但更新后也可能替换原有条目。建议按来源命名分组，保留手工配置的独立分组，并在更新失败时查看提示。订阅地址可能包含访问凭据，分享截图前应遮住完整地址。
订阅分组 → 订阅分组设置
添加 → 备注 / 地址 → 确定
订阅分组 → 更新订阅用域名和 IP 规则安排出口
路由分流决定请求走直连、代理还是阻断，不等于切换服务器。先选客户端提供的路由方案，确认常用网站能访问，再增加少量自定义规则。多数规则按顺序匹配，宽泛规则放在前面可能遮住后面的精确规则。遇到某个域名走错出口时，应同时检查域名解析方式和规则顺序，而不是反复更换节点。相比全部流量使用同一出口，分流更灵活，也更需要保持规则清晰；修改前导出设置，便于恢复。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}先核对支持，再切换内核
客户端负责界面和配置管理，内核负责实际连接。v2rayN 可管理不同内核，具体选择取决于当前构建及服务器配置；安卓端的 v2rayNG 与 v2flyNG 则分别侧重 Xray 和 V2Fly 生态。看到相似的协议名称，不代表所有字段都能通用。尤其是 REALITY、流控和传输参数，必须核对服务端要求。切换内核前先记录原设置，只改变一个变量，再重新启动连接并查看日志，避免把内核差异误判为订阅故障。
参数设置 → Core 类型
Xray
V2Fly系统代理与 TUN 不是同一个开关
系统代理主要影响愿意读取系统代理设置的应用，适合先验证浏览器访问。TUN 通过虚拟网络接口接入流量，覆盖方式更广，但涉及权限、路由和域名解析。两者都不能替代有效的服务器配置。初次使用先选系统代理，确认连接正常后，再按应用需求尝试 TUN。若开启后本地设备无法访问，应检查私有地址的直连规则。与同时启用多个代理工具相比，一次只保留一个接入方案更容易判断问题所在。
系统代理：自动配置系统代理
启用 TUN 模式：关闭
允许来自局域网的连接：关闭同步连接来源，不整包覆盖设备设置
桌面和手机可以使用同一订阅来源，但本地监听端口、系统代理、TUN 权限与路由文件路径需要分别设置。先在新设备导入订阅，确认协议支持，再调整本机选项，比直接搬运完整配置更稳妥。部分客户端提供导入导出或备份功能，格式也未必能跨客户端读取。迁移时把连接参数与设备参数分开处理，保留原设备备份；若只有部分条目缺失，优先检查订阅格式和内核兼容性，不要急着重复安装。
连接来源：订阅地址 / 分享链接
设备设置：监听端口 / 系统代理 / TUN
导入后：更新分组 → 选择服务器 → 验证连接配置、流量接入、路由规则的区别
这三层设置分别回答不同问题：服务器配置决定连接到哪里、使用什么协议；系统代理或 TUN 决定应用流量怎样进入客户端；路由规则决定进入后使用哪个出口。导入成功只说明客户端读到了配置，并不代表应用已经使用代理。浏览器能够访问，也不代表所有桌面程序都会读取同一套系统设置。先分清层次，排查时就能少改几个无关选项。
建议首次使用保留默认监听地址，不开启局域网共享，也不急着加入复杂规则。确认一条连接能够完成实际请求后，再逐项调整。每次修改记录原值，出现问题时恢复最近一次变更，比一次切换协议、内核和路由更容易定位原因。本文中的设置窗仅用于说明选项关系，具体菜单名称以安装的客户端界面为准。
按平台选择 V2Ray 客户端
桌面端从 v2rayN 开始，安卓端优先考虑 v2rayNG。安装包的处理器架构、包格式和系统要求，集中放在客户端下载页核对。
macOS
v2rayNApple Silicon / Intel
v2rayN macOS 下载需要先分清芯片类型。在系统的“关于本机”中查看芯片或处理器信息，再选择 Apple Silicon 或 Intel 对应安装入口。文件后缀相同不代表架构相同，选错后可能无法启动或需要额外兼容处理。
首次启动若出现系统安全提示，先确认下载来源和提示内容，再按系统设置处理，不要直接关闭整套安全机制。订阅可以沿用已有来源，但系统代理权限、TUN 权限和文件路径要在本机重新确认，不能照搬其他桌面系统的设置。
前往下载 →Android
v2rayNG 首推v2flyNG 备选
优先使用基于 Xray 内核的 v2rayNG；需要匹配 V2Fly 配置时，再考虑 v2flyNG。主流设备通常选择 arm64，无法确认架构时可查看通用包说明。设备支持的指令集仍以系统信息为准，不必只根据手机上市年份判断。
安卓端启动连接时会请求系统的 VPN 连接授权，这是客户端接入流量的步骤，不代表软件附带远程服务器。连接后若后台中断，再检查省电策略和后台活动权限。v2rayNG 订阅导入完成后，还需更新分组、选择条目并启动连接。
前往下载 →Linux
v2rayNdeb / rpm
先按发行版选择 deb 或 rpm，再确认设备使用 x64 还是 arm64。下载页以 x64 为主要入口，同时列出 arm64 对应选项。图形桌面环境、系统组件及权限策略会影响运行方式，安装前应阅读该平台的要求，而不是只看包能否下载。
系统代理在不同桌面环境中的生效范围可能不同，部分应用需要单独指定代理地址。先用浏览器验证基础连接，再处理其他程序。若准备使用 TUN，应额外检查所需权限和路由设置，不建议为了启动界面就长期以高权限运行整个程序。
前往下载 →V2Ray 快速上手：导入、接入、验证
准备好来源可信且仍然有效的订阅地址或分享链接。客户端只负责读取配置和建立连接，下载安装本身不会生成服务器。
-
安装客户端，导入配置
按设备平台和处理器选择安装包。订阅地址填入订阅分组，单节点链接使用剪贴板导入入口。保存订阅后执行更新，检查是否出现服务器条目。如果列表为空，先看更新提示、地址是否完整以及内容格式是否匹配，不要反复点击启动。
-
选择服务器，设置流量接入
选中准备使用的条目，桌面端先使用系统代理，安卓端按提示授予连接权限。保持默认路由方案，暂时不要同时调整 DNS、TUN 和自定义规则。若设备上还有其他代理工具，先退出冲突实例，避免端口占用或系统设置互相覆盖。
-
发起实际请求，查看日志
打开常用网站或目标应用，确认请求能够完成。延迟测试只是辅助信息，不能代替实际访问；某些探测方式失败时，业务连接仍可能正常。若访问异常，按订阅有效性、内核运行状态、应用接入和路由顺序逐层检查，一次只修改一个选项。
退出前恢复系统代理。更换配置或升级客户端前，先保存当前可用设置；需要提供故障信息时，仅截取相关错误，隐藏订阅地址、身份标识和服务器凭据。
查看完整教程 →Project V、V2Fly 与 Xray 的关系
客户端、内核和协议分属不同层次。认清这些名字，比按软件名称猜测兼容性更有用。
图形客户端
v2rayN · v2rayNG · v2flyNG
连接内核
Xray · V2Fly
协议与传输
VMess · VLESS · Trojan · Shadowsocks
Project V 是生态背景，不是一个下载按钮
V2Ray 起源于 Project V，提供处理网络连接的模块化能力。用户日常看到的窗口、订阅列表和开关，通常来自另外开发的图形客户端。客户端将界面中的选项转换为内核配置，再交给内核执行。因而“V2Ray 下载”在实际操作中通常是先下载适合设备的客户端，而不是直接编辑底层程序的全部参数。本站把平台选择与入门步骤放在前面，把协议和配置细节放到参考文档，便于按需要深入。
这也解释了为什么两款软件都能导入同一条链接，却可能显示不同菜单。界面组织方式由客户端决定，链接字段能否真正运行则由内核能力和客户端的解析实现共同决定。遇到功能缺失，先确认缺的是界面入口、导入支持还是内核功能，处理方向会更明确。
V2Fly 与 Xray 同源发展，功能不能一概互换
V2Fly 延续 V2Ray 社区维护路线，Xray 从相关代码基础发展出自己的功能路线。两者在常见协议和配置概念上有联系，但传输方式、流控字段与具体实现会持续变化。REALITY 是传输安全机制，不应简单当成与 VMess、VLESS 并列的独立代理协议；实际使用常见的是 VLESS、REALITY 与特定流控的组合，是否可用需要核对两端的实现支持。
选择内核的原则是匹配服务器配置，而不是把名称当成性能排名。连接耗时与资源占用还受设备、网络路径、服务器负载和传输参数影响。移动端的电量表现也与后台保活、网络切换和请求频率有关，不能只凭协议名字下结论。需要比较设计取舍时，可继续阅读协议与内核技术参考。
三款开源客户端，各有操作侧重
v2rayN 侧重桌面端的服务器管理、订阅分组和路由配置，适合需要集中维护多组连接的用户。v2rayNG 提供面向安卓设备的图形操作，采用 Xray 内核路线；v2flyNG 则是 V2Fly 生态的安卓备选。三者均有公开源代码，具体授权以各项目附带的许可证为准。客户端和所集成的内核可能采用不同许可证，不宜把整个生态概括成同一种授权。
开源便于理解实现和追踪变更，但不是所有配置都自动可靠的保证。订阅来源、服务器管理方式和本机权限仍需独立判断。本站提供客户端下载入口与使用说明，并非上述项目的开发团队；站名不代表与这些项目存在官方隶属关系。使用连接服务前，应确认自己具备相应授权，并遵守适用规则。
客户端更新、内核更新、订阅更新要分开看
客户端更新主要涉及界面、导入逻辑和管理功能；内核更新影响实际协议实现；订阅更新则重新获取服务器条目。更新其中一项，不意味着另外两项也已完成。遇到新格式链接无法识别，可能要更新客户端；能够识别但连接报错，则应进一步查看内核日志和参数，而不是只重复更新订阅。已有稳定配置时，先备份再逐项变更，能保留清晰的排查线索。
日志中的连接超时、域名解析失败和握手失败，指向的问题层次不同。超时先检查服务器可达性与网络路径；解析失败检查 DNS 和域名；握手失败核对时间、传输安全及身份参数。不要将所有错误归结为“节点失效”。常见的V2Ray 无法连接、延迟测试异常与测速结果差异，可分别进入对应问题阅读。
配置解析与使用心得
按最近发布日期排列。先理解链接和配置结构，再深入协议机制；阅读顺序不必与发布日期一致。
V2Ray 配置文件 JSON 结构解析：inbounds、outbounds 与 routing 逐段读懂
从入站、出站、路由与日志四部分拆解配置，说明字段在客户端界面中的对应位置。适合已经能够导入连接、希望进一步看懂运行配置的用户。阅读时先追踪一条请求从本地监听进入、匹配规则再交给出口的过程，不必一次记住所有参数。
阅读文章 →vmess:// 与 vless:// 分享链接是什么：单节点链接和订阅地址的区别与导入方法
分享链接描述一条连接，订阅地址提供可更新的内容来源，两者应使用不同入口。文章介绍编码结构与更新机制，并梳理 v2rayN、v2rayNG 从剪贴板和订阅分组导入的操作。遇到粘贴后没有条目时，先判断拿到的究竟是哪一种链接。
阅读文章 →REALITY 协议与 XTLS Vision 流控原理：减少重复加密为什么能提升速度
围绕 TLS 嵌套的处理开销，解释 Vision 流控和 REALITY 握手各自解决的问题，以及组合使用时需要核对的字段。重点是设计取舍与填写逻辑，不把单一机制当成速度保证。已有基础连接经验后再阅读，更容易区分协议、传输安全与流控。
阅读文章 →