Discuz! X3 全新安装图文教程

本教程将分为以下几个部分：

discuz!x3 全新安装图文教程
（图片来源网络，侵删）
  1. 【第一步：环境准备】 - 检查并配置你的服务器环境。
  2. 【第二步：文件上传与解压】 - 将 Discuz! 程序上传到你的服务器。
  3. 【第三步：创建数据库】 - 为论坛准备一个“家”。
  4. 【第四步：运行安装程序】 - 核心安装步骤,浏览器操作。
  5. 【第五步：安装后配置】 - 完成安装并进行初步设置。
  6. 【第六步：安全与维护】 - 重要安全提示。

【第一步：环境准备】

在开始安装之前，请确保你的服务器或虚拟主机满足 Discuz! X3 的运行环境要求,这是安装成功的基础。

系统要求

  • 操作系统：Linux (推荐 CentOS, Ubuntu) 或 Windows Server
  • Web 服务器：Apache 2.0+ 或 Nginx 1.2+ 或 IIS 7+
  • 数据库：MySQL 5.5+ 或 MariaDB 5.5+
  • PHP：PHP 5.3 - 7.4 (推荐 PHP 5.6 或 7.0，因为 X3 是较老的版本，新版本 PHP 可能存在兼容性问题)

环境检查（关键步骤）

你可以创建一个 info.php 文件来检查你的 PHP 环境。

  1. 在你的网站根目录（通常是 public_html 或 wwwroot）下，新建一个名为 info.php 的文件。
  2. 用记事本或代码编辑器打开它，输入以下代码：
    <?php
phpinfo();
?>
  3. 保存文件并通过浏览器访问 http://你的域名/info.php。
  4. 你会看到一个详细的 PHP 信息页面，请检查以下几点：
    • PHP Version：确认版本在 5.3 - 7.4 之间。
    • Loaded Configuration File：确认 php.ini 文件路径。
    • MySQL Support：确保此项为 enabled，表示已安装 MySQL 扩展。

目录权限设置

安装程序需要写入一些文件和目录，必须确保它们的权限正确，你需要设置以下目录和文件的权限为 755 或 777（777 权限较高，不安全，但安装时最方便，安装成功后务必改回 755）。

  • /config/ 目录
  • /data/ 目录
  • /uc_client/data/ 目录
  • /uc_server/data/ 目录
  • /forumdata/ 目录
  • /static/image/common/ 目录
  • /config/config_ucenter.php 文件

如何设置权限？

discuz!x3 全新安装图文教程
（图片来源网络，侵删）
  • 通过 cPanel 面板：进入文件管理器，右键点击上述目录/文件，选择“权限”，然后输入数字 755 或 777。
  • 通过 FTP 客户端：连接服务器后，右键点击目录/文件，选择“文件权限”，然后输入数字 755 或 777。

【第二步：文件上传与解压】

准备好环境后，我们来上传 Discuz! X3 的程序文件。

下载程序

从官方渠道下载 Discuz! X3 的完整安装包。

  • 官方地址：https://gitee.com/Discuz/DiscuzX/tree/release/X3.4/

下载后你会得到一个 .zip 或 .tar.gz 压缩包。

上传文件

使用 FTP 工具（如 FileZilla）或 cPanel 的文件管理器，将下载的压缩包上传到你的网站根目录（public_html 或 wwwroot）。

discuz!x3 全新安装图文教程
（图片来源网络，侵删）

解压文件

上传完成后,在服务器上解压压缩包。

  • 通过 cPanel 文件管理器：

    1. 进入文件管理器,找到你上传的压缩包。
    2. 右键点击它，选择“解压缩”。
    3. 在弹出的窗口中，选择解压到当前目录 ()。

  • 通过 SSH (Linux)：

    # 进入网站根目录
cd /home/用户名/public_html
# 解压压缩包 (假设是 .zip 格式)
unzip Discuz_X3.4_SC_UTF8.zip
# 如果是 .tar.gz 格式
tar -zxvf Discuz_X3.4_SC_UTF8_GBK.zip

重要：解压后，你会发现根目录下多了一个名为 upload 或 discuz 的文件夹，你需要将这个文件夹内的所有文件和文件夹移动（或剪切）到网站根目录 (public_html) 下。

移动前：/public_html/upload/ 移动后：/public_html/ (所有文件都在这里)

【第三步：创建数据库】

论坛需要一个数据库来存储用户、帖子等信息,现在我们来创建它。

登录数据库管理工具

  • 通过 cPanel：找到“数据库”部分，点击 “MySQL 数据库向导” 或 “phpMyAdmin”。
  • 通过宝塔面板：点击“数据库”，然后点击“phpMyAdmin”。

创建新数据库

使用 phpMyAdmin 是最简单的方式。

  1. 登录 phpMyAdmin。
  2. 在主页面的“创建数据库”部分，输入数据库名称（myforum_db）。
  3. 选择排序规则（Collation），对于中文社区，强烈推荐选择 utf8mb4_general_ci 或 utf8mb4_unicode_ci。
  4. 点击“创建”按钮。

创建数据库用户

  1. 在 phpMyAdmin 顶部菜单栏，点击 “权限” 选项卡。
  2. 点击 “添加用户账户” 按钮。
  3. 用户名：输入一个用户名（myforum_user）。
  4. 主机名：选择 “本地” (表示该用户只能从本机连接数据库，最安全)。
  5. 密码：输入一个强密码，并“重新输入密码”。
  6. 向下滚动，找到 “数据库专有权限” 部分，勾选你刚刚创建的数据库名（myforum_db）。
  7. 勾选 “赋予所有在全局权限中定义的权限”。
  8. 点击 “执行” 按钮。

你已经成功创建了数据库和拥有该数据库所有权限的用户，请记下以下信息,下一步会用到：

  • 数据库名：myforum_db
  • 数据库用户名：myforum_user
  • 数据库密码：你设置的密码
  • 数据库主机：通常是 localhost (99% 的情况下都是这个)

【第四步：运行安装程序】

所有准备工作就绪,现在可以开始正式安装了。

  1. 在浏览器中访问你的网站域名，http://你的域名。

  2. 如果看到以下欢迎界面，说明文件上传和权限设置都成功了！点击 “我同意”。

  3. 进入 “环境检测” 页面,这一步会检查你的服务器环境是否符合要求。

    • 如果所有项目都显示为 或 “是”，恭喜你,环境没问题！
    • 如果有 或 “否”，请根据提示返回【第一步】进行修改，最常见的错误是 目录/文件权限不正确。
    • 点击 “下一步”。

  4. 进入 “安装协议” 页面，勾选“我同意”，然后点击 “下一步”。

  5. 进入 “运行环境检测” 页面,再次确认环境。

  6. 进入 “数据库设置” 页面，这是最关键的一步！把你之前记录的信息填入。

    • 数据库服务器：填写 localhost
    • 数据库端口：默认 3306
    • 数据库名：填写 myforum_db
    • 数据库用户名：填写 myforum_user
    • 数据库密码：填写你设置的密码
    • 数据库表前缀：可以保持默认 pre_，如果需要安装多个论坛,可以修改为不同的前缀以区分。
    • 管理员账号：设置你的论坛管理员用户名和密码。
    • 管理员邮箱：填写你的邮箱