CONFIGURATION GLOSSARY
V2Ray 术语表：协议、内核、订阅与路由
从配置文件字段和客户端设置项出发，解释常见名词的准确含义、组合关系与排查位置。协议名称、内核名称和客户端功能分开归类，避免把不同层级的概念混为一谈。
5 个分类
按配置层级整理
30 个术语
覆盖常用设置项
工程定义
附实际作用说明
PROTOCOL & SECURITY
协议与加密
协议、认证标识与安全层属于不同配置层。一个完整节点通常需要把这些参数与传输方式组合起来。
- VMess
- Project V 生态中的客户端与服务器通信协议，包含用户认证、时间校验和数据传输格式。它通常与 TCP、WebSocket、HTTP/2 等传输方式组合使用。客户端与服务端的用户标识、传输类型和安全设置必须保持对应。
- VLESS
- 一种将认证与传输层配置分离的轻量协议。VLESS 本身不负责内容加密，实际部署通常配合 TLS 或 REALITY 等安全层。阅读配置时应分别核对 UUID、流控、传输方式与安全层字段。
- Trojan
- 使用密码完成认证并通常运行在 TLS 连接之上的代理协议。客户端配置需要同时核对服务器地址、端口、密码、传输安全与域名信息。TLS 握手失败和密码错误会在日志中呈现为不同阶段的异常。
- REALITY
- Xray 提供的一种传输安全实现，常与 VLESS 组合。配置通常涉及公钥、短标识、服务器名称和流控等字段，客户端与服务端参数必须对应。它属于连接安全层，不应与 VLESS 协议本身视为同一个概念。
- TLS
- 用于建立加密连接并验证通信端点的通用安全协议。在 V2Ray 配置中，证书域名、服务器名称、系统时间和证书链都会影响握手结果。遇到证书错误时，应先检查域名与时间，再查看客户端日志中的握手信息。
- UUID
- 由十六进制字符和连字符组成的通用唯一标识符。VMess 与 VLESS 配置常用 UUID 识别用户，格式错误或两端不一致会导致认证失败。它不是服务器地址，也不能替代密码、端口或传输参数。
CORE & ECOSYSTEM
内核与生态
图形客户端与内核不是同一个软件层级。客户端负责界面和配置管理，内核负责协议、DNS、路由及连接处理。
- Project V
- 围绕网络代理协议、路由能力和可扩展传输组件形成的开源技术生态。V2Ray、V2Fly 及相关客户端文档中的许多概念都源自这一体系。它描述的是项目与技术脉络，并不是某一款具体图形客户端的名称。
- V2Fly
- 延续 V2Ray 技术路线的社区维护项目及内核家族。它提供协议处理、入站出站、DNS 与路由等基础能力，并可被图形客户端调用。配置兼容范围仍需以所用客户端附带的具体内核版本为准。
- Xray
- 与 V2Ray 配置体系高度相关的开源内核家族。Xray 支持 VLESS、REALITY、路由和多种传输组合，具体可用字段取决于内核与客户端版本。看到“Xray 内核”时，指的是执行连接配置的核心程序，而不是订阅服务。
- v2rayN
- 面向 Windows、macOS 与 Linux 的图形客户端。它负责订阅管理、服务器列表、系统代理、路由规则和内核启动等桌面端操作。连接异常时，需要区分界面设置问题、生成配置问题和底层内核错误。
- v2rayNG
- 面向 Android 的图形客户端，通常使用 Xray 内核处理连接。常见功能包括订阅更新、节点切换、路由模式、应用级代理和连接日志。移动网络与无线网络切换后，系统路由变化也可能影响当前连接。
- v2flyNG
- 面向 Android、采用 V2Fly 内核路线的图形客户端。它可导入订阅和单节点配置，适合需要 V2Fly 内核兼容性的使用场景。与 v2rayNG 对比时，应重点查看内核家族、配置兼容范围和客户端功能差异。
SUBSCRIPTION & NODE
订阅与节点
订阅负责分发配置，节点是可被选择的连接记录，测速则用于观察不同层面的链路表现。
- 订阅链接
- 由服务端提供、用于批量获取节点配置的地址。客户端更新订阅时会请求该地址并解析内容，地址失效、认证参数错误或网络失败都会造成更新异常。订阅导入成功只表示客户端读到了配置，不等于其中每个节点都能建立连接。
- 节点
- 客户端中一组可被选用的服务器连接配置。一个节点通常包含地址、端口、协议、认证信息、传输方式和安全层等参数。节点名称主要用于识别，真正决定连接结果的是其内部字段。
- 订阅分组
- 客户端用于区分不同订阅来源和管理节点集合的组织方式。更新、清理和自动选择操作通常以分组为边界，排查时应先确认当前操作的分组。删除分组可能同时移除该来源下的节点记录，因此操作前应辨别本地节点与订阅节点。
- 延迟
- 数据从本地到目标再返回所消耗的时间，通常以毫秒表示。不同测试方式覆盖的网络阶段不同，因此单个延迟结果不能直接代表实际传输速度。延迟还会随本地网络、链路拥塞和测试目标变化。
- 真连接延迟
- 通过代理节点完成实际协议连接或目标请求后测得的耗时。它比普通网络层探测覆盖更多握手步骤，更适合判断节点能否建立真实连接。若测试超时，应结合日志判断失败发生在解析、传输连接、协议认证还是安全握手阶段。
- 下载测速
- 通过传输一定规模的数据观察吞吐能力的测试方式。结果会受到节点出口、目标服务器、链路拥塞、本地网络和测试时段共同影响。测速会产生实际流量，也不能仅凭一次结果判断长期稳定性。
ROUTING & SPLIT
路由与分流
路由规则先识别流量特征，再把请求交给指定出站。域名规则、IP 规则和出站标签需要作为一条完整链路检查。
- 路由规则
- 按域名、IP、端口、协议或来源匹配流量并指定出站的规则集合。规则顺序与出站标签必须对应，否则可能出现命中结果和预期不一致。排查时应先找出请求实际命中的规则，再检查该规则指向的出站。
- 分流
- 依据路由条件把不同请求发送到直连、代理或拦截等不同出站的处理方式。分流是否正确应结合访问结果、客户端日志与 DNS 解析路径验证。只调整系统代理模式并不会自动修正内核中的路由规则。
- GeoIP
- 按 IP 地址所属地区或网络范围组织的规则数据。路由引擎可在域名解析得到 IP 后使用 GeoIP 匹配，但数据版本与更新频率会影响覆盖结果。它处理的是地址范围，不能直接替代域名分类规则。
- GeoSite
- 按用途或地区整理域名集合的规则数据。GeoSite 负责域名层匹配，不等同于 GeoIP；两者经常组合使用以覆盖域名和地址两类条件。规则名称是否可用取决于客户端所加载的数据文件。
- 出站标签
- 配置中用于标识某个出站处理器的名称。路由规则通过标签引用直连、代理或拦截出站，标签拼写不一致会使规则无法按预期转发。阅读日志时，出站标签也常用于确认请求最终走向。
- 规则优先级
- 多条路由条件同时可能匹配时所采用的判断顺序。多数配置按规则排列顺序逐项检查，因此更具体的条件通常应放在更宽泛的条件之前。修改顺序后应重新加载配置，并用明确的测试域名验证结果。
CLIENT FEATURES
客户端功能
系统代理、虚拟网络接口和 DNS 处理方式决定流量如何进入内核。应用是否读取系统设置，是判断接管范围的关键。
- 系统代理
- 操作系统提供给支持代理设置的应用读取的网络参数。开启系统代理不代表所有程序都会使用它，忽略系统设置的应用需要单独配置或使用其他接管方式。退出客户端前恢复系统代理，可避免遗留一个已经停止监听的本地端口。
- TUN 模式
- 通过虚拟网络接口接收系统流量，再交由客户端内核处理的工作模式。它能覆盖更多不读取系统代理的程序，但需要正确处理权限、路由表和 DNS 设置。启用后若本地网络异常，应检查虚拟接口、路由冲突和其他网络工具的占用情况。
- FakeDNS
- 向应用返回保留地址，并在后续连接阶段恢复原始域名映射的 DNS 处理机制。它有助于保留域名信息供路由匹配，但地址池、缓存和回退配置需要相互配合。关闭或切换模式后，旧缓存可能短暂影响测试结果。
- DNS 泄漏
- 域名查询没有沿预期解析路径发送，导致请求交给了其他 DNS 解析器的现象。排查时应同时检查系统 DNS、客户端 DNS、路由规则和浏览器自身的解析设置。测试结果应结合当前接管模式判断，不能脱离配置单独下结论。
- 入站端口
- 客户端在本机监听并接收应用代理请求的端口。SOCKS 与 HTTP 入站可能使用不同端口，应用填写错误或端口被占用都会导致连接失败。手动配置应用时，还需确认地址通常指向本机而不是远端节点地址。
- 客户端日志
- 记录内核启动、配置加载、DNS 查询、路由匹配和连接错误的文本输出。故障排查应关注错误发生时间附近的记录，并区分客户端界面日志与内核日志。分享日志前应检查其中是否包含订阅地址、认证字段或完整节点配置。