arm32v7/joomla Docker镜像文档

镜像概述和主要用途

arm32v7/joomla是Joomla!官方Docker镜像的arm32v7架构版本，用于在32位ARM架构设备（如树莓派等嵌入式系统）上部署Joomla!内容管理系统。Joomla!是一款免费开源的内容管理系统（CMS），基于PHP语言和MVC架构，支持多种数据库（MySQL、MS SQL、PostgreSQL），可用于快速构建各类网站和Web应用。

注意：此镜像为"按架构拆分"的仓库，仅包含arm32v7架构构建版本，对应官方Joomla镜像的arm32v7架构分支。

核心功能和特性

• MVC架构：采用模型-视图-控制器（MVC）设计模式，支持独立于CMS的Web应用开发
• 多数据库支持：兼容MySQL、MS SQL及PostgreSQL数据库
• 丰富的内容管理功能：包含页面缓存、RSS订阅、打印版本、新闻推送、博客、搜索等模块
• 多语言支持：内置国际化（i18n）功能，支持多语言网站部署
• 扩展性：支持通过扩展插件扩展功能，拥有丰富的第三方扩展生态
• 安全特性：定期更新安全补丁，符合Web应用安全最佳实践

使用场景和适用范围

• 网站构建：企业官网、个人博客、新闻门户、电子商务平台等
• 内容管理：文档发布、知识管理系统、在线教育平台
• 嵌入式设备应用：在arm32v7架构的嵌入式设备（如树莓派）上部署轻量级Web服务
• 开发测试：快速搭建Joomla!开发环境，测试插件和主题兼容性

支持的标签及Dockerfile链接

Joomla 6.x系列

• Apache版本：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
  Dockerfile

• PHP-FPM版本：6.0.0-php8.3-fpm, 6.0-php8.3-fpm, 6-php8.3-fpm, php8.3-fpm
  Dockerfile

• Alpine PHP-FPM版本：6.0.0-php8.3-fpm-alpine, 6.0-php8.3-fpm-alpine, 6-php8.3-fpm-alpine, php8.3-fpm-alpine
  Dockerfile

Joomla 5.x系列

• Apache版本（PHP 8.2）：5.4.0-php8.2-apache, 5.4-php8.2-apache, 5-php8.2-apache
  Dockerfile

• Apache版本（PHP 8.3）：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
  Dockerfile

• PHP-FPM版本（PHP 8.2）：5.4.0-php8.2-fpm, 5.4-php8.2-fpm, 5-php8.2-fpm
  Dockerfile

• PHP-FPM版本（PHP 8.3）：5.4.0-php8.3-fpm, 5.4-php8.3-fpm, 5-php8.3-fpm
  Dockerfile

• Alpine PHP-FPM版本（PHP 8.2）：5.4.0-php8.2-fpm-alpine, 5.4-php8.2-fpm-alpine, 5-php8.2-fpm-alpine
  Dockerfile

• Alpine PHP-FPM版本（PHP 8.3）：5.4.0-php8.3-fpm-alpine, 5.4-php8.3-fpm-alpine, 5-php8.3-fpm-alpine
  Dockerfile

详细使用方法和配置说明

快速启动（docker run）

基础启动命令

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

端口映射（访问主机端口）

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

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

连接外部数据库

$ docker run --name some-joomla --network some-network \
  -e JOOMLA_DB_HOST=10.1.2.3:3306 \
  -e JOOMLA_DB_USER=dbuser \
  -e JOOMLA_DB_PASSWORD=dbpass \
  -e JOOMLA_DB_NAME=joomla_db \
  -d arm32v7/joomla

Docker Compose部署

创建 compose.yaml 文件：

services:
  joomla:
    image: arm32v7/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: securepassword
      JOOMLA_ADMIN_EMAIL: ***
    volumes:
      - joomla_data:/var/www/html  # 持久化Joomla数据
    networks:
      - joomla_network

  db:
    image: arm32v7/mysql:8.0  # 对应arm32v7架构的MySQL镜像
    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:  # Joomla数据卷
  db_data:      # 数据库数据卷

networks:
  joomla_network:  # 自定义网络

启动服务：

$ docker compose up -d

环境变量配置

数据库配置变量

自动部署配置变量（跳过浏览器安装）

添加额外PHP扩展或库

基础镜像不包含所有可能的PHP扩展，如需添加，需基于此镜像构建自定义镜像。参考示例Dockerfile：

FROM arm32v7/joomla:6.0-php8.3-apache

# 安装额外PHP扩展（示例：gd和mysqli）
RUN docker-php-ext-install gd mysqli \
    && docker-php-ext-enable gd mysqli

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

镜像变体说明

arm32v7/joomla:<version>（默认Apache版本）

包含Apache Web服务器和PHP，适用于大多数场景，开箱即用。

arm32v7/joomla:<version>-fpm（PHP-FPM版本）

包含PHP-FPM（FastCGI进程管理器），需配合外部Web服务器（如Nginx）使用，适合需要更高性能的场景。

arm32v7/joomla:<version>-fpm-alpine（Alpine PHP-FPM版本）

基于Alpine Linux构建，体积更小（约5MB基础镜像），使用musl libc替代glibc，适合对镜像大小有严格要求的场景。

维护与支持

• 维护者：Joomla!
• 问题反馈：GitHub Issues
• 支持渠道：Docker社区Slack、Server Fault、Stack Overflow

许可证信息

Joomla! 软件采用 GPL-2.0 许可协议。

镜像中包含的其他软件（如基础系统、PHP等）可能采用不同许可协议，用户需确保使用符合相关软件的许可要求。

更多许可信息可参考 repo-info 仓库的 joomla 目录。