V2Ray 协议手册
先确认客户端与内核是否支持完整的连接组合,再比较速度、电量和更新成本。
快速上手负责安装、导入和首次验证;本手册用于查阅协议原理、核对兼容性和解释测试结果。如果已经拿到节点,只想先完成一次连接,按教程走完主线,再回本页查对应章节。
连接分层:一个节点由哪些参数组成
客户端、内核与远端服务
客户端是管理界面。它保存订阅,展示节点,维护路由选项,并在连接时把这些设置交给内核。内核负责打开本地监听端口、处理传入的请求、建立远端连接和执行协议。远端服务则按部署时约定的方式接收请求。一条分享链接能够显示在列表里,只能证明客户端读到了足以建档的内容;内核是否能启动、远端是否接受请求,仍要分别验证。相反,界面里找不到某个选项,也不一定说明内核没有实现它,可能是导入器或编辑器还没有暴露该字段。
排错时先分清三段:应用到本地入口、本地内核到远端服务、远端服务到目标站点。应用无法连接本地端口,通常还没走到协议握手;远端端口可达,也不表示身份认证已经完成;认证通过后只有个别目标出错,则应再检查路由、解析和目标站点的响应。故障出现在不同段,日志的意义也不同。不要只凭客户端标题栏的状态判断:它可能只表示进程已启动,并未代表某条连接已经建立。
代理协议、承载方式与外层安全
在节点编辑器中,协议类型回答「请求怎样编码、凭据怎样使用」;传输或网络类型回答「这些数据怎样交给远端」;安全设置回答「外层连接怎样保护、客户端怎样识别对端」。例如 VLESS 是代理协议,WebSocket 是一种承载方式,TLS 是外层安全机制。三项不会因协议名称相同而自动一致。服务端端口即使是常见的 HTTPS 端口,也不能由此推断它一定使用 WebSocket、某个路径或某个服务器名称。
| 层次 | 常见字段 | 判断边界 |
|---|---|---|
| 网络端点 | 连接地址、端口 | 能建立底层连接,不代表上层认证通过。 |
| 代理协议 | 协议类型、用户标识、密码或加密方法 | 字段看起来相似,不代表可以跨协议复用。 |
| 承载方式 | 原始字节流、WebSocket 路径等 | 路径、服务名和请求主机名按实际部署核对。 |
| 外层安全 | TLS、REALITY、服务器名称等 | 按所选机制校验对端,不能用任意安全选项代替。 |
连接地址、握手使用的服务器名称和应用承载层的请求主机名,可能填成同一个域名,但并不执行同一项工作。连接地址用于找到端点;服务器名称参与安全握手,常用于选择对应站点或校验证书;请求主机名则可能参与承载层的应用分发。若部署把入口地址与站点名称分开配置,不应为求界面整齐而把三处统一改成一个值。反向代理之后的路径同样以部署提供的为准,不适合用浏览器地址栏里看到的路径猜测。
本地流量入口与远端协议分开判断
系统代理、手动指定的本地代理端口和 TUN 模式决定流量怎样进入客户端,它们不改变已经选定的远端协议。启用系统代理后,遵循系统设置的应用才会主动交付请求;接入虚拟网络接口时,还要考虑路由表、排除范围和域名解析。某个应用在系统代理下不工作、切换入口后恢复,首先说明接入路径发生了变化,不能直接归因为原来的远端协议不支持这个应用。看内核日志是否出现相应请求,比反复切换节点更有效。
VMess 与 VLESS:认证、加密与配置差异
VMess:认证与数据保护由协议参与
VMess 在 Project V 的早期体系中作为专用代理协议发展。它把用户认证、请求头处理和数据传输组织在同一套协议里。客户端常以 UUID 标识用户;这个值看起来像普通标识符,但用于认证,应当和密码一样管理。与只负责转交字节的通道不同,VMess 有自己的报文处理规则。连接再套用 TLS 时,内层协议与外层安全各自工作:前者识别代理请求,后者保护到 TLS 终止点的通道并校验对端身份。
维护旧节点时,最容易误会的是备用身份数量、认证格式和数据加密字段之间的关系。旧导入器可能保留历史字段,界面也可能把它们与当前选项并列展示;字段仍在,不代表新配置需要照填。现代部署通常采用 VMess 的 AEAD 认证,不应为了让旧分享链接连接成功而随意恢复历史认证形式。若旧条目仍在使用,应该先问清服务端接受的形式,并区分认证方式与数据部分的加密设置。下拉菜单中值更多,也不代表自动选择总能与远端协商成功。
VMess 认证对时钟偏差敏感。若备用设备连同一端点正常,而刚结束休眠或长时间离线的设备持续在认证阶段失败,先检查自动校时和实际系统时间,再去核对用户标识。显示时区不同本身不是认证失败的原因,真正相关的是两端所依据的时间是否对得上。如果同步后依旧失败,就回看远端是否接受该认证形式、条目是否仍有效。反复更改传输路径只会掩盖原有诊断线索。
VLESS:把代理请求与外层保护分开
VLESS 的早期设计把代理请求头做得较轻,常见部署用 UUID 识别用户,并把安全通道交给 TLS 或 REALITY。在常见配置中,若加密字段显示 none,它描述的是该字段所指的代理协议层,不能据此断言链路明文,也不能据此断言链路已受保护。应回到安全栏确认生效的外层机制及其覆盖范围。若条目使用某一实现新增的加密能力,还要核实双方是否都支持该扩展,不能沿用旧配置经验判断。
流控字段和传输字段也要分开。以 Xray 的 Vision 为例,xtls-rprx-vision 是特定组合下的流控设置,不是所有 VLESS 节点的通用默认值。收到字段为空的条目,不要仅因另一个节点填写了 Vision 就补进去;收到明确携带流控的条目,也不能为迁就编辑器而简单清空。外层安全和承载方式能在菜单里选到,只说明界面有这些选项,并不证明它们能与当前流控任意组合。
从旧条目迁移时保留对照样本
从 VMess 改用 VLESS 不是更名。只有远端实际开放了 VLESS 入口,客户端才有条件建立相应连接。应向维护方取得新的节点条目,在客户端中与旧条目并存,分别测试冷启动访问和持续传输。两条目若分属不同线路,即使其中一条更快,也不能据此判断是哪一种协议缩短了耗时。若工作中还依赖按应用分流或远程会话,切换前还要确认所用流量确实走过新节点,而非仅测到目标站点可以通过其他路径到达。测试成功后再把旧条目退出自动选择组,可避免结果在后台被切换策略覆盖。
Trojan 与 Shadowsocks:两种会话保护模型
Trojan:先建立 TLS,再交付代理请求
Trojan 的经典方案把代理请求放在 TLS 会话里。客户端先与远端建立受 TLS 保护的连接,再按 Trojan 协议提供由密码生成的认证数据以及目标地址。这个顺序给出了清楚的排错边界:证书不受信任、服务器名称不匹配或证书过期,都发生在发送有效代理请求之前;继续重填密码不会修复证书校验。若 TLS 已经成功而远端关闭连接,则再核对凭据、入口类型,并结合内核和服务端日志判断失败时发生了什么。
对使用域名和证书的长期部署,证书续期是否完成、客户端是否连接到预期端点,往往比记住协议的握手细节更重要。若同一条目从家中可以连接、换一张网络后失败,先比较两边解析的远端地址与证书信息。到达不同端点时,即使名称看似相同,也可能碰上其中一台服务尚未完成更新。碰到证书问题应修复名称、时间或信任链,不要把允许不安全连接当成日常兼容设置。浏览器能打开服务上的某个页面,也只证明浏览器访问路径可用,不能替代 Trojan 认证测试。
Shadowsocks:加密方法和密钥必须匹配
Shadowsocks 常缩写为 SS,早期重心是提供精简的加密代理。常见配置以服务地址、端口、加密方法以及密码或密钥为主。典型部署在协议自身保护数据的同时,并不默认要求再做一轮证书握手。这使端点配置相对直接,不过加密方法仍是严格的互操作条件。不能把两个看似都使用同类型算法的名称理解成可互换:它们可能来自不同规范,对密钥长度、数据格式和会话处理方式也可能有不同要求。
维护时要区分旧式流加密、常见的 AEAD 方案与采用新会话规范的 Shadowsocks 2022。普通密码、符合规定长度的编码密钥、多用户配置中附带的标识信息,并不是可以任选的写法。若导入器显示了地址却没有保留方法名称或完整密钥,优先核对导入能力,而不是随便选一种近似的方法。带附加承载参数的条目也是同理:两端都实现基础 Shadowsocks,并不保证客户端同时支持该附加方式。先用受支持的基础组合建立对照,再决定是否值得保留这些附加依赖。
数据报支持要单独验收
Shadowsocks 可处理基于 UDP 的代理流量,经典 Trojan 也定义了数据报的转发方式,但经典 Trojan 的数据报通过底层流式连接承载。这里有两个独立问题:代理是否能接收这类请求,以及下层怎样传送它们。经有序字节流承载时,遇到丢包,后续数据可能需要等待重传完成;使用数据报承载时,表现又受端点策略和当前网络影响。仅凭浏览器能加载网页,无法确认语音、实时应用或基于数据报的查询会有同样表现。
验证时应从真实业务选择一个可以重复的短场景,记录接入方式、路由命中和业务侧现象。若网页正常但实时应用只在某种本地入口下断续,先看该应用的请求是否进入内核,再区分远端是否接受该类型流量。若应用有自动回落机制,也要留意它可能在测试时切到了另一种传输,导致界面显示可用却没有验证到原定路径。跨协议对照应尽量在同一网络下完成,不宜用一次成功或一次超时替代长期结论。
REALITY:参数含义与握手诊断
为何常与 VLESS 一起出现
REALITY 是 Xray 实现中的一种安全层机制。客户端列表里可能将它作为节点的简写标签,但在结构上,最常见的条目仍是「VLESS 代理协议配合 REALITY 安全层」。在这个组合里,代理协议负责身份和目标请求的表达,安全层负责外部连接的握手与验证。不要把含有 REALITY 的条目改选为普通 TLS,也不要把一个可用的 TLS 入口仅通过切换安全选项当成 REALITY 入口。远端必须按所选机制部署并接受对应参数。
普通 TLS 部署常通过域名证书和信任链确认对端身份。REALITY 的配置还涉及服务端给客户端的验证材料,以及客户端与服务端约定的短标识等参数。对日常选型而言,关键不是记住界面里每个缩写,而是确认这些字段来自同一次交付。同一地址可能承载多个配置,地址未变并不能保证其余字段仍然适配。旧记录和新记录可以并存用于迁移,不应该拼接成一条由不同批次参数组成的连接。
逐项区分地址、名称和验证材料
连接地址和端口决定实际拨到哪里。服务器名称属于握手上下文,应按所给条目填写,而不是根据地址栏自动推导。公钥或客户端界面中与之对应的验证参数,必须与远端使用的材料匹配。服务端私有材料不需要进入客户端;收到字段时,应看清它是客户端侧信息还是服务端侧信息。短标识也应作为字符串保留,避免转换过程中丢失开头的零或改变空值语义。若导入后显示的值与原文不一致,先检查导入器的映射规则。
客户端还可能提供指纹和流控选择。指纹在这里关系到内核生成的握手形态,不等同于浏览器向站点提供的用户名,也不等同于设备认证。流控则属于代理协议与承载组合的一部分。判断这些选项时,以服务交付说明和内核能力两边的交集为准。看到条目有常见外观,不意味着每个字段都能被忽略;同样,某次编辑后恰好成功也不意味着该设置适用于其他入口。
依据握手发生的阶段缩小范围
先分清内核是拒绝启动,还是启动后才不能建立远端连接。前者通常应从不识别的选项、无效参数值或不合规的组合找原因;后者再分底层连接是否成功、安全握手是否完成、代理认证是否通过。若日志只显示连接被关闭而没有进一步说明,不应从一行通用错误推断一定是公钥或短标识有误。可在同一网络使用一个已验证条目作对照,检查故障是否局限于某一配置;若有远端日志,再按时间对应两端记录。
故障发生在订阅更新之后时,保留旧条目并对照更新后的安全类型、名称、验证材料和流控。若旧内核能够运行其他节点,新条目却提示不支持类型,检查当前实例实际调用的是哪个内核,而不是只确认机器里安装过哪个内核。需要发日志请教时,只分享错误阶段和必要的字段类别,遮去凭据、订阅链接以及无需公开的端点。这样保留下来的信息足以让别人判断是导入、解析还是握手问题,又不会把完整节点交给不相关的人。
V2Fly 与 Xray:功能交集和迁移边界
共同历史不等于配置文件通用
Project V 提供了早期用于组合代理、传输和路由模块的框架。V2Fly 延续了 V2Ray 内核的社区维护;Xray 从这一代码体系分出,并在传输、安全和流控方面发展自己的功能。两支内核因此共享一部分概念与协议名称,但实现与发布节奏不同。页首谱系图的连线表示内核家族中存在对应实现,不表示历史版本、传输组合和协议扩展都能相互替代。尤其是 VLESS 条目,只凭协议名无法判断流控与外层安全都受支持。
在配置结构上,两边经常都能见到入站、出站、路由和传输设置,但同名字段的默认行为、有无特定枚举值,以及字段放在哪一层,都要以当前实现为准。版本不同也可能导致解析差异:有的配置直接报未知选项,有的外层工具生成配置时就略过了不认识的字段,界面能保存却得到另一种运行结果。因此,不应仅凭 JSON 能被语法检查读入就宣布迁移完成。还要检查实际生效的内容,以及相同请求是否走向预期的出站。
| 客户端 | 平台 | 核对重点 |
|---|---|---|
| v2rayN | Windows、macOS、Linux | 桌面首选;检查当前条目实际选择并启动的内核。 |
| v2rayNG | Android | 使用 Xray;核对传输、安全与流控是否完整导入。 |
| v2flyNG | Android | 使用 V2Fly;适用于确认与该内核兼容的节点。 |
迁移先重建最小节点,再移植策略
获得条目后,按系统从获取客户端页面选包。迁移时把原配置保留为回退点,不要直接用整份旧配置覆盖新客户端的数据目录。先转入一个两边都实现的基础节点,核对远端地址、用户信息、承载、安全机制,验证单一出站。随后才迁移域名规则、地址规则、默认出站、解析策略与资源文件。遇到专属于某支内核的选项,应先查等效能力;若找不到一致语义,保留原内核比随意删项稳妥。
例如一条域名规则看似相同,却可能因为解析时机不同,在新内核中先匹配到地址规则,也可能因为出站标签改名,转而进入默认线路。迁移不应只检查请求有没有成功,还应读出实际出站,看它是否符合预期。有多条规则共用资源文件时,检查资源文件是否确实存在且已载入;如果文件缺失,不能把遇到的所有错误都归因于节点。对于大配置,用一个可重复的请求逐步加回规则,有助于找出改变行为的那一步。
客户端与内核更新分开记录
更新客户端可能改变订阅解析规则、默认选项和生成配置的方式;更新内核可能改变可用能力或参数校验,即使界面外观完全没变。出现退化时,分别记下这两部分以及平台、接入模式和启动日志中的实际内核信息。用导入前的原条目做对照,可区分是解析回归,还是运行阶段的变化。确认旧组合仍可用且能安全恢复之后,再逐项验证更新后的能力,避免把订阅刷新、客户端升级和内核切换集中到同一次操作里。
连接速度、资源占用与移动端电量
速度至少要拆成三项
第一次访问慢,可能慢在域名查找、远端连接、安全握手或应用开始响应。页面刷新的速度又可能受连接复用与缓存影响。应分别看冷启动首包、稳定吞吐和中断后的恢复表现。一次延迟数字只是某个测量点。普通 Ping 可反映部分网络往返情况,却不会验证代理认证或返回正文;真连接测试即使走完代理路径,也不代表长时间传输稳定。相关测量口径可对照延迟与测速原理。
VMess 的协议内部处理、Trojan 的 TLS 握手、VLESS 采用的外层安全以及 Shadowsocks 的加密封装,各自承担不同工作,无法据此排出跨线路速度榜。额外的往返对高延迟链路的首包更明显;持续传输时,瓶颈又可能落在服务端限速、设备算力、承载方式的重传行为甚至目标站点。比较不同方案,应尽量用同一终端、同一接入网络、条件相近的远端和相同的测试对象。若无法保证远端可比,结论应写成「这条线路更适合当前场景」,不要推广到整个协议。
用明确的本地入口做短测
如果内核已在回环地址开放 SOCKS 入口,可用下列命令验证一次完整的网页请求。示例假定端口是 10808,执行前应在客户端中核对并替换;命令适用于支持此选项的 curl,在 Windows PowerShell 中可调用 curl.exe。使用 socks5h 时,curl 把目标主机名交给 SOCKS 代理解析。示例只发起一次小请求,返回的是从 curl 视角看到的总体耗时,不是某项协议握手的独立耗时。
curl --proxy socks5h://127.0.0.1:10808 --max-time 20 --silent --show-error --output example-response.html --write-out "HTTP %{http_code}\n首字节 %{time_starttransfer}s\n总耗时 %{time_total}s\n" https://example.org/
命令会把响应写入当前目录下的 example-response.html,应在允许创建该文件的目录执行。若显示无法连接本地端口,先检查内核的监听配置,不必改远端条目。若有响应,还要对照客户端日志确认请求命中了待测出站,避免默认分流把它直连。重复执行几次,分别记录冷连接和已有会话下的结果;比较下载吞吐时另选大小相同且来源固定的文件。避免边测速边切换节点,否则一次测试期间可能经过不同路径。
把空闲耗电与工作负载分开
内核的处理器占用受加密实现、设备硬件、并发连接数和包处理路径影响;内存还会受到缓冲区、规则集、连接复用和应用常驻状态的影响。移动端更要区分传输时和待机时的耗电。弱信号使蜂窝链路更容易重传;频繁探测、心跳和后台请求则可能把无线模块留在较高功耗状态。即使两种协议的单位数据处理成本接近,唤醒频率不同,待机表现也可能相差明显。
在手机上比较时,保持同一网络类型、屏幕用法、客户端接入模式和后台应用状态。先观察一段相同长度的锁屏待机,再单独测试前台常用业务,并记录是否频繁发生重连。若关屏后流量停顿,先检查系统的后台权限和网络切换,不要直接把它归因于协议不省电。若耗电只在快速检测或自动切换开启后上升,先降低不必要的探测,再测一次。这样得到的是可复现的设备结论,而不是从协议标签推算出来的电量排名。
订阅格式:导入不等于兼容
订阅地址、响应正文与节点记录
订阅链接是供客户端定期读取的地址,不等同于代理服务的连接地址。客户端拿到的响应正文,可能是多条分享链接,也可能是把这些链接组成的文本再做 Base64 编码,或者是包含规则和分组的结构化文档。单条分享链接通常只描述一个条目。Base64 是编码,不会保护凭据信息;可从订阅正文中还原的授权信息应当与原始链接同等对待。不要把含访问凭据的订阅地址或节点文本发到公开讨论区。
同样是以 HTTPS 开头的地址,可能返回订阅,也可能返回登录提示、过期页面或下载说明。浏览器能打开地址只证明服务器返回了某个页面,未验证正文是否为客户端可读格式。若刷新报告成功但增加的节点数为零,应检查订阅是否到期、服务端返回的格式是否选对,以及响应是否经过登录跳转。部分服务可能按请求条件返回不同内容,浏览器中看到的页面不能完全代表客户端收到的正文。遇到问题优先向服务维护方确认交付格式。
| 交付形式 | 主要用途 | 容易遗漏的内容 |
|---|---|---|
| 单条分享链接 | 新增一个节点 | 不是更新整个分组的入口。 |
| 明文或编码后的链接列表 | 批量导入并刷新条目 | 解出文本不代表每个协议和扩展字段都能识别。 |
| 结构化配置文档 | 描述节点、分组或完整运行策略 | 能提取节点也不代表可移植路由、解析和选择策略。 |
导入验证分四道关
先确认取回响应,再确认解析出了预期的条目,然后核对节点关键字段,最后验证运行中的连接。前两关属于订阅与界面,后两关才涉及内核和远端服务。编辑界面中可以抽查协议、传输、安全层、服务器名称及流控,尤其留意空值是否来自原始条目。涉及带百分号转义的路径、以符号分隔的参数值或非 ASCII 节点名时,不应盲目二次解码。导入后名字正常,也不能当作安全参数已经被原样保留的证据。
桌面端 v2rayN 和 Android 端 v2rayNG 对订阅分组及更新入口的组织不同,可查阅订阅链接导入说明。在同一地址只能在一端使用时,先选取同一条记录做比对,而非导入几份混杂的订阅后凭节点数量判断。两端显示的数量差异,可能来自过滤、去重或某种链接不受支持;即使数量一致,也可能有个别条目缺少扩展字段。比对时只在自己的设备内查看完整凭据,问题记录以字段名和现象为主。
转换前确定需要保留什么
订阅转换通常是在两种数据表达之间做映射,并不能为目标内核补上一项没有实现的协议能力。若目标格式只描述节点,源配置中的策略组、解析规则和本地接入设置就需要另行整理。动手前先问清哪些字段必须保留,优先索取客户端原生支持的交付格式。若一定要转换,也宜先对少量具有代表性的记录做本地核对,确认转换后能够独立连接,再决定是否批量应用。避免把访问地址交给来源不明的在线处理服务。
如果更新会覆盖订阅分组中的手工修改,可复制一条记录到独立分组作为对照,并在测试完毕后清楚标注来源。遇到新旧记录同名时,比对端点和完整连接组合;显示名称可能只是给人看的标签,不足以作为长期标识。批量更新后先试一条基础节点和一条含扩展设置的节点,分别确认普通字段与特殊字段是否保留;不要在同一轮排错里同时改转换规则和本地路由。
按使用场景选协议与验收配置
现成服务:以完整匹配为先
使用现成服务时,先列出服务实际交付的连接组合,再选平台上的客户端。桌面端首选 v2rayN;Android 设备有 Xray 专属的安全层或流控需求时,优先核对 v2rayNG 的支持情况;已明确适配 V2Fly 的条目,再考虑 v2flyNG。若同时收到多种条目,不必挑字段最多的一种。把协议、承载、安全及数据报需求都匹配的组合列为候选,在目标设备上验收。只有一个可用组合时,选择已由维护方验证的完整配置比追求理论性能更有意义。
例如已有一组稳定的 VMess 节点,而新订阅增加了 VLESS,并不意味着需要把旧组全部迁移。先查看新增组合是否解决了实际需求,例如某个目标设备的兼容问题,或服务维护方已经确定的升级计划。若差异只是名称更新,原有节点也仍有维护,保留可用的已知方案可以减少迁移面。反过来,服务端停止维护某种历史配置时,应使用新发放的条目重新验收,而不是在旧记录上沿用已经不适用的字段。
自行维护:把日常管理成本计入选择
自行维护时,先列清必须覆盖的终端和内核,再考虑服务侧能长期维护什么。已有稳定证书续期和域名管理流程,可以评估采用 TLS 的 Trojan 或兼容的 VLESS 组合;希望维持较少的配置依赖,可评估双方都支持的 Shadowsocks 方法,并验证数据报需求。需要 REALITY 或特定流控时,要有相应的 Xray 环境和可复现的配置分发方式。每种方案都有自己的维护工作,不能把某一项配置更少等同于整套系统更省心。
混用桌面与移动设备时,建议保留一条双方均能验证的基线组合,用于判断是远端服务整体异常,还是某类扩展只在个别终端失效。若同一套部署面向不同用途,可分别保留少量明确验证的条目,不必让每个节点同时承担所有角色。对网页和文档使用者,优先评估首次访问、恢复与解析一致性;对连续传输场景,增加持续吞吐和断开重建测试。涉及实时应用时,把数据报接入和网络切换后的恢复列入实际评估,而不是只看测速结果。
验收记录应能交给另一台设备复核
记录平台、客户端、实际内核、节点的连接组合、应用进入代理的方式,以及测试所用的网络和时间段。第一轮在简单路由下证明连接能建立,第二轮再加回日常规则和后台设置,检查应用是否走对线路。必要时加上锁屏后恢复、无线网络间切换、订阅刷新等测试。此处的通过标准应是可观察现象:例如刷新后关键字段保持不变,恢复网络后能完成一次新请求,而不是抽象的「连接正常」。把测试条件一并留下,才方便日后与新配置对照。
失败时,用分类代替猜测:完全没有相应日志就回到应用接入;日志出现拨号错误就先查端点;安全握手失败再对照验证相关字段;连接建立后只有部分应用异常,则查看分流、解析或数据报路径。需要操作指引可以返回快速上手,常见系统代理、安装和权限问题可查疑难解答。若问题只在某次更新后出现,优先复测保留的基线,再比较单项变化。这样得到的选型结论既能用于当下,也能在换设备或内核更新后重新验证。