机场搭建：XBoard Docker Compose 部署

适用场景：快速部署一套 XBoard 机场面板，管理节点、套餐与用户。本文记录使用 Docker Compose + SQLite 快速部署 XBoard 的基本流程。

如果你需要使用 MySQL，请自行准备数据库环境后再调整部署配置。

1. 安装 Docker

curl -sSL https://get.docker.com | bash
systemctl enable docker
systemctl start docker

2. 获取 Docker Compose 项目文件

git clone -b docker-compose --depth 1 https://github.com/cedar2025/Xboard
cd Xboard

3. 初始化数据库

安装过程中选择启用 SQLite 和 Docker 内置 Redis：

docker compose run -it --rm xboard php artisan xboard:install

执行完成后会返回后台地址和管理员账号密码，请及时记录。

4. 启动 XBoard

docker compose up -d

5. 访问站点

默认端口为 7001，可直接访问：

http://你的IP:7001/

如果需要使用 80 或 443 端口，建议额外配置 Nginx 反向代理。

更新

修改版本

cd Xboard
nano -m docker-compose.yaml

将 image 后面的版本号改为目标版本。如果使用 latest，可跳过这一步。

执行更新

docker compose pull
docker compose down
docker compose run -it --rm xboard php artisan xboard:update
docker compose up -d

回滚

注意：下面的操作不会回滚数据库，只会回退镜像版本。

  1. 修改 docker-compose.yaml 中的镜像版本号。
  2. 重新启动服务：
docker compose up -d

说明

  • 启用 Webman 后，如果修改了相关代码，通常需要重启服务才会生效。
  • 如果后续需要对接 v2bx，通常需要先让一个用户购买一次零元套餐，触发 XBoard 在数据库中生成用户记录，否则 v2bx 可能无法正常获取用户数据。

验证与自查

  1. docker compose ps 显示所有服务为 Up 状态
  2. curl -I http://你的IP:7001/ 返回 200
  3. 用安装时返回的管理员账号登录后台，能创建套餐并添加第一个用户
  4. docker compose logs --tail 50 无 ERROR 级别报错

参考