使用 Docker 搭建你的Wiki（MoinMoin）

本文使用「署名 4.0 国际 (CC BY 4.0)」许可协议，欢迎转载、或重新修改使用，但需要注明来源。 署名 4.0 国际 (CC BY 4.0)

本文作者: 苏洋

创建时间: 2019年02月02日 统计字数: 2632字 阅读时间: 6分钟阅读 本文链接: https://soulteary.com/2019/02/02/build-your-own-wiki-with-docker-moinmoin.html

使用 Docker 搭建你的Wiki（MoinMoin）
前面介绍了三款不同的 RSS 系统的快速搭建使用，接下来我将演示几种不同的 Wiki 系统，同样是借助 Docker 和 Traefik 进行快速搭建，本篇是第二篇，MoinMoin。

如果你有阅读过我之前写的文章，那么参考本篇文章将文章搭建起来，应该只需要3分钟或者更少，如果你没有看过，那么可以点击本文相关的文章标签，阅读过往的文章。

关于 MoinMoin
MediaWiki 是一款开源并且支持免费使用的软件，由Python编写，同样天生跨平台，并被广泛使用在各种知识社区内。

当然你可能会觉得陌生，但是当说提及几个站点之后，你可能会大呼原来如此：

• Python 官方Wiki
• Ubuntu 官方社区
• Debian 官方Wiki
• WireShark 官方Wiki
  除此之外，还有 GNOME、WineHQ、ID3、GCC、GRUB 等一堆大名鼎鼎的软件都使用了它。

套用“互联网圈”的话，如果说 MediaWiki 做的是 C 端市场，那么 MoinMoin 主打的则是 B 端的企业服务。

但是在开源生态里，MoinMoin 的周边生态就不比 MediaWiki 了，不过好在全面够用，想了解的同学可以戳此访问。

他目前的稳定版本是 v1.9.10 ，v2.0版本正在开发的路上，有需求的同学可以去 GitHub 上了解更多，本文基于稳定版本撰写。

话不多说，开始实战。

使用 Compose 运行 MoinMoin
配合下面的配置文件，使用 Compose 可以一键启动一个使用 文本文件 作为数据储存的 MoinMoin ，配置很简单，20行代码左右。

version: "3"

services:

# https://hub.docker.com/r/olavgg/moinmoin-wiki/
moinmoin:
restart: always
image: olavgg/moinmoin-wiki:1.9.10.1
environment:
- NOSSL=1
labels:
- "traefik.enable=true"
- "traefik.frontend.rule=Host:moinmoin.lab.io"
- "traefik.frontend.passHostHeader=true"
- "traefik.frontend.entryPoints=http,https"
networks:
- traefik
expose:
- 80
volumes:
- ./storage:/usr/local/share/moin/data

networks:
traefik:
external: true

当使用 docker-compose up 将应用启动之后，便可以通过我们配置的域名进行访问了，本例中地址为 moinmoin.lab.io 。（我使用 Traefik 提供服务发现，如果你不会操作，请访问我的历史文章，了解 Traefik 如何使用。）

在展示程序界面和常规操作之前，我们说一下我们的数据存放地址，以及未来插件要在哪里进行存放和应用。

在上面的配置文件 docker-compose.yml 的同级目录会自动生成 storage 目录，在目录内会包含用户数据相关的内容，如下所示：

storage
├── cache
│   ├── README
│   ├── __session__
│   ├── spellchecker.dict
│   └── wikiconfig
├── dict
│   └── dummy_dict
├── edit-log
├── event-log
├── initialized
├── intermap.txt
├── meta
├── pages
│   ├── BadContent
│   └── FrontPage
├── plugin
│   ├── action
│   ├── converter
│   ├── events
│   ├── filter
│   ├── formatter
│   ├── macro
│   ├── parser
│   ├── theme
│   ├── userprefs
│   └── xmlrpc
└── user

如果你需要应用官方市场的插件或者主题，请放置于 storage/plugin/ 目录内的指定文件夹中，并重启 MoinMoin。

我们的 Wiki 条目数据会被存放在 storage/pages 中，所以请定期对该位置数据进行备份保存。

MoinMoin 的常规操作
打开浏览器，可以看到 MoinMoin 已经运行起来了。

双击任意一个“帖子”，可以直接进入编辑器界面。

点击保存，第一条 Wiki 条目的更新操作就完成了。

点击条目中的信息链接，可以直观的查看到内容的变更记录，并执行不同版本的对比，获取更多的信息。

最后
如果你对本文聊到的 Docker 、Traefik 、Compose 还不是很熟悉，欢迎阅读我的以往文章，补全对上述技术的认识，希望我的文章可以对你有帮助。

接下来我会继续介绍几种不同的 Wiki 系统的安装配置、魔改，如果你也在考虑如何维护一套让自己用起来舒服的知识管理工具，可以继续关注，下回再见。

— EOF