v2rayN · v2rayNG · v2flyNG 文档

V2Ray文档中心客户端与配置手册

下载v2rayN 查看教程

从图形客户端上手，按真实 JSON 配置理解入站、出站与路由；查阅中文操作说明。

订阅导入路由分流DNS 配置

CONFIGURATION / 配置章节

从界面选项到 JSON 键名

先分清请求从哪里进入、按什么条件匹配、最终交给哪个出站。再调整参数，排查结果才有明确边界。

v2rayN / v2rayNG / v2flyNG

本地端口是应用入口

入站负责接收应用交来的请求，不等于远端服务器地址。桌面应用可以通过本地 SOCKS 入口连接内核，也可以在支持时读取系统代理。示例仅监听回环地址，适合本机使用；端口需要与客户端界面及应用设置一致。开启 UDP 只代表该入口允许处理相应请求，能否完成转发还取决于应用、出站和服务端。相比直接维护完整配置，图形客户端会生成多数入站字段；手动编辑前，应先确认当前配置是否会被重新生成。

{
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ]
}
查阅 inbounds 入站说明 →

CLIENTS / 平台选择

V2Ray 客户端下载入口

桌面系统选择 v2rayN；Android 优先了解 v2rayNG，再按内核兼容需求考虑 v2flyNG。先确认系统与处理器架构，再进入下载页选择安装包。

Windows

v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面，WPF 版面向熟悉经典操作布局的用户。两者的界面框架不同，实际可用功能仍需结合发行说明和所选内核判断，不应把界面差异直接当作协议差异。

已有配置时，先保留订阅分组、路由与 DNS 设置，再切换程序目录。首次使用可以先选一种界面完成导入和连接，避免同时运行两份客户端造成监听端口冲突或系统代理被反复改写。

前往下载

macOS

v2rayN 按 Apple Silicon 与 Intel 提供不同入口。在系统的“关于本机”中确认芯片信息后，选择匹配架构的安装包。跨平台界面保持相近的配置思路，但权限提示、菜单位置和系统代理入口可能与其他桌面系统不同。

启动后先确认程序能读取配置目录，再导入订阅。若系统代理已经启用而应用仍未使用代理，检查应用自身的网络设置；对于不读取系统代理的工具，应按其说明单独指定本地地址与端口。

前往下载

Android

v2rayNG 使用 Xray 内核，适合需要相应协议与传输能力的场景；v2flyNG 是 V2Fly 内核备选。多数较新的设备可优先查看 arm64 入口，架构不明确时再了解通用包。具体兼容条件以下载页与设备信息为准。

首次启动连接时，系统会请求建立 VPN 接口的权限。这是客户端接收设备流量的入口，不等于已经连通远端服务器。后台限制、按应用分流和其他占用相同系统接口的程序，都可能改变连接表现。

前往下载

Linux

v2rayN 提供 deb 与 rpm 包入口，并区分 x64、arm64 架构。Debian、Ubuntu 系统通常选择 deb；Fedora 等系统通常选择 rpm。安装包格式负责与系统包管理方式对应，处理器架构则必须与当前设备匹配。

桌面环境对系统代理的支持并不完全一致。浏览器能访问而终端工具不能访问时，先检查各自入口，不要立即修改远端节点。开机自启动、配置目录写入权限和本地端口占用，也应分开验证。

前往下载

查看全部客户端 →

FIRST CONNECTION / 快速上手

导入、选择模式、验证连接

查看完整教程 →

开始前需要准备可用的订阅地址或单个节点参数。客户端负责保存配置和启动内核，安装程序本身不提供远端连接资料。以下步骤以图形界面为主，先建立最小可用路径，再逐步加入分流与自定义设置。

  1. 导入订阅，确认字段完整

    在 v2rayN 的订阅分组中添加地址，填写便于识别的名称，再执行更新；Android 客户端也应先保存订阅分组，再更新节点列表。单条分享链接可以通过剪贴板导入，但分享链接与订阅地址不是同一种输入，放错入口可能导致解析失败。

    列表出现条目后，检查协议、服务器地址、端口、传输方式和安全设置是否保留。节点名称只是显示标签，不能代替参数核对。订阅更新可能覆盖手动调整的条目，因此需要长期保留的修改，应使用独立配置或客户端提供的覆盖功能，并记录修改来源。

    订阅地址可能包含访问凭据，排查时不要把完整地址放进截图。若列表为空，先看更新结果属于地址无法访问、返回内容不兼容，还是解析出错，再决定是否重新导入。

  2. 选择节点，分清代理与路由

    设定活动节点后，再选择系统代理入口与路由模式。系统代理决定哪些遵循系统设置的应用会把请求交给客户端；路由模式决定请求进入内核后使用直连还是代理出站。名称中都有“代理”，并不意味着它们处于同一层。

    首次验证可以先使用规则较少、路径明确的设置。需要访问局域网资源时，再确认私有地址规则是否优先匹配。“绕过大陆”通常依赖域名与地址规则数据，不能只看到模式名称就断定所有应用都会按预期分流。切换后应建立新连接，再观察实际行为。

    Android 上还应核对按应用代理的范围：只代理选中应用和绕过选中应用含义相反。调试期间一次只改变一个设置，保留上一步已验证可用的节点，避免把入口问题与节点问题混在一起。

  3. 建立新连接，按层验证

    启动连接后，先确认客户端没有立即报告配置错误，再用目标应用发起一次新请求。列表中的测试结果只反映特定测试方法，不等同于浏览器页面、文件传输或实时通信一定可用。判断结果时，应以实际使用的应用和目标为准。

    若连接失败，按本地入口、域名解析、远端连接、协议握手的顺序检查。应用未经过本地入口时，反复修改远端参数通常没有帮助；已经到达远端但握手失败时，则需要核对协议字段、安全参数和系统时间。日志中的错误类型可以帮助区分这两种情况。

    完成验证后，再添加自定义路由、后台运行和自启动设置。退出客户端前恢复不再使用的系统代理，避免应用继续指向已经停止监听的本地端口。完整教程进一步说明每一步的操作入口与常见分支。

PROJECT V / 内核与客户端

开源生态与配置边界

客户端管理配置，内核执行连接。项目之间存在技术传承，但协议支持、字段含义与更新节奏需要分别核对。

Project V、V2Fly 与 Xray

Project V 是理解 V2Ray 技术背景的起点。V2Ray 将代理功能拆成入站、出站、传输、路由等模块，使本地应用入口与远端连接方式可以分别配置。V2Fly 延续 V2Ray 的社区维护；Xray 从相关技术基础发展出自己的实现与扩展。两者共享部分配置概念，但并非所有字段与协议组合都可以互换。

阅读资料时，应先确认说明针对哪一种内核，再看客户端是否能生成对应配置。例如，REALITY 属于与安全传输相关的技术组合，不宜简单当作与所有代理协议并列的单一选项。某个客户端出现相应设置入口，也需要远端参数和实际内核同时匹配，才能建立连接。

图形界面不等于内核本身

v2rayN 负责桌面端的节点列表、订阅、路由预设与内核调用；v2rayNG 在 Android 上结合系统 VPN 接口和 Xray 内核处理流量；v2flyNG 则提供基于 V2Fly 的另一条配置路径。三个客户端都是开源项目，但它们的界面操作、配置生成方式和兼容范围不能仅凭相似名称推断。

界面保存成功只说明参数已被记录。内核还需要读取生成的配置、完成解析，并与远端协商。自定义配置模式与普通节点模式可能采用不同的生成流程，因此直接修改生成文件未必能够长期保留。修改前应确认文件是配置来源，还是客户端运行时生成的结果。

配置资料的阅读顺序

只需要连接时，先读快速上手；想理解“节点”“订阅”“传输”等名称时，再查术语手册；需要自定义行为时，进入 JSON 手册按配置段阅读。示例代码用于解释局部结构，不能把缺少出站信息的片段当成完整连接配置。组合片段时，还要检查标签引用、数组层级和规则顺序。

查阅术语手册 阅读 JSON 手册

READING NOTES / 专题文章

客户端选型与分层排查

查看全部文章 →

基础连接建立后，再围绕具体问题查阅专题。安装包选型看系统与界面框架，速度问题看线路与本地入口，协议选择则看远端配置和内核能力。把这些问题分开，才能判断哪些设置值得调整。

需要查找某个配置键时，可直接进入 JSON 手册；需要辨认订阅、节点和内核的区别时，可从 术语手册开始。