Windows
v2rayN / Desktop · WPF
桌面版采用跨平台界面,经典 WPF 版保留熟悉的 Windows 桌面操作方式。两种入口都用于管理订阅、选择活动节点和设置代理;按系统要求及界面使用习惯选择即可,不需要为了导入同一份订阅同时安装两版。
首次启动后,先看节点列表与日志是否正常,再开启系统代理。若浏览器可以访问而开发工具仍连接失败,应检查工具自己的代理选项。软件能够启动、内核运行和应用流量进入代理,是三个需要分别确认的环节。
前往下载 →download
桌面端使用 v2rayN,安卓端优先选择 v2rayNG。先确认操作系统与处理器架构,再进入下载页选择对应安装包;客户端名称相近,不代表安装格式与内核能力完全相同。
v2rayN / Desktop · WPF
桌面版采用跨平台界面,经典 WPF 版保留熟悉的 Windows 桌面操作方式。两种入口都用于管理订阅、选择活动节点和设置代理;按系统要求及界面使用习惯选择即可,不需要为了导入同一份订阅同时安装两版。
首次启动后,先看节点列表与日志是否正常,再开启系统代理。若浏览器可以访问而开发工具仍连接失败,应检查工具自己的代理选项。软件能够启动、内核运行和应用流量进入代理,是三个需要分别确认的环节。
前往下载 →v2rayN / Apple Silicon · Intel
先在“关于本机”中查看芯片信息。Apple Silicon 对应 arm64,Intel 对应 x64;按处理器选择磁盘映像,比仅凭电脑外观判断更可靠。安装完成后从应用程序目录启动,并按系统提示处理首次打开所需的权限。
导入订阅后,先使用系统代理完成浏览器验证,再考虑其他接管方式。终端工具未必读取桌面网络代理设置,需要单独指定代理地址。修改系统网络选项前记下原值,退出客户端时也要确认代理设置是否已恢复。
前往下载 →v2rayNG / Xray · v2flyNG / V2Fly
v2rayNG 是安卓端的优先入口,v2flyNG 用于需要 V2Fly 内核的配置。多数较新的手机可选择 arm64;不确定设备架构时,先阅读下载页的包型说明。两款应用的内核与选项并不完全一致,不能只凭分享链接能够导入就判断配置兼容。
首次连接需要确认系统 VPN 授权。节点配置负责连接参数,应用分流负责哪些应用进入接管范围,二者不是同一个开关。如果切到后台后连接中断,检查电池优化与后台运行限制,再回到日志判断是否存在实际的连接错误。
前往下载 →v2rayN / deb · rpm
Debian、Ubuntu 等发行版通常选择 deb,Fedora 等发行版通常选择 rpm,同时区分 x64 与 arm64。安装包格式匹配只是第一步,还要确认当前发行版的桌面环境与运行依赖满足要求。图形客户端需要在可用的桌面会话中启动。
Linux 桌面的系统代理设置与终端环境变量彼此独立。建议先通过本地 SOCKS 端口测试连通性,再设置桌面网络代理;需要 TUN 时再检查权限、路由和 DNS。逐层验证能够避免把桌面设置问题误判为节点失效。
前往下载 →下载页按平台集中列出包型与适用说明。安装包选择完成后,返回快速上手教程继续导入配置,不必在首页寻找具体文件。
查看全部客户端 →features
订阅解决配置来源,代理模式解决流量入口,路由解决出口选择。先区分这三层,再按需要启用 TUN 或切换内核。下方是设置项示意,实际名称与可用功能以所用客户端为准。
订阅链接用于批量获取节点配置,适合需要定期同步连接参数的场景。在 v2rayN 中先建立订阅分组,填写地址并保存,再执行更新,随后选择活动节点。与逐条粘贴分享链接相比,分组便于区分来源,也方便单独更新或停用。更新通常针对节点列表,不等于同步全部本地路由规则;删除或覆盖前应保留必要设置。订阅地址可能包含访问权限信息,不宜放进公开截图、日志或共享文档。
设置示意:先保存分组,再从订阅菜单执行更新。
系统代理让遵循系统网络设置的应用把请求交给客户端;全局、绕过大陆等路由模式,则决定进入客户端的请求使用哪个出口。两者属于不同层级,开启全局路由并不会自动接管所有程序。初次使用可先开启系统代理,再选择合适的路由预设,通过浏览器验证。与 TUN 相比,系统代理的影响范围通常更容易观察,但部分命令行工具和应用需要独立设置。退出客户端之前,确认系统代理已清除或恢复原状。
菜单示意:系统代理不是“所有应用强制代理”的同义词。
路由分流按条件把请求送往代理、直连或阻断出口,适合同时访问本地资源与远程服务。先使用客户端预设,再为少量明确需求补充自定义规则。与只切换全局模式相比,规则能够细化到域名和 IP 范围,但需要留意匹配顺序、DNS 解析与分类数据。通常先检查靠前规则是否提前命中,再检查出口标签是否存在。一次只改一类条件,结合日志验证,避免把重叠规则叠加成难以维护的配置。
规则示意:分类匹配依赖所用内核与配套规则数据。
TUN 模式通过虚拟网络接口接收流量,适用于不读取系统代理设置的应用。它与普通系统代理的区别在于接管层级更低,因此同时涉及权限、系统路由、DNS 与本地网络访问。建议先让普通代理链路工作,再按照平台说明启用 TUN。遇到局域网设备无法访问或域名解析异常时,先停用 TUN 对照测试,再检查绕行范围与 DNS 设置。不要把 TUN 当作连接故障的通用修复开关,功能是否可用还取决于客户端与运行环境。
选项示意,不代表所有平台具有相同的默认设置。
客户端负责界面与配置管理,内核负责实际协议处理和流量转发。v2rayN 可围绕 Xray、V2Fly 等内核管理相应配置,但不同内核支持的协议参数与扩展能力并不相同。与只看客户端名称相比,检查节点要求和实际使用内核更能解释兼容性问题。导入后若出现不支持的字段,应先确认协议、传输与安全层组合,再选择匹配的内核。切换内核可能改变配置解析和运行行为,应保留原设置并重新验证连接。
选择示意:具体协议支持范围以所用内核的实现为准。
quickstart
安装完成不等于配置完成。按“导入配置、选择入口、验证连接”的顺序进行,每个阶段只处理一类问题。这样即使某一步失败,也能保留已经确认正常的部分。
01 / import
准备已有的有效订阅链接或分享链接。v2rayN 从订阅分组开始,保存地址后执行更新;v2rayNG 从订阅设置添加来源,再更新配置。仅把地址粘进输入框还没有完成导入,需要回到列表确认配置确实出现,并手动选择准备使用的节点。
检查协议类型、服务器端口、传输方式与安全层是否符合配置来源的说明。不要把网页地址当作订阅地址,也不要在更新失败时反复删除全部分组。先看提示属于地址不可达、内容无法解析还是导入后列表为空,再决定是调整更新方式还是核对配置来源。
订阅与单节点分享链接的区别在于管理范围:前者通常用于批量刷新,后者用于导入某一条配置。客户端不提供远端服务器账户,安装软件本身也不会生成可连接的服务。已有配置才能继续下一步。
订阅导入操作说明 →02 / connect
桌面端先启用系统代理,让遵循系统设置的应用进入本地监听端口。安卓端启动连接时按系统提示确认 VPN 授权。随后选择适合当前用途的路由预设;路由预设改变的是出口决策,不会替代应用接入代理的步骤。
日常浏览可以先用常见分流预设测试,同时访问本地资源和远程站点,观察两类请求是否都正常。开发工具、终端和部分独立应用可能不读取系统代理,应在各自设置中指定代理类型、地址和端口。没有明确需求时,不必一开始就启用 TUN 或叠加多套自定义规则。
本地监听地址通常使用回环地址。只有确实需要为同一局域网设备提供代理时,才评估开放监听范围与防火墙设置;“允许来自局域网的连接”不是普通本机使用的必需选项。
查看模式选择步骤 →03 / verify
先打开浏览器访问可用于测试的网页,再检查客户端日志中是否出现对应连接。若工具提供连接测试,可把结果作为辅助信息,但测试成功不代表每个应用都已使用代理。实际业务访问、域名解析和系统接管范围仍需要分别确认。
网页打不开时,先检查系统时间、节点配置与本地端口,再检查系统代理、DNS 和路由。浏览器正常而终端失败,优先看终端代理设置;域名访问失败而连接 IP 的测试正常,应重点检查解析路径。每次只修改一个设置,记录结果后再继续,避免同时改动让故障来源变得模糊。
验证完成后再整理日常配置:保留可用的订阅分组,记录常用路由模式,并了解退出客户端后的系统网络状态。后续更新或更换网络时,可以用相同顺序复查,而不是从头重装。
进入疑难解答 →ecosystem
V2Ray 并不是单一图形应用的名称。理解 Project V、V2Fly、Xray 与三款客户端的关系,有助于判断一份配置应当交给哪个程序,以及错误发生在哪一层。
Project V 围绕模块化代理工具形成生态,V2Ray 是其中广为使用的核心项目。内核把入站、出站、路由和协议处理组合起来,图形客户端则把这些能力整理为订阅分组、节点列表和设置窗口。用户点击连接后,实际处理网络请求的通常是客户端启动或集成的内核,而不是界面本身。
这也解释了为什么同样写着 V2Ray 的配置,在不同客户端中可能有不同表现:客户端的导入解析、生成配置的方式,以及内核支持的参数都可能影响结果。排查时应区分“链接能否导入”“内核能否启动”和“目标请求能否完成”,不要把三个环节合并为一个连接状态。
V2Fly 延续 V2Ray 的社区开发,Xray 则是在相关技术基础上发展出的内核项目。两者有共同的技术来源,也各自演进协议能力和配置行为。常见名称如 VMess、VLESS、Trojan 表示协议,WebSocket 等名称表示传输方式,TLS、REALITY 等涉及安全层;这些名称不能相互替代。
选择内核应当从实际配置要求出发,而不是只比较项目名称。例如使用特定扩展参数时,需要确认该内核确实支持对应组合;普通配置也不应为了切换内核而随意改写安全参数。协议本身不能单独决定速度,网络路径、服务端资源、传输方式和客户端环境都会影响体验。
v2rayN 为桌面使用提供图形配置入口,覆盖本页列出的三个桌面平台。v2rayNG 面向安卓并采用 Xray 内核,v2flyNG 则提供基于 V2Fly 内核的安卓入口。这三款客户端均为开源项目,但各自的界面布局、导入能力和内核集成方式不同,不能把某一款的菜单路径原样套到另一款。
开源意味着源代码可以依照相应许可证查看、使用与参与改进,不等于客户端包含远端代理服务,也不意味着任意配置都适合导入。配置来源、应用权限和设备运行环境仍需独立评估。对普通使用者而言,选择适合平台和协议的客户端,比同时安装多款再混合修改设置更容易维护。
客户端、内核与配套数据可能采用不同的开源许可证。使用、修改或再分发时,应分别阅读所涉及项目的许可说明;不能用一个笼统的“开源”标签替代具体条款。社区维护让问题修复和功能演进持续发生,更新是否适合当前设备,则仍要结合系统要求与变更说明判断。
日常维护也要区分更新对象。更新订阅通常改变远端提供的节点配置,更新客户端可能改变界面和配置生成逻辑,更新内核则可能影响协议实现;域名与 IP 分类数据又属于另一层。出现变化后先确认更新的是哪一部分,再对照日志复查,能够减少不必要的回退和重装。
journal
基础连接完成后,再处理更具体的配置问题。以下三篇文章分别讨论协议机制、多设备同步与自定义路由:先确认当前需求属于哪一层,再选择对应的设置方法。
从 TLS 握手、内层加密冗余与流控机制入手,解释 XTLS Vision 减少重复加密的思路,以及 REALITY 如何省去自备证书。协议能力与实际连接条件需要分开判断,理解工作方式后再核对节点参数。
阅读文章 →对比订阅链接统一分发、分享链接与二维码、配置文件导入导出三种做法,说明桌面与安卓之间保持节点和规则一致的步骤。节点同步与本地设置同步范围不同,迁移前要先确认哪些内容需要分别保存。
阅读文章 →讲清 domain 前缀匹配、ip 与 geoip 段、geosite 分类的写法,以及规则自上而下的命中顺序和常见冲突的处理方式。适合已经使用预设分流、准备为特定服务补充规则的读者。
阅读文章 →