DESKTOP · V2RAYN
Windows
提供桌面版与经典 WPF 版。新安装可先选择跨平台界面的桌面版；习惯传统窗口布局、服务器列表与托盘菜单的用户，可以查看经典版入口。安装前确认系统架构，并保留客户端配置目录的读写权限。
前往下载
04 SUPPORTED PLATFORMS
02 CORE FAMILIES
PROJECT V ECOSYSTEM
OPEN SOURCE CLIENTS
PLATFORM ENTRY
按操作系统进入安装包页面
下载页按平台列出可用客户端、安装包类型与选择说明。桌面系统统一使用 v2rayN，Android 可根据所需内核在 v2rayNG 与 v2flyNG 之间选择。
DESKTOP · V2RAYN
macOS
安装包按 Apple Silicon 与 Intel 处理器区分。可在系统信息中查看芯片名称，再进入对应入口。首次启动后需要按系统提示授予网络配置权限；导入订阅与选择活动服务器的流程与其他桌面平台保持一致。
前往下载MOBILE · V2RAYNG / V2FLYNG
Android
v2rayNG 使用 Xray 内核，适合常见协议与路由配置；v2flyNG 使用 V2Fly 内核，可作为另一套实现选择。多数近年设备可使用 arm64 安装包，无法确认架构时再查看通用包。连接时系统会显示网络连接授权提示。
前往下载DESKTOP · V2RAYN
Linux
v2rayN 提供适配常见发行版包管理体系的安装包。Debian、Ubuntu 系通常选择 deb，Fedora、RHEL 系通常选择 rpm；x64 与 arm64 还需按处理器架构区分。安装后可从桌面菜单启动，再完成订阅与代理模式配置。
前往下载LINK INSPECTION
链路节点检修单
从配置来源到出口验证逐段检查。左侧选择当前环节，右侧说明该环节解决的问题、操作位置与核对参数。
SOURCE / UPDATE
订阅导入：把服务器列表交给客户端管理
订阅地址不是客户端生成的内容，而是配置提供方交付的一组服务器资料。将地址添加到正确分组后执行更新，客户端会解析协议、地址、端口、传输与安全参数，并生成可选择的服务器列表。更新后先核对分组名称与节点数量是否变化，再选择一个活动服务器。若列表为空，应检查地址是否完整、分组是否选对以及更新日志，而不是反复切换代理模式。
多条订阅同时存在时，建议按来源建立分组并添加清晰备注。这样可以分别更新、筛选和排序，避免同名服务器混在一个列表中。订阅内容变化不会自动替换用户自己创建的本地配置，手工条目与远程条目应分开管理。
source: subscription · action: update · result: server list
INBOUND / SYSTEM
系统代理：接管遵循操作系统设置的应用
系统代理模式会把操作系统的代理地址指向客户端本地监听端口，浏览器及大多数遵循系统设置的桌面应用会据此发送流量。它的边界清晰、启停直接，适合作为首次连接时的默认选择。若客户端显示运行中但应用仍直连，应检查系统代理是否真正开启、应用是否使用独立代理配置，以及本地监听端口是否被其他程序占用。
退出客户端前先恢复系统代理，可以避免操作系统保留已经失效的本地地址。部分命令行工具不会读取系统代理，需要单独配置环境变量或改用 TUN；这不是服务器故障，而是应用接入链路不同。
inbound: local socks/http · scope: system-aware applications
VIRTUAL INTERFACE / ROUTE
TUN 模式：覆盖不读取系统代理的连接
TUN 通过虚拟网络接口接收流量，可覆盖游戏启动器、命令行程序及不遵循系统代理设置的应用。它比系统代理接入范围更广，但同时依赖虚拟网卡、路由表、DNS 与权限配置。启用前应退出其他创建虚拟网络接口的工具，并确认客户端具备修改网络设置所需的权限。若启用后局域网访问异常，应先检查绕过私有地址的规则。
TUN 不等于必须把所有连接送往同一出口。最终走直连、代理或阻断仍由路由规则决定。排查时要区分“流量有没有进入客户端”和“进入后匹配了哪条规则”这两个问题。
capture: virtual interface · decision: routing rules · dns: coordinated
RULESET / OUTBOUND
路由分流：按目标决定直连或代理出口
路由规则根据域名、地址、端口、协议或进程等条件选择出口。常见目标是让局域网与本地服务保持直连，将特定网络请求交给代理，同时对不需要的连接执行阻断。规则通常从上到下匹配，因此更具体的条件应放在通用条件之前。修改后不要只看客户端是否已连接，还要查看目标请求实际命中了哪条规则。
预设规则适合建立基础结构，长期使用时仍应理解 direct、proxy 与 block 三类出口的含义。规则越多不代表结果越准确；重复条件、顺序冲突和过宽匹配反而会增加排查成本。
match: domain / ip / port / process · outbound: direct / proxy / block
EVENT / DIAGNOSIS
日志定位：区分配置、端口、DNS 与远端错误
日志是判断断点位置的首要依据。内核无法启动时，优先查找配置解析失败、字段缺失和端口占用；能够启动但无法建立连接时，再看域名解析、TLS 握手、超时与路由匹配信息。记录报错出现的时间和触发动作，可以把启动阶段的问题与访问特定目标时的问题分开，避免一次修改多个设置后无法判断哪项生效。
排查应从本机监听、系统接入、规则匹配、远端连接依次推进。每次只改变一个变量，并在修改后重新触发同一请求。相比盲目重装，这种顺序更容易保留有效配置并定位真正故障点。
order: startup → inbound → dns → routing → outbound
QUICK START
从安装到验证的三步路径
首次配置先保持流程简单：选对安装包、导入可用配置、用系统代理完成一次基础验证。基础链路确认后，再处理 TUN 与复杂路由。
-
01
按平台与架构选择客户端
Windows、macOS 与 Linux 使用 v2rayN；Android 可选择 v2rayNG 或 v2flyNG。下载前先确认处理器架构和安装包格式。桌面系统还应确认当前账户能够写入配置目录，并允许客户端创建本地监听端口。安装完成后先正常启动一次，不要在尚未看到主界面时同时修改防火墙、DNS 和路由设置。
-
02
添加订阅并选择活动服务器
在订阅管理中填写完整地址，为来源设置易识别的分组名称，然后执行更新。服务器列表出现后选择一个条目设为活动服务器。此时应核对协议、地址、端口与传输字段是否被正常解析。订阅地址负责交付配置，客户端负责读取和运行；如果更新失败，应先查看订阅操作的日志，而不是直接判断内核不可用。
-
03
开启系统代理并逐段验证
先启动内核，再开启系统代理，随后使用遵循系统代理设置的浏览器发起测试请求。若无法访问，按本地端口、系统代理、DNS、路由规则、远端连接的顺序检查。基础模式验证成功后，再根据应用覆盖范围决定是否启用 TUN。这样可以把虚拟网卡问题与服务器配置问题分开，减少相互干扰。
OPEN ECOSYSTEM
Project V、V2Fly 与 Xray 的关系
客户端、内核与配置来源是三层不同组件。理解它们的边界，才能正确判断更新、兼容与故障发生在哪一层。
Project V 是协议与工具生态的起点
Project V 形成了一套围绕代理协议、传输方式、路由规则和本地入站的工具生态。图形客户端并不是协议本身，它负责把订阅、服务器列表、系统代理、路由和日志整理成可操作界面，再将生成的配置交给内核运行。用户在界面中选择服务器或切换模式时，实际发生的是客户端重新组织配置并控制内核进程。
这一区分直接影响排查方式。订阅无法更新通常属于配置来源或客户端网络请求问题；内核启动后立即退出，多与配置字段、端口或运行环境有关；只有特定目标无法访问，则更可能涉及 DNS、路由匹配、传输参数或远端状态。把所有现象统称为“客户端坏了”，会掩盖真正的断点。
V2Fly 与 Xray 属于同一技术谱系中的不同内核家族
V2Fly 延续 Project V 生态中的核心实现与配置体系，Xray 则在兼容既有概念的同时扩展了部分协议、传输与底层能力。两者都围绕入站、出站、路由、DNS 和策略等结构组织配置，但具体字段支持和行为可能随实现不同而变化。导入配置时，客户端需要把订阅内容转换为当前内核能够识别的格式。
v2rayN 可以管理桌面平台上的相关内核与配置流程；v2rayNG 主要采用 Xray 内核；v2flyNG 对应 V2Fly 内核。选择客户端时，不需要把图形界面和内核混为一体。界面决定操作方式，内核决定配置执行与协议处理，订阅则提供服务器参数。三层保持兼容，链路才能正常建立。
开源协议与社区维护提供可检查的更新轨迹
这三款客户端均以开源方式维护，功能变化、配置格式调整和问题修复由维护者与社区持续推进。开源属性的实际意义在于实现与变更可以被技术社区检查、讨论和复现，而不是用一句抽象标签替代安全判断。安装新构建后，仍应阅读变更说明，确认配置目录、内核选择、权限要求和系统代理行为是否发生调整。
客户端更新与订阅更新也不是同一件事。客户端更新改变程序本身及其支持能力；订阅更新只刷新服务器配置。遇到协议字段不被识别时，需要判断是订阅内容有误、客户端解析能力不足，还是当前内核不支持对应参数。按层次定位，比频繁删除全部配置更可控。
COMMON QUESTIONS
常见问题精选
以下问题覆盖首次使用中最容易混淆的配置边界。完整分类与排查路径收录在疑难解答页面。
v2rayN 与 V2Ray 内核是同一个程序吗？
不是。v2rayN 是图形客户端，负责订阅、服务器列表、代理模式、路由和日志管理；内核负责解析配置并处理实际连接。客户端可以根据配置与平台调用相应内核，因此界面启动成功不代表内核一定已经正常运行。遇到连接问题时，应同时检查主界面状态与内核日志。
订阅导入后为什么还需要手动选择服务器？
订阅更新只是把远程配置转换为服务器列表，不会替用户判断当前应该使用哪一个条目。更新完成后需要在正确分组中选择活动服务器，再启动内核。若客户端提供自动选择策略，也应先完成一次手动连接验证，确认配置本身能够正常运行。
系统代理与 TUN 模式应该先用哪一个？
首次配置建议先用系统代理，因为接入范围和故障边界更容易观察。确认浏览器等常规应用能够连接后，再根据命令行工具、游戏或其他应用的需求启用 TUN。TUN 涉及虚拟网络接口、路由与 DNS，出现问题时应检查权限和网络接口冲突。
客户端显示运行中但网页打不开，先检查什么？
先确认已选择活动服务器，然后检查系统代理是否开启、本地监听端口是否存在、浏览器是否使用独立代理。接着查看 DNS、路由命中与远端连接日志。按链路顺序逐项检查，可以区分请求没有进入客户端、规则选错出口和远端连接失败三类情况。
TECHNICAL NOTES
最新配置与故障排查文章
文章按操作问题组织，重点记录可复现的检查顺序、日志关键词和配置边界。