如何持久化NiFi数据与配置？容器重建后保留流程配置

你的问题核心是未挂载NiFi的核心配置目录conf，处理器、数据流等核心配置都存在${NIFI_HOME}/conf/flow.xml.gz文件中，同时还要注意目录权限匹配容器内用户，否则配置无法写入。以下是修正后的完整配置和操作步骤：

一、修正docker-compose.yaml配置 #

取消conf目录的挂载注释，同时确保所有关键持久化目录都正确映射。推荐优先使用命名卷（比绑定挂载更稳定，避免权限问题），也可选择绑定挂载（需手动调整权限）：

方案1：使用命名卷（推荐） #

version: "3.7"

services:
  nifi:
    image: koroslak/nifi:latest
    container_name: nifi
    restart: always
    environment:
      - NIFI_HOME=/opt/nifi/nifi-current
      - NIFI_LOG_DIR=/opt/nifi/nifi-current/logs
      - NIFI_PID_DIR=/opt/nifi/nifi-current/run
      - NIFI_BASE_DIR=/opt/nifi
      - NIFI_WEB_HTTP_PORT=8080
    ports:
      - 9000:8080
    depends_on:
      - openldap
    volumes:
      # 核心配置目录：保存flow.xml.gz（流程、处理器配置）
      - nifi_conf:/opt/nifi/nifi-current/conf
      # 状态存储：保存组件运行状态
      - nifi_state:/opt/nifi/nifi-current/state
      # 各类数据仓库
      - nifi_database_repo:/opt/nifi/nifi-current/repositories/database_repository
      - nifi_flowfile_repo:/opt/nifi/nifi-current/repositories/flowfile_repository
      - nifi_content_repo:/opt/nifi/nifi-current/repositories/content_repository
      - nifi_provenance_repo:/opt/nifi/nifi-current/repositories/provenance_repository
      # 日志目录
      - nifi_logs:/opt/nifi/nifi-current/logs

  # 其他服务配置保持不变
  postgres:
    image: koroslak/postgres:latest
    container_name: postgres
    restart: always
    environment:
      - POSTGRES_PASSWORD=secret123
    ports:
      - 6000:5432
    volumes:
      - postgres:/var/lib/postgresql/data

  pgadmin:
    container_name: pgadmin
    image: dpage/pgadmin4:4.18
    restart: always
    environment:
      - PGADMIN_DEFAULT_EMAIL=admin
      - PGADMIN_DEFAULT_PASSWORD=admin
    ports:
      - 8090:80

  metabase:
    container_name: metabase
    image: metabase/metabase:v0.34.2
    restart: always
    environment:
      MB_DB_TYPE: postgres
      MB_DB_DBNAME: metabase
      MB_DB_PORT: 5432
      MB_DB_USER: metabase_admin
      MB_DB_PASS: secret123
      MB_DB_HOST: postgres
    ports:
      - 3000:3000
    depends_on:
      - postgres

  openldap:
    image: osixia/openldap:1.3.0
    container_name: openldap
    restart: always
    ports:
      - 38999:389

# Mocked source systems
  jira-api:
    image: danielgtaylor/apisprout:latest
    container_name: jira-api
    restart: always
    ports:
      - 8000:8000
    command: https://raw.githubusercontent.com/mvrabel/nifi-postgres-metabase/master/api_examples/jira-api.json

  pipedrive-api:
    image: danielgtaylor/apisprout:latest
    container_name: pipedrive-api
    restart: always
    ports:
      - 8100:8000
    command: https://raw.githubusercontent.com/mvrabel/nifi-postgres-metabase/master/api_examples/pipedrive-api.yaml

  restcountries-api:
    image: danielgtaylor/apisprout:latest
    container_name: restcountries-api
    restart: always
    ports:
      - 8200:8000
    command: https://raw.githubusercontent.com/mvrabel/nifi-postgres-metabase/master/api_examples/restcountries-api.json

volumes:
  postgres:
  nifi_conf:
  nifi_state:
  nifi_database_repo:
  nifi_flowfile_repo:
  nifi_content_repo:
  nifi_provenance_repo:
  nifi_logs:
  openldap:
  metabase:
  pgadmin:

方案2：使用绑定挂载（需手动调整权限） #

若坚持用本地目录挂载，先调整本地目录权限匹配容器内NiFi运行用户（通常UID/GID为1000）：

# 创建本地目录
mkdir -p ./volume/nifi-current/{conf,state,logs}
mkdir -p ./volume/repositories/{database_repository,flowfile_repository,content_repository,provenance_repository}

# 设置权限
chown -R 1000:1000 ./volume/nifi-current
chown -R 1000:1000 ./volume/repositories

再修改docker-compose的volumes段：

volumes:
  - ./volume/nifi-current/conf:/opt/nifi/nifi-current/conf
  - ./volume/nifi-current/state:/opt/nifi/nifi-current/state
  - ./volume/repositories/database_repository:/opt/nifi/nifi-current/repositories/database_repository
  - ./volume/repositories/flowfile_repository:/opt/nifi/nifi-current/repositories/flowfile_repository
  - ./volume/repositories/content_repository:/opt/nifi/nifi-current/repositories/content_repository
  - ./volume/repositories/provenance_repository:/opt/nifi/nifi-current/repositories/provenance_repository
  - ./volume/nifi-current/logs:/opt/nifi/nifi-current/logs

二、生效步骤 #

1. 停止并删除现有NiFi容器：

docker-compose stop nifi
docker-compose rm nifi

2. 启动服务：

docker-compose up -d nifi

关键说明 #

• conf/flow.xml.gz是NiFi保存所有流程、处理器、控制器服务配置的核心文件，必须持久化该目录才能保留配置。
• 命名卷由Docker管理，自动处理权限问题，是生产环境的推荐方案；绑定挂载需要手动维护权限，适合开发调试场景。
• 若已配置流程，可先从运行中的容器导出flow.xml.gz到本地挂载目录，再重启容器：

docker cp nifi:/opt/nifi/nifi-current/conf/flow.xml.gz ./volume/nifi-current/conf/
chown 1000:1000 ./volume/nifi-current/conf/flow.xml.gz

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