V2Ray Configuration Reference
V2Ray 术语表:协议、内核、订阅与路由概念
按实际配置路径整理常见名词,区分协议、内核、客户端功能与测试指标。每个词条说明它解决的问题、依赖的参数,以及容易混淆的相邻概念。
5
分类
28
核心术语
4
覆盖平台
Quick Index
拼音与英文索引
已知术语名称时可直接跳转。英文协议名保留原始拼写,中文功能名按常用称呼排列。
协议与加密
协议规定客户端和服务端如何认证、封装与传输数据。订阅中出现的协议名称不能单独决定连接质量,实际可用性还取决于安全层、传输方式和服务端参数是否一致。
- VMess
- Project V 生态中使用的代理协议。客户端与服务端需要使用一致的用户标识、端口、传输方式和安全参数;其中任一项不匹配,都可能导致握手失败。VMess 是协议名称,不是客户端名称,也不能用于判断节点由哪一种图形界面管理。
- VLESS
- 一种结构较精简的代理协议,本身不额外承担数据加密,通常与 TLS 或 REALITY 等安全层组合使用。配置时除了地址、端口和用户标识,还要核对流控、安全方式、服务器名称等字段。VLESS 与 VMess 可以同时存在于同一个订阅中,客户端会按每条节点的协议分别处理。
- Trojan
- 以密码作为主要认证信息并通常运行在 TLS 之上的代理协议。客户端侧常见参数包括服务器地址、端口、密码、服务器名称与证书验证选项。Trojan 节点无法直接套用 VMess 或 VLESS 的认证字段,导入后应保持订阅提供的协议类型不变。
- Shadowsocks
- 采用预共享密码与指定加密方法工作的代理协议。配置重点是服务器地址、端口、密码和加密方式,双方必须使用同一套参数。它与 SOCKS 本地代理不是同一概念:前者描述客户端到服务端的协议,后者通常是应用连接本地客户端的一种接口。
- REALITY
- Xray 生态中的传输安全方案,常与 VLESS 组合。订阅节点中通常会同时携带服务器名称、公钥、短标识与指纹等参数,手动录入时需要逐项对应。REALITY 不是独立节点协议,因此配置界面里看到的完整组合通常仍以 VLESS 作为协议类型。
内核与生态
图形客户端负责界面、订阅和系统设置,内核负责实际协议连接、DNS 与路由处理。区分项目名称、内核分支和客户端名称,有助于判断某项配置到底由哪一层执行。
- Project V
- 围绕网络代理协议、路由能力与相关工具形成的开源技术生态。V2Ray 的配置体系、VMess 等协议以及后续内核分支均与其发展有关。它表示一组技术与项目背景,不等同于某个具体安装程序。
- V2Ray
- Project V 生态中常见的核心程序与配置体系名称,也经常被用作相关客户端生态的统称。严格区分时,V2Ray 内核与 v2rayN、v2rayNG 等图形客户端并不是同一软件。客户端可以封装内核能力,并提供订阅更新、节点选择和系统代理控制等操作入口。
- V2Fly
- 延续 V2Ray 技术路线的社区维护项目,提供 v2ray-core 及相关规范实现。v2flyNG 等客户端名称中的 v2fly 指向这一内核生态。遇到配置兼容问题时,应同时确认客户端版本、内核分支和协议参数,而不是只看界面名称。
- Xray
- 与 V2Ray 配置体系有较多关联的内核分支,支持 VLESS、REALITY 等能力,并被部分图形客户端采用。Xray 是内核,不是订阅服务,也不是某一种连接模式。客户端界面中的协议支持范围,通常取决于所附内核及客户端自身的配置适配。
- v2rayN
- 面向 Windows、macOS 与 Linux 的图形客户端,用于管理订阅、节点、系统代理、路由和 TUN 等功能。v2rayN 会把界面中的设置转换为内核可以读取的运行配置。排查问题时可分别检查客户端操作、生成的配置逻辑与内核日志。
订阅与节点
订阅解决批量分发和更新配置的问题,节点则是可以被实际选中的单条连接记录。客户端保存的本地列表会随更新变化,因此手动修改前要先确认后续更新是否会覆盖该内容。
- 订阅
- 由服务提供方生成的配置集合地址,客户端通过该地址取得节点信息。订阅地址本身通常不是一个可直接连接的节点,而是节点列表的来源。导入后还需要执行更新,客户端才能请求内容并写入本地数据库。
- 节点
- 客户端内一条可选择的服务器连接配置,包含地址、端口、协议、认证与传输参数。节点名称主要用于识别,真正决定连接行为的是内部配置字段。选择节点后还要启动内核,并根据使用场景启用系统代理或 TUN 模式。
- 订阅分组
- 将不同订阅来源分别管理的客户端功能,可独立设置备注、更新间隔和筛选条件。分组有助于区分节点来源,也便于只更新某一份订阅。删除分组时通常会同时影响归属于该来源的节点,操作前应确认客户端提示的范围。
- 订阅更新
- 客户端重新请求订阅地址并用返回内容刷新节点列表的过程。它不等同于升级客户端程序,也不会主动修复服务端配置。更新后节点增减、名称变化或参数调整,通常来自订阅源返回的新内容。
- 节点过滤
- 按照节点名称中的地区、倍率、协议或自定义关键词筛选订阅内容的管理方法。过滤可以减少列表中的无关条目,但不会改善节点本身的连接质量。使用排除规则时应检查关键词范围,避免把仍需使用的节点一并隐藏。
路由与分流
路由系统先识别连接目标,再按照规则顺序选择出站。域名解析发生在哪一层、应用是否遵循系统代理,以及 TUN 是否接管流量,都会改变最终可参与匹配的信息。
- 路由规则
- 根据域名、IP、端口、协议或进程等条件决定流量应直连、代理或阻断的一组匹配规则。规则通常按顺序判断,先命中的结果会影响后续处理。修改规则后应使用明确的测试目标验证,不宜只根据节点显示状态判断分流结果。
- 分流
- 把不同目标流量分配给不同出站方式的配置思路。例如一部分连接可直接访问,另一部分交给选定节点处理。分流不是单一开关,它由匹配数据、规则优先级、DNS 策略和出站配置共同组成。
- GeoIP
- 用于按 IP 地址所属地区进行路由匹配的数据集合。它只在目标已经解析为 IP,或规则直接处理 IP 地址时发挥作用。IP 归属数据会随网络资源调整而变化,因此相同规则在不同数据版本下可能得到不同匹配结果。
- GeoSite
- 按域名类别整理的规则数据集合,可供路由引擎批量匹配一组域名。它处理的是域名规则,不等同于 GeoIP 的地址归属判断。实际使用时应留意分类名称、匹配方式和规则顺序,避免把域名集合与 IP 集合混为一谈。
- 系统代理
- 由客户端修改操作系统代理设置,使遵循该设置的应用把 HTTP 或 SOCKS 请求交给本地代理端口。并非所有程序都会读取系统代理设置,因此客户端显示“已开启”不代表全部流量都已接管。浏览器与常规桌面应用通常优先通过这种模式开始测试。
- TUN 模式
- 通过虚拟网络接口接管更多系统流量的运行方式,适用于不读取系统代理设置的应用。TUN 模式会涉及路由表、DNS 和虚拟网卡权限,启用前应先确认普通节点连接已经可用。若开启后网络异常,可先关闭 TUN,再分别检查权限、DNS 与路由设置。
- FakeDNS
- 为域名临时返回保留地址,并在后续连接阶段恢复域名信息的 DNS 处理机制。它常与 TUN 模式和域名分流配合,使只提供目标 IP 的连接仍可依据原始域名匹配规则。FakeDNS 地址是内部映射结果,不应被理解为目标服务器的真实地址。
连接与诊断
诊断指标必须结合测试方法解释。Ping、真连接延迟和下载测速观察的是不同阶段;连接失败时,则应依次检查订阅内容、节点参数、内核日志、系统接管方式和 DNS 路径。
- 延迟
- 数据完成一次往返所需的时间,通常以毫秒表示。不同测试方法覆盖的链路范围不同,数值不能脱离测试类型单独比较。较低的 Ping 不一定代表代理握手更快,也不能直接推导出下载带宽更高。
- 真连接延迟
- 客户端通过代理节点完成实际连接请求所测得的耗时,包含代理握手和目标连接过程。与仅检测服务器网络可达性的 Ping 相比,它更接近日常打开网页时的连接阶段。测试失败通常表示完整代理链路未建立,但仍需结合日志定位具体原因。
- 下载测速
- 通过实际传输数据估算节点可用吞吐能力的测试方式。结果会受到测试目标、本地网络、节点负载、传输协议和测试时段影响。测速会产生实际流量,适合在真连接延迟已经通过后,用于判断大文件传输或视频加载能力。
- DNS 泄漏
- 代理连接已启用,但部分域名查询仍经由未按预期使用的 DNS 路径发出的现象。它与代理节点是否能建立连接是两个不同问题。排查时需要确认应用查询方式、系统 DNS、客户端 DNS 配置和 TUN 接管范围,而不能只更换节点。
- 握手
- 客户端与服务端建立协议会话并协商必要参数的阶段。认证信息、TLS、服务器名称、公钥或传输层配置不一致,通常会在此阶段暴露错误。日志中的握手失败比界面上的通用连接失败提示更具体,适合用于缩小检查范围。
- 丢包
- 数据包在传输过程中未能到达目标的现象。持续丢包可能造成连接重试、速度波动、语音卡顿或会话中断,但偶发测试结果也可能来自本地无线网络。判断时应在不同时间重复测试,并区分本地链路、服务器链路与目标站点链路。