客户端安装 / 配置文件 / 路由规则

V2Ray 配置教程

从订阅导入开始,读懂配置文件与路由分流。

  • JSON
  • Xray · V2Fly
  • 代码开源

CLIENT SETTINGS / 客户端设置

V2Ray 使用教程,从设置项开始

先分清客户端界面与代理内核的职责,再逐项配置。客户端负责保存服务器信息、更新订阅和生成运行配置;内核负责接收连接、匹配路由并转发流量。下面五个入口按实际操作顺序排列,窗口仅用于说明菜单和配置关系,不代表当前设备的运行状态。

v2rayN / 订阅分组设置 · 界面示意
  • 服务器
  • 订阅分组
  • 设置
  • 路由设置
分组名称日常使用
订阅地址粘贴完整链接
更新订阅从直连开始

更新完成后,在服务器列表中选择活动配置。

订阅地址与分享链接

订阅地址用于批量获取并更新服务器配置,分享链接通常只描述一条配置。v2rayN 可在订阅分组设置中保存地址,再执行更新;v2rayNG 可从订阅分组入口添加。导入前确认复制的是完整链接,而不是网页标题或登录页面地址。首次更新优先使用直连;只有订阅服务明确需要代理访问时,再尝试通过代理更新。地址可能包含访问凭据,不宜出现在公开截图中。导入成功后仍需选择活动配置,列表出现条目并不代表连接已经建立。

查看配置参考 →

第一次配置:先建立最短连接路径

准备好可用的服务器配置或订阅地址,导入后选中一条配置,再开启合适的代理入口。先用浏览器访问一个已知可达的目标,并观察客户端日志是否出现对应连接。这个过程只验证当前配置与当前应用,不需要立刻启用复杂路由、虚拟接口或自定义 DNS。基础路径可以正常工作后,再逐项加入额外设置,每次修改都保留能够恢复的状态。

测试结果也要分开看。服务器条目存在,说明格式已被客户端接受;端口测试有结果,说明某一层连接可能可达;实际网页能够访问,才进一步涉及域名解析、传输握手和应用请求。不同测试测量的对象并不相同。遇到结果矛盾时,记录测试方式和日志,比只比较一个延迟数字更有帮助。

阅读配置:沿着流量方向查字段

理解 JSON 时,可以依次阅读入站、路由和出站。入站描述本地连接从哪里进入;路由描述如何选择处理路径;出站描述最终向哪里转发。DNS 负责相关解析,策略项则调整连接管理行为。教程中的端口和规则只是语法示例,实际使用时应以客户端设置为准,尤其不要假定所有客户端都采用相同的默认端口。

图形客户端可能在启动时重新生成配置文件,因此直接修改生成文件未必能够长期保留。优先使用界面提供的自定义路由或配置入口,修改前导出备份。需要核对字段类型、数组结构和标签对应关系时,继续阅读V2Ray 配置文件参考;不熟悉入站、出站和传输等名称时,可先查阅术语表。

DOWNLOAD / 平台与安装包

v2rayN 下载,按设备选择

桌面平台选择 v2rayN,Android 优先查看 v2rayNG,也可根据 V2Fly 配置需求了解 v2flyNG。先确认操作系统、处理器架构与安装包格式,再进入下载页选择具体文件。客户端与订阅是两件事:安装客户端不会自动获得服务器配置,导入订阅也不会替代系统所需的安装与授权步骤。

Windows

v2rayN / Desktop · WPF

下载页提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典桌面交互。选择时结合系统环境与使用习惯,不需要为同一组配置同时运行两个客户端。安装前先关闭旧实例,避免本地监听端口被占用。

首次启动后,先导入配置并确认本地服务已经启动,再设置系统代理。如果浏览器仍沿用自己的代理扩展或手动设置,需要单独检查其连接入口。更换监听端口后,依赖该端口的应用也要同步修改。

前往下载 Windows 客户端

macOS

v2rayN / Apple Silicon · Intel

先在系统的“关于本机”中确认芯片类型,再选择 Apple Silicon 或 Intel 安装包。架构选择与服务器协议无关,不能根据订阅名称判断。按照安装提示完成应用放置,首次运行时阅读系统给出的权限与安全提示。

系统代理与 TUN 模式的授权范围不同,建议先用普通代理验证连接。若只是某个应用无法访问,先检查该应用是否遵循系统代理,不要直接扩大到全设备流量接管。下载页集中列出架构入口及安装前需要确认的事项。

前往下载 macOS 客户端

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核;v2flyNG 使用 V2Fly 内核,可作为对应配置需求的备选。多数较新的设备可先查看 arm64 安装包,架构不明确时再了解通用包。最终能否安装还取决于系统与应用要求,不应仅凭设备购买年份判断。

导入后选择配置并启动连接,首次启动通常需要确认系统的网络连接请求。后台省电限制可能影响持续运行,出现锁屏后断开时应检查应用后台权限。订阅地址与二维码都可能携带访问凭据,分享操作截图前要遮挡相关内容。

前往下载 Android 客户端

Linux

v2rayN / deb · rpm

按发行版的软件包体系选择 deb 或 rpm,再确认设备使用 x64 还是 arm64 架构。包格式与处理器架构是两个独立条件,文件可以下载并不代表能够在当前环境安装。桌面环境及相关运行依赖也需要符合客户端要求。

不同桌面环境对系统代理的支持方式可能不同,终端程序也未必读取桌面代理设置。验证时应区分浏览器连接与命令行连接,分别确认它们的代理入口。先保证图形客户端与本地监听正常,再考虑虚拟接口权限和系统路由配置。

前往下载 Linux 客户端

设备上已经安装过客户端时,更新前先保存订阅分组、自定义规则及必要的应用设置。不要在未确认配置兼容性的情况下覆盖唯一可用的环境。安装包解决的是程序部署问题,连接问题仍应按配置、代理入口、路由与日志的顺序逐层检查。

查看全部客户端 →

PROJECT V / 内核与图形客户端

V2Ray 开源生态,区分项目与客户端

V2Ray 既是常见的检索名称,也关联到 Project V 生态中的具体软件与配置体系。日常操作主要发生在图形客户端里,实际转发则由所使用的内核执行。理解这层关系,才能正确判断一篇教程、一份 JSON 和当前安装的客户端是否适用。

生态背景

Project V

内核家族

V2Fly / Xray

图形客户端

v2rayN / v2rayNG / v2flyNG

Project V 与配置结构

Project V 以模块化的网络代理能力为基础,V2Ray 的配置围绕入站、出站、路由、DNS 和连接策略等部分展开。模块化意味着同一种本地入口可以配合不同出站,也意味着单个协议名称不足以描述完整连接。阅读配置时,需要同时看认证信息、传输方式与安全层,而不是只确认一项名称是否相同。

V2Fly 社区延续 V2Ray 相关实现与维护,Xray 则在相关技术基础上形成独立演进的内核项目。两者共享部分概念和配置习惯,但功能、字段与更新节奏并不完全一致。一份在某个内核中有效的配置,换到另一个内核后仍需核对支持情况,尤其是涉及特定传输与安全机制的字段。

图形客户端与开源属性

v2rayN、v2rayNG 和 v2flyNG 都是代码开源的图形客户端项目。开源让实现方式、改动记录与许可证条款能够被公开讨论,但不代表任意第三方配置都适合直接导入。客户端提供的便利主要在于管理配置、调用内核和展示日志;服务器参数是否有效、订阅内容是否可信,仍需要结合来源判断。

桌面端的 v2rayN 便于集中管理订阅、系统代理和路由。Android 端的 v2rayNG 与 v2flyNG 则围绕移动系统的连接授权和后台运行组织界面。三者不是同一程序的不同名称,菜单和设置也不必逐项一致。选择时先看设备与配置需求,再阅读对应客户端教程,避免把桌面菜单直接套到移动端。

开源协议与组件边界

开源许可证规定代码使用、修改与分发的条件,不等同于订阅服务的使用条款。内核、图形客户端与随附依赖可能采用不同许可证,需要以各项目随附说明为准。V2Ray 相关核心实现采用的 MIT 许可,以及 Xray-core 采用的 MPL 2.0,体现的是各自代码的授权规则,不能据此推断所有组件都使用同一种许可。

站点名称也不等于项目身份。本页是客户端与配置的中文阅读入口,介绍 Project V、V2Fly 与 Xray 的技术关系,不把教程站与内核项目混为一谈。判断某个功能是否存在,应以所安装客户端的界面、随附说明和实际运行日志为准,而不是仅凭搜索结果中的产品简称。

更新机制与故障定位

客户端更新、内核更新、订阅更新和路由资源更新分别解决不同问题。更新客户端可能改变界面或配置生成逻辑;更新订阅会重新取得服务器条目;更新路由资源则影响域名或地址集合的匹配。订阅更新通常不会替换客户端程序,安装新客户端也不意味着订阅中的服务器参数会自动修复。

出现故障时,先记录最近改动,再检查日志。配置解析失败优先查字段、格式与内核兼容性;本地端口占用优先查重复实例;握手失败需要核对时间、目标地址和安全层参数。公开日志前应移除订阅地址、用户标识及认证内容。分层排查比同时重装、切换内核和重写路由更容易保留线索。

READING NOTES / 配置专题

V2Ray 技术文章,按问题阅读

基础连接已经建立后,再按具体问题补充知识。导入失败适合先读格式说明,配置选型适合查看协议对比,连接异常则从运行日志入手。专题文章分别处理一个问题,便于和配置参考中的字段说明交叉查阅。

下载客户端