V2Ray 协议与内核手册
先分清代理协议、传输方式和安全层,再核对客户端是否保留了服务端要求的参数。第一次安装或导入订阅,从使用教程沿主线完成连接与验证;教程中的协议选择和兼容性问题,可回到本手册按章查阅。
协议与配置层次
节点类型只描述其中一层
图形客户端把远端连接保存为节点。一个节点至少要说明连接哪个入口、如何托管代理会话、如何承载数据,以及是否使用独立安全层。VMess、VLESS、Trojan 和 Shadowsocks 是代理协议;它们规定客户端如何提交凭据、表达目标地址以及传送会话数据。TCP、WebSocket 和 gRPC 属于传输选择,决定这些数据怎样抵达服务端。TLS 和 REALITY 则属于安全层选择,不是代理协议菜单中与 VLESS 并列的另一种会话格式。界面有时把多个字段拼进节点名称,那只是便于识别的标签,不能用来恢复配置。
以 VLESS、WebSocket 和 TLS 的组合为例,客户端先连接入口,完成 TLS 验证,再通过约定路径建立 WebSocket,最后在其中发起 VLESS 会话。若入口由反向代理接收 TLS,远端域名指向的往往是反向代理而不是内核进程。浏览器能打开这个域名,只说明网页对应的入口可用,不代表 WebSocket 路径已转发,也不代表服务端识别所填用户标识。反过来,代理凭据正确也不会修复错误的路径。配置时从外向内核对,能避免在认证字段上反复试错。
| 层次 | 常见字段 | 该字段回答的问题 |
|---|---|---|
| 入口 | 地址、端口 | 连接实际发往哪里? |
| 代理会话 | 类型、用户 ID、密码 | 服务端如何识别请求? |
| 传输 | TCP、WebSocket 路径、gRPC 服务名 | 数据由什么方式送达后端? |
| 安全层 | TLS、REALITY、SNI | 如何建立并验证外层安全连接? |
地址、SNI、Host 与路径不能互相补位
地址和端口决定实际拨号位置。TLS 下的 SNI 在握手阶段向入口指明服务名,证书也要按客户端采用的验证名称检查。WebSocket 的 Host 属于 HTTP 请求字段,接收方可能用它选择虚拟主机;路径则决定进入该主机下的哪个处理器。这几个值经常恰好相同或共享同一个域名,但用途不同。有的入口要求地址填接入域名、SNI 填证书覆盖的名称、Host 保留独立值。脚本或客户端把空项自动继承成地址,并不表示服务端接受这个推断。
端口号也不说明协议。常见 TLS 端口可以承载不同应用,非标准端口也可以启用 TLS。更换端口之前应知道入口实际监听什么,而不是从号码猜测它是否加密。导入后如果界面把传输显示为自动,先查看节点详情或诊断信息里的实际设置;不要把客户端预填值当成订阅原始内容。日志如果同时包含本地监听地址和远端服务器地址,先辨别出错的是哪一端:本地端口被占用时,换远端设置通常没有效果。
出站成功和应用接入是两件事
代理节点是出站。应用通过系统代理、本地代理入口或 TUN 接入是另一个环节;其后还有 DNS 和路由决定请求是否交给该出站。不遵循系统代理的应用可能根本没有把请求送到客户端。即使节点测试通过,目标域名也可能命中直连规则,或域名解析已在到达内核前失败。验证时先用明确遵循系统代理的应用建立基线,再看日志是否出现对应目标和预期出站。若仅在 TUN 启用时失败,先核对虚拟网卡权限、路由和 DNS,再判断是否需要换协议。
VMess 与 VLESS
VMess:读懂历史字段,再判断是否匹配
VMess 是 Project V 生态较早采用的会话协议,把用户认证和协议自身的数据安全机制放在同一个设计里。它能在不同传输上运行,因此同名节点可能直接使用 TCP,也可能附带 WebSocket 和 TLS。配置表单中的用户 ID 用于识别账户,VMess 加密选项描述会话内部的处理方式;传输层安全里的 TLS 是外层连接选项。打开 TLS 不会替代 VMess 的身份认证,两处写着加密也不意味着字段可以互填。
旧配置经常带有 alterId,现代 VMess AEAD 配置通常使用零值。遇到非零值时,先确认是历史导出残留,还是服务端确实使用客户端已不支持的旧方式。把字段改成零只能改变本机发送的请求,不能使服务端自动迁移。类似地,界面的 auto 如果位于 VMess 加密菜单,通常是内核对数据加密选项的自动选择,不表示会探测传输类型、安全层或服务器端口。遇到带旧字段的订阅,比起修改一串未知参数,先取得服务端重新导出的条目更省步骤。
VMess 的认证对时钟有要求。设备从休眠恢复、手动调整时间,或者失去自动校时后,其他网站可能仍能打开,VMess 请求却在认证阶段失败。核对的是设备的实际时间,而不是界面显示的时区名称;改变时区不会纠正系统时钟偏差。服务端和客户端都可能有偏差。修正时间后,在原入口、原传输和原账号下复试,才知道此前故障是否与时钟有关。如果同时换了节点,又改了 DNS,即使恢复连接也难以归因。
VLESS:会话开销与连接安全分开考虑
VLESS 把会话标识和连接保护分开。在常见的部署组合中,客户端用用户 ID 发起代理会话,外层由 TLS 或 REALITY 负责建立安全连接。现有分享条目里常见 encryption=none,它描述这类配置中的 VLESS 协议加密字段,而不是说外层连接也不需要保护,更不表示把安全层一起改为无。若服务端另有扩展要求,应以该内核和服务端给出的参数为准,不把某个分享链接中的默认值推广到所有实现。
VMess 和 VLESS 的界面都有类似 UUID 的用户 ID,但这只是字段形状相近。客户端把节点类型切为 VLESS 后,会发出与 VMess 不同的会话请求,服务端必须有相应入站才能接收。切换时也不能把 VMess 加密选项照抄到 VLESS,更不能因为某个 VLESS 条目可用就把同订阅里的 VMess 条目一并迁移。服务端同时提供两种入口时,分别创建或导入两个节点,保留原命名和接入参数,便于比较和回退。
从失败阶段缩小范围
先检查底层能否连接指定地址和端口,再区分外层握手和内层认证。如果日志已表明外层 TLS 证书验证通过,但节点会话仍被对端关闭,检查协议类型、用户 ID、传输和流控是否与服务端一致。若故障只发生在少数长连接,不应凭一次短请求测试认定整个会话层稳定;规则选择、代理入口对空闲连接的回收、网络切换后旧连接失效,都可能只在较长会话里出现。修改一个字段后,用相同应用和同一目标重试。如果没有服务端日志,客户端的「连接被关闭」只能缩小范围,不能直接证明是哪一项填错。
Trojan 与 Shadowsocks
Trojan:分别核对外层证书和会话密码
Trojan 的设计以 TLS 连接作为基础,使代理数据通过已建立的 TLS 通道传输。经典配置的核对顺序是入口地址和端口、证书名称及信任链、最后是代理密码。客户端中的密码不是证书口令,也不是系统账户密码;证书正确只说明 TLS 层建立了预期的对端身份,不能说明密码被接受。反之,正确的代理密码也不能解决证书过期、证书链不完整或设备时间不准引起的验证失败。
图形客户端有时提供 Trojan 加上其他传输的选项,那是特定实现与接入部署的组合,不应视作所有 Trojan 服务都支持的默认格式。由反向代理承接的入口可能需要路径或服务名,普通 TLS 入口未必需要这些字段。收到一个条目时,先看传输参数是否明确存在,再对照服务方说明,避免为了填满表单而给空项加值。证书名称不同于地址时,确认服务端约定的 SNI 和验证名称;不要把关闭证书验证作为正常配置,因为这样就失去对连接对象的关键检查。
TLS 连接刚建立便结束,不一定是密码问题。对端可能只在特定传输入口接收代理请求,也可能已经进入 TLS 前端但没有到达后端。先在日志里找到握手是否真正完成,再把入口类型、传输字段和密码分开确认。若已有一条可用记录,复制后只替换由服务端明确变更的字段,而不是用网页地址或其他节点的字段填空。密码含保留字符时,分享链接中的百分号编码和手动输入框里的原文也要区分;将同一个密码解码两次可能改变实际值。
Shadowsocks:加密方法是协议参数
Shadowsocks 最初以较简洁的加密代理为目标,将目标地址和应用数据封装在经认证或加密的会话中,使用的具体机制取决于所选方法和代际。常见的现代配置采用 AEAD 方法,例如 aes-128-gcm 或 chacha20-ietf-poly1305。服务端指定哪一种,客户端就应选哪一种;相同密码配不同方法会生成不兼容的请求。不能因为设备某种算法跑得快,就在不改远端的情况下换成该算法。遇到旧方法,先核对当前内核是否支持,以及服务端是否能提供维护中的替代配置。
Shadowsocks 2022 系列的方法名和密钥要求与较早的 AEAD 方法不同。部分方法要求规定长度的编码密钥,也可能有多用户参数;把普通口令直接填入未必能通过本地配置检查。解析器能导入 ss:// 也不等于内核支持其中的方法或扩展。导入后先看方法是否完整保留,再检查凭据格式和扩展参数。若节点信息带有额外组件,而客户端界面没有相应项,需要回头确认客户端与内核的实现范围,不能只依赖链接前缀判断兼容。
单独验证 UDP
能通过节点浏览网页,通常只证明至少有相应的 TCP 请求成功。实时通话等应用可能需要 UDP,结果还取决于应用是否向客户端交付该流量、内核出站如何承载它、服务端是否接收,以及路由有没有选错。系统代理模式下某些应用绕开本地代理入口,也是很常见的混淆。用需要 UDP 的实际应用单独测试,结合日志观察流量是否进入预期出站;若从日志看不到请求,先修正接入与规则,再考虑出站协议支持。对照测试时保留能浏览网页的结果,不要把两类验证合并成单一的「连通」标签。
REALITY 与 XTLS Vision
同一条节点可以同时包含三个名称
在常见的 Xray 节点中,VLESS 描述代理会话,REALITY 描述外层安全连接,xtls-rprx-vision 是 VLESS 用户流控值。服务端可以只提供 VLESS 加 TLS,也可以提供 VLESS 加 REALITY 而不要求 Vision,不能从其中一个名称推断另两个值。客户端编辑器通常分别显示协议、传输层安全和流控。应先确定入口配对,再逐项填入设置,而不是把三个词当成同一个菜单中的不同叫法。尤其不要把「流控为空」与「客户端忽略了流控」混为一谈。
REALITY 在 Xray 中提供不同于常规证书部署的握手方式,服务端可按其配置建立握手所需环境,不依赖为该代理入口单独发行常规站点证书。客户端仍需要拿到正确的服务端认证参数。表单可能写公钥,也可能用与内核字段演进有关的名称展示该客户端参数;应使用服务端发布给客户端的值,不使用服务端私钥。服务器名称和短标识也必须符合服务端的配置。短标识看起来像十六进制文本,但格式正确与服务端接受是两回事;是否可以留空同样由对端配置决定。
Fingerprint 影响所用客户端握手特征,常见取值如 chrome 对应内核提供的一种握手模板,不是选择本机已安装的浏览器,也不是设备硬件标识。SNI 在这里也不意味着应把服务器地址替换成同一个名字:地址确定实际连接入口,名称仍按照服务端要求提供。遇到导入器把两项合并的情况,应找支持相应字段的客户端或由服务方重新导出,而不是把两个值改成一样来消除界面报错。
Vision 减少某些数据路径中的重复处理
应用本身经常使用 TLS。若外层代理连接对这些已经加密的数据再次按常规路径进行加密处理,可能增加复制、封装和密码运算的成本。Vision 针对满足条件的数据路径作优化,不等于所有应用数据都会走相同路径,也不等于取消握手和对端认证。它不是提高网卡速率的开关;吞吐若已被远端出口、无线信号或目标限速卡住,减少本地工作量也未必缩短下载时间。需要比较时,保持服务端和网络条件一致,分开观察首个响应和持续传输。
先验证字段结构,再验证连接
这段 JSON 是 Xray 原生出站流控位置的最小片段,用于说明 flow 属于 VLESS 用户项;合并时用它核对已有记录,不用整段覆盖完整出站。下列命令用于检查内核是否能读取已保存的完整配置,需在 Xray 可执行文件所在目录运行,或将命令中的程序名换成实际路径。
{
"flow": "xtls-rprx-vision"
}
xray run -test -config config.json
本地测试通过只说明配置能被该内核读取,不确认公钥、名称、短标识和用户 ID 与远端一致,也不证明端口可达。图形客户端生成的完整配置可能包含其他出站和本地入口,不宜拿单个片段直接启动。排查时先看内核是否拒绝流控或安全层字段,再查日志是连接入口失败还是握手被拒绝。若要区分数据路径和握手机制,可参阅REALITY 与 XTLS Vision 原理,不必从某次测速结果反推配置结构。
Xray 与 V2Fly 内核兼容性
同一生态不代表配置长期等价
Project V 提供了以入站、出站、路由和传输模块组织代理连接的基础。V2Fly 延续 V2Ray 核心的社区开发;Xray 从同一生态发展出独立实现,在协议扩展和传输安全方面走出了不同路线。两者的部分 JSON 结构、协议名和术语相近,原因是设计有共同来源;它们不是同一个二进制程序的不同名称。文章里的某项配置是否可用,取决于实际内核及其功能,而不是仅看教程标题写的是 V2Ray 还是 Xray。
VMess 等共同功能的条目有机会在两个内核中使用,但仍要核对传输类型、认证方法及客户端生成结果。依赖 REALITY 或 XTLS Vision 的 VLESS 条目,应选择明确支持相应组合的 Xray 配置,不以另一个内核能够识别 VLESS 名称来推断扩展兼容。配置也不只是一条出站。原生 JSON 里可能包含专用 DNS 项、路由匹配方式、外部数据文件引用、统计接口或入站嗅探设置,其中一处不兼容就可能导致整份配置加载失败。
| 平台 | 客户端 | 需要确认的事项 |
|---|---|---|
| Windows | v2rayN | 桌面版或经典 WPF 版,以及节点实际启用的内核。 |
| macOS | v2rayN | 安装包匹配处理器架构,客户端可启动所需内核。 |
| Linux | v2rayN | 包格式和架构匹配发行版,必要的资源文件可读。 |
| Android | v2rayNG、v2flyNG | 前者用于 Xray 配置;后者作为 V2Fly 配置备选。 |
迁移从一条出站开始
桌面首推 v2rayN,选择节点后还要确认界面或启动日志报告的实际运行内核。客户端能管理节点,并不表示它会为所有协议用同一种生成方式。切换内核前在本机保留原节点和规则,记录当前本地代理端口、系统代理或 TUN 状态。不要直接拿完整旧 JSON 覆盖客户端的生成结果;可以先导入一条双方具备相同能力的节点,在默认路由和明确的应用接入方式下复测。成功之后,再恢复自定义 DNS、路由、分流数据与附加入口,并在每一步验证行为。
本地提示字段未知、方法不支持、资源不可读,优先按配置加载问题处理,而不是去测远端延迟。节点已经出现在列表但内核未启动时,列表中保存的条目只证明客户端接受了输入。内核能启动而部分网站仍失败,则检查路由输出是否和原来一致:同名规则预设可能引用不同数据,规则顺序也可能改变首条匹配结果。单节点可用、多个规则恢复后失败,回退最后一批变更通常比重新导入整组订阅更容易找到原因。
配置迁移时可把变化分为表单展示、内核语法和运行环境三类。表单名称改变而实际生成值一致,通常不需要改服务端;内核不认识字段时,应选择支持的组合;若日志报权限或本地端口冲突,则属于运行环境。三类问题的修复方式不同。需要确认家族关系与字段演进时,可继续读Xray 内核与 V2Fly 内核区别,再返回当前客户端查看设置,而不是只看旧配置的截图决定是否迁移。
订阅格式、导入与字段迁移
订阅地址、分享链接和原生配置是三类输入
订阅地址让客户端从远端取得一组条目;单条分享链接携带一个连接所需的常见字段;原生配置则能描述完整运行结构。订阅返回内容可能是逐行分享链接、编码后的文本,或专门面向某种客户端的结构化文档。地址能够在浏览器打开,只说明请求拿到了内容,不说明内容是该客户端认识的格式。若响应实际是登录页或错误说明,客户端可能只显示空列表。先确认订阅地址仍有效、内容类型符合客户端要求,再检查条目本身。
常见的 vmess:// 分享内容可用编码承载对象,但也有不同字段约定;vless:// 和 trojan:// 经常用地址与查询参数表达传输、安全层和入口。Shadowsocks 分享方式也存在不同写法。不能把所有格式都当成同一种 Base64 包装,更不能因为解码后可读就认为解析成功。百分号编码影响密码、路径和查询值;备注名称中的符号也可能改变链接分段。用客户端正式的导入入口,不手工拼接带凭据的完整链接;必要时请服务端重新生成适配条目。
导入之后验收参数,而不是只数节点
从一条准备使用的节点开始,比对协议类型、入口、外层安全和传输四组字段。WebSocket 核对 Host 与路径,gRPC 核对服务名,REALITY 核对客户端认证参数和短标识,Vision 核对流控。再看 TLS 的 SNI 是否继承自地址,确认继承行为符合服务方的说明。有些转换只保留两个格式共有的字段,导致节点名称存在却丢了服务名;有些客户端看得见字段,但当前选中的内核不支持。分别核对导入结果和运行日志,才能定位是解析器还是内核的问题。
导入器不会把一端的代理协议改造成另一端的协议。所谓订阅转换通常只是重排或重新编码同一批连接参数,不能让 VMess 服务自动接收 VLESS,也不能保证特殊传输、流控和路由规则都能完整迁移。若旧客户端没有目标参数对应的表单,优先使用服务方提供的适配订阅。通过含敏感内容的订阅地址获取配置时,尽量使用客户端自己的导入功能;把整条地址给第三方转换工具,相当于可能把读取订阅的权限一起交出去。
处理刷新覆盖和重复条目
订阅分组通常由客户端管理。刷新后,本地手改的名称、流控或路由选择可能还原,具体取决于识别条目和覆盖的策略。要试验字段,可先复制到独立的手动分组,并留下能复现的原条目。若同一名称在刷新后出现多条,比较协议、地址、端口和传输组合再判断是不是重复;名称可能只是地区或用途说明。服务端轮换凭据时,应先刷新有效分组,再验证当前选中的是否是旧副本,不必先删除所有记录。
订阅能更新而连接失败,说明能访问订阅服务,不说明节点入口可达;节点可用而订阅更新失败,也可能只是订阅服务过期、解析失败或更新请求走了不同出口。按订阅导入教程完成基本操作,碰到刷新后失效时先取一条新条目单独测试。若新旧条目的入口不变而安全层变化,就检查新字段是否保留;若连协议类型都变了,按新节点重新验收,不延用旧条目的判断。
连接速度、资源占用与移动端电量
把首个响应和持续吞吐分开
短请求的等待可能包含本地 DNS、入口拨号、TLS 或 REALITY 握手、传输层建立、代理会话及目标响应。客户端的延迟测试可能只拨端口,也可能通过节点请求固定目标,两者的数值不在同一尺度。端口连接很快但完整请求慢,应再看握手和目标栈;测试目标本身缓存、跳转或限速,也可能掩盖协议差异。实际使用中更值得记录的是冷连接首个响应、热连接重复访问和持续传输三项,而不是给所有节点按一个延迟数字排名。
持续吞吐由链路带宽、交互时延、丢包、服务器出口、处理器能力与应用并发共同决定。VLESS 的常见会话格式较轻,但外层握手、反向代理和路径仍有成本;VMess 的会话加密会占用运算资源,实际差异要看处理器和负载;Trojan 的常见路径需要 TLS;Shadowsocks 的开销则随方法和实现变化。支持硬件加速的设备和低功耗设备不一定得出相同排序。多一个传输封装也不必然让体验变差:它可能复用已有连接,或者通过部署中更合适的入口接入后端。比较时先说明正在比较什么。
多路复用不等于每项指标都上升
Mux 将多个逻辑会话放入较少的底层连接,可减少某些使用场景中的连接建立次数,但共享连接出现拥塞、丢包或重连时,其中的会话可能一起受影响。混合长短请求时,少数大流也可能影响短请求感受。客户端和服务端要支持所选的复用方式,且不同流控或传输组合未必适合叠加。开始测试时保持默认配置,然后只改复用一项,分别看网页、长下载和实际需要的并发应用。如果峰值更高但交互变慢,应分开记录,不用一个综合数字掩盖差别。
移动端先查后台唤醒与接管范围
移动端电量不只花在加密上。虚拟网络接口接管范围变大,会增加进入代理处理链的流量;频繁的保活、订阅刷新、测速轮询和失败重试,都可能使无线设备无法及时休眠。蜂窝网络信号弱或在两种网络之间切换时,重连也会增多。屏幕关闭后的待机掉电与下载期间的高功耗应分别记录。前者优先观察后台活动,后者再结合处理器负载、流量大小和无线环境判断瓶颈。
测试时可以先用同一网络、相近信号和固定时段,在相同后台应用条件下比较两轮。第一轮保留原配置,第二轮只调整一个明确项目,如暂停周期测速、缩小接管范围或换用服务端同时提供的另一种组合。若两轮之间切换了入口所在地、路线或设备功耗模式,结论只能描述总体体验,不能归因到协议。打开系统耗电统计时同时关注客户端与系统网络服务;不同系统的计量口径不同,不能把进程显示的单项比例当成代理的全部用电。应用失联与耗电同时升高时,先看是否存在重试循环。
按使用场景选择协议
已有服务端:接入说明优先于协议偏好
服务端只给一种入口时,选型就是找到能完整表达该入口的客户端和内核。桌面从 v2rayN 开始,按下载页选择系统与处理器架构对应的软件包。移动端遇到 VLESS 加 REALITY、带 Vision 的条目,先用 v2rayNG 核对相应设置;如果明确需要 V2Fly 侧能力,再考虑 v2flyNG。先导入一条由服务端给出的记录,验证字段完整、内核启动以及目标应用确实走到出站。不要因为某个界面有一个同名选项,就跳过安全层或传输层核对。
服务端同时支持多种入口时,问清是否共享相同出口、是否经过不同前端、是否有各自的传输限制。持续使用的 VMess 节点如果与现有客户端匹配,且能够满足应用需求,没有必要单凭协议演进顺序迁移。管理常规证书和 TLS 入口已有固定流程时,Trojan 可以按证书与密码分别维护;Shadowsocks 则要把方法与密钥格式纳入客户端能力清单。在 Xray 环境确实提供 VLESS 与 REALITY、并且相应客户端可以完整解析配置时,再评估这套组合和流控是否满足目标。没有任何一种组合能替代实际连通与资源测试。
多设备、长连接和按应用接管
多设备共享订阅时,先用最常使用的两种设备各验证一条节点。目标是相同服务端参数能被各自的解析器保留,而不是所有表单使用相同中文名称。若某台设备无法识别扩展,向服务方索取兼容入口,可以比撤掉整组设备上的扩展更容易维护。同步节点名称和服务入口即可,本地代理端口、系统路由和权限应按设备单独保存。这样当某台设备出现问题,其他设备上仍能保留已验证的配置。
长连接、语音或频繁切换网络的应用,应把会话恢复、UDP 可用性以及 TUN 接管需求作为单独的验收项目。长连接测试要覆盖锁屏、恢复前台和更换网络;如果锁屏后断线而前台始终稳定,先查系统后台限制及应用重连行为。仅少数应用需要通过客户端时,先验证系统代理是否足够,再根据TUN 模式教程调整接管范围。需要分流时,利用路由设置说明核对规则顺序。接管更多应用不会替代出站能力,接管更少也不代表修改了节点协议。
上线前留下可复查的结果
先选一条已知可用的基线节点,记录客户端、内核、协议、传输、安全层及接入模式,不公开个人凭据。用同一个应用完成一次从关闭客户端到重新连接的验证,再测试实际常用任务。切换方案后保留基线,按相同顺序重测。若只有某个域名失败,先排 DNS 与规则;若整体无流量,查看应用接入和本地监听;若内核启动即退,则回到配置文件、端口和权限。登录状态或界面显示「已连接」不是完整验收结果,详细故障分支见已连接却打不开网页的排查清单。
完成核对后,保留服务端提供的原始条目与一份不含凭据的字段说明。后续升级客户端时先验证原配置,再导入更新,不把应用升级、内核切换、订阅转换和规则调整放在同一轮。选择依据应能写成一句具体判断,例如「现有入口要求指定流控,客户端能够保留该字段,实际长连接已验证」。如果尚无这样的依据,先确定缺的是接入信息、内核能力还是测试结果,再决定下一步。