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

[up主专用，视频内嵌代码贴在这]

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

目标：用一台 VPS + 源码方式快速上线一个现代、稳定的 Xboard 机场面板（支持 VLESS/Reality 等新协议，持续更新维护，比旧 V2board 更可靠）。

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

  • 域名注册：优先选 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 分钟（视服务器性能）

前置准备

  1. 一台干净的 Ubuntu 22.04 / 24.04 VPS（推荐 ≥2核4G 内存）
  2. 已解析好的域名（建议用 Cloudflare 管理 DNS，开启橙色小云朵代理）
  3. SSH 工具：FinalShell / Xshell / Termius（推荐 FinalShell：https://www.hostbuf.com/t/988.html ）
  4. 基础知识：会简单复制粘贴命令即可

第一步：安装宝塔 aaPanel（国际版）

登录服务器 SSH，依次运行：

1
2
# 更新系统（可选但推荐）
apt update && apt upgrade -y
1
2
3
4
5
# 一键安装 aaPanel 国际版
URL=https://www.aapanel.com/script/install_7.0_en.sh && \
if [ -f /usr/bin/curl ]; then curl -ksSO "$URL"; \
else wget --no-check-certificate -O install_7.0_en.sh "$URL"; fi && \
bash install_7.0_en.sh aapanel

安装完成后，浏览器访问提示的地址（通常是 http://你的IP:8888），记录好用户名/密码/入口地址。

第二步：配置服务器基础环境

在 aaPanel 面板左侧菜单：

  • 软件商店 → 安装以下组件（选最新稳定版）：

    • Nginx（推荐 1.24+）
    • MySQL / MariaDB（推荐 MariaDB 10.11 或 MySQL 8.0）
    • PHP（必须选 8.3）
    • Redis（默认端口 6379，无密码即可）
    • phpMyAdmin（可选，用于可视化管理数据库）

  • PHP-8.3 设置 → 安装扩展（搜索并勾选）：

    • fileinfo
    • redis
    • mbstring
    • igbinary

  • PHP-8.3 设置 → 禁用函数（在“禁用函数”框中添加）：

    1
    putenv,proc_open

全部设置完 → 保存 → 重启 PHP。

第三步：创建网站和数据库

  1. aaPanel → 网站 → 添加站点

    • 域名：填你的主域名（例如 airport.mydomain.com）
    • 根目录：默认即可（/www/wwwroot/你的域名）

  2. 数据库 标签 → 添加数据库

    • 数据库名：随便起（例如 xboard_db）
    • 用户名/密码：记下来，后面要用

第四步：拉取并部署 Xboard 源码

先清空网站根目录下所有默认文件（重要！）：

1
2
cd /www/wwwroot/你的域名
rm -rf *

然后克隆最新源码（官方 GitHub：https://github.com/cedar2025/Xboard ）：

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

第五步：安装 Composer 依赖（使用 PHP 8.3 执行）

如果服务器没 composer，先全局安装：

1
2
3
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
chmod +x /usr/local/bin/composer

然后用 PHP 8.3 运行（注意路径）：

1
/www/server/php/83/bin/php /usr/local/bin/composer install --no-dev --optimize-autoloader

（这一步可能需要几分钟，耐心等待）

第六步：配置 .env 环境文件

复制示例文件：

1
cp .env.example .env

用 aaPanel 文件管理器或 vi 编辑 .env，重点修改以下几项：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
APP_NAME="My Airport Panel"
APP_ENV=production                    # 注意这个改成production
APP_DEBUG=false
APP_URL=https://你的域名               # 必须是 https

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=xboard_db                 # 你创建的数据库名
DB_USERNAME=你的数据库用户名
DB_PASSWORD=你的数据库密码

REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null                   # 默认无密码
REDIS_PORT=6379

CACHE_DRIVER=redis
QUEUE_CONNECTION=redis
SESSION_DRIVER=redis

保存后执行：

1
2
/www/server/php/83/bin/php artisan key:generate
/www/server/php/83/bin/php artisan config:cache

第七步：权限调整（超级重要，避免 500 错误）

1
2
3
4
chown -R www:www .
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
chmod -R 775 storage bootstrap/cache

第八步：网站配置优化

在 aaPanel 该站点 → 设置：

  • 运行目录 → 改为 /public
  • 伪静态 → 选择 Nginx，粘贴以下规则：
1
2
3
location / {
    try_files $uri $uri/ /index.php?$query_string;
}
  • SSL → 用 Let’s Encrypt 或 Cloudflare 免费证书开启 HTTPS（强烈推荐）

保存 → 重启 Nginx + PHP。

第九步：运行安装向导

执行命令（用 PHP 8.3）：

1
/www/server/php/83/bin/php artisan xboard:install

按提示输入：

  • 是否用 SQLite？ → no（推荐 MySQL 更稳定）
  • 数据库主机 → 127.0.0.1
  • 端口 → 3306
  • 数据库名/用户名/密码 → 刚才创建的
  • Redis → 默认 127.0.0.1:6379（无密码回车）
  • 设置管理员邮箱、密码、昵称（用于登录后台）

安装完成后会显示后台地址（通常是 https://你的域名/admin），记下来！

第十步：验证 & 后续建议

  1. 浏览器访问 https://你的域名 → 应该看到用户注册/登录页面
  2. 用管理员账号登录后台（/admin） → 配置节点、套餐、支付等
  3. 常见坑点速查：
    • 500 错误 → 检查权限、.env 是否正确、Redis 是否运行
    • 订阅不生效 → 确保节点已对接（XrayR / V2bX 等后端）
    • 邮件不发 → 后台设置 SMTP

完成！ 你的 Xboard 机场面板已就绪，可继续添加节点、支付接口、主题美化等。