![图片[1]-Xboard 宝塔部署教程:从环境准备到后台上线(禁止使用在违法业务,只适用于个人使用)-雾祈心语](https://bkm.mistora.cc/wp-content/uploads/2026/11/image-52-1024x574.png)
一、Xboard 是什么?
Xboard 是一套带有用户中心和订阅管理功能的面板,通常包含:
- 用户注册与登录
- 套餐和订阅管理
- 流量统计
- 订单管理
- 邀请奖励
- 工单系统
- 管理员后台
- 节点和订阅接口对接
它的页面形态比单纯的节点管理面板更接近商业化用户中心。
二、服务器环境要求
建议使用:
- Ubuntu 22.04 或 Debian 12
- 1 核 2 GB 内存以上
- PHP 8.1 或 8.2
- MySQL 5.7 或 8.0
- Redis
- Nginx
- Git
- Composer
- 一个已经解析到服务器的域名
服务器部署时,要确认:
- 域名已经解析到服务器 IP;
- 宝塔安全组放行 80 和 443 端口;
- 云服务器控制台安全组也放行 80 和 443;
- 服务器时间和时区正确。
三、在宝塔中安装环境
打开宝塔面板,进入「软件商店」,安装:
- 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
首次进入后,依次配置:
- 管理员账号;
- 站点名称和 Logo;
- 用户注册设置;
- 套餐和订阅规则;
- 邮件服务;
- 支付接口;
- 订阅地址;
- 定时任务;
- 自动备份。
十三、常见问题
页面显示 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
→ 完成后台初始化
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!

















暂无评论内容