Discuz X安装教程，新手如何顺利安装？-建站教程-锦华智联科技

Discuz! X 详细安装教程

Discuz! 是一个功能强大的社区论坛程序，由 Comsenz 公司开发，本教程以最新的 Discuz! X3.7 版本为例进行讲解。

（图片来源网络，侵删）

第一步：安装前准备

在开始安装之前,您需要确保您的服务器环境满足 Discuz! 的运行要求。

环境要求

Web 服务器： Apache 2.0+ 或 Nginx 1.2+ (推荐使用 Nginx，性能更好)
数据库： MySQL 5.5+ / MariaDB 5.5+
PHP 版本： PHP 7.1 - 8.0 (强烈推荐使用 PHP 7.1 或 7.2，兼容性和稳定性最好)
其他： 需要开启 PHP 的 mysqli 和 curl 扩展。

准备安装包

官方下载： 访问 Comsenz 官方网站 https://www.comsenz.com/，在产品中心找到 Discuz! X 并下载最新版本。
下载的压缩包（通常是 .zip 或 .tar.gz）解压后，会包含以下主要文件和文件夹：
- upload/：这是核心文件夹，需要上传到您的网站根目录。
- docs/：存放相关文档，包括 install/ 安装说明和 update/ 升级说明。
- utility/：包含一些实用工具。

第二步：上传文件到服务器

您需要将准备好的文件上传到您的网站服务器,这里我们介绍两种最常见的方式。

（图片来源网络，侵删）

使用 FTP/SFTP 客户端（如 FileZilla）

连接服务器： 使用您的 FTP 软件（如 FileZilla），输入您的主机地址、用户名、密码和端口，连接到您的服务器。
定位网站根目录： 找到您网站的根目录，这个目录通常是：
- Apache (cPanel/Plesk): public_html 或 www
- Nginx (宝塔面板等): www 或 wwwroot
上传文件：
- 在本地电脑上,找到您解压后的 Discuz! X 文件夹。
- 仅将 upload 文件夹内的所有文件和子文件夹，全部选中并拖拽到服务器的网站根目录中。
- 注意： 是上传 upload 文件夹的，而不是上传 upload 这个文件夹本身。

使用面板（如宝塔面板）

如果您使用的是宝塔、cPanel、Plesk 等服务器管理面板，操作会更简单。

登录面板： 进入您的服务器控制面板。
进入文件管理器： 找到并点击“文件”或“文件管理器”选项。
打开网站根目录： 进入您网站的根目录（如 www 或 public_html）。
上传文件：
- 点击“上传”按钮。
- 将您本地电脑上的 upload 文件夹内的所有内容，上传到当前目录。

第三步：创建数据库

Discuz! 需要一个独立的数据库来存储所有数据。

（图片来源网络，侵删）

使用 phpMyAdmin（最常见）

登录 phpMyAdmin： 通常在您的服务器面板（如 cPanel、Plesk、宝塔面板）中可以找到 phpMyAdmin 的入口，或者在浏览器中访问 http://您的域名/phpmyadmin。
创建新数据库：
- 在 phpMyAdmin 的主界面，点击顶部的“数据库”选项卡。
- 在“创建数据库”下，输入一个数据库名称（discuz_db），然后从下拉菜单中选择“排序规则”（推荐选择 utf8mb4_general_ci 或 utf8mb4_unicode_ci）。
- 点击“创建”按钮。
创建数据库用户并授权：
- 返回到“主页”或点击您的数据库名称进入。
- 在“用户账户”选项卡中，点击“添加用户账户”。
- 登录信息：
  - 用户名：输入一个用户名（discuz_user）。
  - 主机名：选择 本地（代表 localhost）。
  - 密码：输入一个强密码并确认。
- 全局权限：
  - 向下滚动,在“数据库专有权限”部分，选择刚刚创建的数据库（discuz_db）。
  - 勾选“所有特权”（All privileges）。
  - 点击“执行”按钮。

使用宝塔面板

进入宝塔面板,点击左侧的“数据库”。
点击“添加数据库”。
填写信息：
- 数据库名：discuz_db
- 数据库用户名：discuz_user
- 数据库密码：一个强密码
- 数据库字符集：utf8mb4
- 点击“提交”。

第四步：运行安装向导

所有准备工作都已完成,可以开始正式安装了。

访问安装页面：
- 在浏览器中,输入您的网站域名。http://www.yourdomain.com
- 如果您将文件上传到了一个子目录,请访问该目录，http://www.yourdomain.com/bbs
进入安装界面：
- 首次访问,Discuz! 会自动检测到 install 目录，并自动跳转到安装页面，如果没有跳转，您可以手动访问 http://您的域名/install/。
- 您会看到一个欢迎页面,点击“我同意”继续。
环境检测：
- 系统会自动检测您的服务器环境（PHP, MySQL, 文件权限等）。
- 如果所有项目都显示为“√”或“通过”，则环境符合要求。
- 如果出现“×”或“不通过”，请根据提示进行修改：
  - PHP 版本不兼容： 需要在服务器面板中修改 PHP 版本。
  - 目录或文件权限不足： 这是最常见的问题，您需要将以下目录和文件设置为 可写 (777 或 755) 权限，安装完成后，请务必改回安全的权限（如 755）。
    - ./config/
    - ./data/
    - ./uc_client/
    - ./uc_server/
    - ./forumdata/
    - ./static/js/
    - ./template/
    - 以及这些目录下的所有文件。
    - 在宝塔面板中，右键点击文件/目录 -> 权限 -> 勾选“所有者”、“用户组”、“其他”的“读取”、“写入”、“执行”即可。
运行环境安装：
- 环境检测通过后,点击“下一步”。
- 系统会尝试自动创建 config/config_ucenter.php 和 config/config_global.php 这两个核心配置文件，如果成功，直接进入下一步，如果失败，您需要手动下载这两个文件，按照提示修改内容后，再上传到服务器的 config/ 目录中，然后刷新页面。
安装数据库：
- 数据库信息：
  - 数据库服务器：通常是 localhost（除非您的数据库和 Web 服务器不在同一台机器上）。
  - 数据库名称：填写您在第三步创建的数据库名（如 discuz_db）。
  - 数据库用户名：填写您创建的数据库用户名（如 discuz_user）。
  - 数据库密码：填写您设置的数据库密码。
- 管理员信息：
  - 管理员用户名：设置您的论坛管理员账号。
  - 管理员密码：设置一个强密码。
  - 管理员邮箱：填写您的邮箱。
- 站点信息：
  - 站点名称：您的论坛名称。
  - 管理员邮箱：与管理员邮箱一致即可。
- 站点 URL： 自动填充，请确认是否正确。
- 管理员 Email 验证： 勾选此项，管理员首次登录时需要验证邮箱。
- 填写完毕后,点击“下一步”，系统开始创建数据表和初始化数据。
安装完成：
- 等待进度条走完,看到“安装成功！”的提示后，安装就完成了。
- 重要！ 请立即执行以下操作：
  - 删除 install/ 目录： 为了安全，务必删除服务器上的 install 文件夹及其所有内容。
  - 修改文件权限： 将之前设置为 777 的目录权限改回 755，将配置文件 config/config_ucenter.php 和 config/config_global.php 的权限改回 644。
  - 删除 install.lock 文件（如果存在）。

第五步：访问您的论坛

您可以在浏览器中直接访问您的域名（如 http://www.yourdomain.com），您的全新 Discuz! 论坛就已经呈现在眼前了！

使用您刚刚设置的管理员账号和密码登录后台,开始个性化您的论坛吧！

常见问题 (FAQ)

Q1: 安装时提示 "Table 'xxx.pre_common_admincp_session' doesn't exist" 或类似错误？ A: 这通常是因为数据库没有成功创建或连接信息错误，请返回第三步，确认数据库名、用户名、密码是否完全正确，并确保数据库用户拥有该数据库的所有权限。

Q2: 安装后页面显示空白或乱码？ A:

空白页： 检查 PHP 错误日志，可能是 PHP 版本不兼容或代码有误。
乱码： 几乎 100% 是数据库字符集问题，请确保在创建数据库时选择了 utf8mb4 字符集，Discuz! 安装时也选择了 utf8mb4。

Q3: 如何进入后台管理？ A: 在您的论坛页面底部，通常会有“管理中心”的链接，或者直接在域名后加上 /admincp/，http://www.yourdomain.com/admincp/。

Q4: 安装后如何修改网站信息？ A: 登录后台，在左侧菜单栏找到 “全局” -> “站点信息”，在这里您可以修改网站名称、URL、Logo、版权信息等。

Q5: 如何更换主题或插件？ A: 登录后台，在左侧菜单栏找到 “应用” -> “插件” 或 “界面”，在这里您可以在线安装、启用、禁用插件和主题。

希望这份详细的教程能帮助您成功安装 Discuz!！如果在安装过程中遇到任何问题，欢迎随时提问。