2026-05-31 · Xray / VLESS / Shell / VPS

Xray VLESS Manager:把常用 VLESS 组合做成一个菜单脚本

Xray VLESS Manager 是一个轻量的 Xray-core / VLESS 一键管理脚本,支持 REALITY、Vision、WebSocket、gRPC、XHTTP 等常用组合,并在重启前校验配置。

Xray / VLESS 的组合很多,参数也不少:TCP、REALITY、Vision、WebSocket、gRPC、XHTTP、Encryption……每种组合都能用,但手写配置很容易漏字段。

我做 Xray VLESS Manager 的目的很简单:把常见组合整理成一个菜单脚本,安装时按提示选模式、填端口,脚本自动生成服务端配置和客户端链接。

项目地址:https://github.com/shuijiao1/Xray-VLESS-Manager

支持哪些组合

目前脚本支持这些常见模式:

  • VLESS TCP;
  • VLESS + XTLS Vision + REALITY;
  • VLESS TCP + REALITY;
  • VLESS + WebSocket + TLS;
  • VLESS + gRPC + REALITY;
  • VLESS + XHTTP + REALITY;
  • VLESS Encryption TCP。

其中默认更推荐 VLESS + XTLS Vision + REALITY,适合大多数想快速搭一个 VLESS 节点的 VPS。

安装方式

一键运行:

bash <(curl -Ls https://xray.shuijiao.de)

脚本会进入菜单:

============================================
 Xray VLESS Manager
 Repo: Xray-VLESS-Manager
 Author: shuijiao
============================================
安装状态: 已安装 / 未安装
运行状态: 运行中 / 未运行

=== 基础功能 ===
 1) 安装/更新 Xray-core
 2) 安装 VLESS TCP 明文
 3) 安装 VLESS + XTLS Vision + REALITY(推荐)
 4) 安装 VLESS TCP + REALITY
 5) 安装 VLESS + WebSocket + TLS
 6) 安装 VLESS + gRPC + REALITY
 7) 安装 VLESS + XHTTP + REALITY
 8) 安装 VLESS Encryption TCP

=== 服务管理 ===
 9) 查看客户端配置
10) 重启 Xray
11) 查看日志

=== 系统功能 ===
12) 卸载 Xray
 0) 退出

安装时会做什么

选择一个模式后,脚本会自动完成:

  1. 检查系统和依赖;
  2. 安装或复用 Xray-core;
  3. 生成 UUID、REALITY X25519 key、shortId、path、serviceName 等参数;
  4. 写入 /usr/local/etc/xray/config.json
  5. 生成 /usr/local/etc/xray/client.txt 和客户端 JSON;
  6. 执行 xray test -config /usr/local/etc/xray/config.json
  7. 校验通过后再重启 xray.service

我比较在意第 6 步:配置写完后不应该直接重启。先测试配置,确认 JSON 和 Xray 参数没问题,再切服务,会安全很多。

服务路径和文件

脚本使用 Xray 官方常见结构:

服务名:xray.service
配置:/usr/local/etc/xray/config.json
客户端摘要:/usr/local/etc/xray/client.txt
客户端 JSON:/usr/local/etc/xray/client.json

这样后续排查也比较直观:

systemctl status xray
journalctl -u xray -e --no-pager
cat /usr/local/etc/xray/client.txt

为什么要做成脚本

当然也可以直接复制 Xray examples,然后手动改配置。

但实际部署时经常会遇到这些小问题:

  • REALITY key、shortId、UUID 要生成;
  • gRPC serviceName / XHTTP path 不想手写;
  • 配置文件少一个逗号就启动失败;
  • 客户端链接容易拼错;
  • 换模式时旧配置和服务路径容易混乱。

脚本不追求做成复杂面板,只是把这些重复步骤固定下来:选模式 → 填参数 → 自动生成 → 校验 → 输出客户端配置

注意事项

几个需要注意的点:

  • REALITY 的目标站建议选择支持 TLS 1.3 / H2、非跳转主站的海外站点;
  • VLESS TCP 明文没有传输层加密,不推荐公网裸跑;
  • WebSocket + TLS 初版使用自签证书,生产环境更推荐 Caddy / Nginx / ACME 前置;
  • 脚本会覆盖 /usr/local/etc/xray/config.json,已有复杂配置请先备份。

这个项目适合想快速生成常见 VLESS 配置的人,不适合拿来管理一堆复杂分流规则。它的定位就是:轻量、菜单式、少填参数,能跑起来并输出可用客户端配置。