iiif_s3_docker 镜像文档

镜像概述

iiif_s3_docker 是一个用于处理图像文件并生成符合IIIF（国际图像互操作框架）0级标准切片及关联清单的Docker镜像，支持将处理结果自动上传至Amazon S3存储桶，以实现IIIF图像资源的托管与分发。

核心功能与特性

• IIIF 0级切片生成：将源图像转换为符合IIIF 0级规范的分层切片，支持基础缩放与区域访问
• 清单自动创建：生成关联的IIIF清单文件（manifest.json），包含图像元数据与切片索引信息
• S3集成上传：处理完成后自动将切片文件及清单上传至指定Amazon S3存储桶
• 批处理支持：支持批量处理多幅源图像，提升大规模图像资源的处理效率

使用场景与适用范围

• 数字文化遗产项目：为博物馆、档案馆的数字化藏品提供标准化IIIF图像服务
• 学术资源平台：为古籍、手稿等学术图像资源构建符合国际标准的访问接口
• 数字图书馆：简化IIIF图像资源的制备流程，支持在线图像浏览与学术研究

使用方法与配置说明

前置要求

• 运行环境需安装Docker引擎
• 拥有Amazon S3存储桶及具备读写权限的AWS访问密钥
• 源图像文件（支持TIFF、JPEG等常见格式）

环境变量配置

运行容器时需通过环境变量指定以下必要参数：

快速启动示例

基本运行命令

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="AKIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secret" \
  -e AWS_REGION="us-east-1" \
  -e S3_BUCKET="my-iiif-bucket" \
  -e IIIF_BASE_URL="[***]" \
  -e SRC_DIR="/app/src" \
  -v /local/path/to/images:/app/src \
  vt-digital-libraries-platform/iiif_s3_docker

参数说明

• -v /local/path/to/images:/app/src: 将本地源图像目录挂载至容器内的SRC_DIR路径
• 环境变量IIIF_BASE_URL需与S3存储桶的访问域名一致，用于生成可访问的清单URL

处理流程

1. 图像输入：容器从挂载的SRC_DIR目录读取源图像文件
2. 切片生成：自动将图像处理为IIIF 0级标准切片（按固定尺寸分割）
3. 清单创建：生成包含图像元数据、切片层级信息的manifest.json文件
4. S3上传：将切片文件及清单按规范路径结构上传至指定S3存储桶
5. 访问验证：上传完成后可通过${IIIF_BASE_URL}/${图像ID}/manifest.json访问IIIF清单

适用场景扩展

• 数字图书馆项目：用于古籍数字化资源的标准化处理，支持读者通过IIIF兼容客户端进行高分辨率图像浏览
• 文化遗产展示：为博物馆藏品图像提供统一访问接口，便于跨平台共享与学术研究
• 教育资源建设：为教学用图像资源构建结构化访问框架，支持动态区域选择与比较研究