linagora/linshare-thumbnail-server

LinShare Thumbnail Server Docker镜像文档

镜像概述

LinShare Thumbnail Server是LinShare文件共享平台的配套服务，专门用于生成各类文件的缩略图，以支持LinShare系统中的文件预览功能。该镜像基于Docker容器化技术构建，提供了便捷的部署方式，可无缝集成到LinShare生态环境中，帮助用户快速实现文件预览能力。

核心功能与特性

• 多格式支持：能够处理多种文件类型（如文档、图片、视频等）并生成缩略图
• 高效处理：优化的文件处理流程，快速生成高质量缩略图
• 无缝集成：与LinShare文件共享平台深度整合，支持平台内文件预览需求
• 容器化部署：基于Docker构建，简化安装、配置和升级过程
• 可配置性：支持自定义缩略图尺寸、质量等参数，适应不同场景需求

使用场景与适用范围

该镜像主要适用于已部署LinShare文件共享平台的环境，特别是需要为用户提供文件预览功能的场景，包括但不限于：

• 企业内部文件管理系统
• 团队协作平台
• 文档分享与预览系统
• 教育机构文件资源库

使用方法与配置说明

前提条件

• 已安装Docker引擎（1.13.0及以上版本）
• 已部署LinShare服务器，且与缩略图服务器网络互通

基本部署（docker run）

bash
docker run -d \
  --name linshare-thumbnail-server \
  -p 8080:8080 \
  -e LINSHARE_URL=http://linshare-server:8080 \
  linagora/linshare-thumbnail-server

环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  linshare-thumbnail-server:
    image: linagora/linshare-thumbnail-server
    container_name: linshare-thumbnail-server
    ports:
      - "8080:8080"
    environment:
      - LINSHARE_URL=http://linshare-server:8080
      - THUMBNAIL_SIZE=250x250
      - LOG_LEVEL=DEBUG
      - MAX_MEMORY=1g
    restart: unless-stopped
    networks:
      - linshare-network

networks:
  linshare-network:
    external: true

验证部署

服务启动后，可通过访问 http://<服务器IP>:8080/health 端点验证服务状态，返回状态码200表示服务正常运行。

注意事项

• 确保LinShare服务器与缩略图服务器之间网络通畅，防火墙规则允许相关端口通信
• 根据实际文件处理需求调整内存配置，处理大量或大型文件时建议增加内存资源
• 生产环境中建议配置日志持久化，以便问题排查
• 定期更新镜像以获取最新功能和安全补丁