2026年使用宝塔搭建V2Board/Xboard最新教程

前言

V2board官方项目地址：https://github.com/v2board/v2board
Xboard官方项目地址：https://github.com/cedar2025/Xboard/
官方教程
V2board：https://docs.v2board.com/deploy/aapanel.html
Xboard：https://github.com/cedar2025/Xboard/blob/master/docs/en/installation/aapanel.md
萌知经实测验证，由于长期未更新，官方教程存在部分问题，例如要求的 PHP 7.4 版本过低，导致依赖安装失败。本文提供的安装流程经过实际验证，可确保顺利完成安装。
注：本文操作步骤适用于具备一定网站建设经验的开发者，不建议零基础用户直接尝试。V2Board目前长期未更新，目前建议使用其衍生的Xboard，本文供参考学习用。

Xboard 和 V2board 的关系

Xboard 面板和 V2board 面板是继承与演进（前身与后继者）的关系。简单来说：Xboard 是基于 V2board 深度二次开发并进行现代化重构的高性能分支，安装步骤类似程度80%以上。

V2board： 曾是网络代理和多协议订阅管理系统中最主流、最经典的“老牌”面板。但由于其原作者很长一段时间不再更新，且原代码在面对更新的协议、更高的并发时逐渐显得有些力不从心，社区开始出现各种分支（Fork）。
Xboard： 正是在 V2board 停更后，由开源社区开发者（如 cedar2025 等）接手，基于 V2board 最后的稳定版本进行大量重构和升级而诞生的“现代版”面板。

安装宝塔面板

宝塔面板官方安装指令：

if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

进入面板后，选择使用LNMP的环境安装方式勾选如下信息

Nginx 1.17
MySQL 5.6
PHP 8.2 （官方教程为7.4，萌知亲测版本太低无法成功安装依赖）

选择 Fast 快速编译后进行安装。

PHP设置

找到PHP 8.2点击设置 > 安装扩展 > redis、fileinfo 进行安装。
解除禁用函数，PHP 8.2点击设置 > Disabled functions 将 putenv proc_open pcntl_alarm pcntl_signal 从列表中删除。

添加网站

在域名填入你指向服务器的域名
在数据库选择MySQL
PHP版本选择PHP-82
为便于以后访问，请申请SSL证书，开启https访问

安装V2Board

宝塔文件管理，删除网站目录下的文件，必须保证文件夹为空，否则后续步骤无法成功
通过SSH面板访问服务器，通过cd命令进入网站文件夹，注意修改域名为你自己的
```
cd /www/wwwroot/你的站点域名
```
执行命令从 Github 克隆到当前目录
想要安装V2board，使用下述代码：
```
git clone https://github.com/v2board/v2board.git ./
```
想要安装Xboard，使用下述代码：
```
git clone https://github.com/cedar2025/Xboard.git ./
```
执行命令安装依赖包以及V2board。PHP版本不能过低（建议>8.1），且必须保证fileinfo扩展成功安装，否则无法成功安装依赖
```
sh init.sh
```
进度完成后，按实际输入数据库信息，保存好V2Board/Xboard后台管理面板信息

配置站点目录及伪静态

添加完成后编辑添加的站点 >网站目录> 选择 /public 保存。并关闭防跨站攻击，否则网站无法正常访问。
添加完成后编辑添加的站点 > URL rewrite 填入伪静态信息。

location /downloads {
}
location / { 
try_files $uri $uri/ /index.php$is_args$query_string; 
}
location ~ .*\.(js|css)?$
{
expires 1h;
error_log off;
access_log /dev/null; 
}

后台演示

完成以上步骤后，网站可以正常访问了，面板截图如下。

V2Board

V2board后台界面

Xboard

Xboard用户界面

Xboard用户登录界面

Xboard后台登录界面

Xboard后台管理界面

配置定时任务

宝塔面板 > 计划任务，按照以下信息添加每1分钟执行一次的定时任务。

任务类型：Shell脚本
任务名称：v2board
执行周期：1分钟
脚本内容：php /www/wwwroot/路径/artisan schedule:run

启动队列服务

V2board的系统强依赖队列服务，正常使用V2Board必须启动队列服务。下面以宝塔面板中“进程守护管理器”（英文：supervisor）来作为演示。

宝塔面板 > 软件商店，找到“进程守护管理器”进行安装，安装完成后点击 设置 > 添加守护进程 按照如下填写，填写后点击确认添加即可运行。

名称：V2board
启动用户：www
运行目录：选择为刚创建的网站目录
启动命令：php artisan horizon
进程数量：1

声明：1、本站大部分资源均为网络采集所得，仅供用来学习研究，请于下载后的24h内自行删除，正式商用请购买正版。2、如若本站内容侵犯了原著者的合法权益，请携带相关版权文件联系我们进行下架或删除。3、虚拟下载类资源具有可复制性，一经下载后本站有权拒绝退款或更换其他商品！