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

Установка на Debian/Ubuntu

Эти документы применимы к APT пакету nginx-module-jpeg, предоставленном репозиторием GetPageSpeed Extras.

Настройте APT репозиторий, как описано в Настройка APT репозитория.
Установите модуль:

sudo apt-get update
sudo apt-get install nginx-module-jpeg

Warning

Этот модуль еще не опубликован под именем nginx-module-jpeg в APT репозиториях. Следите за обновлениями или напишите на support@getpagespeed.com, чтобы запросить его.

Модуль фильтрации 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 будет применен в верхнем левом углу. По умолчанию фильтр обрабатывает только изображения, размером меньше 10MB. Остановите контейнер, нажав 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;
   }

   ...

Или используйте его с ngx_http_lua_module от OpenResty и 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.

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