客户端选择 · 安装与配置

V2RayWindows客户端

从选择客户端开始,按步骤完成订阅导入代理配置,再检查应用是否按预期访问网络。

代码开源 中文配置指南 客户端与内核分层

先确认设备,再选择安装包

V2Ray 客户端下载入口

桌面设备从 v2rayN 开始,Android 优先查看 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。下载前确认系统架构、安装权限和已有配置的兼容性;客户端负责管理配置,实际连接还需要有效的服务端信息。

Windows

v2rayN 提供新一代跨平台桌面版与经典 WPF 版。初次安装可先比较界面与系统要求;已有使用习惯时,优先确认原有订阅分组、路由规则和内核设置能否迁移,再决定是否更换界面。

在系统设置的“系统类型”中查看架构。本站下载入口提供 x64 安装包,不要仅根据电脑品牌判断。安装后先用普通权限完成导入与系统代理验证,需要 TUN 时再检查相应权限。升级之前导出配置,也不要让两个实例同时修改系统代理。

前往下载 ↗

macOS

使用 v2rayN 桌面客户端,在“关于本机”中确认芯片:Apple Silicon 选择 arm64,Intel 选择 x64。安装包架构与订阅协议是两件事,订阅能否导入并不能说明安装包选得正确。

首次启动如遇系统安全提示,先确认文件来源与提示内容,再按系统提供的方式处理,不要直接关闭整套安全防护。配置系统代理后,已有浏览器会话可能需要重新建立连接;应用自身设置了代理时,也应检查是否覆盖系统配置。

前往下载 ↗

Android

优先选择使用 Xray 内核的 v2rayNG;v2flyNG 是使用 V2Fly 内核的备选。多数较新的设备适合 arm64,架构不明确时可查看通用版及其说明。具体协议能力要看所用内核,不能把两款应用视为所有配置都能互换。

首次启动代理通常需要确认系统 VPN 授权,这表示允许应用建立本地接管通道,不等于服务端已经连通。若设备已有其他 VPN 应用运行,先明确由哪个应用接管。后台中断时查看电池限制与日志,再调整运行策略,不必一开始就修改所有后台选项。

前往下载 ↗

Linux

有图形桌面的设备可选择 v2rayN,按发行版使用 deb 或 rpm 软件包,再区分 x64 与 arm64。软件包格式描述安装方式,处理器架构描述运行环境;两项都要对应,不能只看文件后缀。

桌面环境对系统代理的支持范围不同,浏览器、终端和后台服务也可能读取不同设置。先在一个明确支持代理的应用中验证,再处理其他程序。若目标是路由器或旁路由部署,应先理解网关与 DNS 的接管边界,不要把桌面客户端安装流程当作网关方案。

前往下载 ↗

操作项 — 说明 — 适用条件

订阅管理代理设置

先让一条配置正常工作,再增加分流、DNS 或接管规则。界面选项可以帮助整理配置,但不会代替服务端参数,也不会自动消除网络环境差异。以下按常用设置说明作用与检查顺序。

订阅管理

在订阅分组中填写来源提供的地址,保存后执行更新,再检查分组下是否出现预期配置。订阅更新只是取得节点信息,既不代表节点可连接,也不会替代选择当前节点的操作。建议按来源建立分组,给手动配置另留位置,避免更新时混淆。地址通常包含访问凭据,排查时应隐藏完整链接,不要把它贴进公开截图或笔记。

适用条件:已有可信来源的有效订阅,且能访问更新地址。导入失败先分清网络请求失败、返回内容不受支持,还是链接已经失效;反复粘贴同一地址不会改变内容格式。

系统代理

选择“自动配置系统代理”后,客户端会为遵循系统设置的应用提供本地代理入口。它适合先验证浏览器访问,不意味着所有程序都会被接管。“不改变系统代理”表示保留现有系统状态,而不是自动恢复直连;需要撤销接管时,应明确执行清除系统代理,再检查系统设置。客户端退出后的网络异常,也可能与残留代理入口有关。

适用条件:本地代理服务已启动,目标应用会读取系统代理。应用内置代理、扩展或其他网络工具可能覆盖设置;应一次只保留一个明确的配置来源。

TUN 模式

TUN 借助虚拟网卡接收流量,适合处理不读取系统代理的应用,但实际范围仍取决于路由、排除规则与权限。先确认普通代理连接可用,再尝试虚拟网卡接管,这样能把服务端问题与系统接管问题分开。启用后若局域网设备、远程桌面或某些服务访问异常,应检查直连规则与网段排除,而不是立即更换订阅。

适用条件:系统允许相应网络权限,相关组件可正常工作。其他 VPN、虚拟网卡或安全软件可能影响路由;调整前保留原设置,并准备关闭 TUN 的回退方法。

路由分流

路由根据域名、IP 等条件决定请求使用哪个出站。先从现有规则中理解直连、代理与阻断的区别,再按具体需求增加规则;通常应注意匹配顺序,较宽泛的规则可能提前覆盖细分条件。引用 GeoIP 或 GeoSite 时,需要确保数据库与标签可用。全局代理改变的是已进入内核的请求如何出站,并不能让未被接管的应用自动进入内核。

适用条件:已经明确希望哪些请求直连、哪些走代理。改动后用对应域名与日志复测,不能仅凭一个网站能打开,就判断所有规则都按预期执行。

DNS 设置

DNS 负责把域名解析为地址,但请求可能由应用、系统或内核分别发起。调整时先确认是哪一层在解析,再检查解析请求的出站路径与返回结果。仅替换一个 DNS 地址,并不能保证所有应用都使用它。遇到域名访问失败而其他连接正常时,可结合日志检查解析路径、超时与缓存;浏览器自己的加密 DNS 也可能使观察结果与系统设置不同。

适用条件:已理解所选内核的 DNS 规则,以及解析服务如何到达。不要混用不同内核的配置字段;更换解析策略后,重新建立连接并考虑缓存影响。

接管方式怎么选

以下是验证起点,不是默认设置建议。完整操作项保留在上方对照表中。

从系统代理开始

选中一条有效配置,启动本地服务,再设置系统代理。在遵循系统设置的浏览器中打开测试页面,同时观察客户端日志。测试期间不要叠加浏览器代理扩展,以免无法判断请求究竟走了哪条路径。验证完成后再加入分流规则;若浏览器仍不能访问,先排查配置与本地服务,而不是直接开启更多接管功能。

首次使用的检查顺序

三步上手与连接验证

快速上手先处理订阅、节点与代理生效三个环节。界面名称可能随客户端变化,操作目标保持一致:取得配置、选定出站、确认实际应用的流量路径。

  1. 导入订阅,确认配置内容

    安装并启动客户端后,使用订阅分组或导入入口添加已有信息。v2rayN 桌面端适合按来源管理分组,v2rayNG 安卓端可从订阅管理或导入功能开始。先检查地址是否完整、是否混入空格或换行,再更新订阅。导入成功后确认协议、服务端地址与必要的传输参数是否存在,不要只看显示名称。

    如果只有单条分享链接,应使用对应的链接导入方式,不要把它当作订阅更新地址。订阅是一份可更新的配置集合,节点是其中的具体连接配置;两者的入口与维护方式不同。没有连接信息时,应先向服务提供方确认,安装客户端本身不会产生节点。

  2. 选择节点,设置一种接管方式

    在导入的配置中选定当前使用项,确认客户端已启动相应内核。桌面端可先用系统代理验证浏览器;安卓端按提示确认 VPN 授权,再启动连接。路由模式先保持容易理解的设置,不要同时切换内核、DNS、TUN 与分流规则,否则出错时很难判断是哪一步造成变化。

    “已选中”与“正在使用”未必是同一个界面状态,应结合客户端提供的设为活动配置或启动操作确认。切换配置后重新建立测试连接。若需要访问打印机、共享文件夹或局域网服务,保留相关直连条件,并记录修改前的规则,便于恢复。

  3. 交叉检查测试、访问与日志

    先运行客户端提供的连接测试,再用目标应用访问实际页面,并观察同一时刻的日志。真连接测试通常通过代理完成一次请求,用来判断该测试目标能否到达;下载测速更偏向吞吐表现,两者不能相互替代。测试通过也不意味着系统中的每个应用都已经接管。

    若测试失败,先区分解析、连接超时、认证或握手错误;若测试成功而浏览器失败,优先检查系统代理与应用自身设置。每次只改一项,并使用相同目标复测。需要分享日志时先移除订阅地址、身份凭据和可识别的服务端信息。

图形界面、内核与服务端

Project V 与开源客户端生态

先区分谁负责配置、谁负责转发、谁提供远端连接。理解这三个角色,比单看协议名称或客户端外观更有助于选择软件和排查问题。

Project V、V2Fly 与 Xray 的关系

Project V 是围绕代理与网络通信工具形成的开源生态,V2Ray 是其中的重要项目。V2Fly 社区延续维护 V2Ray 相关实现,Xray 则沿着相关技术基础发展出自己的功能与配置体系。它们有共同背景,但并不代表全部功能与字段可以互换。阅读教程时,应同时确认客户端支持的内核和服务端提供的配置,而不是看到“V2Ray”这个名称就直接照搬。

例如涉及 REALITY 的连接,应确认所选内核支持相应能力,并按服务端给出的参数导入。协议名称不能直接换算为连接速度;网络路径、服务端资源、传输设置和设备环境都可能影响实际体验。理解协议职责之后,再判断当前配置是否兼容,通常比反复更换客户端更有效。

三款开源客户端的使用边界

v2rayN 提供桌面配置管理界面,具体内核与功能由所用发行版本及配置决定;v2rayNG 面向 Android,使用 Xray 内核;v2flyNG 同样面向 Android,使用 V2Fly 内核作为另一种选择。三款客户端均以开源方式开发。对普通用户而言,开源意味着可以审阅实现、了解变更和参与问题反馈,但不能据此推断任何订阅来源都可信。

开源协议规定代码使用、修改与分发的条件,客户端与内核也可能采用不同许可证。日常安装使用与重新分发修改版的责任并不相同;计划二次分发时,需要逐项阅读相应项目的许可证与依赖声明。本站是独立整理的中文下载与操作指南,不是这些开源项目的官方网站,也不代表项目维护者发布承诺。

更新客户端、内核与规则数据库

客户端更新可能改变界面或配置生成方式,内核更新可能改变协议行为,GeoIP 与 GeoSite 更新则会影响规则引用的数据。它们不是同一次操作的不同叫法,也不必在排查过程中一起更新。先记录当前可用配置,阅读变更说明,再选择需要调整的部分;更新后用原来的测试目标复测,确认订阅、系统接管与局域网访问都符合预期。

社区维护通常通过公开代码与变更记录推进,发布节奏会随项目变化。本站不把某个下载入口永久描述为最佳选择,也不在首页固定显示容易过期的版本信息。安装包入口集中在下载页,平台差异与配置问题集中在全平台指南,便于按操作阶段查找,而不是在多个页面之间拼接零散步骤。

查看项目介绍与整理原则 ↗

近期配置主题

后台运行、部署与规则维护

基础连接可用以后,再按遇到的问题深入阅读。文章分别处理安卓后台耗电、Linux 网关接管与路由数据库维护,不把单一设置当作所有网络环境的通用答案。

v2rayN下载