mahocommerce/maho

Maho开源电商平台官方Docker镜像

镜像概述和主要用途

本镜像为Maho开源电商平台的官方Docker镜像，专为云生产环境（如Sevalla、DigitalOcean等PaaS提供商）部署设计。镜像不包含MySQL或任何数据库，需通过云提供商单独配置托管MySQL数据库。

核心功能和特性

• 基于FrankenPHP运行环境，支持PHP 8.2、8.3、8.4版本
• 提供多版本标签，包括开发版（nightly）、稳定版（latest）及特定版本号标签
• 专为云生产环境优化，支持水平扩展准备（未来将支持S3兼容存储）
• 支持持久化媒体文件存储，确保产品图片等上传文件不丢失

仓库标签

• nightly：Maho的dev-main开发版，基于最新FrankenPHP + PHP 8.4
• latest：最新稳定版（25.11.0），基于最新FrankenPHP + PHP 8.4
• 25.11.0-php8.4
• 25.11.0-php8.3
• 25.9.0-php8.4
• 25.9.0-php8.3
• 25.7.0-php8.4
• 25.7.0-php8.3
• 25.5.0-php8.4
• 25.5.0-php8.3
• 25.5.0-php8.2

部署方法

选项1：从本地开发开始部署

1. 使用本镜像搭建基于Docker的Web服务器
2. 根据云提供商方式创建空数据库
3. 本地开发期间安装平台，生成包含所有配置的local.xml文件
4. 复制local.xml并修改配置（如替换数据库主机名、用户名、密码等）
5. 在云提供商配置中创建MAHO_LOCAL_XML环境变量，将编辑后的local.xml内容填入
6. 将本地数据库备份导入云数据库，编辑core_config_data表修正网站域名
7. 启动基础设施

选项2：在线安装部署

1. 使用本镜像搭建基于Docker的Web服务器
2. 根据云提供商方式创建空数据库
3. 启动整个基础设施
4. 访问指向基础设施的域名，启动Web安装程序
5. 安装完成后，通过SSH进入容器，复制app/etc/local.xml内容
6. 在云提供商配置中创建MAHO_LOCAL_XML环境变量并粘贴local.xml内容（防止镜像更新或重新部署时丢失配置）
7. 重启基础设施并测试功能

媒体文件系统

Maho将产品图片等上传文件存储在public/media目录。为防止数据丢失，需配置云平台持久化磁盘并挂载至/app/public/media目录，重启后验证文件是否正确保存至该磁盘。

注意：多数云平台仅支持单容器挂载持久化磁盘，目前不支持多前端节点部署。如需扩展性能，可：

• 提升单个容器的CPU/RAM资源（通常满足需求）
• 搭建Linux节点作为public/media目录的NFS共享服务器，再挂载至各前端节点

注：官方正在开发S3兼容存储支持以实现更好的水平扩展，目前暂不可用。

简单docker-compose配置

yml
services:
    php:
        container_name: maho
        image: mahocommerce/maho:latest
        environment:
            - SERVER_NAME=maho.local
        ports:
            - ${HTTP_PORT:-80}:80
            - ${HTTPS_PORT:-443}:443
            - ${HTTPS_PORT:-443}:443/udp
        restart: unless-stopped
        volumes:
            - .docker/data:/data
            - .docker/config:/config
            - ./app:/app/app
            - ./media:/app/public/media
        tty: true
    mysql:
        container_name: mysql
        image: mysql:latest
        environment:
            - MYSQL_DATABASE=maho
            - MYSQL_USER=maho
            - MYSQL_PASSWORD=askmd72BBSspak
            - MYSQL_ROOT_PASSWORD=MaajwekSNUsk242sred
        ports:
            - "3306:3306"
        restart: unless-stopped
        volumes:
            - ./mysql-data:/var/lib/mysql

上述配置将app（含local.xml配置）、media（媒体文件）和mysql-data（数据库数据）目录直接映射至主机，可根据需求调整。

容器启动后，通过以下命令安装Maho：

bash
docker exec -it maho ./maho install --license_agreement_accepted yes --locale en_US --timezone Europe/London --default_currency EUR --db_host mysql --db_name maho --db_user maho --db_pass askmd72BBSspak --url https://maho.local/ --secure_base_url https://maho.local/ --use_secure 1 --use_secure_admin 1 --admin_lastname admin --admin_firstname admin --admin_email admin@admin.com --admin_username admin --admin_password qwe123098poiqwe123098poi --sample_data=1
docker exec -it maho ./maho index:reindex:all
docker exec -it maho ./maho cache:flush

自定义平台

电商项目通常需要附加模块和定制开发，因此建议将本镜像导入项目仓库，在其基础上构建自定义镜像。这样既能利用官方的更新和支持，又能整合项目的定制化需求。