openintegrationhub/attachment-storage-service

附件存储服务 (Attachments Storage Service)

镜像概述

附件存储服务（Attachments Storage Service）是Open Integration Hub生态系统的核心组件，专为集成流程中的附件文件管理设计。该服务提供标准化接口，用于安全存储、检索和管理各类附件（如文档、图片、音频等），支持与Open Integration Hub其他服务无缝集成，确保集成流程中附件数据的可靠流转。

核心功能与特性

• 多存储后端支持：兼容本地文件系统、Amazon S3等多种存储后端，满足不同部署环境需求
• 安全访问控制：提供基于API的安全认证机制，确保附件访问的权限管理
• 元数据管理：支持附件元数据（如文件类型、大小、创建时间等）的存储与查询
• 高可用性：设计支持水平扩展，可根据附件存储需求动态调整服务能力
• 集成友好：提供标准化REST API，易于与Open Integration Hub其他服务及外部系统集成

使用场景

• 企业集成流程中各类业务文档（如合同、发票）的存储与交换
• 客户数据集成场景下的图片、音频等媒体文件管理
• 需要跨系统共享附件的工作流自动化场景
• 对附件存储有高可用性和可扩展性要求的集成平台

使用方法

基本部署（Docker Run）

bash
docker run -d \
  -p 3000:3000 \
  --name attachment-storage-service \
  -e STORAGE_BACKEND=local \
  -e STORAGE_PATH=/app/storage \
  -v /host/path/to/storage:/app/storage \
  openintegrationhub/attachment-storage-service

Docker Compose配置

yaml
version: '3.8'
services:
  attachment-storage:
    image: openintegrationhub/attachment-storage-service
    container_name: oih-attachment-storage
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - STORAGE_BACKEND=s3  # 可选：local 或 s3
      - STORAGE_PATH=/app/storage  # 仅local后端需要
      - AWS_ACCESS_KEY_ID=your_aws_access_key  # 仅s3后端需要
      - AWS_SECRET_ACCESS_KEY=your_aws_secret_key  # 仅s3后端需要
      - AWS_REGION=us-east-1  # 仅s3后端需要
      - S3_BUCKET_NAME=oih-attachments  # 仅s3后端需要
      - PORT=3000
    volumes:
      - attachment-storage-data:/app/storage  # 仅local后端需要
    restart: unless-stopped

volumes:
  attachment-storage-data:

环境变量配置说明

API使用示例

上传附件

bash
curl -X POST http://localhost:3000/attachments \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/local/path/to/file.pdf" \
  -F "metadata={\"name\":\"document.pdf\",\"type\":\"invoice\"}"

获取附件

bash
curl -X GET http://localhost:3000/attachments/{attachmentId}

项目地址

https://github.com/openintegrationhub/openintegrationhub/tree/master/services/attachment-storage-service