边缘加速
  • 站点加速
    • 概述
    • Quickly Import and Export Site Configuration
    • 访问控制
      • Token 鉴权
    • 智能加速
    • 文件优化
      • 智能压缩
    • 网络优化
      • HTTP/2
      • HTTP/3(QUIC)
        • 概述
        • 启用 HTTP/3
        • QUIC SDK
          • SDK 概览
          • SDK 下载和集成指引
          • 代码示例
            • Android
            • iOS
          • API 文档
            • Android
            • iOS
      • IPv6 访问
      • 最大上传大小
      • WebSocket
      • 携带客户端 IP 头部回源
      • 携带客户端 IP 地理位置头部回源
      • 开启 gRPC
    • URL 重写
      • 访问 URL 重定向
      • 回源 URL 重写
    • 修改头部
      • 修改 HTTP 节点响应头
      • 修改 HTTP 回源请求头
    • 自定义错误页面
    • 请求与响应行为
      • 请求处理顺序
      • EdgeOne 默认 HTTP 回源请求头
      • EdgeOne 默认 HTTP 响应头
    • Media Services
      • Audio and Video Pre-pulling
      • Just-in-Time Image Processing
      • Just-in-Time Media Processing
      • VOD Media Origin
  • 四层代理
    • 概述
    • 新建四层代理实例
    • 修改四层代理实例配置
    • 停用/删除四层代理实例
    • 批量配置转发规则
    • 获取客户端真实IP
      • 通过 TOA 获取 TCP 协议客户端真实 IP
      • 通过 Proxy Protocol V1/V2 协议获取客户端真实 IP
        • 概述
        • 方式一:通过 Nginx 获取客户端真实 IP
        • 方式二:在业务服务器解析客户端真实 IP
        • Proxy Protocol V1/V2 获取的客户端真实 IP 格式
      • 通过 SPP 协议传递客户端真实 IP
  • 边缘 DNS
    • 托管域名 DNS 解析
      • 修改 DNS 服务器
      • 配置域名 DNS 解析记录
      • DNS 高级配置
    • 接入加速域名
      • 添加加速域名
      • 站点/域名归属权验证
      • 修改 CNAME 解析
    • 别称域名
      • 概述
      • 配置指南
      • 通过别称域名批量接入 SaaS 建站域名
      • 别称域名实现业务的容灾
    • 流量调度
      • 流量调度管理
    • 源站配置
      • 回源配置
        • 配置回源 HTTPS
        • Host Header 重写
        • 回源请求参数设置
        • 回源跟随重定向
        • HTTP/2 回源
        • 分片回源
      • 负载均衡
        • 概述
        • 快速创建负载均衡实例
        • 健康检查策略介绍
        • 查看源站健康状态
        • 相关参考
          • 负载均衡相关概念
          • 请求重试策略介绍
      • 源站组操作指引
      • 相关参考
        • 旧版源站组兼容相关问题
      • 获取 EdgeOne 回源节点 IP
  • 边缘缓存
    • 概述
    • EdgeOne 缓存规则介绍
      • EdgeOne 内容缓存规则
      • 缓存键(Cache Key)介绍
      • Vary 特性
    • 缓存配置
      • 自定义 Cache Key
      • 节点缓存 TTL
      • 状态码缓存 TTL
      • 浏览器缓存 TTL
      • 离线缓存
      • 缓存预刷新
    • 清除和预热缓存
      • 清除缓存
      • 预热缓存
    • 如何提高 EdgeOne 的缓存命中率
  • 规则引擎
    • 概述
    • 规则引擎支持的匹配类型与操作
    • 规则管理
    • 变量

Just-in-Time Image Processing

功能简介

图片处理功能允许您根据需求调整图片尺寸和转换图片格式。通过 EdgeOne 边缘服务器直接处理、缓存和响应图片,您的业务源站只需存储原始图像,从而降低了图片管理成本。 EdgeOne 边缘服务器在不影响视觉感受的前提下压缩图片,以提高页面加载速度并优化图片加速性能,在保持图像质量的同时,增强用户体验。

支持的图片处理能力

重置大小

能力
参数名
参数值(type/pixel)
说明
重置大小
eo-img.resize
w/<Width>,例如:w/100
指定宽度,高度自适应
h/<Height>,例如:h/100
指定高度,宽度自适应
w/<Width>/h/<Height>,例如:w/100/h/100
指定宽高
l/<Long>,例如:l/100
指定长边,短边自适应
s/<Short>,例如:s/100
指定短边,长边自适应

格式转换

支持通过携带指定参数将原图转换为指定格式
能力
参数名
支持输入格式
支持输出格式
格式转换
eo-img.format
静态图片:jpg、png、bmp、jp2、jxr、gif、webp、avif、heif
均静态:jpg、png、bmp、jp2、jxr、gif、heif、webp、avif
动态图片:gif、webp、avif、heif
静态:jpg、png、bmp、jp2、jxr(取 gif 动画首帧作为单一静态图像) 动态:gif、webp、avif、heif

限制说明

处理图片原图大小不超过32MB。
输入的原图宽、高不超过30000像素且总像素不超过2.5亿像素;针对动图,原图宽 x 高 x 帧数不得超过2.5亿像素。
输入的 gif 格式动画帧数不超过300帧。
输出的图片宽、高设置不得超过9999像素。
注意:
以下任意情况,可能导致图片处理失败,返回原图:
1. 图片处理原图和结果图像的任何一个参数超过以上限制,我们将无法进行图片处理,而只能响应原图。
2. 输入错误的请求参数时,图片将不会被处理,直接返回原图,例如以下几种情况:
重复输入参数:eo-img.resize=w/100&eo-img.resize=w/200,将视为非法传参;
拼写错误:任何格式错误或拼写错误的参数,例如eo-img.resize=w=100,都会被视为非法传参;
重置大小参数错误:参数w/(宽度)和h/(高度)不应与s/(短边)和l/(长边)混用。例如:w/300/s/200是非法传参,图片将保持原状。
3. 若在控制台内关闭了图片缩放功能,则所有 eo-img 相关参数被视为普通查询字符串,不会触发图片处理功能。
4. 若出现其他异常情况导致无法正常处理图片,我们会优先提供原始图片,在后续的请求中,我们会自动尝试重新进行图片处理。

计费说明

此功能为收费功能,将根据图片缩放请求数计费,详见 增值服务用量单元费用(后付费)
说明:
此功能正在限时免费,请关注后续计费通知。

使用方式

您可以直接通过在客户端请求 URL 中拼接图片处理相关参数来实现图片缩放,可参考以下步骤了解如何使用。
如果您不希望变更原始客户端请求 URL,也可以通过 EdgeOne 边缘函数的能力,自动根据客户端请求信息,自适应缩放或转换图片格式。使用方式请参见:通过边缘函数实现自适应图片格式转换

在客户端请求 URL 中增加图片处理参数

如果您需要通过在客户端请求 URL 中增加相关参数实现图片缩放,可参考以下步骤:
1. 登录 边缘安全加速平台 EO 控制台,在左侧菜单栏中,单击站点列表,在站点列表内单击需配置的站点。
2. 在站点详情页面,单击多媒体服务 > 图片处理,进入图片处理页面。
3. 单击图片即时处理开关,即可开始使用。

4. 开启后,您只需要通过在客户端请求 URL 后拼接 eo-img 相关参数传递图片缩放需求,EdgeOne 将自动根据客户端请求 URL 内的图片处理参数完成图片处理。例如: https://www.example.com/foo.png?eo-img.resize=w/100

图片处理示例

处理的原图为 500*280,500 KB,处理示例如下:
1. 指定宽度为200px,高度自适应。
请求 url:http://www.example.com/foo.png?eo-img.resize=w/200

2. 指定高度为200px,宽度自适应。
请求 url:http://www.example.com/foo.png?eo-img.resize=h/200

3. 指定宽度为300px,高度为200px。
请求 url:http://www.example.com/foo.png?eo-img.resize=w/300/h/200
注意:
同时指定宽高,会按照指定的值缩放,不再保持原图长宽比。

4. 指定长边为400px,短边自适应。
请求 url:http://www.example.com/foo.png?eo-img.resize=l/400

5. 指定短边为200px,长边自适应。
请求 url:http://www.example.com/foo.png?eo-img.resize=s/200

6. 指定图片转换格式为 webp。
请求 url:http://www.example.com/foo.png?eo-img.format=webp
输出图片格式:webp。
7. 指定宽度为200px,高度自适应,并转换格式为 webp。
请求 url:http://www.example.com/foo.png?eo-img.resize=w/200&eo-img.format=webp