xray-manager
v1.8.5
Published
Xray 企业级管理平台 - 一键部署 + 流量配额管理 + 用户管理 | Enterprise-grade Xray management platform with one-click deployment, traffic quota, and user management
Maintainers
danps-1Readme
🚀 Xray VPN OneClick | 一键科学上网
📑 目录
✨ 项目简介
Xray VPN OneClick 是一个完全自动化的 Xray 服务端部署项目，使用最新的 VLESS + XTLS-Reality 协议，为用户提供安全、高速、难以被检测的代理服务。
为什么选择本项目？
| 特点 | 说明 | |------|------| | 🎯 零配置部署 | 一行命令完成安装，自动生成所有配置参数 | | 🔐 顶级安全 | 使用 Reality 协议，流量特征与正常 TLS 无法区分 | | ⚡ 高性能 | 内置 BBR 拥塞控制和 TCP Fast Open 优化 | | 📱 全平台兼容 | 支持 Windows、macOS、Linux、Android、iOS | | 🛠️ 完善工具 | 提供用户管理、备份恢复、一键更新等工具 | | 📚 详尽文档 | 完整的中英文文档和故障排查指南 |
🌐 使用场景
🤖 访问 AI 服务
- ChatGPT / GPT-4
- Claude / Anthropic
- Google Gemini / Bard
- Midjourney / DALL-E
- GitHub Copilot
🔒 隐私与安全
- 公共 WiFi 安全防护
- 防止 ISP 流量监控
- 保护敏感通信
- 匿名浏览
💼 远程办公
- 安全访问公司内网
- 跨国团队协作
- 远程开发环境
- 企业 VPN 替代方案
🎓 学术研究
- 访问 Google Scholar
- 下载学术论文
- 使用国际学术资源
- 参与国际学术交流
👨💻 开发者工具
- 访问 GitHub / GitLab
- 使用 npm / Docker Hub
- 查阅技术文档
- Stack Overflow
🌍 内容访问
- YouTube / Netflix
- Twitter / Instagram
- Telegram / Discord
- 国际新闻媒体
🎯 主要特性
🚀 部署特性
- ✅ 一键安装 - 5分钟内完成部署
- ✅ 自动配置 - UUID、密钥自动生成
- ✅ systemd 集成 - 开机自启动
- ✅ 多种安装方式 - wget、curl、git clone
- ✅ 国内加速 - 提供镜像加速下载
🔒 安全特性
- ✅ VLESS 协议 - 轻量级高性能
- ✅ Reality 伪装 - 流量难以识别
- ✅ x25519 密钥 - 强加密保护
- ✅ Short ID - 增强安全性
- ✅ 防重放攻击 - 内置保护机制
🛠️ 管理特性
- ✅ 用户管理 - 添加/删除用户
- ✅ 配置备份 - 自动备份恢复
- ✅ 一键更新 - 升级到最新版本
- ✅ 查看配置 - 显示连接信息
- ✅ 安全卸载 - 完整清理系统
📱 客户端特性
- ✅ 分享链接 - 自动生成 VLESS URL
- ✅ 二维码 - 扫码快速导入
- ✅ 全平台 - 主流系统全覆盖
- ✅ 多协议 - 兼容 v2ray 生态
- ✅ 详细教程 - 分平台配置指南
🆚 协议对比
| 协议 | 速度 | 安全性 | 抗检测 | 配置难度 | 推荐度 | |------|------|--------|--------|----------|--------| | VLESS+Reality | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ✅ 推荐 | | VMess+WebSocket+TLS | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⚠️ 一般 | | Shadowsocks | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐⭐ | ⚠️ 易封锁 | | Trojan | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ✅ 可选 | | V2Ray (传统) | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ | ❌ 过时 |
VLESS+Reality 优势：
- 🎯 流量特征与真实 TLS 1.3 连接完全相同
- 🎯 无需购买域名和配置证书
- 🎯 性能损耗极小，接近直连速度
- 🎯 主动探测无法识别代理特征
🚀 快速开始
📋 系统要求
最低配置
- 操作系统: Linux (见下方支持列表)
- 内存: 512 MB RAM
- 存储: 100 MB 可用空间
- 网络: 公网 IP 地址
推荐配置
- 操作系统: Ubuntu 22.04 LTS / Debian 12
- 内存: 1 GB RAM
- CPU: 1 核心
- 带宽: 10 Mbps+
支持的操作系统
| 发行版 | 最低版本 | 状态 | |--------|----------|------| | 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 客户端支持
本项目完全适配 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 和 npm（如果尚未安装）
CLI 工具需要 Node.js 18+ 和 npm。如果你的系统还没有安装，请先执行：
# 使用 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 或更高# 使用 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
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 工具：
# 全局安装 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 |
🔧 systemd 原生命令
如果不使用 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 行用户管理脚本
# 添加新用户
sudo bash scripts/add-user.sh [email protected]
# 删除用户
sudo bash scripts/del-user.sh [email protected]
# 列出所有用户
sudo bash scripts/show-config.sh users
# 显示用户的分享链接
sudo bash scripts/show-config.sh link [email protected]系统维护脚本
# 更新 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/[email protected]
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
国内云平台
- ✅ 阿里云、腾讯云、华为云
注意: 在国内云平台使用可能面临合规风险，请谨慎选择。
💡 常见问题
1. 端口 443 被占用怎么办？
# 查看占用端口的进程
sudo lsof -i :443
# 停止占用的服务
sudo systemctl stop nginx # 或其他服务
# 或修改 Xray 配置使用其他端口
sudo nano /usr/local/etc/xray/config.json2. 客户端无法连接？
排查步骤：
- 确认服务正在运行：
sudo systemctl status xray - 检查防火墙规则：
sudo ufw status - 确认云服务商安全组已开放 443 端口
- 检查配置信息是否正确（UUID、公钥等）
- 查看服务日志：
sudo journalctl -u xray -f
3. 如何更换伪装目标网站？
编辑配置文件 /usr/local/etc/xray/config.json：
"dest": "www.cloudflare.com:443",
"serverNames": ["www.cloudflare.com"]推荐使用：www.microsoft.com、www.apple.com、www.cloudflare.com
4. 如何提升连接速度？
# 启用 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 的建议
请在 Issue 中提供以下信息：
- 你的操作系统和版本
- Xray 版本号
- 详细的问题描述和错误信息
- 相关的配置文件（隐藏敏感信息）
- 你已经尝试过的解决方法
⭐ Star History
👥 Contributors
感谢所有为这个项目做出贡献的人！
⭐ 如果这个项目对你有帮助，请给一个 Star 支持一下！
🔄 也欢迎 Fork 和分享给需要的朋友！
Made with ❤️ by DanOps-1