使用Docker部署DokuWiki教程-快速搭建个人知识库

以下是一份详细的 Docker 部署 DokuWiki 的教程，分为 基础版（快速启动）和 进阶版（自定义配置），按需选择即可。

一、基础版：快速启动

适用于快速测试或简单使用，数据保存在容器内（重启可能丢失数据）。

# 1. 拉取官方镜像
docker pull bitnami/dokuwiki

# 2. 运行容器（自动创建随机密码）
docker run -d \
  --name dokuwiki \
  -p 8080:8080 \
  -p 8443:8443 \
  bitnami/dokuwiki

# 3. 访问
# - 默认用户: user
# - 密码查看命令:
docker logs dokuwiki 2>&1 | grep "Password"

访问 http://服务器IP:8080 即可进入 DokuWiki。

二、进阶版：持久化配置

推荐生产环境使用，将数据和配置持久化到宿主机。

1. 创建数据目录

mkdir -p /opt/dokuwiki/{data,conf,plugins}

2. 运行容器（绑定目录）

docker run -d \
  --name dokuwiki \
  -p 80:8080 \
  -p 443:8443 \
  -v /opt/dokuwiki/data:/bitnami/dokuwiki \
  -v /opt/dokuwiki/conf:/bitnami/dokuwiki-conf \
  -v /opt/dokuwiki/plugins:/opt/bitnami/dokuwiki/lib/plugins \
  -e DOKUWIKI_USERNAME=admin \
  -e DOKUWIKI_FULL_NAME="管理员" \
  -e DOKUWIKI_PASSWORD=yourpassword \
  bitnami/dokuwiki

3. 反向代理配置（可选）

若需通过域名访问，推荐使用 Nginx 反向代理：

server {
    listen 80;
    server_name wiki.yourdomain.com;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

三、关键操作命令

| 功能 | 命令 |
|------|------|
| 停止容器 | docker stop dokuwiki |
| 启动容器 | docker start dokuwiki |
| 备份数据 | cp -r /opt/dokuwiki /backup/dokuwiki_$(date +%F) |
| 更新版本 | docker pull bitnami/dokuwiki:latest 后重新运行容器 |

四、常见问题

中文乱码
在 配置设置 → 高级 中修改 编码 为 UTF-8。

插件安装
将插件上传到 /opt/dokuwiki/plugins 后，在容器内执行：

docker exec dokuwiki chown -R daemon:daemon /opt/bitnami/dokuwiki/lib/plugins

性能优化
在 conf/local.php 中添加：

$conf['compression'] = 1;  // 启用Gzip压缩
$conf['cachetime'] = 86400; // 缓存时间

五、升级注意事项

升级前务必备份 /opt/dokuwiki 目录。
新版镜像可能需调整卷路径，参考 Bitnami 文档。

通过以上步骤，你可以快速部署一个功能完整的 DokuWiki。如需更复杂配置（如 LDAP 集成），可进一步修改 conf/local.php 或使用环境变量。