yalelibraryit/dc-iiif-cantaloupe

Cantaloupe IIIF图像服务器（S3 TIFF读取版）

镜像概述

本镜像为Cantaloupe IIIF（国际图像互操作框架）图像服务器的定制版本，专门用于从AWS S3桶读取TIFF格式图像，并通过IIIF协议提供标准化的图像访问服务。服务器可自动生成图像衍生品（如缩略图、不同分辨率版本等），并将这些衍生品缓存至指定的AWS S3缓存桶，以优化重复访问性能。

核心功能与特性

• IIIF标准支持：遵循IIIF Image API规范，提供图像缩放、旋转、裁剪、格式转换等标准化操作接口。
• S3图像读取：直接从AWS S3源桶加载TIFF格式图像，无需本地存储原始文件。
• S3缓存机制：生成的图像衍生品自动缓存至指定S3缓存桶，减少重复处理开销。
• HTTP/2支持：默认启用HTTP/2协议，提升图像资源传输效率和并发性能。
• 日志控制：应用日志级别固定为warn，平衡日志信息量与系统性能。

使用场景与适用范围

适用于需要通过IIIF协议提供TIFF图像资源在线访问的场景，包括：

• 图书馆、档案馆、博物馆等文化机构，用于提供珍贵TIFF图像的标准化在线服务。
• 远程TIFF图像资源集中管理与分发，需通过统一接口对外提供服务的项目。
• 对图像访问性能有要求，需通过缓存优化大规模图像请求的应用。

使用方法与配置说明

环境变量配置

使用本镜像前，必须配置以下环境变量以确保服务正常运行：

Docker运行示例

通过以下命令启动容器，替换占位符为实际配置值：

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your-aws-access-key-id" \
  -e AWS_SECRET_KEY="your-aws-secret-key" \
  -e S3_SOURCE_BUCKET_NAME="your-source-bucket" \
  -e S3CACHE_BUCKET_NAME="your-cache-bucket" \
  -e BASE_URI="https://your-service-base-uri" \
  -e LOG_APPLICATION_LEVEL="warn" \
  -e HTTP_HTTP2_ENABLED="true" \
  --name cantaloupe-iiif-server \
  [镜像名称或ID]

注：[镜像名称或ID]需替换为实际使用的Docker镜像名称或ID。

服务验证

服务启动后，可通过以下方式验证：

1. 访问IIIF图像信息接口：{BASE_URI}/iiif/2/{image-id}/info.json（{image-id}为S3源桶中TIFF图像的键名）。
2. 访问图像衍生品：{BASE_URI}/iiif/2/{image-id}/full/800,/0/default.jpg（获取800像素宽度的JPG格式衍生品）。