Xboard 是一个基于 Laravel 11 构建的现代面板系统，专注于提供干净、高效的用户体验。

Xboard Github：https://github.com/cedar2025/Xboard

本篇文章以 aaPanel (宝塔国际版) 面板安装为教学，其他环境可参照 Github 官方文档。

• CPU：4核及以上

• 内存：4GB或以上

• 存储空间：40GB+可用空间 

• 操作系统：Ubuntu 20.04+ / CentOS 7+ / Debian 10+

• 最新版本的aaPanel

• Docker 和 Docker Compose

• Nginx（任何版本）

• MySQL 5.7+

Ps：Xboard 不依赖 PHP 环境运行，所以非必须安装 PHP 也可运行，操作系统推荐使用 Ubuntu 22.04，不推荐使用市面上廉价 VPS 进行搭建，因为超开会导致性能严重不足，并且便宜的 VPS 线路也不怎么样，提前做好充足准备以免后续使用时想更换服务器又比较繁琐。

curl -sSL https://www.aapanel.com/script/install_6.0_en.sh -o install_6.0_en.sh && \
bash install_6.0_en.sh aapanel

也可以自行安装宝塔国内版、小皮面板等，后续操作步骤大同类似。

# Install Dockercurl -sSL https://get.docker.com | bash# For CentOS systems, also run:systemctl enable docker
systemctl start docker

在 aaPanel 仪表板中，安装：

• Nginx（任何版本）

• MySQL 5.7

• 不需要 PHP 和 Redis

• 3. 站点配置

• 3.1 创建网站

• 导航至：aaPanel > 网站 > 添加站点

• 填写信息：

• 域名：输入您的网站域名

• 数据库：选择 MySQL

• PHP版本：选择纯静态

• 3.2 部署Xboard

• # Enter site directorycd /www/wwwroot/your-domain# Clean directorychattr -i .user.ini
  rm -rf .htaccess 404.html 502.html index.html .user.ini# Clone repositorygit clone https://github.com/cedar2025/Xboard.git ./# Prepare configuration filecp compose.sample.yaml compose.yaml# Install dependencies and initializedocker compose run -it --rm web sh init.sh

  ⚠️

  请保存安装后显示的管理仪表板 URL、用户名和密码

• 3.3 启动服务

• docker compose up -d

• 3.4 配置反向代理

• 将以下内容添加到您的站点配置中：

• location ^~ / {    proxy_pass http://127.0.0.1:7001;    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;    proxy_cache off;
  }

• 故障排除

• 如果您在安装或操作过程中遇到任何问题，请检查：

• 满足系统要求

• 所有必需端口均可用

• Docker服务正常运行

• Nginx配置正确

• 检查日志以获取详细的错误消息