客户端下载 · 配置文档

V2Ray文档中心v2rayN 下载与配置

从订阅导入开始,按平台选择客户端,再理解路由分流与DNS 配置。

下载平台

订阅 → 规则 → 出站

订阅管理与路由配置

客户端负责整理配置,内核负责处理连接。先让一条连接正常工作,再逐项增加规则,排查时就能知道变化来自哪里。

订阅分组 · 结构示意
  • 订阅管理
    • 日常使用 启用更新
    • 备用配置 独立维护
服务器过滤按备注关键词

先分组,再更新订阅

多个订阅混在同一列表时,很难判断服务器来自哪里。先在 v2rayN 中为不同来源建立独立分组,填写订阅地址,再执行更新;需要缩小列表时,用备注关键词过滤。过滤只是改变显示范围,不会修改远端订阅内容。更新前记下当前分组与选中项,更新后检查日志,避免把列表为空误判为连接失败。相比逐条粘贴分享链接,分组更便于集中更新与回退。

订阅地址是配置入口,应按敏感信息保管。 查看手册对应章节 →

按系统选择安装包

V2Ray 客户端下载入口

桌面平台先看 v2rayN,安卓端先看 v2rayNG。安装包的处理器架构要与设备一致;相同客户端的不同界面或封装形式,不代表订阅需要重新购买或更换。

Windows

v2rayN 首推

v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的经典操作布局;先根据使用习惯选择,再确认系统环境是否满足对应安装要求。

更新前保留订阅分组和自定义路由,遇到启动异常时先检查运行环境与解压位置,不要反复覆盖配置。

macOS

v2rayN

先在系统的“关于本机”中查看芯片信息,再选择 Apple Silicon 或 Intel 对应的 v2rayN 安装包。两种架构的配置思路相同,区别主要在程序运行环境。

安装后先完成系统要求的授权,再测试系统代理。已有其他代理工具时,先退出冲突程序,避免多处设置互相覆盖。

Android

v2rayNG 首推

v2rayNG 使用 Xray 内核,适合作为安卓端的优先选择;需要 V2Fly 内核环境时可查看 v2flyNG。多数近年的设备可选 arm64,不确定架构时再了解通用版。

首次启动连接需要确认 VPN 授权。切换客户端前先断开原有连接,并检查系统后台限制,避免把授权或休眠问题当成服务器故障。

Linux

v2rayN

根据发行版选择 deb 或 rpm,再核对 x64 或 arm64 架构。先用桌面界面完成订阅导入与连接测试,确认基础配置有效后,再考虑虚拟网络接口相关设置。

桌面系统代理与终端环境变量是两套入口。浏览器正常而命令行异常时,应分别检查,不必直接重装客户端或替换订阅。

首次配置顺序

v2rayN 订阅导入与连接

这三步先建立一个容易验证的基础状态。桌面端使用 v2rayN,安卓端使用 v2rayNG 时,菜单名称可能不同,但导入配置、选择入口和检查结果的顺序可以保持一致。

  1. 建立分组,导入订阅

    在订阅设置中新增分组,给分组起一个能识别来源的名称,再粘贴完整的订阅地址并更新。分享链接通常描述单个服务器,订阅链接则用于批量获取配置,不能只凭链接长度判断格式。导入完成后先检查服务器列表与更新日志,确认没有复制空格、截断地址或把网页地址当成订阅。

    订阅通常包含访问凭据。排查问题时只分享去除敏感内容的错误提示,不要公开完整链接或二维码。

  2. 选择服务器,启用连接入口

    选中一条服务器配置,先保留容易理解的基础路由。在 v2rayN 中启用系统代理,让遵循系统代理设置的浏览器进入客户端;在 v2rayNG 中启动连接并确认系统授权。暂时不要同时启用多个代理程序,也不要一次更改 TUN、DNS 和路由,避免出现问题后无法判断是哪一步引起。

    “客户端已启动”只表示程序在运行,并不等于每个应用都已使用代理,入口设置仍需单独确认。

  3. 检查网页、日志与直连范围

    先访问一个日常使用的网站,再检查客户端日志是否有连接与解析错误,同时确认局域网设备仍可访问。如果只有某个应用异常,检查该应用是否遵循系统代理;如果所有请求都失败,再回看订阅有效性、服务器配置与网络状态。完成一次成功测试后,才逐项加入细分路由,并记录改动。

    结束使用时恢复不再需要的系统代理设置,避免客户端退出后,应用仍向已关闭的本地端口发送请求。

Project V · V2Fly · Xray

V2Ray 内核与开源客户端

选型时先分清三个层次:协议描述通信方式,内核执行连接与路由,图形客户端负责把这些能力整理成可以操作的界面。名称相近,并不意味着功能范围和配置格式完全相同。

项目背景

Project V

V2Ray 的项目体系与模块化思路

V2Fly

社区维护的 V2Ray 内核体系

v2flyNG

Xray

从 V2Ray 发展出的独立内核分支

v2rayNG

v2rayN 可管理不同内核,实际支持范围以所选内核与配置为准。

Project V 的模块化背景

V2Ray 是 Project V 体系中的网络代理工具,其配置把入站、出站、路由与 DNS 等能力分开组织。图形客户端把常用设置放进菜单,但这些层次仍然存在。理解这种结构后,就能区分“应用没有进入本地入口”与“请求进入内核后选择了错误出站”,不再把所有连接问题都归结为服务器不可用。

V2Fly 与 Xray 的关系

V2Fly 延续了 V2Ray 的社区维护,Xray 则由 V2Ray 发展而来,并沿独立方向演进。两者共享部分概念和历史基础,但协议能力、字段支持及默认行为可能不同。看到某种协议名称时,还应确认具体传输方式、安全设置与内核支持,不能把一个内核的完整配置直接视作另一个内核的通用配置。

三款客户端的开源属性

v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。v2rayN 面向桌面使用与配置管理,v2rayNG 和 v2flyNG 面向安卓端,分别采用不同的内核路线。开源许可规定代码使用、修改与分发的条件,具体以各项目许可文本为准;客户端开放源代码,不代表服务器运营、订阅服务和客户端项目属于同一主体。

客户端更新与订阅更新

更新客户端是更换程序,更新订阅是重新获取服务器配置,两者解决的问题不同。遇到协议能力不足时,可能需要检查客户端及内核;遇到订阅条目变化时,应先查看订阅更新记录。更新前保留自定义规则,更新后复查系统代理与权限。不要只因界面出现新选项就全部启用,稳定的配置应当能说明每个开关的用途。

客户端不提供服务器资源。安装程序后仍需导入有权使用的配置;订阅有效期、服务范围及账号状态由订阅来源决定。本站文档侧重客户端操作与配置概念,选择前可先阅读三款客户端横向评测,遇到陌生名词再查阅名词解释。

配置实践与故障排查

V2Ray 客户端使用文章

基础配置完成后,再根据具体症状查找文章。启动失败、系统代理失效与内核选型是不同的问题:先确认故障发生在哪一层,再选择对应的排查路径,比同时替换全部设置更容易得到明确结果。