imgproxy
一个快速安全的独立服务器，用于实时调整、处理和转换图片。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
图片处理代理服务器，又快又安全，Docker 一键部署。
核心功能
- 实时缩放、裁剪、旋转、加水印、应用滤镜
- 支持 JPEG / PNG / WebP / AVIF / JPEG XL 等多种格式
- 基于 libvips 超高速处理，内存占用极低
- URL 签名、类型检查、尺寸限制等安全防护
- 通过 Docker 数秒即可启动，配置极简
避坑指南
- •imgproxy 本身不处理 HTTPS，生产环境建议放在 Nginx、CDN 或负载均衡后面；处理大量并发时需合理配置内存和连接数，默认配置可能不够高并发场景；Pro 版许多高级功能（如视频预览、对象检测）需要付费订阅；签名密钥请妥善保管，泄露后他人可滥用你的处理服务器。
适用场景
- 电商网站的商品图片实时裁剪和优化
- 社交平台自动生成不同尺寸的头像和缩略图
- CMS 中动态调整图片质量与格式以适配客户端
- 替代 ImageMagick / GraphicsMagick 等命令行工具
详细介绍
imgproxy 是一款高性能图片处理服务器，可以实时对图片进行缩放、裁剪、旋转、添加滤镜和格式转换。它作为应用和图片源之间的代理，把图片处理工作全部交给这个专用服务完成。基于 libvips 库，处理速度极快且内存占用低。支持 JPEG、PNG、WebP、AVIF、JPEG XL 等多种输入输出格式。内置强大的安全机制，包括 URL 签名、图片类型验证、尺寸检查以及源限制，防止滥用。通过 Docker 几十秒就能启动运行，是替代 Web 应用中复杂图片处理代码的理想选择。项目还提供 Pro 版本，包含视频预览、目标检测和基于 SSIM 的自动质量等高级功能。
常见问题与排障 (1)
故障排除如何修复升级到最新版本后imgproxy Docker容器中的内存泄漏问题？
最新的imgproxy Docker镜像（包括sha256:77069360a...）存在内存泄漏，导致内存使用量激增至16GB以上。作为临时解决方案，请回退到版本3.30.1（例如镜像标签：imgproxy/imgproxy:3.30.1）。持续关注该问题以获取永久修复。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker
步骤2：运行 docker run -p 8080:8080 -it ghcr.io/imgproxy/imgproxy:latest
步骤3：访问 http://localhost:8080 即可开始处理图片
- 步骤1：确保已安装 Docker
- 步骤2：运行 docker run -p 8080:8080 -it ghcr.io/imgproxy/imgproxy:latest
- 步骤3：访问 http://localhost:8080 即可开始处理图片
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
如果通过 Docker 运行，只需停止容器并删除镜像即可：docker stop <容器名> && docker rm <容器名> && docker rmi ghcr.io/imgproxy/imgproxy:latest。如果从源码编译，删除编译目录及相关服务文件。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ