1 配置要求
1.1 硬件要求
- CPU:单核或以上
- 内存:2GB 或以上
- 存储空间:10GB以上可用空间
1.2 软件需求
- 操作系统:Ubuntu 20.04+ / Debian 10+ (⚠️不建议使用 CentOS 7)
- 最新版本的aaPanel
- PHP 8.2+
- MySQL 5.7+
- Redis
- Nginx(任何版本)
2 快速部署
2.1 安装 aaPanel
2.2 安装 LNMP 环境
在 aaPanel 控制面板中,安装:
- Nginx(任何版本)
- MySQL 5.7
- PHP 8.2
2.3 安装 PHP 扩展(必需的PHP扩展)
在aaPanel中打开PHP程序管理,找到扩展安装,并逐个安装
- redis
- fileinfo
- swoole
- readline
- event
- mbstring
2.4 启用所需的 PHP 函数
在PHP程序管理中找到函数禁用,并删除下述函数的禁用
- putenv
- proc_open
- pcntl_alarm
- pcntl_signal
2.5 创建网站
- 导航至:aaPanel > 网站 > 添加站点
- 请填写以下信息:
- 域名:请输入您的网站域名
- 数据库:选择 MySQL
- PHP 版本:选择 8.2+
2.6 配置站点
打开aaPanel站点设置,并进行下方设置
- 解析域名并申请SSL证书
- 设置运行目录
/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;
}
2.7 部署 Xboard
在服务器运行下述代码,并按照要求填写对应的Mysql等信息,Redis可按照默认参数
# Enter site directory
cd /www/wwwroot/your-domain
# Clean directory
chattr -i .user.ini
rm -rf .htaccess 404.html 502.html index.html .user.ini
# Clone repository
git clone https://github.com/cedar2025/Xboard.git ./
# Install dependencies
sh init.sh
部署后会获得对应的 前后台登录地址 以及 管理员账号密码,请记下来并打开按需设置。
3 后续配置
3.1 配置守护进程
- 安装 Supervisor (在aaPanel 面板软件商店进行安装)
- 添加队列守护进程:
- 姓名:
Xboard - 运行用户:
www - 运行目录:站点目录
- 启动命令:
php artisan horizon - 进程数:1
- 姓名:
3.2 配置计划任务
在aaPanelz 计划任务中,按照下述内容添加一条定时任务(流量重置等全靠它)
- 类型:Shell脚本
- 任务名称:v2board
- 运行用户:www
- 频率:1分钟
- 脚本内容:
php /www/wwwroot/site-directory/artisan schedule:run
3.3 Octane配置(可选)
3.3.1 添加 Octane 守护进程
- 名称:辛烷
- 运行用户:www
- 运行目录:站点目录
- 启动命令:
/www/server/php/82/bin/php artisan octane:start --port 7010 - 进程数:1
3.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;
}
4 其他
4.1 日常维护
- 定期日志检查
- 监控系统资源使用情况
- 定期备份数据库和配置文件
4.2 常见问题
- 对管理路径的更改需要重启服务才能生效。
- 启用 Octane 后所做的任何代码更改都需要重启才能生效。
- PHP扩展安装失败时,请检查PHP版本是否正确。
- 如果数据库连接失败,请检查数据库配置和权限。













