Thumbor S3 Docker

一个集成AWS S3和Minio的Docker镜像，专为动态图像裁剪、调整大小、应用滤镜及图像优化设计。

!Thumbor S3 Docker

概述

Thumbor S3 Docker提供两种Docker镜像变体：轻量级（slim-alpine）和全功能（debian）。轻量级镜像体积更小，全功能镜像包含更多高级特性。

核心功能

所有当前镜像均包含以下特性：

• AWS S3 / Minio集成支持
• jpegtran（已启用）：无损JPEG优化器，通过优化DCT系数减小JPEG文件大小
• gifsicle：生成高质量动态GIF及最小体积静态GIF
• thumbor-aws：***异步非阻塞AWS S3支持扩展
• sentry-client：Sentry错误处理客户端
• Prometheus指标收集器支持
• 容器内置健康检查：确保Thumbor服务正常运行

全功能（debian）版本额外提供：

• gifv优化器：将GIF转换为MP4或WebM视频，显著减小文件体积
• 面部检测支持
• SVG、AVIF和HEIF文件处理能力
• 延迟检测（Lazy Detection）功能
• 图像元数据支持
• 高效图像格式（AVIF、HEIF）支持

选择全功能版本前请确认是否需要这些额外功能，其容器体积约为轻量级版本的3倍。

当前维护的镜像标签

• beeyev/thumbor-s3:debian
• beeyev/thumbor-s3:slim-alpine
• beeyev/thumbor-s3:7-debian
• beeyev/thumbor-s3:7-slim-alpine
• beeyev/thumbor-s3:7.7-debian
• beeyev/thumbor-s3:7.7-slim-alpine

Docker Hub | Github packages | Red Hat quay.io

配置说明

所有配置通过环境变量实现，完整配置变量列表见配置文件。除配置文件中的变量外，还支持以下额外环境变量：

环境变量

• PORT：Thumbor实例运行端口，默认：8888
• LOG_LEVEL：日志级别，可选值：debug, info, warning, error, critical，默认：warning
• NUM_PROCESSES：Thumbor进程数，0（自动检测）、1（无分叉）或自定义数值，默认：0

安全配置

生产环境建议配置：

• ALLOW_UNSAFE_URL（默认False）：禁用“不安全”（非HMAC签名）URL，文档
• SECURITY_KEY（默认31337）：HMAC签名URL的共享密钥

更多信息见HMAC签名文档。

卷映射

/data:/data

健康检查

默认健康检查URL：[***]，用于监控服务运行状态。

使用方法

详见示例，包含完整入门指南。

问题反馈

bug报告和功能请求请提交至Github Issue Tracker。

Credits

Thumbor contributors

许可证

MIT许可证。详见许可证文件。