Docker部署的Airflow连接本地主机PostgreSQL连接拒绝问题咨询

首先明确：Docker部署的Airflow完全可以正常访问宿主机上的PostgreSQL，不需要必须将PostgreSQL也部署在Docker中。你遇到的连接拒绝报错，核心原因是Docker容器内部的localhost指向的是容器自身的网络环境，而非部署了PostgreSQL的宿主机。

你可以根据自己的需求选择以下任意一种方案解决：

方案1：直接连接宿主机PostgreSQL #

不需要改动现有PostgreSQL部署，仅调整配置即可：

• 第一步：调整连接地址
  不同操作系统的宿主机访问地址规则不同：
  • Windows、MacOS环境下的Docker：直接将连接字符串和Airflow后台连接配置中的host改为host.docker.internal
  • Linux环境下的Docker：可以直接填写宿主机docker0网桥的IP（默认一般为172.17.0.1，可执行ip addr show docker0查询实际地址）；也可以在启动Airflow容器时添加--add-host=host.docker.internal:host-gateway参数，后续同样使用host.docker.internal作为host地址
    调整后的连接字符串示例：

  def queryPostgresql():
      conn_string="dbname='datawarehouse' host='host.docker.internal' user='postgres' password='admin'"
      conn=db.connect(conn_string)
      df=pd.read_sql("select name,city from test",conn)
      df.to_csv('data.csv')
      print("-------Data Saved------")
  

  如果你是通过docker-compose部署的Airflow，需要在docker-compose.yml的x-airflow-common配置块下添加extra_hosts配置，修改后重启服务生效：

  x-airflow-common:
    &airflow-common
    # 其他原有配置保持不变
    extra_hosts:
      - "host.docker.internal:host-gateway"
  

• 第二步：调整PostgreSQL访问权限
  要允许Docker网段的IP访问PostgreSQL：
  1. 打开PostgreSQL配置文件postgresql.conf，将listen_addresses修改为'*'（或添加Docker网段地址）
  2. 打开同目录下的pg_hba.conf，添加Docker网段访问规则，示例：

  host    all             all             172.17.0.0/16           scram-sha-256
  

  修改完成后重启PostgreSQL服务生效。
• 第三步：放行端口规则
  如果宿主机开启了防火墙，需要放行5432端口的入站规则。

方案2：将PostgreSQL部署在Docker同网络下 #

如果不想调整宿主机PostgreSQL配置，也可以将PostgreSQL部署在Docker中，和Airflow加入同一个Docker网络，此时直接使用PostgreSQL的容器名作为host即可访问，网络连通性更稳定，无需调整防火墙和PostgreSQL白名单配置。

建议优先使用Airflow后台配置的连接，不要在DAG代码中硬编码数据库连接信息，安全性和可维护性更高。

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