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性能

速度基准

可参考基准测试报告，其中包含与其他知名图像处理方案的性能对比。

安全性

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

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

使用场景和适用范围

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

使用方法和配置说明

基本使用

详细使用文档请参考***📑 文档。

Docker部署示例

基础运行命令

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

关键配置参数

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

• IMGPROXY_MAX_DIMENSIONS：设置最大允许图像尺寸（默认：***x***）
• 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 "DarthSim" Alexandrovich

特别感谢

• Roman Shamin：logo设计
• Alena Kirdina 与 Alexander Madyankin：网站开发
• John Cupitt：开发libvips库并协助优化其在imgproxy中的使用
• Kirill Kuznetsov：Helm Chart维护
• Travis Turner：文档维护

许可证

imgproxy基于MIT许可证开源，详见LICENSE。

安全联系

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

***资源

• 网站
• GitHub
• 博客
• 文档
• imgproxy Pro

• ---

• ---