DokuWiki 2026-07-14c 介绍与选型指南

DokuWiki 2026-07-14c 联网溯源选型指南：无数据库纯文件架构、官方特性与要求（PHP 8.2+）、与 MediaWiki/XWiki/Wiki.js/BookStack 的量化对比与选型建议。

DokuWikiDokuWiki2026/10/22

DokuWiki 2026-07-14c 介绍与选型指南

目标：以官方渠道联网溯源的方式（来源与查询日期逐条标注，查询日期均为 2026-10-22）介绍 DokuWiki——定位、核心架构、功能特性、快速开始路径、适用场景与同类量化选型对比，帮助读者判断它是否适合你的知识库场景。

一、环境信息

本文是认知与选型篇，全部事实来自官方渠道联网溯源，不含本地实测结论；部署与命令实测见系列后续篇章。溯源来源清单：

来源URL用途
DokuWiki 官方主站https://www.dokuwiki.org/dokuwiki产品定义、官方优势列表
官方系统要求https://www.dokuwiki.org/requirementsWeb 服务器与 PHP 版本要求
官方下载通道https://download.dokuwiki.org稳定版版本号与发行形态
官方源码仓库https://github.com/splitbrain/dokuwiki版本 tag、许可证、社区数据
shields.io 徽章https://img.shields.io/github/stars/splitbrain/dokuwiki.json 等各对比项目 GitHub 星数取证
官方发行包https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgzCOPYING 许可证原文

统一查询日期：2026-10-22。下文各条均以此为准。

二、软件概述

DokuWiki 是一个「简单易用、高度灵活的开源 wiki 软件，不需要数据库」（官方主站原文："DokuWiki is a simple to use and highly versatile Open Source wiki software that doesn't require a database."，来源 https://www.dokuwiki.org/dokuwiki ，查询日期 2026-10-22）。官方对它的三个定位词是：语法干净易读、维护/备份/集成对管理员友好、内建访问控制与企业级认证连接器。

关键身份信息（来源与查询日期标注于各条）：

项目事实来源
当前稳定版2026-07-14c "Mort"（官方 stable 通道版本号；GitHub tag release-2026-07-14c）download.dokuwiki.org stable tarball 包内 VERSION 文件与 shields.io 版本徽章，2026-10-22
开源许可证GPL-2.0（GNU General Public License Version 2）官方发行包内 COPYING 文件原文，2026-10-22
实现语言PHP官方 requirements（"DokuWiki is written in the PHP scripting language"），2026-10-22
数据存储无数据库，普通文件存储页面/图片/索引/历史版本官方安装器页声明（"uses ordinary files for the storage of wiki pages and other information"），2026-10-22
Web 服务器任何支持 PHP 的均可，主流 Apache/Nginx，官方点名 IIS、LiteSpeed、lighttpd、OpenBSD httpd、Caddy、Abyss 已知可用https://www.dokuwiki.org/requirements ，2026-10-22
PHP 要求当前稳定版要求 PHP 8.2 或更高（"The current stable release requires PHP in version 8.2 or higher"）https://www.dokuwiki.org/requirements ，2026-10-22
界面语言官方声明支持超过 50 种语言（"Over 50 languages supported"）https://www.dokuwiki.org/dokuwiki ，2026-10-22

官方在主站给出的自述优势共六条（来源 https://www.dokuwiki.org/dokuwiki ，查询日期 2026-10-22）：Easy to install and use（安装使用简单）、Low system requirements（系统要求低）、Built-in Access Control Lists（内建 ACL）、Large variety of extensions（大量扩展）、Over 50 languages supported（50+ 语言）、Device independent（设备无关）。

三、核心架构

从官方声明与发行结构看，DokuWiki 的架构极简：Web 服务器 + PHP 解释器 + 一组目录文件，三者之外别无依赖。官方安装器页明确："DokuWiki uses ordinary files for the storage of wiki pages and other information associated with those pages (e.g. images, search indexes, old revisions, etc)"（来源官方安装器页 https://www.dokuwiki.org/installer ，查询日期 2026-10-22）。

按官方发行包的目录划分（来源：官方 stable tarball 结构，2026-10-22），运行时由四类目录构成：

目录承担职责架构意义
data/页面（纯文本）、媒体文件、全文搜索索引、历史修订全部业务数据的家，备份=拷贝
conf/主配置、辅助配置表、用户账本、ACL 表无数据库的「配置库」
inc/ + vendor/程序核心与 Composer 依赖渲染、认证、插件机制
lib/模板、插件、媒体处理入口扩展挂载点

无数据库带来的架构级特征（官方定位的直接推论）：

  1. 部署面最小：官方 requirements 只要求「Web 服务器 + PHP」两件套，无数据库服务进程（来源 https://www.dokuwiki.org/requirements ，2026-10-22）；
  2. 备份恢复语义极简：页面即文件，tar 两个目录即为全量备份；
  3. 伸缩以「单机文件 + Web 层横向扩展」为形态：官方定位是个人/团队/企业内部 wiki，官方主站强调 enterprise context 下靠内建 ACL 与认证连接器取胜，而非分布式集群（来源 https://www.dokuwiki.org/dokuwiki ，2026-10-22）。

💡 技术拓展：wiki 引擎的存储底座不止「纯文件」一种，主流形态对比——

存储形态代表产品特点
纯文件（无数据库）DokuWiki部署/备份最简，版本管理用文件归档
关系数据库MediaWiki、Wiki.js、BookStack强一致性、便于大规模全文检索，但多一套数据库运维
数据库+ORM 抽象XWikiJava 生态，可跑在多种关系库上

DokuWiki 选择纯文件，与其「低系统要求、易备份」的官方卖点互为因果；代价是高并发写入与超大规模检索不是它的主战场。

四、功能特性

按官方主站优势列表与发行包内建组件展开（来源标注于条目末尾，统一查询日期 2026-10-22）：

  1. 内建访问控制（ACL）：官方主站将 "Built-in Access Control Lists" 列为核心优势，并称"内建访问控制与认证连接器使 DokuWiki 在企业场景特别有用"（来源 https://www.dokuwiki.org/dokuwiki ）。捆绑 ACL Manager 插件与 authplain/authldap/authad/authpdo 认证后端（来源官方发行包 conf 与插件清单，2026-10-22）。
  2. 扩展生态：官方主站称 "the large number of plugins contributed by its vibrant community allow for a broad range of use cases beyond a traditional wiki"（大量社区插件支撑超越传统 wiki 的用例），官方扩展库在 https://www.dokuwiki.org/plugins （2026-10-22）。
  3. 50+ 语言：界面与帮助体系的本地化覆盖（来源 https://www.dokuwiki.org/dokuwiki ）。
  4. 设备无关：官方自述 "Device independent"，模板适配多终端阅读（来源同上）。
  5. 干净可读的语法：官方称用户喜爱其 "clean and readable syntax"（来源同上）。
  6. Markdown 混合语法（新版本特性）：2026-07-14c 发行包主配置新增 syntax 参数，官方注释给出 'dw', 'md', 'dw+md', 'md+dw' 四种语法风格（来源官方发行包 conf/dokuwiki.php 注释原文，2026-10-22），即新版本起原生支持 Markdown 语法风格。

五、快速开始（最小可用示例）

以下路径来自官方安装文档（来源 https://www.dokuwiki.org/install 与 https://download.dokuwiki.org ，查询日期 2026-10-22），四步即可获得一个可登录的 wiki；逐步命令与真实回显的完整实测版见《Ubuntu 22.04 安装 DokuWiki 2026-07-14c 指南》。

  1. 就位 Web + PHP 环境：Apache 或 Nginx 加 PHP 8.2+（官方 requirements 明确稳定版需要 PHP >= 8.2，来源 https://www.dokuwiki.org/requirements ，2026-10-22）；
  2. 下载官方发行包：从官方下载通道取 dokuwiki-stable.tgz（该地址始终指向当前推荐稳定版，2026-10-22 时为 2026-07-14c "Mort"），解压到 Web 根目录；
  3. 修正可写目录：把 data/、conf/、lib/plugins/ 交给 Web 服务运行用户；
  4. 浏览器打开 install.php 向导：填站点名、管理员账号与 ACL 策略，提交后删除 install.php 即完成（官方安装器页流程，来源 https://www.dokuwiki.org/installer ，2026-10-22）。

安装完成后，管理员登录即可创建页面；页面在服务器侧以 .txt 纯文本落盘，配置与扩展管理都在 Web 后台完成。配置参数的全量细节见《DokuWiki 2026-07-14c 配置参数详解》，命令行工具见《DokuWiki 2026-07-14c 常用 CLI 命令与工具详解》。

六、适用场景与限制

适用场景（与官方卖点一一对应，来源见第二章）：

  1. 团队/企业内部知识库：内建 ACL + LDAP/AD 连接器是官方点名的企业场景优势（来源 https://www.dokuwiki.org/dokuwiki ，2026-10-22）；
  2. 低配环境部署：官方 "Low system requirements" 卖点，无数据库意味着单台小内存服务器即可运行（来源同上）；
  3. 重备份合规的环境：页面即文件，运维侧用文件级备份/同步方案即可获得完整 wiki 数据；
  4. 文档归档与轻协作：干净语法 + 版本归档 + 全文搜索，适合手册、运维文档、项目文档沉淀。

限制与边界（同样来自官方渠道信息与架构事实，2026-10-22）：

  1. 需要数据库级多实例共享、复杂结构化内容（数据库表单/强工作流）时，应考虑 XWiki/BookStack 一类数据库型 wiki；
  2. 需要现代化所见即所得编辑体验或公开大型内容社区时，MediaWiki/Wiki.js 的生态更对口；
  3. 高频并发写入与海量页面全文检索不是纯文件架构的长项——搜索索引为文件型倒排索引（官方安装器页对 data 目录内容的声明，2026-10-22）；
  4. PHP 8.2+ 是硬门槛：老操作系统（如 Ubuntu 20.04 默认源）需先升级 PHP（来源官方 requirements）。

七、同类选型对比

对比对象为四款主流开源 wiki/知识库软件：MediaWiki、XWiki、Wiki.js、BookStack。数据来源与口径说明（统一查询日期 2026-10-22）：

  • GitHub 星数：shields.io 星数徽章实时返回值取证（https://img.shields.io/github/stars/<owner>/<repo>.json），星数反映的是仓库热度而非质量；
  • 存储形态/语言栈/许可证：各项目官方仓库与官网公开信息；许可证以各仓库 LICENSE 文件为准。
维度DokuWikiMediaWikiXWikiWiki.jsBookStack
GitHub 星数（2026-10-22 实查）4.7k（splitbrain/dokuwiki）5.2k（wikimedia/mediawiki）1.3k（xwiki/xwiki-platform）29k（requarks/wiki）19k（BookStackApp/BookStack）
技术栈PHPPHPJavaNode.jsPHP（Laravel）
数据存储纯文件，无数据库MySQL/PostgreSQL/SQLite关系库（Hibernate）PostgreSQL/MySQL/SQLite 等MySQL/MariaDB
许可证GPL-2.0GPL-2.0+LGPL-2.1AGPL-3.0MIT
部署依赖面Web 服务器 + PHP 8.2+Web + PHP + 数据库Java + 数据库Node.js + 数据库Web + PHP + 数据库
备份形态拷贝目录数据库 dump + 图片目录数据库 dump + 附件数据库 dump + 上传目录数据库 dump + 上传目录
语法风格DokuWiki 语法（新版可混用 Markdown）MediaWiki 语法XWiki 语法 + WYSIWYGMarkdown 为主所见即所得 + Markdown
典型场景内部知识库、文档归档、低配自托管大型百科/社区企业级结构化知识（应用平台化）现代化文档站书本式团队文档

如何选型（基于上表的关键差异）：

  1. 唯「无数据库」是 DokuWiki 的不可替代项：若数据库运维不可得（边缘设备、严格合规的内网小机、想用文件同步工具直接带走数据），DokuWiki 是五者中唯一解；
  2. 追求现代化界面与 Markdown 体验 → Wiki.js（星数最高、Node 生态）；若团队已用 PHP 栈且喜欢「书/章节/页面」结构 → BookStack（MIT 许可对商用最宽松）；
  3. 要做大型公开百科或依赖 MediaWiki 生态（模板/信息框/语义扩展）→ MediaWiki；
  4. 需要平台化的企业知识工程（结构化数据、脚本、宏、应用内开发）→ XWiki；
  5. 要最轻的内部 wiki：DokuWiki 的依赖面最小——官方 requirements 只有 Web + PHP 两条（2026-10-22 实查）。

八、参考链接