使用 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 Docke

MediaWiki docker file

MediaWiki default admin user and password

MediaWiki configuration settings

Trouble uploading after installation

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏软件测试经验与教训

爬一爬有道词典~

4058
来自专栏JAVA后端开发

通用数据级别权限的框架设计与实现(5)-总结与延伸思考

继上篇文章通用数据级别权限的框架设计与实现(4)-单条记录的权限控制后,通用数据级别权限的框架设计已经实现,但我们就这样满足了吗? 代码也只是花了我两个晚上完...

872
来自专栏IMWeb前端团队

react 的数据管理方案:redux 还是 mobx?

本文作者:IMWeb jerytang 原文出处:IMWeb社区 未经同意,禁止转载 mobx 简介 和 redux 类似,mobx 是一个数据管理库...

3887
来自专栏网站漏洞修补

网站安全检测 对thinkphp通杀漏洞利用与漏洞修复建议

thinkphp在国内来说,很多站长以及平台都在使用这套开源的系统来建站,为什么会这么深受大家的喜欢,第一开源,便捷,高效,生成静态化html,第二框架性的易于...

2811
来自专栏大数据和云计算技术

Cosmos DB的5种事物一致性

TP和AP最重要的区别就是事物。事务是指对系统进行的一组操作,为了保证系统的完整性,事务需要具有ACID特性,具体指原子性(Atomic)一致性(Consist...

4305
来自专栏JetpropelledSnake

Django学习笔记之使用 Django项目开发框架

1783
来自专栏liuchengxu

[译]使用pelican搭建一个数据科学博客

写博客是一个证明你的技能,进一步加深学习和积累受众的一个非常好的方式。已经有非常多的数据科学和编程博客帮助它们的作者找到工作,或是建立了非常重要的联系。撰写博客...

1002
来自专栏无题

mongoDB常见问题整理

多方收集整理成此篇,以后也会持续更新。 为什么要使用Nosql 关系型数据库采用的结构化的数据,NoSQL采用的是键值对的方式存储数据。 mongo使用场景: ...

4464
来自专栏大数据和云计算技术

HBase框架基础(二)

HBase的基础框架,将分成几个章节对HBase进行描述,不当之处还望大家批评指正。下面是了解HBase基础架构的第二部分。

1402
来自专栏salesforce零基础学习

salesforce零基础学习(八十五)streaming api 简单使用(接近实时获取你需要跟踪的数据的更新消息状态)

Streaming API参考链接: https://trailhead.salesforce.com/en/modules/api_basics/units/...

3328

扫码关注云+社区

领取腾讯云代金券