macOS 12.4下Docker Compose部署PostgreSQL遇权限错误

PostgreSQL镜像内部是以postgres用户（UID/GID通常为999）运行数据库服务的，该用户需要对数据目录/var/lib/postgresql/data拥有读写权限。

当你用本地目录./pgdata挂载到容器时，macOS的文件系统权限会被映射到Docker背后的Linux虚拟机中。本地目录的所有者是你macOS系统的用户（UID一般为501），容器内的postgres用户（UID999）没有访问该目录的权限，导致PostgreSQL启动时检测到权限不符合要求（需要u=rwx(0700)或u=rwx,g=rx(0750)），从而退出。

而Docker Volume是由Docker本身管理的存储卷，创建时会自动将卷的所有者设置为容器内运行服务的用户（也就是postgres），所以不会出现权限问题。

方案一：手动调整本地目录权限 #

先在本地创建pgdata目录，然后通过临时容器修改该目录的所有者为容器内postgres用户的UID/GID：

# 创建本地目录
mkdir -p ./pgdata
# 用alpine容器修改目录权限
docker run --rm -v $(pwd)/pgdata:/data alpine chown -R 999:999 /data

之后再执行docker-compose up，容器就能正常访问数据目录了。

方案二：改用Docker命名卷 #

修改docker-compose.yml，使用Docker管理的命名卷替代本地目录挂载：

version: '3.8'
services:
  db:
    image: postgres:latest
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: gymbro
    ports:
      - 5438:5432
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

这种方式下，Docker会自动处理卷的权限配置，无需手动调整，数据也会持久化存储在Docker的管理路径下。

方案三：临时放宽目录权限（不推荐） #

如果只是临时测试，可以直接修改本地目录的权限为0777，让所有用户都能访问：

chmod -R 0777 ./pgdata

但这种方式存在安全风险，生产环境不建议使用。

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