边缘安全加速 ESA提供图像转换功能,可直接对源站图片进行格式/质量转换、裁剪、缩放等处理并进行缓存,提升获取图片的速度,减少回源流量。
图像优化规则仅对命中规则条件的请求进行处理。如果您需要配置站点级的图像优化规则,详细信息请参考图像优化。
适用场景
通过ESA进行图片处理,所有的图片处理和缓存都通过ESA节点完成,源站无感知。
下表为您列出了图片处理常见的适用场景,适用场景较多,不仅限于以下场景。
适用场景 | 说明 |
电商平台 |
|
社交软件 |
|
在线教育 |
|
素材网站 |
|
使用限制
使用图片处理功能时有如下限制。
原图限制:
图片格式只支持JPEG、JPG、PNG、WebP、BMP、GIF、TIFF、JPEG 2000。
原图大小不能超过10MB。
原图的宽×高不能超过16,777,216 px。
说明若图片为 GIF 格式时,GIF 图片的原图宽×高为所有帧相加之和,您可以使用 ImageMagick 等工具查看 GIF 图片的帧信息。
处理后的图片限制:
图片的宽×高不能超过16,777,216 px。
转 WebP 格式时,图片的宽×高不能超过16,777,216 px,且宽和高单边均不能超过16,384 px。如果原图为动图,转 WebP 格式时会被转换为静态图片。
缓存预热限制:
图像转换功能不支持对缓存预热的内容生效,即ESA节点在缓存预热时只回源获取原始图片文件,不会做图像转换处理。
新增图像优化规则
转换验证
原始请求
请求example.com/bb.jpeg,响应的资源为.jpeg格式的正常方向图片。

转换请求
格式转换:以将
.jpeg转换为.png格式为例。将请求URL调整为example.com/bb.jpeg?image_process=format,png,响应的资源为.png格式图片。
图片旋转:以将图片顺时针旋转90°为例。将请求URL调整为
example.com/bb.jpeg?image_process=rotate,90,响应的资源为顺时针旋转90°后的图片。
支持的图片处理方式
开启图像优化后,用户请求的URL携带一个或多个图像处理的相关参数,即可完成相应的图片处理,支持的参数请参见下表。
图片处理功能 | 处理参数 | 说明 |
format | 转换图片格式。 | |
quality | 调整图片质量。 | |
crop | 裁剪指定大小的图片。 | |
resize | 将图片缩放至指定大小(目前只支持将原图缩小处理,暂不支持将原图放大处理)。 | |
| 将携带旋转参数的图片进行自适应旋转或按指定角度以顺时针方向旋转图片。 | |
| 调整图片的亮度、对比度和清晰度。 | |
watermark | 为图片添加图片水印或文字水印。 | |
info | 获取图片信息,包括图片的长、宽、高、图片格式和图片质量等信息。 |
相关文档
规则相关的功能,在生效优先级、可重入性、生效颗粒度上存在差异,详细情况请查看规则相关功能的特性说明。