本教程适用于以下操作系统版本

  • Ubuntu 24.04 (Noble Numbat)
  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 18.04 (Bionic Beaver)

本页内容

  • 前提条件
  • 安装 LAMP Stack
  • 为 MediaWiki 配置 PHP
  • 配置 MariaDB 数据库服务器
  • 下载 MediaWiki 源代码
  • 为 MediaWiki 设置 Apache2 虚拟主机
  • 开始安装 MediaWiki
  • 总结

MediaWiki 是一款免费开源的 wiki 软件,为互联网上规模最大的 wiki 站点(如 Wikipedia 和 Wikimedia)提供支撑。它功能极其强大、可伸缩且易于扩展,能提供特性丰富的 wiki 实现。MediaWiki 是 2002 年开发的一款 Web 应用程序,主要使用 PHP 编写,并使用 MySQL、PostgreSQL 等 RDBMS 来存储数据。

MediaWiki 也可用作协作与文档平台。它可以帮助你和团队整理文档,并将其向所有人公开。它还支持多语言,可用于创建多语言站点。同时它是一款高度可定制的 wiki 软件,你可以为 wiki 选择不同的主题和编辑器。

在本教程中,我们将演示如何在 Ubuntu 22.04 服务器上通过 LAMP Stack(Linux、Apache2、MariaDB 和 PHP)安装 MediaWiki。本教程包含 MediaWiki 的基础配置,完成以后你将拥有一个功能完整的 wiki 站点。

前提条件

在本示例中,我们需要满足以下前提条件:

  • 一台 Ubuntu 22.04 服务器。
  • 一个具备 root/管理员权限的非 root 用户。
  • 一个已解析到服务器 IP 地址的域名。

安装 LAMP Stack

第一步,你将在 ubuntu 22.04 服务器上安装基础的 LAMP Stack。在本示例中,你将使用 Apache2 Web 服务器来运行 MediaWiki。

在开始之前,你需要在 Ubuntu 22.04 服务器上安装 PHP 7.4。最新版 MediaWiki 要求 PHP 7.4,尚未适配最新的 PHP 8.1。因此你需要在 Ubuntu 系统上配置第三方仓库来安装 PHP 7.4。

运行以下命令,将 PHP 7.4 PPA 仓库添加到系统中。该命令还会自动更新并刷新系统上所有可用的仓库。

sudo add-apt-repository ppa:ondrej/php -y

全部完成后,运行下面的 apt 命令,将 LAMP Stack 软件包安装到 ubuntu 22.04 服务器上。

sudo apt install apache2 mariadb-server imagemagick libapache2-mod-php7.4 php7.4 php7.4-common php7.4-intl php7.4-xml php7.4-curl php7.4-gd php7.4-mbstring php7.4-mysql php7.4-apcu

输入 Y 确认安装并按 ENTER 继续。随后 LAMP Stack 的安装将开始。

LAMP Stack 安装完成后,使用以下命令检查并验证 Apache2 和 MariaDB 服务。你可以看到 Apache2 服务已启用并正在运行。

sudo systemctl is-enabled apache2
sudo systemctl status apache2

对于 MariaDB 服务,可使用下面的命令进行验证。

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

在下面的截图中,你可以看到 MariaDB 服务已启用,会在系统启动时自动运行,并且 MariaDB 服务当前的状态为运行中。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

为 MediaWiki 配置 PHP

安装完 LAMP Stack 软件包后,接下来将按照 MediaWiki 的安装要求配置 PHP。这包括对 PHP 安装中的 " max_upload_filesize "、" memory_limit " 和 " max_execution_time " 等配置项进行设置。

使用 nano 编辑器编辑文件 " /etc/php/7.4/apache2/php.ini "。

sudo nano /etc/php/7.4/apache2/php.ini

将以下配置项的默认值修改为如下所示。

upload_max_filesize = 80M
memory_limit = 512M
max_execution_time = 360

完成后保存并关闭文件。

最后,运行下面的命令重启 apache2 服务并应用新的更改。

sudo systemctl restart apache2

配置 MariaDB 数据库服务器

配置好 PHP 安装后,现在该来设置 MariaDB 服务器了。这包括配置 MariaDB 的 root 密码及部署,同时你还需要为 MediaWiki 安装创建一个新的 MariaDB 数据库和用户。

运行以下命令开始配置 MariaDB 部署。

sudo mysql_secure_installation

接下来,MariaDB 配置过程中会询问你以下问题:

  • 默认的 MariaDB 安装不带 root 密码,按 ENTER 继续。
  • 输入 n 以保留默认认证方式,不使用 unix_socket 认证(这针对 MariaDB root 用户)。
  • 输入 Y 以设置 MariaDB root 密码,然后输入新密码并重复确认。
  • 输入 Y 以删除默认的匿名用户。
  • 输入 Y 以禁用 MariaDB root 用户的远程登录。
  • 输入 Y 以从 MariaDB 安装中删除默认的 "test" 数据库。
  • 最后,再次输入 Y 以重新加载所有表的权限并应用新的更改。

至此,你已完成 MariaDB 部署的基础配置。

接下来,使用以下命令以 root 用户身份登录 MariaDB shell。

sudo mysql -u root -p

现在运行以下 MySQL/MariaDB 查询语句,创建一个新数据库 " mediawikidb ",并创建用户 " mediawiki " 及密码 " mediawikipassdb "。该数据库和用户将用于存储 MediaWiki 数据。

CREATE DATABASE mediawikidb;
CREATE USER mediawiki@localhost IDENTIFIED BY 'mediawikipassdb';
GRANT ALL ON mediawikidb.* TO mediawiki@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

之后,运行下面的查询语句查看用户 " mediawiki@localhost " 的数据库访问权限列表,然后退出 MariaDB shell。此时请确认 MariaDB 用户 " mediawiki@localhost " 已拥有对数据库 " mediawikidb " 的访问权限。

SHOW GRANTS FOR mediawiki@localhost;
quit

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

下载 MediaWiki 源代码

至此,你已完成 MediaWiki 安装所需的 LAMP Stack 基础配置。现在该把 MediaWiki 源代码下载到你的 Ubuntu 机器上了。

现在进入 " /var/www/ " 目录,并使用下面的 wget 命令下载 MediaWiki 源代码。目前 MediaWiki 的最新版本是 v1.38.1,你将得到文件 "mediawiki-1.38.1.tar.gz"。

cd /var/www/
wget https://releases.wikimedia.org/mediawiki/1.38/mediawiki-1.38.1.tar.gz

运行以下命令解压 MediaWiki 源代码 " mediawiki-1.38.1.tar.gz ",并将解压后的目录重命名为 " mediawiki "。这样 MediaWiki 的安装目录就是 " /var/www/mediawiki "。

tar -xvzf mediawiki-*.tar.gz
mv mediawiki-*/ mediawiki/

最后,运行以下命令,将 MediaWiki 安装目录 " /var/www/mediawiki " 的所有者更改为正确的用户 " www-data ",并将权限改为 " 755 "。

sudo chown -R www-data:www-data /var/www/mediawiki
sudo chmod 755 /var/www/mediawiki

为 MediaWiki 设置 Apache2 虚拟主机

现在你将为 MediaWiki 设置 Apache2 虚拟主机。在本示例中,MediaWiki 将使用域名 "wiki.example.local" 运行,并在 Apache2 虚拟主机之上启用安全的 SSL/HTTPS 连接。

在开始创建虚拟主机配置之前,运行以下命令启用 Apache2 的 rewrite 和 ssl 模块。

sudo a2enmod rewrite ssl

使用 nano 编辑器新建虚拟主机配置文件 " /etc/apache2/sites-available/mediawiki.conf "。

sudo nano /etc/apache2/sites-available/mediawiki.conf

将以下配置添加到该文件中。另外,别忘了修改域名和 SSL 证书的路径。

<VirtualHost *:80>
    ServerName wiki.example.local
    ServerAdmin 
[email protected]
    # Redirect Requests to SSL
    Redirect permanent "/" "https://wiki.example.local/"
    ErrorLog ${APACHE_LOG_DIR}/wiki.example.local.error.log
    CustomLog ${APACHE_LOG_DIR}/wiki.example.local.access.log combined
</VirtualHost>
<IfModule mod_ssl.c>
    <VirtualHost _default_:443>
        ServerName wiki.example.local
        ServerAdmin 
[email protected]
        DocumentRoot /var/www/mediawiki
        # According MWiki Manual:Security
        php_flag register_globals off
        ErrorLog ${APACHE_LOG_DIR}/wiki.example.local.error.log
        CustomLog ${APACHE_LOG_DIR}/wiki.example.local.access.log combined
        SSLEngine on
        SSLCertificateFile /etc/letsencrypt/live/wiki.example.local/fullchain.pem
        SSLCertificateKeyFile /etc/letsencrypt/live/wiki.example.local/privkey.pem
        <FilesMatch "\.(cgi|shtml|phtml|php)$">
                SSLOptions +StdEnvVars
        </FilesMatch>
        <Directory /usr/lib/cgi-bin>
                SSLOptions +StdEnvVars
        </Directory>
        <Directory /var/www/mediawiki>
                Options None FollowSymLinks
                #Allow .htaccess
                AllowOverride All
                Require all granted
                <IfModule security2_module>
                        SecRuleEngine Off
                        # or disable only problematic rules
                </IfModule>
        </Directory>
        # According to MWiki Manual:Security
        <Directory /var/www/mediawiki/images>
                # Ignore .htaccess files
                AllowOverride None
                # Serve HTML as plaintext, don't execute SHTML
                AddType text/plain .html .htm .shtml .php .phtml .php5
                # Don't run arbitrary PHP code.
                php_admin_flag engine off
                # If you've other scripting languages, disable them too.
        </Directory>
        #According to MWiki Manual:Security
        <Directory /var/www/mediawiki/images/deleted>
                Deny from all
                AllowOverride AuthConfig Limit
                Require local
        </Directory>
    </VirtualHost>
</IfModule>

完成后保存并关闭文件。

接着,激活虚拟主机配置 "mediawiki.conf",然后验证 Apache2 配置。如果得到 " Syntax OK " 之类的输出信息,则说明 Apache2 配置正确。

sudo a2ensite mediawiki.conf
sudo apachectl configtest

最后,运行下面的命令重启 Apache2 服务并应用新的更改。至此,你已完成 MediaWiki 所需的 LAMP Stack 配置,现在可以开始配置 MediaWiki 了。

sudo systemctl restart apache2

开始安装 MediaWiki

打开 Web 浏览器,在地址栏输入 MediaWiki 的安装域名(即 https://wiki.example.local/)。点击 "set up the wiki" 链接,开始配置你的 MediaWiki 安装。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

为你的 Wiki 选择默认语言,然后点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

现在 MediaWiki 安装程序将检查安装所需的全部条件。确认屏幕上出现 " The environment has been checked. You can install MediaWiki" 提示信息后,点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

填写 MediaWiki 所需的 MariaDB 数据库和用户详细信息,然后再次点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

数据库设置保持默认,点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

现在输入你的 wiki 标题,并填写 MediaWiki 管理员用户和密码的详细信息,然后点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

对于 MediaWiki 的其他选项/配置,可以保持默认,然后点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

再次点击 " Continue " 确认并开始安装 MediaWiki。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

MediaWiki 安装完成后,再次点击 " Continue "。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

现在你需要将 " LocalSettings.php " 文件下载到本地机器,再上传到 MediaWiki 服务器。

另一种做法是,使用 nano 编辑器新建文件 " /var/www/mediawiki/LocalSettings.php "。

nano /var/www/mediawiki/LocalSettings.php

将本地机器上 LocalSettings.php 文件中的脚本内容添加进去。

现在将该文件的所有者更改为正确的用户 " www-data "。

sudo chown www-data:www-data /var/www/mediawiki/LocalSettings.php

现在点击 " enter your wiki " 链接,查看安装结果。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

此时你将看到 MediaWiki 安装的默认首页。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

现在点击右上角的 " Login " 链接,输入 MediaWiki 的管理员用户和密码,然后点击 " Log in "。此时你应该已经登录到 MediaWiki。

Ubuntu 22.04 系统下 MediaWiki 维基站点完整安装与配置教程

总结

恭喜!你已成功在 Ubuntu 22.04 服务器上通过 LAMP Stack 安装了 MediaWiki。采用这种安装方式,你的 MediaWiki 在启用 HTTPS/SSL 的情况下安全运行。