中文 | English

Xray 管理脚本 ✨

• 一个纯 Shell 编写的 Xray 管理脚本
• 可选配置:
  • mKCP (VLESS-mKCP-seed)
  • Vision (VLESS-Vision-REALITY)
  • XHTTP (VLESS-XHTTP-REALITY)
  • trojan (Trojan-XHTTP-REALITY)
  • Fallback (包含 VLESS-Vision-REALITY、VLESS-XHTTP-REALITY)
  • SNI (包含 Vision_REALITY、XHTTP_REALITY、XHTTP_TLS)
• SNI 配置由 Nginx 实现 SNI 分流，适合过 CDN、上下行分离、多网站共存等需求
• SNI 分享链接实现了上下行分离(上行 xhttp+TLS+CDN | 下行 xhttp+Reality、上行 xhttp+Reality | 下行 xhttp+TLS+CDN)
• SNI 配置支持管理自定义域名与反代应用，每个站点拥有独立证书、独立站点配置、独立 stream 映射与 UDS
• 规则配置与自填:
  • 禁止 bittorrent 流量(可选)
  • 禁止回国 ip 流量(可选)
  • 屏蔽广告(可选)
  • 添加自定义 WARP Proxy 分流
  • 添加自定义屏蔽分流
• 开关 Cloudflare WARP Proxy( 🐳 Docker 部署)
• 开关 geodata 自动更新功能
• xray 端口默认与自填:
  • VLESS-mKCP: 随机生成
  • ALL-REALITY: 443
• UUID 默认与自填:
  • 随机生成
  • 自定义输入标准 UUID
  • 非标准 UUID 映射转化为 UUID
• kcp(seed) 和 trojan(password) 默认与自填:
  • 随机生成(格式: cw-GEMDYgwIV3_g#)
  • 自定义输入
• target 默认与自填:
  • 随机在 serverNames.json 中获取
  • 实现自填 target 的 TLSv1.3 与 H2 验证
  • 实现自填 target 的 serverNames 自动获取
• shortId 默认与自填:
  • 随机生成(默认两个 shortId 例如: 01234567, 0123456789abcdef)
  • 实现自填 shortId
  • 实现输入值为 0 到 8, 则自动生成对 0-16 长度的 shortId
  • 支持逗号分隔的多个值
• path 默认与自填:
  • 随机生成(格式: /8ugSUeNJ.9OEnTErb.dVZMUAFu)
  • 自定义输入(格式: /8ugSUeNJ, 加不加 / 都可以)

问题

1. 如果安装成功，但无法使用，请检查服务器是否开启对应端口，可通过 https://tcp.ping.pe/ip:port 验证服务器端口是否开放。
2. 使用 SNI 配置前，请确保 VPS 的 HTTP(80) 与 HTTPS(443) 端口开放。
3. 使用 SNI 配置前，请不要开启 CDN 保护，不然无法正常申请 SSL 证书。
4. 上下行分离详情请看 XHTTP: Beyond REALITY 与 xhttp 五合一配置 了解。
5. 使用 SNI 获取证书时遇到 【Could not get nonce, let's try again】 请查看 ZeroSSL 状态页，大概率是 ZeroSSL 的【Free ACME Service】处于 【Service disruption】或【Service outage】状态。

更新日志

1. v2025.11.19 版本解决【开启 WARP 时没有设置日志限制，导致容器日志会一直叠加，最终占满硬盘空间】问题。
   1. 已启动 WARP 分流的用户可以在【管理配置】->【分流管理】中选择【重置 WARP Proxy】选项，该选项实现清空容器日志与重置 WARP Proxy。
   2. 已添加日志限制，如需使用 WARP 功能直接启用即可。
2. v2026.03.01 版本添加切换 CA 厂商功能，切换 CA 厂商时，脚本会对现有域名证书执行强制重签（domain、cdn 与 custom_sites[].domain），全部成功后才写入新 CA；若中途失败会自动回滚到原 CA，并恢复对应配置，避免影响后续 acme 自动续期任务。
   1. 强制重签会绕过「域名未变化」检查（acme.sh 的 Domains not changed 提示场景）。
   2. 请留意 CA 侧签发频率限制（例如 Let's Encrypt 的速率限制）。
3. v2026.03.17 版本添加 SNI 自定义域名与反代应用管理功能，用于在不影响现有 Reality(domain) 与 CDN(cdn) 站点的前提下，额外挂载多个 HTTPS 反代站点。
   1. 菜单路径：管理配置 -> SNI 配置管理 -> 管理自定义域名与反代应用
   2. 支持列表 / 新增 / 编辑 / 删除，自定义站点拥有独立证书、独立 sites-available/<domain>.conf、独立 stream 映射与 UDS。
   3. stream.conf 会按 domain、cdn、custom_sites 全量重建；UDS 名称规则为 SHA-256(域名) 前 12 位 + 端口号。
   4. 反代目标支持仅输入端口或完整 http(s)://host:port 地址；仅输入端口时自动规范化为 http://127.0.0.1:<port>；不接受带 path、query、fragment 的地址。
   5. 编辑时仅修改上游地址不会重复签发证书；修改域名时会先申请新证书，再切换配置，失败自动回滚；删除时会同时清理站点配置、软链、续签记录与证书目录。
   6. 自定义域名不能与 domain、cdn 或其他自定义站点域名重复；切换 CA 厂商与“强制续签所有证书”都会覆盖自定义站点域名。
   7. 自定义站点为“纯反代站点”，不包含 Xray 的 xhttp/grpc 路径，也不接入 Cloudreve 管理逻辑；代理层不会额外注入 Content-Security-Policy，由上游应用自行控制 CSP。

分享链接

基于VMessAEAD / VLESS 分享链接标准提案与v2rayN实现，如果其他客户端无法正常使用，请自行根据分享链接进行修改。

SNI 配置中，CDN 的分享链接 Alpn 默认为 H2，如有 H3 需求，请自行在客户端修改。

如何使用

• 获取

  wget --no-check-certificate -O ${HOME}/Xray-script.sh https://raw.githubusercontent.com/zxcvos/Xray-script/main/install.sh
  

• 使用

  • 启动界面

    bash ${HOME}/Xray-script.sh
    

  • 快速安装 Vision

    bash ${HOME}/Xray-script.sh --vision
    

  • 快速安装 XHTTP

    bash ${HOME}/Xray-script.sh --xhttp
    

  • 快速安装 Fallback

    bash ${HOME}/Xray-script.sh --fallback
    

• 快速启动(界面)

  wget --no-check-certificate -O ${HOME}/Xray-script.sh https://raw.githubusercontent.com/zxcvos/Xray-script/main/install.sh && bash ${HOME}/Xray-script.sh
  

脚本界面

 __   __  _    _   _______   _______   _____  
 \ \ / / | |  | | |__   __| |__   __| |  __ \ 
  \ V /  | |__| |    | |       | |    | |__) |
   > <   |  __  |    | |       | |    |  ___/ 
  / . \  | |  | |    | |       | |    | |     
 /_/ \_\ |_|  |_|    |_|       |_|    |_|     

Copyright (C) zxcvos | https://github.com/zxcvos/Xray-script

-------------------------------------------
Xray       : v25.7.26
CONFIG     : VLESS-Vision-REALITY
WARP Proxy : 已启动
-------------------------------------------

--------------- Xray-script ---------------
 Version      : v2025-07-25
 Description  : Xray 管理脚本
----------------- 装载管理 ----------------
1. 完整安装
2. 仅安装/更新
3. 卸载
----------------- 操作管理 ----------------
4. 启动
5. 停止
6. 重启
----------------- 配置管理 ----------------
7. 分享链接与二维码
8. 信息统计
9. 管理配置
-------------------------------------------
0. 退出

已测试系统

以上发行版均通过 Vultr 测试安装。

其他 Debian 基系统与 Red Hat 基系统可能能用，但未测试过，可能存在问题。

安装时长说明

SNI 配置适合安装一次后长期使用，不适合反复重置系统安装，这会消耗您的大量时间。如果需要更换配置和域名等，在管理界面都有相应的选项。

更换为非 SNI 配置后，Nginx 将停止服务，但会继续保留在本机，再启用 SNI 配置时不会进行重新安装。

安装时长参考

安装流程：

更新系统管理包->安装依赖->[安装Docker]->[安装Cloudreve]->[安装Cloudflare-warp]->安装Xray->安装Nginx->申请证书->配置文件

这是一台单核1G的服务器的平均安装时长，仅供参考：

为什么 SNI 配置安装时间那么长？

脚本的 Nginx 是采用源码编译的形式进行管理安装。

编译相比直接安装二进制文件的优点有：

1. 运行效率高 (编译时采用了-O3优化)
2. 软件版本新

缺点就是编译耗时长。

安装位置

Xray-script: /usr/local/xray-script

Nginx: /usr/local/nginx

Cloudreve: $HOME/.xray-script/docker/cloudreve

Cloudflare-warp: $HOME/.xray-script/docker/warp

Xray: 见 Xray-install

依赖列表

使用 SNI 配置时，脚本可能自动安装以下依赖：

致谢

Xray-core

REALITY

XHTTP: Beyond REALITY

integrated-examples

xhttp 五合一配置

部署 Cloudflare WARP Proxy

cloudflare-warp 镜像

V2Ray 路由规则文件加强版

kirin10000/Xray-script

Cloudreve

此脚本仅供交流学习使用，请勿使用此脚本行违法之事。网络非法外之地，行非法之事，必将接受法律制裁。