xray-manager
v1.8.5TypeScript
Xray 企业级管理平台 - 一键部署 + 流量配额管理 + 用户管理 | Enterprise-grade Xray management platform with one-click deployment, traffic quota, and user management
0/weekUpdated 2 weeks agoMITUnpacked: 1.0 MB
Published by DanOps-1
npm install xray-manager
🚀 Xray VPN OneClick | 一键科学上网
5分钟部署 VLESS+Reality 代理服务器 — 最强抗封锁协议
🔥 无需域名/证书 | 流量伪装 TLS 1.3 | 主动探测防御 | 全平台客户端支持
自建梯子 · 科学上网 · 翻墙工具 · VPN替代方案 · 访问ChatGPT/Claude
---
📑 目录
- ✨ 项目简介
- 🌐 使用场景
- 🎯 主要特性
- 🆚 协议对比
- 🚀 快速开始
- 🛠️ 服务管理
- 📱 客户端配置
- 🗑️ 卸载与清理
- 💡 常见问题
- 📖 详细文档
- 🤝 贡献指南
- 📄 许可证
---
✨ 项目简介
Xray VPN OneClick 是一个完全自动化的 Xray 服务端部署项目，使用最新的 VLESS + XTLS-Reality 协议，为用户提供安全、高速、难以被检测的代理服务。
$3
| 特点 | 说明 |
|------|------|
| 🎯 零配置部署 | 一行命令完成安装，自动生成所有配置参数 |
| 🔐 顶级安全 | 使用 Reality 协议，流量特征与正常 TLS 无法区分 |
| ⚡ 高性能 | 内置 BBR 拥塞控制和 TCP Fast Open 优化 |
| 📱 全平台兼容 | 支持 Windows、macOS、Linux、Android、iOS |
| 🛠️ 完善工具 | 提供用户管理、备份恢复、一键更新等工具 |
| 📚 详尽文档 | 完整的中英文文档和故障排查指南 |
---
🌐 使用场景
$3- ChatGPT / GPT-4 - Claude / Anthropic - Google Gemini / Bard - Midjourney / DALL-E - GitHub Copilot | $3- 公共 WiFi 安全防护 - 防止 ISP 流量监控 - 保护敏感通信 - 匿名浏览 |
$3- 安全访问公司内网 - 跨国团队协作 - 远程开发环境 - 企业 VPN 替代方案 | $3- 访问 Google Scholar - 下载学术论文 - 使用国际学术资源 - 参与国际学术交流 |
$3- 访问 GitHub / GitLab - 使用 npm / Docker Hub - 查阅技术文档 - Stack Overflow | $3- YouTube / Netflix - Twitter / Instagram - Telegram / Discord - 国际新闻媒体 |
---
🎯 主要特性
$3- ✅ 一键安装 - 5分钟内完成部署 - ✅ 自动配置 - UUID、密钥自动生成 - ✅ systemd 集成 - 开机自启动 - ✅ 多种安装方式 - wget、curl、git clone - ✅ 国内加速 - 提供镜像加速下载 | $3- ✅ VLESS 协议 - 轻量级高性能 - ✅ Reality 伪装 - 流量难以识别 - ✅ x25519 密钥 - 强加密保护 - ✅ Short ID - 增强安全性 - ✅ 防重放攻击 - 内置保护机制 |
$3- ✅ 用户管理 - 添加/删除用户 - ✅ 配置备份 - 自动备份恢复 - ✅ 一键更新 - 升级到最新版本 - ✅ 查看配置 - 显示连接信息 - ✅ 安全卸载 - 完整清理系统 | $3- ✅ 分享链接 - 自动生成 VLESS URL - ✅ 二维码 - 扫码快速导入 - ✅ 全平台 - 主流系统全覆盖 - ✅ 多协议 - 兼容 v2ray 生态 - ✅ 详细教程 - 分平台配置指南 |
---
🆚 协议对比
| 协议 | 速度 | 安全性 | 抗检测 | 配置难度 | 推荐度 |
|------|------|--------|--------|----------|--------|
| VLESS+Reality | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ✅ 推荐 |
| VMess+WebSocket+TLS | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⚠️ 一般 |
| Shadowsocks | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⚠️ 易封锁 |
| Trojan | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ✅ 可选 |
| V2Ray (传统) | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ❌ 过时 |
VLESS+Reality 优势：
- 🎯 流量特征与真实 TLS 1.3 连接完全相同
- 🎯 无需购买域名和配置证书
- 🎯 性能损耗极小，接近直连速度
- 🎯 主动探测无法识别代理特征
---
🚀 快速开始
$3
点击查看详细配置要求
最低配置 | 推荐配置 |
支持的操作系统
| 发行版 | 最低版本 | 状态 |
|--------|----------|------|
| Ubuntu / Debian / Kali | 22.04 / 11 / 2023+ | ✅ 完全支持 |
| CentOS Stream / AlmaLinux / Rocky | 9 | ✅ 完全支持 |
| Fedora / Amazon Linux | 39 / 2023 | ✅ 完全支持 |
$3
选择适合你的安装方式（推荐方式一）：
方式一：直接安装 | 方式二：加速安装 | 方式三：克隆仓库 |
安装完成后，脚本会自动输出服务器信息和客户端配置，请妥善保存。
---
📱 客户端配置
$3
| 平台 | 推荐客户端 | 下载链接 |
|------|-----------|---------|
| 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（需美区账号）|
$3
本项目完全适配 Clash Verge Rev - 一款现代化的跨平台 Clash 客户端！
为什么选择 Clash Verge Rev？
- ✅ 跨平台支持（Windows、macOS、Linux）
- ✅ 现代化的图形界面，易于使用
- ✅ 完整支持 VLESS + Reality 协议
- ✅ 内置规则管理和订阅功能
- ✅ 开源免费，持续更新维护
使用方法：
1. 下载安装 Clash Verge Rev
- 访问 GitHub Releases 下载对应平台版本
2. 生成 Clash 配置文件
`bash
# 使用 CLI 工具生成
xray-manager
# 选择 "用户管理" -> "生成 Clash 配置"
# 或使用命令行直接生成
xray-manager clash --link <你的VLESS链接>
`
3. 导入配置到 Clash Verge Rev
- 打开 Clash Verge Rev
- 点击 "配置" -> "导入"
- 选择生成的 clash-config.yaml 文件
- 启用配置并连接
> 💡 提示: 生成的 Clash 配置文件完全兼容 Clash Meta 内核，支持所有 Reality 特性。
$3
方式一：使用分享链接（推荐）
1. 复制安装脚本输出的 VLESS 分享链接
2. 打开客户端应用
3. 选择"从剪贴板导入"或"扫描二维码"
4. 连接并开始使用
方式二：使用 Clash 配置文件
1. 使用 CLI 工具生成 Clash 配置
2. 导入到 Clash Verge Rev 或其他 Clash 客户端
3. 启用配置并连接
方式三：手动配置
查看详细教程：客户端配置指南
---
🛠️ 服务管理
$3
#### 📦 安装 Node.js 和 npm（如果尚未安装）
CLI 工具需要 Node.js 18+ 和 npm。如果你的系统还没有安装，请先执行：
Ubuntu / Debian / Kali
`bash使用 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
bash
使用 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 发行版）
bash
安装 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
`#### 🚀 安装 CLI 工具
安装 Node.js 后，使用以下命令安装 CLI 工具：
bash
全局安装 CLI 工具
npm install -g xray-manager启动交互式菜单
xray-manager
或使用简短别名
xm
`> 💡 提示: 也可以使用
无需安装直接运行（需要 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 |
$3
如果不使用 CLI 工具，也可以直接使用 systemd 命令：
`bash
查看服务状态
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 脚本工具
用户管理脚本
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
`系统维护脚本
bash
更新 Xray 到最新版本
sudo bash scripts/update.sh备份当前配置
sudo bash scripts/backup.sh恢复配置
sudo bash scripts/restore.sh <备份文件>卸载 Xray
sudo bash scripts/uninstall.sh
`---
🗑️ 卸载与清理
$3
使用提供的卸载脚本可以安全地卸载 Xray：
bash
如果克隆了仓库
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
`卸载过程：
1. 确认卸载：输入
确认
2. 选择是否保留配置备份：
- 输入 Y 或回车：保留备份到 /var/backups/xray/
- 输入 ：不保留备份自动清理内容：
- ✅ 停止并禁用 Xray 服务
- ✅ 备份配置文件（可选）
- ✅ 卸载 Xray-core 程序
- ✅ 删除配置目录
/usr/local/etc/xray
- ✅ 删除日志目录
- ✅ 删除 systemd 服务文件$3
如果卸载脚本无法使用，可以手动执行以下命令：
bash
1. 停止并禁用服务
sudo systemctl stop xray
sudo systemctl disable xray2. 备份配置（可选）
sudo mkdir -p /var/backups/xray
sudo cp /usr/local/etc/xray/config.json /var/backups/xray/config-backup-$(date +%Y%m%d).json3. 使用官方脚本卸载 Xray
bash -c "$(curl -L https://github.com/XTLS/Xray-install/raw/main/install-release.sh)" @ remove --purge4. 删除残留文件
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
`$3
如果要完全删除所有相关文件：
bash
删除配置备份
sudo rm -rf /var/backups/xray删除项目目录（如果克隆了仓库）
rm -rf ~/Xray-VPN-OneClick
`$3
卸载后运行以下命令检查是否清理干净：
bash
检查服务状态（应该显示 "could not be found"）
systemctl status xray检查程序是否存在（应该没有输出）
which xray检查配置目录（应该不存在）
ls /usr/local/etc/xray检查端口占用（443 端口应该空闲）
sudo lsof -i :443
`---
📖 详细文档
- 完整安装教程 - 手动安装的详细步骤说明
- 客户端配置指南 - 各平台客户端的详细配置方法
- 用户管理指南 - 如何添加、删除和管理多个用户
- 开源仓库评审指南 - 生成开源成熟度评审报告
- 常见问题解答 - 常见问题的排查和解决方案
- 性能优化指南 - 提升服务器性能的建议
---
🔒 安全建议
基本安全措施
1. ✅ 定期更换密钥（建议每 3-6 个月）
2. ✅ 使用强密码或密钥认证
3. ✅ 配置防火墙，只开放必要端口
4. ✅ 及时更新 Xray 到最新版本
5. ✅ 定期检查日志和备份配置
查看进阶安全配置
bash
限制 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
国内云平台
- ✅ 阿里云、腾讯云、华为云
> 注意: 在国内云平台使用可能面临合规风险，请谨慎选择。
---
💡 常见问题
$3
bash
查看占用端口的进程
sudo lsof -i :443停止占用的服务
sudo systemctl stop nginx # 或其他服务或修改 Xray 配置使用其他端口
sudo nano /usr/local/etc/xray/config.json
`$3
排查步骤：
1. 确认服务正在运行：
2. 检查防火墙规则：
3. 确认云服务商安全组已开放 443 端口
4. 检查配置信息是否正确（UUID、公钥等）
5. 查看服务日志：$3
编辑配置文件
：`json
"dest": "www.cloudflare.com:443",
"serverNames": ["www.cloudflare.com"]
`推荐使用：
、www.apple.com、www.cloudflare.com$3
bash
启用 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 来改进本项目！
$3
1. Fork 本项目到你的账号
2. 创建特性分支：
3. 提交你的更改：
4. 推送到分支：5. 提交 Pull Request
$3
- 📝 改进文档和教程
- 🐛 修复 bug 和问题
- ✨ 添加新功能和工具
- 🌍 翻译文档到其他语言
- 📊 优化脚本性能
---
📚 参考资源
$3
- Xray 官方网站
- VLESS 协议规范
- Reality 协议介绍
- Xray-core 源代码
$3
- v2rayN (Windows 客户端)
- v2rayNG (Android 客户端)
- V2rayU (macOS 客户端)
---
📄 许可证
本项目采用 MIT License 开源许可证。
重要: 使用前请务必阅读 NOTICE - 使用须知与免责声明
这意味着你可以：
- ✅ 自由使用、复制、修改和分发本项目
- ✅ 用于商业或非商业目的（需遵守法律）
- ✅ 在遵守许可证的前提下自由修改
但需要：
- ⚠️ 保留原作者的版权声明
- ⚠️ 提供许可证副本
- ⚠️ 遵守 NOTICE 文件中的使用限制
---
⚠️ 免责声明
重要提示: 本项目仅供学习和研究使用。
$3
- ✅ 允许: 个人学习、技术研究、合法的企业内网、授权的安全测试
- ❌ 禁止: 任何违反当地法律法规的行为、访问非法内容、未授权的商业使用
$3
1. 使用代理技术需遵守当地法律法规
2. 在某些国家/地区（如中国大陆），未经授权使用 VPN 可能违法
3. 用户需自行承担所有法律后果
4. 作者不对使用本项目造成的任何后果负责
5. 使用者应自行评估法律风险
$3
使用前请务必阅读: NOTICE - 完整的使用须知与免责声明
如果你不同意相关条款或无法确保合法使用，请勿使用本项目。
---
💬 获取帮助
$3
- 📧 提交 Issue: GitHub Issues
- 💡 常见问题: 查看 FAQ 文档
- 📖 阅读文档: 完整的 安装和配置教程
- 🔍 搜索已有问题: 在提问前先搜索是否有相同问题
$3
请在 Issue 中提供以下信息：
1. 你的操作系统和版本
2. Xray 版本号
3. 详细的问题描述和错误信息
4. 相关的配置文件（隐藏敏感信息）
5. 你已经尝试过的解决方法
---
⭐ Star History
---
👥 Contributors
感谢所有为这个项目做出贡献的人！
---