在日常的学习和工作中,会遇到各种各样的知识点和经验,为了能更好的记录整理这些知识点和经验,搭建一个属于自己的wiki知识库还是很有必要的。

I、前言

一款好的 Wiki 工具不仅要能够稳定地保存我们的知识经验,同时也要能够尽量有条理和美观地展示这些知识及它们之间的联系,还需要方便查阅和更新。基于以上几点要求,在众多的开源wiki程序中我个人比较喜欢的是Bookstackwiki.js

不过考虑再三后,我最终选择了Wiki.js(毕竟颜值就是正义)

II、简介


Wiki.js.png
一款基于Node.js的现代,轻量级且功能强大的Wiki应用程序。

Github地址:https://github.com/Requarks/wiki

III、安装

尽管wiki.js的安装非常简单便捷,但是对于小白来说还是相当不易的(我自己也是...)。所以呢,我们这次就使用Docker管理器来管理部署,整个过程简单易懂。

1.准备工作

Wiki.js支持PostgreSQL、MySQL、MariaDB、MS SQL Server等数据库,但是为了获得最佳性能,功能和将来的兼容性,官方强烈建议使用 PostgreSQL

  • Wiki.js的下一个主要版本可能不支持这些引擎(MySQL,MariaDB,MS SQL Server和SQLite)。如果计划在未来几年升级到3.x +,请确保你了解如何将数据库迁移到PostgreSQL。
  • 不建议将SQLite 用于生产部署。

为了以后少折腾,那我们肯定首选 PostgreSQL啊。

2.下载相关面板插件

进入宝塔面板的软件商店,下载 Docker管理器Nginx插件。
wiki.js宝塔相关插件.png

3.Docker相关

进入终端,然后安装docker-compose

wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py
pip install docker-compose


若出现ERROR: Cannot uninstall 'xxx'. It is a distutils installed project and thus we cannot accuratel的情况。

输入:sudo pip install --ignore-installed xxx来强制升级该模块。

查看目前的docker和docker-compose版本。

docker -v && docker-compose -v

然后新建一个 docker-compose.yml配置文件

mkdir -p /opt/docker-wikijs && cd /opt/docker-wikijs && vim docker-compose.yml

写入如下配置:

version: '3.5'

services:
  wiki-db:
    image: postgres:11-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: 你设置的密码
      POSTGRES_USER: wikijs
    logging:
      driver: "none"
    restart: unless-stopped
    volumes:
      - ./data:/www/server/pgsql/data

  wiki:
    image: requarks/wiki:2.4
    depends_on:
      - wiki-db
    environment:
      DB_TYPE: postgres
      DB_HOST: wiki-db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: 你设置的密码
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "3000:3000"

然后up起来就可以了

docker-compose up -d

wikijs-up.png
接着打开Docker管理器,就可以看到我们运行中的容器了。
Docker管理器.png

4.添加Nginx反向代理

新建一个站点,php版本选择纯静态。
添加网站.png

然后在站点设置里选择反向代理,目标URL填写 http://服务器ip:3000即可。

创建反向代理.png


记得要去防火墙放行3000端口。

不出意外的话,打开你新建的网站就可以看到wiki的安装界面了。
Wiki.js Setup.jpg
安装完成后可以去后台设置中文。
欢迎光临  Wiki.js .png
那么,废话不多说,赶紧开始你的知识整理之旅吧~

如果觉得我的文章对你有用,请随意赞赏