v2rayN 配置 VLESS：订阅导入、Reality 参数与无法连接排查
简答：v2rayN 配置 VLESS，优先粘贴 vless://链接或更新订阅；没有完整链接时再手动填写。导入后设置活动节点、重启服务并开启系统代理，连接失败先查核心日志和关键参数。
定义：v2rayN 是用于管理节点、调用 Xray 或 sing-box 核心并提供本地代理入口的客户端，VLESS 则是由核心处理的代理协议。
先照做：导入 VLESS 后完成 3 步验证
有完整的 vless:// 分享链接时，先在 v2rayN 主界面非输入框区域按 Ctrl+V；有订阅地址时，进入“订阅分组”相关设置新增地址并更新。导入完成后，再按下面顺序验证：
- 在节点列表中选中目标 VLESS 节点，设置为活动服务器。v2rayN 会根据活动配置生成核心配置并启动服务，不需要寻找单独的“启动核心”按钮。
- 查看底部状态和主界面信息栏，确认核心没有启动失败、配置解析错误或本地端口占用；修改设置后使用“重启服务”重新加载。
- 在底部“系统代理”下拉选项中选择“自动配置系统代理”，再用浏览器测试；如果浏览器能用但其他应用不能用，继续检查路由模式或 TUN，而不要只看节点列表状态。
本文是第三方使用指南站，不提供节点资源。v2rayN 官方 Wiki 说明，订阅可以包含 VLESS 等协议，标准协议格式和 v2rayN 内部格式都可能出现在订阅内容中，可参考 v2rayN 订阅功能说明。
v2rayN、VLESS、Xray 与 sing-box 的关系
v2rayN 是桌面客户端和管理界面，不是服务器，也不是 VLESS 协议本身。VLESS 节点需要由兼容的核心处理，v2rayN 当前代码中分别列出了 Xray 和 sing-box 核心，并将 VLESS 列入两者支持的配置类型。Android 设备对应的是 v2rayNG，不能把 v2rayN 的桌面菜单直接套用到手机端；iOS 不使用 v2rayN 桌面界面，具体客户端应以对应项目说明为准。
| 对象 | 负责什么 | 配置时先看什么 |
|---|---|---|
| v2rayN | 节点列表、订阅更新、核心选择、系统代理和日志 | 活动服务器、核心类型、本地监听端口 |
| VLESS | 客户端与服务端之间的协议 | UUID、加密字段、Flow 和传输组合 |
| Xray | v2rayN 可调用的核心之一 | VLESS、TLS、Reality、TCP、WS、gRPC 等组合 |
| sing-box | v2rayN 可调用的另一核心 | 确认该节点和当前字段能被所选核心支持 |
如果同一节点在 Xray 与 sing-box 下表现不同，先确认核心日志和生成的配置是否都成功，不要仅凭“节点已连接”判断应用流量已经经过代理。v2rayN 的核心类型与协议支持可在其项目代码中核对：v2rayN 核心与协议配置定义。
三种导入方式：订阅、分享链接和二维码
方法一：通过订阅地址导入
- 准备服务端提供的订阅 URL，通常是可访问的
http://或https://地址。 - 打开 v2rayN，进入“订阅分组”设置，新增订阅分组并填写订阅地址。
- 保存后执行更新订阅，等待节点列表出现。
- 选中需要使用的 VLESS 节点，设置为活动服务器，再按“重启服务”让配置生效。
订阅适合节点较多或需要定期更新的情况。更新失败时，先检查 URL 是否完整、是否需要登录或访问权限，再查看 v2rayN 的界面日志。
方法二：粘贴 vless:// 分享链接
标准 VLESS 分享链接的格式来源于 XTLS 社区的分享链接提案，v2rayN Wiki 也收录了可识别的 VLESS 订阅格式，但不应把该格式归为 v2rayN 首创。提案中定义了地址、端口、UUID 以及 security、sni、fp、pbk、sid、type 等参数，可参考 VMessAEAD / VLESS 分享链接标准提案。
示例结构如下，尖括号内容必须替换为服务端提供的真实值：
vless://<UUID>@<地址>:<端口>?encryption=none&security=reality&sni=<ServerName>&fp=chrome&pbk=<PublicKey>&sid=<ShortID>&type=tcp#<备注>
- 复制完整链接，保留开头的
vless://、问号后的参数和最后的备注。 - 回到 v2rayN 主界面，在非输入框区域按
Ctrl+V。 - 打开节点编辑页面，核对地址、端口、UUID、传输方式和 TLS/Reality 参数。
方法三：二维码导入
使用 v2rayN 的二维码导入入口扫描服务端生成的二维码。二维码通常承载分享链接或客户端可识别的配置数据，扫描成功不代表参数一定适合当前核心；导入后仍需检查活动节点、核心类型和日志。
vless:// 参数对应 v2rayN 哪些字段？
这是手动核对 VLESS 配置时最容易出错的部分。参数名称来自分享链接标准，v2rayN 界面中的显示名称可能随版本或核心略有差异，遇到空字段时应以服务端提供的完整链接为准。
| 分享链接参数 | v2rayN 界面常见对应项 | 填写要点 |
|---|---|---|
| 地址与端口 | Address、Port | Address 是实际连接地址；SNI 不一定等于 Address。 |
| 用户信息 | UUID / ID | 完整复制 UUID，不能混用其他节点的 ID。 |
| encryption | Encryption | 关闭 VLESS 加密层时通常为 none；如果服务端启用了 VLESS Encryption，必须照完整字符串填写，不能擅自改成 none。 |
| flow | Flow | 例如 xtls-rprx-vision，仅在服务端要求时填写。 |
| security | 传输层安全方式 | 常见为 none、tls 或 reality，不要填入 Encryption。 |
| sni | Server Name / SNI | 对应核心配置中的服务名，需与服务端允许值一致。 |
| fp | Fingerprint | Reality 通常需要该字段，值以分享链接或服务端资料为准。 |
| pbk | Public Key | Reality 客户端公钥，不是服务端私钥。 |
| sid | Short ID | 服务端允许的十六进制短 ID，不能自行编造。 |
| type | 传输协议 / Network | tcp 通常对应 RAW/TCP，ws 对应 WebSocket，grpc 对应 gRPC。 |
| path、host | WebSocket Path、Host | 仅在 WebSocket 组合中重点检查，必须与服务端一致。 |
| serviceName | gRPC ServiceName | 仅在 gRPC 组合中填写，不要把 WebSocket Path 当成 ServiceName。 |
其中 pbk、sid、fp、sni 和 type 与 Xray 配置字段的对应关系，可结合 VLESS 分享链接标准提案 和 Xray VLESS 出站配置文档核对。
手动添加 VLESS：按界面逐项填写
- 打开 v2rayN，进入“服务器”菜单，选择“添加 VLESS 服务器”。
- 在 Address、Port、UUID / ID 中填写服务端提供的连接地址、端口和 UUID。
- 根据服务端资料选择传输方式：TCP/RAW、WebSocket 或 gRPC。
- 选择对应的安全方式。如果是 TLS，填写 SNI/Server Name；如果是 Reality，再核对 Fingerprint、Public Key、Short ID 和 Flow。
- WebSocket 节点检查 Path、Host；gRPC 节点检查 ServiceName。没有提供的字段不要凭经验补写。
- 保存后选中该节点并设为活动服务器，再使用“重启服务”。
| 组合 | 重点字段 | 不能混淆的地方 |
|---|---|---|
| VLESS + TCP + TLS | UUID、TLS、SNI、Fingerprint、Flow | TLS 是安全方式，不是 Encryption 值。 |
| VLESS + TCP + Reality | SNI、Fingerprint、Public Key、Short ID、Flow | Public Key 不能替换成私钥，Short ID 必须来自服务端。 |
| VLESS + WebSocket + TLS | SNI、Path、Host、UUID | Path 和 Host 不能照搬 gRPC 字段。 |
| VLESS + gRPC + TLS | SNI、ServiceName、UUID | ServiceName 必须与服务端一致。 |
Reality、TLS 与传输协议属于不同配置层级，填写时不要因为都出现在同一个分享链接里就互相替换。具体字段可参考 Xray REALITY 配置、Xray WebSocket 配置 和 Xray gRPC 配置。
看到什么报错，先查哪里？
快速判断：TLS handshake 失败先查 SNI、Fingerprint 和证书相关字段；Reality 验证失败先查 Public Key、Short ID、Server Name 和 Flow；timeout 先查地址、端口、DNS 与网络可达性；核心启动失败先查配置格式、核心类型和本地端口占用。
| 现象或日志方向 | 优先检查 | 下一步 |
|---|---|---|
| 核心启动失败 | 核心类型、配置解析、端口占用 | 查看主界面核心日志，修改后使用“重启服务”。 |
| TLS handshake 失败 | SNI、Fingerprint、TLS 类型 | 对照完整分享链接，不要把 Address 直接当成 SNI。 |
| Reality 验证失败 | Public Key、Short ID、Server Name、Flow | 让服务端重新提供完整节点参数，不要自行生成。 |
| 连接 timeout | Address、Port、DNS、IPv4/IPv6 | 先确认域名解析和端口可达，再判断协议参数。 |
| 节点已连接但浏览器打不开 | 活动服务器、系统代理、路由和本地端口 | 检查日志中的入站与出站记录，并对比代理前后的出口 IP。 |
- 确认目标节点已经设置为活动服务器。
- 查看主界面核心日志；v2rayN FAQ 区分了界面日志和核心日志，核心问题应优先看信息栏中的核心输出，可参考 v2rayN 常见问题。
- 确认 v2rayN 本地混合端口。当前默认配置代码中的本地 SOCKS 入站端口为
10808；部分旧版本或自定义配置可能不同，必须以“设置→参数设置→核心基础设置”中的实际端口为准，可参考 v2rayN 默认入站配置。 - 在底部“系统代理”中选择“自动配置系统代理”。v2rayN Wiki 说明，系统代理会把部分应用流量转发到核心入口，而路由功能再决定流量走代理还是直连。
- 临时排除其他代理软件、VPN、TUN 或安全软件的拦截，避免多个程序同时占用端口或修改路由。
路由、DNS 与 Geo 文件：为什么只有部分网站打不开？
“节点已连接”只说明核心或节点建立了某种连接，不代表所有域名都会走同一条路径。v2rayN 的系统代理和路由是两层设置：系统代理决定部分应用是否把请求交给本地核心，路由规则决定请求最终直连、代理或拒绝。官方 Wiki 将“自动配置系统代理”和“绕过大陆”等列为常见组合，具体名称可能因版本和语言略有差异，可参考 v2rayN 系统代理和路由说明。
- 如果目标是让大多数流量经过节点，暂时选择全局类路由模式测试；测试完成后再恢复按规则分流。
- 如果只是不通少数域名，检查当前路由规则是否把域名误判为直连、拒绝或错误策略。
- 如果域名解析失败，检查 DNS 设置、系统 DNS、hosts 文件以及 IPv4/IPv6 解析结果。
- 如果 GeoSite 或 GeoIP 文件过旧，规则可能把域名或 IP 分类错误；在 v2rayN 的相关设置中更新 Geo 文件后重启服务。
- 在全球不同地区，DNS 返回结果、IPv6 可用性和网络路径可能不同。应分别比较直连与代理解析结果，不要只凭某一个网站是否打开判断节点配置正确。
如果使用 TUN，浏览器和其他应用的流量接管范围可能扩大，但还会受到系统权限、核心支持和路由规则影响。先用系统代理完成基础验证，再按需启用 TUN，并结合日志和出口 IP 判断是否真正生效。
常见问题
v2rayN 导入 VLESS 后为什么还要设置活动服务器？
导入只是把配置保存到节点列表，不一定代表当前核心正在使用它。导入后选中目标节点并设置为活动服务器，再使用“重启服务”加载配置。
v2rayN 的本地代理端口是 7890 或 7897 吗？
不要按 Clash 系客户端的端口判断。v2rayN 当前默认配置代码中的本地 SOCKS 入站端口为 10808，旧版或自定义配置可能不同，最终以参数设置页显示的实际端口为准。
VLESS 的 encryption 一定要填 none 吗？
不一定。关闭 VLESS 加密层时通常填写 none；如果服务端提供了 VLESS Encryption 字符串，应完整照填，不能因为不是 none 就自行改掉。
Reality 的 Public Key、Short ID 和 SNI 从哪里获取？
这三个值应来自服务端参数或完整分享链接。Public Key 不是服务器私钥，Short ID 必须是服务端允许的十六进制值，SNI 也不一定等于 Address。
VLESS + WebSocket 和 VLESS + gRPC 可以互换吗？
不能直接互换。WebSocket 重点检查 Path 和 Host，gRPC 重点检查 ServiceName；客户端与服务端的传输方式必须一致，安全方式也要匹配。
节点显示已连接，但浏览器仍然打不开怎么办？
先确认活动服务器和核心日志，再检查底部系统代理是否选择“自动配置系统代理”、浏览器是否读取系统代理、本地端口是否一致，最后对比代理前后的出口 IP。
为什么浏览器能用，但其他应用仍然直连？
系统代理通常只影响会读取系统代理设置的应用。命令行、游戏、虚拟机等程序可能需要单独配置代理，或在确认核心和权限后使用 TUN 与路由规则接管。