1234下一页
返回列表 发帖

Discuz! X5.0 安装升级注意事项

10915 33 楼主
发表于 2026-3-6 16:11:15 |北京| 只看楼主 阅读模式
|
X5.0 下载安装、升级前请大家先看此文再出手,内容有点多,如果您想认真看完,绝对有收获。

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

【关于升级】
不要到处找升级程序了,从 X5.0 开始安装程序内置升级程序,升级前请关闭站点、关闭所有插件。请详细阅读下面的内容:
1、确保您的旧版本 Discuz! 必须为 X3.5 版本,如不满足版本要求请先升级到此版本;
2、确保 UCenter 和 Discuz! 部署在一个数据库中;
3、确保您已备份了数据库和程序文件,将旧版本程序文件移动到其他目录下;
4、将旧版本的配置文件 config/config_global.php、config/config_ucenter.php 复制到当前新版本的 config/ 目录中;
5、点击“下一步”开始升级;
6、升级完成后可以将旧版本中 source/plugin/ 目录下的插件文件挑选后复制到新版本的对应目录下、将 template/ 目录下的模板文件挑选后复制到新版本的对应目录下(不要复制 template/default/ 目录);
7、升级完成后 data/attachment/ 目录以及 data/ 目录下其他目录请酌情复制;如旧版本应用涉及其他目录中的文件,请自行咨询相关开发者复制;
如果您对上面的内容看着的确有点摸不着头脑,可以观看《DiscuzX5.0正式版升级安装保姆教学》的视频教程,用完全覆盖法升级。官方说明里不会明确推荐覆盖法的原因是由于 X5.0 架构的升级,文件目录结构全变了,如果覆盖你会分不清哪个是新文件哪个是旧文件,当然如果你压根不关心(或者看不懂)的话无所谓。同时推荐阅读《Nginx+Discuz! X3.5/X5 安装出错解决办法》中的内容调整服务器配置。

【插件模板兼容性】
1、插件方面,官方已经在 X3.5 版本就强制要求必须兼容 PHP8.0,如果您使用的插件已经做好兼容,那么恭喜,可以直接在 X5.0 中使用。否则,说明插件已经落后了 2 个版本迭代了,请督促插件开发者速度适配 PHP8.0。
2、模板方面,严谨地说 X5.0 模板不可能 100% 兼容 X3.5 模板,但也不至于完全打不开的地步,可能使用某些新功能时会有异常。因此也请督促模板开发者速度适配 X5.0。

【升级补丁】
从 X5.0 起,官方在版本发布更新时将不再发布更新补丁程序,因为 X5.0 会自行提供补丁程序。当有新版本发布时,您可通过“管理中心”的“升级补丁”功能自行下载补丁文件后上传覆盖。若要使用此功能,请确保您的 PHP 已安装 zip 扩展。如果您无法正常使用 X5.0 自带的补丁下载功能,可重新下载官方发布的完整包覆盖。
友情提示:官方发布包会按照 Tri-Monthly 的节奏更新,即每月 1 日、10 日、20 日固定时间更新,如变更的文件数量较少或无重大变更会跳过,欢迎站长们定时关注。

【UCenter 不再内置】
从 X5.0 起,产品将不再内置 UCenter 服务端,仅保留 UCenter 客户端。有需要的用户可在安装 X5 前预先部署 UCenter 服务端(https://gitee.com/Discuz/UCenter)。不过,一般情况下这并无必要。即便您看重 UCenter 2.0 的 oAuth2 接口功能,X5 本身也已具备,而且目前能与 UCenter 对接的其他应用程序几乎已不存在。此外,产品还内置了多个 X5 站点相互登录的功能。

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

其他 Redis 配置信息酌情修改。
友情提示:如果您服务器内存足够,请给 PHP 留出足够多的内存(php.ini 中 memory_limit 的设置)

【关于 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 条件的服务器可以自行下载 https://gitee.com/Discuz/IP

【关于 QQ 登录、微信登录相关插件】
由于 X5.0 系统级内置了 QQ 登录和微信登录的关系,所以如果您之前在 X3.5 版本中使用了相关插件,无论是不是官方插件,如果希望使用 X5.0 内置的第三方登录功能,那么就需要把数据转移到 X5.0 内置的第三方登录中,放弃使用以前的插件,因此您需要做以下操作:
1、关闭相关插件,注意是关闭不是卸载;
2、对于 “QQ 互联” 插件,执行下面的 SQL 语句,将用户的数据转移到系统表中
INSERT INTO `pre_common_member_account` (uid, atype, account)
SELECT uid, 6, conopenid
FROM `pre_common_member_connect`;

注意上面数字 6 为 QQ 登录数据,微信(服务号)登录是数字 4,pre_common_member_connect 为 QQ 互联用户表名称。
对于其他第三方的 QQ 登录、微信登录插件,请和相关插件开发者确认后更改上面的 SQL 即可把数据导入到系统的第三方登录数据中;
3、把之前填写在插件的相关配置信息填写到“第三方登录”相关功能中去,新的跳转地址留空提交,页面刷新后自动会告诉你正确的新地址,自己到相关平台更换即可;
4、测试无误后可酌情卸载旧插件;
友情提示:我们鼓励第三方插件作者制作比 X5.0 内置功能更完善的 QQ 登录、微信登录插件,但必须是基于 X5.0 第三方登录机制的全新结构登录插件,旧版登录插件按照 Discuz! 开放平台新规已被禁止在 X5.0 版本中更新。

【地区设置数据空缺】
为了方便各位站长个性化配置适合自己社区的地区数据,从 X5.0 开始地区设置的数据默认是空的,如需要请下载此文件后在“地区设置”中导入。
district_default.txt (74.74 KB, 下载次数: 239) (数据较多导入时请耐心等待,可能需要1分钟左右)

【旧版本的 X5.0 升级】
X5.0 正式发布前的所有版本都属于开发者版范畴,请访问下方链接下载 SQL 文件自行更新数据库。
X5 官方 Git 已经变更为开源版的声明

【有相关服务吗?】
官方的应用中心提供 代安装服务升级服务,欢迎咨询。同时,如果您有任何 X5 相关问题、建议请发帖至 Discuz! X5 专区




评分

参与人数 2金币 +10 人气 +5 收起 理由
鸿茂传媒 + 5 很详细的教程。
v2studio + 5 + 5 最好的 X5 教程

查看全部评分

回复

使用道具 举报

评论33

置顶 来自 20#
Discuz有偿服务Lv.9 发表于 2026-3-20 11:22:20 |浙江来自手机 | 只看Ta
官方提供 安装服务升级服务,欢迎咨询。
回复

使用道具 举报

置顶 来自 27#
克米设计Lv.7 发表于 2026-3-24 15:30:58 |广东| 只看Ta
回复 1

使用道具 举报

沙发
兰博Lv.9 发表于 2026-3-6 16:15:00 |内蒙古| 只看Ta
😋
回复

使用道具 举报

板凳
babyfacerLv.5 发表于 2026-3-6 16:27:41 |四川| 只看Ta
好家伙,真来了呀。看来得先把3.5的插件升级一下了
回复

使用道具 举报

地板
湖中沉Lv.6商业客户 发表于 2026-3-6 16:46:56 |浙江| 只看Ta
前排占位😄,展望未来
回复

使用道具 举报

5#
鸿茂传媒Lv.6 发表于 2026-3-6 17:17:50 |浙江| 只看Ta
前排支持一下,不错不错
回复

使用道具 举报

6#
时光无声Lv.2 发表于 2026-3-6 17:41:38 |广西来自手机 | 只看Ta
已经准备好了,明天发布?🙃🙃期待正式版
回复

使用道具 举报

7#
时光无声Lv.2 发表于 2026-3-6 17:42:40 |广西来自手机 | 只看Ta
3.8是吉利的日子
回复

使用道具 举报

8#
一定Lv.5 发表于 2026-3-6 20:39:48 |广东| 只看Ta
注定与我无缘啊,我PHP8开启网站空白,3.5版本
回复

使用道具 举报

9#
邓振华Lv.1 发表于 2026-3-6 21:12:56 |广西来自手机 | 只看Ta
什么时候发布?有具体时间表吗?
回复

使用道具 举报

10#
晚风Lv.2 发表于 2026-3-7 10:27:26 |江苏| 只看Ta
现在是预览版,按理来说还有一个测试版吧,距离真正可以用到运营的正式版,应该在5月1日左右发布吧(按“营销借势”)角度:lol
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

更多新闻
致久游网创始人王子杰先生悼文暨致谢辞
惊闻久游网创始人王子杰先生,于 2026 年 4 月 14 日在上海因突发心源性疾病逝
X5 开源版更新日志
X5 开源版的官方发布包会按照 Tri-Monthly 的节奏更新,即每月 1 日、10 日、20 日固
Discuz! X5.0 正式发布
2026年3月20日,承载着千万站长的期待与25年的技术积淀,国内领先的社区论坛软件系统
Discuz! X5.0 安装升级注意事项
X5.0 下载安装、升级前请大家先看此文再出手,内容有点多,如果您想认真看完,绝对有
Discuz! X5 企飞版新功能公示栏 [04.16]
Discuz! X5 企飞版新功能公示栏最后更新 2026-04-16 X5.1 功能要点 [*]原生可定制的
Discuz! X5 安全验证:这个 “Devil” 的点
论坛站长们是不是早被注册机搞出 PTSD 了?上周有个站长跟我们吐槽:一晚上被灌了 200
Discuz! X5 安装程序的优化
俗话说,了解一款软件通常是从安装开始的。回顾 Discuz! 从 1.0 版本发展到如今
Discuz! 官网 APP 现已开放!
从 2001 年到 2025 年,Discuz! 陪伴 300 万+站长从个人爱好者成长为创业先锋
Discuz! X5 中 DIY 功能的增强
DIY,即“Do It Yourself”的缩写,它为用户赋予了高度灵活且个性化的社区定制
Discuz! X5 分类信息的增强
分类信息在 Discuz! 中始终发挥着至关重要的作用,它满足了网站多样化的信息需
官方公告
Discuz! 2026 年春节假期服务调整公告
尊敬的各位站长、开放平台开发者: 新春将至,感谢大家一直以来对 Discuz!
关于近期 Discuz! 相关漏洞传闻的官方说明
各位亲爱的 Discuz! 站长及社区伙伴:​ 近日,我们关注到部分渠道流传关于 Discuz!
安全为王!Discuz!上线扫码登录后台和登录
为了进一步加强管理中心的安全性,Discuz!ᵂ 将正式上线管理中心扫码登录功能。自此,
Discuz! 持续经典,架构重塑,Discuz! X5.0
Discuz! X5.0 开发者预览版正式开源 【Discuz! X5.0 Git 官网】**** 本内容被作者隐
仅以此图官宣目前 Discuz!ᵂ 以及 X5 的手
一切尽在全新的手机版 DIY,欢迎体验
  • 关注公众号
  • 有偿服务微信
  • 有偿服务QQ

手机版|小黑屋|Discuz! 官方交流社区 ( 皖ICP备16010102号 |皖公网安备34010302002376号 )|网站地图|star

GMT+8, 2026-4-20 09:17 , Processed in 0.077147 second(s), 19 queries , Redis On.

Powered by Discuz! X5.0 Licensed

© 2001-2026 Discuz! Team.

关灯 在本版发帖
有偿服务QQ
有偿服务微信
返回顶部
快速回复 返回顶部 返回列表