v2board

By | 2026-06-27

1、如果你“坚持”非要用 PHP 7.4 安装，怎么解决？
如果你因为某些原因（比如服务器上还有其他老网站）绝对不想升级 PHP 8.0，可以通过锁死组件版本来解决：

打开项目目录下的 composer.json 文件。

找到 “firebase/php-jwt”: “^6.3” 这一行。

把他改成一个明确兼容 PHP 7.4 的具体老版本（例如 ^6.10.0）

“firebase/php-jwt”: “6.3.0“
保存文件，然后重新执行 composer install —no-dev —optimize-autoloader

2、最小改动修复方式：
app/Http/Requests/Passport/AuthForget.php

找到’email_code’ => ‘required’
改成’email_code’ => ‘required|string|digits:6’

3、Nginx 爆出重大安全漏洞。请大家尽快升级 Nginx 版本至 1.30.1 or 1.31.0 或者及以上的版本。

4、rule和首页

下载新的归档源配置文件
请根据你服务器所在的网络环境，选择阿里云或腾讯云之一执行：

选项 A：更换为【阿里云 Vault 归档源】（推荐）
> curl -o /etc/yum.repos.d/CentOS-Base.repo https://mirrors.aliyun.com/repo/Centos-7.repo

下载完成后，因为官方源地址已失效，需要用 sed 命令将配置文件中的域名批量替换为阿里云的 Vault（历史存档）地址：

sed -i -e 's/http:\/\/mirrors.cloud.aliyuncs.com/http:\/\/mirrors.aliyun.com/g' \
       -e 's/http:\/\/mirrors.aliyun.com\/centos\/$releasever/http:\/\/mirrors.aliyun.com\/centos-vault\/7.9.2009/g' \
       /etc/yum.repos.d/CentOS-Base.repo

# 清理旧缓存
yum clean all

# 建立新缓存
yum makecache

使用aaPanel手动部署#
aaPanel是宝塔(bt.cn)的国际版本

1.配置aaPanel#
你需要在 aaPanel 选择你的系统获得安装方式。这里以 CentOS 7+ 作为系统环境进行安装。

请务必使用 CentOS 7+ 安装aaPanel，其他系统可能会有未知问题。

bash
// 最新脚本可以在aaPanel官网获取
yum install -y wget && wget -O install.sh http://www.aapanel.com/script/install_6.0_en.sh && bash install.sh
安装完成后我们登陆 aaPanel 进行环境的安装。

选择使用LNMP的环境安装方式勾选如下信息

☑️ Nginx 1.17
☑️ MySQL 5.6
☑️ PHP 7.4

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

2.安装Redis、fileinfo#
aaPanel 面板 > App Store > 找到PHP 7.4点击Setting > Install extentions > redis,fileinfo 进行安装。

3.解除被禁止的函数#
aaPanel 面板 > App Store > 找到PHP 7.4点击Setting > Disabled functions 将 putenv proc_open pcntl_alarm pcntl_signal 从列表中删除。

4.添加站点#
aaPanel 面板 > Website > Add site。

在 Domain 填入你指向服务器的域名
在 Database 选择MySQL
在 PHP Verison 选择PHP-74

5.安装V2Board#
通过SSH登录到服务器后访问站点路径如：/www/wwwroot/你的站点域名。

以下命令都需要在站点目录进行执行。

bash

删除目录下文件

chattr -i .user.ini
rm -rf .htaccess 404.html index.html .user.ini
执行命令从 Github 克隆到当前目录。

bash
git clone https://github.com/v2board/v2board.git ./
执行命令安装依赖包以及V2board

bash
sh init.sh
根据提示完成安装

6.配置站点目录及伪静态#
添加完成后编辑添加的站点 > Site directory > Running directory 选择 /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;
}
7.配置定时任务#
aaPanel 面板 > Cron。

在 Type of Task 选择 Shell Script
在 Name of Task 填写 v2board
在 Period 选择 N Minutes 1 Minute
在 Script content 填写 php /www/wwwroot/路径/artisan schedule:run

根据上述信息添加每1分钟执行一次的定时任务。

8.启动队列服务#
V2board的系统强依赖队列服务，正常使用V2Board必须启动队列服务。下面以aaPanel中supervisor服务来守护队列服务作为演示。

aaPanel 面板 > App Store > Tools

找到Supervisor进行安装，安装完成后点击设置 > Add Daemon按照如下填写

在 Name 填写 V2board
在 Run User 选择 www
在 Run Dir 选择 站点目录 在 Start Command 填写 php artisan horizon 在 Processes 填写 1

填写后点击Confirm添加即可运行。

常见问题#
Q：500错误
A：检查站点根目录权限，递归755，保证目录有可写文件的权限，也有可能是Redis扩展没有安装或者Redis没有按照造成的。你可以通过查看storage/logs下的日志来排查错误或者开启debug模式、站点设置中关闭防跨站。