Joomla Docker镜像文档

镜像概述和主要用途

注意：本镜像为Joomla官方镜像的mips64le架构版本。警告：该镜像在mips64le架构上不受支持。有关多架构镜像的更多信息，请参见官方镜像文档中的“非amd64架构”和官方镜像FAQ中的“镜像源在Git中变更后怎么办？”。

Joomla!是一个开源内容管理系统(CMS)，用于发布网络内容。本Docker镜像提供了Joomla的容器化部署方案，简化了Joomla应用的搭建和管理流程。

• 维护者：Joomla!
• 问题反馈：GitHub Issues
• 支持架构：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

核心功能和特性

• 开源内容管理系统：基于GPL-2.0许可的免费开源CMS，用于发布和管理 web 内容
• MVC架构：采用模型-视图-控制器(MVC) web应用框架，支持独立于CMS使用
• 多语言支持：内置语言国际化功能，支持多语言网站部署
• 数据库兼容性：支持MySQL、MS SQL及PostgreSQL数据库存储
• 丰富功能集：包含页面缓存、RSS订阅、页面打印版本、新闻推送、博客、搜索等功能
• PHP技术栈：使用PHP编写，采用面向对象编程(OOP)技术和软件设计模式

使用场景和适用范围

Joomla适用于各类web内容管理场景，包括但不限于：

• 企业官方网站和门户
• 个人或企业博客系统
• 新闻资讯类网站
• 在线社区平台
• 电子商务网站（通过扩展实现）
• 政府或教育机构网站

详细使用方法和配置说明

基本运行（Docker Run）

简单启动

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

端口映射（访问主机）

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

启动后通过 http://localhost:8080 或 [***] 访问

连接外部数据库

$ 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 mips64le/joomla

Docker Compose 部署

以下是使用Docker Compose部署Joomla与MySQL的完整示例：

services:
  joomla:
    image: mips64le/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_ADMIN_USERNAME: admin
      JOOMLA_ADMIN_PASSWORD: secure_password
      JOOMLA_ADMIN_EMAIL: ***
    volumes:
      - joomla_data:/var/www/html  # 持久化Joomla数据
    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'  # 自动生成root密码
    volumes:
      - db_data:/var/lib/mysql  # 持久化数据库数据
    networks:
      - joomla_network

volumes:
  joomla_data:
  db_data:

networks:
  joomla_network:

启动命令：

$ docker compose up -d

等待初始化完成后，通过 http://localhost:8080 访问网站

环境变量配置参数

数据库配置

注意：若指定的JOOMLA_DB_NAME在数据库中不存在，且JOOMLA_DB_USER有创建权限，容器启动时会自动创建该数据库。

自动部署配置（跳过浏览器安装向导）

SMTP邮件配置

扩展与自定义

安装扩展

可通过以下两种方式安装Joomla扩展：

1. URL安装：设置JOOMLA_EXTENSIONS_URLS环境变量，指定分号分隔的扩展下载URL
2. 文件路径安装：设置JOOMLA_EXTENSIONS_PATHS环境变量，指定容器内扩展文件路径

添加PHP扩展

本镜像不包含额外PHP扩展，如需添加，可基于本镜像创建自定义Dockerfile。参考示例：

FROM mips64le/joomla

# 安装所需PHP扩展（示例：安装gd扩展）
RUN set -eux; \
    apt-get update; \
    apt-get install -y --no-install-recommends \
        libfreetype6-dev \
        libjpeg62-turbo-dev \
        libpng-dev \
    ; \
    docker-php-ext-configure gd --with-freetype --with-jpeg; \
    docker-php-ext-install -j$(nproc) gd; \
    apt-get clean; \
    rm -rf /var/lib/apt/lists/*

更多PHP扩展安装方法可参考PHP官方镜像文档。

许可证信息

• 软件许可：本镜像包含的Joomla软件基于GPL-2.0许可发布
• 镜像组件：与所有Docker镜像一样，本镜像可能包含其他软件（如Bash、基础系统组件等），这些软件可能具有各自的许可协议
• 许可信息查询：部分自动检测的许可信息可在repo-info仓库的joomla目录中找到

使用责任：使用本镜像时，用户有责任确保其使用符合所有包含软件的相关许可协议。