zalari/image-resizer

Image-Resizer 镜像说明

镜像概述

zalari/image-resizer是一个Node.js应用，作为CDN自定义源实现图片实时调整与优化。它支持部署到Heroku、AWS等云平台，核心目标是简化Web应用中图片上传存储阶段的尺寸设置流程，底层依赖sharp库处理图片，支持插件扩展功能。

核心功能

• 动态调整：根据请求参数调整图片尺寸（高度、宽度、正方形裁剪等）。
• 图片优化：自定义质量、启用渐进式加载、移除元数据。
• 多源支持：默认支持S3、、、***、Vimeo及本地文件系统。
• 插件扩展：通过插件架构添加自定义图片源或过滤器。
• 格式转换：支持JPEG、PNG、WEBP格式互转。
• 元数据接口：提供JSON格式的图片元数据查询。

使用场景

• Web应用动态处理：避免存储多尺寸图片，降低存储成本。
• CDN缓存优化：生成的图片通过CDN缓存，提升用户访问速度。
• 外部源统一处理：标准化处理社交媒体或第三方平台的图片。

配置说明

关键环境变量

Docker部署示例

Docker Run命令

bash
docker run -d \
  -p 3001:3001 \
  -e NODE_ENV=production \
  -e AWS_ACCESS_KEY_ID=your_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret \
  -e AWS_REGION=cn-north-1 \
  -e S3_BUCKET=your_bucket \
  zalari/image-resizer

Docker Compose示例

yaml
version: '3'
services:
  image-resizer:
    image: zalari/image-resizer
    ports:
      - "3001:3001"
    environment:
      - NODE_ENV=production
      - AWS_ACCESS_KEY_ID=your_key
      - AWS_SECRET_ACCESS_KEY=your_secret
      - AWS_REGION=cn-north-1
      - S3_BUCKET=your_bucket

使用方法

通过URL参数获取调整后的图片： http://your-domain.com/:modifiers/path/to/image.png[:format][:metadata]

• modifiers：调整参数（如h500=高度500，s50=正方形50px）
• format：输出格式（如.webp）
• metadata：添加.json获取元数据

示例：

• 50px正方形图片：http://domain.com/s50/path/image.png
• WEBP格式转换：http://domain.com/path/image.png.webp
• 元数据查询：http://domain.com/path/image.png.json