jpeg: Módulo de filtro JPEG do NGINX

Instalação

Você pode instalar este módulo em qualquer distribuição baseada em RHEL, incluindo, mas não se limitando a:

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

CentOS/RHEL 8+, Fedora Linux, Amazon Linux 2023+CentOS/RHEL 7 e 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

Ative o módulo adicionando o seguinte no início de /etc/nginx/nginx.conf:

load_module modules/ngx_http_jpeg_filter_module.so;

Este documento descreve o nginx-module-jpeg v1.0.1 lançado em 04 de setembro de 2018.

Módulo de filtro Nginx para adicionar sobreposições em JPEGs em tempo real com libmodjpeg.

Com libmodjpeg, você pode sobrepor uma imagem (mascarada) em um JPEG existente da forma mais sem perdas possível. As alterações no JPEG ocorrem apenas onde a imagem sobreposta é aplicada. Todas as modificações acontecem no domínio DCT, assim o JPEG é decodificado e codificado sem perdas.

Usos Típicos
Experimente
Instalação
Compatibilidade
Sinopse
Diretivas
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
Notas
Licença
Agradecimentos

Usos Típicos

Este módulo de filtro pode adicionar sobreposições (por exemplo, um logotipo, marca d'água visual) em JPEGs quando são solicitados.

Algumas ideias:

Considere que você é um fotógrafo e tem uma galeria de imagens em seu site. Sem codificar seu logotipo (marca, marca d'água, ...) diretamente nessas imagens, você pode aplicá-lo no momento em que a imagem é solicitada. Sempre que você atualizar seu logotipo, basta atualizar a configuração do nginx e está feito. Não há necessidade de reprocessar todas as suas imagens.
Você tem uma loja online com milhares de imagens de produtos. Com apenas a configuração do nginx, você pode adicionar seu logotipo a todas as imagens dos produtos. Você não precisa processar todas as imagens dos produtos.
Você tem um serviço pago. Adicione uma marca d'água a todas as imagens se o usuário não estiver inscrito. Se o usuário estiver inscrito, não aplique a marca d'água ou coloque apenas um pequeno logotipo nas imagens sem tocar nas imagens originais.
Em seu site, usuários registrados podem enviar imagens. Adicione o avatar do usuário à imagem que enviou a imagem sem processá-la após o upload. Se o usuário mudar seu avatar, todas as suas imagens terão automaticamente o novo avatar.

Experimente

Para experimentar este módulo de filtro, puxe a imagem do docker

docker pull ioppermann/modjpeg-nginx:latest

O contêiner docker expõe a porta TCP 80 e espera um diretório com imagens montado em /images, por exemplo:

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

Agora você pode navegar até http://localhost:8080/ e clicar nas imagens listadas. O logotipo do modjpeg será aplicado no canto superior esquerdo. Por padrão, apenas imagens que são menores que 10MB são processadas pelo filtro. Pare o contêiner pressionando Ctrl-c.

O filtro pode ser controlado por estas variáveis de ambiente:

Nome	Padrão	Descrição
MJ_GRACEFUL	on	Veja jpeg_filter_graceful
MJ_BUFFER	10M	Veja jpeg_filter_buffer
MJ_MAX_PIXEL	0	Veja jpeg_filter_max_pixel
MJ_DROPON_ALIGN	"top left"	Veja jpeg_filter_dropon_align
MJ_DROPON_OFFSET	"0 0"	Veja jpeg_filter_dropon_offset
MJ_DROPON_FILE	"/usr/local/nginx/conf/dropon.png"	Veja jpeg_filter_dropon_file

O seguinte exemplo permitirá imagens com até 150 megapixels (MJ_MAX_PIXEL) e 100MB de tamanho de arquivo (MJ_BUFFER). O logotipo será colocado no canto inferior direito (MJ_DROPON_ALIGN) com um deslocamento de -15px horizontal e verticalmente (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

Para mudar o logotipo, você pode montar um volume adicional ou colocá-lo no diretório que você já montou, por exemplo:

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

Clonar e instalar libmodjpeg

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

Clonar modjpeg-nginx

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

Baixar e instalar 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

Configurar como módulo estático, ou ...

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

... configurar como módulo dinâmico (a partir do nginx 1.9.11)

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

Se a biblioteca libmodjpeg não for encontrada, adicione por exemplo '--with-ld-opt=-L/usr/local/lib' às

opções de configuração se ela foi instalada em /usr/local/lib

Você pode querer usar as outras opções './configure' que são usadas

na sua construção atual do nginx. Verifique a saída de 'nginx -V'.

make make install

Se você configurou o modjpeg-nginx como um módulo dinâmico, você deve carregar o módulo no início da configuração

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

Sinopse

   ...

   location /gallery {
      # habilitar módulo de filtro jpeg
      jpeg_filter on;

      # limitar tamanhos de imagem a 9 megapixels
      jpeg_filter_max_pixel 9000000;

      # limitar o tamanho do arquivo de imagem a 5 megabytes
      jpeg_filter_buffer 5M;

      # entregar as imagens não modificadas se um dos limites se aplicar
      jpeg_filter_graceful on;

      # pixelar a imagem
      jpeg_filter_effect pixelate;

      # adicionar um logotipo mascarado no canto inferior direito
      # com uma distância de 10 pixels da borda
      jpeg_filter_dropon_align bottom right;
      jpeg_filter_dropon_offset -10 -10;
      jpeg_filter_dropon_file /path/to/logo.jpg /path/to/mask.jpg;
   }

   ...

Ou use-o com OpenResty's ngx_http_lua_module e um logotipo 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)]
      }

      # habilitar módulo de filtro jpeg
      jpeg_filter on;

      # limitar tamanhos de imagem a 9 megapixels
      jpeg_filter_max_pixel 9000000;

      # limitar o tamanho do arquivo de imagem a 5 megabytes
      jpeg_filter_buffer 5M;

      # entregar as imagens não modificadas se um dos limites se aplicar
      jpeg_filter_graceful on;

      # pixelar a imagem
      jpeg_filter_effect pixelate;

      # adicionar um logotipo em uma posição aleatória
      jpeg_filter_dropon_align $valign $halign;
      jpeg_filter_dropon_file /path/to/logo.png;
   }

   ...

Ou gere um logotipo com 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)
           }

       # habilitar módulo de filtro jpeg
       jpeg_filter on;

           # limitar tamanhos de imagem a 9 megapixels
           jpeg_filter_max_pixel 9000000;

           # limitar o tamanho do arquivo de imagem a 5 megabytes
           jpeg_filter_buffer 5M;

           # entregar as imagens não modificadas se um dos limites se aplicar
           jpeg_filter_graceful on;

           # pixelar a imagem
           jpeg_filter_effect pixelate;

           # adicionar um logotipo gerado no canto inferior direito
           # com uma distância de 10 pixels da borda
           jpeg_filter_dropon_align bottom right;
           jpeg_filter_dropon_offset -10 -10;
           jpeg_filter_dropon_memory $logobytestream;
      }
      ...
   }
   ...
}

jpeg_filter

Sintaxe: jpeg_filter on | off

Padrão: jpeg_filter off

Contexto: location

Habilita o módulo de filtro jpeg.

Esta diretiva está desativada por padrão.