基于aaPanel和Docker的Xboard项目部署指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00156/article/details/148758696

基于aaPanel和Docker的Xboard项目部署指南

前言

Xboard是一款功能强大的开源项目，本文将详细介绍如何在aaPanel面板和Docker环境下部署Xboard项目。通过本教程，即使是初学者也能顺利完成部署工作。

环境准备

硬件要求

处理器：至少1核CPU
内存：建议2GB及以上
存储空间：至少10GB可用空间

软件要求

操作系统：Ubuntu 20.04+/CentOS 7+/Debian 10+
aaPanel：最新版本
Docker：包含Docker Compose
Nginx：任意版本
MySQL：5.7及以上版本

安装步骤

第一步：安装aaPanel

aaPanel是一款优秀的服务器管理面板，安装命令如下：

curl -sSL https://www.aapanel.com/script/install_6.0_en.sh -o install_6.0_en.sh && \
bash install_6.0_en.sh aapanel

安装完成后，通过浏览器访问面板地址，完成初始设置。

第二步：基础环境配置

安装Docker

# 安装Docker
curl -sSL https://get.docker.com | bash

# 对于CentOS系统，还需执行：
systemctl enable docker
systemctl start docker

安装必要组件

在aaPanel面板中安装以下组件：

Nginx（任意版本）
MySQL 5.7
注意：不需要安装PHP和Redis

第三步：网站配置

创建网站

进入aaPanel > 网站 > 添加站点
填写信息：
- 域名：输入您的网站域名
- 数据库：选择MySQL
- PHP版本：选择纯静态

部署Xboard项目

# 进入网站目录
cd /www/wwwroot/您的域名

# 清理目录
chattr -i .user.ini
rm -rf .htaccess 404.html 502.html index.html .user.ini

# 获取项目代码
git clone https://github.com/cedar2025/Xboard.git ./

# 准备配置文件
cp compose.sample.yaml compose.yaml

# 初始化项目
docker compose run -it --rm web sh init.sh

初始化完成后，请务必记录显示的管理后台URL、用户名和密码。

启动服务

docker compose up -d

配置反向代理

在网站配置中添加以下Nginx配置：

location ^~ / {
    proxy_pass http://127.0.0.1:7001;
    proxy_http_version 1.1;
    proxy_set_header Connection "";
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Real-PORT $remote_port;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header Scheme $scheme;
    proxy_set_header Server-Protocol $server_protocol;
    proxy_set_header Server-Name $server_name;
    proxy_set_header Server-Addr $server_addr;
    proxy_set_header Server-Port $server_port;
    proxy_cache off;
}

项目维护

版本更新

根据安装版本不同，更新命令有所差异：

新版本更新命令：

docker compose pull && \
docker compose run -it --rm web sh update.sh && \
docker compose up -d

旧版本更新命令：

git config --global --add safe.directory $(pwd)
git fetch --all && git reset --hard origin/master && git pull origin master
docker compose pull && \
docker compose run -it --rm xboard sh update.sh && \
docker compose up -d

如果不确定使用哪个命令，建议先尝试新版本命令，如果失败再使用旧版本命令。