aaPanel Docker 安装 Xboard|枫叶的博客

要求

硬件要求

CPU：1核及以上
内存：2GB或以上
存储空间：10GB+可用空间

软件要求

操作系统：Ubuntu 20.04+ / CentOS 7+ / Debian 10+
最新版本的aaPanel
Docker 和 Docker Compose
Nginx（任何版本）
MySQL 5.7+

快速部署

1. 安装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

2. 基本环境设置

2.1 安装 Docker 优先使用aapanel自带的

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

# For CentOS systems, also run:
systemctl enable docker
systemctl start docker

2.2 安装所需组件

在 aaPanel 仪表板中，安装：

Nginx（任何版本）
MySQL 5.7
⚠️不需要 PHP 和 Redis

3. 站点配置

3.1 创建网站

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

3.2 部署Xboard

# Enter site directory
cd /www/wwwroot/your-domain

# Clean directory
chattr -i .user.ini
rm -rf .htaccess 404.html 502.html index.html .user.ini

# Clone repository
git clone https://github.com/cedar2025/Xboard.git ./

# Prepare configuration file
cp compose.sample.yaml compose.yaml

# Install dependencies and initialize
docker compose run -it --rm web sh init.sh

⚠️请保存安装后显示的管理仪表板 URL、用户名和密码

3.3 启动服务

docker compose up -d

3.4 配置反向代理

将以下内容添加到您的站点配置中：

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

对于较旧的安装，请替换web为xboard：

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