yalelibraryit/dc-iiif-cantaloupe

Cantaloupe IIIF图像服务器，用于从AWS S3桶读取TIFF图像并提供IIIF服务，支持生成图像衍生品并缓存至S3桶，启用HTTP/2以提升传输效率。

1 收藏0 次下载activeyalelibraryit镜像

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图像资源集中管理与分发，需通过统一接口对外提供服务的项目。
对图像访问性能有要求，需通过缓存优化大规模图像请求的应用。

使用方法与配置说明

环境变量配置

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

环境变量名	描述	必填	取值要求
`AWS_ACCESS_KEY_ID`	AWS访问密钥ID，用于认证访问S3源桶和缓存桶	是	AWS IAM用户访问密钥ID
`AWS_SECRET_KEY`	AWS密钥，与`AWS_ACCESS_KEY_ID`配对用于S3桶认证	是	AWS IAM用户密钥
`S3_SOURCE_BUCKET_NAME`	存储原始TIFF图像的AWS S3源桶名称	是	有效的AWS S3桶名称
`S3CACHE_BUCKET_NAME`	用于缓存图像衍生品的AWS S3缓存桶名称	是	有效的AWS S3桶名称
`BASE_URI`	服务基础URL，用于生成IIIF `info.json`文件中的资源链接	是	需包含协议（如`https://`），例：`[***]`
`LOG_APPLICATION_LEVEL`	应用日志级别	是	固定设为`warn`
`HTTP_HTTP2_ENABLED`	是否启用HTTP/2协议	是	固定设为`true`

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="[***]" \
  -e LOG_APPLICATION_LEVEL="warn" \
  -e HTTP_HTTP2_ENABLED="true" \
  --name cantaloupe-iiif-server \
  [镜像名称或ID]

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

服务验证

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

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

查看更多 dc-iiif-cantaloupe 相关镜像 →