配置与排错词汇

V2Ray 术语表

界面里看到 VLESS、TUN 或真连接延迟时,可以先查它属于哪一层,再决定该核对节点参数、系统设置,还是配置文件。

协议与传输

节点设置里的协议、传输和安全层是不同的参数,排查时应分别核对。

VMessProxy protocol
VMess 是 Project V 生态中的代理协议,由客户端和服务端按约定识别用户并处理代理请求。导入后如果端口可达却连不上,除了核对用户标识、传输方式和安全设置,也要检查设备时钟是否准确。
VLESSProxy protocol
VLESS 是一种代理协议,通常用 UUID 标识客户端,但协议本身不加密载荷。实际配置常与 TLS 或 REALITY 等安全层搭配。只选对 VLESS 仍不足以建立连接,传输方式和安全层参数也要与服务端匹配。
TrojanTLS-based proxy protocol
Trojan 通常在 TLS 连接上使用口令进行认证,口令是代理协议的参数,不是证书参数。若日志停在 TLS 握手或证书验证阶段,应先核对服务端名称、证书和系统时间,再检查口令。
REALITYTransport security
REALITY 是 Xray 支持的安全层,常与 VLESS 搭配。它不是另一个代理协议,也不是 WebSocket 一类的传输方式。节点标注 REALITY 时,应先确认所选内核支持它,再对照节点来源核对服务端名称、公钥和短标识等参数。
传输方式Transport
传输方式决定代理协议的数据如何承载,例如使用原始 TCP、WebSocket 或 gRPC。两个节点即使采用相同的代理协议,传输设置也可能不同。遇到路径或服务名不匹配时,应找对应的传输设置,而不是改节点备注或认证信息。

内核与生态

界面负责管理设置,内核负责处理连接。两者的版本和支持范围要分开看。

Project VOpen-source ecosystem
Project V 是 V2Ray 起源所在的开源网络代理项目。后来出现了由不同社区维护的内核和图形客户端,因此文章里单说「V2Ray」时,可能指具体内核,也可能泛指整个生态。查配置前,先确认文档讲的是哪一种。
XrayXray-core
Xray 是从 V2Ray 生态发展而来的独立代理内核,支持 REALITY 等功能。图形界面能显示某个节点,不代表当前内核可以使用它;排查兼容性时,先看实际运行的内核及其版本,再核对节点所需的功能。
V2FlyV2Ray community project
V2Fly 是延续 V2Ray 开发的社区项目,其维护的 V2Ray 内核负责读取配置、接收入站并处理出站。它与 Xray 有共同的历史,但字段与功能会随各自版本演进,不能仅凭配置格式相似就认定两者可以直接互换。
查看内核配置参考 →

客户端功能

应用流量先进入客户端,再由内核决定如何处理。接入失败和出站失败需要分开排查。

系统代理System proxy
系统代理向遵循系统代理设置的应用提供本地代理入口。自行管理网络连接的应用可能忽略这项设置,所以浏览器能用并不代表所有应用都会走同一路径。关闭客户端后若应用仍尝试连接本地端口,可以检查系统是否还保留代理设置。
TUN 模式Virtual network interface
TUN 模式通过虚拟网络接口接收系统路由送来的流量,而不是等应用主动使用代理。启用时可能需要系统授权,实际接管范围仍取决于路由和排除项。已有其他虚拟网卡时,两套设置可能争用路由,需要分别确认生效范围。
入站inbounds
入站定义代理内核如何接收连接,例如在哪个地址和端口提供 SOCKS 服务。本机应用连接失败时,可以先核对它填写的协议和端口是否与入站一致。只供本机使用的入口通常监听回环地址,不必绑定到所有网络接口。
出站outbounds
出站定义内核如何处理连接,可以发往代理服务端,也可以直连或拦截。路由规则通常通过标签引用指定的出站。出现「入站已收到连接,但流量没有按预期发送」时,可以对照规则里的 outboundTag 与出站的 tag。
查看入站配置示例 →

路由与 DNS

解析决定怎样取得地址,路由决定连接交给哪个出站。两步有关联,但排错时不能当成一步。

路由规则routing.rules
路由规则按目标域名、IP、端口等条件为连接选择出站。V2Ray 和 Xray 通常按配置顺序检查规则,先命中的规则生效。如果某条精确规则一直没有命中,先看它前面是否已有一条范围更广的规则接走了连接。
分流Traffic routing
分流是把不同连接送往不同出站的做法,例如局域网连接直连,其余连接交给另一条出站。它只作用于已经进入相关处理链路的流量。测试结果不符时,先确认流量有没有进入内核,再检查分流条件。
GeoIPgeoip:
GeoIP 把 IP 网段按地区或地址类别归集,便于用一条规则匹配一组地址。它判断的是数据文件如何归类某个地址,不等于确认服务器的实际所在地。规则结果不同于预期时,应同时检查最终匹配的 IP 和当前数据文件。
GeoSitegeosite:
GeoSite 是按类别组织的域名集合,路由规则可以引用集合名来匹配一批域名。分类名称和覆盖范围由数据集决定,不能仅凭分类名推断一定包含某个域名。需要精确匹配单个域名时,可以单独写域名规则。
FakeDNSSynthetic IP mapping
FakeDNS 先向应用返回合成 IP,并保留它与原域名的映射。后续连接进入能识别该映射的内核时,内核可以取回域名并用于匹配规则。如果 DNS 响应经过了这套机制,但后续连接没有交给对应内核处理,应用就可能连不上。
DNS 泄漏DNS leak
DNS 泄漏指查询走了预期之外的解析路径,由非预期的解析服务处理。仅看到测试页面显示一个陌生的解析器,还不足以判断配置有问题,应先明确希望由谁解析。定位时可分开检查应用自带的加密 DNS、操作系统设置和内核的 DNS 配置。
查看路由规则与匹配顺序 →

订阅与节点

更新订阅、测试端口、经过代理发送请求是三件事。某一步成功,并不表示后面的步骤已经通过。

订阅Subscription
订阅是供客户端批量导入和更新节点资料的来源,常用链接提供。更新成功只表示客户端取到并处理了资料,不能据此判断每个节点都可连接。订阅链接可能包含访问凭据,分享截图或日志之前应遮住完整链接。
节点Server profile
节点是客户端里记录代理端点及连接参数的一条配置,通常包含地址、端口、协议和安全设置。备注名用于区分配置,不保证同名条目指向同一服务。更新后出现同名条目时,先比较它们所属的订阅分组和连接参数,再决定保留哪条。
TcpingTCP connect test
Tcping 用 TCP 建连耗时作为端口连通性的参考。它通常不检查代理协议认证,也不会通过该节点访问目标网站。出现 Tcping 正常但代理请求失败时,应该把排查重点转向协议、安全层和代理出站,而不是仅凭端口结果判断节点可用。
真连接延迟Proxied request latency
真连接延迟通过所选代理出站访问测试目标,再按客户端的实现记录请求耗时。测试地址、连接复用和目标服务的响应都可能影响结果,它也不是下载吞吐量。比较多个节点时,尽量使用同一个测试目标和同一种测试方式。