darthsim/imgproxy-ci

imgproxy Docker镜像文档

镜像概述和主要用途

imgproxy是一个快速且安全的独立服务器，用于调整和转换远程图像。其核心设计原则是安全、速度和简洁。它能够快速轻松地动态调整图像大小，能处理大量图像调整任务，是应用内图像调整代码（如图像库或调用ImageMagick/GraphicsMagic的代码）的安全、快速替代品，也是处理远程来源图像的必备工具。使用imgproxy，无需在设计变更时重复准备适配图像。

核心功能和特性

简洁性

imgproxy仅包含图像处理、优化和安全所需的必备功能：

• 旋转、翻转和应用蒙版等操作通常可通过CSS3实现，无需内置
• HTTP缓存更适合通过CDN或缓存代理服务器实现
• HTTPS支持可通过nginx等代理服务器轻松解决

速度

• 基于高效图像处理库libvips，速度极快且内存占用低，能即时处理大量图像
• 使用Go原生net/http包（无包装器），减少请求处理 overhead，提供最佳HTTP支持
• 基准测试结果可参考https://github.com/imgproxy/imgproxy/blob/master/BENCHMARK.md

安全性

针对远程图像处理的潜在安全风险，imgproxy采取多种防护措施：

• 下载时检查图像类型和实际尺寸，未知格式或超尺寸（可设置最大允许尺寸）的图像将不会完全下载，防止"图像炸弹"***
• 通过签名保护图像URL，防止者通过请求大量图像调整实施DoS
• 支持HTTP头授权，防止直接被***者使用，同时允许通过CDN或缓存服务器添加头信息使用

使用场景和适用范围

• 替代应用内图像处理代码，减少应用复杂度
• 处理来自远程来源的图像，无需本地存储
• 动态调整图像尺寸以适应不同设计需求，避免重复准备图像
• 大规模图像处理场景，需要高效、安全的图像调整服务

使用方法和配置说明

基本使用

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

Docker部署示例

Docker Run命令

bash
docker run -p 8080:8080 darthsim/imgproxy

配置环境变量

可通过环境变量配置imgproxy，例如设置最大图像尺寸：

bash
docker run -p 8080:8080 \
  -e IMGPROXY_MAX_SRC_DIMENSIONS=4096 \
  darthsim/imgproxy

docker-compose配置

yaml
version: '3'
services:
  imgproxy:
    image: darthsim/imgproxy
    ports:
      - "8080:8080"
    environment:
      - IMGPROXY_MAX_SRC_DIMENSIONS=4096
      - IMGPROXY_SIGNATURE_KEY=your_secure_signature_key
    restart: always

许可证

imgproxy采用MIT许可证，详见https://github.com/imgproxy/imgproxy/blob/master/LICENSE%E3%80%82

安全联系

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