⚠️ 废弃通知 ⚠️

• Plone 4.x 不再受支持。
• Plone 5.x 不再受支持。
• 强烈建议迁移到最新可用的 Plone 版本。详情参见 [***]

从 Plone 6.x 开始，前端和后端在单独的 Docker 镜像中运行，另有 ZEO 服务器 Docker 镜像。所有 Plone 6.0 及更高版本的镜像由 Plone 基金会支持，并由社区志愿者维护。

• Plone 后端
• Plone 前端
• ZEO 服务器

有关 Docker 镜像用法，请参见 Plone 6 文档。

快速参考

• 维护者：
  Plone 社区

• 获取帮助：
  Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

警告：此镜像在 arm64v8 架构上不受支持

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  无支持的架构

• 已发布镜像制品详情：
  repo-info 仓库的 repos/plone/ 目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/plone 标签
  official-images 仓库的 library/plone 文件 (历史记录)

• 此描述的来源：
  docs 仓库的 plone/ 目录 (历史记录)

什么是 Plone？

Plone 是一个免费开源的内容管理系统，构建于 Zope 应用服务器之上。

!logo

特性

• 通过环境变量启用附加组件。
• 可选择基于 Debian 或 Alpine 的镜像。
• 内置 RelStorage 支持，可通过环境变量配置（需 Plone 5.2.4+）。
• 通过 pas.plugins.ldap 内置 LDAP/AD 支持（需 Plone 5.2.4+）。

用法

启动单个 Plone 实例

这将下载并启动最新的 Plone 5 容器，基于 Debian。

docker run -p 8080:8080 arm64v8/plone

此镜像包含 EXPOSE 8080（Plone 端口），因此标准容器链接会使其自动对链接的容器可用。现在你可以在 http://localhost:8080 添加 Plone 站点。默认 Zope 用户和密码为 admin/admin。

在 ZEO 集群中启动 Plone

ZEO 集群最适合生产环境设置。你需要一个负载均衡器。

在后台启动 ZEO 服务器。

docker run --name=zeo arm64v8/plone zeo

在后台启动两个 Plone 客户端。

docker run --link=zeo -e ZEO_ADDRESS=zeo:8080 -p 8081:8080 arm64v8/plone
docker run --link=zeo -e ZEO_ADDRESS=zeo:8080 -p 8082:8080 arm64v8/plone

以调试模式启动 Plone

你也可以通过以下命令以调试模式（fg）启动 Plone。

docker run -p 8080:8080 arm64v8/plone fg

附加组件

你可以通过 ADDONS 环境变量启用 Plone 附加组件。

docker run -p 8080:8080 -e PLONE_ADDONS="eea.facetednavigation Products.PloneFormGen" arm64v8/plone

有关如何使用自定义设置扩展此镜像、添加更多附加组件、构建镜像或挂载卷的更多信息，请参阅 Plone 5 文档。

支持的环境变量

Plone 镜像使用多个环境变量。

基本用法

• ADDONS - 通过此环境变量使用 Plone 附加组件自定义 Plone。
• SITE - 首次运行时，将具有此 ID 的 Plone 实例添加到 Data.fs。如果未提供，你需要通过 Web UI 手动添加 Plone 站点。
• ZEO_ADDRESS - 此环境变量允许将 Plone 镜像作为 ZEO 客户端运行。
• VERSIONS - 使用特定版本的 Plone 附加组件或 Python 库。

运行 Plone 并安装两个附加组件（eea.facetednavigation 和 collective.easyform）。

docker run -p 8080:8080 -e SITE="mysite" -e ADDONS="eea.facetednavigation collective.easyform" arm64v8/plone

要使用特定的附加组件版本，请按如下所示更改环境变量参数。

-e ADDONS="eea.facetednavigation collective.easyform" \
-e VERSIONS="eea.facetednavigation=13.3 collective.easyform=2.1.0"

要使用 Plone REST API，启动 Plone Docker 镜像，然后执行 curl 命令。

docker run -p 8080:8080 -e SITE=plone arm64v8/plone
curl -H 'Accept: application/json' http://localhost:8080/plone

高级用法

对于高级用法，镜像支持以下环境变量。

Plone

• PLONE_ADDONS、ADDONS - 通过这些环境变量使用 Plone 附加组件自定义 Plone。
• PLONE_SITE、SITE - 首次运行时，将具有此 ID 的 Plone 实例添加到 Data.fs。如果未提供，你需要通过 Web UI 手动添加 Plone 站点。
• PLONE_VERSIONS、VERSIONS - 使用特定版本的 Plone 附加组件或 Python 库。
• PLONE_PROFILES、PROFILES - 当提供 SITE 环境变量时，要包含的 GenericSetup 配置文件。
• PLONE_ZCML、ZCML - 包含自定义 Plone 附加组件 ZCML 文件（以前为 BUILDOUT_ZCML）。
• PLONE_DEVELOP、DEVELOP - 开发新的或现有 Plone 附加组件（以前为 BUILDOUT_DEVELOP）。

ZEO

• ZEO_ADDRESS - 此环境变量允许将 Plone 镜像作为 ZEO 客户端运行。
• ZEO_READ_ONLY - 将 Plone 作为只读 ZEO 客户端运行。默认为 off。
• ZEO_CLIENT_READ_ONLY_FALLBACK - 指示当没有可写存储可用时，是否接受只读远程存储作为回退的标志。默认为 false。
• ZEO_SHARED_BLOB_DIR - 如果 ZEO 服务器和实例可以访问同一目录，设置为 on。默认为 off。
• ZEO_STORAGE - 设置 ZEO 存储的存储编号。默认为 1。
• ZEO_CLIENT_CACHE_SIZE - 设置 ZEO 客户端缓存大小。默认为 128MB。
• ZEO_PACK_KEEP_OLD - 可设置为 false 以禁用在打包运行前创建 *.fs.old 文件。默认为 true。
• HEALTH_CHECK_TIMEOUT - 等待健康检查开始的时间（秒）。默认为 1 秒。
• HEALTH_CHECK_INTERVAL - 检查 Zope 应用是否仍然健康的时间间隔（秒）。默认为 1 秒。

CORS

• CORS_ALLOW_ORIGIN - 允许访问资源的源。可以是逗号分隔的源列表，例如 [***]，或 *。默认为 http://localhost:3000,http://127.0.0.1:3000。
• CORS_ALLOW_METHODS - 此 CORS 策略允许的 HTTP 方法名称的逗号分隔列表，例如 DELETE,GET,OPTIONS,PATCH,POST,PUT。默认为 DELETE,GET,OPTIONS,PATCH,POST,PUT。
• CORS_ALLOW_CREDENTIALS - 指示资源是否支持请求中的用户凭据。默认为 true。
• CORS_EXPOSE_HEADERS - 客户端可访问的响应头的逗号分隔列表，例如 Content-Length,X-My-Header。默认为 Content-Length,X-My-Header。
• CORS_ALLOW_HEADERS - 允许客户端发送的请求头的逗号分隔列表，例如 X-My-Header。默认为 Accept,Authorization,Content-Type,X-Custom-Header。
• CORS_MAX_AGE - 指示预检请求结果的缓存时间。默认为 3600。

RelStorage

• RELSTORAGE_ADAPTER_OPTIONS - 使用 plone.recipe.zope2instance 为 plone 实例设置的 RelStorage 适配器选项的逗号分隔列表。使用 RelStorage 需此选项。

所有其他可用环境变量均与 RelStorage 设置完全匹配，具体参见 文档中的设置规范。

• RELSTORAGE_NAME - name - 存储的名称。

• RELSTORAGE_READ_ONLY - read-only - 如果为 true，则只能对存储执行读取操作。

• RELSTORAGE_KEEP_HISTORY - 如果此选项设置为 true（默认值），则适配器将创建并使用保留历史的数据库模式，如 FileStorage。

• RELSTORAGE_BLOB_DIR - 如果提供，存储将提供 ZODB BLOB 支持。此选项指定保存 BLOB 数据的目录。如果目录不存在，将创建它。如果未提供值或提供空值，则不提供 BLOB 支持。默认为 /plone/instance/var/blobstorage。

  查看更多 RelStorage 选项。

文档

最终用户的完整文档可在 5.docs.plone.org 找到。

许可证

查看此镜像中包含的软件的 许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他受其他许可证约束的软件（例如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可证信息可能位于 repo-info 仓库的 plone/ 目录 中。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用均符合其中包含的所有软件的相关许可证。