lfenergy/compas-scl-data-service

IEC 61850 SCL文件存储与检索镜像

镜像概述和主要用途

本Docker镜像专注于提供IEC 61850 SCL（Substation Configuration Language）文件的存储与检索功能。作为电力系统自动化领域的核心配置文件格式，SCL文件用于描述变电站的设备模型、通信参数及系统拓扑等关键信息。该镜像旨在为电力自动化应用提供便捷、可靠的SCL文件管理解决方案，简化配置数据的持久化与访问流程。

核心功能和特性

• SCL文件全生命周期管理：支持SCL文件的上传、下载、查询及删除操作，覆盖文件管理完整流程
• 标准化数据接口：提供RESTful API接口，便于与电力自动化系统、SCADA应用及配置工具集成
• 数据持久化存储：支持通过卷挂载实现文件持久化，确保容器重启或迁移时数据不丢失
• 轻量级架构：基于精简基础镜像构建，资源占用低，启动速度快，适合边缘计算环境部署
• 可配置访问控制：支持基础认证机制，通过环境变量配置访问令牌，保障数据访问安全

使用场景和适用范围

典型应用场景

• 变电站配置管理系统的后端存储服务
• 电力调度自动化系统的SCL文件版本控制
• 智能电网终端设备的配置参数分发中心
• 电力自动化设备测试环境的配置文件仓库

适用领域

• 电力系统自动化（变电站、换流站、配电网络）
• 新能源并网调度系统
• 微电网能量管理系统
• 电力设备研发与测试平台

使用方法和配置说明

基础部署（Docker Run）

bash
docker run -d \
  --name scl-store \
  -p 8080:8080 \
  -v /host/scl-data:/app/storage \
  -e AUTH_TOKEN=your_secure_token \
  [镜像名称]:[版本标签]

参数说明：

• -p 8080:8080：端口映射（容器内默认服务端口8080）
• -v /host/scl-data:/app/storage：挂载主机目录实现数据持久化
• -e AUTH_TOKEN：设置访问认证令牌（建议使用强密码）

Docker Compose配置

yaml
version: '3.8'
services:
  scl-store:
    image: [镜像名称]:[版本标签]
    container_name: scl-store
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - ./scl-data:/app/storage
    environment:
      - PORT=8080
      - STORAGE_PATH=/app/storage
      - AUTH_ENABLED=true
      - AUTH_TOKEN=your_secure_token
      - LOG_LEVEL=info
    networks:
      - power-automation-network

networks:
  power-automation-network:
    driver: bridge

环境变量配置项

API使用示例

1. 上传SCL文件

bash
curl -X POST http://localhost:8080/api/scl \
  -H "Authorization: Bearer your_secure_token" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@./substation_config.scl" \
  -F "metadata={\"substationId\":\"SUB-101\",\"version\":\"1.2\"}"

2. 检索SCL文件列表

bash
curl -X GET "http://localhost:8080/api/scl?substationId=SUB-101" \
  -H "Authorization: Bearer your_secure_token"

3. 下载指定SCL文件

bash
curl -X GET "http://localhost:8080/api/scl/substation_config.scl" \
  -H "Authorization: Bearer your_secure_token" \
  -o downloaded_config.scl

4. 删除SCL文件

bash
curl -X DELETE "http://localhost:8080/api/scl/substation_config.scl" \
  -H "Authorization: Bearer your_secure_token"

数据安全与维护

• 定期备份：建议通过crontab或备份工具定期备份挂载的主机目录
• 访问控制：生产环境中必须启用AUTH_TOKEN，并定期轮换令牌
• 日志监控：通过LOG_LEVEL=debug开启详细日志，配合ELK栈实现日志分析
• 版本管理：对于关键SCL文件，建议在文件名中包含版本信息（如substation_v1.2.scl）

扩展建议

• 对于大规模部署，可配合Nginx实现负载均衡
• 结合MinIO或S3兼容存储实现高可用文件存储
• 通过Prometheus metrics接口监控文件访问量与存储占用
• 集成Git版本控制实现SCL文件的历史版本追踪