🔥 无需域名/证书 | 流量伪装 TLS 1.3 | 主动探测防御 | 全平台客户端支持
自建梯子 · 科学上网 · 翻墙工具 · VPN替代方案 · 访问ChatGPT/Claude
你的 Star 是我持续更新的最大动力 🙏
开源不易，维护更难。一个 Star，一份鼓励！
现代化的交互式管理界面，支持服务管理、用户管理、流量配额等功能
Xray VPN OneClick 是一个完全自动化的 Xray 服务端部署项目，使用最新的 VLESS + XTLS-Reality 协议，为用户提供安全、高速、难以被检测的代理服务。
| 特点 | 说明 |
|---|---|
| 🎯 零配置部署 | 一行命令完成安装，自动生成所有配置参数 |
| 🔐 顶级安全 | 使用 Reality 协议，流量特征与正常 TLS 无法区分 |
| ⚡ 高性能 | 内置 BBR 拥塞控制和 TCP Fast Open 优化 |
| 📱 全平台兼容 | 支持 Windows、macOS、Linux、Android、iOS |
| 🛠️ 完善工具 | 提供用户管理、备份恢复、一键更新等工具 |
| 📚 详尽文档 | 完整的中英文文档和故障排查指南 |
|
|
|
|
|
|
|
|
|
|
| 协议 | 速度 | 安全性 | 抗检测 | 配置难度 | 推荐度 |
|---|---|---|---|---|---|
| VLESS+Reality | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ✅ 推荐 |
| VMess+WebSocket+TLS | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | |
| Shadowsocks | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | |
| Trojan | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ✅ 可选 |
| V2Ray (传统) | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ❌ 过时 |
VLESS+Reality 优势：
- 🎯 流量特征与真实 TLS 1.3 连接完全相同
- 🎯 无需购买域名和配置证书
- 🎯 性能损耗极小，接近直连速度
- 🎯 主动探测无法识别代理特征
点击查看详细配置要求
|
最低配置
|
推荐配置
|
支持的操作系统
| 发行版 | 最低版本 | 状态 |
|---|---|---|
| Ubuntu / Debian / Kali | 22.04 / 11 / 2023+ | ✅ 完全支持 |
| CentOS Stream / AlmaLinux / Rocky | 9 | ✅ 完全支持 |
| Fedora / Amazon Linux | 39 / 2023 | ✅ 完全支持 |
选择适合你的安装方式（推荐方式一）：
|
方式一：直接安装 wget https://raw.githubusercontent.com/DanOps-1/Xray-VPN-OneClick/main/scripts/install.sh -O xray-install.sh
sudo bash xray-install.sh |
方式二：加速安装 # 国内服务器推荐
wget https://ghproxy.com/https://raw.githubusercontent.com/DanOps-1/Xray-VPN-OneClick/main/scripts/install.sh -O xray-install.sh
sudo bash xray-install.sh |
方式三：克隆仓库 git clone https://github.com/DanOps-1/Xray-VPN-OneClick.git
cd Xray-VPN-OneClick/scripts
sudo bash install.sh |
安装完成后，脚本会自动输出服务器信息和客户端配置，请妥善保存。
| 平台 | 推荐客户端 | 下载链接 |
|---|---|---|
| Windows | v2rayN | GitHub Releases |
| macOS | V2rayU / V2RayXS | V2rayU | V2RayXS |
| Linux | v2ray-core / Qv2ray | v2ray | Qv2ray |
| Android | v2rayNG | GitHub Releases |
| iOS | Shadowrocket / Quantumult X | App Store（需美区账号） |
本项目完全适配 Clash Verge Rev - 一款现代化的跨平台 Clash 客户端！
为什么选择 Clash Verge Rev？
- ✅ 跨平台支持（Windows、macOS、Linux）
- ✅ 现代化的图形界面，易于使用
- ✅ 完整支持 VLESS + Reality 协议
- ✅ 内置规则管理和订阅功能
- ✅ 开源免费，持续更新维护
使用方法：
-
下载安装 Clash Verge Rev
- 访问 GitHub Releases 下载对应平台版本
-
生成 Clash 配置文件
# 使用 CLI 工具生成 xray-manager # 选择 "用户管理" -> "生成 Clash 配置" # 或使用命令行直接生成 xray-manager clash --link <你的VLESS链接>
-
导入配置到 Clash Verge Rev
- 打开 Clash Verge Rev
- 点击 "配置" -> "导入"
- 选择生成的
clash-config.yaml文件 - 启用配置并连接
💡 提示: 生成的 Clash 配置文件完全兼容 Clash Meta 内核，支持所有 Reality 特性。
方式一：使用分享链接（推荐）
- 复制安装脚本输出的 VLESS 分享链接
- 打开客户端应用
- 选择"从剪贴板导入"或"扫描二维码"
- 连接并开始使用
方式二：使用 Clash 配置文件
- 使用 CLI 工具生成 Clash 配置
- 导入到 Clash Verge Rev 或其他 Clash 客户端
- 启用配置并连接
方式三：手动配置
查看详细教程：客户端配置指南
CLI 工具需要 Node.js 18+ 和 npm。如果你的系统还没有安装，请先执行：
Ubuntu / Debian / Kali
# 使用 NodeSource 仓库安装最新 LTS 版本
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version # 应显示 v18.x 或更高
npm --version # 应显示 9.x 或更高CentOS / RHEL / Fedora / AlmaLinux / Rocky
# 使用 NodeSource 仓库安装最新 LTS 版本
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install -y nodejs
# 验证安装
node --version # 应显示 v18.x 或更高
npm --version # 应显示 9.x 或更高使用 nvm（推荐，适用于所有 Linux 发行版）
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载 shell 配置
source ~/.bashrc # 或 source ~/.zshrc
# 安装 Node.js LTS
nvm install --lts
nvm use --lts
# 验证安装
node --version
npm --version安装 Node.js 后，使用以下命令安装 CLI 工具：
# 全局安装 CLI 工具
npm install -g xray-manager
# 启动交互式菜单
xray-manager
# 或使用简短别名
xm💡 提示: 也可以使用
npx xray-manager无需安装直接运行（需要 npm）
| 功能模块 | 说明 |
|---|---|
| 📊 服务管理 | 查看状态、启动/停止/重启服务 |
| 👥 用户管理 | 添加/删除用户、生成分享链接 |
| 📊 流量配额 ⭐ | 设置配额、流量预警、超额自动禁用 |
| ⚙️ 配置管理 | 备份/恢复配置、修改配置项 |
| 📝 日志查看 | 实时日志、按级别/时间过滤 |
| 📈 仪表盘 | 服务概览、用户统计、流量统计 |
查看详细功能列表
服务管理
- 查看服务状态（运行时长、内存使用）
- 启动/停止/重启服务
- 自动检测权限和 systemd
用户管理
- 列出所有用户（含流量使用信息）
- 添加新用户（自动生成 UUID）
- 删除用户
- 显示分享链接（自动复制到剪贴板）
流量配额管理 ⭐ NEW
- 为用户设置流量配额（预设/自定义）
- 查看流量使用情况和剩余配额
- 流量预警（80%黄色/100%红色）
- 超额自动禁用用户
- 重置流量和重新启用用户
配置管理
- 查看当前配置
- 创建配置备份（时间戳命名）
- 列出所有备份
- 恢复配置
- 修改配置项
日志查看
- 查看最近日志
- 实时跟踪日志（Ctrl+C 停止）
- 按级别过滤（error/warning/info/debug）
- 按时间范围过滤
仪表盘
- 服务状态概览
- 用户统计（活跃/警告/超额）
- 总流量使用统计
- 实时数据刷新
查看终端兼容性详情
CLI 工具支持多种终端环境，自动适配不同系统：
支持的终端
- ✅ 现代终端: xterm, iTerm2, GNOME Terminal, Konsole（Unicode + 彩色）
- ✅ Windows CMD: 完全兼容（纯 ASCII 文本图标）
- ✅ SSH 会话: 自动检测并适配远程终端
- ✅ 传统终端: vt100, dumb terminal（降级到 ASCII）
- ✅ 管道输出: 重定向时自动切换到纯文本 + 时间戳模式
三种输出模式
| 模式 | 使用场景 | 特性 |
|---|---|---|
| RICH | 现代终端（默认） | 彩色 + Unicode 图标 + 格式化 |
| PLAIN_TTY | 无彩色终端 | ASCII 图标 + 格式化（无彩色） |
| PIPE | 管道/日志文件 | 纯文本 + 时间戳 + 结构化输出 |
终端尺寸推荐
| 尺寸类型 | 终端大小 | 布局模式 |
|---|---|---|
| 最小 | 60x20 | COMPACT |
| 标准 | 80x24 | STANDARD（推荐） |
| 宽屏 | 120+ 列 | WIDE |
如果不使用 CLI 工具，也可以直接使用 systemd 命令：
# 查看服务状态
sudo systemctl status xray
# 启动/停止/重启服务
sudo systemctl start xray
sudo systemctl stop xray
sudo systemctl restart xray
# 查看日志
sudo journalctl -u xray -f # 实时日志
sudo journalctl -u xray -n 100 # 最近 100 行查看 Bash 脚本工具
用户管理脚本
# 添加新用户
sudo bash scripts/add-user.sh user@example.com
# 删除用户
sudo bash scripts/del-user.sh user@example.com
# 列出所有用户
sudo bash scripts/show-config.sh users
# 显示用户的分享链接
sudo bash scripts/show-config.sh link user@example.com系统维护脚本
# 更新 Xray 到最新版本
sudo bash scripts/update.sh
# 备份当前配置
sudo bash scripts/backup.sh
# 恢复配置
sudo bash scripts/restore.sh <备份文件>
# 卸载 Xray
sudo bash scripts/uninstall.sh使用提供的卸载脚本可以安全地卸载 Xray：
# 如果克隆了仓库
sudo bash scripts/uninstall.sh
# 如果没有仓库，下载卸载脚本
wget https://ghproxy.com/https://raw.githubusercontent.com/DanOps-1/Xray-VPN-OneClick/main/scripts/uninstall.sh
sudo bash uninstall.sh卸载过程：
- 确认卸载：输入
yes确认 - 选择是否保留配置备份：
- 输入
Y或回车：保留备份到/var/backups/xray/ - 输入
n：不保留备份
- 输入
自动清理内容：
- ✅ 停止并禁用 Xray 服务
- ✅ 备份配置文件（可选）
- ✅ 卸载 Xray-core 程序
- ✅ 删除配置目录
/usr/local/etc/xray - ✅ 删除日志目录
/var/log/xray - ✅ 删除 systemd 服务文件
如果卸载脚本无法使用，可以手动执行以下命令：
# 1. 停止并禁用服务
sudo systemctl stop xray
sudo systemctl disable xray
# 2. 备份配置（可选）
sudo mkdir -p /var/backups/xray
sudo cp /usr/local/etc/xray/config.json /var/backups/xray/config-backup-$(date +%Y%m%d).json
# 3. 使用官方脚本卸载 Xray
bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ remove --purge
# 4. 删除残留文件
sudo rm -rf /usr/local/etc/xray
sudo rm -rf /var/log/xray
sudo rm -f /etc/systemd/system/xray.service
sudo rm -f /etc/systemd/system/xray@.service
sudo systemctl daemon-reload如果要完全删除所有相关文件：
# 删除配置备份
sudo rm -rf /var/backups/xray
# 删除项目目录（如果克隆了仓库）
rm -rf ~/Xray-VPN-OneClick卸载后运行以下命令检查是否清理干净：
# 检查服务状态（应该显示 "could not be found"）
systemctl status xray
# 检查程序是否存在（应该没有输出）
which xray
# 检查配置目录（应该不存在）
ls /usr/local/etc/xray
# 检查端口占用（443 端口应该空闲）
sudo lsof -i :443- 完整安装教程 - 手动安装的详细步骤说明
- 客户端配置指南 - 各平台客户端的详细配置方法
- 用户管理指南 - 如何添加、删除和管理多个用户
- 开源仓库评审指南 - 生成开源成熟度评审报告
- 常见问题解答 - 常见问题的排查和解决方案
- 性能优化指南 - 提升服务器性能的建议
基本安全措施
- ✅ 定期更换密钥（建议每 3-6 个月）
- ✅ 使用强密码或密钥认证
- ✅ 配置防火墙，只开放必要端口
- ✅ 及时更新 Xray 到最新版本
- ✅ 定期检查日志和备份配置
查看进阶安全配置
# 限制 SSH 访问
sudo ufw allow 22/tcp
sudo ufw allow 443/tcp
sudo ufw enable
# 禁用 root 登录（推荐）
sudo nano /etc/ssh/sshd_config
# 设置: PermitRootLogin no
sudo systemctl restart sshd
# 配置自动安全更新
sudo apt install unattended-upgrades
sudo dpkg-reconfigure --priority=low unattended-upgrades本项目已在以下云平台测试通过：
查看支持的云平台列表
国外云平台
- ✅ AWS EC2, Google Cloud Platform, Microsoft Azure
- ✅ DigitalOcean, Vultr, Linode, Hetzner
国内云平台
- ✅ 阿里云、腾讯云、华为云
注意: 在国内云平台使用可能面临合规风险，请谨慎选择。
# 查看占用端口的进程
sudo lsof -i :443
# 停止占用的服务
sudo systemctl stop nginx # 或其他服务
# 或修改 Xray 配置使用其他端口
sudo nano /usr/local/etc/xray/config.json排查步骤：
- 确认服务正在运行：
sudo systemctl status xray - 检查防火墙规则：
sudo ufw status - 确认云服务商安全组已开放 443 端口
- 检查配置信息是否正确（UUID、公钥等）
- 查看服务日志：
sudo journalctl -u xray -f
编辑配置文件 /usr/local/etc/xray/config.json：
"dest": "www.cloudflare.com:443",
"serverNames": ["www.cloudflare.com"]推荐使用：www.microsoft.com、www.apple.com、www.cloudflare.com
# 启用 BBR 拥塞控制
echo "net.core.default_qdisc=fq" | sudo tee -a /etc/sysctl.conf
echo "net.ipv4.tcp_congestion_control=bbr" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
# 启用 TCP Fast Open
echo "net.ipv4.tcp_fastopen=3" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p更多问题查看：常见问题完整列表
欢迎提交 Issue 和 Pull Request 来改进本项目！
- Fork 本项目到你的账号
- 创建特性分支：
git checkout -b feature/AmazingFeature - 提交你的更改：
git commit -m 'Add some AmazingFeature' - 推送到分支：
git push origin feature/AmazingFeature - 提交 Pull Request
- 📝 改进文档和教程
- 🐛 修复 bug 和问题
- ✨ 添加新功能和工具
- 🌍 翻译文档到其他语言
- 📊 优化脚本性能
本项目采用 MIT License 开源许可证。
重要: 使用前请务必阅读 NOTICE - 使用须知与免责声明
这意味着你可以：
- ✅ 自由使用、复制、修改和分发本项目
- ✅ 用于商业或非商业目的（需遵守法律）
- ✅ 在遵守许可证的前提下自由修改
但需要：
⚠️ 保留原作者的版权声明⚠️ 提供许可证副本⚠️ 遵守 NOTICE 文件中的使用限制
重要提示: 本项目仅供学习和研究使用。
- ✅ 允许: 个人学习、技术研究、合法的企业内网、授权的安全测试
- ❌ 禁止: 任何违反当地法律法规的行为、访问非法内容、未授权的商业使用
- 使用代理技术需遵守当地法律法规
- 在某些国家/地区（如中国大陆），未经授权使用 VPN 可能违法
- 用户需自行承担所有法律后果
- 作者不对使用本项目造成的任何后果负责
- 使用者应自行评估法律风险
使用前请务必阅读: NOTICE - 完整的使用须知与免责声明
如果你不同意相关条款或无法确保合法使用，请勿使用本项目。
- 📧 提交 Issue: GitHub Issues
- 💡 常见问题: 查看 FAQ 文档
- 📖 阅读文档: 完整的 安装和配置教程
- 🔍 搜索已有问题: 在提问前先搜索是否有相同问题
请在 Issue 中提供以下信息：
- 你的操作系统和版本
- Xray 版本号
- 详细的问题描述和错误信息
- 相关的配置文件（隐藏敏感信息）
- 你已经尝试过的解决方法
感谢所有为这个项目做出贡献的人！