***DokuWiki Docker镜像

此镜像基于***PHP Apache镜像构建，提供DokuWiki安装环境。建议配合反向代理使用，由反向代理处理SSL终止和身份验证。不推荐将此镜像用于独立安装（可参考在Docker上运行DokuWiki了解替代方案）。未充分理解Linux、网络和Docker的用户不建议使用Docker，新手应优先考虑共享主机服务。

如果您使用此镜像，请在Docker Hub上点亮星标⭐ - 这有助于提高镜像在仓库中的可见性。

快速开始

docker run -p 8080:8080 --user 1000:1000 -v /path/to/storage:/storage dokuwiki/dokuwiki:stable

• 暴露端口：8080
• 卷：/storage
• 可使用非root用户运行，确保存储卷对指定UID可写。
• 可用标签：stable、oldstable、master及版本标签（如2020-07-29a）。latest是stable的别名。

仓库中包含示例docker-compose文件。

首次运行时，使用DokuWiki的安装程序按常规配置Wiki。

特性

• xsendfile已配置并启用
• ImageMagick已安装并启用
• 通过URL重写配置并启用友好URL
• 通过农场插件支持农场模式
• Docker健康检查（每30秒运行一次基本DokuWiki检查，3次重试）

注意：此镜像不包含邮件服务器。需配置DokuWiki使用外部邮件服务器，推荐通过SMTP插件实现。

PHP配置与环境

容器运行标准生产环境php.ini。部分配置可通过环境变量设置：

• PHP_UPLOADLIMIT - 文件上传大小限制，默认128M
• PHP_MEMORYLIMIT - 进程内存限制，默认256M
• PHP_TIMEZONE - 时区，默认UTC

自定义PHP配置可在存储卷中的php.ini文件中设置。

农场模式支持

此镜像通过农场插件支持农场模式。使用时，安装插件并按插件文档配置即可。初始农场配置已在镜像中完成，农场目录为/storage/farm。

使用反向代理将子Wiki（animal）请求路由到此容器。

用户数据处理

除页面和媒体数据外，扩展和配置需在容器替换时持久化。需区分用户安装的扩展/配置与捆绑的扩展/配置。

此镜像使用单个存储卷存储所有用户数据：

• 捆绑插件和模板移至容器内单独目录，并符号链接到存储卷，存储卷再符号链接到正确的插件和模板目录，确保存储卷不含过时的捆绑扩展。
• 核心配置移至单独目录，通过预加载机制加载默认配置，存储卷仅含本地配置。
• 容器重启时重新检查必要的符号链接。

此设置确保通过管理界面的所有调整正确存储在存储卷中，而捆绑数据保留在容器中，容器更新时自动更新/替换。

开发构建

手动构建

docker build --build-arg=\"DOKUWIKI_VERSION=stable\" -t dokuwiki/dokuwiki:stable .

自动构建

构建和部署通过GitHub Actions workflow每日进行。详见仓库：[***]