如何在Ubuntu 14.04与Nginx的安装了MoinMoin

简体中文MoinMoin是用Python编写的一款高性能的开源wiki引擎。它提供了一个庞大的社区用户的一个功能丰富的维基,非常个性化和容易使用。 MoinMoin的使用由几个组织公开自己的维基,如Ubuntu,...

介绍

MoinMoin是一个用Python编写的高性能开源Wiki引擎。 它提供了一个功能丰富的wiki,有一个大型社区的用户,是非常可定制和易于使用。 MoinMoin被一些组织用于他们的公共wiki,如Ubuntu,Apache,FreeBSD等。

在本教程中,我们将向您展示如何在一个全新的Ubuntu 14.04服务器上设置自己的MoinMoin wiki,使用Nginx作为Web服务器和uWSGI作为应用程序引擎。 这个特定的设置是一个单一的wiki,它是非常快速和记忆效率。

先决条件

在开始使用本指南之前,您应该在服务器上设置一个单独的非root用户帐户。 你可以学习如何通过完成1-4的步骤做这个初始服务器设置为Ubuntu 14.04

本指南假设您有一个新鲜的Ubuntu 14.04服务器。

本教程使用vi打开和编辑文件。 如果你喜欢不同的编辑器,随意代替使用它vi适用。

让我们开始吧!

安装uWSGI

首先,让我们安装uWSGI,我们将使用它作为应用程序服务器。

首先,使用以下命令更新Apt数据库:

sudo apt-get update

安装uWSGI一个简单的方法是使用Python包管理器,到pip 现在安装Python-pip和Python库:

sudo apt-get install python-pip python-dev

使用pip安装,我们可以使用它来安装最新的稳定版本的uWSGI与此命令:

sudo pip install http://projects.unbit.it/downloads/uwsgi-lts.tar.gz

如果uWSGI安装成功,您将看到一条如下所示的消息:

    ############## end of uWSGI configuration #############
    total build time: 36 seconds
    *** uWSGI is ready, launch it with /usr/local/bin/uwsgi ***

Successfully installed uWSGI
Cleaning up...

现在,uWSGI应用程序服务器已安装,我们准备下载并安装MoinMoin。

安装Moinmoin

在安装了MoinMoin之前,查找要在这里安装版本: MoinMoin的发布 你可能想使用最新的一般版本。

查找最新的MoinMoin常规版本,并将其URL复制到剪贴板:

MoinMoin下载

本教程编写的最新一般版本是1.9.8,因此示例URL指的是1.9.8版本。 使用此wget命令将MoinMoin的档案下载到你的home目录(代替您复制下载网址):

cd ~
wget http://static.moinmo.in/files/moin-1.9.8.tar.gz

现在用tar解压缩归档文件:

tar zxvf moin-1.9.8.tar.gz

切换到通过提取MoinMoin归档创建的目录:

cd moin-*

要构建MoinMoin的Python应用程序并将其复制到/usr/local ,运行以下命令:

sudo python setup.py install --prefix=/usr/local

假设你是在Python 2.7版,Python脚本安装MoinMoin的代码包/usr/local/lib/ python2.7 /dist-packages/和MoinMoin的数据,其余/usr/local/share/moin

现在MoinMoin Python应用程序已安装,但尚未配置。 让我们现在配置它。

配置MoinMoin应用程序

在实际启动MoinMoin应用程序之前,我们需要准备其配置文件。

更改到安装目录:

cd /usr/local/share/moin

然后复制样本服务器配置文件, moin.wsgi ,到当前目录:

sudo cp server/moin.wsgi .

打开服务器配置文件进行编辑:

sudo vi moin.wsgi

下面的import sys, os线,插入以下行:

sys.path.insert(0, '/usr/local/lib/python2.7/dist-packages/')
sys.path.insert(0, '/usr/local/share/moin/')

保存并退出。 这将使用MoinMoin代码的位置和wiki配置文件所在位置来配置应用程序。

接下来,创建并打开uwsgi.ini

sudo vi uwsgi.ini

将以下行插入文件:

[uwsgi]
uid = www-data
gid = www-data
socket = /usr/local/share/moin/moin.sock
chmod-socket = 660
logto = /var/log/uwsgi/uwsgi.log

chdir = /usr/local/share/moin/
wsgi-file = moin.wsgi

master
workers = 3
max-requests = 200
harakiri = 30
die-on-term

保存并退出。 uwsgi.ini文件将被用于加载与uWSGI应用程序服务器的应用程序的MoinMoin。 这里,我们指定应用程序应该使用的用户,套接字和服务器配置和日志文件,以及其他内容。 随意调整工人数量,最大请求或可接受的会话持续时间(harakiri)。

现在创建/var/log/uwsgi目录,这是我们配置的uWSGI应用到其日志写到:

sudo mkdir -p /var/log/uwsgi
sudo chown www-data /var/log/uwsgi

接下来,让我们创建一个initctl脚本,用于启动我们的MoinMoin应用程序。 该脚本将在服务器启动启用了MoinMoin,并允许您控制与uWSGI应用程序start moinstop moin

创建并打开moin.conf用下面的命令:

sudo vi /etc/init/moin.conf

插入以下配置行:

description "moin uwsgi service"

start on runlevel [2345]
stop on runlevel [!2345]

chdir /usr/local/share/moin
exec /usr/local/bin/uwsgi /usr/local/share/moin/uwsgi.ini
respawn

保存并退出。 在该路径是很重要chdirexec线准确地反映在安装MoinMoin的位置,并在那里的uwsgi二进制和uwsgi.ini文件存在。

您现在可以启动应用程序服务器( sudo start moin ),但我们会先维基配置进行一些更改。

配置Wiki

现在uWSGI应用程序服务器准备就绪,我们将要配置实际的Wiki。

切换到MoinMoin的安装目录,并将样品wikiconfig.py文件:

cd /usr/local/share/moin
sudo cp config/wikiconfig.py .

现在打开文件进行编辑:

sudo vi wikiconfig.py

这里我们可以配置Wiki的各个方面。 至少,我们要配置以下项目:

  • sitename :你的Wiki的标题
  • page_front_page :取消此行,使正常的头版
  • superuser :您要为维基的管理员使用的用户名。 此项目也必须取消注释

找到以下行(如果有必要取消其注释,删去# ),并更改突出显示的值根据自己的喜好:

    sitename = u'My First Wiki'

    page_front_page = u"FrontPage"

    superuser = [u"WikiAdmin", ]

保存并退出。 这是一个Python文件,因此请务必保留已存在的任何缩进。

在启动应用程序之前,让我们更改MoinMoin目录的所有权和权限:

sudo chown -R www-data: /usr/local/share/moin
sudo chmod -R o-rwx /usr/local/share/moin

使用以下命令启动uWSGI应用程序服务器:

sudo start moin

MoinMoin现在运行,但是我们需要安装配置Nginx,Web服务器,然后才能使用它。

安装和配置Nginx

我们将使用Nginx作为我们的网络服务器,让我们现在安装和配置它。

安装Nginx与apt:

sudo apt-get install nginx

现在切换到sites-available目录,并为维基一个新的服务器模块的配置文件。 我们会打电话给我们的moin

cd /etc/nginx/sites-available
sudo vi moin

在文件中,插入以下行(用您自己的信息替换突出显示的部分):

server {
    server_name wiki.example.com;

    access_log /var/log/nginx/access.log;
    error_log /var/log/nginx/error.log;

    location / {
        include uwsgi_params;
        uwsgi_pass unix:///usr/local/share/moin/moin.sock;
        uwsgi_modifier1 30;
    }
}

这是一个裸骨骼的Nginx配置。 随意做出任何您认为适合您的服务器的更改。

现在,让我们创建一个符号链接在我们的新的服务器块配置文件中sites-enabled目录:

cd /etc/nginx/sites-enabled
sudo ln -s ../sites-available/moin .

并删除符号链接default服务器块:

sudo rm default

现在, moin服务器块将是默认的。

重新启动Nginx以加载新设置:

sudo service nginx restart

你的新Wiki已经开始运行了! 它可在您的服务器的IP地址或主机名。

创建Wiki超级用户

在使用Wiki之前,您最后要做的是创建超级用户帐户。 此帐户对博客有管理员权限。 我们配置了该用户的名superuser在该领域wikiconfig.py文件,在本教程的配置维基部分,所以一定要在这里使用相同的名称。

连接到Web浏览器的服务器,通过它的IP地址或主机名: http:// wiki.example.com

您将收到以下首页的问候:

首页

点击页面顶部的登录链接。

登录

在登录页面,点击就可以创建一个链接现在

创建

在创建帐户页面上,输入相匹配的超级用户的配置使用(“WikiAdmin”的例子),你的密码和电子邮件地址的名称,然后单击创建配置文件按钮。

如果一切顺利,您应该会看到以下成功消息:

用户创建

而已! 您的wiki现在可以使用。

结论

现在你已经开始运行MoinMoin wiki,你已经准备好使用它来协作! 随意添加内容和用户,或更改其配置和主题。