v2rayN · v2rayNG · v2flyNG

V2Ray全平台下载客户端与配置指南

下载v2rayN 查看教程

整理四平台客户端入口，从订阅导入到路由与 DNS 配置，按操作顺序说明设置边界。

  • VMess
  • VLESS
  • Trojan
  • REALITY

CONFIGURATION LAYERS

V2Ray 配置分层

先识别设置属于哪一层，再修改对应入口。客户端的订阅管理、系统代理开关与内核配置各有职责，不能用一个“已连接”状态代替整条链路的检查。

应用如何进入本地代理

入站决定客户端从哪里接收连接。常见方式是在本机监听 SOCKS 或 HTTP 端口，再让应用或系统代理指向该端口。导入服务器并不等于应用已经使用代理；排查时先确认监听地址、端口与应用设置一致。仅供本机使用时通常绑定回环地址，向局域网开放则需要额外检查访问控制与防火墙。相较逐个应用手动填写地址，系统代理更便于统一设置，但是否遵循该设置仍由应用决定。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": { "udp": true }
    }
  ]
}
查看入站与接管方式 →

配置片段用于辨认结构，不是完整连接配置。实际运行还需要有效的服务器信息以及相互对应的标签。不同内核对字段和协议特性的支持可能存在差异，修改前应确认客户端当前选择的内核。建议先保存一份能够正常工作的配置，每次只调整一个层次，再用相同的应用和目标地址验证结果。若订阅更新会重新生成配置，应在客户端提供的规则或自定义设置入口修改，避免直接改动临时生成文件。

CLIENT SHELF

四平台下载入口

桌面端以 v2rayN 为主，安卓端优先了解 v2rayNG，再根据 V2Fly 内核需求考虑 v2flyNG。先选操作系统，再核对处理器架构与安装格式；客户端名称相近，不代表安装包可以互换。

Windows

选择 v2rayN。下载中心区分采用跨平台界面的桌面版与保留经典界面的 WPF 版，两者都用于管理服务器、订阅和路由。初次安装先按系统要求选择一个入口，不必为了导入同一订阅同时运行两套客户端。

安装后先确认本地代理端口，再设置系统代理。应用没有遵循系统代理时，可单独配置应用代理或进一步了解 TUN 模式。两套客户端同时接管系统设置可能产生端口占用或代理指向混淆，排查时应只保留一套运行环境。

前往下载 Windows 客户端安装后的操作步骤

macOS

选择 v2rayN 的桌面客户端，根据电脑芯片区分 Apple Silicon 与 Intel 安装入口。可在系统的“关于本机”中查看芯片或处理器信息，再选择对应架构，不需要通过反复安装来判断。

首次运行时留意系统权限提示，并检查网络代理是否已经指向客户端监听端口。若后来关闭客户端，仍无法正常访问网络，应先检查系统代理残留。TUN 涉及更深一层的流量接管，启用前应阅读权限与路由说明，不能将它视为所有连接问题的通用修复开关。

前往下载 macOS 客户端了解 TUN 设置

Android

优先选择采用 Xray 内核的 v2rayNG；已有配置依赖 V2Fly 特性时，再查看 v2flyNG。下载中心分别提供 arm64 与通用版入口。较新的主流设备通常使用 arm64，无法确认架构时应先查看设备信息与对应包的要求。

首次启动连接需要确认系统 VPN 授权。分应用设置决定哪些应用进入代理通道，与服务器路由规则不是同一层。若连接在后台中断，可检查系统电池管理和后台运行限制；同时确认其他使用 VPN 通道的应用是否占用了接管位置，再判断是否需要调整客户端设置。

前往下载 Android 客户端比较两款安卓客户端

Linux

选择 v2rayN，并按发行版软件包体系区分 deb 与 rpm，再核对 x64 或 arm64 架构。这里提供图形客户端入口；能否直接运行还取决于桌面环境、运行依赖与软件包要求，不应仅根据发行版名称判断。

不同桌面环境和应用读取代理设置的方式可能不同。先用能够显式填写代理地址的应用验证本地端口，再检查桌面环境的系统代理。需要 TUN 时另行处理权限与路由，避免同时运行多个会修改网络接口的工具。更新前保存订阅分组和自定义规则，便于回查行为变化。

前往下载 Linux 客户端阅读进阶配置
查看全部客户端

下载前先确认配置来源

客户端负责运行与管理配置，安装包本身不提供服务器地址、账户或订阅。已有分享链接时，应确认它对应的协议和传输特性；已有订阅地址时，应确认客户端能够识别返回格式。将网页地址误当作订阅地址，或把单条分享链接填进订阅更新入口，都可能导致列表为空。遇到导入失败，先识别输入内容的类型，再检查地址是否完整，避免反复重装客户端。

安装完成后的验证应分两步：先确认客户端能够读取服务器配置并启动内核，再确认目标应用的请求确实经过预期路径。仅有服务器列表、连接开关或一次测试结果，都不足以说明所有应用已经使用相同出口。涉及订阅、服务器记录或日志的截图，应遮盖访问地址中的个人标识与认证信息，保留必要的错误类别和设置名称即可。

PROJECT V ECOSYSTEM

开源生态与内核选择

区分项目、内核、客户端和服务器配置，有助于判断功能来自哪里，也能缩小排查范围。相似的名称不代表相同的配置能力。

PROJECT / CORE / CLIENT

Project V
代理工具与相关组件的项目背景
V2Fly · Xray
具有共同技术渊源的内核家族
v2rayN · v2rayNG · v2flyNG
面向用户的图形配置与运行入口
查看概念速查 →

Project V 与 V2Ray 的技术背景

Project V 围绕代理通信提供相关工具与组件，V2Ray 是这一生态中广为使用的名称。实际使用时，用户通常通过图形客户端导入服务器、启动内核并管理代理设置，而不是直接编辑所有运行参数。内核负责处理协议、传输和路由等逻辑；图形客户端负责将常用操作组织成界面。理解这一分工，才能解释为什么更换界面不一定改变协议能力，而切换内核却可能影响配置是否被接受。

“V2Ray 配置”在日常交流中可能指服务器分享链接、客户端保存的记录，也可能指内核读取的 JSON 文件。这些内容不能直接混用。分享链接通常只描述一个服务器，订阅用于批量分发记录，内核配置则还包含本地入站和路由。开始排查前先确认当前讨论的是哪一种对象，可以避免把客户端的订阅选项误写进内核配置。

V2Fly 与 Xray 的关系

V2Fly 延续了 V2Ray 相关内核的社区发展，Xray 则从共同的技术基础发展出自己的实现与特性。两者共享部分概念和配置习惯，但不能据此假定全部字段、协议组合或传输行为完全一致。选择时应围绕现有服务器配置需要什么功能，以及客户端实际集成了什么内核，而不是仅按名称或界面外观判断。

例如，服务器使用的协议名称相同，仍可能因为传输层、安全参数或扩展功能不同而要求特定内核支持。遇到无法解析或无法启动，先查看错误信息中的字段与功能名称，再核对该配置的适用范围。把报错简单归结为服务器不可达，会遗漏配置尚未被内核接受这一更早的环节。

三款图形客户端的分工

v2rayN 是桌面端的配置与运行入口，覆盖本站列出的三类桌面系统，具体能力取决于所用发行包与内核设置。v2rayNG 面向安卓设备，本站按 Xray 内核方案介绍其常规使用；v2flyNG 则作为 V2Fly 内核方向的备选。三者均属于开源客户端，便于围绕公开的实现与配置行为理解功能，但它们不是服务器服务，也不会自动生成可用订阅。

已有配置能够在某一客户端正常使用时，迁移到另一客户端仍应核对导入格式、路由规则与接管方式。导入服务器通常不会同时迁移系统代理、分应用名单和本地自定义规则。迁移后先验证一个服务器与一个目标应用，再补回分组与分流设置，比一次复制全部环境更容易识别差异。具体选型可参阅客户端对比。

开源协议与更新边界

Project V 生态中的项目、内核和图形客户端可能采用不同的开源许可证。例如 V2Fly 的 V2Ray 核心与 Xray 核心采用 MPL 2.0，图形客户端自身及其附带组件则应分别查看对应许可说明。开源许可证描述代码使用、修改与再分发的条件，不等同于某个订阅来源的服务条款，也不代表服务器运行状态。使用者仍需要独立管理凭据、访问权限与服务器配置。

客户端更新、内核更新和订阅更新是三个不同动作。客户端更新可能改变界面与管理逻辑，内核更新可能影响配置解析与协议行为，订阅更新则主要刷新服务器记录。发生行为变化时，先记录变更属于哪一类，再对照更新前保留的设置。不要同时更换客户端、内核、DNS 与规则后才开始测试，否则很难识别是哪一项改变了连接路径。

FIELD NOTES

配置记录与故障排查

从订阅输入到网页访问，按故障发生的位置查找文章。导入阶段的问题先看链接与格式；客户端已经启动却无法访问时，再检查系统代理、路由和 DNS。不同阶段使用不同检查清单，避免重复执行无关步骤。

查看全部文章