kalisio/k-teleray

TELERAY 伽马剂量率数据下载服务 (基于Krawler)

镜像概述

本镜像是一个基于Krawler框架的专用服务，主要功能是从法国TELERAY伽马剂量率警报网络自动化下载伽马剂量率监测数据。TELERAY网络由法国辐射防护与核安全研究所（IRSN）等机构维护，是法国境内重要的环境辐射监测网络，提供实时和历史伽马剂量率数据。该镜像通过Krawler的任务调度与数据处理能力，简化了从TELERAY网络获取、处理和存储数据的流程，适用于需要持续获取辐射监测数据的场景。

核心功能与特性

核心功能

• TELERAY网络集成：专门针对TELERAY伽马剂量率数据接口设计，确保数据获取的兼容性和准确性。
• 自动化数据抓取：支持基于cron表达式的定时任务调度，实现无人值守的数据下载。
• 数据处理与格式化：可配置输出数据格式（如JSON、CSV），满足不同下游系统的数据需求。
• 灵活存储配置：支持自定义数据存储路径，方便与外部存储系统（如本地文件、数据库）集成。

关键特性

• 轻量级部署：基于Docker容器化，简化依赖管理和跨平台部署。
• 可配置化：通过环境变量灵活调整抓取频率、数据格式、日志级别等参数。
• Krawler框架支持：依托Krawler的数据抓取生态，具备任务重试、错误处理等健壮性机制。

使用场景与适用范围

适用场景

• 环境辐射监测：环境监测机构定期获取TELERAY网络数据，用于区域辐射水平监控。
• 科研分析：科研人员获取历史/实时数据，支持辐射环境变化趋势研究、模型验证等。
• 应急响应：在辐射事件中，快速获取事发区域剂量率数据，辅助应急决策。
• 工业辅助：核设施运营单位用于周边环境辐射水平的辅助监测与数据备份。

目标用户

• 环境监测机构及相关部门
• 辐射防护与核安全研究人员
• 应急响应团队
• 核设施运营与维护单位

使用方法与配置说明

前置要求

• Docker Engine 19.03+ 或 Docker Desktop
• 网络连接（需访问TELERAY网络数据接口）

Docker 运行命令示例

基本运行（默认配置）

bash
docker run -d \
  -v /local/path/to/data:/app/data \  # 挂载本地目录存储下载数据
  --name teleray-downloader \
  <镜像名称>  # 替换为实际镜像名称（如teleray-krawler-downloader:latest）

自定义配置运行

bash
docker run -d \
  -v /local/path/to/data:/app/data \
  -e CRON_SCHEDULE="*/30 * * * *" \  # 每30分钟抓取一次
  -e OUTPUT_FORMAT="csv" \  # 输出CSV格式数据
  -e LOG_LEVEL="debug" \  # 开启调试日志
  --name teleray-downloader \
  <镜像名称>

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  teleray-downloader:
    image: <镜像名称>  # 替换为实际镜像名称
    container_name: teleray-downloader
    volumes:
      - /local/path/to/data:/app/data  # 本地数据目录挂载
    environment:
      - CRON_SCHEDULE="0 * * * *"  # 每小时抓取一次（默认）
      - OUTPUT_DIR="/app/data"  # 容器内数据存储路径（默认）
      - OUTPUT_FORMAT="json"  # 数据格式（默认：json，支持csv）
      - TELERAY_API_URL="https://api.teleray.fr/v1/data"  # TELERAY数据接口（默认内置）
      - LOG_LEVEL="info"  # 日志级别（默认：info，支持debug/warn/error）
    restart: unless-stopped  # 容器退出时自动重启（可选）

启动服务：

bash
docker-compose up -d

配置参数说明

数据输出说明

下载的数据文件将存储在OUTPUT_DIR指定的路径下（默认/app/data），文件名通常包含时间戳（如20240520_1200_teleray_data.json），便于区分不同时间点的抓取结果。

注意事项

• 确保本地挂载目录有写入权限，避免容器因权限问题无法存储数据。
• TELERAY网络接口可能有访问限制，使用前需确认网络访问权限。
• 频繁抓取可能触发接口限流，建议根据实际需求合理配置CRON_SCHEDULE。