jpeg: Модуль фильтра JPEG для NGINX

Установка

Вы можете установить этот модуль в любой дистрибутив на базе RHEL, включая, но не ограничиваясь:

RedHat Enterprise Linux 7, 8, 9 и 10
CentOS 7, 8, 9
AlmaLinux 8, 9
Rocky Linux 8, 9
Amazon Linux 2 и Amazon Linux 2023

CentOS/RHEL 8+, Fedora Linux, Amazon Linux 2023+CentOS/RHEL 7 и Amazon Linux 2

dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-jpeg

yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-jpeg

Включите модуль, добавив следующее в начало файла /etc/nginx/nginx.conf:

load_module modules/ngx_http_jpeg_filter_module.so;

Этот документ описывает nginx-module-jpeg v1.0.1, выпущенный 4 сентября 2018 года.

Модуль фильтра Nginx для добавления наложений на JPEG в реальном времени с помощью libmodjpeg.

С помощью libmodjpeg вы можете наложить (замаскированное) изображение на существующий JPEG с минимальными потерями. Изменения в JPEG происходят только там, где применяется наложенное изображение. Все модификации происходят в области DCT, таким образом JPEG декодируется и кодируется без потерь.

Типичные применения
Попробуйте
Установка
Совместимость
Синопсис
Директивы
jpeg_filter
jpeg_filter_max_pixel
jpeg_filter_buffer
jpeg_filter_optimize
jpeg_filter_progressive
jpeg_filter_arithmetric
jpeg_filter_graceful
jpeg_filter_effect
jpeg_filter_dropon_align
jpeg_filter_dropon_offset
jpeg_filter_dropon_file
jpeg_filter_dropon_memory
Заметки
Лицензия
Благодарности

Типичные применения

Этот модуль фильтра может добавлять наложения (например, логотип, визуальный водяной знак) на JPEG, когда они запрашиваются.

Несколько идей:

Представьте, что вы фотограф и у вас есть галерея изображений на вашем сайте. Без жесткой кодировки вашего логотипа (бренда, водяного знака и т. д.) в эти изображения вы можете применить его в момент запроса изображения. Когда вы обновляете свой логотип, просто обновите конфигурацию nginx, и это сделано. Нет необходимости повторно обрабатывать все ваши изображения.
У вас есть интернет-магазин с тысячами изображений продуктов. Просто настроив nginx, вы можете добавить свой логотип ко всем изображениям продуктов. Вам не нужно обрабатывать все изображения продуктов.
У вас есть платный сервис. Добавьте водяной знак ко всем изображениям, если пользователь не подписан. Если пользователь подписан, не применяйте водяной знак или просто добавьте небольшой логотип на изображения, не затрагивая оригинальные изображения.
На вашем сайте зарегистрированные пользователи могут загружать изображения. Добавьте аватар пользователя к изображению, которое загрузил пользователь, без обработки после загрузки. Если пользователь изменит свой аватар, все его изображения автоматически получат новый аватар.

Попробуйте

Чтобы попробовать этот модуль фильтра, загрузите образ docker

docker pull ioppermann/modjpeg-nginx:latest

Контейнер docker открывает TCP-порт 80 и ожидает, что директория с изображениями будет смонтирована на /images, например:

docker run -it --rm --name=modjpeg-nginx \
   --mount type=bind,src=$PWD/images,dst=/images,readonly \
   -p 8080:80 \
   ioppermann/modjpeg-nginx:latest

Теперь вы можете перейти по адресу http://localhost:8080/ и кликнуть на перечисленные изображения. Логотип modjpeg будет применен в верхнем левом углу. По умолчанию фильтр обрабатывает только изображения размером менее 10 МБ. Остановите контейнер, нажав Ctrl-c.

Фильтр можно контролировать с помощью следующих переменных окружения:

Имя	По умолчанию	Описание
MJ_GRACEFUL	on	См. jpeg_filter_graceful
MJ_BUFFER	10M	См. jpeg_filter_buffer
MJ_MAX_PIXEL	0	См. jpeg_filter_max_pixel
MJ_DROPON_ALIGN	"top left"	См. jpeg_filter_dropon_align
MJ_DROPON_OFFSET	"0 0"	См. jpeg_filter_dropon_offset
MJ_DROPON_FILE	"/usr/local/nginx/conf/dropon.png"	См. jpeg_filter_dropon_file

Следующий пример позволит обрабатывать изображения с максимальным разрешением до 150 мегапикселей (MJ_MAX_PIXEL) и размером файла до 100 МБ (MJ_BUFFER). Логотип будет размещен в нижнем правом углу (MJ_DROPON_ALIGN) с смещением -15 пикселей по горизонтали и вертикали (MJ_DROPON_OFFSET).

docker run -it --rm --name=modjpeg-nginx \
   --mount type=bind,src=$PWD/images,dst=/images,readonly \
   -p 8080:80 \
   -e MJ_MAX_PIXEL=150000000 \
   -e MJ_BUFFER=100M \
   -e MJ_DROPON_ALIGN="bottom right" \
   -e MJ_DROPON_OFFSET="-15 -15" \
   ioppermann/modjpeg-nginx:latest

Чтобы изменить логотип, вы можете смонтировать дополнительный том или поместить его в директорию, которую вы уже монтируете, например:

docker run -it --rm --name=modjpeg-nginx \
   --mount type=bind,src=$PWD/images,dst=/images,readonly \
   -p 8080:80 \
   -e MJ_DROPON_FILE="/images/logo.png" \
   ioppermann/modjpeg-nginx:latest

Клонируйте и установите libmodjpeg

git clone https://github.com/ioppermann/libmodjpeg.git cd libmodjpeg cmake . make make install cd ..

Клонируйте modjpeg-nginx

git clone https://github.com/ioppermann/modjpeg-nginx.git

Скачайте и установите nginx

wget 'http://nginx.org/download/nginx-1.15.1.tar.gz' tar -xvzf nginx-1.15.1.tar.gz cd nginx-1.15.1

Настройте как статический модуль, или ...

./configure --add_module=../modjpeg-nginx

... настройте как динамический модуль (начиная с nginx 1.9.11)

./configure --add_dynamic_module=../modjpeg-nginx

Если библиотека libmodjpeg не найдена, добавьте, например, '--with-ld-opt=-L/usr/local/lib' в

параметры конфигурации, если она была установлена в /usr/local/lib

Возможно, вам также стоит использовать другие параметры './configure', которые используются

в вашей текущей сборке nginx. Проверьте вывод 'nginx -V'.

make make install

Если вы настроили modjpeg-nginx как динамический модуль, вам нужно загрузить модуль в начале конфигурации

```nginx
...
load_module modules/ngx_http_jpeg_filter_module.so;
...

Синопсис

   ...

   location /gallery {
      # включить модуль фильтра jpeg
      jpeg_filter on;

      # ограничить размеры изображений до 9 мегапикселей
      jpeg_filter_max_pixel 9000000;

      # ограничить размер файла изображения до 5 мегабайт
      jpeg_filter_buffer 5M;

      # доставлять изображения без изменений, если одно из ограничений применимо
      jpeg_filter_graceful on;

      # пикселизировать изображение
      jpeg_filter_effect pixelate;

      # добавить замаскированный логотип в нижнем правом углу
      # с расстоянием 10 пикселей от края
      jpeg_filter_dropon_align bottom right;
      jpeg_filter_dropon_offset -10 -10;
      jpeg_filter_dropon_file /path/to/logo.jpg /path/to/mask.jpg;
   }

   ...

Или используйте его с OpenResty's ngx_http_lua_module и логотипом PNG:

   ...

   location /gallery {
      set_by_lua_block $valign {
         local a = { 'top', 'center', 'bottom' }
         return a[math.random(#a)]
      }

      set_by_lua_block $halign {
         local a = { 'left', 'center', 'right' }
         return a[math.random(#a)]
      }

      # включить модуль фильтра jpeg
      jpeg_filter on;

      # ограничить размеры изображений до 9 мегапикселей
      jpeg_filter_max_pixel 9000000;

      # ограничить размер файла изображения до 5 мегабайт
      jpeg_filter_buffer 5M;

      # доставлять изображения без изменений, если одно из ограничений применимо
      jpeg_filter_graceful on;

      # пикселизировать изображение
      jpeg_filter_effect pixelate;

      # добавить логотип в случайном положении
      jpeg_filter_dropon_align $valign $halign;
      jpeg_filter_dropon_file /path/to/logo.png;
   }

   ...

Или сгенерируйте логотип с помощью Lua-GD:

http {
   ...
   ...
   server {
      ...
      location /gallery {
           set_by_lua_block $logobytestream {
              local gd = require "gd"

              local im = gd.create(210, 70)
              local white = im:colorAllocate(255, 255, 255)
              local black = im:colorAllocate(0, 0, 0)
              im:filledRectangle(0, 0, 140, 80, white)
              im:string(gd.FONT_LARGE, 10, 10, "Hello modjpeg", black)
              im:string(gd.FONT_LARGE, 10, 40, os.date("%c"), black);
              return im:jpegStr(85)
           }

       # включить модуль фильтра jpeg
       jpeg_filter on;

           # ограничить размеры изображений до 9 мегапикселей
           jpeg_filter_max_pixel 9000000;

           # ограничить размер файла изображения до 5 мегабайт
           jpeg_filter_buffer 5M;

           # доставлять изображения без изменений, если одно из ограничений применимо
           jpeg_filter_graceful on;

           # пикселизировать изображение
           jpeg_filter_effect pixelate;

           # добавить сгенерированный логотип в нижнем правом углу
           # с расстоянием 10 пикселей от края
           jpeg_filter_dropon_align bottom right;
           jpeg_filter_dropon_offset -10 -10;
           jpeg_filter_dropon_memory $logobytestream;
      }
      ...
   }
   ...
}

jpeg_filter

Синтаксис: jpeg_filter on | off

По умолчанию: jpeg_filter off

Контекст: location

Включите модуль фильтра jpeg.

Эта директива по умолчанию отключена.