术语参考 / CONCEPT REFERENCE

V2Ray 术语手册

协议、内核、配置与路由的概念边界。先确认术语所在的层级,再对照客户端设置与 JSON 字段。

01 / PROTOCOL & TRANSPORT

协议与传输

代理协议负责约定认证与数据格式;传输方式负责承载连接;安全层负责保护通信。一个节点通常同时包含这几类参数,名称相近不代表可以互换。

VMess

VMess

V2Ray 生态中的代理协议,使用用户标识进行身份认证,并有自身的数据保护机制。配置时要把用户标识、协议选项与底层传输设置分别核对,不能只填写服务器地址。旧教程中的兼容参数未必适用于当前实现,遇到连接错误应先确认内核版本与服务端要求。

VLESS

VLESS

以精简认证结构为特点的代理协议,协议本身不提供载荷加密,常与 TLS 或 REALITY 搭配。VLESS、传输方式与安全层是不同配置项,选择其中一个不会自动补齐其余参数。若连接还使用特定流控选项,需要同时确认两端内核的支持情况。

Trojan

Trojan

通常建立在 TLS 连接上的代理协议,使用密码完成认证。连接成功不仅取决于密码,还取决于端口、服务端名称以及证书验证是否正确。证书错误应从名称匹配、信任链和设备时间排查,不宜直接跳过验证。

Shadowsocks

Shadowsocks

使用约定加密方法与凭据传送代理流量的协议家族。不同规范和加密方法对密钥格式、实现版本可能有不同要求,因此导入后仍需核对方法名称。它与 VMess、VLESS 是不同协议,不能通过改一个显示名称完成转换。

TLS

TLS

为连接提供加密、完整性保护与身份验证的安全协议,不等同于代理协议本身。客户端通常需要正确的服务端名称,并验证证书是否可信。SNI 用于在握手中指示目标名称;它与实际连接地址可能不同,但这种差异必须符合服务端部署方式。

REALITY

REALITY

Xray 生态中的传输安全方案,常见于与 VLESS 组合的连接配置。客户端需要按服务端提供的信息填写相应公钥、服务端名称及其他连接参数,不能直接套用普通 TLS 的全部做法。界面能够识别链接不代表内核能够运行,实际支持以当前内核版本为准。

02 / CORE & CLIENT

内核与客户端

界面负责组织设置,内核负责执行连接。系统代理与 TUN 是流量进入客户端的方式,不是某一种远端代理协议。

Project V

Project V

围绕网络代理与通信工具形成的项目生态概念,V2Ray 是其中的重要组成部分。这个名称不是某个图形客户端,也不意味着生态中的所有实现共享完全一致的功能。阅读资料时,应进一步确认文中说的是项目背景、具体内核,还是客户端界面。

V2Fly / V2Ray core

V2Fly

维护 V2Ray 相关核心实现的社区项目,内核承担协议处理、入站接收、出站连接、路由与 DNS 等工作。v2flyNG 是使用这一内核家族的 Android 客户端选项。比较配置时要核对具体版本,不能仅凭文件名相同就认定字段完全兼容。

Xray

Xray

与 V2Ray 有历史渊源的独立内核项目,在协议能力与配置细节上有自己的发展方向。v2rayNG 使用 Xray 内核,v2rayN 的实际能力则应结合所选内核检查。某项功能写在 Xray 的资料中,并不表示另一内核也接受相同配置。

GUI client

图形客户端

提供订阅管理、节点选择和参数设置界面的应用,通常通过生成配置来调用底层内核。v2rayN、v2rayNG、v2flyNG 属于客户端名称,而不是协议名称。排查时应分别记录客户端与内核版本,因为界面选项和连接能力可能由不同部分决定。

System proxy

系统代理

操作系统向应用提供的代理设置,通常指向客户端的本地监听地址与端口。只有遵循这套设置的应用才会使用相应入口,命令行程序或带独立网络设置的应用可能走其他路径。开启系统代理只解决入口问题,不决定进入内核后请求采用哪个出站。

TUN

TUN 模式

借助虚拟网络接口接收 IP 数据包的接入方式,可用于接管部分不遵循系统代理的应用流量。实际覆盖范围由客户端实现、系统权限、路由与排除规则共同决定。启用后还要关注 DNS 处理和本地网络访问;出现异常时应先检查是否与其他网络工具争用路由。

03 / CONFIGURATION STRUCTURE

配置文件结构

按“接收连接 → 匹配规则 → 选择出口”阅读配置更容易定位问题。下列名称对应常见 JSON 字段,完整示例见 JSON 配置手册。

JSON / config.json

JSON 配置

使用对象、数组与键值描述内核行为的配置形式,字符串和字段名使用双引号。语法能够解析只说明文档格式正确,不说明其中的字段被当前内核接受。客户端自动生成的运行配置还可能在下次保存时被覆盖,修改前应先确认持久化设置入口。

log

日志

记录运行状态与错误信息的配置部分,常用于定位解析失败、握手失败或连接超时。日志级别影响细节数量,临时提高级别有助于排查,但也会产生更多记录。阅读时应对齐故障发生时间;分享记录前应移除订阅地址、认证信息及不必要的访问细节。

inbounds

入站

内核接收连接的入口,通常描述监听地址、端口、入口协议及标签。本地 SOCKS 或 HTTP 代理端口就是常见入站,应用连接到这里后才交由内核处理。监听本机回环地址与监听所有接口的可访问范围不同,开放局域网访问前应确认防火墙与认证设置。

outbounds

出站

内核处理请求的出口,可对应远端代理、直接连接或阻断行为。路由通常通过出站标签引用它,所以标签必须与规则中的引用一致。未匹配规则的请求如何处理也需要明确确认;不要把客户端列表中的显示顺序直接当作最终生成配置的默认出口。

sniffing

流量探测

从部分连接的初始数据中识别协议或目标域名的机制,常用于为路由补充信息。它不能解密任意加密载荷,也不保证每个连接都能恢复域名。是否仅用于路由、是否影响连接目标,要结合具体选项判断,不能把开启探测当作修复全部域名规则的通用办法。

policy

策略

用于设置连接超时、用户级别相关行为及部分统计开关的配置段,不是域名分流规则表。“策略”这个中文词也可能出现在客户端其他菜单中,应先确认对应字段。调整超时会改变连接被保留或终止的时机,但不会直接改善线路容量或服务端响应速度。

04 / ROUTING & DNS

路由与 DNS

分流依赖可用于匹配的信息,DNS 决定域名如何被解析。检查这部分设置时,既要看规则内容,也要看请求进入内核时携带的是域名还是 IP。

routing / rules

路由规则与分流

按域名、IP、端口、协议或入口标签等条件选择出站的规则集合,分流就是这种选择过程。规则通常按配置顺序匹配,因此精确例外应放在可能覆盖它的宽泛规则之前。客户端的“绕过大陆”等模式通常是规则预设名称,不是与 VMess 并列的协议。

GeoIP

GeoIP

按地区或特定用途组织的 IP 地址集合,路由可利用集合标签批量匹配地址。它表达的是数据集对地址的归类,不是对服务器实际位置或服务归属的实时测量。网站使用多个地址或地址发生变化时,匹配结果也可能变化,应结合实际连接目标与数据更新时间检查。

GeoSite

GeoSite

按服务、用途或其他类别组织的域名集合,可减少逐条维护域名规则的工作量。集合名称与内容取决于所用数据文件,并不是所有内核环境都带有相同分类。若内核只拿到目标 IP,域名集合未必能够直接匹配,还需要检查入口信息与流量探测设置。

domainStrategy

域名策略

控制特定配置段如何处理域名解析的选项,不同位置中的同名字段不一定具有相同语义。路由中的 IPIfNonMatch 通常表示先用现有信息匹配,未命中时再解析域名以尝试 IP 规则。它不等于将所有应用的 DNS 请求统一转交某个解析服务器。

FakeDNS

FakeDNS

向应用返回合成 IP,并维护合成地址与原始域名之间的映射。后续连接必须进入能够恢复映射的处理链路,合成地址本身不是目标网站的真实地址。若查询与连接走了不同路径,应用可能无法访问,因此需要把 DNS 接管、地址池与路由设置作为整体检查。

DNS leak

DNS 泄漏

域名查询走了预期策略之外解析路径的现象,需要先明确预期使用哪个解析器及哪条链路。系统解析器、浏览器独立解析和应用内置解析都可能参与请求。测试页面显示的解析服务地区只能提供线索,不能单独证明所有应用的查询都遵循同一策略。

05 / SUBSCRIPTION & NODE

订阅与节点

订阅负责分发连接参数,节点是参数记录,测试结果则描述特定条件下的表现。这三者需要分别判断,不能用一次测速结果代替配置核对。

Subscription

订阅

客户端通过一个地址获取一组连接配置的更新入口,具体格式与内容由提供方和客户端共同决定。更新订阅不一定会同步路由、DNS 或本地偏好,手工修改的节点也可能被下一次更新覆盖。订阅地址可能包含访问凭据,应像认证信息一样妥善保存。

Node

节点

客户端保存的一组连接参数,通常包含地址、端口、协议、认证与传输设置。一个节点记录不一定对应一台独立服务器,同一地址也可以承载多个不同配置。名称中的地区或线路说明属于描述信息,实际使用时仍应依据连接结果与配置内容判断。

Share URI

分享链接

用文本链接封装连接参数的交换形式,客户端可通过剪贴板或二维码读取它。成功导入只表示内容被解析,不代表所有参数都被完整支持,也不代表服务端当前可用。分享链接可能携带认证信息,截图、日志与公开求助内容中都不宜直接展示完整链接。

Subscription conversion

订阅转换

把一类订阅或节点格式转成另一种目标格式的过程,常涉及字段映射与不支持参数的处理。转换不能给目标客户端增加原本不存在的协议能力,部分语义也可能在转换中丢失。使用转换服务意味着原始内容可能交给额外处理方,应先了解处理方式与访问范围。

Latency

延迟

特定测试方法下的响应耗时,必须结合测试目标、网络层级和超时条件阅读。ICMP 探测、TCP 建连与经代理发送请求测到的不是同一件事,数值不能直接横向混用。较低延迟也不等于较高下载速度,因为吞吐量还受线路容量、拥塞和服务端负载影响。

Connection test

真连接延迟

客户端经指定代理连接测试目标时测得的耗时,通常比只检查服务器端口更接近实际请求路径。具体是否包含 DNS、TLS 握手与响应读取,应以客户端当前实现为准。测试成功只说明当时能访问该目标,超时也可能来自测试站点或本地设置,不能直接断定节点失效。

从术语定位到配置操作

不清楚请求是否进入客户端,先读系统代理与入站;请求已进入但出口不符合预期,查路由规则与出站标签;域名与 IP 表现不同,再检查域名策略和 DNS。每次只调整一组相关选项,保留能够复现问题的测试条件。