Xboard 宝塔部署教程:从环境准备到后台上线(禁止使用在违法业务,只适用于个人使用)

图片[1]-Xboard 宝塔部署教程:从环境准备到后台上线(禁止使用在违法业务,只适用于个人使用)-雾祈心语

      一、Xboard 是什么?

      Xboard 是一套带有用户中心和订阅管理功能的面板,通常包含:

      • 用户注册与登录
      • 套餐和订阅管理
      • 流量统计
      • 订单管理
      • 邀请奖励
      • 工单系统
      • 管理员后台
      • 节点和订阅接口对接

      它的页面形态比单纯的节点管理面板更接近商业化用户中心。

      二、服务器环境要求

      建议使用:

      • Ubuntu 22.04 或 Debian 12
      • 1 核 2 GB 内存以上
      • PHP 8.1 或 8.2
      • MySQL 5.7 或 8.0
      • Redis
      • Nginx
      • Git
      • Composer
      • 一个已经解析到服务器的域名

      服务器部署时,要确认:

      1. 域名已经解析到服务器 IP;
      2. 宝塔安全组放行 80 和 443 端口;
      3. 云服务器控制台安全组也放行 80 和 443;
      4. 服务器时间和时区正确。

      三、在宝塔中安装环境

      打开宝塔面板,进入「软件商店」,安装:

      • Nginx
      • MySQL
      • PHP 8.1 或 PHP 8.2
      • Redis
      • Git
      • Composer

      进入 PHP 设置,安装以下扩展:

      fileinfo
      openssl
      pdo_mysql
      mbstring
      tokenizer
      xml
      curl
      zip
      bcmath
      redis

      建议调整 PHP 配置:

      memory_limit = 256M
      upload_max_filesize = 50M
      post_max_size = 50M

      四、创建网站和数据库

      在宝塔中创建一个网站,例如:

      panel.example.com

      创建 MySQL 数据库,并记录:

      • 数据库名
      • 数据库用户名
      • 数据库密码
      • 数据库端口

      然后申请 SSL 证书并开启 HTTPS。

      五、下载 Xboard 源码

      进入宝塔终端:

      cd /www/wwwroot
      git clone https://github.com/cedar2025/Xboard.git xboard
      cd /www/wwwroot/xboard

      如果官方仓库调整了地址或分支,应以仓库 README 中的安装说明为准。

      六、安装项目依赖

      cd /www/wwwroot/xboard
      composer install --no-dev --optimize-autoloader

      如果提示找不到 Composer,可以在宝塔软件商店安装 Composer 后重试。

      七、配置环境变量

      复制环境文件:

      cp .env.example .env

      生成应用密钥:

      php artisan key:generate

      编辑 .env:

      APP_ENV=production
      APP_DEBUG=false
      APP_URL=https://panel.example.com
      
      DB_CONNECTION=mysql
      DB_HOST=127.0.0.1
      DB_PORT=3306
      DB_DATABASE=xboard
      DB_USERNAME=xboard
      DB_PASSWORD=修改为数据库密码
      
      REDIS_HOST=127.0.0.1
      REDIS_PASSWORD=null
      REDIS_PORT=6379

      请把示例域名、数据库名和密码替换成实际值。

      八、初始化数据库

      php artisan migrate --force
      php artisan db:seed --force

      如果当前 Xboard 版本提供专用安装命令,应优先使用官方文档中的命令。

      然后清理缓存:

      php artisan config:clear
      php artisan cache:clear
      php artisan route:clear
      php artisan view:clear

      九、配置宝塔网站目录

      进入「网站 → 设置」:

      • 网站目录:
      /www/wwwroot/xboard/public
      • 运行目录:
      /
      • PHP 版本:选择项目要求的版本
      • SSL:开启
      • 强制 HTTPS:开启

      Laravel 伪静态可使用:

      location / {
          try_files $uri $uri/ /index.php?$query_string;
      }

      十、设置目录权限

      chown -R www:www /www/wwwroot/xboard
      chmod -R 755 /www/wwwroot/xboard
      chmod -R 775 /www/wwwroot/xboard/storage
      chmod -R 775 /www/wwwroot/xboard/bootstrap/cache

      十一、配置定时任务

      进入宝塔「计划任务」,新增 Shell 脚本:

      cd /www/wwwroot/xboard && php artisan schedule:run

      执行周期设置为:

      每分钟

      如果项目使用队列,再添加队列进程:

      cd /www/wwwroot/xboard && php artisan queue:work --sleep=3 --tries=3

      生产环境建议使用 Supervisor 或宝塔进程守护,避免队列进程意外退出。

      十二、首次访问后台

      浏览器访问:

      https://panel.example.com

      首次进入后,依次配置:

      1. 管理员账号;
      2. 站点名称和 Logo;
      3. 用户注册设置;
      4. 套餐和订阅规则;
      5. 邮件服务;
      6. 支付接口;
      7. 订阅地址;
      8. 定时任务;
      9. 自动备份。

      十三、常见问题

      页面显示 404

      检查:

      • 网站目录是否指向 public;
      • 是否配置 Laravel 伪静态;
      • Nginx 配置是否保存并重载。

      页面显示 502

      检查:

      • PHP-FPM 是否运行;
      • PHP 版本是否符合项目要求;
      • PHP 扩展是否完整;
      • 网站用户权限是否正确。

      数据库连接失败

      检查 .env:

      DB_HOST=127.0.0.1
      DB_PORT=3306
      DB_DATABASE=数据库名
      DB_USERNAME=数据库用户
      DB_PASSWORD=数据库密码

      修改后执行:

      php artisan config:clear
      php artisan cache:clear

      队列没有执行

      检查:

      • Redis 是否正常运行;
      • 宝塔计划任务是否启用;
      • queue:work 是否被系统终止;
      • Supervisor 日志是否有报错。

      修改配置后页面没有变化

      执行:

      php artisan optimize:clear

      然后重启 PHP-FPM 和 Nginx。

      十四、安全建议

      部署完成后建议立即处理:

      • 删除或保护安装文件;
      • 关闭 APP_DEBUG;
      • 后台使用独立域名;
      • 管理员密码使用随机长密码;
      • 限制数据库远程访问;
      • 定期备份数据库和 .env;
      • 不要把 .env、订阅链接和支付密钥上传到公开仓库;
      • 定期查看 Xboard 官方仓库的 Issue 和安全更新。

      总结

      使用宝塔部署 Xboard 的基本流程是:

      安装环境
      → 创建网站和数据库
      → 下载源码
      → 安装 Composer 依赖
      → 配置 .env
      → 初始化数据库
      → 设置 public 目录
      → 配置伪静态
      → 添加定时任务
      → 开启 HTTPS
      → 完成后台初始化

      © 版权声明
      THE END
      喜欢就支持一下吧
      点赞11 分享
      评论 抢沙发

      请登录后发表评论

        暂无评论内容