build(docker): Docker mozjpeg variant for imagor (#613)

* build(docker): Docker mozjpeg variant for imagor

* build(docker): Docker mozjpeg variant for imagor

* build(docker): Docker mozjpeg variant for imagor

* build(docker): Docker mozjpeg variant for imagor

* build(docker): Docker mozjpeg variant for imagor

* build(docker): Docker mozjpeg variant for imagor

* chore: add community section to readme

* add readme

Author: cshum

.github/workflows/docker-imagor-magick.yml renamed to .github/workflows/docker-variants.yml

@@ -1,4 +1,4 @@
-name: docker-imagor-magick
+name: docker-variants
 
 on:
   push:
@@ -7,14 +7,22 @@ on:
     tags: [ 'v*.*.*' ]
 
 jobs:
-  build:
-    name: Docker imagor-magick
+  build-variants:
+    name: Docker variants
     runs-on: ubuntu-latest
     if: github.repository == 'cshum/imagor'
     permissions:
       contents: read
       packages: write
-
+    strategy:
+      matrix:
+        variant:
+          - name: magick
+            build_args: |
+              ENABLE_MAGICK=true
+          - name: mozjpeg
+            build_args: |
+              ENABLE_MOZJPEG=true
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
@@ -38,7 +46,7 @@ jobs:
         id: meta
         uses: docker/metadata-action@v4
         with:
-          images: ghcr.io/cshum/imagor-magick
+          images: ghcr.io/cshum/imagor-${{ matrix.variant.name }}
           tags: |
             type=ref,event=branch
             type=semver,pattern={{version}}
@@ -52,5 +60,4 @@ jobs:
           push: true
           tags: ${{ steps.meta.outputs.tags }}
           labels: ${{ steps.meta.outputs.labels }}
-          build-args: |
-            ENABLE_MAGICK=true
+          build-args: ${{ matrix.variant.build_args }}

Dockerfile

@@ -3,10 +3,32 @@ FROM golang:${GOLANG_VERSION}-trixie as builder
 
 ARG VIPS_VERSION=8.17.2
 ARG TARGETARCH
+
 ARG ENABLE_MAGICK=false
 
+ARG ENABLE_MOZJPEG=false
+ARG MOZJPEG_VERSION=4.1.1
+ARG MOZJPEG_URL=https://github.com/mozilla/mozjpeg/archive
+
 ENV PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
 
+# Conditionally install MozJPEG build dependencies and build MozJPEG
+RUN if [ "$ENABLE_MOZJPEG" = "true" ]; then \
+  DEBIAN_FRONTEND=noninteractive \
+  apt-get update && \
+  apt-get install --no-install-recommends -y build-essential libboost-all-dev pkg-config autoconf automake libtool nasm make cmake flex libpng-tools libpng-dev zlib1g-dev && \
+  cd /tmp && \
+  curl -fsSLO ${MOZJPEG_URL}/v${MOZJPEG_VERSION}.tar.gz && \
+  tar xf v${MOZJPEG_VERSION}.tar.gz && \
+  cd mozjpeg-${MOZJPEG_VERSION} && \
+  cmake -G"Unix Makefiles" -DCMAKE_INSTALL_PREFIX=/usr/local . && \
+  make -j4 && \
+  make install && \
+  cp jpegint.h /usr/include/jpegint.h && \
+  cd .. && \
+  rm -rf mozjpeg-${MOZJPEG_VERSION} v${MOZJPEG_VERSION}.tar.gz; \
+fi
+
 # Installs libvips + required libraries + conditionally ImageMagick
 RUN DEBIAN_FRONTEND=noninteractive \
   apt-get update && \
@@ -56,6 +78,7 @@ FROM debian:trixie-slim as runtime
 LABEL maintainer="adrian@cshum.com"
 
 ARG ENABLE_MAGICK=false
+ARG ENABLE_MOZJPEG=false
 
 COPY --from=builder /usr/local/lib /usr/local/lib
 COPY --from=builder /etc/ssl/certs /etc/ssl/certs

README.md

@@ -438,6 +438,49 @@ docker run -p 8000:8000 ghcr.io/cshum/imagor-magick -imagor-unsafe -imagor-auto-
 
 We recommend using the standard imagor image for most use cases.
 
+### MozJPEG Support
+
+By default, imagor uses libjpeg-turbo for JPEG encoding, which provides fast compression. For enhanced JPEG compression at the cost of slower encoding speed, imagor provides a MozJPEG-enabled variant that includes [MozJPEG](https://github.com/mozilla/mozjpeg) support through libvips.
+
+MozJPEG improves JPEG compression efficiency while maintaining compatibility with existing JPEG decoders. It can typically reduce JPEG file sizes by 10-15% compared to libjpeg-turbo while maintaining the same visual quality, but with slower encoding performance.
+
+#### Docker build `imagor-mozjpeg`
+
+```bash
+docker pull ghcr.io/cshum/imagor-mozjpeg
+```
+
+Usage:
+
+```bash
+docker run -p 8000:8000 ghcr.io/cshum/imagor-mozjpeg -imagor-unsafe -vips-mozjpeg
+```
+
+#### Enabling MozJPEG
+
+MozJPEG can be enabled using the `-vips-mozjpeg` command-line argument, or the equivalent environment variable:
+
+```bash
+VIPS_MOZJPEG=1
+```
+
+Docker Compose example:
+
+```yaml
+version: "3"
+services:
+  imagor:
+    image: ghcr.io/cshum/imagor-mozjpeg:latest
+    environment:
+      PORT: 8000
+      IMAGOR_UNSAFE: 1
+      VIPS_MOZJPEG: 1  # Enable MozJPEG compression
+    ports:
+      - "8000:8000"
+```
+
+When enabled, MozJPEG will be used for JPEG output, providing better compression efficiency for JPEG images.
+
 ### Metadata and Exif
 
 imagor provides metadata endpoint that extracts information such as image format, resolution and Exif metadata.