darthsim/imgproxy

imgproxy Docker镜像文档

[!WARNING] 官方imgproxy Docker仓库已迁移至ghcr.io/imgproxy/imgproxy。Docker Hub上的仓库将保持可用，但最终可能停止更新镜像。

镜像概述和主要用途

imgproxy是一款快速且安全的独立服务器，用于调整和转换远程图像。其设计遵循安全、速度和简洁三大核心原则，可作为Web应用中图像调整代码（如调整库、调用ImageMagick或GraphicsMagic的代码）的高效替代品，尤其适用于需要处理大量图像调整的场景。

核心功能和特性

简洁性

秉持"无代码优于少代码"理念，仅包含图像处理、优化和安全所需的核心功能：

• 旋转、翻转等视觉效果建议通过CSS3实现，而非内置功能
• HTTP缓存推荐使用CDN或缓存代理服务器，而非内置实现
• HTTPS支持建议通过nginx等反向代理服务器实现

速度

• 高效图像处理：基于libvips库，该库以处理速度快、内存占用低著称，可实时处理大量图像
• 优化HTTP支持：使用Go原生net/http包（无包装器），减少请求处理 overhead，提供最佳HTTP性能

速度基准

可参考https://github.com/imgproxy/imgproxy/blob/master/BENCHMARK.md%EF%BC%8C%E5%85%B6%E4%B8%AD%E5%8C%85%E5%90%AB%E4%B8%8E%E5%85%B6%E4%BB%96%E7%9F%A5%E5%90%8D%E5%9B%BE%E5%83%8F%E5%A4%84%E7%90%86%E6%96%B9%E6%A1%88%E7%9A%84%E6%80%A7%E8%83%BD%E5%AF%B9%E6%AF%94%E3%80%82

安全性

针对远程图像处理的潜在安全风险，提供多重防护措施：

• 图像验证：下载时检查图像类型和真实尺寸，未知格式或超出最大允许尺寸的图像将被中断下载，有效防御"图像炸弹"***
• URL签名保护：通过签名验证图像URL，防止者通过请求大量图像调整发起DoS
• HTTP头授权：支持通过HTTP头进行授权，防止直接被***者使用，同时允许通过CDN或缓存服务器添加授权头后使用

使用场景和适用范围

• 替代Web应用中的图像调整代码，提升性能
• 处理来自远程源的图像并实时调整尺寸
• 需要高效处理大量并发图像调整请求的场景
• 对图像处理安全性有较高要求的业务场景

使用方法和配置说明

基本使用

详细使用文档请参考官方📑 文档。

Docker部署示例

基础运行命令

bash
docker run -p 8080:8080 ghcr.io/imgproxy/imgproxy

关键配置参数

imgproxy通过环境变量进行配置，常用参数包括：

• IMGPROXY_MAX_DIMENSIONS：设置最大允许图像尺寸（默认：16384x16384）
• IMGPROXY_SIGNATURE_KEY：设置用于URL签名验证的密钥（强烈建议生产环境配置）
• IMGPROXY_ALLOWED_SOURCES：限制允许的图像源（默认允许所有源）

带基本安全配置的运行示例

bash
docker run -d \
  -p 8080:8080 \
  -e IMGPROXY_SIGNATURE_KEY="your-secure-signature-key" \
  -e IMGPROXY_MAX_DIMENSIONS="4096x4096" \
  ghcr.io/imgproxy/imgproxy

相关信息

作者

Sergey "https://github.com/DarthSim" Alexandrovich

特别感谢

• https://github.com/romashamin%EF%BC%9Alogo%E8%AE%BE%E8%AE%A1
• https://github.com/egodyston 与 https://github.com/madyankin%EF%BC%9A%E7%BD%91%E7%AB%99%E5%BC%80%E5%8F%91
• https://github.com/jcupitt%EF%BC%9A%E5%BC%80%E5%8F%91%60libvips%60%E5%BA%93%E5%B9%B6%E5%8D%8F%E5%8A%A9%E4%BC%98%E5%8C%96%E5%85%B6%E5%9C%A8imgproxy%E4%B8%AD%E7%9A%84%E4%BD%BF%E7%94%A8
• https://github.com/dragonsmith%EF%BC%9AHelm Chart维护
• https://github.com/Travis-Turner%EF%BC%9A%E6%96%87%E6%A1%A3%E7%BB%B4%E6%8A%A4

许可证

imgproxy基于MIT许可证开源，详见https://github.com/imgproxy/imgproxy/blob/master/LICENSE%E3%80%82

安全联系

如发现安全漏洞，请联系：***。我们将协调修复和披露事宜。

官方资源

• 网站
• https://github.com/imgproxy
• 博客
• 文档
• imgproxy Pro

• ---

• ---