NiFi Registry容器未读取Docker Compose环境变量NIFI_REGISTRY_WEB_HTTPS_PORT问题

核心问题分析 #

你遇到的问题是NiFi Registry容器已接收环境变量，但未将其注入到nifi-registry.properties配置文件中，导致仍使用默认HTTP端口18080。主要原因可能有以下几点：

• 用户身份冲突：你设置了user: root运行容器，但官方NiFi Registry镜像的启动脚本是为默认的nifi-registry用户设计的，切换root后，脚本可能无法正确执行环境变量到配置文件的替换逻辑。
• 未禁用默认HTTP端口：即使配置了HTTPS端口，NiFi Registry默认仍会启用HTTP端口18080，需要显式禁用它才能强制使用HTTPS。
• 证书文件权限问题：挂载的证书文件可能权限不足，导致启动脚本无法读取，进而跳过安全配置的注入（此可能性较低，但仍需验证）。

解决方案步骤 #

1. 移除user: root配置 #

修改Compose中Registry服务的配置，删除user: root，使用镜像默认用户运行：

registry:
    hostname: DWH_Nifi_registry
    container_name: nifi_registry_container_persistent
    image: 'apache/nifi-registry:1.22.0'
    restart: on-failure
    # 移除 user: root 这一行
    ports:
        - '18443:18443'
    # 其余配置保持不变

2. 添加HTTP端口禁用配置 #

在Registry的环境变量中加入NIFI_REGISTRY_WEB_HTTP_PORT=-1，关闭默认HTTP端口：

environment:
    - NIFI_REGISTRY_WEB_HTTPS_PORT=18443
    - NIFI_REGISTRY_WEB_HTTP_PORT=-1  # 新增这一行
    - NIFI_REGISTRY_SECURITY_KEYSTORE=/opt/certs/keystore.jks
    # 其余环境变量保持不变

3. 验证证书文件权限 #

如果上述步骤后仍有问题，检查容器内证书文件的权限：

# 进入Registry容器
docker exec -it nifi_registry_container_persistent bash
# 查看证书文件权限
ls -l /opt/certs/

如果权限不是nifi-registry用户可读取，可在Compose中添加命令调整权限：

command: >
    bash -c "chown nifi-registry:nifi-registry /opt/certs/* && /opt/nifi-registry/scripts/start.sh"

4. 查看启动日志排查错误 #

执行以下命令查看Registry容器的启动日志，确认是否有配置加载错误：

docker logs nifi_registry_container_persistent

日志中若出现证书读取失败、配置注入错误等信息，可针对性解决。

验证修复 #

修改完成后，重启Docker Compose：

docker-compose down && docker-compose up -d

等待容器启动完成后，进入容器查看nifi-registry.properties：

docker exec -it nifi_registry_container_persistent cat /opt/nifi-registry/nifi-registry-current/conf/nifi-registry.properties

确认nifi.registry.web.https.port=18443及其他安全配置已正确写入，同时验证HTTPS端口是否可访问：

curl -k https://localhost:18443/nifi-registry/

内容的提问来源于stack exchange，提问作者santhosh