怎样在 CentOS 7 上安装 MoinMoin

MoinMoin 是一个开源的、基于文件系统的 wiki 引擎,用 Python 编写。 如今,MoinMoin 被广泛应用于开源社区。 许多供应商,包括但不限于 Apache、Ubuntu、Debian 和 Python,已经使用 MoinMoin wiki 引擎建立了自己的 wiki。

在本教程中,您将学习怎样在 CentOS 7 服务器实例上设置单个 MoinMoin wiki 站点。 为了服务于 MoinMoin,Nginx 和 uWSGI 也将被安装。

先决条件

  • 一个全新的 Vultr CentOS 7 x64 服务器实例。 说它的 IP 地址是 203.0.113.1.
  • 一个 sudo 用户。
  • 服务器实例已使用 EPEL YUM 存储库更新到最新的稳定状态。

第 1 步:安装和配置 Nginx

在您启动并运行 MoinMoin 之前,您需要为其设置一个 Web 服务器,而 Nginx 是实现此目的的绝佳选择。

1) 为方便起见,您可以使用 EPEL YUM 存储库安装 Nginx:

sudo yum install nginx -y

2)如下配置Nginx,使其可以与uWSGI和MoinMoin一起工作。

使用 vi 文本编辑器打开主要的 Nginx 配置文件 /etc/nginx/nginx.conf

sudo vi /etc/nginx/nginx.conf

http { } 段,找到 server { } 部分摘录如下:

http {

...

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;
    root         /usr/share/nginx/html;

    # Load configuration files for the default server block.
    include /etc/nginx/default.d/*.conf;

    location / {
    }

...

2.1)使用服务器的IP地址为Nginx定义一个服务器名称:

找到这一行:

server_name _;

替换为:

server_name  203.0.113.1;

2.2)将Nginx配置为使用uWSGI协议进行通信:

找出 location / { } 分割:

location / {
}

插入两行如下:

location / {
    uwsgi_pass unix:///run/moin/moin.sock;
    include uwsgi_params;
}

Save 并退出:

:wq!

3) 或者,您可以使用以下命令测试修改后的配置:

sudo nginx -t

如果没有任何问题,您应该会看到如下输出:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

4) 最后,启动 Nginx 服务并使其在系统启动时自动启动:

sudo systemctl start nginx.service
sudo systemctl enable nginx.service

第 2 步:安装和配置 MoinMoin

1) 使用以下命令安装 MoinMoin 1.9.9,这是我撰写本文时 MoinMoin 的最新稳定版本:

cd
wget https://static.moinmo.in/files/moin-1.9.9.tar.gz
tar -zxvf moin-1.9.9.tar.gz
cd moin-1.9.9
sudo python setup.py install --force --record=install.log --prefix='/opt/moin' --install-data=/srv

运行上述命令后,MoinMoin 可执行文件和所有库文件将安装在 /opt/moin 目录,用于构建您自己的单个 MoinMoin wiki 的数据将安装在 /srv/share/moin 目录。

2)创建一个名为的配置文件 moin.wsgi 在 MoinMoin 数据目录中使用同名模板文件:

cd /srv/share/moin/
sudo cp server/moin.wsgi moin.wsgi

使用打开新创建的配置文件 vi 文本编辑器:

sudo vi /srv/share/moin/moin.wsgi

找到以下行:

import sys, os

在下面添加以下两行:

sys.path.insert(0, '/opt/moin/lib/python2.7/site-packages/')
sys.path.insert(0, '/srv/share/moin/')

Save 并退出:

:wq!

3) 创建另一个 MoinMoin wiki 配置文件,用于自定义您自己的 wiki:

cd /srv/share/moin
sudo cp config/wikiconfig.py wikiconfig.py

您可以在此文件中为您的 MoinMoin wiki 配置许多功能,但现在,您只需要设置以下几个功能。

定义站点名称(假设它是 My First Wiki):

sudo sed -i 's/Untitled Wiki/My First Wiki/' /srv/share/moin/wikiconfig.py

定义一个超级用户(假设它是 admin):

sudo sed -i '/#superuser/a    superuser = [u"admin", ]' /srv/share/moin/wikiconfig.py

注意:您稍后仍需要从 MoinMoin 网页界面注册此用户。

禁用反向 DNS 查找以进行加速:

sudo sed -i '$a    log_reverse_dns_lookups = False' /srv/share/moin/wikiconfig.py

4) 更改已安装的 MoinMoin 文件的所有权:

sudo chown -R nginx:nginx /srv/share/moin
sudo chown -R nginx:nginx /opt/moin

第三步:安装和配置uWSGI

作为 Nginx Web 服务器和 Python 应用程序之间的枢纽,uWSGI 旨在使用高性能 uWSGI 协议产生最佳性能。 接下来,我们来看看怎样安装和配置 uWSGI 来运行 MoinMoin。

1)使用pip安装uWSGI如下:

sudo yum install -y python-devel python-setuptools python-pip gcc
sudo pip install --upgrade pip
sudo pip install uwsgi

如果一切顺利,您应该会看到类似于以下内容的输出:

...
Successfully installed uwsgi-2.0.15

2)安装uWSGI后,需要创建一个目录来存放uWSGI日志文件:

sudo mkdir /var/log/uwsgi
sudo chown nginx:nginx /var/log/uwsgi

3)另外,需要创建一个目录来存放MoinMoin的socket文件:

sudo mkdir /run/moin
sudo chown nginx:nginx /run/moin

4)创建一个uWSGI配置文件 uwsgi.ini 在 MoinMoin wiki 数据目录中并按如下方式填充它:

cat <<EOF | sudo tee -a /srv/share/moin/uwsgi.ini
[uwsgi]
uid = nginx
gid = nginx
socket = /run/moin/moin.sock
chmod-socket = 660
logto = /var/log/uwsgi/uwsgi.log

chdir = /srv/share/moin
wsgi-file = /srv/share/moin/moin.wsgi

master = true
processes = 3
max-requests = 200
harakiri = 30
vacuum = true
enable-threads = true
EOF

5)为了使用systemd来管理uWSGI,你需要为uWSGI设置一个systemd单元文件:

cat <<EOF | sudo tee -a /etc/systemd/system/uwsgi.service
[Unit]
Description=uWSGI instance to serve MoinMoin
After=syslog.target

[Service]
ExecStart=/usr/bin/uwsgi --ini /srv/share/moin/uwsgi.ini
RuntimeDirectory=uwsgi
Restart=always
KillSignal=SIGQUIT
Type=notify
StandardError=syslog
NotifyAccess=all

[Install]
WantedBy=multi-user.target
EOF

6)启动uWSGI服务,使其在系统启动时自动启动:

sudo systemctl start uwsgi.service
sudo systemctl enable uwsgi.service

第 4 步:允许网络访问

如下配置防火墙规则,以便用户可以使用 Web 浏览器访问您的 MoinMoin wiki 站点:

sudo firewall-cmd --zone=public --permanent --add-service=http
sudo firewall-cmd --reload

第 5 步:从 Web 浏览器访问 MoinMoin

现在,一个 MoinMoin wiki 站点已经在您的 CentOS 7 服务器实例上启动并运行。

将您喜爱的网络浏览器指向 https://203.0.113.1,然后您将进入 MoinMoin 网页界面。 注册并以超级用户身份登录 admin 我们之前提到过,然后您就可以随心所欲地管理您的维基站点。

如有必要,您可以通过编辑 /srv/share/moin/wikiconfig.py 文件。

本教程到此结束。 谢谢阅读。

注:本教程在Vultr VPS上测试通过,如需部署请前往Vultr.com