thumbororg/thumbor

Thumbor 官方Docker镜像文档

镜像概述

Thumbor官方Docker镜像是开源实时图片处理服务Thumbor的容器化部署方案。Thumbor能够对图片进行实时处理，包括裁剪、缩放、旋转、滤镜应用、格式转换等操作，同时提供安全的URL签名机制，防止未授权图片处理请求，广泛应用于需要动态优化图片资源的场景。

核心功能与特性

• 实时图片处理：支持即时对图片进行裁剪、缩放（按尺寸/比例）、旋转、翻转等几何操作
• 丰富滤镜效果：提供灰度、对比度、亮度、模糊、锐化等多种滤镜
• 格式转换：支持JPEG、PNG、WebP、GIF等多种图片格式的转换与优化
• 安全机制：通过密钥签名生成安全URL，防止***图片处理请求
• 缓存支持：内置缓存机制，提升重复图片处理请求的响应速度
• 灵活存储：支持本地文件系统、Amazon S3、Google Cloud Storage等多种存储后端
• 可扩展性：支持自定义插件扩展功能，如人脸识别、水印添加等

使用场景

• 网站图片优化：动态生成适配不同设备（PC/移动端）的图片尺寸
• 移动应用：减少客户端图片处理压力，服务端统一处理后返回优化图片
• 内容管理系统（CMS）：集成到CMS中实现图片自动优化与格式转换
• 电商平台：实时生成商品缩略图、详情图等多规格图片
• 图片CDN辅助：作为CDN源站，提供动态图片处理能力

使用方法与配置说明

基本运行命令

通过以下命令启动基础Thumbor服务：

bash
docker run -d -p 8888:8888 --name thumbor thumbor/thumbor

• -p 8888:8888：映射容器8888端口到主机，Thumbor默认监听8888端口
• --name thumbor：指定容器名称为thumbor

环境变量配置

通过环境变量自定义Thumbor配置，常用变量如下：

示例：带安全密钥和端口配置的启动命令

bash
docker run -d \
  -p 9000:9000 \
  -e THUMBOR_PORT=9000 \
  -e SECURITY_KEY=my_secure_key_123 \
  --name thumbor-secure \
  thumbor/thumbor

卷挂载

如需持久化存储图片或配置文件，可挂载主机目录到容器：

• /data/thumbor/storage：存储原始图片的目录
• /data/thumbor/result_storage：存储处理后图片的目录
• /data/thumbor/cache：缓存目录
• /etc/thumbor：自定义配置文件目录（需包含thumbor.conf）

示例：挂载存储和缓存目录

bash
docker run -d \
  -p 8888:8888 \
  -v /host/path/storage:/data/thumbor/storage \
  -v /host/path/cache:/data/thumbor/cache \
  --name thumbor-persistent \
  thumbor/thumbor

Docker Compose配置示例

以下是使用Docker Compose部署Thumbor的示例（含持久化存储和安全配置）：

yaml
version: '3'
services:
  thumbor:
    image: thumbor/thumbor
    ports:
      - "8888:8888"
    environment:
      - SECURITY_KEY=your_secure_key_here
      - MAX_WIDTH=2000
      - MAX_HEIGHT=2000
      - CACHE_BACKEND=thumbor.cache.file_cache
    volumes:
      - ./storage:/data/thumbor/storage
      - ./cache:/data/thumbor/cache
    restart: unless-stopped

验证服务

服务启动后，可通过访问以下URL测试基础功能（需替换[IMAGE_URL]为实际图片URL）：

http://localhost:8888/unsafe/300x200/[IMAGE_URL]

• unsafe：未签名模式（仅测试用，生产环境需使用安全签名URL）
• 300x200：目标图片尺寸（宽度x高度）
• [IMAGE_URL]：原始图片的URL（需URL编码）

注意事项

• 生产环境必须设置SECURITY_KEY并使用签名URL，避免未授权图片处理
• 高并发场景建议配置分布式缓存（如Redis）和负载均衡
• 对于大尺寸图片处理，可适当调整容器内存限制（--memory参数）
• 自定义配置文件需确保权限正确，避免容器内无法读取