fiware/draco

Apache NiFi Docker镜像文档

镜像概述和主要用途

Apache NiFi Docker镜像用于简化NiFi的部署与运行，支持独立模式下的多种安全认证方式，适用于数据处理、流程自动化及数据流转场景，可快速搭建开发测试环境或企业级数据管理系统。

核心功能和特性

• 多认证模式：支持无安全认证、双向SSL客户端证书认证和LDAP认证
• 灵活配置：通过环境变量自定义端口、主机名及认证参数
• 版本控制：可通过构建参数指定NiFi版本（1.4.0+兼容）
• 集群支持：提供ZooKeeper集成配置，支持集群部署

使用场景和适用范围

• 开发测试环境的快速部署
• 需要安全认证的数据处理流程
• 与LDAP集成的企业级权限管理
• 独立运行的数据流转和自动化任务

详细使用方法和配置说明

构建镜像

使用以下命令构建默认版本镜像：

bash
docker build -t apache/nifi:latest .

构建完成后，镜像将标记为apache/nifi:latest。

如需构建特定版本，通过NIFI_VERSION参数指定：

bash
docker build --build-arg=NIFI_VERSION={所需NiFi版本} -t apache/nifi:latest .

注意：配置脚本适用于NiFi 1.4.0+版本，旧版本可能因属性变化无法正常工作。

运行容器

独立实例（无安全认证）

最小化启动命令：

bash
docker run --name nifi \
  -p 8080:8080 \
  -d \
  apache/nifi:latest

访问UI：http://localhost:8080/nifi

自定义端口示例：

bash
docker run --name nifi \
  -p 9090:9090 \
  -d \
  -e NIFI_WEB_HTTP_PORT='9090' \
  apache/nifi:latest

独立实例（双向SSL认证）

需提供证书文件并配置相关参数，设置AUTH=tls：

bash
docker run --name nifi \
  -v /本地证书路径:/opt/certs \
  -p 8443:8443 \
  -e AUTH=tls \
  -e KEYSTORE_PATH=/opt/certs/keystore.jks \
  -e KEYSTORE_TYPE=JKS \
  -e KEYSTORE_PASSWORD={密钥库密码} \
  -e TRUSTSTORE_PATH=/opt/certs/truststore.jks \
  -e TRUSTSTORE_PASSWORD={信任库密码} \
  -e TRUSTSTORE_TYPE=JKS \
  -e INITIAL_ADMIN_IDENTITY='CN=管理员, O=组织, OU=部门, C=国家' \
  -d \
  apache/nifi:latest

独立实例（LDAP认证）

设置AUTH=ldap并配置LDAP参数，基础配置示例：

bash
docker run --name nifi \
  -v /本地证书路径:/opt/certs \
  -p 8443:8443 \
  -e AUTH=ldap \
  -e KEYSTORE_PATH=/opt/certs/keystore.jks \
  -e KEYSTORE_TYPE=JKS \
  -e KEYSTORE_PASSWORD={密钥库密码} \
  -e TRUSTSTORE_PATH=/opt/certs/truststore.jks \
  -e TRUSTSTORE_PASSWORD={信任库密码} \
  -e TRUSTSTORE_TYPE=JKS \
  -e INITIAL_ADMIN_IDENTITY='cn=admin,dc=example,dc=org' \
  -e LDAP_AUTHENTICATION_STRATEGY='SIMPLE' \
  -e LDAP_MANAGER_DN='cn=admin,dc=example,dc=org' \
  -e LDAP_MANAGER_PASSWORD='password' \
  -e LDAP_USER_SEARCH_BASE='dc=example,dc=org' \
  -e LDAP_USER_SEARCH_FILTER='cn={0}' \
  -e LDAP_IDENTITY_STRATEGY='USE_DN' \
  -e LDAP_URL='ldap://ldap:389' \
  -d \
  apache/nifi:latest

安全LDAP（START_TLS/LDAPS）可选环境变量：

bash
-e LDAP_TLS_KEYSTORE: '' \
-e LDAP_TLS_KEYSTORE_PASSWORD: '' \
-e LDAP_TLS_KEYSTORE_TYPE: '' \
-e LDAP_TLS_TRUSTSTORE: '' \
-e LDAP_TLS_TRUSTSTORE_PASSWORD: '' \
-e LDAP_TLS_TRUSTSTORE_TYPE: ''

集群配置

通过环境变量配置集群参数（对应nifi.properties）：

state-management.xml配置映射：

配置信息

默认端口

容器内默认端口及功能：

变量注册配置

通过NIFI_VARIABLE_REGISTRY_PROPERTIES环境变量配置变量注册。

注意：映射HTTPS端口时，应通过NIFI_WEB_PROXY_HOST环境变量指定可信主机。