Xboard/docs/aapanel+docker安装指南.md
xboard 4728784d1f fix: frontend styling and bug fixes, update deployment docs
- Fix class styling issues and adjust UI components
- Fix various minor bugs across the application
- Update deployment documentation with improved instructions
2025-01-07 12:41:52 +08:00

2.1 KiB
Raw Blame History

aaPanel + Docker 快速部署指南

本指南介绍如何使用 aaPanel + Docker Compose 部署 Xboard。

1. 环境准备

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

# CentOS 系统需要执行:
systemctl enable docker
systemctl start docker
  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. 环境配置

在 aaPanel 中安装 LNMP

  • Nginx任意版本
  • MySQL 5.7
  • ⚠️ 无需安装 PHP 和 Redis

3. 部署步骤

  1. 添加站点:

    • 进入 aaPanel > Website > Add site
    • 域名:填写你的域名
    • 数据库:选择 MySQL
    • PHP 版本:选择纯静态
  2. 安装 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

安装完成后请保存返回的后台地址和管理员账号密码

  1. 启动服务:
docker compose up -d
  1. 配置反向代理:
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;
}

4. 版本更新

docker compose pull && docker compose up -d

注意事项

  • ⚠️ 请确保防火墙已开启,避免 7001 端口暴露到公网
  • 代码修改后需要重启服务才能生效
  • 建议配置 SSL 证书以确保安全访问