如何安装 MDClub

MDClub 的安装非常便捷。在大多数情况下，只需不到 30 秒就能完成安装。

服务器要求

在安装 MDClub 之前，请检查你的服务器是否满足要求。如果你不了解你的服务器是否满足要求，也没关系，MDClub 的安装脚本会自动帮你完成检查。服务器要求如下：

• Apache（需要启用 mod_rewrite 重写模块）或 Nginx
• PHP 7.2+，需要启用 gd 或 imagemagick、fileinfo、json、pdo、iconv、curl 扩展
• MySQL 5.6+ 或 MariaDB 10.0.5+

开始安装

1. 从 MDClub 官网 下载最新版本的 MDClub 安装包并解压。
2. 在你的 Web 服务器上为 MDClub 创建数据库，数据库编码建议设置为 utf8mb4_general_ci。
3. 将解压缩后的 MDClub 文件上传到服务器。
4. 按下文的”文件夹权限“说明设置 MDClub 的文件夹权限。
5. 配置你的 Web 服务器，将网站根目录设置为”MDClub路径/public“，并按照下文说明设置 URL 重写。
6. 在浏览器中访问 URL 来运行 MDClub 的安装脚本。

URL 重写

Apache

MDClub 在 public 目录中附带了一个 .htaccess 文件。如果没有启用 mod_rewrite 模块，或禁用了 .htaccess，MDClub 将无法正常运行。

启用 mod_rewrite 的方法会根据操作系统的不同而不同。在 Ubuntu 上，您可以通过运行 sudo a2enmod rewrite 命令来启用它，而在 CentOS 上 mod_rewrite 是默认启用的。请不要忘记在修改配置后重启 Apache！

启用 .htaccess 文件，你可能需要在 Apache 的配置文件中添加以下内容：

<Directory "/MDClub路径/public">
  AllowOverride All
</Directory>

Nginx

MDClub 附带了一个 .nginx.conf 文件。你需要在 Nginx 的站点配置文件中添加以下内容，以导入默认的重写规则：

include /MDClub路径/.nginx.conf;

文件夹权限

若服务器使用 Windows 系统，则无需设置权限。

若服务器使用 Linux 系统，则需将以下文件夹设置为 755 权限：

./config
./var
./public/sitemap
./public/upload

安装过程遇到问题？

如果在安装或使用过程遇到“服务器错误”，请按先开启调试模式，以输出详细的错误信息。

请先在顶部的搜索框中进行搜索。若仍无法解决，请到问答区提问以寻求帮助。