Docker 27.3.1升级后PostgreSQL本地卷挂载遇chown权限拒绝问题

Docker 27.3.1版本对卷挂载的权限处理逻辑做了调整，在Mac的colima环境中，这种变化尤为明显：

• 当你指定PGDATA=/var/lib/postgresql/data/pgdata并挂载本地目录到/var/lib/postgresql/data时，容器启动阶段会尝试将pgdata目录的所有权改为postgres用户（默认UID 999）。
• 新版本Docker强化了对非root用户操作挂载目录的限制，再加上colima虚拟机与Mac宿主系统的文件权限映射差异，导致postgres用户没有足够权限修改目录所有权，触发Permission denied错误。

方案1：提前在colima虚拟机内配置目录权限 #

1. 进入colima虚拟机：

colima ssh

2. 创建目标子目录并修改权限：

mkdir -p /custom/mount/pgdata
chown 999:999 /custom/mount/pgdata

3. 退出虚拟机后，重新执行原docker run命令即可。

方案2：使用Docker命名卷替代本地目录挂载 #

Docker命名卷会自动处理权限配置，避免宿主与容器的权限冲突：

docker run -d \
    --name some-postgres \
    -e POSTGRES_PASSWORD=mysecretpassword \
    -e PGDATA=/var/lib/postgresql/data/pgdata \
    -v postgres_data:/var/lib/postgresql/data \
    postgres

postgres_data为自定义命名卷，Docker会自动创建并设置正确的权限。

方案3：修改colima挂载配置 #

通过配置colima的挂载权限映射，让目录默认以postgres用户的UID/GID挂载：

1. 停止colima：

colima stop

2. 编辑colima配置文件：

colima edit

3. 在mounts节点下添加权限配置，示例：

mounts:
  - location: /custom/mount
    options: ["rw", "uid=999", "gid=999"]

4. 重启colima后执行原docker run命令。

方案4：临时以root用户启动（不推荐生产环境） #

仅用于临时测试场景：

1. 以root用户启动容器：

docker run -d \
    --name some-postgres \
    -e POSTGRES_PASSWORD=mysecretpassword \
    -e PGDATA=/var/lib/postgresql/data/pgdata \
    -v /custom/mount:/var/lib/postgresql/data \
    --user root \
    postgres

2. 进入容器修改目录权限：

docker exec -it some-postgres chown -R 999:999 /var/lib/postgresql/data/pgdata

3. 停止容器，去掉--user root参数后重新启动。

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