Windows
v2rayNDesktop 使用跨平台界面，WPF 保留经典桌面操作方式。两种入口都以订阅管理和代理设置为主，不需要因为界面不同而重新购买或更换订阅。
先在系统“设置 → 系统 → 系统信息”确认系统类型。首次启动遇到运行库提示时，按安装包说明补齐依赖；保留原配置目录后再更换界面版本，避免直接覆盖正在使用的文件。
前往下载 Windows 客户端 →Project V 生态 · 客户端与内核分层
- Project V
- V2Fly
- Xray
- 订阅管理
- 路由分流
下载入口
按操作系统选择
客户端安装包
桌面使用 v2rayN，安卓优先查看 v2rayNG。先确认系统与处理器架构，再进入对应平台的安装包清单。
macOS
v2rayN按芯片选择 Apple Silicon 或 Intel 安装包。打开系统菜单中的“关于本机”，查看显示的是芯片名称还是 Intel 处理器；不要仅凭设备外观或购买年份判断架构。
将客户端放入应用程序目录后再运行，便于后续更新与权限管理。启用系统代理和启用 TUN 是不同操作，首次配置可先验证普通代理链路，再按应用需求处理网络权限。
前往下载 macOS 客户端 →Android
v2rayNG / v2flyNGv2rayNG 使用 Xray 内核，作为安卓首选入口；v2flyNG 使用 V2Fly 内核，适合已有对应配置的用户。多数较新的手机可先查看 arm64 包，不确定架构时查看通用版说明。
连接时需要确认系统 VPN 授权。若另一个网络工具已经占用该连接，应先停止原连接。后台中断还可能与电池管理有关，导入成功并不等于客户端已获得持续运行权限。
前往下载 Android 客户端 →Linux
v2rayN按发行版的软件包体系选择 deb 或 rpm，再确认 x64 与 arm64 架构。桌面环境中的系统代理通常只影响遵循该设置的程序，终端工具可能仍需单独配置代理入口。
首次使用先完成订阅更新，选择配置后再测试应用请求。需要 TUN 时检查相应权限与本机网络管理方式，不要同时修改路由、DNS 和防火墙，否则难以判断具体是哪一步造成变化。
前往下载 Linux 客户端 →客户端负责读取配置与控制本地入口，服务端地址、端口和认证信息仍需由用户准备。本站提供下载索引与技术说明，不提供订阅账户或节点服务。
查看全部客户端 →配置路径
从订阅导入
到路由分流
把配置来源、流量入口与内核出站分开检查。选择设置项，查看对应操作与配置片段。
订阅分组设置输入 → 保存 → 更新
订阅地址与单条配置分开导入
订阅适合集中更新多条配置。在 v2rayN 的“订阅分组 → 订阅分组设置”中添加分组，填写地址并保存，再执行更新订阅。单条分享链接则从剪贴板导入，不要填进订阅地址栏。与逐条录入相比，分组便于区分来源和批量维护；更新会改变组内内容，手动修改前先导出需要保留的配置。示例地址只用于识别格式，不能用于实际连接。
https://example.com/sub?token=xxxx路由规则routing.rules
按域名和 IP 决定出站
路由规则在内核收到流量后生效，通常按顺序检查并使用首先匹配的规则。相比把全部请求交给同一出站，自定义规则能单独处理本地网络、指定域名和其他流量。下面片段将中国域名集合与私有地址交给 direct；实际配置必须存在同名出站，并准备相应规则数据库。修改前备份原规则，每次只调整一类条件，再用目标应用验证，避免误把入口问题当作分流问题。
{
"routing": {
"rules": [
{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}流量入口系统代理 / TUN
先确认应用是否使用本地入口
系统代理通过操作系统设置提示应用使用本地代理，只对遵循该设置的程序有效。“自动配置系统代理”用于写入设置，“清除系统代理”用于移除设置，“不改变系统代理”则保留当前状态。TUN 使用虚拟网络接口接入流量，与普通系统代理相比覆盖方式不同，也涉及权限、路由和 DNS。建议先验证系统代理，再按需要启用 TUN；两者都不能代替正确的服务端配置。
排查应用未使用代理 →内核设置Xray / V2Fly
按配置所需能力选择内核
v2rayN 的界面负责管理配置，内核负责协议处理和转发。可用内核与切换入口以当前安装包为准；需要选择时，在设置中检查对应协议的内核类型。Xray-core 与 v2fly-core 各自演进，不能仅凭相似的协议名称判断所有字段都兼容。与只更换界面相比，切换内核会影响配置解析能力。切换后先查看启动日志，确认内核已启动，再检查传输、安全参数与服务端是否一致。
查看内核与协议术语 →导出与分享配置迁移
迁移连接参数，重新检查本机设置
跨设备迁移优先使用原订阅地址；只有单条配置时，可在服务器列表选中条目，通过右键菜单导出分享链接，再在目标客户端从剪贴板导入。不同界面的菜单名称可能略有差异，应按导出与导入功能核对。相比整目录复制，分享链接更适合传递连接参数，但通常不包含完整路由、DNS 和系统权限。迁移后重新检查本地端口与代理模式，含认证信息的链接只在受控设备间传递。
查看全平台安装与迁移说明 →连接检查的顺序
导入后先确认有可选配置，再确认内核可以启动，然后检查应用入口，最后调整路由与 DNS。浏览器能够访问某个页面，只能说明这次请求成功，不能证明每个程序都遵循同一套代理设置。需要进一步判断时，用同一应用、同一目标重复测试，并记录刚刚修改的设置项。一次只改变一个条件，回退时才有明确依据。
开源生态与维护边界
Project V、V2Fly
与 Xray 内核
客户端、内核和订阅服务处于不同层次。辨清各自职责，比只记住一个软件名称更便于选型与排查。
Project V 与内核家族
Project V 是围绕代理通信工具形成的技术生态，V2Ray 是其中广为使用的实现。V2Fly 延续了 V2Ray 的社区维护与开发，Xray 则源自相关代码基础并独立演进。两者共享部分概念，但新增功能、配置字段与发布节奏并不完全一致。阅读配置文档时，应同时确认文档针对的内核，不能把某个实现中的设置原样推到另一个实现上。
协议名称、传输方式和安全层也需要分别理解。VMess、VLESS、Trojan 与 Shadowsocks 描述不同的协议方案，WebSocket 等传输设置描述数据怎样承载，TLS 等安全设置又属于另一层。选择客户端之前先确认现有服务端需要哪些能力，不必为了更多设置项而更换已经兼容的工具。具体字段应以服务端提供的参数和当前内核支持范围为准。
三款客户端的分工
v2rayN 面向桌面系统，提供订阅分组、服务器配置、路由与本地代理入口管理。v2rayNG 面向安卓，使用 Xray 内核；v2flyNG 同样面向安卓，提供 V2Fly 内核路线。三款客户端均属于开源项目，界面负责组织操作，实际协议能力仍与打包内核和配置有关。桌面和手机可以使用兼容的同一订阅，但本地网络设置不应照搬。
安卓的系统 VPN 授权、桌面的系统代理和 TUN 权限是不同机制。迁移时可以复用连接参数，不能据此假定全部应用都已经接入。若只希望比较客户端定位，先看操作系统、内核路线和配置管理习惯；若要判断某个具体协议是否可用，则继续核对传输与安全参数。选型不以界面复杂程度或设置数量作为速度依据。
开源协议与使用责任
开源意味着代码在相应许可证条件下开放，允许按许可证约定阅读、使用或修改。V2Fly 的 V2Ray 核心主要采用 MIT 许可证，Xray 核心主要采用 MPL-2.0 许可证；客户端、内核与附带组件的授权应分别查看项目随附说明，不能用一个项目的许可证替代整个安装包的授权判断。需要再分发或修改时，应保留适用声明并核对具体义务。
代码开放不代表每份订阅都可信，也不能代替对配置来源的判断。订阅地址可能携带访问凭据，分享链接通常包含服务器地址与认证参数。排查问题时可保留错误类型、内核名称和相关设置，删除能够识别账户的信息。使用客户端还应遵守所在地法律与所使用网络的管理要求，本文档仅讨论软件安装和技术配置。
更新分为客户端、内核与规则数据
客户端更新会影响界面和配置生成逻辑，内核更新会影响协议解析与转发，GeoIP、GeoSite 数据更新则会影响规则集合。三类更新解决的问题不同。遇到域名分流结果变化时，应检查规则引用与数据库；遇到配置无法解析时，应先看日志和内核兼容性。不要把所有问题都归因于客户端太旧，也不要同时更新全部组件后再猜测原因。
更新前保存订阅分组和手动维护的规则，确认能够恢复旧设置，再按下载页的包类型与架构选择入口。本站整理安装与配置路径，不是客户端官方开发团队，也不提供服务端连通性保证。教程中的界面文字用于定位功能，具体布局可能随客户端变化；有差异时，以当前界面与日志输出为检查依据。
配置与排查记录
近期技术文章
先明确症状，再进入对应步骤。下面三篇分别处理应用入口、客户端启动与规则匹配，避免把不同层面的问题混在一起。
系统代理已开启却不生效：浏览器与终端分别排查的步骤
浏览器不走代理多与扩展或代理设置覆盖有关，终端不走代理则要手动设置环境变量，本文分两条线给出可照做的检查顺序。
阅读文章 →v2rayN 打不开或启动闪退：.NET 运行库、目录权限与内核文件排查
按出现频率整理客户端启动即退的原因：缺少 .NET 桌面运行库、安装目录无写入权限、内核文件缺失被拦截，逐项给出处理办法。
阅读文章 →V2Ray 分流规则实战：国内网站直连、海外流量走代理的路由配置
以 v2rayN 自定义路由为例，逐条拆解 domain、ip、outboundTag 字段，演示直连、代理、拦截三类规则的排序与常见写法。
阅读文章 →安装客户端后，为什么还没有可用配置？
客户端不自带个人服务端账户。需要准备有效订阅或单条分享链接，导入并选择配置后才能连接。订阅更新失败时先检查地址格式、来源状态与网络可达性，不要随意把带凭据的地址交给在线转换服务。操作路径见使用文档。
系统代理与“全局”路由是一回事吗？
不是。系统代理决定遵循系统设置的应用是否把请求交给本地入口；“全局”通常是客户端路由预设，决定已进入内核的流量使用哪个出站。应用没有接入时，切换路由模式不能解决入口问题。相关概念见术语表。
订阅转换能补齐客户端不支持的功能吗？
转换主要改变配置表示方式，不能让内核获得原本缺少的协议能力，也可能丢失某些专有字段。优先使用来源提供的兼容订阅；确需转换时确认工具来源、字段保留情况与凭据处理方式，再逐项检查结果。更多说明见帮助中心。
一台设备正常，另一台设备不通，如何缩小范围？
先比较活动配置与内核支持，再核对设备时间、网络环境和应用代理入口。不要把正常设备的整个配置目录直接覆盖到另一平台。分享链接可以传递连接参数，本地权限、DNS 与路由仍需分别确认。分平台步骤见安装大全。