Golang基于libvips实现高性能图像处理服务器插件库imagor的使用

imagor是一个快速、安全的图像处理服务器和Go库，它使用高效的图像处理库libvips（通过Go绑定vipsgen实现），通常比使用最快的ImageMagick设置快4-8倍。

快速开始

使用Docker快速启动imagor服务器：

docker run -p 8000:8000 shumc/imagor -imagor-unsafe -imagor-auto-webp

原始测试图片：

尝试以下图像URL示例：

http://localhost:8000/unsafe/fit-in/200x200/filters:fill(white)/https://raw.githubusercontent.com/cshum/imagor/master/testdata/gopher.png
http://localhost:8000/unsafe/200x200/smart/filters:fill(white):format(jpeg):quality(80)/https://raw.githubusercontent.com/cshum/imagor/master/testdata/gopher.png
http://localhost:8000/unsafe/fit-in/-180x180/10x10/filters:hue(290):saturation(100):fill(yellow)/raw.githubusercontent.com/cshum/imagor/master/testdata/gopher.png
http://localhost:8000/unsafe/30x40:100x150/filters:fill(cyan)/raw.githubusercontent.com/cshum/imagor/master/testdata/dancing-banana.gif
http://localhost:8000/unsafe/fit-in/200x150/filters:fill(yellow):watermark(raw.githubusercontent.com/cshum/imagor/master/testdata/gopher-front.png,repeat,bottom,0,40,40)/raw.githubusercontent.com/cshum/imagor/master/testdata/dancing-banana.gif

图像端点

imagor端点是一系列定义图像操作的URL部分，后跟图像URI：

/HASH|unsafe/trim/AxB:CxD/fit-in/stretch/-Ex-F/GxH:IxJ/HALIGN/VALIGN/smart/filters:NAME(ARGS):NAME(ARGS):.../IMAGE

过滤器

过滤器/filters:NAME(ARGS):NAME(ARGS):.../是一系列将顺序应用于图像的图像操作管道。

imagor支持以下过滤器：

• background_color(color) - 设置透明图像的背景颜色
• blur(sigma) - 应用高斯模糊
• brightness(amount) - 调整图像亮度
• contrast(amount) - 调整图像对比度
• fill(color) - 填充缺失区域或透明图像
• format(format) - 指定输出格式
• grayscale() - 转换为灰度
• hue(angle) - 调整色调
• quality(amount) - 调整图像质量
• rotate(angle) - 旋转图像
• saturation(amount) - 调整饱和度
• watermark(image,x,y,alpha) - 添加水印

Go库示例

imagor也是一个Go库，以下是使用示例：

package main

import (
	"log"
	"net/http"

	"github.com/cshum/vipsgen/vips"
)

func main() {
	// 从HTTP获取图像
	resp, err := http.Get("https://raw.githubusercontent.com/cshum/imagor/master/testdata/gopher.png")
	if err != nil {
		log.Fatalf("Failed to fetch image: %v", err)
	}
	defer resp.Body.Close()

	// 从io.ReadCloser创建源
	source := vips.NewSource(resp.Body)
	defer source.Close() // 在图像生命周期内源需要保持可用

	// 通过从缩略图源创建图像实现加载时缩小
	image, err := vips.NewThumbnailSource(source, 800, &vips.ThumbnailSourceOptions{
		Height: 1000,
		FailOn: vips.FailOnError, // 在第一个错误时失败
	})
	if err != nil {
		log.Fatalf("Failed to load image: %v", err)
	}
	defer image.Close() // 始终关闭图像以释放内存

	// 使用vips_embed添加黄色边框
	border := 10
	if err := image.Embed(
		border, border,
		image.Width()+border*2,
		image.Height()+border*2,
		&vips.EmbedOptions{
			Extend:     vips.ExtendBackground,       // 使用背景属性颜色扩展
			Background: []float64{255, 255, 0, 255}, // 黄色边框
		},
	); err != nil {
		log.Fatalf("Failed to add border: %v", err)
	}

	log.Printf("Processed image: %dx%d\n", image.Width(), image.Height())

	// 将结果保存为WebP文件
	err = image.Webpsave("resized-gopher.webp", &vips.WebpsaveOptions{
		Q:              85,   // 质量因子(0-100)
		Effort:         4,    // 压缩努力(0-6)
		SmartSubsample: true, // 更好的色度子采样
	})
	if err != nil {
		log.Fatalf("Failed to save image as WebP: %v", err)
	}
	log.Println("Successfully saved processed images")
}

配置

imagor支持命令行参数和环境变量配置。例如：

# 两者等效
imagor -debug -imagor-secret 1234

DEBUG=1 IMAGOR_SECRET=1234 imagor

也可以使用.env文件：

imagor -config path/to/config.env

config.env内容示例：

PORT=8000
IMAGOR_SECRET=mysecret
DEBUG=1

imagor是一个功能强大的图像处理解决方案，无论是作为独立服务器还是Go库集成到现有应用中，都能提供高性能的图像处理能力。