mtilson/dokuwiki

说明

• 本镜像分叉自 https://github.com/crazy-max/docker-dokuwiki
• Git备份功能基于 https://github.com/ericbarch/dockuwiki

关于

• 这是 DokuWiki 的Docker镜像，通过 https://github.com/containous/traefik 反向代理提供服务
• 使用 https://github.com/containous/traefik-library-image
• Traefik用于反向代理及Let's Encrypt证书的自动创建/续期

2020/01/15 更新

• 原单一docker-compose.yml拆分为应用容器配置（docker-compose.yml）和Traefik容器配置（traefik/docker-compose.yml）
• Traefik可独立于DokuWiki运行，仅需共享COMMON_NETWORK定义的网络即可，适用于已部署Traefik作为边缘代理的场景
• traefik/docker-compose.yml可作为新系统部署的示例配置

功能特性

• 基于Alpine Linux 3.9、Nginx、PHP 7.2，通过Traefik实现ACME Let's Encrypt证书管理
• 构建过程验证Tar包真实性
• 启用OPCache以提升PHP性能
• 站点数据、配置、插件及模板自动备份到Git仓库

环境变量

• .env文件中定义的变量：
  • DOKUWIKI_TRAEFIK_FE_RULE：Traefik前端规则，默认Host:wiki.example.com，未定义则无法路由流量
  • PERSISTENT_DIR：主机持久化目录，存储DokuWiki数据、证书及Git备份密钥，默认/opt/docker/persistent
  • ACME_EMAIL：Let's Encrypt注册***，默认webmaster@example.com，未定义则证书功能异常
  • DOCKER_DOMAIN：前端规则基础域名，默认docker.localhost
  • COMMON_NETWORK：Traefik与应用共享的网络名称，默认traefik-public-network
  • BACKUP_USER_EMAIL：Git备份用户***，默认dokuwiki-backup@example.com
  • GIT_BACKUP_REPO_URL：Git备份仓库SSH地址，必填项
  • TZ：容器时区，默认Europe/Luxembourg，为空则使用UTC
• 容器ENTRYPOINT默认变量（可在.env中重定义）：
  • MEMORY_LIMIT：PHP内存限制，默认256M
  • UPLOAD_MAX_SIZE：上传文件最大尺寸，默认16M
  • OPCACHE_MEM_SIZE：OPCache内存大小，默认128

卷挂载

• DokuWiki：
  • /data → 主机${PERSISTENT_DIR}/dokuwiki/data（存储配置、插件、模板及数据）
  • /root/.ssh → 主机${PERSISTENT_DIR}/dokuwiki/root/.ssh（存储SSH密钥及配置）
• Traefik：
  • /acme.json → 主机${PERSISTENT_DIR}/acme.json（存储Let's Encrypt证书）

端口

• Traefik：
  • 80：HTTP端口（重定向至HTTPS）
  • 443：HTTPS端口（代理至DokuWiki的80端口）
• DokuWiki：
  • 80：HTTP端口（提供Wiki服务）

安装步骤

• 新系统部署：
  1. 创建项目目录并进入，创建.env文件：

bash
DOKUWIKI_TRAEFIK_FE_RULE=Host:wiki.example.com
PERSISTENT_DIR=/opt/docker/persistent
ACME_EMAIL=webmaster@example.com
DOCKER_DOMAIN=docker.localhost
BACKUP_USER_EMAIL=dokuwiki-backup@example.com
GIT_BACKUP_REPO_URL=git@bitbucket.org:username/reponame.git
COMMON_NETWORK=traefik-public-network
TZ=Europe/Oslo
MEMORY_LIMIT=
UPLOAD_MAX_SIZE=
OPCACHE_MEM_SIZE=

2. 下载并执行预部署脚本：

bash
curl -sSL https://raw.githubusercontent.com/mtilson/dokuwiki/master/pre-deploy.sh > pre-deploy.sh
chmod +x pre-deploy.sh
./pre-deploy.sh

3. 配置Git SSH访问：
   • 生成SSH密钥对，将私钥放入${PERSISTENT_DIR}/dokuwiki/root/.ssh/id_rsa（权限设为600）
   • 将公钥添加到Git仓库账户
   • 创建SSH配置文件${PERSISTENT_DIR}/dokuwiki/root/.ssh/config（示例：Host bitbucket.org\n StrictHostKeyChecking no）
4. 部署容器：

bash
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml pull
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml up -d
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml logs -f

5. 完成DokuWiki安装向导后，删除install.php：

bash
docker exec dokuwiki /bin/sh -c "rm -fr /var/www/install.php"

后续运行

bash
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml pull
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml up -d

升级

bash
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml down
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml pull
docker-compose -f docker-compose.yml -f traefik/docker-compose.yml up -d

• 也可通过DokuWiki UI自动升级

备份与恢复

• /data目录内容定期备份到Git仓库
• 新主机部署时，通过Git仓库同步数据至容器/data卷

许可证

• MIT许可证，详见LICENSE文件