wiki.js 是一款开源、颜值极高,功能强大的wiki软件,基于Node构建,本身支持嵌入draw.io画流程图,这个是真的方便,就果断部署来体验下。官网github

部署

官方有详细的个平台部署文档,这里记录下基于极空间docker的部署,这里直接部署的最新版本v2.5.300.

  • 镜像拉取

  • 点击部署

路径映射:

端口映射:

环境变量:

部署存粹是个人使用,就直接用的sqlite,目前官方支持这几种数据库:mysql, postgres, mariadb, mssql,sqlite

初始化配置

  • 设置密码

启动后通过ip+端口访问,填写邮箱和登录密码,site URL可以先不用管,下面开关是否允许官方收集信息来优化产品。

  • 设置语言

登录后选择进入管理台:

进入后台后,在Local里下载本地语言并切换到本地语言

  • 权限管理

访客默认有查看权限,可以在用户组里把访客权限干掉:

  • 存储

这里相当于一个备份存储,可选择种类很多,我这里就启用了一个git存储,下面可以配置同步方向、同步周期等

这里需要注意的是,填的git仓库和分支一定要先创建好,如过配置没问题还是同步失败,有可能是下面这个问题,登录到容器找到git仓库目录执行下git config --global --add safe.directory /wiki/data/repo

cfe4c4613525:/wiki/data/repo# git remote -v
fatal: detected dubious ownership in repository at '/wiki/data/repo'
To add an exception for this directory, call:

git config --global --add safe.directory /wiki/data/repo
cfe4c4613525:/wiki/data/repo# git config --global --add safe.directory /wiki/data/repo

其他一些功能可以根据官方文档自行探索,对于个人使用目前的配置已经满足了。

创建页面

首次进入需要创建首页,根据习惯选择编辑器即可,支持markdown,创建类似目录的层级关系话可以在下面路径里直接填写

编辑支持嵌入draw.io画图,并且画完后支持在原来基础上编辑,这个功能真的是太棒了,很多支持插入的画图的工具都是画完后插入一张图片就不可编辑了,这里是直接渲染的数据,不是图片,所以可以继续编辑。

wiki 本身还有很多偏向团队方面的功能,适合小型团队作为知识管理的工具,本身颜值也高。槽点的话就目前体验来看,渲染速度不是很快每次编辑完发布需要等待;侧边栏不能收起,不过说是3.x版本会支持。