DZ程序上传到服务器后,安装核心步骤是:确认环境、访问 /install 目录、填写数据库信息和管理员账号,最后删除 install 目录完成安装。整个过程不是把文件放上去就能跑,大部分失败都出在环境不匹配和数据库配置这两步,下面按实际会遇到的操作顺序拆解,你可以直接对着做。
上传文件后的第一步:检查服务器环境是否满足运行要求
很多用户把源码传到根目录后直接访问域名,看到的是空白页或者程序报错,这通常是服务器环境不达标,DZ程序(Discuz!)对PHP版本和MySQL版本有明确下限要求。
用宝塔面板搭建环境的用户,直接进面板的软件商店看PHP版本和MySQL版本就行,行业共识认为,PHP 7.4 及以上、MySQL 5.7 及以上是DZ程序流畅运行的稳妥配置,如果你用的老版本PHP,程序会直接提示版本过低无法继续安装。
处理方式很简单:
- 在面板里切换PHP版本,选中对应网站的运行目录,修改版本后重载配置。
- 虚拟主机用户没有切换权限,需要联系主机商确认支持哪些版本,据统计,多数虚拟主机默认提供的是PHP 5.6或7.0,安装新版DZ可能会报错。
检查PHP版本还有一种离线方式:在网站根目录创建一个 phpinfo.php 文件,写入 <?php phpinfo(); ?>,然后访问这个文件就能看到完整环境信息,确认无误后删除这个文件。
除了版本,还有一个容易忽略的地方:PHP扩展是否安装完整,DZ安装过程中会检查 mysqli、mbstring、curl、gz 等扩展是否启用,宝塔面板内这些扩展默认是开启的,虚拟主机有时候默认关闭,导致安装页面提示缺失扩展无法继续。
数据库准备:新建站点专属的数据库账号
安装过程中会要求填写数据库信息,这类信息不会自动生成,需要你自己在数据库管理工具里提前创建,这一步卡住的人相当多,因为搞不清楚主机名、端口、前缀这些概念。
宝塔面板创建数据库的具体操作路径
进入宝塔面板左侧菜单的“数据库”,点击“添加数据库”,数据库名自行填写,dz_forum,用户名和密码可以自动生成或者自己设定,访问权限选“本地服务器”即可除非你的数据库在独立服务器上,才需要选“所有人”,创建完成后,你会看到数据库名、用户名、密码、端口这四个信息,安装时需要原样填入。
裸服务器和虚拟主机的数据库区别
裸服务器(比如直接在ECS或VPS上配置的LNMP/LAMP环境)一般用phpMyAdmin管理数据库,登录phpMyAdmin后,点“新建”创建数据库,字符集选 utf8mb4_general_ci,然后在“用户账户”页面添加新用户,把该用户添加到你新建的数据库上,并赋予全部权限。
虚拟主机用户相对省事,主机商通常在你购买时已经开通了MySQL服务,在主机管理面板里能找到对应的数据库名和主机地址,很多情况下主机地址是 localhost,端口是 3306,按主机商提供的文档填写。
执行安装脚本:访问 /install 目录开始安装
环境就绪、数据库创建完毕,接下来才是正式的安装环节,不要把安装包里的文件全部一股脑传上去就访问域名,DZ的上传要求和普通PHP程序略有不同。
正确上传目录结构
解压你下载的DZ安装包后,你会看到 upload 这个文件夹,里面才是程序的真实文件。把 upload 目录下的所有文件复制到网站的根目录(wwwroot 或 htdocs),不是把 upload 文件夹本身放进去,这是一个高频错误很多人把upload文件夹整个传到根目录,结果访问域名时找不到安装页面。
访问安装页面
文件放置正确后,浏览器访问你的域名,程序一般会自动跳转到 http://你的域名/install/index.php,或者你自己在地址栏输入这个路径访问。
安装界面选项怎么选
安装向导会询问“全新安装”还是“升级安装”,选全新安装,接下来进入环境检测页面,列表中每项前方都是对勾,说明全部通过;如果有叉号,按照提示的后缀说明去调整环境。
接下来是数据库配置模块,逐项解释:
- 数据库服务器:绝大多数场景填
localhost或0.0.1,如果你是云数据库(比如酷番云CDB、简米云RDS),这里填你那台数据库的内网地址。 - 数据库名:你在MySQL里创建好的那个库的名字。
- 数据库用户名:你创建的那个MySQL用户。
- 数据库密码:该用户对应的密码。
- 数据表前缀:默认
pre_就行,没必要改,除非你有技术洁癖或者打算将来一台库跑多个论坛。 - 管理员账号密码:填你论坛创始人的登录名和密码,这个以后登录后台用,密码建议包含字母加数字加符号,不要用纯数字。
创始人账号创建时,如果提示“创始人UID=1是必须的”,是因为之前安装过残留配置没有清理干净,检查根目录 config 文件夹下是否有 config_global.php 和 config_ucenter.php 这两个文件,有的话删掉再重新访问安装页。
安装完成后的收尾工作:删除安装目录
安装结束后,程序会提示你删除 install 目录,这一步不是建议,是必须操作。不删的话,别人访问你的论坛域名下的install目录,可以重新执行安装脚本,直接覆盖你现有的配置,导致站点被恶意重置。
在宝塔面板里删除根目录下的 install 文件夹即可,如果你用的是Linux命令行环境,执行:
rm -rf /你的网站根目录/install
虚拟主机的文件管理界面里,找到这个目录右键删除即可,删除完成后,访问你的域名,看到论坛首页就是装成功了。
常见安装失败问题排查
整个流程走下来,最常见的报错有三个场景,分别对应不同的解决办法。
安装页面白屏或500错误
大概率是PHP版本太高或者某个扩展缺失,DZ官方对PHP版本的适配有滞后性,如果你用PHP 8.1以上版本,部分老版本DZ会直接白屏,这时在面板里切换到PHP 7.4通常能解决,把网站目录下的 .user.ini 文件删除或检查其内容是否限制了PHP执行权限。
数据库连接失败,提示无法连接到数据库服务器
先确认数据库名和用户名密码是否完全一致,密码别复制到多余空格,其次确认主机名是否写对本地环境是 localhost,云数据库要填内网地址,填公网地址一般会出现连接超时。
安装到一半卡住不动
检查数据库服务是否在正常运行,宝塔面板里看MySQL服务是否启动,虚拟主机用户联系主机商确认MySQL是否挂载在你所在的服务器节点上。
域名解析和后台设置
安装完成后,你用临时IP或者临时域名访问的话,后续访问都是这个地址,如果绑定正式域名,需要提前在域名控制台解析到当前服务器的IP,并且在网站管理面板里将域名绑定站点,这一步应该在安装前就完成,装完后再改域名会导致后台配置的站点URL还是旧地址,论坛发帖和登录的链接都出错。
后台登录路径是 http://你的域名/admin.php,用刚才创建的创始人账号登录,首次进后台,建议优先把“全局->站点信息”里的站点名称、门户URL、论坛URL核对一遍,确保URL尾部带斜杠,证书是HTTPS的也要在设置里开启,否则页面会提示不安全。
DZ程序上传到服务器安装相关问题解答
Q:DZ程序上传到服务器后安装提示“当前状态:无法获取ucenter信息”怎么解决?
A:这个问题源于旧的 UCenter 配置残留,检查根目录 uc_server/data/ 下是否存在 install.lock 文件,存在则删除,同时检查 config/config_ucenter.php 文件是否存在,存在的话一并删除,重新访问安装页面执行全新安装。
Q:重新安装DZ程序,数据库是否要重新创建?
A:如果之前安装过并产生了数据,建议在phpMyAdmin中把旧数据库直接删除,重新创建一个空数据库,确保前缀不变且字符集为 utf8mb4_general_ci,避免沿用旧库导致安装过程中数据表冲突,出现“数据表已存在”的停止报错。
Q:DZ程序上传服务器后安装时管理员账号设置的密码有什么要求?
A:系统要求密码长度为6位以上并包含两种以上字符类型,如果设置失败,检查你是否在密码确认框中输入了相同的内容,密码框旁会实时提示复杂度状态,达标后才能进入下一步,建议使用包含大写字母、小写字母和数字的组合,方便记忆且不易被暴力破解。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/787463.html


