mirror of
https://github.com/cedar2025/Xboard.git
synced 2025-02-02 15:38:14 -05:00
174 lines
3.8 KiB
Markdown
174 lines
3.8 KiB
Markdown
## Xboard 在 aaPanel 环境下的部署指南
|
||
|
||
## 目录
|
||
1. [环境要求](#环境要求)
|
||
2. [快速部署](#快速部署)
|
||
3. [详细配置](#详细配置)
|
||
4. [维护指南](#维护指南)
|
||
5. [故障排查](#故障排查)
|
||
|
||
## 环境要求
|
||
|
||
### 硬件配置
|
||
- CPU: 1核心及以上
|
||
- 内存: 2GB及以上
|
||
- 硬盘: 10GB及以上可用空间
|
||
|
||
### 软件要求
|
||
- 操作系统: Ubuntu 20.04+ / Debian 10+ (⚠️ 不建议使用 CentOS 7)
|
||
- aaPanel 最新版
|
||
- PHP 8.2
|
||
- MySQL 5.7+
|
||
- Redis
|
||
- Nginx（任意版本）
|
||
|
||
## 快速部署
|
||
|
||
### 1. 安装 aaPanel
|
||
```bash
|
||
URL=https://www.aapanel.com/script/install_6.0_en.sh && \
|
||
if [ -f /usr/bin/curl ];then curl -ksSO "$URL" ;else wget --no-check-certificate -O install_6.0_en.sh "$URL";fi && \
|
||
bash install_6.0_en.sh aapanel
|
||
```
|
||
|
||
### 2. 基础环境配置
|
||
|
||
#### 2.1 安装 LNMP 环境
|
||
在 aaPanel 面板中安装：
|
||
- Nginx（任意版本）
|
||
- MySQL 5.7
|
||
- PHP 8.2
|
||
|
||
#### 2.2 安装 PHP 扩展
|
||
必需的 PHP 扩展：
|
||
- redis
|
||
- fileinfo
|
||
- swoole4
|
||
- readline
|
||
- event
|
||
|
||
#### 2.3 解除 PHP 禁用函数
|
||
需要启用的函数：
|
||
- putenv
|
||
- proc_open
|
||
- pcntl_alarm
|
||
- pcntl_signal
|
||
|
||
### 3. 站点配置
|
||
|
||
#### 3.1 创建站点
|
||
1. 导航至：aaPanel > Website > Add site
|
||
2. 填写信息：
|
||
- 域名：填写您的站点域名
|
||
- 数据库：选择 MySQL
|
||
- PHP 版本：选择 8.2
|
||
|
||
#### 3.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 ./
|
||
|
||
# 安装依赖
|
||
sh init.sh
|
||
```
|
||
|
||
#### 3.3 配置站点
|
||
1. 设置运行目录为 `/public`
|
||
2. 添加伪静态规则：
|
||
```nginx
|
||
location /downloads {
|
||
}
|
||
|
||
location / {
|
||
try_files $uri $uri/ /index.php$is_args$query_string;
|
||
}
|
||
|
||
location ~ .*\.(js|css)?$
|
||
{
|
||
expires 1h;
|
||
error_log off;
|
||
access_log /dev/null;
|
||
}
|
||
```
|
||
|
||
## 详细配置
|
||
|
||
### 1. 配置守护进程
|
||
1. 安装 Supervisor
|
||
2. 添加队列守护进程：
|
||
- 名称：`Xboard`
|
||
- 运行用户：`www`
|
||
- 运行目录：站点目录
|
||
- 启动命令：`php artisan horizon`
|
||
- 进程数：1
|
||
|
||
### 2. 配置计划任务
|
||
- 类型：Shell Script
|
||
- 任务名：v2board
|
||
- 周期：1分钟
|
||
- 脚本内容：`php /www/wwwroot/站点目录/artisan schedule:run`
|
||
|
||
### 3. Octane 配置（可选）
|
||
#### 3.1 添加 Octane 守护进程
|
||
- 名称：Octane
|
||
- 运行用户：www
|
||
- 运行目录：站点目录
|
||
- 启动命令：`/www/server/php/81/bin/php artisan octane:start --port 7010`
|
||
- 进程数：1
|
||
|
||
#### 3.2 Octane 专用伪静态规则
|
||
```nginx
|
||
location ~* \.(jpg|jpeg|png|gif|js|css|svg|woff2|woff|ttf|eot|wasm|json|ico)$ {
|
||
}
|
||
|
||
location ~ .* {
|
||
proxy_pass http://127.0.0.1:7010;
|
||
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;
|
||
}
|
||
```
|
||
|
||
## 维护指南
|
||
|
||
### 版本更新
|
||
```bash
|
||
# 进入站点目录
|
||
cd /www/wwwroot/你的域名
|
||
|
||
# 执行更新脚本
|
||
git fetch --all && git reset --hard origin/master && git pull origin master
|
||
sh update.sh
|
||
|
||
# 如果启用了 Octane，需要重启守护进程
|
||
# aaPanel > App Store > Tools > Supervisor > 重启 Octane
|
||
```
|
||
|
||
### 日常维护
|
||
- 定期检查日志
|
||
- 监控系统资源使用情况
|
||
- 定期备份数据库和配置文件
|
||
|
||
## 故障排查
|
||
|
||
### 常见问题
|
||
1. 修改后台路径需要重启服务才能生效
|
||
2. 启用 Octane 后的任何代码修改都需要重启才能生效
|
||
3. PHP 扩展安装失败时，请检查 PHP 版本是否正确
|
||
4. 数据库连接失败时，请检查数据库配置和权限
|