Windows
v2rayN · Desktop / WPF
桌面版采用跨平台界面，经典 WPF 版保留熟悉的 Windows 操作布局。首次安装先查看系统要求，并将程序放在有写入权限的目录。导入订阅后选择活动配置，启用自动配置系统代理，再用浏览器验证连接。两种界面的菜单位置可能不同，但订阅、路由和本地监听端口的检查顺序一致。
前往下载 →V2Ray 客户端，按平台选择
桌面使用 v2rayN，Android 首选 v2rayNG。先选系统与架构，再按教程导入已有配置。
Android
v2rayNG · v2flyNG
首选使用 Xray 内核的 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。主流设备通常选择 arm64，架构不明确时查看通用包说明。首次启动连接需确认系统 VPN 授权；分应用代理与后台电池限制会影响实际接管范围。更换客户端前先保存配置，两款应用的设置不会自动互相同步。
前往下载 →macOS
v2rayN · Apple Silicon / Intel
先在“关于本机”中查看芯片类型，再选择 Apple Silicon 或 Intel 安装包。安装后按系统提示处理应用打开权限，确认客户端已经启动内核，再启用系统代理。浏览器能连接而其他应用不能连接时，先确认该应用是否读取系统代理；只有确实需要接管更多流量时，再了解 TUN 的权限与路由要求。
前往下载 →Linux
v2rayN · deb / rpm
按发行版的软件包体系选择 deb 或 rpm，并核对设备使用 x64 还是 arm64 架构。图形客户端负责管理配置，桌面环境是否采用系统代理仍需单独确认。终端程序也可能使用自己的代理参数，不能仅凭浏览器结果判断所有请求都已接管。出现启动失败时，先检查依赖和目录权限，再查看客户端日志。
前往下载 →订阅、路由与代理设置
把配置来源、请求去向和流量接管分开理解。每次只调整一类设置，验证后再继续。
订阅分组
按来源管理，更新后再选配置
订阅链接是获取一组连接配置的入口，不是单个节点地址。先在客户端建立订阅分组，再填写完整链接并执行更新。不同来源分开保存，便于确认哪些配置由哪条订阅生成，也能避免手动添加的项目混在一起。更新完成后检查分组是否出现可选配置，再设为活动服务器。与逐条维护分享链接相比，分组更新更适合配置会定期调整的情况，但仍需确认来源有效。
订阅导入教程 →分享链接导入
区分订阅地址与单条配置
单条分享链接通常包含协议、地址、端口和传输参数，适合临时添加或核对某一项配置。复制时保留完整内容，避免换行、空格或聊天工具自动截断。导入后检查协议与传输类型是否被正确识别，再确认当前客户端和内核支持这些选项。分享链接与订阅地址的导入入口可能不同，粘贴到错误位置会得到空列表或解析提示；不要把一次解析失败直接判断为网络故障。
查看导入步骤 →节点测试
先确认可连接，再判断使用体验
节点测试只能反映特定测试方式与当时的网络条件，不能直接等同于浏览器或其他应用的实际体验。先查看测试是否成功，再用目标应用访问需要的服务。若全部超时，优先检查本机网络、内核启动状态和订阅有效性；若只有个别配置失败，再核对服务端地址与传输参数。不同测试入口的结果不宜混在一起排序，更不应仅凭一个数值反复切换配置。
查看连接诊断 →订阅更新失败
从链接状态查到更新路径
订阅列表为空与已有节点连接失败属于不同环节。先检查链接是否过期、是否完整复制，再看客户端提示的是请求失败还是内容解析失败。当前网络无法访问订阅地址时，可在已有可用连接的前提下尝试通过代理更新。若请求成功但没有生成配置，需要核对返回内容及格式支持情况。订阅链接可能携带访问权限，分享排查截图时应遮住完整地址，不要将它公开粘贴到讨论区。
订阅失败自查 →预设路由
先用预设确认请求去向
路由规则决定进入内核的请求走代理、直连还是被阻止，它与系统代理负责的流量接管不是同一件事。首次使用先选适合需求的预设，验证常用网站与本地服务，再考虑自定义。全局通常表示把匹配范围内的请求交给代理出口，并不表示所有应用都已进入客户端。排查分流问题时，先确认应用请求进入内核，再看命中了哪条规则，避免在错误的环节反复切换模式。
路由设置入门 →规则顺序
具体规则在前，兜底规则在后
多条路由规则同时可能匹配一个请求时，顺序会直接影响结果。添加自定义域名或地址规则前，先了解当前内核采用的匹配方式，再检查是否已有更靠前的宽泛规则覆盖它。需要直连的本地资源应明确处理，不要靠频繁切换全局模式维持访问。修改前保存原有配置，每次只增加少量规则，并用实际请求确认命中结果。规则越多不代表分流越准确，长期不用的重复条目应及时整理。
理解路由分流 →域名与 DNS
把名称解析与出口选择一起检查
网站无法打开不一定是节点不可用，也可能发生在域名解析阶段。域名规则、地址规则和域名策略共同影响匹配过程，只有地址信息的请求与保留域名的请求可能得到不同结果。先检查日志中的解析错误，再核对 DNS 请求是否具备可达路径。不要同时修改系统 DNS、浏览器加密 DNS 和客户端 DNS，否则很难判断是哪项改变起效。保留一套可恢复的基础设置，逐项验证更容易定位原因。
排查 DNS 问题 →本地资源直连
保留局域网与本机服务的访问路径
打印机、路由器管理页和局域网文件服务通常不需要经过远端代理。启用新路由或 TUN 后若这些资源无法访问，先确认地址属于本地网络，再检查相应的直连与排除设置。设备发现与普通网页访问使用的流量类型可能不同，因此网页能打开并不代表局域网功能全部正常。修改规则时不要盲目扩大地址范围；先记录受影响的目标，再用最小范围的规则进行验证并保留回退方案。
查看网络诊断 →自动配置系统代理
先启动内核，再让应用读取代理
自动配置系统代理会让支持该设置的应用把请求发往客户端本地监听地址。先选择有效配置并确认内核启动成功，再启用这一选项。若浏览器有单独的代理扩展，需要检查它是否覆盖系统设置。清除系统代理只修改系统层的代理入口，不会删除订阅与节点；不改变系统代理则保留原有系统设置。退出客户端后网络异常时，先检查是否还残留指向已关闭端口的代理配置。
设置系统代理 →TUN 模式
为不读取系统代理的应用接管流量
TUN 借助虚拟网络接口处理流量，适合普通系统代理无法覆盖的应用，但会引入权限、路由与 DNS 等额外配置。开启前先确认同一节点在普通代理模式下可以使用，再按客户端提示授予必要权限。若连接异常，临时关闭其他 VPN 或同类流量接管工具进行对照。TUN 不是修复无效订阅的开关，也不能保证每种流量都按预期转发；出问题时先退回已验证的基础模式。
查看 TUN 排查 →本地监听端口
客户端与应用使用同一组入口参数
本地监听端口是应用进入客户端的入口，不是远端服务器的端口。图中的 10808 仅用于说明，应以当前参数设置实际显示的值为准。端口被其他程序占用时，先定位冲突进程，再决定关闭重复实例还是修改监听端口。修改后同步检查系统代理、浏览器和手动配置的应用，并确认代理协议类型正确。不要只改一处数字就结束，否则内核已启动也可能仍然没有请求进入。
排查端口占用 →Android 分应用代理
明确哪些应用需要进入 VPN 接口
Android 的 VPN 模式与桌面系统代理入口不同，首次启动需要确认系统授权。分应用代理可以缩小接管范围，但应先看清当前列表表示包含还是排除，避免勾选结果与预期相反。浏览器可用而其他应用无法连接时，先检查应用是否被纳入范围，再检查路由。锁屏后断开则继续查看后台运行和电池优化设置。只允许一个接管工具工作进行测试，更容易判断是否存在 VPN 接口冲突。
查看移动端步骤 →客户端与内核
界面管理配置，内核处理连接
客户端提供订阅、设置和日志界面，内核负责解释配置并建立网络连接。两者的更新节奏与功能范围不一定完全一致，因此界面能导入某个字段，不代表当前内核一定支持对应能力。遇到启动错误时先阅读日志，判断是配置生成失败还是内核拒绝参数。与只看应用名称相比，确认实际运行的内核更有助于排查协议兼容问题，也能避免把界面差异误认为连接机制不同。
查看内核名词 →Xray 与 V2Fly
按配置需求判断兼容范围
Xray 与 V2Fly 属于相关但独立演进的内核项目，协议实现、配置字段及新功能支持可能不同。选择内核时以服务端给出的配置要求为依据，不要只凭名称或发布时间判断优劣。同一个订阅中也可能包含不同需求的配置，切换前应核对协议与传输组合。若某项配置仅在特定内核下工作，保留这个已验证的组合，再单独研究差异，比同时修改多个传输选项更容易得到可靠结论。
查看客户端对比 →切换前备份
保留配置，让测试可以回退
切换内核或升级客户端前，先保存订阅分组、自定义路由和必要的参数设置。记录当前可用配置，但不要在公开笔记中保存凭据。更新后先用原有配置验证基础连接，再测试需要的新功能。若启动失败，比较日志中的错误字段，而不是立即覆盖全部设置。配置格式可能随项目演进发生变化，备份的作用是保留恢复依据；恢复时仍需确认目标版本能正确识别相应的设置内容。
查看启动诊断 →三款客户端选型
平台在前，内核需求在后
桌面平台优先选择 v2rayN，在统一的配置管理方式下处理订阅与代理设置。Android 首选 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。选择客户端首先取决于设备平台，其次是配置要求和常用设置，不必为一个界面差异频繁迁移。迁移时可重新导入有效订阅，但路由、分应用列表和权限通常需要重新确认；这些本机设置不能依靠节点分享链接完整携带。
按需求选择客户端 →Project V、V2Fly 与 Xray
区分开源项目、连接内核与图形客户端，再决定下载什么、修改哪里。
V2Ray 源于 Project V 的模块化网络代理设计。它把入站、出站、路由和传输等部分分开组织，让不同请求可以按规则交给不同出口。今天搜索 V2Ray，常会同时看到 V2Fly、Xray、v2rayN 与 v2rayNG；这些名称处在不同层次，不能简单当成同一个安装包的不同叫法。先理解各自职责，遇到问题时才能把检查范围缩小到正确位置。
对日常使用而言，图形客户端是主要操作入口。订阅提供连接配置，内核读取配置并建立连接，系统代理或 VPN 接口决定哪些应用请求能进入客户端，路由再决定这些请求的去向。四个环节彼此关联，却不能相互代替：订阅成功不等于连接成功，连接成功也不等于所有应用都已使用代理。按这个顺序验证，比反复导入订阅或重装应用更有针对性。
从模块化设计理解配置
Project V 的思路不是把所有网络行为压成一个开关，而是将不同任务拆成可组合的模块。入站接受应用请求，出站负责连接目标或代理服务器，路由负责选择出口，传输层则约定连接如何承载。这种分工也是客户端里出现订阅、路由、DNS、监听端口等多个设置入口的原因。页面上的名称很多，但每项设置都有对应的作用范围。
例如，本地监听端口改变的是应用接入客户端的位置；远端服务器端口改变的是客户端连接服务端的位置。两者都叫端口，却不能互相替代。类似地，全局路由影响进入内核后的选择，不会自动让一个忽略系统代理的应用开始使用代理。理解这些边界后，可以先用基础设置建立连接，再逐步增加分流与流量接管能力。
查找技术资料时，应同时留意资料对应的客户端、内核与设置层级。某篇文章讨论的是内核配置文件，并不意味着其中每个字段都能原样填进图形界面的某个输入框。先识别概念，再对照当前界面，能减少把不同项目说明混用造成的错误。
查阅专业名词 →V2Fly 与 Xray 分别演进
V2Fly 社区持续维护 V2Ray 相关实现，Xray 则从相关代码基础发展为独立演进的内核项目。它们有共同的技术背景，也有各自的实现选择与功能节奏。对使用者来说，关键不是把两个名称排出高低，而是确认当前节点所需的协议、传输和安全选项是否被正在运行的内核支持。
v2rayN 可根据具体版本与配置使用相应内核；Android 的 v2rayNG 以 Xray 内核为主要连接基础，v2flyNG 则提供 V2Fly 内核方向的选择。切换内核不是万能修复步骤。若错误来自订阅链接失效、系统时间偏差或本地端口冲突，换一个内核往往仍会遇到同样的症状。应先看日志指向的环节，再决定是否需要调整实现。
服务端给出的参数应作为兼容性核对依据。不要为消除一条报错而随意关闭证书验证，也不要把无法识别的字段全部删除后继续使用。先保留原始配置，确认客户端与内核是否匹配；无法确定参数含义时，再查阅对应的术语说明与问题诊断。
按症状诊断问题 →三款客户端与各自的许可证
v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端，应用本身可免费使用。开源意味着项目代码与相应许可证可供查阅，不意味着客户端会自动提供远端服务器、订阅额度或连接配置。安装应用后，仍需使用有权访问的订阅或自行管理的服务端配置，才能完成实际连接。
开源生态并不是所有组件共用一份许可证。v2rayN 项目采用 GPL-3.0，v2rayNG 与 v2flyNG 项目采用 GPL-3.0，V2Fly 与 Xray 相关内核项目采用 MPL-2.0；分发包内的其他组件还可能包含各自的许可说明。普通使用与二次分发涉及的义务不同，计划修改或重新分发时，应阅读所用项目及对应组件的许可证全文。
配置管理与网络服务也应分别看待。客户端能保存和解析订阅，不代表它能决定订阅是否有效，更不能替代服务端运行维护。发生连接问题时，先确认是应用设置、配置内容还是远端状态导致，再选择对应的处理方式。这样既能保留已有设置，也能向配置提供方描述清楚实际症状。
比较三款客户端 →分开处理应用、内核与订阅更新
应用更新可能调整界面与配置管理逻辑，内核更新可能改变协议能力与参数支持，订阅更新则主要刷新连接配置。这三种更新作用不同，不宜在排查过程中一次全部执行。若原本可以连接，先记录发生故障前做过的改动，再选一个环节验证，才能判断问题是否由更新引起。
准备升级前，保存订阅分组与自定义路由，确认安装包适用于当前系统和处理器架构。升级后先使用原有配置测试基础连接，再检查系统代理与需要的应用。TUN、分应用代理等扩展设置应放在基础连接验证之后。若只有新增功能异常，先恢复到已验证的模式，再对照日志检查权限或兼容问题。
日志适合定位失败阶段，但其中可能包含服务器地址、订阅链接或其他敏感参数。分享问题时，只保留必要的错误信息并遮住凭据，同时说明设备平台、运行模式和受影响的应用。清楚的复现步骤比一整张未处理的配置截图更有帮助，也能避免在讨论过程中泄露访问权限。
查看常见问题 →V2Ray 配置与排查文章
从具体症状进入：端口占用、证书报错、订阅解析失败。
v2rayN 本地端口被占用：定位冲突进程并修改 10808 监听端口
客户端启动报端口占用或系统代理不生效时，用系统命令找出占用 10808、10809 的进程，在参数设置里改本地监听端口，并同步调整浏览器与系统代理。
阅读端口排查 →V2Ray TLS 握手失败与证书报错：系统时间偏差和 SNI 填写排查
出现证书无效、握手失败、x509 报错时，先校准系统时间，再核对 SNI、伪装域名与 allowInsecure 设置，讲清这些报错背后的原理和对应修复方法。
阅读证书排查 →V2Ray 订阅更新失败与解析为空：链接格式、编码与更新方式自查
订阅导入后列表为空、提示解析失败或更新一直不成功时，从链接是否过期、Base64 编码、分享链接格式到通过代理更新订阅，逐项给出自查步骤。
阅读订阅自查 →