Docker部署PostgreSQL容器无法从终端连接的问题求助

1. 先查容器日志定位核心问题 #

直接查看容器的运行日志，能快速找到报错根源：

docker logs api_db_1

如果日志里出现permission denied相关内容，基本是本地挂载的数据目录权限不匹配容器内PostgreSQL进程的权限（容器内PostgreSQL用UID为999的postgres用户运行）。

2. 修复挂载目录权限（如果是权限问题） #

修改本地挂载目录的权限，让容器内进程能正常读写：

sudo chown -R 999:999 ./api/db/postgres-test-data

之后重启容器：

docker-compose restart db

3. 确保PostgreSQL监听所有地址 #

默认PostgreSQL只监听容器内部的localhost，需要配置为监听所有地址才能被外部访问，有两种简单实现方式：

方式一：通过启动命令强制修改 #

修改docker-compose.yaml，给服务添加command字段：

version: '3.8'
services:
  db:
    image: postgres:14.5
    restart: always
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    logging:
      options:
        max-size: 10m
        max-file: "3"
    ports:
      - '5416:5432'
    volumes:
      - ./api/db/postgres-test-data:/var/lib/postgresql/data
    command: postgres -c listen_addresses='*'

重启服务生效：

docker-compose down && docker-compose up -d

方式二：挂载自定义配置文件 #

如果需要更多自定义配置，在本地创建postgresql.conf并添加listen_addresses = '*'，然后在docker-compose.yaml中挂载该文件：

volumes:
  - ./api/db/postgres-test-data:/var/lib/postgresql/data
  - ./api/db/postgresql.conf:/var/lib/postgresql/data/postgresql.conf

同时修改启动命令加载这个配置：

command: postgres -c config_file=/var/lib/postgresql/data/postgresql.conf

之后重启服务即可。

4. 重新尝试连接 #

完成上述操作后，再次执行连接命令：

psql -h localhost -p 5416 -U postgres

输入密码postgres就能正常连接了。

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