Configuration reference

V2Ray 术语表

按配置位置查找协议、内核、订阅、路由、DNS 与传输安全名词。每条解释先说明用途,再列出配置时需要核对的关系。

协议与传输 客户端与网络 路由与安全

Protocol and transport

协议与传输

协议决定身份参数与数据格式,传输方式决定连接如何承载。导入配置后,应把两部分字段分开核对。

VMess

Project V 生态中的代理协议。配置通常包含用户标识、服务器地址、端口和传输方式。客户端与服务端必须使用对应参数,任一关键字段不一致都会导致连接失败。

VLESS

一种轻量协议,把身份验证与传输安全分开配置。实际使用时常与 TLS、XTLS 或 REALITY 组合。检查配置时需要分别确认用户标识、流控方式和传输安全参数。

Trojan

基于密码认证并通常配合 TLS 使用的代理协议。客户端需要填写域名、端口、密码及传输参数。服务器名称与证书验证设置也会影响连接建立。

REALITY

Xray 生态中的传输安全方案,常与 VLESS 组合。客户端通常需要公钥、短标识、服务器名称和指纹等参数。这些内容应直接按服务端配置填写,不适合依靠默认值推测。

WebSocket

建立在 HTTP 之上的双向通信传输方式。在 V2Ray 配置中,常见关键字段包括路径、请求头、主机名与 TLS 设置。路径或主机名不一致时,连接通常无法完成握手。

gRPC

基于 HTTP/2 的远程调用框架,也可作为代理流量的传输方式。配置时重点核对服务名称、传输安全和服务器名称。它与 WebSocket 的路径字段不是同一套参数。

Core and client

内核与客户端

图形客户端负责管理界面和配置,内核负责协议连接、DNS 与路由处理。排查问题时先确认故障发生在哪一层。

Xray

Project V 生态中的内核实现之一,支持 VLESS、XTLS、REALITY 等配置能力。v2rayN 与 v2rayNG 可调用该内核处理连接、DNS 和路由。内核版本会影响可识别的配置字段。

V2Fly

Project V 生态中的社区内核分支,延续 V2Ray 配置体系。它与 Xray 的基础概念相近,但支持的协议字段和传输特性不完全相同。切换内核前应先检查现有配置的兼容性。

v2rayN

面向 Windows、macOS 与 Linux 的图形客户端。它负责订阅管理、配置编辑、系统代理、路由设置和内核进程控制。界面中的模式选项最终会转换为内核可读取的配置。

v2rayNG

面向 Android 的图形客户端,通常搭配 Xray 内核。常用操作包括扫描配置、导入订阅、设置路由和启用 VPN 模式。系统权限、后台限制与内核配置会共同影响连接状态。

v2flyNG

面向 Android 并使用 V2Fly 内核的客户端。它适合需要对应 V2Fly 配置兼容性的场景。导入配置前,应确认订阅中的协议与传输字段能被当前内核识别。

Subscription and profile

订阅与节点

订阅负责批量传递配置,节点是一条可用的连接记录。更新、筛选和测速属于不同操作,不应混为同一步。

订阅

由服务提供方给出的配置集合地址。客户端更新订阅后,会解析其中的服务器配置并归入对应分组。更新动作只负责读取新内容,不会自动修正本地路由与 DNS 设置。

节点

客户端中的一条服务器连接配置。节点通常包含地址、端口、协议、身份参数和传输设置。节点名称主要用于识别,不代表实际连接质量或协议类型。

订阅分组

客户端用于区分多个订阅来源的管理单元。不同分组可以分别更新、筛选和指定自动更新策略。发现配置缺失时,应先确认更新的是正确分组。

延迟

数据从本机到目标端并返回所需时间的概括性指标。不同客户端可能采用 TCP 探测、HTTP 请求或其他测试方法。测试结果用于比较响应时间,不能直接等同于实际传输速度。

真连接延迟

通过实际建立代理连接并访问测试目标得到的响应时间。它比只检查网络可达性的测试包含更多连接阶段。结果仍会受到测试目标、DNS 和当前网络状态影响。

Routing and dispatch

路由与分流

路由规则按顺序匹配连接信息,再把流量交给指定出站。域名解析结果可能改变后续 IP 规则的命中情况。

路由规则

根据域名、IP、端口或协议类型决定流量出站方向的匹配条件。多条规则同时存在时,顺序会影响最终结果。修改后应重启内核,并通过日志确认实际命中的规则。

分流

把不同目标流量交给直连、代理或阻断等出站处理的配置方式。分流结果取决于规则条件、DNS 解析和出站标签。模式名称只是预设入口,最终行为由具体规则决定。

GeoIP

按 IP 地址所属地区或网络类别整理的数据集合。路由规则可使用 geoip 分类匹配目标 IP。数据文件需要与内核支持的格式对应,并按实际配置周期更新。

GeoSite

按域名用途或地区整理的数据集合。规则中的 geosite 分类名会展开为一组可匹配的域名条目。分类名拼写错误或数据版本不匹配会导致规则无法按预期命中。

出站标签

配置中用于标识出站连接的名称。路由规则通过标签把匹配到的流量交给指定出站。标签可以自定义,但规则引用值必须与出站配置完全一致。

DNS and network

DNS 与网络

DNS 决定域名如何得到地址,网络接管方式决定哪些应用流量进入客户端。两者需要与路由策略配合设置。

DNS

把域名转换为 IP 地址的解析系统。V2Ray 客户端可为不同域名设置解析服务器、查询策略和匹配规则。排查解析问题时,应区分系统查询与内核内部查询。

FakeDNS

向应用返回映射地址,并在内核中保留域名对应关系的 DNS 处理方式。它常用于需要保留原始域名信息的透明代理场景。地址池、嗅探和路由规则需要成套配置。

DNS 泄漏

本应按既定链路处理的域名查询被其他解析路径发送。排查时需要同时检查系统 DNS、客户端 DNS、路由规则和浏览器解析设置。仅更换一个解析服务器不一定能改变全部查询路径。

域名策略

控制路由匹配时是否解析域名,以及何时使用解析结果继续匹配 IP 规则。常见策略包括 AsIs、IPIfNonMatch 与 IPOnDemand。选择策略前应先确认规则主要依赖域名还是 IP。

TUN 模式

通过虚拟网络接口接管系统网络流量的工作方式。它可覆盖不读取系统代理设置的应用,但需要正确配置路由、DNS 与运行权限。启用前应记录原有网络设置,便于逐项排查。

系统代理

操作系统向支持代理设置的应用公布代理地址和端口的机制。它与客户端路由模式属于不同层级:系统代理决定流量是否进入客户端,路由规则决定进入后的处理方向。

Security and encryption

安全与加密

传输安全字段通常由服务端配置决定。客户端应逐项核对名称、验证方式与流控参数,不使用相似字段互相替代。

TLS

用于保护传输连接的安全协议。客户端配置通常需要核对服务器名称、证书验证和应用层协议等字段。域名、证书与实际连接目标之间需要保持正确对应关系。

XTLS

Xray 生态中的传输与流控技术集合。具体可用字段取决于内核版本、协议组合和服务端配置。看到 XTLS 相关选项时,应同时核对 VLESS 流控值与传输安全类型。

服务器名称

TLS 或 REALITY 配置中用于连接验证与握手的域名字段,界面里也可能显示为 SNI。它不一定等同于节点地址。填写时应采用配置提供方给出的准确值。

指纹

部分 TLS 与 REALITY 配置中用于指定客户端握手特征的选项。它属于传输安全参数,不是账户身份标识。字段可选范围由当前内核版本决定。

V2Ray客户端下载