知识库搭建方案(wiki知识库搭建)怎么可以错过
一款简洁、漂亮、轻量、功能强大,最重要的是开源的知识库软件。
之前有分享过如何搭建经典的 MediaWiki 来做维基百科或者知识库:Installation of MediaWiki under Docker话说在尝试了多种方案后,对于纯维基类应用来说,可能值得推荐的也就是
MediaWiki 和 DokuWiki 吧两者差别是:如果就是自己维护,类似个人笔记,DokuWiki 会轻量的很多;如果有多人合作,或者内容预估比较大型,还是推荐已经活了几十年的 MediaWiki。
为什么上么说「纯维基」,目前其他耳熟能详的甚至比如 Confluence,其实准确来说只是知识库软件「维基百科」软件和「知识库」软件可以通用,「维基百科」能够无缝替代知识库,但是「知识库」想替代「维基百科」无论从编辑、维护等多方便,都是有一定的复杂度(其实就是比较麻烦)。
这次尝试一个尽管名字叫「Wiki」但是其实是个「知识库」的软件 - wiki.js其官网为:https://js.wiki/ (话说,我也占了一个 .wiki 的坑)按本人习惯,仍然选择「上手最快、运行稳定、维护方便。
」的Docker方式来运行很幸运,官方提供了Docker镜像,省掉了自己手写调试 Dockerfile 的麻烦官方说对于硬件有一些基本要求(预估Docker要吃的):2C1G,1G硬盘空间,实际上如果就是想跑起来看看,大概 。
200M 内存就够数据库要求 PostgreSQL 9.5 + 或 MySQL 8.0 + 或 MariaDB 10.2.7 ,还有其他懒得记那么多了不过官方给了个高亮提示:These engines (MySQL, MariaDB, MS SQL Server and SQLite) will NOT be supported in the next major version of Wiki.js.。
说是 3.x 之后,杂七杂八数据库都不支持了,看来,官方是准备 PostgreSQL 一条路跑到黑了目前 2.x,刚好我服务器上是有现成的 MySQL8,于是,我就按MySQL安装的创建数据库本例使用 。
MySQL8, 创建了一个名为 wiki_js 的库,使用 utf8mb4_bin 编码,然后用户名、密码、权限一套操作不细表;启动服务基于 Docker 方式的好处,就是一行命令就搞定了上面数据库创建好了后,执行如下命令:。
sudo docker run -d \ -p 127.0.0.1:18086:3000 \ --name wiki.js \ --restart unless-stopped \ -v /etc/timezone:/etc/timezone:ro \
-v /etc/localtime:/etc/localtime:ro \ -e DB_TYPE=mysql \ -e DB_HOST=172.17.0.1 \ -e DB_PORT=3306 \
-e DB_NAME=wiki_js \ -e DB_USER=... \ -e DB_PASS=... \ requarks/wiki简要说明几点:我的个人习惯,都不是一步到位映射到公网,都是从
127.0.0.1 缓冲一下,因为我前面有 nginx 做反代;两个 -v 习惯性解决时区和时间的同步问题;对于 MySQL 来说,需要配置 DB_TYPE、DB_HOST、DB_PORT、DB_NAME、DB_USER、DB_PASS
这样几个变量;图省事儿,母机上有个 MySQL,于是 DB_HOST 直接指定到了 172.17.0.1;执行命令后,拉取、启动一气呵成,确认一下是不是拉起来了:
很好,看样子是成功拉起来了,进行下一步之前,需要配置一下 nginxNginx配置来个最简单的配置好了:server { server_name "wiki.micrograils.com"; listen 80;
location / { proxy_pass http://127.0.0.1:18086; proxy_set_header host $host; proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }然后,通过 Certbot 自动配置一个 SSL证书,这样,现在网址就是:
https://wiki.micrograils.com放问网址,提示配置,按要求填写了信息,注意这里直接用了公网的网址的:
点击安装,几秒钟后即可安装完毕,登录界面也很是漂亮:(截个图提示文件过大,放不上来,算了)引导创建首页或者进入管理后台,进管理后台调整下配置吧。
在 Locale 里,下载个语言包,然后可以切换成简体中文(后面那个繁体中文不是默认带的,是我第一次点错了),然后点击应用即可全站刷新为简体中文。
关于时区,通过点击右上角的头像,修改「我的信息」:
到此,基本上就能用的。用法简直是傻瓜式,毋庸多言。
权限配置可能额外值得说一下的,就是其完善的 权限配置 体系,支持用户维度、用户组维度、页面维度等多种方式,及他们的组合。
图片来自于官网,完整的这部分讲解,请参见官方文档(主要太多了)。https://docs.requarks.io/groups- END -
免责声明:本站所有信息均搜集自互联网,并不代表本站观点,本站不对其真实合法性负责。如有信息侵犯了您的权益,请告知,本站将立刻处理。联系QQ:1640731186