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

93 lines
2.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## aaPanel + Docker 快速部署指南
本指南介绍如何使用 aaPanel + Docker Compose 部署 Xboard。
### 1. 环境准备
1. 安装 Docker
```bash
# 安装 Docker
curl -sSL https://get.docker.com | bash
# CentOS 系统需要执行:
systemctl enable docker
systemctl start docker
```
2. 安装 aaPanel
```bash
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
```bash
# 进入站点目录
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
```
> 安装完成后请保存返回的后台地址和管理员账号密码
3. 启动服务:
```bash
docker compose up -d
```
4. 配置反向代理:
```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;
}
```
### 4. 版本更新
```bash
docker compose pull && docker compose up -d
```
### 注意事项
- ⚠️ 请确保防火墙已开启,避免 7001 端口暴露到公网
- 代码修改后需要重启服务才能生效
- 建议配置 SSL 证书以确保安全访问