别慌，我来帮你搞定从宿主机连接PostgreSQL容器的问题，结合你的Airflow场景，给你几个实用的方法：

首先得明确核心前提：你的PostgreSQL容器是否把内部5432端口映射到了宿主机，这是直接连接的关键。

方法一：端口映射后用宿主机psql直接连接（推荐） #

1. 检查并配置端口映射
   打开你的docker-compose.yml，找到postgres服务的配置块，确认是否有ports字段：

   services:
     postgres:
       image: postgres:xxx  # 你的镜像版本
       ports:
         - "5432:5432"  # 格式：宿主机端口:容器内部端口
       # 其他配置（环境变量、挂载卷等）...
   

   如果没有这个ports配置，手动加上后，执行docker-compose down && docker-compose up -d重启服务，让端口映射生效。

2. 执行psql连接命令
   端口映射生效后，直接在宿主机终端运行：

   psql -U airflow -d airflow -h localhost
   

   命令执行后输入密码airflow，就能成功连接到容器内的数据库了。

   要是不想每次输入密码，可以临时设置环境变量（注意：生产环境不建议这么做，避免密码泄露）：

   PGPASSWORD=airflow psql -U airflow -d airflow -h localhost
   

方法二：无需端口映射，直接进入容器操作psql #

如果不想修改配置重启服务，也可以直接通过Docker命令进入PostgreSQL容器内部操作：

1. 找到PostgreSQL容器的名称/ID
   执行docker ps命令，找到postgres服务对应的容器信息，比如名称可能是your-project-name_postgres_1，ID是一串随机字符。

2. 进入容器并连接数据库
   用以下命令直接进入容器并启动psql：

   docker exec -it <postgres-container-name-or-id> psql -U airflow -d airflow
   

   举个例子，如果容器名是airflow_postgres_1，命令就是：

   docker exec -it airflow_postgres_1 psql -U airflow -d airflow
   

   这个方法适合临时调试，不需要改动任何配置。

常见问题排查 #

如果还是连不上，可以检查这几点：

• 确认PostgreSQL容器状态：执行docker-compose ps，看postgres服务的状态是不是Up；
• 检查容器内PostgreSQL配置：如果你自定义了postgresql.conf，确保listen_addresses = '*'（允许远程连接），同时pg_hba.conf里有host all all 0.0.0.0/0 md5的规则（官方postgres镜像默认已配置，除非你手动修改过）；
• 排查宿主机防火墙：比如Linux用ufw status检查，Windows/macOS查看防火墙设置，确保5432端口没有被拦截。

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