apache/nifi-minifi

Apache NiFi MiNiFi (Java版) Docker镜像文档

1. 镜像概述

本镜像为Apache NiFi MiNiFi（Java版）的非官方便捷Docker化部署方案，基于Apache官方发布的MiNiFi Java版二进制包构建，旨在简化边缘计算场景下的部署流程。MiNiFi作为Apache NiFi的轻量级分支，专为边缘设备和资源受限环境设计，提供数据采集、处理、转换与传输能力，可无缝集成NiFi生态系统。

2. 核心功能与特性

2.1 轻量级架构

• 针对边缘计算优化，最小化CPU/内存资源占用（典型场景下内存占用<100MB），适配嵌入式设备、IoT网关等资源受限环境。
• 精简版NiFi数据流引擎，保留核心数据处理逻辑，去除非必要组件。

2.2 数据采集与处理能力

• 多源数据接入：支持文件系统、网络端口（TCP/UDP）、传感器数据、日志文件等多种数据源采集。
• 内置数据处理器：提供过滤、格式转换（JSON/CSV/AVRO等）、字段提取、加密/解密等基础数据处理功能。
• 流程编排：通过XML/JSON格式的流程定义文件（Flow Configuration）配置数据流转逻辑，支持可视化设计工具（如MiNiFi Toolkit）生成。

2.3 NiFi生态兼容性

• 共享NiFi数据模型（FlowFile），支持NiFi模板（Template）导入，实现边缘与中心数据平台（NiFi Cluster、NiFi Registry）的协同。
• 兼容NiFi Reporting Task，可将边缘节点状态、数据统计信息上报至中心监控系统。

2.4 安全与可靠性

• 支持SSL/TLS加密传输，可配置双向认证确保数据传输安全。
• 内置数据本地缓存机制，网络中断时临时存储数据，恢复后自动续传。

3. 使用场景与适用范围

3.1 典型应用场景

• 物联网边缘数据采集：工业传感器、智能家居设备、车载系统等边缘节点的实时数据采集与预处理。
• 资源受限环境部署：嵌入式Linux设备、ARM架构服务器等低配置硬件上的数据处理。
• 分布式边缘网络：构建多节点边缘数据采集网络，统一汇聚数据至云端或数据中心NiFi集群。
• 边缘数据预处理：在数据上传前过滤无效数据、压缩传输体积、标准化格式，降低中心节点处理压力。

3.2 适用环境

• 边缘计算节点（边缘服务器、IoT网关）
• 嵌入式系统（如Raspberry Pi、工业控制设备）
• 资源受限的云服务器或容器化环境（Kubernetes边缘节点）

4. 使用方法与配置说明

4.1 快速启动

通过以下命令启动默认配置的MiNiFi实例：

bash
docker run -d --name minifi -p 8080:8080 <镜像名称>

• -p 8080:8080：映射Web管理界面端口（默认8080），可通过http://localhost:8080访问。
• 首次启动将使用内置默认流程配置（空流程），可通过挂载自定义配置文件覆盖。

4.2 Docker Compose配置示例

创建docker-compose.yml文件实现持久化部署：

yaml
version: '3'
services:
  minifi:
    image: <镜像名称>
    container_name: minifi-edge
    ports:
      - "8080:8080"  # Web UI端口
      - "9999:9999"  # 数据接收端口（根据流程配置调整）
    volumes:
      - ./minifi-flow:/opt/minifi/minifi-current/conf  # 挂载自定义流程配置文件
      - ./minifi-data:/opt/minifi/minifi-current/data  # 持久化数据缓存目录
      - ./minifi-logs:/opt/minifi/minifi-current/logs  # 日志持久化
    environment:
      - MINIFI_LOG_LEVEL=INFO  # 日志级别：DEBUG/INFO/WARN/ERROR
      - MINIFI_JAVA_OPTS=-Xmx128m  # JVM内存限制（根据设备资源调整）
    restart: unless-stopped

启动命令：docker-compose up -d

4.3 核心配置说明

4.3.1 流程定义文件

MiNiFi的数据处理逻辑通过conf/flow.yml（或flow.xml.gz）定义，需通过挂载./minifi-flow目录提供自定义配置。可使用MiNiFi Toolkit生成流程文件。

4.3.2 配置文件路径

• 主配置文件：conf/minifi.properties（包含端口、SSL、集群等配置）
• 流程定义文件：conf/flow.yml（YAML格式，推荐）或conf/flow.xml.gz（XML压缩格式）
• 日志配置：conf/logback.xml

4.3.3 常用环境变量

5. 启动与维护

5.1 查看日志

bash
docker logs -f minifi  # 实时查看容器日志
# 或通过挂载的日志目录查看：tail -f ./minifi-logs/minifi-app.log

5.2 停止与重启

bash
docker stop minifi      # 停止容器
docker start minifi     # 启动容器
docker restart minifi   # 重启容器

5.3 版本更新

bash
# 拉取最新镜像
docker pull <镜像名称>:latest
# 停止并删除旧容器（保留挂载数据）
docker stop minifi && docker rm minifi
# 启动新容器
docker run -d --name minifi -p 8080:8080 -v ./minifi-flow:/opt/minifi/minifi-current/conf <镜像名称>:latest

6. 注意事项

• 本镜像为非官方构建，使用前请确认与目标MiNiFi版本（如1.20.0、2.0.0等）的兼容性。
• 边缘设备部署时，需根据硬件资源调整MINIFI_JAVA_OPTS（如ARM架构设备可能需要指定-XX:+UseSerialGC等轻量级GC策略）。
• 敏感配置（如SSL证书、认证密钥）建议通过加密卷或环境变量注入，避免明文存储。