去评论
dz插件网

Discuz! X3.5或X3.4版本升级到DZ X5.0官方指导升级帮助说明文档

惧愁人
2026/03/06 17:05:41
X5 3月20日发布在即,下载安装、升级前请大家先看此文再出手。

环境要求
从 X5.0 版本起,PHP 的最低要求已提升至 PHP8.0,如果您的 PHP 环境要求不满足,请先升级到 PHP8.0。
如果您使用的是老版本的 Discuz!,版本低于 X3.5 的,请先升级到 X3.5 版本。已经是 X3.5 版本的站点,可直接通过正常的安装程序进行升级。同时,安装程序内置了工具箱,熟悉情况的老站长们就不必询问为何 utility 目录不见了。

升级补丁
从 X5.0 起,官方在版本发布更新时将不再发布更新补丁程序,因为 X5 会自行提供补丁程序。当有新版本发布时,您可通过“管理中心”的“升级补丁”功能自行下载补丁文件。若要使用此功能,请确保您的 PHP 已安装 zip 扩展。

环境部署
如果你确实对环境部署很小白,建议使用宝塔初始化 Discuz! X5 的环境(此处不是广告哈),按照以下步骤安装:
1、进入宝塔面板“软件商店”;
2、选择“PHP 8.x”,是 8+ 就可以,8.4 也是没问题的,安装后安装扩展 opcache、redis;
3、选择“Redis”,版本不限;
4、选择“MySQL”,必须 5.7+(含),8.0 也是可以,看你服务器内存情况;
5、选择“Nginx”,版本越高越好不会有漏洞;
6、添加站点,上传 upload 目录中的代码到网站根目录。如需配置伪静态规则,选择“discuzx3”即可;
7、正常访问网站,进行安装,安装完成当站点前后台可以正常访问后 config_global.php 修改以下内容,开启 Redis:
  1. $_config['memory']['redis']['server'] = '127.0.0.1';
  2. $_config['memory']['redis']['port'] = 6379;

config_global.php
1、前台和后台可以同时登录 2 个账号
$_config['admincp']['mustlogin'] = 0 且 $_config['admincp']['synclogin_front'] = 0 的时候,如果社区前台已经登录一个账号的情况下,登录“管理中心”可以登录另一个账号互不冲突。
2、仅扫码登录后台
管理中心绑定了微信扫码登录后,如果设置 $_config['admincp']['qrcode_only'] = 1,那么后台就只能扫码才能登录,不会出现用户名密码的输入框,增加后台的安全性。
3、后台二次校验
当 $_config['admincp']['validate']['method'] = 'default' 的时候设置 ['user'] 和 ['pass'] 可为管理中心增加一个额外校验,校验通过后才会显示管理中心界面。更多二次校验方法可以通过应用中心下载。
4、日志文件
$_config['log']['type'] = 'mysql' 说明日志文件默认是写入数据库的,如果您担心数据库膨胀过快可以改成 'file'。
5、官方 IP 库
X5 默认启用官方的 IP 库,可以把 $_config['ipdb']['setting']['ipv4'] = 'system'。IPv6 同理,但是库文件较大默认是不带的,符合 IPv6 条件的服务器可以自行下载 [color=var(--comiis-color)]https://gitee.com/Discuz/IP

Preload
如果您的服务器上只有一个 Discuz 程序,并无其他程序,可以在 php.ini 中加入以下配置,开启 Preload,进一步为 Discuz! X5 提速。当然要先开启最基础的 opcache 扩展。如果您压根不知道 Preload 为何物,可以忽略。
  1. opcache.preload=/[path]/api/opcache/preload.php
  2. opcache.preload_user=www

任何 X5 相关问题、建议请发帖至 Discuz! X5 专区