Xboard搭建 - 斯凯维斯

步骤一：安装 aaPanel（国际版）

SSH 登录服务器，运行：

# 更新系统（可选但推荐）
apt update && apt upgrade -y

安装

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

浏览器访问 http://你的IP:8888 登录（记录账号密码）。

步骤二：安装 Docker & 必要组件

安装 Docker（一键脚本）：

curl -sSL https://get.docker.com | bash

CentOS/Debian 用户额外执行：

systemctl enable docker --now

验证：docker --version 看到版本即成功。

aaPanel 面板中安装：

Nginx（任意版本，推荐最新）
MySQL 5.7+（或 MariaDB 10.x）

重要：无需安装 PHP、Redis、Composer 等！Docker 容器自带一切依赖。

步骤三：创建站点（纯静态）

aaPanel → 网站 → 添加站点：

域名：你的主域名（e.g. airport.example.com）
根目录：默认（/www/wwwroot/你的域名）
PHP 版本：纯静态（无 PHP 运行环境）
数据库：勾选 MySQL，自动创建（记下用户名/密码/数据库名）

步骤四：部署 Xboard（Docker 方式）

进入站点根目录：

cd /www/wwwroot/你的域名

清空默认文件（防冲突）：

chattr -i .user.ini  # 如果有 i 属性

rm -rf .htaccess 404.html 502.html index.html .user.ini *

克隆仓库（使用 compose 分支或 master，根据官方最新）：

git clone https://github.com/cedar2025/Xboard.git ./

准备 compose 文件：

cp compose.sample.yaml compose.yaml

初始化 & 安装（交互式，关键一步）：

docker compose run -it --rm web sh init.sh

按提示填写 MySQL 连接（用 aaPanel 创建的数据库信息：主机 127.0.0.1、端口 3306、用户名/密码/数据库名）
设置管理员账号（邮箱 + 密码 + 昵称）
完成后务必保存 显示的后台 URL、用户名、密码（通常后台在 /admin 或自定义路径）

启动所有容器：

docker compose up -d

步骤五：配置 Nginx 反向代理（aaPanel 必设）

aaPanel → 该站点 → 配置 → 在 配置文件 中添加以下 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;
}

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

保存 → 重启 Nginx。

开启 HTTPS（强烈推荐）：用 aaPanel SSL → Let’s Encrypt 或 Cloudflare 证书。

步骤六：验证 & 访问

用户端：https://你的域名（看到登录/注册页即成功）
后台：https://你的域名/admin （或安装时显示的路径），用刚才设置的管理员登录

/ws/ 路径默认支持节点实时同步（WebSocket），可在后台 > 系统设置 > 服务器中开关。

维护指南（日常操作）

版本更新（推荐方式，适用于新版安装）：

docker compose pull && \
docker compose run -it --rm web sh update.sh && \
docker compose up -d

若提示失败，尝试旧版兼容命令：

git fetch --all && git reset --hard origin/master && git pull && \
docker compose pull && \
docker compose run -it --rm xboard sh update.sh && \
docker compose up -d

日常运维：

查看日志：docker compose logs -f
监控资源：aaPanel 系统监控或 docker stats
备份：定期导出 MySQL 数据库 + 备份 compose.yaml 和 /www/wwwroot/你的域名目录

故障排除速查

容器启动失败 → 检查 docker compose logs，常见：端口冲突（7001/8076）、MySQL 连接错
502/504 → 确认 Nginx proxy_pass 指向正确，Docker 服务 running
WebSocket 节点不同步 → 后台检查 ws-server 是否启用，端口 8076 是否通
权限问题 → 极少见，Docker 已隔离
所有端口可用：ufw/firewall 放行 80/443 + Docker 内部端口

完成！ 你的 Xboard 机场已用官方最高成功率方式上线。Docker 方式维护成本低，升级顺滑。

aapanel卸载

wget http://download.bt.cn/install/bt-uninstall.sh
sh bt-uninstall.sh