V2Ray 客户端 · 中文配置指南

V2Ray中文网客户端与配置教程

按设备选择开源客户端,从订阅导入开始,逐项配置路由与 DNS。

VMess / VLESS Xray / V2Fly 中文操作说明
图形客户端 v2rayN / v2rayNG / v2flyNG 内核家族 Xray · V2Fly 配置入口 订阅 / 分享链接 / JSON

设置目录 / CLIENT SETTINGS

V2Ray 配置
先看这五项

图形客户端负责整理配置,内核负责实际连接。先导入服务器信息,再确定哪些应用经过代理,最后核对路由和域名解析;不要一次更改所有选项。

按顺序完成首次配置 →
v2rayN / v2rayNG
订阅分组设置

订阅链接与单条分享链接

订阅用于集中获取服务器配置,单条分享链接只导入一条记录。v2rayN 可在「订阅分组设置」中添加地址,保存后执行订阅更新;v2rayNG 可从菜单进入同名设置。剪贴板导入适合已复制的分享链接,不能把网页标题当作配置。导入后先核对分组、协议和地址,再选为活动服务器。订阅更新失败时保留原有记录,先检查链接是否完整,不要反复删除分组;订阅地址可能包含访问凭据,截图时应遮盖。

v2rayN
订阅分组 → 订阅分组设置 → 添加
保存分组 → 更新订阅

v2rayNG
菜单 → 从剪贴板导入
查看订阅导入步骤 →

先导入,再连接

平台选择 / DOWNLOAD ENTRY

按系统选择客户端

先确认操作系统,再确认处理器架构。下面的入口会打开下载页对应平台;桌面端与安卓端使用不同客户端,不要按名称相似程度选择安装包。

Windows

v2rayN · Desktop / WPF

v2rayN 提供 Desktop 与经典 WPF 两种界面。Desktop 使用跨平台界面方案,WPF 保留熟悉的桌面操作方式;两者都需要继续完成订阅导入和代理设置。首次安装按下载页说明确认系统与运行环境,不要把一种界面的设置路径机械套用到另一种界面。

解压包应放在可写的独立目录,避免直接在压缩软件窗口内运行。迁移已有配置前先退出旧实例,保留原配置备份,再检查本地监听端口是否冲突。出现启动错误时,先看运行环境提示,再处理代理设置。

前往下载 Windows 客户端

macOS

v2rayN · Apple Silicon / Intel

先在「关于本机」查看芯片信息:Apple 芯片选择 Apple Silicon,Intel 处理器选择 Intel。安装完成后将应用放到固定位置,再处理系统给出的安全与网络授权提示。架构选错可能导致应用无法启动,不能通过修改订阅解决。

系统代理与更广泛的网络接管涉及不同权限,首次使用建议先完成基本代理链路验证。遇到开发者验证提示时,应先确认安装来源与系统提示内容,再按对应教程操作;不要为了消除提示而批量关闭系统保护设置。

前往下载 macOS 客户端

Android

v2rayNG 优先 · v2flyNG 备选

优先查看使用 Xray 内核的 v2rayNG;需要 V2Fly 内核配置时,再考虑 v2flyNG。多数较新的设备可选择 arm64,设备架构不明确时查看系统信息或选择通用包。两款客户端分别维护配置,安装另一款并不会自动迁移原有订阅。

首次连接通常需要确认系统 VPN 授权。后台连接被中断时,检查电池优化和后台运行限制,而不是先更换协议参数。同一时刻应明确由哪个应用接管 VPN;测试结束后关闭不使用的连接,避免把应用之间的接管冲突误判为服务器故障。

前往下载 Android 客户端

Linux

v2rayN · deb / rpm

根据发行版的软件包管理方式选择 deb 或 rpm,再区分 x64 与 arm64。安装包格式、处理器架构和桌面运行环境是不同条件,文件可以下载不代表当前系统一定能够运行。安装报依赖错误时,先查看软件包管理器的具体提示。

不同桌面环境对系统代理的支持存在差异,部分程序仍需独立设置代理地址。先用明确支持代理的应用验证本地监听,再决定是否使用其他接管方式。需要额外权限的功能只在理解用途后开启,不建议把整个图形客户端长期以高权限运行。

前往下载 Linux 客户端
查看全部客户端 →

开源生态 / PROJECT & CORE

客户端、内核
与协议的关系

选择客户端时看平台,判断配置能否运行时看内核。界面相似、订阅相同,都不等于功能完全一致。

图形客户端导入 · 编辑 · 启停

代理内核握手 · 传输 · 分流

服务器配置协议 · 地址 · 安全层

阅读协议与内核技术参考 →

Project V:模块化代理工具的背景

V2Ray 源于 Project V 的模块化代理工具体系。它将流量入口、出站连接、传输方式与路由规则分开组织,使同一套内核能够适应不同使用场景。用户在图形界面里填写的服务器信息,最终通常会转换为内核读取的配置。因此,「V2Ray」有时指技术生态,有时指具体内核,不能把它简单理解为某一个桌面窗口或某一款安卓应用。

对首次使用者而言,这种分层最实际的意义是排错可以分步进行:应用是否接入本地代理、内核是否正常启动、服务器参数是否匹配,分别对应不同环节。只有先确定故障发生在哪一层,后续修改才有依据。重新安装界面程序不会自动修复服务器端的证书问题,更换订阅也不会消除本地端口冲突。

V2Fly 与 Xray:同源发展,不是同一功能清单

V2Fly 是 V2Ray 的社区维护延续,Xray 则从相关代码基础分支发展,形成自己的功能演进路线。两者共享部分配置概念,但扩展特性、字段支持和更新节奏并不完全一致。读取配置时应以实际使用的内核为准,而不是仅凭客户端名称包含相同字母就判断支持情况。技术参考页会按协议与安全层拆开比较,帮助确认配置需要哪些能力。

例如 VMess、VLESS、Trojan 与 Shadowsocks 属于协议选项,WebSocket 等属于传输方式,TLS 与 REALITY 又涉及安全层。它们不是一张互斥的同类名单。订阅中出现一个熟悉的协议名,也不能说明整条配置一定兼容;还要核对传输、安全层、服务器名称和相关扩展。服务器端与客户端参数需要成套匹配,单方面替换协议通常无法建立连接。

三款开源客户端:界面与内核分别维护

v2rayN 面向桌面系统,提供服务器列表、订阅分组、系统代理和路由等图形入口;v2rayNG 面向安卓设备,主要结合 Xray 内核使用;v2flyNG 则提供面向 V2Fly 内核的安卓使用路径。三者均属于开源客户端项目,客户端本身不等于服务器服务。安装完成后仍需使用有权访问的服务器配置,客户端名称也不能作为某个订阅来源可信的证明。

开源许可证约束代码的使用、修改和分发,不等于承诺任何网络环境下都能连接。界面程序、内核及其依赖组件可能适用不同许可证,具体权利义务应查看对应发行资料。对于日常使用,开源生态的价值在于实现方式和配置逻辑可以被讨论、检查与改进,而不是把某个项目标签直接等同于性能或隐私结论。

更新机制:客户端更新与订阅更新分开处理

客户端更新通常涉及界面、配置生成逻辑、依赖与随包内核;订阅更新则刷新服务器记录。二者解决的问题不同。缺少某种协议特性时,应检查内核支持与客户端配置生成能力;地址过期或服务器参数变化时,应检查订阅。不要把一次订阅更新理解为客户端已经升级,也不要认为更新界面后所有自定义配置都会自动适配。

更新前先备份本地设置,记录当前使用的代理方式和路由规则。更新后先验证原有基本连接,再逐步恢复自定义 DNS、规则和高级接管方式。如果出现新的错误,保留具体日志,比较更新前后的设置差异。下载页集中提供安装入口,首页不固定展示版本信息,避免将客户端选择与短期发行变化混在一起。

首次配置 / QUICK CHECK

连接前的常见问题

下面按首次使用的顺序检查。每次只改一项并重新测试,可以保留清晰的排错线索。

客户端安装完成,为什么列表仍然为空?

客户端是管理配置和启动内核的工具,安装包本身不提供服务器记录。先导入完整的分享链接,或在订阅分组中添加订阅地址并执行更新。若更新后仍为空,检查分组筛选、链接有效性和返回格式,不要将网页地址或说明文字当作分享链接。查看导入步骤 →

显示已连接,为什么部分应用没有使用代理?

已连接通常说明客户端或内核进入运行状态,不代表所有应用的流量都被接管。桌面端先确认系统代理已配置,再确认目标应用是否遵循系统设置;安卓端还需检查是否启用按应用分流。路由只处理已经进入内核的流量,单独更换路由模式不能解决入口缺失。查看代理模式说明 →

连接失败时,应该先换 DNS 还是先换协议?

先看日志中的错误阶段。连接超时、域名解析失败、证书验证失败和配置解析失败需要不同处理。检查系统时间、服务器地址、端口和安全层参数,再根据错误定位 DNS。协议必须与服务器配置匹配,不能将随意更换协议作为通用修复方法。查看 DNS 排查步骤 →

切换设备时,可以直接复制全部客户端配置吗?

优先迁移订阅或兼容的分享链接,再分别调整每台设备的系统代理、监听地址与路由。桌面环境的目录、端口占用和网络权限与安卓设备不同,自定义 JSON 也可能依赖特定内核字段。迁移后先测试一条基本配置,确认可用后再恢复复杂规则。核对配置兼容性 →

使用心得 / RECENT NOTES

安装与排错记录

从平台权限、订阅更新和配置结构三个角度补充操作细节。遇到问题先保留报错原文,再对照对应检查项,不必从头重装所有组件。

查看全部文章 →