dpokidov/imagemagick

dpokidov/imagemagick Docker镜像文档

!https://github.com/dooman87/imagemagick-docker/workflows/ci/badge.svg

1. 镜像概述

1.1 概述和主要用途

本镜像提供最新版本的https://github.com/ImageMagick/ImageMagick 7，以Docker容器形式运行。旨在为用户提供稳定的Linux环境，实现最新版ImageMagick的容器化部署，并支持多种现代网络图像格式处理需求。

1.2 核心功能和特性

• 最新ImageMagick 7：内置当前最新版本的ImageMagick 7，支持完整的图像处理功能集。
• 多基础镜像支持：基于Debian Bullseye（默认）和Ubuntu Focal等稳定Linux发行版构建，适配不同环境需求。
• 全面格式兼容：支持Jpeg、PNG、WebP、AVIF、JPEG XL、JpegXR、PDF及TIFF等主流和新兴图像格式。

2. 基础镜像信息

2.1 可用基础镜像

提供两种基础镜像选择：Debian Bullseye（稳定版）和Ubuntu Focal，默认使用Debian Bullseye。可通过Docker镜像标签切换基础镜像（具体标签请参考https://hub.docker.com/r/dpokidov/imagemagick%EF%BC%89%E3%80%82

2.2 格式支持对比

3. 使用方法

3.1 基本使用（默认convert命令）

镜像默认入口点为convert命令，用于执行图像转换操作。使用时需挂载本地图像目录至容器内，示例如下：

bash
# 将本地/your/images目录挂载到容器/imgs目录，调整sample.png尺寸为100x100并保存为resized-sample.png
docker run -v /your/images:/imgs dpokidov/imagemagick /imgs/sample.png -resize 100x100 /imgs/resized-sample.png

3.2 执行其他ImageMagick命令

通过--entrypoint参数可指定其他ImageMagick命令（如identify、mogrify等）。示例如下：

bash
# 运行identify命令查看图像元数据
docker run --entrypoint=identify -v /your/images:/imgs dpokidov/imagemagick /imgs/sample.png

# 运行mogrify命令批量调整目录中所有JPG图像尺寸
docker run --entrypoint=mogrify -v /your/images:/imgs dpokidov/imagemagick -resize 200x200 /imgs/*.jpg

4. 使用场景和适用范围

4.1 典型使用场景

• 图像格式转换：实现PNG→WebP、JPEG→AVIF等格式转换，优化网络传输。
• 批量图像处理：调整尺寸、裁剪、添加水印等批量操作。
• 图像元数据提取：通过identify命令获取图像尺寸、色彩模式等信息。
• 自动化工作流：集成至CI/CD pipeline或后端服务，实现自动化图像处理。

4.2 适用范围

• 开发环境中的图像处理功能测试。
• 容器化部署的应用需集成图像处理能力的场景。
• 对环境一致性要求高的服务器端图像处理任务。

5. 配置说明

5.1 入口点配置

默认入口点为convert，可通过--entrypoint指定其他命令。常用命令包括：

• convert：图像转换（默认）
• identify：图像信息查询
• mogrify：批量修改图像
• composite：图像合成
• montage：创建图像拼接图

详细命令参数参见ImageMagick官方文档。

5.2 数据卷挂载

处理本地文件时，需通过-v参数挂载目录，格式为-v <本地目录>:<容器内目录>，确保容器可读写图像文件。