desktop / x64
Windows
桌面端首选 v2rayN。下载页分别提供新一代跨平台桌面界面与经典 WPF 界面,适合常规代理、订阅管理和路由配置。选择前可先确认系统架构,再按界面习惯决定安装入口。
前往下载集中查找 v2rayN 桌面客户端、Android 客户端与中文配置文档,按系统完成安装、订阅导入、代理模式选择和路由检查。
SYSTEM MODULES
从订阅数据进入客户端开始,配置会依次经过协议解析、路由判断、DNS 查询与本地代理接管。逐项查看每个模块负责的范围,以及修改设置时需要确认的边界。
路由引擎读取域名、目标地址、目标端口和进程等条件,再把连接交给指定出口。常见用法是让局域网与直连范围保留原路径,其余请求按规则进入代理出口。规则顺序会影响命中结果,因此调整前应记录当前模式,先用少量明确条件验证,再逐步扩大范围。v2rayN 提供预设路由与自定义规则入口,普通使用者通常先从预设模式开始,出现特定站点路径不符合预期时,再检查域名规则、地址规则与最终兜底项。
订阅管理负责保存订阅地址、请求远端内容、解析节点并写入客户端分组。添加地址后,需要主动执行更新并查看结果提示;只保存地址不会自动产生可选节点。多条订阅并存时,应通过备注区分来源,同时确认当前服务器列表筛选条件,避免节点已经导入却被隐藏在其他分组。更新失败时先检查地址是否完整、网络是否可访问以及系统时间是否准确,再判断是否需要重新添加。分享链接只描述单个节点,与持续更新的一组订阅并不是同一种数据。
协议栈把节点中的地址、端口、用户标识、传输方式和加密相关参数转换为内核配置。VMess 与 VLESS 描述的是协议层,TCP、WebSocket、gRPC 等属于传输层,两者需要按服务端给出的组合保持一致。导入失败或连接后没有数据时,不宜只核对协议名称,还要继续检查传输类型、路径、主机名与 TLS 相关字段。客户端通常会解析规范分享链接,但手工编辑时一个空格、端口错误或字段错位都可能让最终配置无法启动。
DNS 模块负责把域名转换为地址,并可根据域名类别选择不同查询服务器。它与路由规则相互关联:域名在解析前后可能参与不同阶段的匹配,错误的查询结果也会让看似正确的路由落到意外出口。刚完成安装时可先保留客户端默认设置,确认基本连接正常后再启用复杂分流。遇到域名打不开但直接访问地址可用的情况,应重点查看 DNS 服务器可达性、查询模式、缓存状态和系统代理是否覆盖了发起查询的应用。
系统代理会把本地 HTTP 或 SOCKS 监听地址写入操作系统代理设置,浏览器和多数遵循系统配置的桌面程序随后通过客户端转发。它的优势是范围清晰、开启和恢复都较直观,但部分程序会忽略系统代理,需要在应用内部单独设置。连接测试时应同时确认客户端核心已经运行、系统代理状态已经切换、浏览器没有保留旧连接。退出客户端前按正常流程恢复系统代理,可以避免系统继续指向已经停止监听的本地端口。
TUN 模式通过虚拟网络接口接收流量,适合不读取系统代理设置的程序,覆盖范围通常比普通系统代理更广。启用时可能需要操作系统授予网络接口或管理员权限,还要留意本机防火墙、虚拟化软件和其他网络工具是否同时修改路由。首次配置不建议同时叠加多套接管方式;先关闭系统代理之外的额外网络工具,确认 TUN 单独工作,再逐项恢复。若出现局域网设备不可达,应检查绕过地址、默认路由和 DNS 接管范围。
PLATFORM ENTRY
先按当前设备选择平台,再根据处理器架构和安装包格式进入对应客户端。首页只负责平台导航,具体文件、版本说明和系统要求集中在下载中心。
desktop / x64
桌面端首选 v2rayN。下载页分别提供新一代跨平台桌面界面与经典 WPF 界面,适合常规代理、订阅管理和路由配置。选择前可先确认系统架构,再按界面习惯决定安装入口。
前往下载desktop / arm64 · x64
macOS 使用 v2rayN 桌面版,需要按 Apple Silicon 或 Intel 处理器选择安装文件。首次运行时应完成系统放行与网络权限确认,随后再导入订阅并切换系统代理,避免把权限问题误判为节点问题。
前往下载mobile / arm64 · universal
Android 可在 v2rayNG 与 v2flyNG 之间选择。v2rayNG 使用 Xray 内核,适合作为常规首选;v2flyNG 使用 V2Fly 内核,可按订阅兼容情况作为备选。主流设备通常选择 arm64,无法确认架构时可查看通用版说明。
前往下载desktop / deb · rpm
Linux 桌面端使用 v2rayN,根据发行版选择 deb 或 rpm 安装包。Debian、Ubuntu 系通常使用 deb,Fedora、RHEL 系通常使用 rpm;同时还要区分 x64 与 arm64 架构,并在安装后检查桌面入口与自启动设置。
前往下载OPEN SOURCE ECOSYSTEM
V2Ray 相关名称分布在项目生态、内核实现、图形客户端和协议配置多个层级。先分清每一层负责什么,安装与排查会更直接。
Project V 形成了一套围绕代理协议、传输方式、路由规则和配置格式的开源技术生态。日常搜索中,“V2Ray”可能指协议能力、核心程序,也可能泛指能够读取相关配置的图形客户端。用户真正操作的通常是 v2rayN、v2rayNG 或 v2flyNG;客户端负责界面、订阅和系统集成,底层内核负责建立连接、执行路由与处理协议。把图形界面和内核视为两个层次,有助于理解为什么客户端更新、内核更新与订阅更新并不等同。
V2Fly 延续 V2Ray 核心能力并由社区持续维护,Xray 则在兼容部分既有配置的基础上独立演进。两者都能处理常见协议与路由配置,但可用功能、字段细节和更新节奏可能不同。订阅提供的节点是否能够正常使用,不只取决于客户端名称,还取决于客户端所调用的内核是否支持对应协议、传输层和扩展参数。遇到导入成功却无法启动的情况,应查看客户端日志中的配置错误,再对照当前内核能力判断,而不是反复删除同一条订阅。
三款客户端及其相关内核均属于开源软件生态,源代码许可用于说明代码可以被查看、研究、修改和再分发的条件。不同组件可能采用不同许可,用户在二次分发或集成时应以对应项目附带的许可文本为准。开源属性不代表所有第三方订阅内容都由客户端项目维护,也不代表某个节点服务属于 Project V。客户端、内核、订阅提供方和本地网络环境是相互独立的环节,排查时需要分别确认责任范围。
客户端更新主要改变界面、平台适配和配置管理能力;内核更新可能加入协议能力、修正配置解析或调整网络行为;订阅更新则从已有地址重新获取节点列表。三类更新应分开理解。正常使用时,可先确认当前客户端能够启动,再更新订阅并测试已知配置;只有在日志明确提示内核不支持字段,或平台兼容问题已经被新版处理时,才需要考虑客户端或内核升级。升级前记录代理模式、路由方案和自定义设置,便于对照变化。
QUICK ANSWERS
安装前先确认客户端、订阅与代理模式的区别,可以减少重复配置。更完整的分类问答位于常见问题页。
01 / CLIENT
Windows、macOS、Linux 桌面系统优先选择 v2rayN。Android 通常从 v2rayNG 开始;当配置明确需要 V2Fly 内核路径,或需要对照两种内核行为时,再使用 v2flyNG。客户端名称决定操作界面与平台,真正处理协议的是它所调用的内核。
查看客户端选择说明 →02 / SUBSCRIPTION
vmess:// 或 vless:// 通常描述单个节点,导入后形成一条服务器记录;订阅地址返回一组可更新的节点内容,并由客户端按分组管理。只有分享链接时直接从剪贴板导入;持有订阅地址时应进入订阅设置添加,再执行更新操作。
03 / MODE
初次配置建议先用系统代理,它的接管范围容易观察,也便于确认浏览器等常见应用是否正常。部分程序不读取系统代理时,再评估 TUN。启用 TUN 前应了解虚拟网络接口、系统权限、路由表和 DNS 接管的变化,不要同时叠加多个网络接管工具。
查看代理模式术语 →04 / TROUBLESHOOTING
先确认客户端核心已经启动,再看订阅是否更新成功、当前节点是否被选中、系统代理是否开启。随后读取日志中的第一条明确错误,区分域名解析、端口不可达、配置字段错误和权限问题。一次只修改一个变量,比同时更换客户端、节点和代理模式更容易定位原因。
打开故障排查问答 →LATEST GUIDES
按平台安装、分享链接导入与启动故障三个方向整理具体步骤。文章中的下载引导统一返回下载中心,配置操作则按客户端界面逐项说明。
面向 Debian、Ubuntu 与 Fedora 系发行版,说明安装包格式、安装命令、桌面入口修复和 systemd 用户服务设置。
阅读文章 →逐步处理系统设置放行路径、首次启动提示、本地网络权限和代理权限,区分安装拦截与节点连接问题。
阅读文章 →解释单节点分享链接与订阅地址的结构差异,并演示在 v2rayN 与 v2rayNG 中通过剪贴板导入和更新分组。
阅读文章 →