客户端与中文配置文档

V2Ray下载官网
v2rayN 客户端与配置教程

集中整理 桌面与 Android 客户端中文配置步骤进阶路由说明。先按系统选择客户端,再导入订阅并确认代理模式。

永久免费 代码开源 Xray · V2Fly VMess / VLESS / Trojan
选择客户端 → 导入订阅 → 设置代理 按平台进入对应下载区
配置链路剖面

从客户端选择到稳定运行

把一次完整配置拆成五个接线点。每一步只处理一个问题,避免在客户端、订阅、代理模式和路由规则之间来回猜测。

先按系统选客户端

桌面系统优先查看 v2rayN。它把服务器列表、订阅分组、系统代理、路由规则和内核日志放在同一套界面里,Windows、macOS、Linux 用户可以沿用相近的操作路径。Android 设备通常选择 v2rayNG;需要使用 V2Fly 内核家族时,再考虑 v2flyNG。选型时先确认操作系统与处理器架构,不要先下载文件再反推能否安装,这样能减少包类型选错和配置迁移的额外步骤。

导入后主动更新订阅

订阅地址不是服务器本身,而是一份由服务提供方维护的配置清单。复制地址后,从客户端的订阅管理菜单新增记录,再执行一次手动更新,服务器条目才会写入本地列表。多份订阅应分别命名,并按来源建立分组,后续排查失效地址时更容易定位。若更新后列表为空,先检查地址是否完整、分组过滤条件是否过严,再查看订阅更新日志,不必反复删除客户端。

区分客户端运行与系统代理

内核启动成功,只表示本地代理端口已经监听;浏览器或其他程序是否经过该端口,还取决于系统代理、应用自身代理设置与 TUN 模式。初次配置建议先选择一个服务器,启用系统代理,再用浏览器验证。终端程序常常不会自动读取桌面系统的代理设置,需要单独配置环境变量或应用选项。把“内核是否运行”和“流量是否进入代理”分开检查,能快速缩小问题范围。

让路由规则处理不同流量

路由分流决定域名、IP 或应用流量应走代理、直连还是阻断。新用户可先使用客户端内置的基础规则,确认连接正常后再增加自定义项。规则顺序会影响匹配结果:更具体的域名与网段通常放在通用规则之前,避免被提前命中。修改后应重启内核并观察实际访问结果。与只提供单一开关的工具相比,V2Ray 生态允许把入站、出站、DNS 与路由组合管理,但也要求配置者保持规则边界清楚。

用日志确认链路停在哪一段

无法连接时先看客户端状态栏和内核日志,不要同时改动订阅、端口、DNS 与路由。日志中的端口占用通常指向本地程序冲突;配置解析错误说明字段格式或参数不完整;连接超时则需要继续区分服务器状态、网络路径与 DNS 解析。每次只改一个变量,重启后记录结果。这样的排查方式比连续切换服务器更慢一点,却能留下可复用的结论,也便于判断问题属于客户端界面还是底层内核。

平台下载入口

选择对应系统的客户端

首页只负责把平台分清。安装包类型、处理器架构与客户端差异集中放在下载页,避免在多个入口之间重复判断。

Windows

v2rayN

可在新一代桌面界面与经典 WPF 界面之间选择。前者适合新安装,后者适合沿用既有菜单习惯与配置流程。

前往下载

macOS

v2rayN

按设备处理器选择 Apple Silicon 或 Intel 安装包。安装后可使用与其他桌面系统相近的订阅和路由管理界面。

前往下载

Android

v2rayNG · v2flyNG

主流设备通常选择 arm64 安装包。v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核,可按协议配置与使用习惯决定。

前往下载

Linux

v2rayN

根据发行版的软件包体系选择 deb 或 rpm,并区分 x64 与 arm64 架构。桌面界面适合需要订阅分组和可视化路由的环境。

前往下载
快速上手预览

三步完成基础配置

先建立一条能验证的最短链路,再调整路由、DNS 与 TUN。这样出现问题时,可以清楚知道是哪一步改变了结果。

查看完整教程
  1. 01

    安装对应客户端

    进入下载页,按系统与处理器架构选择安装包。桌面端使用 v2rayN;Android 端先比较 v2rayNG 与 v2flyNG 的内核家族,再决定安装哪一个。安装完成后先打开客户端确认界面能够正常加载,不急着修改高级设置。

  2. 02

    添加订阅并更新列表

    从服务提供方复制完整订阅地址,在客户端的订阅管理中新增记录并填写便于识别的备注。保存后执行更新,等待服务器条目进入列表。多份订阅分开命名,不要把不同来源合并成一条难以追踪的记录。

  3. 03

    选择服务器并验证流量

    选中一条配置并启动内核,然后启用系统代理。先用浏览器验证基础访问,再测试需要单独代理设置的终端或应用。基础链路稳定后,才继续调整分流规则、DNS 或 TUN 模式,避免一次引入过多变量。

开源生态说明

Project V、V2Fly 与 Xray 的关系

客户端只是配置入口。真正处理协议、传输、路由和 DNS 的部分位于内核层。理解这层关系,选客户端和读日志都会更直接。

Project V 提供协议与配置体系的起点

Project V 形成了以 V2Ray 配置模型为核心的一套网络工具生态。配置通常由入站、出站、路由、DNS、传输与策略等部分组成。图形客户端把这些结构转换为菜单、表单和开关,降低日常管理成本,但底层概念仍然一致。理解“客户端生成配置、内核执行配置”这条边界后,遇到启动失败时就能先判断是界面保存问题、配置字段问题,还是内核运行阶段的问题。

VMess、VLESS、Trojan 等协议名称描述的是连接方式;TCP、WebSocket、gRPC 等描述传输层组合;TLS 与 REALITY 则涉及连接握手和身份验证。它们不是相互替代的一组单选项,而是可能分布在配置的不同层级。本站术语表按层级解释这些概念,避免只记缩写却不知道字段应放在哪里。

V2Fly 与 Xray 是两个持续演进的内核家族

V2Fly 延续 V2Ray Core 的社区维护路线,保留相对完整的配置体系和协议实现。Xray 在相近配置模型上继续扩展,加入不同的传输能力、协议实现与运行选项。两者存在大量共同概念,但支持范围、字段细节与更新节奏并不完全相同。导入分享链接或订阅时,客户端通常会根据自身内核转换配置;涉及较新的协议参数时,应确认服务端、分享格式、客户端和内核是否处在兼容链路上。

内核家族不是按操作系统划分。桌面端 v2rayN 可以管理内核和图形设置,Android 端则由 v2rayNG、v2flyNG 分别提供对应方向的实现。选择时不必追求功能名称最多,而应看现有订阅使用哪些协议、是否需要复杂路由,以及团队或个人是否希望在不同设备间复用相近的配置习惯。

三款客户端承担不同平台的图形管理

v2rayN 面向 Windows、macOS 与 Linux 桌面环境,提供订阅管理、服务器筛选、系统代理、路由规则、DNS、TUN 和日志查看等功能。桌面端需要同时处理操作系统代理与应用代理,因此 v2rayN 的价值不只是启动内核,也在于把系统设置、配置生成和运行状态放到可检查的流程里。

v2rayNG 是 Android 上常用的 Xray 内核客户端,适合通过订阅或分享链接管理配置,也提供按应用、路由和本地代理相关选项。v2flyNG 则面向 V2Fly 内核路线,可作为需要该内核家族时的选择。三款客户端都由开源社区持续维护,功能变化通常围绕内核兼容、平台适配、订阅解析和界面管理展开。

更新时同时看客户端、内核与配置兼容

一次客户端更新可能只改变界面,也可能同步调整内核、配置转换或系统集成。更新前应记录当前使用的订阅分组、路由规则与关键设置;更新后先验证内核启动,再确认系统代理、DNS 和 TUN 等功能。若旧配置无法直接运行,优先阅读错误日志并检查已经废弃或改名的字段,而不是把所有服务器条目重新导入。

开源维护的优势在于配置行为和问题讨论可以围绕明确的代码与版本变化展开,但用户仍需区分上游内核、客户端封装和订阅服务三方责任。本站的下载说明按平台整理客户端,教程负责操作路径,进阶手册则解释订阅分组、路由、DNS、TUN、FakeDNS 与自定义出站。三类文档分开写,查问题时更容易落到具体层级。

常见问题精选

先确认概念,再修改配置

下面四个问题覆盖新配置中最容易混在一起的环节。更完整的协议、路由与客户端术语可继续查看术语表。

打开术语表
v2rayN、v2rayNG 与 v2flyNG 应该怎么选?

Windows、macOS、Linux 桌面系统优先使用 v2rayN。Android 设备通常先选使用 Xray 内核的 v2rayNG;明确需要 V2Fly 内核家族时,再选择 v2flyNG。客户端名称相近,但平台定位和内核路线不同。

导入订阅后为什么没有服务器?

新增订阅记录后还需要执行更新。若列表仍为空,检查地址是否完整、订阅是否被分组过滤、更新日志是否返回解析错误。不要在尚未读取日志时连续删除和重建订阅。

系统代理开启后,终端为什么仍然直连?

不少终端工具不会自动读取桌面系统代理,需要设置应用参数或代理环境变量。先确认本地代理端口,再分别测试浏览器与终端,不要把两个结果当成同一条链路。

什么时候需要 TUN 模式?

当应用不支持代理设置、需要接管更广泛的系统流量,或普通系统代理无法覆盖目标程序时,可以评估 TUN。启用前先完成基础代理验证,并了解 DNS、路由与权限变化,便于出现问题时回退。