DokuWiki Docker镜像文档

镜像概述

本镜像是基于Alpine Linux构建的DokuWiki应用容器，DokuWiki是一款轻量级开源wiki引擎，采用文件系统存储数据，无需数据库支持。Alpine Linux的特性确保镜像体积小巧、资源占用低，适合快速部署个人知识库、团队协作文档或项目文档系统。

核心功能与特性

• 轻量级设计：基于Alpine Linux，镜像体积小，启动速度快，资源占用低
• 无数据库依赖：采用文件系统存储内容，简化部署与维护流程
• 易扩展性：支持DokuWiki插件系统，可按需扩展功能（如版本控制、语法高亮等）
• 安全可靠：定期更新基础镜像，内置安全配置，支持访问权限控制
• 跨平台兼容：可在任何支持Docker的环境中运行，包括服务器、PC及嵌入式设备

使用场景

• 个人知识库或笔记系统
• 小型团队协作文档平台
• 开源项目或内部项目文档管理
• 企业内部wiki或帮助中心
• 教育机构教学资料共享平台

使用方法

前置要求

• Docker Engine 19.03+ 或 Docker Desktop
• 网络环境可访问Docker Hub（用于拉取镜像）

Docker Run 命令示例

bash
docker run -d \
  --name dokuwiki \
  -p 8080:80 \
  -v /path/to/dokuwiki/data:/var/www/html/data \
  -v /path/to/dokuwiki/conf:/var/www/html/conf \
  -e TZ=Asia/Shanghai \
  -e PUID=1000 \
  -e PGID=1000 \
  crazy-max/dokuwiki

参数说明：

• -p 8080:80：将容器内80端口映射到主机8080端口
• -v /path/to/dokuwiki/data：持久化存储DokuWiki内容数据
• -v /path/to/dokuwiki/conf：持久化存储配置文件
• -e TZ：设置时区（如Asia/Shanghai）
• -e PUID/PGID：指定运行用户ID/组ID，避免权限问题

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: "3.8"

services:
  dokuwiki:
    image: crazy-max/dokuwiki
    container_name: dokuwiki
    restart: always
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/html/data
      - ./conf:/var/www/html/conf
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=1000
    networks:
      - dokuwiki-net

networks:
  dokuwiki-net:
    driver: bridge

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

数据卷挂载

访问与初始化

1. 容器启动后，通过 http://<主机IP>:<映射端口> 访问DokuWiki
2. 首次访问将进入安装向导，设置管理员账号、站点名称及初始配置
3. 完成配置后即可开始创建和管理wiki页面

维护与更新

• 数据备份：定期备份挂载的data和conf目录
• 镜像更新：

  bash
  docker pull crazy-max/dokuwiki
  docker restart dokuwiki
  

• 插件管理：通过DokuWiki后台"扩展管理器"安装或更新插件，持久化plugins目录可保留插件配置

注意事项

• 确保挂载的数据目录具有正确权限（与PUID/PGID匹配）
• 生产环境建议配置HTTPS（可配合Nginx反向代理实现）
• 定期更新镜像以获取安全补丁和功能改进