aptive/img

IMG

一个图像缩放和处理服务器。

快速开始

sh
docker compose up -d --build

注意：您也可以选择直接使用go进行开发，但Docker容器包含了构建和运行应用程序所需的所有依赖，确保所有功能可用。如果系统上缺少依赖包，部分功能可能会被禁用。

绑定到本地主机

若要通过localhost访问容器端口，需要覆盖默认的compose.yml端口值，并指定首选的主机端口。如需使用默认值或快速生成配置文件，只需执行：

sh
cp compose.override.example.yml compose.override.yml

[!NOTE] compose.override.yml的任何更改都会被git忽略，因此您可以放心使用它进行环境特定的更改或覆盖，而不会影响其他人的本地设置。

然后使用新的端口绑定（重新）启动容器：

sh
docker compose up -d

支持的格式

当前端点支持以下图像格式：

• image/jpeg，关键词为jpg或jpeg
• image/png，关键词为png
• image/gif，关键词为gif
• image/tiff，关键词为tiff
• image/bmp，关键词为bmp

同时补充支持以下格式：

• image/heif，关键词为heif或heic。默认转换为image/jpeg格式。

接口端点

/display

显示图像，适用于需要对图像执行操作的场景。

参数

• url - 远程图像URL，用于处理
• quality - 图像渲染质量，默认最高。
  注：仅适用于jpeg格式。
• grayscale - 是否以灰度模式渲染图像，默认false。

/stats

提供图像信息，如文件名、尺寸、大小和格式。

/qrcode

根据提供的content生成***。

参数

• content - ***中编码的内容
• color - ***前景色（十六进制格式）
• bgColor - ***背景色（十六进制格式，默认透明）
• qrWidth - ***块宽度（最大255）
• borderWidth - 边框宽度（默认自动计算）

/upload

未实现

显示操作

可通过提供各种查询参数对图像执行显示操作。目前仅在/display端点支持这些操作。

convert

• format - 输出图像格式，默认与源格式相同，详见支持的格式。

resize

调整图像至指定的width和height。

若width或height未设置或为0，将保持图像宽高比。

参数

• width - 目标图像宽度
• height - 目标图像高度

rotate

将图像旋转至指定的degrees角度。

参数

• degrees - 目标旋转角度（示例：12.7）

flip

垂直（上下）、水平（左右）或同时翻转图像。

参数

• direction - 翻转方向：
  • h、horizontal（水平）
  • v、vertical（垂直）
  • b、both（同时）

待办事项

• 添加对image/webp的支持
• 添加对image/svg+xml的支持
• 使用zap.Logger记录请求中的错误
• 清理HTTP错误和响应，利用render包
• DataDog APM & 指标
• 通过libx265修复libheif-dev的Cfunc_GoBytes内存泄漏问题