服务器Discuz教程:从环境准备到论坛安装的完整步骤
在服务器上安装 Discuz,核心是三件事:把 PHP 和 MySQL 环境准备好,把程序文件放到站点目录并配好权限,然后通过浏览器运行安装向导。
下面以宝塔面板加 LNMP 环境为例,把每一步拆开讲,零基础也能照着做完。
装之前先确认这几项
Discuz 对运行环境有基本要求,环境不对后面会反复报错。
- 操作系统:常见 CentOS、Ubuntu、Debian 都可以,本文操作以宝塔面板为入口。
- Web 服务:Nginx 或 Apache 均可,新手建议 Nginx。
- PHP:建议 PHP 7.4 或 8.0 这类较新版本,具体以你所下载的 Discuz 版本说明为准。
- 数据库:MySQL 5.7 或 8.0 均可,装之前记住数据库 root 密码。
- 域名:已解析到服务器 IP,否则安装时访问会失败。
如果服务器还没装面板,先在服务器安全组放行 8888 面板端口和 80、443 网站端口,再安装宝塔。
用宝塔建站并选好环境
登录宝塔面板,从左侧菜单进入 网站 → 添加站点,填写以下内容:
- 域名:填你的域名,例如
bbs.example.com。 - 根目录:保持默认,例如
/www/wwwroot/bbs.example.com。 - FTP:不创建。
- 数据库:选择 MySQL,编码
utf8mb4,记下自动生成的库名、用户名和密码,安装向导要用。 - PHP 版本:选 7.4 或 8.0,与后面 Discuz 版本匹配。
提交后站点会出现在列表中。
如果 PHP 版本没装,先在 软件商店 里安装对应版本的 PHP 和 MySQL。
上传 Discuz 程序并设置权限
从 Discuz 官方渠道下载安装包,解压后得到 upload 目录,里面才是真正的程序文件。
- 在宝塔 文件 中进入站点根目录
/www/wwwroot/bbs.example.com。 - 删除默认的
index.html、404.html等占位文件。 - 把
upload目录里的全部文件上传到站点根目录,注意不要把upload这一层目录本身也传进去。 - 选中站点根目录,点 权限,所有者设为
www,权限设为755,勾选“应用到子目录”。
关键目录需要可写权限,否则安装会提示无法写入:
chown -R www:www /www/wwwroot/bbs.example.com
chmod -R 755 /www/wwwroot/bbs.example.com
chmod -R 777 /www/wwwroot/bbs.example.com/config
chmod -R 777 /www/wwwroot/bbs.example.com/data
chmod -R 777 /www/wwwroot/bbs.example.com/uc_server/data
chmod -R 777 /www/wwwroot/bbs.example.com/uc_client/data
改完权限后,在宝塔 网站 → 设置 → 网站目录 里确认“运行目录”没有指向多余子目录,通常保持站点根目录即可。
运行安装向导
浏览器访问 http://你的域名/install/,会进入 Discuz 安装页面。
- 第一步:勾选同意协议,点下一步。
- 第二步:确认目录权限检查全部通过,若某项不通过,回到上一步补权限。
- 第三步:选择“全新安装”,填写数据库信息。数据库地址一般填
localhost,库名、用户名、密码用建站时记录的那组。 - 第四步:设置管理员账号、密码和邮箱,这个账号是论坛后台最高权限,务必记牢。
- 第五步:点击安装,等待完成。
安装成功后,先访问前台首页确认论坛能打开,再访问 http://你的域名/admin.php 进入后台。
装完要检查的几处
安装完成不等于万事大吉,建议按下面几项快速验证:
- 前台首页是否正常显示版块,没有报错或乱码。
- 用管理员账号登录后台,检查 全局 → 站点信息 里的站点 URL 是否正确。
- 在宝塔 网站 → 设置 → SSL 中申请证书,开启 HTTPS,避免浏览器提示不安全。
- 关闭安装目录:进入宝塔文件管理,把站点根目录下的
install文件夹删除或改名,防止被再次运行。
常见报错与避坑
提示“数据库连接失败”:多半是库名、用户名、密码填错,或数据库地址不是 localhost。
回到宝塔 数据库 页面核对,必要时重置密码。
安装页白屏或 500 错误:先看 PHP 版本是否过低,再看 config、data 目录权限是否可写。
可以在宝塔 网站 → 设置 → 网站日志 里查看具体报错。
前台样式丢失:检查伪静态是否配置。
Discuz 在 Nginx 下需要在 网站 → 设置 → 伪静态 中选择 Discuz 规则并保存。
上传文件失败:
确认 PHP 的 upload_max_filesize 和 post_max_size 是否偏小,
可在宝塔 软件商店 → PHP 设置 → 配置修改 中调整后重启 PHP。
避坑提醒:不要给整个站点目录设 777,只对 config、data 等确实需要写入的目录放开;
安装完一定删掉 install 目录;
数据库密码不要用弱口令。
几个新手常问的问题
Discuz 必须用宝塔面板吗? 不是。
宝塔只是把建站、数据库、权限操作图形化了,用命令行或其它面板同样可以,原理一样。
安装后想换域名怎么办? 先在后台 全局 → 站点信息 改站点 URL,再在宝塔里改绑定域名并重新解析,最后清理缓存。
PHP 版本选哪个更稳? 以你下载的 Discuz 版本官方说明为准,不要盲目追最新版,环境不匹配容易出现兼容性报错。
安装目录删了还能重装吗? 可以重新上传 install 目录,但重装会覆盖数据,操作前务必备份数据库和站点文件。
到这里,服务器 Discuz 教程的主要流程就走完了。
建议先在测试环境练一遍,确认每一步的预期结果都对上,再放到正式服务器上操作。