同一台 win10 服务器跑多个 wiki（包括 DokuWiki、django-wiki）

最新推荐文章于 2024-06-25 16:15:56 发布
最新推荐文章于 2024-06-25 16:15:56 发布
阅读量1.2k 收藏 1
点赞数
分类专栏： 运维 文章标签： dokuwiki django waitress nginx wiki
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/goocheez/article/details/103459471
版权

一、需求

在一台 win10 服务器上，需要搭建多个各不相干的 wiki 系统，用于不同小组访问。眼下最便捷的 wiki 系统，就是 dokuwiki 了，官方自带微型 apache 服务器、纯文本保存内容、无需数据库，直接运行就好了。

Dokuwiki的一个弱点是无法很好利用 Markdown 语法的便利性，因此又考虑在同一台服务器上搭建一个支持 Markdown 语法的 wiki。经了解，django-wiki 支持。

二、思路简述

  1. 利用 nginx 做反向代理，通过域名区别不同的wiki
  2. DokuWiki 可利用自带的微型 apache 服务器，服务在不同的端口上，实现多个实例
  3. django-wiki 可利用 waitress 来部署在Windows下

三、详细动手

安装第一个 DokuWiki 1

到 DokuWiki 的官方下载页面（https://download.dokuwiki.org），给 Include Web-Server 选项打钩，去掉 Languages 列表中除了中文之外的其他所有语言，Popular Plugins 选项中的内容，根据实际需求选择，然后点击 Download 即可。

将下载到本地的压缩包解压的合适位置（譬如 d:\Public\DokuWiki1 下），然后运行自带的 run.cmd，访问 http://127.0.0.1:8800 ，看是否成功

安装第二个 DokuWiki

利用上述步骤下载的压缩包，复制一份到另一目录（譬如 d:\Public\DokuWiki2 下），修改其中 server\conf 目录下的 httpd.conf 文件，将端口号改为 8802，然后运行自带的 run.cmd，访问 http://127.0.0.1:8802，看是否成功。

至此，两个 DokuWiki 已安装好。

安装 django-wiki 2

  1. 安装 python 3.7

  2. 修改 pip 的镜像指向。新建 C:\Users\Administrator\pip\pip.ini 文件，并添加下述内容：

    [global]
index-url = https://mirrors.aliyun.com/pypi/simple/

[install]
trusted-host=mirrors.aliyun.com

  3. 安装 django-wiki 模块。 打开 CMD 窗口，直接运行 pip install wiki 即可。若不想将相关模块全局安装，可利用 python -m venv venv 命令新建虚拟环境、激活之后，再运行 pip install 相关命令。

  4. 新建 django-wiki 项目。进入 d:\public 目录，运行 django-admin.exe startproject django-wiki

  5. 修改 django-wiki 的配置。修改 d:\public\django-wiki\django-wiki\settings.py 文件，首先改 INSTALLED_APPS 参数，添加如下模块：

    'django.contrib.sites.apps.SitesConfig',
'django.contrib.humanize.apps.HumanizeConfig',
'django_nyt.apps.DjangoNytConfig',
'mptt',
'sekizai',
'sorl.thumbnail',
'wiki.apps.WikiConfig',
'wiki.plugins.attachments.apps.AttachmentsConfig',
'wiki.plugins.notifications.apps.NotificationsConfig',
'wiki.plugins.images.apps.ImagesConfig',
'wiki.plugins.macros.apps.MacrosConfig',

    其次，修改 TEMPLATES 参数，在 context_processors 处，添加如下内容

     'sekizai.context_processors.sekizai',

    最后，添加如下内容在 settings.py 的末尾：

    SITE_ID = 1
STATIC_ROOT = 'D:\Public\django-wiki\mywiki\static' #用于生产环境下存储静态文件

MEDIA_URL = "/media/"
MEDIA_ROOT = os.path.join(BASE_DIR, "media")

from django.urls import reverse_lazy
LOGIN_REDIRECT_URL = reverse_lazy('wiki:get', kwargs={'path': ''})

LANGUAGES = [
    ('en-us', 'English'),
    ('zh-hans', 'Chinese'),
]

  6. 创建数据库表格。进入 d:\public\django-wiki目录，运行 python manage.py migrate

  7. 添加管理员。运行 python manage.py createsuperuser ，为网站创建一个管理员

  8. 修改项目 url 的处理规则。将新建项目自带的 urls.py 改为如下内容：

    from django.contrib import admin
from django.urls import include, path
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),
    path('notifications/', include('django_nyt.urls')),
    path('', include('wiki.urls')),
]
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

至此，整个项目即可通过 python manage.py runserver 8001 命令，在http://127.0.0.1:8001 地址处看到效果

最后，我们利用专业的 wsgi 服务器来部署 django-wiki。经了解 3，windows 环境下的 wsgi 服务器用 waitress 最简单，如果在 linux 环境下，也可以用 gunicorn、uWSGI 等。当然，不怕麻烦的可以考虑使用 apache 加上 mod_wsgi 来实现。

  1. 关闭调试开关。继续打开 d:\public\django-wiki\django-wiki\settings.py 修改 DEBUG、ALLOWED_HOSTS 变量
    DEBUG = False
ALLOWED_HOSTS = ['127.0.0.1','localhost']
  2. 整理静态文件。进入项目 d:\public\django-wiki\ 目录下，运行 python manage.py collectstatic
  3. 安装 waitress 服务器。使用命令安装之： pip install waitress，当前最新版本 1.3.1。安装完毕后，可以发现在 python 的目录下多了 waitress-serve.exe 文件。若使用虚拟环境，则可在虚拟环境目录下找到它 venv\Scripts\waitress-serve.exe 。
  4. 运行服务器：运行 waitress-serve --listen 127.0.0.1:8804 django-wiki.wsgi:application 即可启动服务器。 4

批量启动 wiki 服务们

至此，多个 wiki 系统已经安装完毕。我们需要提供一个快捷的手段，以便一次性启动他们。

另外，前面安装的两套 DokuWiki 一个问题，就是需要维持一个黑色的 CMD 窗口以便运行 apache 服务器。一旦关闭那个 CMD 窗口， apache 服务器进程就被关闭了。而 waitress-serve 命令也需要在 CMD 窗口下运行。这个问题可以通过“隐藏批处理窗口“相关技巧来解决。

打开 Dokuwiki 自带的 run.cmd 文件，可以看到核心语句就是一句 start /B mapache.exe，因此我们可以单独写一个批处理文件，一次性启动两个 apache 进程和 waitress。新建 start_Dokuwikis.cmd 文件于d:\Public下，内容如下： 5

@echo off
rem 下面这两句，实现了无窗口的脚本启动。其中第二句在第一次运行时会退出，再带着参数 h 运行第二次，此时就跳转到真正的代码处
if "%1" == "h" goto begin 
mshta vbscript:createobject("wscript.shell").run("%~nx0 h",0)(window.close)&&exit

:begin
rem 启动两个小型 apache 服务器
cd D:\Public\DokuWiki1\server
start /B mapache.exe
cd D:\Public\DokuWiki2\server
start /B mapache.exe
rem 若有python虚拟环境，可使用下面这一句
rem call D:\public\django-wiki\venv\Scripts\activate.bat
cd D:\Public\django-wiki
waitress-serve --listen 127.0.0.1:8804 django-wiki.wsgi:application

安装 nginx

到 nginx 官方下载最新版（编写此文时为 1.16.1）的 windows 系统包，直接解压到 D:\Public\nginx 下即可，然后打开 cmd 窗口，运行 start d:\public\nginx\nginx.exe 即可。然后修改 nginx\conf\nginx.conf文件6

    ...
    include server_wiki_1.conf;
    include server_wiki_2.conf;
    include server_django-wiki.conf;

    server {
        listen       80;
        server_name  *.abc.org;
    ...

在nginx\conf 目录下，新建 server_wiki_1.conf 文件，内容大致如下：

server {
    listen 80;
    server_name wiki1.abc.org;
    charset utf-8;

    location /{
        proxy_pass http://127.0.0.1:8800; 
    }
    access_log logs/private_wiki.log;
}

再新建server_wiki_2.conf 文件，内容与此大同小异，就是修改一下对应的域名与端口号而已。
最后新建 server-django-wiki.conf 文件，内容如下：

server {
    listen 18099;
    server_name wiki3.xacourt.org;
    charset utf-8;
    
    location /media/ {
        root D:/Public/django-wiki/mywiki/; 
        try_files $uri =404;
    }

    location /static/ {
        alias D:/Public/django-wiki/mywiki/static/;
    }
    location / {
        proxy_pass http://127.0.0.1:8804;
    }

    access_log logs/server_django-wiki.log;
}

现在，我们用 nginx.exe -t 来测试一下配置文件是否有问题，没问题的话，运行 nginx.exe -s reload 即可加载最新配置文件。此时试试 wiki1.abc.org 、 wiki2.abc.org、wiki3.abc.org 几个域名，看看是否均正常访问。

四、参考

  1. DokuWiki 的官方文档 ↩︎

  2. django-wiki 的官方文档 ↩︎

  3. 各 wsgi 服务器对比 ↩︎

  4. waitress 的官方文档 ↩︎

  5. 在批处理文件中如何调用 python 虚拟环境激活脚本（activeate.bat） ↩︎

  6. nginx 相关文档 ↩︎

goocheez
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Django实现的Wiki系统django-wiki.zip
07-18
使用django搭建的wiki知识管理系统Demo：https://demo.django.wiki/环境需求：django>=1.5=2.2.0django-mpttdjango-sekizaisorl-thumbnailPillow (Python Imaging Library)Python>=2.6 or Python>=3.2 标签：django
搭建WIKI-dokuwiki
asiali666的博客
05-28 2018
1、官网下载地址：https://download.dokuwiki.org/ 以Windows为例：（linux，mac 参考https://cloud.tencent.com/developer/article/1337420 ） 若本地没有PHP环境，注意在“Include Web-Server”处勾选“MicroApache (Windows) 1、解压后打开run.cmd，按界面提示填...
Windows7部署：使用Waitress作为服务器部署django项目
最新发布
qq_45225756的博客
06-25 521
好处 可以确保在 Windows 7 上使用 Waitress 作为 Django 3 项目的 WSGI 服务器，并且可以受益于多线程处理能力。也可以使用python文件启动，在 Django 项目的根目录下，创建一个。文件，并添加以下内容。
Windows下搭建dokuwiki过程
weixin_30273175的博客
08-30 486
Windows下搭建dokuwiki过程： windows版本： 本地环境win10、xampp(apache+mariadb(mysql)+PHP+perl) 一、web环境装备，dokuwiki是一套web程序，依托于web环境，本文用apache作为web 1、下载xampp https://www.apachefriends.org/zh_cn/index.html 注...
material-dokuwiki：DokuWiki的材料设计模板
02-04
您可以先在style.ini文件中的多个颜色主题之间进行选择。 从那里开始，您可以使用整个材质图标包完全自定义边栏。 访问上的模板页面 它基于 ，进行了一些小的更改和调整。 设计 美丽的主题 优雅的编辑 现在，材料...
dokuwiki-template-bootstrap3：DokuWiki的基于引导程序的模板
01-31
DokuWiki的Bootstrap3模板 产品特点 HTML5和CSS3 React灵敏 基于Bootstrap 3.x的模板 字形图标和FontAwesome图标 AnchorJS支持 提前输入支持 高可通过配置管理器自定义 许多html和DokuWiki钩子 侧边栏支持（左和/或...
docker-dokuwiki:基于Alpine Linux和Nginx的DokuWiki Docker映像
05-01
关于 基于Alpine Linux的 Docker映像。 如果您有兴趣，我的其他Docker映像！...cd docker-dokuwiki # Build image and output to docker (default) docker buildx bake # Build multi-platform image docker build
dokuwiki-plugin-prosemirror:工作正在进行中
04-28
适用于DokuWiki的prosemirror插件 DokuWiki的WYSIWYG编辑器 可以在找到此插件的所有文档。 如果您手动安装此插件，请确保lib/plugins/prosemirror/其安装在lib/plugins/prosemirror/ -如果该文件夹的名称不同，它...
Dokuwiki-Plugin-Doodle2:dokuwiki.org的投票或投票功能
05-19
Dokuwiki-插件-Doodle2 dokuwiki.org的投票或投票功能 该插件已被积极使用，但它正在寻找维护者。 我在业余时间写了这个插件。 我真的很高兴，它被蜜蜂所使用。 但是由于我进入了其他项目，所以我没有时间维护此...
Python库 | waitress-0.9.0b1.tar.gz
04-19
资源分类：Python库 所属语言：Python 资源全名：waitress-0.9.0b1.tar.gz 资源来源：官方 安装方法：https://lanzao.blog.csdn.net/article/details/101784059
dokuwiki-plugin-foldablelist:一个dokuwiki插件来折叠n个项目后的列表
04-11
dokuwiki插件可折叠列表 使n项后无序列表不可见的插件 如何使用？ 只需将无序列表包装到标签中 <foldablelist> * list item 1 * list item 2 * list item 3 </foldablelist> 该列表可以通过标记或插件标签之类的dokuwiki插件生成。 进阶使用 <foldablelist> {{topic>ns1:sub-ns?tag}} </foldablelist> 使用标签插件（主题组件）从名称空间ns1 / sub-ns中用“ tag”标签的所有页面生成列表 配置 可以通过dokuwikis admin config页面配置此插件到目前为止，只有1个项目需要配置： collapse_after: 5隐藏其余列表之前要显示的列表项数，默认值：5 2020年新增功能： 您可以将配置传递给每个实例：
djwiki:django中的Wiki页面
05-04
djwiki django中的Wiki页面 特征 添加类别以对文章进行排序/排列 添加/编辑/删除文章 查看编辑历史记录/摘要 单元测试 将测试运行为：-$ python manage.py test --keepdb 设定说明 简单验证码 您必须安装以下依赖项：-apt-get -y install libz-dev libjpeg-dev libfreetype6-dev python-dev 然后使用以下方法安装简单的catcha：-pip install枕头pip install django-simple-captcha
django-wakawaka:使用Django框架以Python编写的简单Wiki应用程序
05-14
django-wakawaka django-wakawaka是一个使用Django框架以Python编写的超简单Wiki系统。 Wiki页面之间的链接由其CamelCase命名方案自动解析。 它自动跟踪页面的修订更改，同时提供还原到较早状态的功能。 它还具有相当全面的权限集成，可以处理Django的默认create / edit / delete权限。 Wakawaka是一个应用程序，缩进到现有项目中。 示例项目的一些屏幕截图： 安装： 将wakawaka放入django项目中settings.py中的INSTALLED_APPS中。 将(r'^wiki/', include('wakawaka.urls')),到您的urls.py中。 就这样。 Wakawaka除了Django 1.11或更高版本外没有其他依赖项。 配置： Wakawaka负责Django的权限系统
搭建自己的公司业务百科网页 2（发布公司百科网站）
11-02 558
而需要设置的内容包括“隧道名称”、“协议”、“本地地址”、“域名类型”、“二级子域名（Sub Domain）”、“地区”几项。在完成这几项设置后，就可以点击页面下方的“创建”按钮，将我们所做的设置保存下来，同时也为本地的dokuwiki网页创建了一条内网穿透数据隧道，而dokuwiki的公共互联网地址可以在“状态”项下的“在线隧道列表”中找到。想要构建一条能长期运行存在的数据隧道，我们需要先登录cpolar官网，从“仪表台”左侧的“预留”键进入预留隧道的设置页面，在这个页面中，找到“保留二级子域名”栏位。
Django-Wiki: 一个强大的、可扩展的基于Django的维基引擎
gitblog_00057的博客
03-18 467
Django-Wiki: 一个强大的、可扩展的基于Django的维基引擎 django-wikiA wiki system with complex functionality for simple integration and a superb interface. Store your knowledge with style: Use django models.项目地址:https:/...
ubuntu下部署wiki与Django （使用mod-python与mod-wsgi）
HappyBevis的专栏
03-10 858
最近使用Django python写了个网站，后来又想部署wiki。所以就开始用apache来部署这两个服务。 网上的很多资料我扫过一遍，很多都比较旧了，想来想去。不如把自己动手的过程分享出来，让大家省时省力把。 第一部分：使用mod_python(cgi方式)部署wiki  注意：本来准备就用mode_python把wiki和django部署完毕就行了，结果悲剧的发现：1.5以上的
部署 Django
weixin_74075792的博客
02-19 1061
补充说明：关于项目部署，历来是开发和运维人员的痛点。造成部署困难的主要原因是大家的Linux环境不同，这包括发行版、解释器、插件、运行库、配置、版本级别等等太多太多的细节。因此，一个成功的部署案例，往往很难移植到别的环境下，总是要填许多坑。那么，别人的案例就没有参考价值了么?当然不是，部署的过程其实就是参考很多的成功案例，摸索出自己适用的方式！这过程中需要什么？熟练的Linux技能是最基本的！一些部署的经验和灵活的思维也是要有的。不惧怕满屏的英文错误信息，能从中抓住问题的耐心更是要有的。
Markdown到Dokuwiki实时同步：借助mdsyncfunction整合优势
本文介绍了一种将Markdown文件自动实时同步到DokuWiki的方法，旨在结合Markdown的便捷编辑和DokuWiki的集中管理与全局搜索功能。通过PHP编写的功能插件，实现在Typora等Markdown编辑器中编辑后，文档内容能即时在...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值