不需要数据库的DokuWiki

上周发完 TiddlyWiki,有网友留言 dokuwiki 更好用,所以再来个 DokuWiki 安装教程,大家装起来自己评判吧🙂

连续 2 周的 wiki,估计大家都烦了,从 outline 的阅读数据看,下篇的阅读量只有上篇的一半了。下周还有一篇老苏承诺的 ourline 的本地认证,之后的一段时间内不会再发 wiki

最近工作挺忙,差不多 2 个礼拜几乎没有写出新的稿子,现在发的基本上还是春节期间完成的,上周末本来准备折腾点新东西,结果接到网友报告,老苏打的 lskypro 镜像有 2 个严重的 bug,花了 3 天时间才解决😳,也没太多时间测试,毕竟精力有限,年纪在这放着呢。


什么是 DokuWiki ?

Dokuwiki 是一个简单易用且用途广泛的开源 wiki 软件,不需要数据库。它以其简洁易读的语法受到用户的喜爱。易于维护、备份和集成使其成为管理员的最爱。内置的访问控制和身份验证连接器使 DokuWiki 在企业环境中特别有用,其充满活力的社区贡献的大量插件允许超越传统 wiki 的广泛用例。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 dokuwiki ,选择第三个 linuxserver/dokuwiki,版本选择 latest

docker 文件夹中,创建一个新文件夹,并将其命名为 dokuwiki

文件夹 装载路径 说明
docker/dokuwiki /config 存放设置

端口

本地端口不冲突就行,不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
2280 80
2243 443

环境

可变
TZ 设为 Asia/Shanghai
PUID 设为 1000
PGID 设为 1000

运行

在浏览器中输入 http://群晖IP:2280 就能看到主界面

中文

在浏览器中输入 http://群晖IP:2280/install.php,可进行权限号账号、密码、读写策略、语言等设置

由于安全上的考虑,该脚本只能用于全新且未做任何改动的 DokuWiki 安装包。也就是说只能运行一次,理论上删除 /docker/dokuwiki/dokuwiki/conf 下的 3 个文件,local.phpusers.auth.phpacl.auth.php 应该就可以

选择 zh 后,页面会自动刷新,刷新之后就是中文了

设置完账号后

跳转到欢迎界面

插件

登录后进入管理 界面

在线安装

进入 扩展管理器 –> 搜索安装

搜索 markdown 插件

安装成功后

离线安装

上面这种方式是在线安装,还可以离线安装,通过官网插件下载地址👇下载插件

  • 下载地址:https://www.dokuwiki.org/plugins

插件很多

找到你要下载的插件,点 Download

下载的插件是 zip 格式,可以通过 手动安装

上传扩展

安装成功也有提示

开始写作

老苏还是习惯 markdown

除了前后要加 <markdown> / </markdown> 标签外,其他的都是一样的

这比让老苏去学习 DokuWikiFormatting Syntax 简单多了,长长的一页,还是英文,真心有点学不动了

移动端

下载客户端

老苏找到的是 Android 的,可以在 https://f-droid.org/en/packages/com.fabienli.dokuwiki/ 下载,最新版本是 0.20

启用 XML-RPC

在设置前,需要先启用 XML-RPCDokuWiki 有一个 XML-RPC API,可用于从其他应用程序访问 wiki 或与之交互。出于安全原因,只允许通过 HTTPS 访问 XML-RPC

管理 –> 配置管理

认证设置 部分,勾选 激活远程 API 系统。这允许其他程序通过 XML-RPC 或其他机制来访问维基。

别忘记拉到底部点 保存

反向代理

通过 Nginx Proxy Manager 做反代

启用 https 协议

设置客户端

打开 Android 客户端, Settings –> Synchronisation中将 server URL地址栏中的 mydokuwiki 替换为你的域名,并输入 UserPassword

默认的服务器地址:https://mydokuwiki/lib/exe/xmlrpc.php

不知道是什么原因, github 上的图片加载不出来

而实际上通过 Display online page 在浏览器中看,是正常的

参考文档

splitbrain/dokuwiki: The DokuWiki Open Source Wiki Engine
地址:https://github.com/splitbrain/dokuwiki

How to Install DokuWiki on Your Synology NAS – Marius Hosting
地址:https://mariushosting.com/how-to-install-dokuwiki-on-your-synology-nas/