thumbor 镜像文档

镜像概述

thumbor镜像是基于globo.com开发的开源照片缩略图服务构建的Docker镜像，网址[]

核心功能与特性

核心功能

• 动态缩略图生成：支持自定义尺寸、比例裁剪
• 图片几何操作：包括旋转、翻转、裁剪等
• 丰富滤镜效果：提供灰度、模糊、对比度调整等多种滤镜
• 安全访问控制：支持URL签名验证，防止未授权图片处理
• 多格式支持：兼容JPEG、PNG、WebP等主流图片格式
• 缓存机制：内置缓存功能，提升重复请求处理效率

主要特性

• 开源免费：基于MIT许可证，代码完全开放
• 高度可定制：支持通过插件扩展功能
• 轻量高效：资源占用低，处理速度快
• 跨平台部署：通过Docker容器化，支持各类环境

使用场景与适用范围

• Web应用图片优化：为网站自动生成不同尺寸缩略图，减少页面加载时间
• 移动应用资源处理：根据设备分辨率动态调整图片尺寸，降低带宽消耗
• 内容管理系统集成：作为CMS的图片处理模块，实现上传图片自动优化
• 电子商务平台：商品图片的缩略图生成、裁剪及美化处理
• 内容分发网络：作为CDN节点的图片处理服务，提供实时转换能力

使用方法与配置说明

前提条件

• Docker Engine 20.10+
• Docker Compose（可选，用于多容器部署）

快速启动（docker run）

# 基础启动命令（开发环境）
docker run -d -p 8888:8888 --name thumbor globo/thumbor

生产环境配置（带安全密钥）

docker run -d -p 8888:8888 \
  --name thumbor \
  -e THUMBOR_SECURITY_KEY="your_secure_random_key" \  # 必须设置安全密钥
  -e THUMBOR_MAX_WIDTH=1920 \                         # 限制最大宽度
  -e THUMBOR_MAX_HEIGHT=1080 \                        # 限制最大高度
  -e ALLOWED_SOURCES="*.example.com" \                # 限制图片源域名
  -v ./thumbor-cache:/data \                          # 挂载缓存目录
  globo/thumbor

Docker Compose配置示例

创建docker-compose.yml文件：

version: '3'
services:
  thumbor:
    image: globo/thumbor
    ports:
      - "8888:8888"
    environment:
      - THUMBOR_SECURITY_KEY=your_secure_key_here
      - THUMBOR_PORT=8888
      - THUMBOR_MAX_WIDTH=2000
      - THUMBOR_MAX_HEIGHT=2000
      - THUMBOR_LOADER=thumbor.loaders.http_loader
      - THUMBOR_CACHE=thumbor.cache.file_cache
      - ALLOWED_SOURCES=*.yourdomain.com
    volumes:
      - thumbor_data:/data  # 持久化缓存数据
    restart: unless-stopped

volumes:
  thumbor_data:

启动服务：

docker-compose up -d

核心配置参数（环境变量）

服务验证

服务启动后，可通过以下URL测试基本功能（开发环境，未签名）：

http://localhost:8888/unsafe/300x200/http://example.com/test.jpg

• unsafe：表示未使用签名（仅开发测试用）
• 300x200：目标缩略图尺寸
• [***]：原始图片URL

生产环境需使用签名URL，可通过thumbor提供的签名工具生成授权链接。

注意事项

• 生产环境必须配置THUMBOR_SECURITY_KEY并使用签名URL
• 建议通过ALLOWED_SOURCES限制图片源，防止滥用
• 高并发场景建议配合Redis缓存和负载均衡使用
• 定期更新镜像以获取安全补丁和功能更新