VLESS Reality 一键搭建教程:3X-UI 与 Xray
VLESS Reality 自己动手部署:先分清第三方 3X-UI 面板和官方 Xray 核心,再依次走安装、核对握手目标、对字段、开端口、查客户端和逐层排查。
- 发布
- 更新
- 验证
- 门槛
- 高级
- 类别
- VPS 自建
最后更新于:2026-11-16
眼下的首选做法;还是要定期去看官方是否在维护、兼容性有没有变。
原名 / 别名:Reality
眼下的首选做法;还是要定期去看官方是否在维护、兼容性有没有变。
多数 Reality 部署用不着自备域名和证书,可 Xray 版本、握手目标、密钥、传输搭配、客户端支持和端口能否连通,哪一项不对都跑不起来。先定下用官方核心还是第三方面板,然后沿同一套检查顺序去核对。
- 官方核心自己直接改 Xray 配置,对外暴露的东西少,不过得看得懂 JSON 和 systemd。
- 第三方面板3X-UI 能在网页上点着管理,代价是多了一个一直开着的 Web 后台和 root 权限风险。
- 结果可验证握手目标、配置检查、服务日志、监听端口、客户端字段全部对上了,再去谈线路好坏。
准备工作
- 一台商家仍在维护的 Linux VPS,拿得到 root 或 sudo 权限
- 一个没被别的程序占着的 TCP 端口
- 版本够新、支持 Reality 的客户端和内核
- VPS 快照或配置备份;跑远程脚本、改配置,都可能波及 SSH 以外的服务
挑 VPS 时看预算、计费方式、能否退款、有没有快照、换 IP 规则,再在自己常用时段试一下线路,别光凭地区或价格判断好不好用。下面沿用好飞机场指南原有的推广短链,价格与条款请以商家页面为准:
连上 VPS 后先把系统更新一遍,并确认手边另开着一个能用的 SSH 窗口:
apt update && apt upgrade -y
apt install -y curl sudo路线一:3X-UI 第三方面板
3X-UI 属于第三方做的 Xray 网页面板,不是 XTLS / Xray 官方出品。它的 README 写明定位是个人使用,不建议放进生产环境。安装脚本要高权限,还会装一个常驻的管理服务;能接受这些前提再用它。
curl -fsSL https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh -o /tmp/3x-ui-install.sh
less /tmp/3x-ui-install.sh
bash /tmp/3x-ui-install.sh要长期跑或用于正式环境,先到仓库 Releases 挑一个核对过的版本,把对应 tag 传给脚本,别无脑跟着 master。装好以后:
- 运行
x-ui找到脚本随机生成的用户名、密码和访问路径。 - 别让面板端口一直对全网开放;尽量走 SSH 隧道,或只放行指定来源 IP。
- 新建一个 VLESS 入站,选 Reality,让面板自动生成密钥和分享信息。传输方式只挑 Reality 目前支持的搭配,别配成 WebSocket + Reality。
- 需记录这些信息:实际监听端口、UUID、flow,以及握手目标、Public Key、Short ID 和 SNI。
- 导进客户端先试一下能不能连上,然后再加别的用户或入站。
路线二:官方 Xray 核心
安装与生成凭证
用 XTLS 自己维护的 Xray-install,先下载下来看一遍再执行:
curl -fsSL https://raw.githubusercontent.com/XTLS/Xray-install/main/install-release.sh -o /tmp/xray-install.sh
less /tmp/xray-install.sh
bash /tmp/xray-install.sh install
xray version生成 UUID 和一对 Reality 密钥:
xray uuid
xray x25519Private Key 只留在服务端,Public Key 交给客户端。真实密钥别贴进公开的 Issue、聊天群或版本库。
从官方示例创建配置
Reality 的字段会跟着 Xray 更新而变。请拿最新的 RealityObject、传输兼容表 和 Xray 官方示例仓库 当底稿,别从老博客里整段抄 JSON。
按眼下官方的兼容表,Reality 只能搭配 RAW、XHTTP、gRPC 这几种。WebSocket、HTTPUpgrade、mKCP 都不能当 Reality 的传输方式。
配置 /usr/local/etc/xray/config.json 时一项一项对:
| 项目 | 服务端 | 客户端 |
|---|---|---|
| 用户凭证 | VLESS UUID;用 Vision 的话,flow 要设成对应的值 | 同一个 UUID 和 flow |
| Reality 密钥 | privateKey | 配对的公钥;现行文档里的字段名是 password,旧名 publicKey |
| Short ID | shortIds 列表 | 从中挑一个;长度须为偶数,最长 16 位十六进制 |
| 握手目标 | target(旧名 dest) | 客户端这里留空 target / dest |
| SNI | serverNames,不支持 * | serverName 只能是列表里的某一个 |
| 传输 | RAW、XHTTP 或 gRPC | 方式和服务端一模一样 |
shortIds 里可以放一个空字符串,意思是客户端可以不填 Short ID;只有服务端允许空值,客户端才能空着。位数是奇数的值会被新版内核直接拒掉。
握手目标怎么核
握手目标得保证 VPS 自己就能连上,光你的电脑打得开不算数。换目标之前先在服务器上查一下:
curl -I --max-time 10 https://你的握手目标域名
xray tls ping 你的握手目标域名xray tls ping 能看到目标对 TLS、SNI 和证书怎么回应。没通过认证的流量会被转给这个目标;如果目标在 CDN 后面,你的 VPS 可能沦为别人扫出来的加速节点。别照搬博客里写死的域名。
ML-DSA、fallback 限速、XHTTP / gRPC 都属于进阶玩法。先把 RAW + Reality 跑起来,之后每次只改一处做对比。
先检查配置,没问题再重启服务:
xray run -test -config /usr/local/etc/xray/config.json
systemctl restart xray
systemctl status xray --no-pager
journalctl -u xray -n 50 --no-pager检查没过就别重启。照着报错说的字段去改,一直改到 -test 通过为止。
端口与防火墙
Reality 并不非得用 443。挑一个空着的 TCP 端口,然后在 Xray、本机防火墙、云厂商安全组和客户端这四个地方填成同一个。
ss -lntp
ufw status verbose
ufw allow 你的端口/tcp
ufw reload代理端口只对需要的来源开放。面板端口和 SSH 端口要卡得更严;改 SSH 设置前别关掉现有窗口,先确认新窗口能登上,免得把自己挡在门外。
客户端核对
分享链接导进去以后,别看到「导入成功」就完事。在 v2rayN、v2rayNG、Shadowrocket、Stash 或能用 Reality 的 mihomo / sing-box 客户端里逐项看:
- 地址与端口
- UUID 与
xtls-rprx-visionflow(服务端开了才需要) - Reality 公钥(界面上可能叫 Public Key 或 password)、Short ID 和 SNI / server name
- 传输方式得是 Reality 支持的搭配,还要和服务端内核版本对得上
先打开一个普通的 HTTPS 网站,再去翻 Xray 的服务日志。服务端一条日志都没有,先查端口和网络;日志里有认证或 Reality 相关报错,先回头对字段。
分层排障
- A服务未启动
配置检查、systemd 状态或本机监听有一项不过,先把服务端修好。
- B端口不可达
服务端在监听,但从外面连 TCP 不通,就查主机防火墙、云安全组和中间网络。
- C握手或认证失败
外面能连上端口、日志也有请求,那就去对 UUID、flow、密钥、Short ID、SNI 和传输。
常用命令:
xray run -test -config /usr/local/etc/xray/config.json
systemctl status xray --no-pager
ss -lntp
journalctl -u xray -n 100 --no-pagerConnection refused、timeout 和 No route to host 单凭哪一个都不能断定「IP 被墙」。得把监听、防火墙、商家状态、多家宽带、多处外部探测放在一起看,具体见 VPS IP 被墙排障。
性能与安全
- 先把空闲时和高负载时的延迟、丢包、吞吐以及真实使用情况记下来,再考虑要不要动内核参数。
- BBR、文件描述符、sysctl 这类模板别一股脑往上加;每台机器的默认值、内核版本和瓶颈都不一样。
- 每个用户发一个单独的 UUID,哪个泄露了就只作废哪个。
- 系统、Xray、3X-UI 要按时更新;更新前先备份,读一遍 release notes。
- 登录用 SSH 密钥,管理入口要收紧,留好救援控制台或商家提供的 console。