菜单名称与配置字段对照
V2Ray 概念速查
先分清协议、内核与传输,再看订阅、分流和 DNS。
遇到不熟悉的设置项,按下面六类定位。术语说明用于理解配置含义;具体菜单入口和字段支持,以正在使用的客户端与内核为准。
v2rayN 操作界面
Xray 执行内核
VLESS + TLS 协议与安全层
协议与传输
协议负责如何交换代理数据,传输负责如何承载这些数据。两端必须使用兼容组合。
- VMess
- VMess 是 Project V 生态中的代理协议,涉及用户标识、认证与数据加密,并不等于某一种传输方式。导入后应分别检查用户 ID、服务端口以及 TCP、WebSocket 等传输参数;使用 TLS 时还需检查对应的安全设置。连接失败不能仅凭协议名判断原因,系统时间偏差也可能影响认证。
- 协议与传输 · 常见字段 protocol
- VLESS
- VLESS 是轻量代理协议,本身不提供数据加密,通常结合 TLS 或 REALITY 等传输安全机制使用。客户端中的用户 ID、加密设置与 flow 是不同参数,不应把其他协议的值直接填入。是否支持某个 flow 或安全组合取决于实际内核,不能仅以客户端能导入链接作为兼容依据。
- 协议与传输 · 关联词 TLS、REALITY
- Trojan
- Trojan 是通常运行在 TLS 连接上的代理协议,使用密码进行认证,不能与以 UUID 为用户标识的配置混填。检查连接时,需要同时核对密码、地址、端口、传输方式和 TLS 参数。密码正确但证书名称不匹配,仍可能在安全连接建立阶段失败。
- 协议与传输 · 认证方式 password
- 传输方式
- 传输方式描述代理协议的数据如何在连接上承载,例如 TCP、WebSocket 与 gRPC,它与 VMess、VLESS 等协议不在同一层。WebSocket 的路径和 Host、gRPC 的服务名称都属于需要与服务端对应的参数。修改传输选项不是单方面的性能调优,服务端没有配置同类入口时无法直接互换。
- 协议与传输 · 常见字段 streamSettings
内核与生态
界面程序生成配置,内核处理连接。升级其中一项,不代表另一项也已更新。
- Project V
- Project V 是围绕 V2Ray 形成的开源网络代理工具生态,不是一份订阅,也不是远端服务器的提供方。图形客户端负责交互,内核负责入站、出站与路由,规则数据提供匹配集合。排查问题时先确认属于哪一层,避免把订阅返回错误误判为内核缺陷。
- 内核与生态 · 项目背景
- V2Fly
- V2Fly 是维护 V2Ray 相关项目的社区,客户端里的 v2fly 内核通常指该社区维护的 V2Ray 内核。v2flyNG 是图形客户端名称,不应与内核名称混为一谈。选择这条内核分支时,应对照其支持的协议和传输字段,不能默认另一分支的新增能力可以直接使用。
- 内核与生态 · 对应 V2Ray 内核
- Xray
- Xray 是与 V2Ray 有共同技术来源、后续独立发展的内核项目,具备自身的协议与传输实现。涉及 REALITY 或特定 flow 的配置,应先确认 Xray 内核及其实际版本是否支持。切换内核后需要重新检查生成配置和启动日志,字段名称相似不代表所有配置都兼容。
- 内核与生态 · 内核类型
- 图形客户端
- 图形客户端提供订阅管理、服务器选择、系统代理与日志查看等操作界面,实际连接通常交给配套内核执行。v2rayN 面向桌面平台,v2rayNG 与 v2flyNG 面向 Android,界面入口不必完全一致。判断某项能力是否可用,需要同时检查客户端是否能生成相关配置,以及内核是否能执行。
- 内核与生态 · 界面与内核分工
订阅与节点
先辨认输入内容的类型,再选择导入入口。订阅地址、分享链接和完整配置不能随意混用。
- 订阅
- 订阅是通过一个地址获取服务器配置集合的机制,更新订阅时由客户端重新请求并解析返回内容。Base64 编码的链接集合、结构化订阅和完整配置可能需要不同处理方式,地址能在浏览器打开并不代表格式可导入。订阅地址可能包含访问凭据,分享截图或日志前应遮盖完整地址。
- 订阅与节点 · 常见入口 订阅分组设置
- 节点
- 节点通常指一组连接远端服务所需的参数,包括地址、端口、认证信息、传输方式与安全设置。列表中的名称只是备注,并不能证明服务器所在地、协议支持或连接质量。出现问题时应打开配置详情逐项核对,而不是仅通过重命名、换分组来判断配置是否发生变化。
- 订阅与节点 · 客户端中也称服务器
- 真连接延迟
- 真连接延迟通常指客户端经代理出站访问指定测试目标时测得的耗时,测试路径可能包含认证、安全握手与目标响应。它不同于只检查端口是否可达的 TCP 测试,也不能直接换算为持续下载速度。比较结果前要统一测试目标与网络环境,单个目标超时不代表所有访问都必然失败。
- 订阅与节点 · 测试结果的适用范围
路由与分流
匹配条件、规则顺序与出站标签共同决定结果。规则写对,还要有可用的数据文件。
- 路由规则与分流
- 分流是根据域名、IP、端口等条件选择不同出站的过程,路由规则是表达这些选择条件的配置。规则通常按顺序匹配,因此范围较大的规则放在前面,可能使后面的细分规则失去机会。direct、proxy、block 在客户端中常用作标签或动作名称,最终生成配置里的出站引用必须与实际定义一致。
- 路由与分流 · 常见字段 routing.rules
- GeoIP
- GeoIP 是按分类组织的 IP 地址集合,路由中可使用 geoip:private 等表达式匹配目标地址。它依赖相应规则数据,并不表示客户端会实时测量每个地址的位置。以域名发起连接时,IP 条件能否参与匹配还取决于域名解析策略,因此应结合 domainStrategy 检查实际路径。
- 路由与分流 · IP 集合
- GeoSite
- GeoSite 是按分类组织的域名集合,例如 geosite:cn 或 geosite:category-ads-all,可用于域名路由规则。分类是否存在、具体包含哪些域名,取决于所安装的规则数据,而不是标签名称的直观含义。它不直接表示服务器的地理位置,规则文件缺失或分类拼错时应优先查看内核启动日志。
- 路由与分流 · 域名集合
- domainStrategy
- 这里指 routing 中的域名处理策略,用于控制路由匹配时是否尝试解析目标域名。AsIs 主要保留域名进行匹配;IPIfNonMatch 会在域名规则未命中时尝试解析,再参与 IP 规则匹配。它不是所有 DNS 行为的总开关,修改后还需检查内核 DNS、出站设置与应用自身的解析方式。
- 路由与分流 · 路由阶段的域名处理
客户端功能
流量入口与域名解析是两个问题。连接范围不同,所需权限和排查位置也不同。
- 系统代理
- 系统代理向操作系统登记本地代理地址和端口,主要影响遵循这一设置的应用,并不自动接管所有网络请求。v2rayN 的自动配置系统代理需要本地入站已经正常监听,清除系统代理则是移除相关系统设置。部分应用采用独立代理或直接连接,应分别查看应用设置,不能只根据系统开关判断。
- 客户端功能 · 系统级代理设置
- TUN 模式
- TUN 模式通过虚拟网络接口接收流量,再由客户端配套组件按规则转发,它不是 VMess 或 VLESS 这样的代理协议。能否启用取决于系统权限、路由与实现方式,桌面端可能需要提权,Android 通常需要授予 VPN 连接权限。启用后应检查局域网访问和 DNS,多个接管网络的程序同时运行容易产生冲突。
- 客户端功能 · 虚拟网络接口
- DNS
- DNS 用于把域名解析为 IP 等记录,系统、浏览器与代理内核可能分别采用自己的解析路径。内核中填写 DNS 服务器,不代表浏览器的加密 DNS 或所有应用请求都会自动改走同一路径。排查时应区分域名是否解析成功、返回地址是否可达,以及解析请求本身通过哪个出站发送。
- 客户端功能 · 域名解析
- FakeDNS
- FakeDNS 为域名返回合成 IP,并保存域名与地址之间的映射,使后续连接可恢复原始域名用于处理。它依赖 DNS 接管和流量入口协同工作,不能把合成地址当作普通公网地址交给不识别映射的程序。切换或关闭相关模式后,应用缓存可能仍保留旧地址,需要结合缓存与解析路径排查。
- 客户端功能 · 合成地址映射
加密与伪装
连接地址、认证参数和证书名称分别核对。安全层成功建立,也不代表路由结果符合预期。
- TLS
- TLS 是提供传输加密和身份验证的安全协议,可作为多种代理协议的外层保护。连接时需要检查证书有效期、信任链、服务器名称与系统时间,而不只是确认 TLS 开关已开启。跳过证书验证会削弱身份验证,不应作为长期解决方案;名称不匹配时应修正配置或服务端证书。
- 加密与伪装 · 传输安全
- REALITY
- REALITY 是 Xray 生态中的传输安全机制,需要客户端与服务端使用相互匹配的参数,并确认实际内核支持。常见设置涉及 serverName、公钥相关参数、shortId 和指纹,部分字段在不同版本中的名称可能变化。它不是可随意替换 TLS 的通用按钮,不能把普通 TLS 配置直接切换后预期连接成功。
- 加密与伪装 · 关联内核 Xray
- SNI 与 serverName
- SNI 是 TLS 握手中携带服务器名称的扩展,配置里的 serverName 通常影响发送的名称以及证书名称验证。服务器连接地址负责确定连接到哪里,serverName 则用于安全层的名称处理,两者不必是同一个值。应使用服务端提供的对应名称,不能把订阅备注或任意域名填入该字段。
- 加密与伪装 · 服务器名称
- DNS 泄漏
- DNS 泄漏指查询走了预期之外的解析路径,例如网页请求进入代理,而域名查询仍由另一条系统路径发出。判断前需要先定义预期路径,不能仅凭测试页显示某个解析服务名称就认定异常。排查应结合浏览器加密 DNS、系统解析器、内核 DNS 出站和 TUN 接管范围,逐层确认实际行为。
- 加密与伪装 · 解析路径检查
术语对应的操作入口
已经确认概念后,再进入操作文档。导入问题先检查内容格式,连接问题先看内核日志,分流问题先核对规则顺序与 DNS 路径;避免同时更改多个设置,导致无法判断是哪项修改起作用。