jpeg: NGINX JPEG 过滤模块

安装

您可以在任何基于 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，于 2018 年 9 月 4 日发布。

Nginx 过滤模块，用于通过 libmodjpeg 在 JPEG 上动态添加覆盖层。

使用 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）和文件大小为 100MB（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 库，例如，如果它安装在 /usr/local/lib 中，请在配置选项中添加 `--with-ld-opt=-L/usr/local/lib`

您可能希望使用当前 nginx 构建中使用的其他 `./configure` 选项。检查 `nginx -V` 的输出。

make
make install

如果您将 modjpeg-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 的 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 过滤模块。

此指令默认关闭。