garrardkitchen/gif-creator-encoder

GIF Creator Encoder镜像说明

镜像概述

garrardkitchen/gif-creator-encoder是GIF Creator系统的核心编码服务镜像，基于FFmpeg实现高效GIF编码，支持标题帧渲染。该镜像作为独立微服务运行，负责处理视频转GIF的编码任务，可与系统中的API服务配合，支持AI辅助或手动模糊敏感信息后的视频转GIF功能。

核心功能

1. FFmpeg驱动的GIF编码：采用双pass调色板编码技术，确保GIF输出质量与效率。
2. 标题帧渲染：支持在GIF开头添加自定义标题帧。
3. 服务隔离：独立容器运行，不阻塞API服务，具备可扩展性。
4. 存储集成：通过卷挂载持久化存储帧文件与生成的GIF。

使用场景

• 部署完整GIF Creator系统时作为编码组件使用。
• 需要将视频转换为GIF且需处理敏感信息模糊的场景。
• 开发或测试GIF编码功能的本地环境搭建。

配置说明

环境变量

• ASPNETCORE_ENVIRONMENT：运行环境（建议生产环境使用Production）。
• Storage__BasePath：存储帧文件和GIF的基础路径（需与API服务共享卷）。

卷挂载

• /data/storage：用于存储帧文件和生成的GIF，建议通过Docker卷挂载以保证数据持久化。

Docker Compose部署示例

以下是与GIF Creator系统其他组件配合的完整配置片段：

yaml
services:
  encoder:
    image: garrardkitchen/gif-creator-encoder:latest
    container_name: gif-creator-encoder
    restart: unless-stopped
    volumes:
      - gif_data:/data
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - Storage__BasePath=/data/storage
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8002/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 20s

volumes:
  gif_data:
    driver: local

健康检查

镜像内置健康检查机制，通过访问http://localhost:8002/health验证服务可用性，确保编码服务正常运行。