Docker运行PostgreSQL如何将数据持久化到宿主机普通文件系统

问题根因 #

• 执行docker run时使用了sudo，此时$HOME环境变量会被替换为root用户的主目录/root，而非当前登录用户的主目录，实际挂载路径为/root/docker/volumes/postgres，你在当前用户主目录下查看对应路径自然为空。
• 你指定了PGDATA=/var/lib/postgresql/data/pgdata，但挂载的宿主机目录下没有预先创建pgdata子目录，且目录权限不符合容器内postgres用户（uid=999）的读写要求，会导致PostgreSQL要么初始化失败，要么将数据写入容器内部的临时存储。
• 你当前命令使用了--rm参数，容器一旦停止就会自动删除，若未正确挂载持久化目录，停止容器后所有数据会直接丢失。

解决步骤 #

1. 先停止当前运行的PostgreSQL容器，因加了--rm参数，停止后容器会自动清理：

sudo docker stop selectel-pgdocker_pgdata

2. 创建宿主机持久化目录并配置权限（示例为将数据存放在当前普通用户主目录下）：

# 创建完整的目录结构，无需额外配置pgdata子目录的版本更易维护
mkdir -p $HOME/docker/volumes/postgres
# 给容器内postgres用户（uid固定为999）授予读写权限
sudo chown -R 999:999 $HOME/docker/volumes/postgres

3. 执行修正后的容器启动命令，手动替换你的实际用户名为你当前登录的系统用户名，避免sudo环境下$HOME变量异常：

sudo docker run --rm \
  --name selectel-pgdocker_pgdata \
  -p 5432:5432 \
  -e POSTGRES_USER=selectel \
  -e POSTGRES_PASSWORD=selectel \
  -e POSTGRES_DB=selectel \
  -d \
  -v /home/你的实际用户名/docker/volumes/postgres:/var/lib/postgresql/data \
  postgres

如果你需要保留自定义PGDATA子目录的配置，只需要在第一步创建目录时多加一层pgdata子目录，同时在启动命令中加回-e PGDATA=/var/lib/postgresql/data/pgdata参数即可。

验证方法 #

容器启动后连接psql创建测试库表，执行sudo docker stop selectel-pgdocker_pgdata停止容器后重新执行启动命令，再次连接psql确认之前创建的内容依然存在，同时查看宿主机/home/你的实际用户名/docker/volumes/postgres目录下已生成PostgreSQL的运行数据文件即配置生效。

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