搭建 – Xboard – 管理端

要求

硬件需求

• CPU：1核及以上
• 内存：2GB及以上
• 存储：10GB+ 可用空间

软件需求

• 操作系统：Ubuntu 20.04+ / Debian 10+ （⚠️不推荐使用 CentOS 7）
• aaPanel 最新版本
• PHP 8.2
• MySQL 5.7+
• 雷迪斯
• Nginx（任何版本）

快速部署

1. 安装AA面板

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
• mbstring

2.3 启用所需的PHP函数

需要启用的功能：

• putenv
• proc_open
• pcntl_alarm
• pcntl_signal

3. 站点配置

3.1 创建网站

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

3.2 部署Xboard

# 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. 将运行目录设置为/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. 安装监督
2. 添加队列守护进程：
   • 名称：Xboard
   • 运行用户：www
   • 运行目录：站点目录
   • 启动指令：php artisan horizon
   • 进程数量：1

2. 配置定时任务

• 类型：Shell Script
• 任务名称：v2board
• 运行用户：www
• 频率：1分钟
• 剧本内容：php /www/wwwroot/site-directory/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;
}

维护指南

版本更新

# Enter site directory
cd /www/wwwroot/your-domain

# Execute update script
git fetch --all && git reset --hard origin/master && git pull origin master
sh update.sh

# If Octane is enabled, restart the daemon process
# aaPanel > App Store > Tools > Supervisor > Restart Octane

例行维护

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

故障排除

常见问题

1. 管理仪表盘空：如果管理面板是空白的，运行以恢复主题文件。git submodule update --init --recursive --force
2. 管理员路径的更改需要服务重启才能生效
3. 启用Octane后的任何代码更改都需要重启才能生效
4. 当PHP扩展安装失败时，检查PHP版本是否正确
5. 对于数据库连接失败，请检查数据库配置和权限

启用WebSocket实时同步（可选）

WebSocket 支持配置的实时同步和用户对节点的变更。

1. 启动 WS 服务器

在 aaPanel Supervisor 中添加 WebSocket 守护进程：

• 姓名：Xboard-WS
• 运行用户：www
• 运行目录：站点目录
• 启动指令：php artisan ws-server start
• 进程数量：1

2. 配置 Nginx

在你网站的 Nginx 配置中，将 WebSocket 位置添加到主块之前：location ^~ /

location /ws/ {
    proxy_pass http://127.0.0.1:8076;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_read_timeout 60s;
}

3. 重启服务

在 Supervisor 中重启 Octane 和 WS 服务器进程。

节点会在握手期间自动检测WebSocket的可用性。节点端无需额外配置。