介绍
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复制到剪贴板:
本教程编写的最新一般版本是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 moin
和stop 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
保存并退出。 在该路径是很重要chdir
和exec
线准确地反映在安装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,你已经准备好使用它来协作! 随意添加内容和用户,或更改其配置和主题。