v2rayN
桌面版使用跨平台界面，经典 WPF 版保留熟悉的窗口布局。先在系统设置中确认处理器类型，再阅读安装说明；切换两种界面前备份订阅分组和自定义路由，避免把界面差异当成连接故障。
前往下载 →按系统选择安装包
先确认操作系统和处理器架构，再选择客户端。安装包入口集中在下载页，首页只负责选型与配置指引。
桌面版使用跨平台界面，经典 WPF 版保留熟悉的窗口布局。先在系统设置中确认处理器类型，再阅读安装说明；切换两种界面前备份订阅分组和自定义路由，避免把界面差异当成连接故障。
前往下载 →在“关于本机”查看芯片名称，Apple Silicon 与 Intel 使用各自的安装包。首次启动遇到系统提示时，先确认下载来源并阅读提示内容；安装完成后检查网络代理是否指向客户端当前的本地端口。
前往下载 →优先了解使用 Xray 内核的 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。多数较新的安卓手机可选 arm64，架构不明确时查看通用包说明。首次连接需确认系统 VPN 授权，并检查是否已有其他应用占用 VPN 通道。
前往下载 →Ubuntu、Debian 桌面通常选择 deb，Fedora 等发行版通常选择 rpm，同时区分 x64 与 arm64。图形客户端适合桌面环境；终端程序是否使用代理取决于自身配置，不能只凭桌面系统代理开关判断。
前往下载 →客户端负责读取配置、调用内核和管理本机代理，不会在安装后自动生成可用的远程连接。准备由可信来源提供的订阅地址或单条配置，确认使用权限与有效期，再按教程导入。订阅链接可能包含访问凭据，不要放进公开截图，也不要提交给来源不明的在线转换页面。确实需要 V2Ray 订阅转换时，先核对目标客户端支持的格式，并优先使用配置提供方明确支持的导出方式。
首次配置建议只启动一个客户端，保留默认监听端口，暂不叠加浏览器代理扩展或其他接管网络的工具。先验证订阅能够导入、内核能够启动，再启用系统代理；基础连接成立后再调整分流与 TUN。这样每次只改变一个环节，出现异常时能明确回退位置，而不是同时猜测节点、DNS 和权限是否都有问题。
按设置项理解连接路径
界面名称可能随平台和版本调整。先理解设置的作用，再对照客户端中的同类选项，不把桌面菜单原样套到安卓端。
节点列表为空或更新后没有变化时，先打开“订阅分组设置”，检查地址是否完整、分组是否启用，以及订阅是否仍有效。按来源分组，能避免更新时混淆不同配置。若当前连接不可用，可尝试“更新订阅(不通过代理)”；若地址只在特定网络路径下可访问，则应使用对应通道。更新成功后再检查实际导入结果，不把请求完成等同于节点可连接。相比逐条手工维护，分组更便于统一更新，但不会自动修复失效地址。
查看教程 →同一节点能访问部分网站，却在另一些网站超时时，先确认目标域名命中了哪条路由。规则通常按顺序匹配，范围较大的规则可能提前截住请求。“IPIfNonMatch”表示域名规则未匹配时，再解析目标地址并尝试匹配 IP 规则，并不等同于所有请求都先解析。先使用可理解的预设，再添加少量自定义规则；每次修改后复测同一个目标。路由负责决定出口，不能替代节点连通性检查，也不能靠规则修复远端认证错误。
查看教程 →IPIfNonMatch系统代理只影响愿意读取系统代理设置的应用，不代表所有程序都会经过客户端。“自动配置系统代理”写入本机代理地址，“清除系统代理”移除相关设置，“不改变系统代理”则保留现状。TUN 通过虚拟网络接口接管流量，通常还涉及权限、路由与 DNS。先验证普通代理连接，再决定是否开启 TUN；不要一开始同时启用多种接管方式。终端、浏览器扩展和安卓 VPN 各有自己的入口，应分别确认实际请求路径。
查看教程 →图形客户端与内核承担不同任务：前者管理配置，后者处理协议和网络连接。v2rayN 可在支持的配置场景中调用 Xray 或 sing-box，但具体入口与支持范围取决于版本和平台。遇到不支持的传输或参数提示时，先记录日志中的错误，再核对配置要求，避免反复切换内核。安卓端也要区分使用 Xray 的 v2rayNG 与使用 V2Fly 的 v2flyNG。切换只能解决适用的兼容问题，不会让过期订阅或错误凭据恢复有效。
查看教程 →Project V · V2Fly · Xray
把客户端、内核、协议和订阅拆开理解。下载图形界面只是第一步，可用连接还取决于配置与网络环境。
V2Ray 来自 Project V 生态，核心思路是通过配置组合入站、出站与路由，让应用请求经过明确的处理路径。V2Fly 延续了 V2Ray 相关内核的社区维护，Xray 则从相关代码基础发展出自己的实现与功能。它们有历史联系，但不能因此假定所有参数、协议扩展和配置文件都可直接互换。
协议名称描述通信约定，内核负责实现协议，图形客户端再把常用操作整理成菜单。看到 VMess、VLESS、Trojan 或 REALITY 等名称时，先核对配置要求与内核支持；不要只看客户端名称相似就导入使用。传输方式、TLS 参数与服务器端配置需要对应，单独改动一侧通常不能完成兼容。
排查时记录“哪个客户端、哪个内核、什么连接方式、在哪一步失败”比笼统描述“V2Ray 不能用”更有效。日志中的启动失败与请求超时属于不同层级，前者应先查配置和监听，后者再查远端、解析与出口。
v2rayN 面向桌面使用场景，集中提供服务器列表、订阅分组、系统代理和路由管理。v2rayNG 面向安卓设备，使用 Xray 内核，并通过系统 VPN 接口承接应用流量。v2flyNG 同样面向安卓，使用 V2Fly 内核，适合明确需要相应内核行为或兼容范围的场景。三者均属于开源客户端，但并非同一个程序的不同皮肤。
桌面与手机可以使用同一来源提供的兼容配置，但本地代理端口、后台运行方式和权限要求不同。桌面端的“自动配置系统代理”不能替代安卓 VPN 授权，安卓连接按钮也不对应桌面全部网络设置。迁移时先导入配置，再按目标设备重新确认连接方式。
本站整理下载入口和中文操作说明，不是这些项目的官方开发站。搜索“v2rayN 官网”或“v2rayNG 官网”时，应继续辨别站点身份、软件项目和配置提供方，三者承担的责任并不相同。
开源意味着软件代码按相应许可证公开，使用、修改和再分发应遵循具体项目的许可条款。客户端、内核以及附带组件可能采用不同许可证，涉及二次分发时应分别阅读授权说明，不能用“开源”两个字替代许可判断。普通使用者也应区分软件本身免费与远程服务可能收费这两件事。
订阅通常承载一组连接配置，可能含服务器地址、用户标识和认证信息。公开问题截图时，应遮挡订阅地址和敏感参数，只保留错误类型、菜单位置与必要的环境信息。不要为了让别人复现故障就完整公开订阅；经过脱敏的日志与操作顺序，通常更利于定位问题。
配置能够导入不等于服务有效，也不等于每种应用都已经接入代理。确认来源、兼容性和使用权限后，再通过实际访问验证连接。遇到证书错误时先检查系统时间、目标名称和配置匹配关系，不把关闭安全检查当成通用解决办法。
图形客户端、内核和规则数据可能独立更新。菜单增加一个选项，并不代表所有旧配置都需要同步修改；协议支持变化也可能来自内核而非界面。更新前记录当前工作状态，备份订阅分组、自定义规则和必要设置，再阅读与所用平台有关的变更说明。
更新后先验证最小配置：启动客户端，确认内核正常运行，使用一个已知可用的配置访问固定目标。确认基础连接后，再恢复自定义路由、TUN 和后台启动。若问题只在更新后出现，应保留具体错误和触发步骤，避免同时删除配置、替换内核和重置网络，导致无法判断原因。
处理订阅失败时先看地址与请求通道；处理网页打不开时先看客户端是否监听、应用是否走代理；处理速度慢时再比较网络与远端负载。这种从入口到出口的顺序，比反复重装更容易保留有效信息。复杂情况可继续查阅疑难手册。
先确认列表中有可用配置，并已选择当前服务器，再查看内核启动日志。内核正常后检查“自动配置系统代理”，核对浏览器是否被扩展覆盖。若只有一个应用失败，应先检查该应用的代理入口，而不是立即更换全部节点。进一步按配置教程完成连接验证。
先识别占用者，不要直接结束未知系统进程。检查是否重复启动客户端，或另一个代理程序正在使用相同端口。确需修改“本地混合监听端口”时，记录新值，重启服务，并同步更新手工设置的浏览器与应用代理。已写入的旧端口不会因为界面改值就自动全部消失，详见疑难解答。
先关闭 TUN，确认普通代理模式是否可用。若普通模式正常，再单独检查 TUN 所需权限、虚拟接口以及其他网络工具是否冲突。保留当前 DNS 与路由设置的记录，每次只调整一项并复测。若退出客户端后仍不能访问网络，还要检查遗留系统代理，详见疑难手册。
订阅更新是向地址请求配置，节点连接则是使用配置访问远程服务器，两者可能走不同网络路径。先确认订阅地址有效、格式受支持，再比较通过代理与不通过代理的更新方式。已有节点超时不一定妨碍直连更新，订阅更新成功也不保证远端服务可用。更多症状可在疑难解答中对照。
使用心得
从具体症状进入操作说明。先定位失败环节，再调整对应设置，保留每一步修改前后的结果。
面向 Ubuntu、Debian、Fedora 桌面用户，讲解 deb 与 rpm 包的安装命令、依赖问题处理、桌面入口与开机自启动配置。先确认发行版与处理器架构，再区分安装失败、界面未启动和代理未接管三类现象。
阅读安装步骤 →汇总订阅地址失效、格式不识别、更新请求走错通道等常见原因，并说明订阅分组里的自动更新间隔与“不通过代理更新”怎么设置。先判断请求能否到达，再检查返回内容，避免把错误页面当成有效订阅。
阅读更新排查 →已开启自动配置系统代理却打不开网页时，分浏览器扩展、系统设置与终端环境变量三条线检查。先确认本地监听仍在运行，再核对应用实际使用的地址与端口，不把浏览器能访问直接等同于终端也能访问。
阅读代理排查 →