recognizebv/imaginary

recognizebv/imaginary 镜像说明

镜像概述

recognizebv/imaginary是一个基于Go语言开发的高性能HTTP微服务镜像，用于高效处理图像。它依赖libvips库，具备低内存占用和快速处理能力，支持多种图像格式（JPEG、PNG、WEBP等），可作为私有或公共服务用于大规模图像处理，且原生支持Docker部署。

核心功能

• 基础图像处理：裁剪（含智能裁剪）、缩放、旋转（支持EXIF自动旋转）、翻转、缩略图生成
• 高级操作：水印（文字/图片）、格式转换（支持透明通道）、模糊处理、图像信息提取
• 辅助功能：错误时返回占位图、API授权、URL签名保护、CORS支持、并发限制

使用场景

• Web应用的动态图像优化（如缩略图生成、尺寸调整）
• 批量图像处理服务（如批量添加水印、格式转换）
• CDN或静态资源服务的图像实时处理
• 企业内部图像加工流水线

配置说明

Docker部署示例

基本运行

bash
docker run -p 9000:9000 recognizebv/imaginary -cors -gzip

启用远程URL图像处理

bash
docker run -p 9000:9000 recognizebv/imaginary -enable-url-source

挂载本地目录处理本地图像

bash
docker run -p 9000:9000 -v /本地图像目录:/mnt/images recognizebv/imaginary -mount /mnt/images

Docker Compose配置

yaml
version: "3"
services:
  imaginary:
    image: recognizebv/imaginary:latest
    volumes:
      - /本地图像目录:/mnt/data
    environment:
      PORT: 9000
    command: -enable-url-source -mount /mnt/data
    ports:
      - "9000:9000"

关键参数说明

• -enable-url-source：允许通过URL参数处理远程图像
• -mount <路径>：挂载本地目录，支持处理本地图像
• -concurrency <数量>：设置并发限制（如20，避免过载）
• -enable-placeholder：错误时返回默认占位图
• -key <密钥>：启用API密钥授权
• -url-signature-key <密钥>：启用URL签名保护（需32字符以上密钥）