介绍
MoinMoin是一个高性能的开源维基引擎,是用Python编写的,它提供了一个功能丰富的维基,具有庞大的用户社区,并且非常可自定义和易于使用。
在本教程中,我们将向您展示如何在新的 Ubuntu 14.04 服务器上设置自己的 MoinMoin wiki,使用 Nginx 作为 Web 服务器和 uWSGI 作为应用引擎。
前提条件
在您开始使用本指南之前,您应该在您的服务器上设置一个单独的非根用户帐户,您可以通过完成 Ubuntu 14.04 初始服务器设置(https://andsky.com/tech/tutorials/initial-server-setup-with-ubuntu-14-04)中的步骤 1 到 4 来学习如何做到这一点。
这个指南假定你有一个新的Ubuntu 14.04服务器。
本教程使用vi来打开和编辑文件. 如果您喜欢不同的编辑器,请随时使用它而不是vi。
让我们开始吧!
安装UWSGI
要开始,让我们安装uWSGI,我们将使用它作为应用程序服务器。
首先,用此命令更新您的 Apt 数据库:
1sudo apt-get update
安装 uWSGI 的一个简单方法是使用 Python 包管理器,即pip。安装 Python-pip 和 Python 库:
1sudo apt-get install python-pip python-dev
安装了 pip,我们可以使用它来安装 uWSGI 的最新稳定版本,使用此命令:
1sudo pip install http://projects.unbit.it/downloads/uwsgi-lts.tar.gz
如果 uWSGI 安装成功,您将看到一个看起来像这样的消息:
1############## end of uWSGI configuration #############
2 total build time: 36 seconds
3 *** uWSGI is ready, launch it with /usr/local/bin/uwsgi ***
4
5Successfully installed uWSGI
6Cleaning up...
现在安装了 uWSGI 应用程序服务器,我们已经准备好下载和安装 MoinMoin。
安装 Moinmoin
在安装 MoinMoin 之前,请查看您想在这里安装的版本: MoinMoin Releases。
找到 MoinMoin 的最新通用版本,并将其 URL 复制到您的剪辑板:
当本教程编写时最新的通用版本是 1.9.8,所以示例 URL 指向 1.9.8 版本. 使用此 wget 命令将 MoinMoin 档案下载到您的主目录(取代您复制的下载 URL):
1cd ~
2wget http://static.moinmo.in/files/moin-1.9.8.tar.gz
现在用 tar 提取档案:
1tar zxvf moin-1.9.8.tar.gz
更改通过提取 MoinMoin 档案创建的目录:
1cd moin-*
要构建 MoinMoin Python 应用程序并将其复制到 /usr/local,请运行以下命令:
1sudo 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 应用之前,我们需要准备其配置文件。
更改安装目录:
1cd /usr/local/share/moin
然后将样本服务器配置文件 moin.wsgi 复制到当前目录:
1sudo cp server/moin.wsgi .
打开服务器配置文件以编辑:
1sudo vi moin.wsgi
在import sys, os行下方,插入以下行:
1sys.path.insert(0, '/usr/local/lib/python2.7/dist-packages/')
2sys.path.insert(0, '/usr/local/share/moin/')
这将配置应用程序与MoinMoin代码的位置和维基配置文件的位置。
接下来,创建并打开uwsgi.ini:
1sudo vi uwsgi.ini
将下列行插入文件中:
1[uwsgi]
2uid = www-data
3gid = www-data
4socket = /usr/local/share/moin/moin.sock
5chmod-socket = 660
6logto = /var/log/uwsgi/uwsgi.log
7
8chdir = /usr/local/share/moin/
9wsgi-file = moin.wsgi
10
11master
12workers = 3
13max-requests = 200
14harakiri = 30
15die-on-term
保存和退出. uwsgi.ini 文件将用于与 uWSGI 应用程序服务器一起加载 MoinMoin 应用程序. 在这里,我们正在指定用户、插件和服务器配置和日志文件,该应用程序应该使用,包括其他东西。
现在创建 /var/log/uwsgi 目录,这是我们配置 uWSGI 应用程序以将其日志编写到:
1sudo mkdir -p /var/log/uwsgi
2sudo chown www-data /var/log/uwsgi
接下来,让我们创建一个 initctl 脚本,将用于启动我们的 MoinMoin 应用程序. 此脚本将允许 MoinMoin 在服务器上启动,并允许您控制 uWSGI 应用程序与 start moin 和 stop moin。
使用以下命令创建并打开moin.conf:
1sudo vi /etc/init/moin.conf
输入以下配置线:
1description "moin uwsgi service"
2
3start on runlevel [2345]
4stop on runlevel [!2345]
5
6chdir /usr/local/share/moin
7exec /usr/local/bin/uwsgi /usr/local/share/moin/uwsgi.ini
8respawn
重要的是chdir和exec行中的路径准确反映了MoinMoin安装的地方,以及uwsgi二进制和uwsgi.ini文件存在的地方。
您现在可以启动应用程序服务器(‘sudo start moin’),但我们首先将对维基配置做一些更改。
配置wiki
现在 uWSGI 应用程序服务器已经准备好了,我们将要配置实际的 Wiki。
转到 MoinMoin 安装目录并复制样本 wikiconfig.py 文件:
1cd /usr/local/share/moin
2sudo cp config/wikiconfig.py .
现在打开文件来编辑:
1sudo vi wikiconfig.py
在这里,我们可以配置维基的各个方面,至少要配置以下内容:
sitename: 您的Wiki 的标题*page_front_page: 删除此行以启用正常前页superuser: 您希望作为维基管理员使用的用户的名称。
查找以下行(如果需要的话,通过删除# 删除评论),并根据您的喜好更改突出值:
1sitename = u'My First Wiki'
2
3 page_front_page = u"FrontPage"
4
5 superuser = [u"WikiAdmin", ]
这是一个Python文件,所以请确保保存已经存在的任何插件。
在启动应用程序之前,让我们更改 MoinMoin 目录的所有权和权限:
1sudo chown -R www-data: /usr/local/share/moin
2sudo chmod -R o-rwx /usr/local/share/moin
使用此命令启动 uWSGI 应用程序服务器:
1sudo start moin
MoinMoin现在正在运行,但我们需要安装配置 Nginx,Web服务器,才能使用它。
安装和配置 Nginx
我们将使用 Nginx 作为我们的 Web 服务器,所以让我们现在安装和配置它。
使用 apt 安装 Nginx:
1sudo apt-get install nginx
现在,转到网站可用目录,并为维基创建一个新的服务器封锁配置文件。
1cd /etc/nginx/sites-available
2sudo vi moin
在文件中,插入以下行(用您自己的信息代替突出部分):
1server {
2 server_name wiki.example.com;
3
4 access_log /var/log/nginx/access.log;
5 error_log /var/log/nginx/error.log;
6
7 location / {
8 include uwsgi_params;
9 uwsgi_pass unix:///usr/local/share/moin/moin.sock;
10 uwsgi_modifier1 30;
11 }
12}
这是一个裸体的 Nginx 配置. 请自由进行任何您认为适合您的服务器的更改。
现在,让我们在网站启用目录中创建一个符号链接到我们的新服务器封锁配置文件:
1cd /etc/nginx/sites-enabled
2sudo ln -s ../sites-available/moin .
然后删除到默认服务器块的符号链接:
1sudo rm default
现在moin服务器块将是默认的。
重新启动 Nginx 以加载新设置:
1sudo service nginx restart
你的新维基正在运行!它可以在你的服务器的IP地址或主机名称。
创建 Wiki 超级用户
在使用您的Wiki之前,您需要做的最后一件事就是创建一个超级用户帐户,这个帐户具有博客的管理权限,我们将这个用户的名字配置为超级用户字段在wikiconfig.py文件中,在本教程的Configure Wiki部分,所以请确保您在这里使用相同的名称。
在网页浏览器中连接到您的服务器,通过其IP地址或主机名称:http://wiki.example.com`
您将受到以下首页的欢迎:
点击页面顶部的登录链接。
在登录页面上,单击 你可以创建一个现在 链接。
在创建帐户页面上,输入匹配您的超级用户配置的名称(使用的例子是WikiAdmin),并输入您的密码和电子邮件地址,然后点击创建个人资料按钮。
如果一切顺利,你应该看到以下成功消息:
是的!您的wiki现在已经准备好使用。
结论
现在你有你的 MoinMoin wiki 运行,你已经准备好使用它来协作! 自由添加内容和用户,或更改其配置和主题。