配置参考 / 24 个常用术语
V2Ray 术语手册
从协议、内核到流量接管,按设置所在层级查阅。
先确认术语描述的是哪一层,再修改对应设置。协议决定双方如何通信,内核执行连接,客户端管理配置;订阅只提供连接参数,系统代理或 TUN 才涉及应用流量如何进入客户端。
连接参数
协议与传输
协议、传输方式和传输安全不是同一个字段。导入后应保留服务端提供的组合,不能只改协议名称。
- VMessProxy protocol
- VMess 是包含用户认证与数据保护机制的代理协议,配置中通常涉及服务器地址、端口和 UUID。它可以搭配不同传输方式,但客户端与服务端的参数必须兼容。遇到认证失败时,应检查 UUID、内核支持情况和设备时间,而不是仅凭端口可连接就判断配置正确。
- VLESSLightweight proxy protocol
- VLESS 侧重轻量认证与数据转发,协议本身不提供流量加密,实际部署常搭配 TLS 或 REALITY。UUID、传输方式、传输安全以及可能使用的 flow 参数分别承担不同作用。选择 VLESS 不代表这些参数可以省略,也不意味着它在所有网络与设备上都比其他协议更快。
- TrojanTLS-based proxy protocol
- Trojan 通常依托 TLS 保护连接,并使用密码进行代理认证。密码正确和证书验证通过是两个不同环节,服务器名称、证书有效期或设备时间异常,都可能阻止连接。排查时保留正常的证书验证流程,先核对服务端提供的地址、名称与认证信息。
- REALITYTransport security
- REALITY 是 Xray 生态中的传输安全机制,常与 VLESS 配合使用,并非一个可单独替代 VLESS 的代理协议。客户端通常需要服务端名称、公钥与短标识等配套信息。字段应按提供方配置填写;缺少参数或内核不支持时,仅切换界面中的安全选项无法补齐连接条件。
运行基础
内核与生态
图形界面相似不代表底层能力相同。判断某项配置能否使用,应同时看客户端支持和实际运行的内核。
- Project VProject ecosystem
- Project V 是围绕模块化网络代理工具形成的项目背景与生态概念,V2Ray 是其中广为使用的核心工具名称。日常所说的“V2Ray 客户端”往往泛指这类协议生态中的图形工具,并不保证每个程序使用相同内核。查兼容性时,应进一步确认具体客户端和内核名称。
- XrayXray-core
- Xray 是从 V2Ray 发展而来的开源代理内核,承担协议处理、路由和 DNS 等工作。它与 V2Fly 具有共同的技术背景,但后续功能与配置细节并不完全一致。某项特性需要对应内核版本支持,还需要图形客户端能够正确生成配置,不能只看节点的协议名称。
- V2FlyCommunity-maintained V2Ray
- V2Fly 是持续维护 V2Ray 相关实现的社区项目,延续模块化代理工具的开发。它与 Xray 不是可以任意互换所有配置字段的同一个程序。使用 v2flyNG 或其他接入 V2Fly 的客户端时,应按实际内核版本确认协议、传输与 DNS 配置支持范围。
- 内核Core / Runtime engine
- 内核是实际执行代理协议、路由规则和名称解析的底层程序,图形客户端则负责配置管理与操作入口。客户端界面能够打开,不等于内核已经成功运行。遇到启动失败时,应查看运行日志中的配置错误、权限或端口占用提示;切换内核前,还要确认现有连接参数能被目标内核识别。
操作入口
客户端与界面
桌面端优先从 v2rayN 开始;安卓端先明确内核需求,再在 v2rayNG 与 v2flyNG 之间选择。
- v2rayNDesktop client
- v2rayN 是面向 Windows、macOS 和 Linux 的图形客户端,提供服务器管理、订阅更新及代理相关设置入口。不同平台、界面版本与打包方式可能影响菜单位置和可用功能。文档提到的按钮名称应结合实际界面理解;下载时先匹配操作系统与处理器架构,再处理订阅和流量接管。
- v2rayNGAndroid client / Xray
- v2rayNG 是使用 Xray 内核的 Android 图形客户端,可以通过系统 VPN 授权建立流量接管入口。配置列表中选中服务器后,还需要启动服务,应用流量才可能按规则进入内核。后台中断时应检查省电策略与 VPN 状态,不能把所有断连都归因于订阅失效。
- v2flyNGAndroid client / V2Fly
- v2flyNG 是使用 V2Fly 内核的 Android 图形客户端,可作为有明确内核兼容需求时的备选。它与 v2rayNG 名称接近,但不能据此推断两者支持完全相同的扩展参数。选择前先核对现有配置需要的协议和传输能力,迁移后也应重新检查路由、DNS 与应用接管设置。
- 入站与出站Inbound / Outbound
- 入站负责接收应用交给内核的流量,例如本地 SOCKS 监听;出站决定流量如何离开内核,例如直接连接或经远端服务器转发。路由规则位于两者之间,按条件选择对应出站。配置中的标签是引用名称,规则引用的出站标签必须与已定义的出站一致,否则可能出现启动或转发错误。
配置来源
订阅与节点
导入、更新、选中和启用是不同操作。订阅中出现服务器条目,只能说明配置已进入客户端。
- 订阅Subscription
- 订阅是用于批量获取和更新服务器配置的地址或数据集合,客户端读取后将其中条目加入列表。更新可能增删节点或修改参数,但不会自动证明节点可用,也不等于已开启系统代理。订阅地址可能携带访问标识,应按敏感配置保管,分享截图或日志前先隐藏完整地址。
- 节点Server profile / Node
- 节点是客户端里一组服务器连接参数的常用称呼,通常包含地址、端口、协议、认证信息和传输设置。列表中的备注只是便于识别的名称,不能单凭备注判断实际出口位置或服务质量。切换节点后应确认它已成为当前活动配置,并在必要时按客户端提示重载内核。
- 延迟与真连接延迟Latency / End-to-end test
- 普通延迟测试可能只测服务器端口的连接耗时,真连接测试通常经代理请求测试地址,更接近实际转发链路。具体测量方式取决于客户端,两个结果不宜直接横向比较。数值较低不代表持续下载速度更高;测试失败也可能来自测试地址、DNS 或路由,应结合实际访问和日志判断。
连接去向
路由与 DNS
先确认流量进入了内核,再判断规则如何匹配。应用自行解析域名时,也可能改变内核能看到的信息。
- 路由规则与分流Routing / Traffic selection
- 分流是根据域名、目标地址、端口或协议等条件,为连接选择出站的过程,路由规则就是这些选择条件的具体表达。规则顺序很重要,较宽泛的条件可能先于更具体的规则命中。排查时同时检查匹配条件、出站标签和未命中时的默认处理;界面的模式名称只是预设规则的概括。
- GeoIP 与 GeoSiteIP sets / Domain sets
- GeoIP 通常提供地址集合,GeoSite 通常提供域名集合,内核可用这些数据简化路由条件。它们是规则匹配数据,不是实时测速结果,也不能保证分类永久准确。数据来源、分类名称和版本都会影响命中结果;域名规则与地址规则不一致时,还应结合解析策略检查最终选择。
- DNS 与 FakeDNSName resolution / Synthetic mapping
- DNS 将域名解析为地址等记录,应用需要这些信息才能建立后续连接。FakeDNS 则返回合成地址,并保存域名与地址的映射,供兼容的接管链路恢复目标信息。它不是简单替换一个 DNS 服务器地址就能启用的功能;解析路径、内核支持和流量入口必须配合,否则合成地址可能无法正确转发。
- DNS 泄漏Unexpected DNS path
- DNS 泄漏通常指名称查询没有按预期经过指定解析路径,例如浏览器或系统仍直接访问另一解析器。它描述的是路径偏离,并不等同于所有解析失败。检查时要分别看系统 DNS、客户端 DNS、浏览器加密 DNS 与分流设置;单次检测显示的解析器名称,不能独立证明全部应用的查询路径。
流量入口
系统代理与 TUN
接管范围与出站方向分开判断:进入客户端的流量,仍可能按规则直连,而不是全部交给远端服务器。
- 系统代理System proxy
- 系统代理是操作系统向支持该设置的应用提供的代理入口,常用于让浏览器连接本地 HTTP 代理。它不等于接管所有程序,命令行工具可能读取独立的环境变量,也可能完全忽略系统设置。浏览器可访问而终端不可访问时,应先查各自代理来源,再判断是否需要更广的接管方式。
- TUN 模式Virtual network interface
- TUN 借助虚拟网络接口在网络层接收流量,可覆盖部分不遵循系统代理设置的应用。启用通常涉及额外权限、路由和 DNS 配合,实际能力取决于平台与客户端实现。它不等于“所有连接都走代理”,进入 TUN 的连接仍可按路由直连;与其他 VPN 或虚拟网卡并用时还要检查路由冲突。
- SOCKS 与 HTTP 代理端口Local proxy listener
- 本地端口是应用连接代理服务的入口,SOCKS 与 HTTP 表示不同的代理协议。应用填写的协议、地址和端口必须与客户端监听设置一致;例如
127.0.0.1:10808只在该端口确实提供所需服务时才有效。回环地址只指向本机,改为局域网监听前,应明确访问范围并配置必要的访问控制。
- VpnService 与分应用代理Android traffic capture
- VpnService 是 Android 提供给应用建立 VPN 流量入口的系统接口,授权提示表示应用正在请求这一入口。分应用代理决定哪些应用进入接管范围,常见形式包括仅接管选中应用或排除选中应用,两者含义相反。进入入口后仍可继续按域名或地址分流,因此“应用已选中”不代表它的每条连接都经远端转发。