x-ui 项目指南

项目地址: vaxilu/x-ui - GitHub
🔥 一款支持多协议、多用户的 Xray 可视化控制面板，提供便捷的配置管理与监控功能。

核心功能概览

• 系统监控
  实时查看服务器 CPU、内存、磁盘和网络状态。
• 多协议支持
  支持 VMess、VLESS、Trojan、Shadowsocks、HTTP、Socks 等协议，网页可视化操作。
• 流量管理
  精准统计用户流量，支持流量限额与到期时间设置。
• 自定义配置
  灵活修改 Xray 模板，适配 WebSocket、gRPC、TCP 等传输层协议。
• HTTPS 支持
  支持绑定域名与 SSL 证书，提供一键申请 Let's Encrypt 证书并自动续签。
• Docker 集成
  支持 Docker 快速部署，持久化配置与证书存储。

安装与升级

1. 一键脚本安装/升级

bash <(curl -Ls https://raw.githubusercontent.com/vaxilu/x-ui/master/install.sh)

2. 手动安装步骤

# 下载并解压（根据架构替换 amd64，如 arm64）
cd /root/
rm -rf x-ui/ /usr/local/x-ui/ /usr/bin/x-ui  # 注意确认路径
tar zxvf x-ui-linux-amd64.tar.gz

# 设置权限与部署文件
chmod +x x-ui/x-ui x-ui/bin/xray-linux-* x-ui/x-ui.sh
cp x-ui/x-ui.sh /usr/bin/x-ui
cp -f x-ui/x-ui.service /etc/systemd/system/
mv x-ui/ /usr/local/

# 启动服务
systemctl daemon-reload
systemctl enable x-ui
systemctl restart x-ui

3. Docker 部署

# 安装 Docker
curl -fsSL https://get.docker.com | sh

# 运行 x-ui 容器
mkdir x-ui && cd x-ui
docker run -itd --network=host \
    -v $PWD/db/:/etc/x-ui/ \          # 配置文件持久化
    -v $PWD/cert/:/root/cert/ \       # SSL 证书目录
    --name x-ui --restart=unless-stopped \
    enwaiax/x-ui:latest

# 自定义构建镜像（可选）
docker build -t x-ui .

SSL 证书申请（自动续签）

前置条件

• 域名通过 Cloudflare 解析至当前服务器。
• 获取 Cloudflare 注册邮箱 和 Global API Key（获取方法）。

操作步骤

1. 访问面板 http://服务器IP:54321（默认端口 54321）。
2. 进入 SSL 证书申请 功能页，输入：
   • 域名（如 example.com，自动生成泛域名证书 *.example.com）
   • Cloudflare 邮箱
   • Cloudflare Global API Key
3. 证书将保存至 /root/cert/，配置面板 HTTPS 时需指定此路径。

注意事项

1. 路径安全
   手动安装时 rm -rf 操作需谨慎，避免误删系统文件。
2. 架构适配
   非 amd64 设备需替换安装包名称（如 arm64）。
3. 防火墙设置
   开放面板端口（默认 54321）及代理服务端口（如 443、80）。
4. 证书维护
   脚本申请的证书通过 crontab 自动续签，无需手动干预。

如有问题，请参考 GitHub 项目文档。