revoltchat/january

镜像概述

本镜像是一个轻量级图片代理与嵌入生成工具，主要用于处理图片请求、生成可直接嵌入的图片链接及代码。通过该镜像，用户可对图片进行格式转换、尺寸调整、质量优化等操作，并快速生成适用于网站、应用的嵌入链接或代码，简化图片资源的管理与分发流程。

核心功能与特性

图片处理能力

• 格式转换：支持主流图片格式互转，包括 JPG、PNG、WebP、GIF 等
• 尺寸调整：可自定义图片宽高、按比例缩放、裁剪（支持居中、左上角等锚点）
• 质量优化：调整图片压缩质量（0-100%），平衡图片大小与清晰度

嵌入生成功能

• 嵌入链接生成：直接生成可嵌入的图片链接，支持带参数（如尺寸、格式）
• 嵌入代码生成：支持 HTML <img> 标签、Markdown 图片语法等嵌入代码输出
• 批量处理：支持多图片批量转换与嵌入代码生成

性能与兼容性

• 缓存机制：自动缓存处理后的图片，减少重复计算与资源消耗
• 跨平台兼容：支持主流浏览器及应用的图片加载协议（HTTP/HTTPS）
• 轻量化设计：基于高效图像处理库构建，启动快速，资源占用低

使用场景与适用范围

适用场景

• 网站图片资源管理：统一处理网站图片，优化加载速度与显示效果
• 应用图片加载优化：通过代理调整图片尺寸、格式，减少应用带宽消耗
• 图片内容分发：生成带参数的嵌入链接，实现图片资源的灵活分发
• 内容创作工具：为博客、文档生成标准化的图片嵌入代码，提升内容编辑效率

适用对象

• 网站开发者（个人博客、企业官网）
• 应用开发者（移动端、桌面端应用）
• 内容创作者（需要批量处理图片嵌入的作者）
• 图片资源管理者（优化图片存储与分发）

使用方法与配置说明

基本部署（Docker Run）

通过以下命令启动镜像，默认监听 8080 端口：

bash
docker run -d \
  --name image-proxy-embed \
  -p 8080:8080 \
  -e CACHE_TTL=3600 \  # 缓存有效期（秒），默认 3600
  -e MAX_SIZE=10485760 \  # 最大图片大小（字节），默认 10MB
  your-image-registry/image-proxy-embed:latest

环境变量配置

请求参数说明

通过 HTTP 请求调用图片处理与嵌入功能，基础请求格式为：
http://<服务地址>/proxy?url=<原图片URL>&<处理参数>

核心处理参数

使用示例

1. 转换图片格式并调整尺寸

将 https://example.com/image.png 转换为 WebP 格式，宽度 800px：

http://localhost:8080/proxy?url=https://example.com/image.png&format=webp&width=800

2. 生成 HTML 嵌入代码

将图片转换为 JPG 并生成 HTML <img> 标签：

http://localhost:8080/proxy?url=https://example.com/photo.jpg&format=jpg&quality=80&embed=true&embed_type=img

返回结果：
<img src="http://localhost:8080/proxy?url=https://example.com/photo.jpg&format=jpg&quality=80" alt="Embedded Image" width="auto">

3. 带缓存的批量处理

通过设置 CACHE_TTL=86400（24小时），批量处理图片时自动缓存结果，减少重复计算：

bash
docker run -d \
  --name image-proxy-embed \
  -p 8080:8080 \
  -e CACHE_TTL=86400 \
  docker.xuanyuan.run/your-image-registry/image-proxy-embed:latest

注意事项

• 原图片 URL 需支持 HTTP/HTTPS 访问，且目标服务器未限制跨域请求；
• 处理超大图片（超过 MAX_SIZE）时会返回 413 错误，需调整环境变量或压缩原图片；
• 缓存文件默认存储于容器内 /app/cache 目录，如需持久化可挂载本地目录：-v /local/cache:/app/cache。