Docker 快速部署單節點 NiFi 1.27

前言

Apache NiFi 是一款強大的數據集成工具，專注于數據的采集、處理和分發，具有可視化流程設計、強大的容錯能力等特點。通過 Docker 部署可以快速搭建環境，省去復雜的配置步驟。本文介紹如何使用官方鏡像部署單節點 NiFi 1.27。

環境準備

• 已安裝 Docker 環境（Docker 安裝指南）
• 確保 Docker 服務正常運行
  • Linux/Mac：systemctl start docker 或 service docker start
  • Windows：在服務中啟動 Docker 服務

部署步驟

1. 拉取 NiFi 1.27 官方鏡像

打開終端/命令提示符，執行以下命令拉取官方鏡像：

docker pull apache/nifi:1.27.0

2. 啟動 NiFi 容器

使用以下命令啟動 NiFi 容器，包含端口映射和數據持久化配置：

docker run -d --name nifi-1.27 -p 8080:8080 -e NIFI_WEB_HTTP_PORT=8080 -v nifi_data:/Users/xuyy/tool/docker/nifi-1.27.0/data apache/nifi:1.27.0

3. 驗證部署

• 訪問 Web 界面：打開瀏覽器，訪問 http://localhost:8080/nifi（首次啟動可能需要 1-2 分鐘，耐心等待）
• 查看容器日志：若啟動異常，可通過日志排查問題：

  docker logs -f nifi-1.27
  

關鍵配置說明

1. 端口映射

若默認的 8080 端口被占用，可修改端口映射參數，示例如下（改用 9090 端口）：

docker run -d --name nifi-1.27 -p 9090:9090 -e NIFI_WEB_HTTP_PORT=9090 apache/nifi:1.27.0

• 格式說明：-p 主機端口:容器端口，需保證兩者一致
• 訪問地址相應變為：http://localhost:9090/nifi

2. 數據持久化

通過 -v 參數掛載數據卷，確保容器刪除后配置和數據不丟失：

• 使用 Docker 數據卷（推薦）：
  nifi_data 是自動創建的 Docker 數據卷，會持久化存儲 NiFi 的配置、狀態和流數據：

  -v nifi_data:/opt/nifi/nifi-1.27.0/data
  

• 掛載本地目錄：
  也可直接映射到本地目錄（需替換為實際路徑）：

  -v /本地絕對路徑:/opt/nifi/nifi-1.27.0/data
  

3. 自定義配置

如需修改 NiFi 核心配置（如 nifi.properties），可通過掛載文件覆蓋默認配置：

docker run -d --name nifi-1.27 -p 8080:8080 -v /本地路徑/nifi.properties:/opt/nifi/nifi-1.27.0/conf/nifi.properties apache/nifi:1.27.0

• 先從容器中復制默認配置文件：docker cp nifi-1.27:/opt/nifi/nifi-1.27.0/conf/nifi.properties /本地路徑/
• 修改后再通過上述命令掛載生效

常見問題

1. 容器啟動失敗：
   檢查端口是否被占用（Linux：netstat -tulpn | grep 8080；Windows：netstat -ano | findstr "8080"），或通過日志定位錯誤。

2. 權限問題：
   掛載本地目錄時，若出現權限錯誤，可臨時調整目錄權限：chmod 777 /本地路徑（生產環境需謹慎設置）。

3. 數據丟失風險：
   未配置數據卷掛載時，刪除容器會導致所有配置和流程丟失，務必做好持久化配置。

總結

通過 Docker 部署 NiFi 1.27 無需復雜的環境配置，幾步即可完成搭建。根據實際需求調整端口、數據掛載方式和配置文件，可快速適配開發測試或生產環境，適合新手快速上手 NiFi。