使用 Docker 部署 MediaWiki

MediaWiki

0 简介

MediaWiki 是 Wikipedia 使用的网站解决方案的开源版，以个人观点来看，Wiki 在这个时代显得不够时尚，且不支持 MarkDown 等新兴的标记语言，另外页面的组织方式采用了自己的一套管理语言，上手需要一定的学习成本。不过经典总归是经典。

MediaWiki 也提供了官方的 Docker image，这就节省了不少安装环境的工作量，接下来就来看看私有 MediaWiki 站点是如何搭建起来的吧。

1 使用 docker 安装 MediaWiki

第一部分中的命令除非特殊说明，都需要 root 权限。

1.1 安装 Docker

第一部自然是要先安装 docker，我们使用官方的 docker 安装脚本来规避不同操作系统安装命令不同的问题，命令运行结束后，docker 就安装好了，如果你的环境中还没有 wget 命令，CentOS 和 RedHat 用 yum install -y wget，Debian 和 Ubuntu 系统用 apt install -y wget 安装。

# wget -qO- https://get.docker.com/ | sh

接下来需修改 docker 的下载源：

# cat /etc/docker/daemon.json 
{
  "registry-mirrors": ["https://registry.docker-cn.com",
                       "http://hub.c.163.com"]
}

# systemctl restart docker.service

1.2 下载所需的 docker images

MediaWiki 需要 MySQL，且 MediaWiki 镜像中不提供 MySQL，所以 MySQL 镜像也须要下载。

# docker pull wikimedia/mediawiki:1.30.0-wmf4
# docker pull mysql/mysql-server:5.7

1.3 启动 MediaWiki 和 MySQL，并关联

MediaWiki 需要依赖于 MySQL，所以要先启动 MySQL，再启动 MediaWiki，不然启动会失败。而且需要开启 MySQL 的远程连接权限。

# docker run -d --name mediawiki-mysql -e MYSQL_ROOT_PASSWORD=<mysql-root-password> mysql/mysql-server:5.7
# docker exec -it mediawiki-mysql /bin/bash
bash-4.2# mysql -uroot -p<mysql-root-password>
......
mysql> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY '<mysql-root-password>' WITH GRANT OPTION;
mysql> FLUSH PRIVILEGES;

然后启动 MediaWiki。

# docker run --name facethink-mediawiki --link mediawiki-mysql:mysql -p 80:80 -e MEDIAWIKI_DB_PASSWORD=<mysql-root-password> -d wikimedia/mediawiki:1.30.0-wmf4

需要注意的是，启动 MediaWiki 时，需要使用 --link 参数来关联之前启动的 MySQL。
另外 -p 将 MediaWiki docker 中的 80 端口和 docker 宿主机上的 80 端口绑定在了一起。在浏览器中访问 docker 宿主机的 IP 就可以访问刚刚建好的 MediaWiki 网站了。不过要保证宿主机上 80 端口没有被其他程序占用，不然 docker run 命令无法执行成功。

下面就是刚刚建好的 wiki 站点页面，过程并不复杂，如果遇到问题，可以流言讨论：

MediaWiki main page

2. MediaWiki 配置

2.1 MediaWiki 的默认管理员

Wiki 是有了，不过这么素的界面，当然是要做些配置，那么就需要管理员权限了，可在安装过程中，我们并不知道这些信息。不过我们可以从 MySQL 中找到。

# docker exec -it mediawiki-mysql -- mysql -uroot -p<mysql-root-password>
......
mysql> use mediawiki;
mysql> select * from user;
mysql> select * from user;
+---------+-----------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------+------------------+-------------------+---------------------+----------------+----------------------------------+--------------------------+----------------------------------+--------------------------+-------------------+----------------+-----------------------+
| user_id | user_name | user_real_name | user_password                                                                                                                             | user_newpassword | user_newpass_time | user_email          | user_touched   | user_token                       | user_email_authenticated | user_email_token                 | user_email_token_expires | user_registration | user_editcount | user_password_expires |
+---------+-----------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------+------------------+-------------------+---------------------+----------------+----------------------------------+--------------------------+----------------------------------+--------------------------+-------------------+----------------+-----------------------+
|       1 | Admin     |                | :pbkdf2:sha512:30000:64:CyuznKx44JuAClGG7avxow==:V9MLp3r/obJIjv+BR2Bs0eCvyWkyDK0eveqEE+9HiUgxvMjzu26kGBz+BcZSmlRssLswzq1j3a+PVuh6AFEaxQ== |                  | NULL              | NULL                | 20180622063649 | 490898f83d4ad9d1ec1c0276a740209b | NULL                     | d3bcbd107e31220c891334c8e1ba0440 | 20180629063644           | 20180622050411    |              0 | NULL 
+---------+-----------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------+------------------+-------------------+---------------------+----------------+----------------------------------+--------------------------+----------------------------------+--------------------------+-------------------+----------------+-----------------------+

看以看到默认账户是 Admin，但密码是加密的，好在 root 用户是有权限修改这个密码的，

mysql> UPDATE user SET user_password = MD5( CONCAT( user_id, '-', MD5( 'NEWPASS' ) ) ) WHERE user_id =1;

至此，我们终于可以用管理员的权限登陆了。

login page

2.2 使用 php 变量配置 MediaWiki 站点地址

假设已经为站点申请了域名：wiki.example.com，如何让 wiki 自己能够识别这个域名呢？
这需要登陆到 MediaWiki 的 docker 中去，修改配置文件。MediaWiki 是 php 语言编写的，所以配置文件以 .php 后缀结尾。

$ sudo docker exec -it facethink-mediawiki /bin/bash
root@1a0f3692a08d:/# vi /var/www/html/LocalSettings.php
...
$wgServer = "http://wiki.example.com";
...

php 可以动态读取配置文件，所以无需重启即可生效。

2.3 修改 Logo

默认 logo 是金色的葵花，那么如何更换成自己心仪的图标呢？
首先需要开启 wiki 的文件上传功能：

$ sudo docker exec -it facethink-mediawiki /bin/bash
root@1a0f3692a08d:/# vi /var/www/html/LocalSettings.php
...
$wgEnableUploads = true;
...

然后给 /var/www/html/images 目录添加全部用户开启所有权限。

$ sudo docker exec -it facethink-mediawiki /bin/bash
root@1a0f3692a08d:/# chmod 777 /var/www/html/images

然后在 Upload File 页面上传文件：

upload file page

找到文件所在目录：

# ll /var/www/html/images/thumb/6/64/example.png/120px-example.png

修改 php 配置文件：

$ sudo docker exec -it facethink-mediawiki /bin/bash
root@1a0f3692a08d:/# vi /var/www/html/LocalSettings.php
...
$wgLogo = $wgScriptPath . "images/thumb/6/64/example.png/120px-example.png";
...

好了，刷新一下页面，看看更换 logo 之后效果如何吧。

2.4 邮箱配置

MediaWiki 的邮箱配置很坑，调试不太方便，而且默认配置很容易被判定成垃圾邮件， 或者无效，被拒掉，需要调整发件人的地址来规避。这里用的是 Elastic Email 的邮件服务器系统，这里大家需要自己注册。

配置部分还是需要修改 /var/www/html/LocalSettings.php

# cat  /var/www/html/LocalSettings.php
...
$wgServerName = "example.com";
$wgPasswordSender = "";

$wgSMTP = array(
    'host' => 'smtp.elasticemail.com',
    'port' => 2525,
    'IDHost' => 'wiki.example.com',
    'username' => <user-id>,
    'password' => <password>,
    'auth' => true
);
...

同时需要安装 PHP 与邮件发送相关的插件，这里还需要说明一点，MediaWiki 的 docker 虽然能运行 PHP 代码，但实际上并没有安装 PHP，原因是 Apache 能够解析运行 PHP，LAMP 果然是集成度很高。而安装 pear 是要依赖于 PHP 环境的，所以必须要安装 PHP。

# apt install php, php-pear
# pear install mail, net_smtp

2.5 限制用户权限

如果不想开放 Wiki 的公开注册，并且在未登陆时，限制可见的页面的话，还是需要通过对 LocalSettings.php 的定制实现。

# cat /var/www/html/LocalSettings.php
...
# Prevent new user registrations
$wgWhitelistAccount = array("user" => 0, "sysop" => 1, "developer" => 1);
$wgGroupPermissions['*']['createaccount'] = false;
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgWhitelistRead = array("Main Page", "Special:Userlogin", "Wikipedia:Help");
...

2.6 添加用户

现在已经关闭了用户注册，那用户只能手动添加了。MediaWiki 也提供添加用户的脚本：

# apt install php-mbstring, php-mysql
# php /usr/src/mediawiki/maintenance/createAndPromote.php --conf=/var/www/html/LocalSettings.php --force <user-id> <password>

3. 参考文档

• MySQL Docker
• MediaWiki docker file
• MediaWiki default admin user and password
• MediaWiki configuration settings
• Trouble uploading after installation