kira-imgproxy 是基于 imgproxy 的图片处理服务，提供动态图片缩放、格式转换、模糊等功能。
部署信息
| 配置 | 值 |
|---|
| 平台 | Fly.io |
| 域名 | img.kira.art |
| 区域 | sjc (San Jose) |
| 内存 | 8GB |
| CPU | 4 vCPU (shared) |
| 端口 | 8080 |
URL 签名
imgproxy 使用 HMAC-SHA256 签名保护 URL，防止滥用。
签名算法
import crypto from "crypto";
function signImgproxyPath(path: string): string {
const key = Buffer.from(IMGPROXY_KEY, "hex");
const salt = Buffer.from(IMGPROXY_SALT, "hex");
const hmac = crypto.createHmac("sha256", key);
hmac.update(salt);
hmac.update(path);
return hmac.digest("base64url");
}
URL 格式
https://img.kira.art/{signature}/{processing}/{source}@{format}
https://img.kira.art/CQTBc5cY.../rs:fit:400:0/plain/https%3A%2F%2F...@webp
处理参数
缩放 (resize)
rs:{type}:{width}:{height}
| 参数 | 说明 |
|---|
rs:fit:400:0 | 宽度 400px，高度自适应 |
rs:fill:200:200 | 填充到 200x200 |
rs:auto:800:600 | 自动选择最佳方式 |
模糊 (blur)
示例：bl:5 - 高斯模糊，sigma=5
质量 (quality)
示例：q:80 - 压缩质量 80%
环境变量
性能配置
IMGPROXY_WORKERS = "8" # 工作线程数 (CPU × 2)
IMGPROXY_TIMEOUT = "60" # 处理超时 60 秒
IMGPROXY_DOWNLOAD_TIMEOUT = "30" # 下载超时 30 秒
IMGPROXY_TTL = "2592000" # Cache-Control max-age (30 天)
安全限制
IMGPROXY_ALLOWED_SOURCES = "https://wibrssifrdftzivotinz-all.supabase.co/,https://base.kira.art/"
IMGPROXY_MAX_SRC_RESOLUTION = "50" # 最大 50MP
IMGPROXY_MAX_SRC_FILE_SIZE = "52428800" # 最大 50MB
IMGPROXY_MAX_ANIMATION_FRAMES = "100" # 最大动画帧数
图片质量
IMGPROXY_QUALITY = "80"
IMGPROXY_FORMAT_QUALITY = "avif=65,webp=75,jpeg=80"
IMGPROXY_STRIP_METADATA = "true" # 移除 EXIF 等元数据
IMGPROXY_AUTO_ROTATE = "true" # 自动修正方向
格式检测
IMGPROXY_ENABLE_WEBP_DETECTION = "true"
IMGPROXY_ENABLE_AVIF_DETECTION = "true"
IMGPROXY_PREFERRED_FORMATS = "avif,webp,jpeg"
密钥配置
签名密钥存储在 Fly.io secrets 中：
fly secrets set IMGPROXY_KEY=<hex-key> IMGPROXY_SALT=<hex-salt>
密钥必须是 hex 编码的字符串，至少 32 字节。
缓存策略
响应头
imgproxy 返回的 Cache-Control 头：
Cache-Control: public, max-age=2592000
Cloudflare CDN
在 Cloudflare Dashboard 为 img.kira.art 配置 Cache Rules：
- Cache eligibility: Eligible for cache
- Edge TTL: Use origin Cache-Control header
- Browser TTL: Use origin Cache-Control header
本地运行
cd kira-imgproxy
# 使用 Docker
docker run -p 8080:8080 \
-e IMGPROXY_KEY=your_key \
-e IMGPROXY_SALT=your_salt \
ghcr.io/imgproxy/imgproxy:latest
文件结构
kira-imgproxy/
├── .github/
│ └── workflows/ # CI/CD
├── Dockerfile # 基于 imgproxy 官方镜像
└── fly.toml # Fly.io 配置
