一、Dokuwiki介绍

1.1 Dokuwiki概述

Dokuwiki是一款轻量级、开源且无需数据库的Wiki系统，专注于简洁性和可维护性。它使用纯文本文件存储内容，支持版本控制、插件扩展和模板定制，适合个人知识管理、团队协作或文档发布。

1.2 核心特点

• 无需数据库：数据以文本文件形式存储，备份和迁移更简单。
• 版本控制：自动记录内容修改历史，支持差异对比和版本回滚。
• 语法简洁：使用易于学习的标记语法（类似Markdown）编辑内容。
• 插件生态：通过插件支持表格、图表、代码高亮等扩展功能。
• 多语言支持：内置多语言界面，包括中文。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署Dokuwiki个人知识库。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Mon 2025-08-04 10:10:52 UTC; 30min ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 860 (dockerd)
      Tasks: 10
     Memory: 97.2M (peak: 98.4M)
        CPU: 606ms
     CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v
Docker version 28.3.3, build 980b856

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker -v
Docker version 28.3.3, build 980b856

四、拉取Dokuwiki镜像

下载拉Dokuwiki容器镜像，如下所示

docker pull ghcr.io/linuxserver/dokuwiki:latest

五、部署Dokuwiki服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/dokuwiki/config   &&  cd /data/dokuwiki

• 目录授权

chmod -R 755 /data/dokuwiki/

5.2 编辑部署文件

使用docker-cli方式部署，可参考以下命令：

docker run -d \
  --name=dokuwiki \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8741:80 \
  -p 443:443  \
  -v /data/dokuwiki/config:/config \
  --restart unless-stopped \
  ghcr.io/linuxserver/dokuwiki:latest

在部署目录下，创建docker-compose.yaml文件，内容如下所示：

vim docker-compose.yaml

version: '3.9'
services:
    linuxserver:
        image: 'ghcr.io/linuxserver/dokuwiki:latest'
        restart: unless-stopped
        volumes:
            - '/data/dokuwiki/config:/config'
        ports:
            - '443:443'
            - '8741:80'
        environment:
            - TZ=Asia/Shanghai
            - PGID=1000
            - PUID=1000
        container_name: dokuwiki

5.3 创建Dokuwiki容器

执行以下命令，创建Dokuwiki容器。

docker compose up -d

5.4 查看Dokuwiki容器状态

检查Dokuwiki容器运行状态，确保Dokuwiki容器正常启动。

root@jeven:/data/dokuwiki# docker compose ps
WARN[0000] /data/dokuwiki/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME       IMAGE                                 COMMAND   SERVICE       CREATED          STATUS          PORTS
dokuwiki   ghcr.io/linuxserver/dokuwiki:latest   "/init"   linuxserver   20 seconds ago   Up 19 seconds   0.0.0.0:443->443/tcp, [::]:443->443/tcp, 0.0.0.0:8741->80/tcp, [::]:8741->80/tcp

六、访问Dokuwiki服务

6.1 初始化安装

浏览器地址： http://<个人的服务器IP>:8741/install.php，访问Dokuwiki的初始安装页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

设置系统语言为中文后，自定义填写登录账号密码信息，如下所示：

6.2 登录Dokuwiki

使用刚才设置的账号密码登录Dokuwiki，进入Dokuwiki首页。

七、Dokuwiki基本使用

进行如下操作，进行创建新页面。

编辑内容完毕后，点击保存选项。

八、总结

通过本次实践，我们成功使用Docker快速部署了DokuWiki个人知识库。整个过程操作简便，得益于容器化技术，实现了环境隔离与服务的高效交付。通过数据卷挂载，保障了内容与配置的持久化，便于后期维护与备份。DokuWiki轻量易用、无需数据库的特性，结合Docker的可移植性，是搭建个人知识管理系统的理想选择。