tcjlj/Xboard
1
0
Fork 0
mirror of https://github.com/cedar2025/Xboard.git synced 2025-01-23 02:58:14 -05:00
Code Issues Actions 2 Packages Projects Releases Wiki Activity
4728784d1f
Xboard/docs/aapanel安装指南.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

3.4 KiB
Raw Blame History

aaPanel 快速部署指南

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

⚠️ 不建议在 CentOS 7 上部署，可能会遇到兼容性问题。

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. 环境配置

  1. 在 aaPanel 中安装 LNMP：

    • Nginx（任意版本）
    • MySQL 5.7
    • PHP 8.1

  2. 安装 PHP 扩展：

    • redis
    • fileinfo
    • swoole4
    • readline
    • event

  3. 解除 PHP 禁用函数：

    • putenv
    • proc_open
    • pcntl_alarm
    • pcntl_signal

3. 部署步骤

  1. 添加站点：

    • 进入 aaPanel > Website > Add site
    • 填写域名
    • 数据库选择 MySQL
    • PHP 版本选择 8.1

  2. 安装 Xboard：

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

# 清理目录
chattr -i .user.ini
rm -rf .htaccess 404.html 502.html index.html .user.ini

# 克隆代码
git clone -b new https://github.com/cedar2025/Xboard.git ./

# 安装依赖
sh init.sh
  1. 配置站点：
    • 设置运行目录为 /public
    • 配置伪静态规则：
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. 配置守护进程：

    • 安装 Supervisor
    • 添加队列守护进程：
      • 名称：Xboard
      • 运行用户：www
      • 运行目录：站点目录
      • 启动命令：php artisan horizon
      • 进程数：1

  2. 添加计划任务：

    • 类型：Shell Script
    • 任务名：v2board
    • 周期：1分钟
    • 脚本内容：php /www/wwwroot/站点目录/artisan schedule:run

4. 开启 Octane（可选）

  1. 配置 PHP：
cp /www/server/php/81/etc/php.ini cli-php.ini
sed -i 's/^disable_functions[[:space:]]*=[[:space:]]*.*/disable_functions=header,header_remove,headers_sent,http_response_code,setcookie,session_create_id,session_id,session_name,session_save_path,session_status,session_start,session_write_close,session_regenerate_id,set_time_limit/g' cli-php.ini

  1. 添加 Octane 守护进程：

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

  2. 更新伪静态规则：

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

5. 版本更新

# 更新代码
cd /www/wwwroot/你的域名
sh update.sh

# 如果启用了 Octane，需要重启守护进程
# aaPanel > App Store > Tools > Supervisor > 重启 Octane

注意事项

  • 修改后台路径需要重启服务才能生效
  • 启用 octane 后的任何代码修改都需要重启才能生效