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

      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
      • swoole
      • readline
      • event

      2.3 启用必要的 PHP 函数

      需要启用的函数:

      • putenv
      • proc_open
      • pcntl_alarm
      • pcntl_signal

      3. 站点配置

      3.1 创建网站

      1. 导航至: aaPanel > 网站 > 添加站点
      2. 填写信息:
        • 域名: 输入您的站点域名
        • 数据库: 选择 MySQL
        • PHP 版本: 选择 8.2

      3.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 ./

# 安装依赖
sh init.sh

      3.3 配置站点

      1. 设置运行目录为 /public
      2. 添加重写规则:
      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 脚本
      • 任务名称: v2board
      • 运行用户: www
      • 执行周期: 1分钟
      • 脚本内容: php /www/wwwroot/站点目录/artisan schedule:run

      3. Octane 配置 (可选)

      3.1 添加 Octane 守护进程

      • 名称: Octane
      • 运行用户: www
      • 运行目录: 站点目录
      • 启动命令: /www/server/php/82/bin/php artisan octane:start --port 7010
      • 进程数量: 1

      3.2 Octane 专用重写规则

      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;
}

      维护指南

      版本更新

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

# 执行更新脚本
git fetch --all && git reset --hard origin/master && git pull origin master
sh update.sh

# 如果启用了 Octane，需重启守护进程
# aaPanel > 应用商店 > 工具 > Supervisor > 重启 Octane

      日常维护

      • 定期检查日志
      • 监控系统资源使用情况
      • 定期备份数据库和配置文件

      故障排除

      常见问题

      1. 管理员路径修改后需要重启服务才能生效
      2. 启用 Octane 后任何代码变更都需要重启才能生效
      3. PHP 扩展安装失败时，请检查 PHP 版本是否正确
      4. 数据库连接失败时，请检查数据库配置和权限