开源客户端指南

V2Ray中文指南客户端与配置教程

按系统选装 v2rayN、v2rayNG 或 v2flyNG,再按步骤完成 订阅导入与代理设置。

01 客户端设置

订阅、代理与内核设置

先把节点导入客户端,再决定哪些应用交给代理、哪些请求直接连接。第一次配置时,按这个顺序逐项确认,出错时也容易找到是哪一步的问题。

配置来源

订阅一键导入

订阅地址用来更新一组节点,分享链接通常只对应一条。拿到订阅地址后,在 v2rayN 里新建订阅分组,填入地址并更新当前分组,再核对节点是否出现在该分组下。如果手上只有一条分享链接,直接从剪贴板导入即可,不必添加订阅。与逐条录入相比,订阅的好处是来源更新后不用重填每个节点;仍需长期保留的手动节点,建议与订阅分开存放,避免刷新后找不到原来的条目。

流量接入

系统代理与 TUN 模式

只想让浏览器等遵循系统设置的应用使用代理时,先试系统代理。遇到不读取该设置的应用,再查看客户端是否提供 TUN 模式。TUN 通过虚拟网络接口接入流量,覆盖范围通常更广,但可能需要额外权限,也可能与正在运行的其他网络工具冲突。初次测试时只开一种模式,用同一个应用确认结果。退出客户端前,记得检查系统代理是否恢复,避免应用继续连接已经关闭的本地代理端口。

出站选择

路由分流规则

路由分流决定已经进入客户端的请求走代理、直连还是其他出站。可以先从内置规则开始,保留局域网设备的直连,再确认默认出站是否符合预期。与一律走代理相比,分流适合同时访问打印机、文件共享和其他服务。自定义规则时,先写适用范围较窄的例外,再看是否被前面的通用规则覆盖。每次只改一条,用原来的访问路径复测;只要改动前后使用的应用一致,就更容易判断规则是否生效。

维护与回退

内核与数据库更新

客户端界面、代理内核和路由数据库各自更新。遇到新传输选项无法识别,先确认当前内核是否支持;域名明明能连,却被归入意料之外的出站,则先看规则顺序以及引用的分类数据。更新前保存常用配置,更新后重载客户端,并用同一个节点复测。只更新当前需要的那一层,比同时换客户端、内核和数据库更容易排查;如果结果变差,也能依据记录判断该恢复哪项设置。

设置后的检查项

分组为空时,先确认所填的是订阅地址,并检查更新提示。其他分组可以正常刷新时,优先检查当前订阅状态,不必重装客户端。

02 平台入口

按系统下载客户端

先确认操作系统,再核对处理器架构和包格式。下列入口会打开下载页对应的面板;安装之前,可在面板里继续查看包型与运行要求。

Windows

选择 v2rayN。下载页区分使用跨平台界面的桌面版和沿用经典界面的 WPF 版。第一次使用可以从桌面版开始;已有使用习惯或需要对照经典界面教程时,再看 WPF 版。

下载前在系统的「关于」页面查看系统类型,别把操作系统架构和应用名称混在一起。已有设置时,先备份配置;切换界面版本后,重新核对订阅分组、本地端口和默认路由,再开启系统代理。

前往下载

macOS

选择与芯片对应的 v2rayN 磁盘映像。「关于本机」显示 Apple 芯片时选 Apple Silicon 包,显示 Intel 处理器时选 Intel 包。机型名称相同不代表芯片相同,按系统显示的信息选择更稳妥。

打开映像后,按安装指引把应用移到「应用程序」文件夹,再从那里启动。若连接正常但应用没有使用代理,先查看系统代理设置是否生效;如果同时运行其他网络工具,逐个退出后再进行对照。

前往下载

Android

优先查看使用 Xray 内核的 v2rayNG;已有明确的 V2Fly 配置需求时,再选择 v2flyNG。多数较新的设备适用 arm64 包;不确定系统向应用提供的架构时,可查看通用包,但仍需满足系统版本要求。

首次连接时,系统通常会要求确认 VPN 权限。若设备上已有其他 VPN 应用运行,先结束那条连接。平时能连、锁屏后却中断时,先看系统是否限制了客户端的后台运行,再决定是否调整电池设置。

前往下载

Linux

按发行版和处理器架构选择 v2rayN。Debian、Ubuntu 一类系统通常使用 deb,Fedora 一类系统通常使用 rpm;同一种包格式还要区分 x64 与 arm64,不能只看文件扩展名。

优先使用发行版自带的软件安装工具处理依赖。如果应用能够启动而浏览器没有走代理,先确认桌面环境与浏览器分别采用哪套代理设置。托盘菜单可用与否,也取决于当前桌面环境对托盘的支持。

前往下载

查看全部客户端 →

03 开源生态

Project V、V2Fly 与 Xray

客户端下载页上的产品名、设置里的内核名,以及链接开头的协议名,指的是三种不同的东西。先分清它们,再看教程和报错会更容易。

界面
v2rayN · v2rayNG · v2flyNG
内核
V2Fly · Xray
协议
VMess · VLESS · Trojan · Shadowsocks

Project V 是生态名称

Project V 最初以 V2Ray 为核心,提供可组合的代理、传输与路由能力。早期的使用方式围绕配置文件和内核进程展开。后来社区为不同系统开发了图形客户端,把原本分散在配置文件里的节点、分流和日志放进界面。因而,在安装文章里看到的「V2Ray」有时特指内核,有时泛指整个生态。看到这个词,先辨认当前说明是在讲程序界面、配置语法,还是通信协议。

这种分工也能帮助排查问题:导入按钮找不到,先看客户端教程;字段看起来都填好了,启动时却提示无法读取某个选项,则根据日志去查当前内核的配置说明。换一个外观不同的客户端,不一定会改变内核处理配置的结果。

两条内核分支,分别维护

V2Fly 延续 V2Ray 的社区维护。Xray 从同一代码体系分出后独立演进。两边保留了一部分相近的概念和配置能力,但支持的功能、默认行为和发布时间并不总是相同。比如,拿到写明使用 REALITY 的配置时,不能只凭分享链接前缀判断是否兼容:前缀能说明协议类别,却不会说明内核能否处理链接里的全部传输和安全参数。

v2rayN 在桌面端通过图形界面管理配置,并按节点类型和客户端支持情况调用相应内核;v2rayNG 主要使用 Xray,v2flyNG 则以 V2Fly 为基础。迁移现有配置时,先记录原来使用的内核,再挑一条熟悉的节点测试,不必一开始就导入并改写全部设置。

开源许可与连接参数是两回事

v2rayN、v2rayNG 和 v2flyNG 都是开源的图形客户端。开源许可规定的是代码如何使用、修改和再分发;安装包中包含的其他组件也可能各有许可。判断部署或再分发的要求时,应查看相应项目和组件的许可,而不是把一个项目的条款套到整个生态上。

VMess、VLESS、Trojan 和 Shadowsocks 则是客户端可识别的代理协议。导入时应保留来源给出的服务器地址、端口、传输和安全设置;只把链接的前缀换成另一种协议,不会让对端改用相同配置。协议名称也不能单独说明连接使用了何种保护。例如,看到 VLESS 只能确认协议类型,判断传输保护还要看实际的安全设置。公开交流时宜描述前缀和错误提示,别复制包含连接凭据的完整链接。

内核、界面和规则库分别更新

客户端更新主要改动界面和配置管理,也可能随包带来内核更新。内核负责解释配置并建立连接;GeoIP 和 GeoSite 等资源则为引用这些分类的路由规则提供数据。资源变化可能改变某些请求命中的分类,即使设置界面没有任何改动。反过来,如果规则没有引用相关分类,仅下载新的数据文件也不会让流量自动换一条路。

更新后可用同一个节点、同一个应用和同一个目标地址做对照。无法启动时,先查内核日志;可以启动但某些目标的出站变了,再查路由规则的匹配顺序和资源文件。把升级前的设置和测试结果留一份记录,比一次重置多个选项更容易定位原因。

配置来源与服务来源要分开看

下载客户端只解决本机如何读取配置和转发流量,安装包并不替你提供节点或订阅。已有手工配置时,先保存一份备份,再尝试导入新分组。订阅刷新后节点名称可能变化,有些条目也可能被移除;使用前仍要确认当前选中的节点,而不是只看分组曾经更新成功。

求助时可以说明系统、客户端、内核、出错步骤以及脱敏后的日志。若只在某个应用中失败,还可以注明使用的是系统代理还是 TUN。截图应遮掉订阅地址、服务器地址和账号信息。需要从头核对操作时,可直接对照安装配置大全里对应平台的章节。

04 配置专题

近期配置教程

常用设置跑通后,再按实际需求整理多设备配置、更新路由资源,或核对当前客户端与内核的对应关系。

查看全部文章 →

下载客户端