camicroscope/iipimage

iipImage 镜像文档

镜像概述和主要用途

iipImage是一个容器化的IIP（Image Interaction Protocol）图像服务器，旨在提供便捷的图像服务。它允许用户通过HTTP访问并处理图像，特别支持DeepZoom参数来访问指定的幻灯片图像，适用于需要图像服务的各类应用场景。

核心功能和特性

• 容器化部署：通过Docker容器化，简化部署流程，确保环境一致性
• 图像服务支持：提供HTTP接口，支持通过DeepZoom参数访问图像
• 端口映射：默认通过80端口提供服务，可灵活映射到主机端口

使用场景和适用范围

• 医学图像查看系统，需要访问高分辨率幻灯片图像
• 数字图书馆，提供图像资源的在线访问
• 各类需要通过网络提供图像服务的应用场景

使用方法和配置说明

构建镜像

使用以下命令从Dockerfile构建镜像：

bash
docker build . -t iipsrv

运行容器

运行容器时，需确保包含幻灯片目录。建议通过卷挂载将本地幻灯片目录映射到容器内，例如：

bash
docker run -d -p 4010:80 -v /path/to/local/slides:/slides iipsrv

说明：/path/to/local/slides 是本地存放幻灯片的目录，/slides 是容器内的目录，可根据实际情况调整。

访问图像服务

通过以下URL格式访问图像：

http://localhost:4010/fcgi-bin/iipsrv.fcgi?DeepZoom=(path to slide)

其中，(path to slide) 是容器内幻灯片的路径。例如，若幻灯片文件 example.svs 位于容器内的 /slides 目录，则访问URL为：

http://localhost:4010/fcgi-bin/iipsrv.fcgi?DeepZoom=/slides/example.svs

docker-compose配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  iipsrv:
    build: .
    ports:
      - "4010:80"
    volumes:
      - /path/to/local/slides:/slides
    restart: always

使用以下命令启动服务：

bash
docker-compose up -d