如何从Docker容器内的NiFi连接外部FTP服务器？

• 环境信息：
  • 通过Docker Compose运行的NiFi容器，配置如下：

    version: '3'
    
    services:
      nifi:
        image: apache/nifi:latest
        container_name: nifi
        ports:
          - "8443:8443"
        volumes:
          - ./database_repository:/opt/nifi/nifi-current/database_repository
          - ./flowfile_repository:/opt/nifi/nifi-current/flowfile_repository
          - ./content_repository:/opt/nifi/nifi-current/content_repository
          - ./provenance_repository:/opt/nifi/nifi-current/provenance_repository
          - ./state:/opt/nifi/nifi-current/state
          - ./logs:/opt/nifi/nifi-current/logs
          - ./conf:/opt/nifi/nifi-current/conf
        restart: always
    

  • FTP服务器部署在宿主机（容器外部的localhost）
  • NiFi流程中使用GetFTP处理器连接localhost:21失败，确认是容器网络隔离特性导致容器内的localhost无法指向宿主机

可以通过以下几种方式修改配置解决问题：

方法1：添加宿主机映射域名（推荐） #

在docker-compose.yml的nifi服务中添加extra_hosts配置，将宿主机映射为容器可识别的域名：

services:
  nifi:
    # 保留原有所有配置
    extra_hosts:
      - "host.docker.internal:host-gateway"

修改完成后重启NiFi容器，在GetFTP处理器的主机地址栏填写host.docker.internal，端口保持21即可连接宿主机的FTP服务。

方法2：直接使用宿主机实际IP #

如果host.docker.internal无法生效（部分Linux环境可能存在兼容性问题），可以直接使用宿主机的局域网IP：

1. 获取宿主机实际IP：Linux执行ip addr show，Windows执行ipconfig，Mac执行ifconfig
2. 在GetFTP处理器的主机地址栏填写该IP，端口保持21，无需修改docker-compose.yml

方法3：使用宿主机网络模式（不推荐） #

将NiFi容器设置为宿主机网络模式，容器直接复用宿主机网络栈，此时容器内的localhost将指向宿主机：

services:
  nifi:
    # 保留原有除ports外的配置（端口映射可移除，因为直接使用宿主机端口）
    network_mode: "host"

注意：该方法会丢失容器的网络隔离性，仅适合测试场景，不建议生产环境使用。

内容的提问来源于stack exchange，提问作者Александр Беляков