REFERENCE / GLOSSARY

V2Ray 协议、内核与配置术语表

按配置链路整理常用概念,覆盖协议字段、内核关系、客户端模式、订阅节点、路由分流与 DNS。每个词条说明它解决什么问题、与相邻概念有什么区别,以及配置时应关注哪些边界。

READING PATH

从连接配置到流量出口

一条完整连接通常由客户端界面生成配置,交给 V2Fly 或 Xray 内核执行。内核先从入站接收流量,再结合 DNS 与路由规则选择出站。订阅负责批量交付节点记录,VMess、VLESS、Trojan 等协议则描述其中的认证和传输参数。理解这些层次后,排查问题时可以更快区分订阅、节点、内核、解析和路由环节。

PROTOCOL / TRANSPORT

协议与传输

协议处理认证与数据交换,传输安全层负责连接外观、加密协商或底层承载。一个协议名称通常不能替代完整配置。

VMess
Project V 生态中用于客户端与服务端交换数据的协议,节点配置通常包含服务器地址、端口、用户标识、传输方式和安全设置。导入后仍需确保客户端时间、用户标识和服务端参数一致;只复制地址与端口并不能构成可用配置。
VLESS
采用轻量认证设计的协议,常与 TLS、REALITY、TCP、WebSocket 或 gRPC 等传输组合。VLESS 本身只描述连接体系中的一部分,服务器名称、公钥、短标识、路径等字段是否需要填写,取决于服务端采用的安全层和传输方式。
Trojan
以密码认证并通常配合 TLS 使用的协议。客户端需要同时匹配服务器地址、端口、密码、服务器名称和传输参数;如果证书名称与连接目标不一致,连接可能在安全协商阶段结束,而不是进入代理转发阶段。
REALITY
Xray 生态中的传输安全方案,常见组合是 VLESS 与 REALITY。配置时需要关注服务器名称、公钥、短标识、客户端指纹和流控等字段,字段必须与服务端保持对应。它属于连接安全层,不是独立的订阅格式或客户端名称。

CORE / ECOSYSTEM

内核与生态

图形客户端负责管理操作入口,内核负责读取配置并处理网络流量。区分项目生态、内核家族和具体客户端,有助于判断功能由哪一层提供。

Project V
围绕网络代理内核、协议和配置体系形成的开源技术生态。它不是某一个桌面按钮或单一安装包的名称,相关技术后来由不同社区与项目继续维护。阅读文档时应结合具体内核和客户端版本判断字段是否可用。
V2Fly
维护 v2ray-core 及相关规范、组件和文档的开源社区生态。V2Fly 内核可以被图形客户端调用,用于执行入站、出站、DNS、传输和路由配置。客户端界面中显示的功能范围,仍取决于客户端是否暴露对应内核选项。
Xray
与 Project V 技术体系相关的内核家族,支持 VMess、VLESS、Trojan、REALITY 等配置。v2rayNG 等客户端可以使用 Xray 处理实际连接。节点导入成功只表示配置被识别,不表示全部参数已经通过内核验证。
v2ray-core
由 V2Fly 维护的核心程序,读取结构化配置后处理入站、出站、DNS、传输与路由。它通常在图形客户端后台运行,用户通过客户端完成订阅更新和模式切换。日志中的配置解析、监听端口和路由错误通常来自这一执行层。

CLIENT / PLATFORM

客户端与平台

客户端把订阅、节点、内核和系统网络设置组织成可操作界面。系统代理与 TUN 是两种不同的流量接入方式。

v2rayN
面向 Windows、macOS 与 Linux 的桌面图形客户端,提供订阅管理、节点选择、系统代理、TUN 和路由配置。v2rayN 本身负责界面与配置调度,网络处理由随客户端运行的内核完成。不同桌面系统的权限与代理设置入口并不完全相同。
v2rayNG
面向 Android 的图形客户端,通常使用 Xray 内核处理连接。它可以导入订阅或单节点分享链接,并通过系统 VPN 服务接管选定流量。后台运行策略、电池限制和 VPN 权限会影响连接能否持续保持。
v2flyNG
面向 Android 的 V2Fly 内核客户端,可作为需要 V2Fly 内核体系时的选择。其订阅导入和节点管理思路与常见 V2Ray 客户端相近,但支持的协议字段应以当前客户端和内核版本为准,不能仅按分享链接前缀判断。
系统代理
客户端把操作系统代理设置指向本地 HTTP 或 SOCKS 监听端口的工作方式。只有读取并遵循系统代理设置的应用会经过该入口,拥有独立代理配置或直接建立连接的应用可能不受影响。关闭客户端前通常应先恢复系统代理状态。
TUN 模式
通过虚拟网络接口接收系统网络流量的工作模式,覆盖范围通常比系统代理更广。TUN 需要相应系统权限,并依赖路由表、DNS 和排除规则协同工作。遇到局域网访问异常时,应检查绕过地址与接口路由,而不是只更换节点。

SUBSCRIPTION / NODE

订阅与节点

订阅是配置集合的交付方式,节点是其中的单条连接记录。延迟测试只反映特定测试方法下的耗时,不等同于完整可用性。

订阅
由服务端提供并可被客户端定期读取的节点配置集合。更新订阅会重新获取远端内容并刷新对应分组,但不一定自动切换当前节点。若更新后列表没有变化,应检查订阅地址、分组选择、更新结果和客户端日志。
节点
客户端中的一组可连接服务器配置记录,完整内容包括协议、地址、端口、认证信息和传输层参数。节点名称只是便于识别的标签,不参与多数连接认证。名称相同的两条记录仍可能使用完全不同的服务器或协议设置。
延迟
从本地到测试目标完成指定探测所需的时间,通常以毫秒表示。客户端可能使用 TCP 建连、HTTP 请求或其他方法测试,因此不同页面的结果不能直接比较。较低数值也不代表带宽、稳定性和目标可达性一定更好。
真连接延迟
客户端按节点配置建立实际代理连接,并通过该连接访问测试目标后得到的耗时。它覆盖了协议握手与代理转发过程,比单纯探测服务器端口更接近实际使用。测试失败时还需结合日志判断是节点、DNS 还是测试目标的问题。

ROUTING / RULES

路由与分流

路由模块根据连接属性决定流量交给哪个出站。规则顺序、DNS 结果与数据文件版本都会影响匹配结果。

路由规则
根据域名、IP、端口、网络类型、协议或进程等条件选择出站方向的配置。多条规则同时存在时,内核通常按照既定顺序和优先级执行匹配。修改前应记录原模式,以便在结果不符合预期时恢复。
分流
把不同目标流量分配到直连、代理或阻断等出站的过程。分流不是单独协议,而是 DNS、域名规则、IP 规则和出站配置共同形成的结果。同一域名解析到不同地址时,最终命中的规则也可能变化。
GeoIP
按 IP 地址归属范围整理的数据集合,可供路由规则引用。它匹配的是连接目标 IP 或解析后的 IP,不等同于域名分类。数据范围会随版本更新,规则名称相同也不表示内容永久固定。
GeoSite
按用途或类别整理的域名规则集合,可由路由模块按分类名称加载。它与 GeoIP 的主要区别是匹配对象为域名。使用时需要确认内核能够找到对应数据文件,并了解客户端预设规则的覆盖顺序。

NETWORK / DNS

网络基础

DNS 决定域名如何得到目标地址,入站与出站决定流量如何进入和离开内核。多数连接问题都可以沿这条处理链逐段定位。

DNS
把域名转换为 IP 地址的基础网络服务。V2Ray 客户端可以使用系统 DNS、指定远程 DNS,或按域名规则选择不同解析器。解析路径若与路由目标不一致,可能出现域名规则命中但实际连接方向不符合预期的情况。
FakeDNS
向应用返回保留地址,并在内核中保存域名与该地址映射关系的解析机制。它常用于 TUN 场景,使应用发起连接后,内核仍能找回原始域名并参与路由。地址池范围需要避免与本地网络和其他虚拟接口冲突。
DNS 泄漏
应用的 DNS 查询绕过预期解析路径并被其他解析器处理的现象。排查时需要同时检查系统 DNS、客户端 DNS、浏览器内置解析、TUN 设置和路由规则。仅修改一个 DNS 地址,未必能覆盖所有应用的查询路径。
入站
内核接收本地应用流量的入口配置,常见形式包括 SOCKS、HTTP 本地监听端口和 TUN 虚拟接口。入站决定监听地址、端口和接入协议。若端口被其他程序占用,客户端可能启动内核失败或无法接收应用流量。
出站
内核处理流量后的发送方向,可以是某个代理节点、直接连接或阻断处理。路由规则的最终动作通常指向一个出站标签。出站配置中的协议和传输参数必须完整,否则即使入站工作正常,连接仍会在发送阶段失败。