3X-UI 配置 VLESS + REALITY:密钥、SNI 与客户端导入
本文目录
本文用 3X-UI 的图形界面梳理 VLESS + REALITY 入站参数,并说明服务器端与客户端字段如何对应。参数名称可能随面板和核心版本变化,开始前请核对 3X-UI 官方 REALITY 文档 和当前 官方发布说明。
仅在你有权限管理的服务器和网络环境中配置服务。不要复用示例密钥,也不要把私钥、UUID 或完整分享链接公开。
视频演示
视频中从 11:03 左右开始介绍 3X-UI 的 VLESS + REALITY 配置。面板版本可能不同,建议将视频作为界面参考,再对照官方文档确认每个字段。
也可以直接在 YouTube 观看。该视频发布于 2024 年,部分菜单、核心版本和默认值可能已经变化;涉及协议参数时以当前官方文档为准。
配置前确认
- 3X-UI 和 Xray-core 已更新到兼容版本,服务器时间准确。
- 准备一个由你管理的 VPS,确认目标端口可用,并按需设置云安全组和系统防火墙。
- 入站目标(
dest)应是真实、可访问且支持所需 TLS 能力的主机;SNI必须与目标站点证书中的主机名匹配。不要仅照抄其他教程里的目标域名。 - 私钥只保存在服务器端。分享给客户端的配置只应包含公钥和连接所需参数。
在 3X-UI 添加 VLESS 入站
- 打开 入站 / Inbounds,选择 添加 / Add。
- 协议选择 VLESS,填写备注和一个未被占用的监听端口。
- 传输方式按兼容客户端和当前官方建议选择。REALITY 常用 TCP(Raw)传输;不要把 WebSocket、gRPC 等组合与不匹配的客户端参数混用。
- 安全层选择 REALITY。
- 填写目标地址和 SNI;目标通常需要写成
主机名:端口,SNI 只填写主机名。两者必须匹配目标证书及服务器实际可达情况。 - 通过面板生成 X25519 密钥对和 short ID。私钥留在服务器,客户端配置使用公钥。short ID 应为有效十六进制值,且服务器与客户端要使用同一个值。
- 按官方建议设置客户端指纹与流控。常见组合是
chrome指纹和xtls-rprx-vision;客户端支持情况需要结合其当前核心版本确认。 - 添加客户端用户并保存入站。然后在面板中复制该客户端专属分享链接或二维码。
每个客户端使用独立的凭据,便于单独停用和排查。不要将同一分享链接长期发给不需要访问的设备或人员。
把分享链接导入客户端
在兼容 Xray 的客户端中导入面板生成的 vless:// 链接或扫描二维码。导入后先检查服务器地址、端口、SNI、REALITY 公钥、short ID、指纹和 flow 是否都有值。若客户端不支持当前参数,不要删掉校验选项强行连接;优先升级客户端/核心或选择双方都支持的配置。
导入成功后进行一次连接测试,再查看客户端日志。分享链接含有用户凭据,应像密码一样保管。截图、演示或求助时先遮挡 UUID、域名、IP、二维码和订阅链接。
握手失败的排查顺序
目标地址或 SNI 不匹配
确认服务器可以访问目标站点,端口开放,并且 SNI 是该目标证书的有效主机名。配置错误时,客户端可能表现为超时、TLS 握手失败或立即断开。
公钥、私钥或 short ID 对不上
如果重新生成密钥,应同步更新客户端分享配置。不要只复制部分参数或沿用旧二维码;服务器端私钥与客户端公钥必须属于同一密钥对,short ID 也要一致。
flow 与核心版本不兼容
确认服务器端入站和客户端都使用兼容的 Xray-core,并且 Vision flow 配置一致。核心升级后若旧客户端无法握手,先检查双方日志和官方版本说明,不要同时改动多项字段。
端口被占用或未放行
在服务器上检查该端口是否由预期服务监听,同时核对云安全组和本机防火墙。改端口后,客户端链接也需要更新。
系统时间或内核版本异常
检查服务器与客户端系统时间,并确认软件版本没有停留在不兼容的旧版本。出现特定握手错误时,将完整错误文本(去掉 IP、UUID、私钥等敏感信息)与官方故障排查文档比对。
配置完成后的维护
- 记录当前 3X-UI 和 Xray-core 版本;升级前先备份数据库和配置。
- 定期检查官方 release notes 与安全公告。
- 给不同设备或用户创建独立客户端,失去访问权限时单独禁用对应凭据。
- 备份文件加密保存,并确认能在恢复环境中读取;不要把私钥和数据库提交到公开仓库。
参考资料
3X-UI 的其他教程
软件页 →- 文章标题
- 3X-UI 配置 VLESS + REALITY:密钥、SNI 与客户端导入
- 本文链接
- https://www.gowall.net/software/3x-ui/vless-reality-3x-ui/
- 版权说明
- 版权所有,保留所有权利。