PostgreSQL Docker容器突然无法启动：数据目录权限异常问题

我有一个基于timescale/timescaledb-ha:pg14-latest镜像的Docker容器，启动命令如下：

docker run -d --name timescaledb -p 127.0.0.1:5432:5432 \
-v /Users/<me>/timescaledb-data:/home/postgres/pgdata/data \
-e POSTGRES_PASSWORD=postgres timescale/timescaledb-ha:pg14-latest

今日执行该启动脚本时，Docker报错：

2023-11-05 19:43:48 2023-11-05 19:43:48.439 UTC [1] FATAL:  data directory "/home/postgres/pgdata/data" has wrong ownership
2023-11-05 19:43:48 2023-11-05 19:43:48.439 UTC [1] HINT:  The server must be started by the user that owns the data directory.

自昨日成功启动后我未做任何更改，目前已尝试重置该文件夹权限。我的环境是macOS 14.2 + Docker Desktop 4.25.0 (126437)，不确定该错误指向什么——是指PostgreSQL服务器吗？

这个错误就是指向容器内的PostgreSQL服务器进程：容器里的PostgreSQL是以postgres用户（默认UID为999）运行的，你挂载的宿主机目录权限和容器内用户不匹配，导致进程无法访问数据目录。macOS上Docker Desktop的文件权限映射经常出这类问题，哪怕手动改了宿主机权限，容器内还是会识别异常。

试试这几个解决方法：

• 临时修复：通过特权容器修改权限

  1. 先启动一个临时特权容器，挂载同一个目录：

     docker run -it --rm --privileged -v /Users/<me>/timescaledb-data:/tmp/pgdata timescale/timescaledb-ha:pg14-latest bash
     

  2. 在容器内执行命令修改目录所有权：

     chown -R 999:999 /tmp/pgdata
     

  3. 退出容器后，重新启动你的TimescaleDB容器。

• 永久规避：改用Docker卷存储数据
  要是频繁碰到权限问题，直接用Docker管理的卷代替宿主机目录挂载，Docker会自动处理权限适配：

  1. 创建一个Docker卷：

     docker volume create timescaledb-data
     

  2. 修改启动命令，替换成卷挂载：

     docker run -d --name timescaledb -p 127.0.0.1:5432:5432 \
     -v timescaledb-data:/home/postgres/pgdata/data \
     -e POSTGRES_PASSWORD=postgres timescale/timescaledb-ha:pg14-latest
     

• 检查Docker Desktop文件共享权限
  打开Docker Desktop的设置，进入「资源」-「文件共享」，确认/Users目录已被勾选，并且Docker有访问权限。如果之前没勾选，勾选后重启Docker再试。

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