thumbor
智能按需图片裁剪、缩放与优化服务，由 AI 驱动。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
可自托管的智能图片处理服务器，改个 URL 就能自动裁剪、缩放。
核心功能
- 支持所有常见图片格式的即时裁剪、缩放、旋转和滤镜
- AI 智能检测人脸、特征点，自动定位裁剪焦点
- 内置高速缓存，支持本地磁盘、AWS S3、Ceph 等多种存储
- 高度可扩展，可通过插件自定义加载器、存储引擎和滤镜
- 与主流语言和框架（Python、Node.js、Ruby 等）轻松集成
避坑指南
- •生产环境建议配置安全密钥（SECURITY_KEY），否则任何人都可调用 unsafe 模式；默认图片缓存占用本地磁盘，需定期清理或配置外部存储；AI 检测依赖 OpenCV，首次加载模型可能需要额外内存。
适用场景
- 电商产品图按比例自动裁剪，适配不同展示位
- 社交媒体缩略图动态生成，减少重复制作
- 新闻网站统一处理图片，保留重要部分并优化加载速度
thumbor 是一款开源图片处理服务，作为 HTTP 服务器运行，可按需裁剪、缩放、旋转、添加滤镜并优化图片。它支持所有常见图片格式，利用 AI 进行智能检测（人脸、特征点、兴趣区域），自动完成精准裁剪，避免“断头”等尴尬效果。内置高速缓存，支持本地、AWS S3、Ceph 等多种存储后端，并且插件系统使其极易扩展。全球数百家公司（如维基百科、福布斯、Vox Media）都在使用。只需修改 URL 参数即可生成不同尺寸的图片，大幅节省带宽并提升网站性能。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
使用 Docker 一步启动：docker run -p 8888:8888 ghcr.io/thumbor/thumbor:latest
浏览器打开 http://localhost:8888/unsafe/你的图片URL 即可查看效果
若要自定义配置，可将本地配置目录挂载到容器 /etc/thumbor.conf
- 使用 Docker 一步启动：docker run -p 8888:8888 ghcr.io/thumbor/thumbor:latest
- 浏览器打开 http://localhost:8888/unsafe/你的图片URL 即可查看效果
- 若要自定义配置，可将本地配置目录挂载到容器 /etc/thumbor.conf
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
如果使用 Docker 启动，直接停止并删除容器即可；若通过 pip 安装，执行 pip uninstall thumbor。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
3 FAQs