V2Ray 术语表

从协议名到配置字段,按使用位置查阅。先区分客户端、内核与连接参数,再判断某个选项应该在界面中调整,还是在 config.json 中设置。

协议与传输

协议规定数据交互方式,传输承载连接,安全层负责相应的握手与保护。三个层次需要分别匹配服务端。

协议与传输

VMess

VMess 是 Project V 生态中的代理协议,使用用户标识等参数完成身份认证,连接配置需要与服务端一致。排查认证失败时,除了核对地址、端口与 UUID,还应检查设备系统时间,因为时间偏差可能影响握手。VMess 与 WebSocket 不是同类选项:前者是代理协议,后者是可承载它的传输方式。

查看出站字段 →
协议与传输

VLESS

VLESS 是轻量代理协议,本身不承担数据加密,通常结合 TLS 或 REALITY 等安全层部署。选择 VLESS 后,仍要单独核对传输方式、服务名称与安全参数,不能只填 UUID 就认为配置完整。不同内核对相关组合及扩展的支持存在差异,应以实际内核版本为准。

区分 VLESS 与 REALITY →
协议与传输

Trojan

Trojan 通常在 TLS 连接之上承载代理数据,以密码作为认证参数。密码正确不代表握手一定成功,还需要正确的服务器名称、证书信任关系和传输设置。遇到证书错误时,应先核对域名与设备时间,而不是直接跳过证书验证。

对照连接参数 →
协议与传输

REALITY

REALITY 是 Xray 生态中的传输安全机制,不是独立的代理协议,也不是一个节点地址。它常与 VLESS 组合,客户端需要使用与服务端相对应的公钥、服务器名称和短标识等参数。界面中能够选择 REALITY,不代表任意内核都能运行该组合,实际执行内核也必须支持。

查看 Xray 定义 →
协议与传输

传输层

传输层描述代理数据通过什么连接方式传递,常见选项包括 TCP、WebSocket 和 gRPC。WebSocket 的路径、gRPC 的服务名称等属于各自的传输参数,需要与服务端及中间转发配置对应。传输名称相同也不保证连接可用,还要继续核对 TLS 等安全层参数。

查看传输配置位置 →

内核与生态

项目名称、执行内核与图形客户端属于不同层级。客户端的名称不能替代实际内核信息。

内核与生态

Project V

Project V 是围绕网络代理与通信工具形成的项目体系,V2Ray 是理解这一技术体系的重要入口。常见的入站、出站和路由模型来自这一配置思路,相关实现后来形成不同的项目与分支。阅读旧教程时,不能仅凭 Project V 或 V2Ray 的名称判断某个新字段是否可用。

区分项目与客户端 →
内核与生态

V2Fly

V2Fly 是持续维护 V2Ray 相关核心实现与文档的社区项目,常见表述中的 V2Fly-core 指其核心程序。Android 客户端 v2flyNG 以 V2Fly 内核作为连接执行基础,适合需要对应配置体系的场景。不同版本的配置格式与支持范围需要分别核对,不能把其他内核的新参数直接照抄过来。

查看 Android 客户端 →
内核与生态

Xray

Xray 是从 V2Ray 技术体系发展而来的内核项目,在协议、安全层和配置字段上具有自身实现。v2rayNG 基于 Xray 内核,v2rayN 的实际可用能力则要结合所选内核判断。两个内核共享部分配置概念,但这种关联不代表所有 JSON 片段都能互换。

阅读内核选型笔记 →
内核与生态

内核与客户端

内核负责建立连接、执行路由和处理解析请求;客户端负责配置编辑、订阅管理及运行控制。v2rayN、v2rayNG、v2flyNG 是客户端名称,界面中的设置可能会被转换成内核配置,也可能只影响客户端自身。判断一个功能是否可用时,需要同时确认界面支持与内核支持,不能只看安装了哪款客户端。

查看客户端与平台 →

配置结构

以 config.json 的顶层段名定位职责。先找到连接从哪里进入、从哪里离开,再看路由如何选择出站。

配置结构

config.json

config.json 是常见的内核 JSON 配置文件名,内容通常组织入站、出站、路由、DNS 和策略等配置段。JSON 对引号、逗号和括号有严格要求,普通 JSON 文件不能直接加入说明性注释。客户端生成的运行配置与客户端自己的设置文件可能不同,直接修改生成文件还可能被下一次启动覆盖。

查看完整配置参考 →
配置结构

inbounds

inbounds 是入站配置数组,用来定义内核如何接收连接,例如本机 SOCKS 或 HTTP 代理监听。每个入站可设置监听地址、端口、协议和标识,其中 127.0.0.1 通常只接受本机访问。将监听地址改成所有接口会扩大可访问范围,应同时考虑认证与防火墙限制。

查看入站字段 →
配置结构

outbounds

outbounds 是出站配置数组,描述连接接下来通过哪种方式发送,可包含代理、直连或阻断处理。出站的 tag 是供路由引用的标识,不是固定协议名称,可以按配置需要命名。只有声明出站还不够,必须确认路由能够选中它;未匹配规则时的默认处理也需要核对。

查看出站字段 →
配置结构

routing

routing 按域名、目标 IP、端口或入站标识等条件选择出站。规则通常按顺序匹配,较宽泛的条件放在前面,可能让后续更具体的规则失去生效机会。同一规则内不同类型条件常需要同时满足,不能把所有字段都理解成任意命中即可。

查看路由规则 →
配置结构

policy

policy 是连接处理策略段,可按用户等级设置握手超时、空闲超时和缓冲等行为。它与 routing 的职责不同,不负责决定某个域名走代理还是直连。随意增大超时或缓冲并不等于提升速度,调整前应确认对应字段的单位、默认值及内核支持情况。

查看策略字段 →

路由与 DNS

域名解析和连接转发相互影响,但不是同一条处理链。规则数据、解析请求与最终流量去向应分别检查。

路由与 DNS

DNS

DNS 将域名解析为 IP 地址,V2Ray 配置中的 dns 段通常描述内置解析器的行为。操作系统、浏览器与内核可能各自发起解析,因此修改内置 DNS 不代表所有应用都会使用它。排查时应先确定域名在哪一层被解析,再核对解析服务器、查询路径和相关路由。

查看 DNS 配置 →
路由与 DNS

GeoIP

GeoIP 在这里指按标识组织的 IP 地址集合,可通过 geoip:cn 等表达式参与路由匹配。它判断的是目标 IP 是否属于指定集合,不是识别网页语言,也不是精确定位服务器的实时物理位置。命中结果取决于本地数据文件的内容;只有域名信息时,还可能涉及后续解析策略。

查看 IP 匹配规则 →
路由与 DNS

GeoSite

GeoSite 是按分类标识组织的域名规则集合,可用于路由分流,也可在支持的 DNS 配置中限定解析范围。配置里的 geosite:cn 引用数据文件中的分类,不会自动搜索网络补全条目。分类名称和收录范围随数据来源变化,缺少分类或文件路径错误都可能导致加载失败。

查看域名解析匹配 →
路由与 DNS

FakeDNS

FakeDNS 用合成 IP 回答域名查询,并在内部保存 IP 与域名的对应关系,以便后续处理连接时恢复域名信息。它不是一个普通公共 DNS 地址,需要与流量接管、映射恢复及路由设置配合。若应用缓存的合成地址脱离对应处理链,连接可能失败,切换模式后也可能需要清理相关缓存。

查看 DNS 字段边界 →
路由与 DNS

DNS 泄漏

DNS 泄漏指域名查询没有遵循预期解析路径,例如希望经代理解析,却仍由系统向另一解析服务器发送请求。测试页面显示某个解析服务器的位置,只能作为线索,不能单独证明全部流量的去向。应结合浏览器安全 DNS、系统解析设置与内核日志检查,使用加密 DNS 也不自动等于查询走了预期出站。

阅读 DNS 分流笔记 →
路由与 DNS

分流

分流是依据条件把不同连接送往不同路径,例如特定域名直连,其余连接交给代理出站。它不等于自动测速,也不必然包含节点故障切换;这些功能需要额外机制支持。分流效果同时依赖规则顺序、域名是否仍然可见,以及未命中规则时采用的默认出站。

查看路由配置示例 →

客户端与订阅

这些名词多见于客户端界面。导入配置、接管应用流量和测试连接是三个不同步骤。

客户端与订阅

订阅

订阅是用于获取和更新一组连接配置的地址或数据源,客户端读取后将其转换为可选择的节点。订阅地址可能包含访问凭据,应按敏感信息保存,不宜出现在公开截图或日志中。更新订阅主要是刷新配置列表,不会自动修复系统代理、DNS 或本机网络设置。

查看订阅导入步骤 →
客户端与订阅

节点

节点是客户端对一组服务端连接参数的常用称呼,通常包含地址、端口、协议、认证和传输设置。显示名称可以由提供方或用户修改,并不能证明服务器所在地、线路类型或性能。节点能够导入,只说明客户端接受了相应数据格式,仍需启动内核并测试实际连接。

对应到出站参数 →
客户端与订阅

系统代理

系统代理是操作系统提供给应用读取的代理入口设置,通常指向客户端在本机监听的地址与端口。只有遵循这套设置的应用才会发送相应连接,因此打开系统代理不等于接管整台设备的所有流量。应用自行设置代理、直接联网或使用独立网络组件时,需要分别确认实际路径。

比较 TUN 模式 →
客户端与订阅

TUN 模式

TUN 模式通过虚拟网络接口和路由设置接收网络流量,使不读取系统代理的应用也有机会进入客户端处理链。实际覆盖范围仍受管理员权限、路由、排除规则及其他网络软件影响,不能把开关开启当成全部流量都已被代理。它属于客户端与系统集成能力,不是给任意内核 JSON 添加一个同名字段即可启用。

查看 TUN 设置笔记 →
客户端与订阅

延迟

延迟是某种测试方法下的耗时结果,可能指 ICMP 往返时间、TCP 建连时间或完整请求耗时。不同方法覆盖的网络阶段不同,不能把两个名称不同的数值直接作横向比较。较低延迟也不代表较高下载速度,吞吐量、丢包和持续稳定性需要另外观察。

区分真连接延迟 →
客户端与订阅

真连接延迟

真连接延迟通常指客户端通过选定配置访问测试目标所测得的耗时,比单纯探测服务器端口更接近一次实际请求。测量是否包含 DNS、TLS 或其他阶段,取决于客户端实现与测试方式,不能只凭名称作统一解释。超时还可能来自测试目标或路由规则,应结合普通访问结果判断。

查看连接验证流程 →
下载客户端