注意：这是 Joomla 官方镜像 的 amd64 架构专用仓库。更多信息请参见官方镜像文档中的 "非 amd64 架构？" 和官方镜像常见问题中的 "镜像源在 Git 中已更改，该怎么办？"。

快速参考

• 维护者：
  Joomla!

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

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

• 6.0.0, 6.0, 6, latest, 6.0.0-apache, 6.0-apache, 6-apache, apache, 6.0.0-php8.3, 6.0-php8.3, 6-php8.3, php8.3, 6.0.0-php8.3-apache, 6.0-php8.3-apache, 6-php8.3-apache, php8.3-apache

• 6.0.0-php8.3-fpm-alpine, 6.0-php8.3-fpm-alpine, 6-php8.3-fpm-alpine, php8.3-fpm-alpine

• 6.0.0-php8.3-fpm, 6.0-php8.3-fpm, 6-php8.3-fpm, php8.3-fpm

• 5.4.0-php8.2-apache, 5.4-php8.2-apache, 5-php8.2-apache

• 5.4.0-php8.2-fpm-alpine, 5.4-php8.2-fpm-alpine, 5-php8.2-fpm-alpine

• 5.4.0-php8.2-fpm, 5.4-php8.2-fpm, 5-php8.2-fpm

• 5.4.0, 5.4, 5, 5.4.0-apache, 5.4-apache, 5-apache, 5.4.0-php8.3, 5.4-php8.3, 5-php8.3, 5.4.0-php8.3-apache, 5.4-php8.3-apache, 5-php8.3-apache

• 5.4.0-php8.3-fpm-alpine, 5.4-php8.3-fpm-alpine, 5-php8.3-fpm-alpine

• 5.4.0-php8.3-fpm, 5.4-php8.3-fpm, 5-php8.3-fpm

快速参考（续）

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

• 支持的架构：(更多信息)
  amd64, arm32v5, arm32v6, arm32v7, arm64v8, i386, ppc64le, riscv64, s390x

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

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

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

什么是 Joomla？

Joomla 是一个免费开源的内容管理系统（CMS），用于发布网页内容。它基于模型-视图-控制器（MVC）Web 应用框架构建，可独立于 CMS 使用。Joomla 采用 PHP 编写，使用面向对象编程（OOP）技术和软件设计模式，数据存储在 MySQL、MS SQL 或 PostgreSQL 数据库中，包含页面缓存、RSS 订阅、页面打印版本、新闻推送、博客、搜索以及语言国际化支持等功能。

***.org/wiki/Joomla

!logo

如何使用本镜像

$ docker run --name some-joomla --network some-network -d amd64/joomla

以下环境变量用于配置 Joomla 实例：

• -e JOOMLA_DB_HOST=...（默认为链接的 mysql 容器的 IP 和端口）
• -e JOOMLA_DB_USER=...（默认为 "root"）
• -e JOOMLA_DB_PASSWORD=...（默认为链接的 mysql 容器的 MYSQL_ROOT_PASSWORD 环境变量值）
• -e JOOMLA_DB_PASSWORD_FILE=...（包含数据库密码的文件路径）
• -e JOOMLA_DB_NAME=...（默认为 "joomla"）
• -e JOOMLA_DB_TYPE=...（默认为 "mysqli"，可选值：mysqli、pgsql）

如果指定的 JOOMLA_DB_NAME 在给定的 MySQL 服务器上不存在，且 JOOMLA_DB_USER 具有创建数据库的权限，joomla 容器启动时将自动创建该数据库。

以下环境变量用于配置自动部署（跳过浏览器设置）：

• -e JOOMLA_SITE_NAME=...（Joomla 网站名称）
• -e JOOMLA_ADMIN_USER=...（Joomla 管理员全名）
• -e JOOMLA_ADMIN_USERNAME=...（Joomla 管理员用户名）
• -e JOOMLA_ADMIN_PASSWORD=...（Joomla 管理员密码）
• -e JOOMLA_ADMIN_EMAIL=...（Joomla 管理员邮箱地址）
• -e JOOMLA_EXTENSIONS_URLS=...（用于安装 Joomla 扩展的 URL 列表，以分号分隔）
• -e JOOMLA_EXTENSIONS_PATHS=...（用于安装 Joomla 扩展的文件路径列表，以分号分隔）
• -e JOOMLA_SMTP_HOST=...（外发邮件的 SMTP 主机）
• -e JOOMLA_SMTP_HOST_PORT=...（外发邮件的 SMTP 端口）

若需从主机访问实例（无需容器 IP），可使用标准端口映射：

$ docker run --name some-joomla --network some-network -p 8080:80 -d amd64/joomla

然后通过浏览器访问 http://localhost:8080 或 [***]。

若需使用外部数据库而非 MySQL 容器，需通过 JOOMLA_DB_HOST 指定主机名和端口，以及 JOOMLA_DB_PASSWORD 中的密码和 JOOMLA_DB_USER 中的用户名（若不是 "root"）：

$ docker run --name some-joomla --network some-network -e JOOMLA_DB_HOST=10.1.2.3:3306 \
    -e JOOMLA_DB_USER=... -e JOOMLA_DB_PASSWORD=... -d amd64/joomla

... 使用 docker compose

joomla 的 compose.yaml 示例：

services:

  joomla:
    image: joomla
    restart: always
    ports:
      - 8080:80
    environment:
      JOOMLA_DB_HOST: db
      JOOMLA_DB_USER: joomla
      JOOMLA_DB_PASSWORD: examplepass
      JOOMLA_DB_NAME: joomla_db
      JOOMLA_SITE_NAME: Joomla
      JOOMLA_ADMIN_USER: Joomla Hero
      JOOMLA_ADMIN_USERNAME: joomla
      JOOMLA_ADMIN_PASSWORD: joomla@secured
      JOOMLA_ADMIN_EMAIL: ***
    volumes:
      - joomla_data:/var/www/html
    networks:
      - joomla_network

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_DATABASE: joomla_db
      MYSQL_USER: joomla
      MYSQL_PASSWORD: examplepass
      MYSQL_RANDOM_ROOT_PASSWORD: '1'
    volumes:
      - db_data:/var/lib/mysql
    networks:
      - joomla_network

volumes:
  joomla_data:
  db_data:

networks:
  joomla_network:

运行 docker compose up，等待初始化完成后，访问 http://localhost:8080 或 [***]（根据实际情况）。

添加额外库/扩展

本镜像不提供任何额外的 PHP 扩展或其他库，即使是热门插件可能需要的。由于插件数量众多，且可能需要 PHP 支持的任何扩展，包含所有 PHP 扩展会显著增加镜像大小。

如需额外 PHP 扩展，需基于本镜像创建自定义镜像。php 镜像文档 说明了如何编译额外扩展。此外，joomla Dockerfile 提供了相关示例。

Docker Hub 的以下功能可帮助保持依赖镜像更新：

• 自动构建 使 Docker Hub 能在您推送更改时自动构建 Dockerfile。

镜像变体

amd64/joomla 镜像有多种版本，适用于不同场景。

amd64/joomla:<version>

这是默认镜像。若不确定需求，建议使用此版本。它既可作为临时容器（挂载源代码并启动容器运行应用），也可作为构建其他镜像的基础。

amd64/joomla:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，来自 官方 alpine 镜像。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此通常生成更精简的镜像。

当最终镜像大小是首要考虑因素时，此变体非常有用。需要注意的是，它使用 musl libc 而非 glibc 等，因此软件可能因对 libc 的依赖/假设深度而出现问题。更多讨论参见 此 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像通常不包含额外相关工具（如 git 或 bash）。如需这些工具，可在基于此镜像的自定义 Dockerfile 中添加（不熟悉如何安装包可参考 alpine 镜像说明）。

许可

查看本镜像包含软件的 许可信息。

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

可在 repo-info 仓库的 joomla/ 目录 中找到一些自动检测到的额外许可信息。

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