¶ wiki.js的安装
- Use wiki.js 2.5 and postgress DB 14
- 参考
git@gitee.com:niuhongxing/wiki.js.git 中的readme.md - 使用docker compose的方式拉起 wiki的服务
- db的数据通过volume的方式存放到宿主机上, 可以备份这个目录的方式来备份数据库
- 数据可以同步到git上
¶ wiki.js内容的git方式备份的配置
- 只是备份内容网页，wiki本身的设置在数据库中需要对数据库进行定时备份
- 以gitee做为同步的源
- gitee上创建存储备份的repo
- 按照下图创建相应的git 存储备份（双向）
图1 设置git存储备份
- 可以通过手动出发同步备份
¶ wiki.js配置的备份
- wiki.js中的用户信息，locale等的备份需要备份数据库，首先获取宿主机上数据的目录
(base) root@xxx# docker volume ls DRIVER VOLUME NAME local ae779733ecd6447cfd14e78e0cd1e0cf2b67e4d7eba291b99e23d0cdd98289a4 local wikijs_db-data local wikijs_home-data
(base) root@xxx# docker inspect wikijs_db-data [ { xxxxxx "Driver": "local", "Labels": { "com.docker.compose.project": "wikijs", "com.docker.compose.version": "1.25.0", "com.docker.compose.volume": "db-data" }, "Mountpoint": "/var/lib/docker/volumes/wikijs_db-data/_data", "Name": "wikijs_db-data", xxx } ]
- 备份上述得到的宿主机上的数据目录
- 运行
tar cvf databackup.tar /var/lib/docker/volumes/wikijs_db-data/_data来 备份数据到databackup.tar - 恢复时，将数据拷贝到对应的目录即可
- 运行
mv databackup.tar / - 运行
tar xvf databackup.tar
¶ wiki.js的AI cloud search
- 采用azure global的账号，因为wiki.js内部把cloud search服务的域名已经写死进去了，不能连接国内的服务
- 设置细节如下图所示
图 设置AI cloud search
- 索引由wiki.js创建，具体的索引字段参考wiki AIsearch
¶ wiki.js的权限配置
- wiki.js 有组的概念，也有用户的概念，在组的概念中，对于页面URL的权限配置是最关键的。
- wiki.js的权限围绕URL进行，URL是结构化的，最佳实践是目录层级用 / 字符进行隔离，每个层级有自己的意思。
- 每个用户自己的敏感目录，可以都以自己用户的名字做为URL开始，比如/niuguyue/
¶ 普通的用户组 user 设定
权限说明：
- 只能看它目录下的文章（假定目录名字为niuguyue）
- 并且也能够看默认的主页，就是整个wiki的默认主页，点击最左上角的wiki图标就能够到达。用正则表达式能够比较好的解决这个问题：
- 在权限的组->page rules中设置 patch match rgex,设置如下规则：表示URL的路径中，以niuguyue为开头的网页，或者可以读地址为home的网页：
^(niuguyue)|^(home)$
¶ 设置参考用图
图1 设置跳转url
图2 设置group权限
图2 设置页面权限
¶ 匿名用户组 guest 设定
权限说明：
- 只能看非敏感目录下的文章（假定目录niuguyue为敏感目录）
- 并且也能够看默认的主页，就是整个wiki的默认主页，点击最左上角的wiki图标就能够到达。用正则表达式能够比较好的解决这个问题：
- 在权限的组->page rules中设置 patch match rgex,设置如下规则：表示URL的路径中，不能读取以niuguyue和Tech为开头的网页，正则表达式默认是与的关系：
^(?!niuguyue)^(?!Tech)
¶ regx参考
¶ 调试错误
¶ 日志错误
- 查看日志：docker logs -f wikijs_wiki_1
- 把所有的错误输出到一个文件中 docker logs wikijs_wiki_1 >/tmp/t
- 查看是哪个文件有错误， grep Failed /tmp/t |awk '{print $NF}'|sort|uniq
- 文件中的两个保留字很关键， title: 和 description: 注意关键字后面有空格
- 错误调试完毕后，把日志清空，下一次排错时不会受干扰：
ls -lh $(find /var/lib/docker/containers/ -name *-json.log)
#找到容器的ID
docker ps | grep wikijs_wiki_1
#找到对应的日志文件
ls -lh $(find /var/lib/docker/containers/ -name *-json.log) | grep grep 714a62e872ad
# 清空日志文件，注意，不要删除
cat /dev/null > /var/lib/docker/containers/714a62e872adfd78206fe3dee29489aa6122534dedea51661462c23e523d9df2/714a62e872adfd78206fe3dee29489aa6122534dedea51661462c23e523d9df2-json.log
¶ commit 错误
Wiki 同步，显示错误提示:
error: cannot pull with rebase: Your index contains uncommitted changes.
error: please commit or stash them
修复方法如下：
1. 登录到wiki的容器，
docker exec -it wikijs_wiki_1 bash
2. 运行如下：
git commit -m 'fix error'
git pull --rebase origin master
3. 等5分钟 wiki 同步正常