2026年 Xboard 机场面板完整部署指南（aaPanel + 手动源码方式

2026年 Xboard 机场面板零基础部署指南（隐私优先版）

为什么选 aaPanel + Docker？
官方明确标注为 推荐方式（Recommended），相比纯源码或纯 Docker Compose，结合 aaPanel 的 Nginx 管理 + Docker 的容器化，配置简单、反向代理稳、维护轻松。新手成功率最高，几乎零依赖冲突。

隐私 & 支付推荐（机场业务常用配置）：

  • 域名注册：优先选 Spaceship（Namecheap 旗下新品牌，价格实惠，免费终身 WHOIS 隐私保护，隐藏个人信息防骚扰/泄露）。
    注册链接（含优惠/返佣）：
    👉 https://spaceship.sjv.io/limin
    优势：.com/.net 等主流 TLD 便宜，自动隐私保护（WHOIS 显示匿名信息），适合不想暴露身份的用户。
    注意：正常注册无需实名，但若触发风控（如批量注册/可疑行为），可能要求额外验证（KYC）。建议用干净邮箱 + VPN 注册。

  • 收款方式：加密货币直收（避免银行卡/支付宝风控）。
    推荐用币安（Binance）账户接收 USDT/TRC20 等主流币。
    注册链接（含返佣，交易手续费更低）：
    👉 https://www.bsmkweb.cc/register?ref=D7RFFB5M
    邀请码：D7RFFB5M
    优势：全球最大交易所，P2P/充值提现方便，支持多种链上收款。机场用户常用 USDT 支付订阅，币安到账快、手续费低。
    提示：注册后开启 2FA 安全，建议用独立钱包地址对接面板支付接口。

服务器推荐（低延迟、性价比高）：
Vultr VPS（东京/新加坡节点最适合亚洲用户）
👉 https://www.vultr.com/?ref=9661692 （新人 $100+ 免费额度，选 2核4G + Ubuntu 24.04 起步）

预计耗时：30–60 分钟（视服务器性能）

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

SSH 登录服务器，运行：

1
2
3
4
5
# 更新系统（可选但推荐）
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 & 必要组件

  1. 安装 Docker（一键脚本）：
1
curl -sSL https://get.docker.com | bash

CentOS/Debian 用户额外执行：

1
systemctl enable docker --now

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

  1. 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 方式）

进入站点根目录：

1
cd /www/wwwroot/你的域名

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

1
2
chattr -i .user.ini  # 如果有 i 属性
rm -rf .htaccess 404.html 502.html index.html .user.ini *

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

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

准备 compose 文件：

1
cp compose.sample.yaml compose.yaml

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

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

启动所有容器：

1
docker compose up -d

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

aaPanel → 该站点 → 配置 → 在 配置文件 中添加以下 location（替换默认内容或追加）：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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），可在后台 > 系统设置 > 服务器 中开关。

维护指南（日常操作）

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

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

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

1
2
3
4
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 方式维护成本低，升级顺滑。需要对接 Hysteria2/Reality 节点、支付插件、主题美化等进阶教程，继续问我。祝机场大卖！🚀