Apache NiFi Registry Docker镜像文档

1. 镜像概述和主要用途

本镜像是Apache NiFi Registry的非***便捷Docker镜像。Apache NiFi Registry是Apache NiFi的配套工具，主要用于版本化和管理NiFi数据流资源（如模板、处理器、控制器服务、报告任务等），支持追踪资源变更历史、回滚版本及团队协作，是NiFi生态中实现数据流生命周期管理的核心组件。

2. 核心功能和特性

• 独立模式部署：支持以独立实例形式运行，满足单机或简单集群场景需求。
• 灵活的认证机制：
  • 无安全认证模式，适用于开发/测试环境；
  • 双向SSL（客户端证书）认证，通过客户端证书验证用户身份；
  • LDAP认证，集成企业级目录服务进行用户身份管理。

3. 使用场景和适用范围

• 无安全认证模式：适用于开发、测试或内部演示环境，快速部署验证功能，无需配置认证。
• 双向SSL认证模式：适用于对数据传输安全和用户身份验证有严格要求的生产环境，确保通信加密且客户端身份可信任。
• LDAP认证模式：适用于企业内部已部署LDAP用户目录的场景，可复用现有用户体系实现统一身份管理。

4. 构建镜像

4.1 默认构建

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

bash
# 在Dockerfile所在目录执行
docker build -t apache/nifi-registry:latest .

构建完成后，可通过docker images查看镜像：

bash
docker images
> REPOSITORY               TAG           IMAGE ID            CREATED             SIZE
> apache/nifi-registry     latest        751428cbf631        时间戳              342MB

注意：Dockerfile默认指定的NiFi Registry版本通常为未发布版本（若从源码构建）。

4.2 指定版本构建

如需构建特定已发布版本的镜像，可通过NIFI_REGISTRY_VERSION构建参数覆盖默认版本：

bash
docker build --build-arg NIFI_REGISTRY_VERSION={目标版本号} -t apache/nifi-registry:latest .

兼容性说明：配置脚本至少支持NiFi Registry 0.1.0+版本，但旧版本可能因配置参数变更导致不兼容，使用时需注意版本匹配。

5. 运行容器

5.1 独立实例（无安全认证）

基本运行命令

启动无安全认证的NiFi Registry实例，暴露UI端口***：

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

容器启动后，可通过http://localhost:***/nifi-registry访问Web UI。

自定义端口和主机名

通过环境变量NIFI_REGISTRY_WEB_HTTP_PORT修改服务端口，示例如下（将端口改为***）：

bash
docker run --name nifi-registry \
  -p ***:*** \
  -d \
  -e NIFI_REGISTRY_WEB_HTTP_PORT='***' \
  apache/nifi-registry:latest

环境变量说明：完整环境变量列表可参考镜像内的.sh/secure.sh和.sh/start.sh脚本。

5.2 独立实例（双向SSL认证）

需提供证书文件及配置信息，关键参数包括：

• AUTH=tls：启用双向SSL认证；
• INITIAL_ADMIN_IDENTITY：客户端证书的可分辨名称（DN），用于初始化管理员权限；
• 卷挂载：将主机证书目录映射到容器内/opt/certs路径。

示例命令：

bash
docker run --name nifi-registry \
  -v /path/to/tls/certs/localhost:/opt/certs \  # 主机证书目录映射
  -p ***:*** \
  -e AUTH=tls \
  -e KEYSTORE_PATH=/opt/certs/keystore.jks \    # 密钥库路径
  -e KEYSTORE_TYPE=JKS \                        # 密钥库类型（如JKS/PKCS12）
  -e KEYSTORE_PASSWORD=QKZv1hSWAFQYZ+WU1jjF5ank+l4igeOfQRp+OSbkkrs \  # 密钥库密码
  -e TRUSTSTORE_PATH=/opt/certs/truststore.jks \  # 信任库路径
  -e TRUSTSTORE_PASSWORD=rHkWR1gDNW3R9hgbeRsT3OM3Ue0zwGtQqcFKJD2EXWE \  # 信任库密码
  -e TRUSTSTORE_TYPE=JKS \                        # 信任库类型
  -e INITIAL_ADMIN_IDENTITY='CN=AdminUser, OU=nifi' \  # 管理员证书DN
  -d \
  apache/nifi-registry:latest

5.3 独立实例（LDAP认证）

需配置LDAP连接参数，若LDAP服务启用LDAPS或START_TLS，还需提供相关证书。关键参数包括：

• AUTH=ldap：启用LDAP认证；
• INITIAL_ADMIN_IDENTITY：LDAP用户的DN，用于初始化管理员权限；
• LDAP连接参数（如认证策略、管理员DN、密码、用户搜索基等）。

基础LDAP配置（SIMPLE认证）

bash
docker run --name nifi-registry \
  -v /path/to/tls/certs/localhost:/opt/certs \  # 若LDAP需证书，挂载证书目录
  -p ***:*** \
  -e AUTH=ldap \
  -e KEYSTORE_PATH=/opt/certs/keystore.jks \    # 密钥库配置（同双向SSL）
  -e KEYSTORE_TYPE=JKS \
  -e KEYSTORE_PASSWORD=QKZv1hSWAFQYZ+WU1jjF5ank+l4igeOfQRp+OSbkkrs \
  -e TRUSTSTORE_PATH=/opt/certs/truststore.jks \
  -e TRUSTSTORE_PASSWORD=rHkWR1gDNW3R9hgbeRsT3OM3Ue0zwGtQqcFKJD2EXWE \
  -e TRUSTSTORE_TYPE=JKS \
  -e INITIAL_ADMIN_IDENTITY='cn=nifi-admin,dc=example,dc=org' \  # LDAP管理员DN
  -e LDAP_AUTHENTICATION_STRATEGY='SIMPLE' \  # 认证策略（SIMPLE/START_TLS/LDAPS）
  -e LDAP_MANAGER_DN='cn=ldap-admin,dc=example,dc=org' \  # LDAP管理用户DN
  -e LDAP_MANAGER_PASSWORD='password' \  # LDAP管理用户密码
  -e LDAP_USER_SEARCH_BASE='dc=example,dc=org' \  # 用户搜索基DN
  -e LDAP_USER_SEARCH_FILTER='cn={0}' \  # 用户搜索过滤器（{0}为用户名占位符）
  -e LDAP_IDENTITY_STRATEGY='USE_DN' \  # 身份策略（USE_DN/USE_USERNAME）
  -e LDAP_URL='ldap://ldap:389' \  # LDAP服务URL
  -d \
  apache/nifi-registry:latest

LDAP TLS配置（可选）

若LDAP服务启用START_TLS或LDAPS，可添加以下环境变量配置TLS：

bash
-e LDAP_TLS_KEYSTORE='/path/to/ldap/tls/keystore.jks' \          # LDAP客户端密钥库路径
-e LDAP_TLS_KEYSTORE_PASSWORD='tls_keystore_password' \          # 密钥库密码
-e LDAP_TLS_KEYSTORE_TYPE='JKS' \                                # 密钥库类型
-e LDAP_TLS_TRUSTSTORE='/path/to/ldap/tls/truststore.jks' \      # LDAP客户端信任库路径
-e LDAP_TLS_TRUSTSTORE_PASSWORD='tls_truststore_password' \      # 信任库密码
-e LDAP_TLS_TRUSTSTORE_TYPE='JKS' \                              # 信任库类型

6. 配置参数说明