数据持久化核心是挂载外部存储并正确设置参数：用docker run需指定-v宿主机目录:/var/lib/postgresql/data；用docker-compose则通过volumes配置；务必注意权限（chown -R 999:999）、路径顺序和固定镜像版本。

直接用 Docker 部署 PostgreSQL 并实现数据持久化，核心就两点：**挂载外部存储 + 正确设置启动参数**。不依赖复杂工具，一条命令或一个 docker-compose.yml 就能搞定，关键是路径、权限和配置别出错。

用 docker run 一键部署（适合快速验证）

这是最轻量的方式，适合开发测试环境：

• 先创建宿主机目录用于存数据：mkdir -p /data/pgdata
• 运行容器，把目录挂载进去：
  docker run -d \
--name my-postgres \
-e POSTGRES_PASSWORD=mysecretpass \
-v /data/pgdata:/var/lib/postgresql/data \
-p 5432:5432 \
-d postgres:15-slim
• 关键说明：
    • /data/pgdata 是你本地的空目录，容器首次启动会自动初始化数据库文件
    • 挂载到 /var/lib/postgresql/data 是 PostgreSQL 官方镜像约定的数据根路径
    • 使用 postgres:15-slim 比 latest 更稳，体积小、兼容好

用 docker-compose 管理（推荐用于生产或长期使用）

写一个 docker-compose.yml，结构清晰、易备份、可复用：

Docker Encyclopedia

Docker 文档优先工作流：针对 Docker 特定问题、故障排除、命令规划、镜像/构建、容器/运行时操作及 Compose 等

下载

• 示例内容（保存为 docker-compose.yml）：
  version: '3.8'
services:
  postgres:
    image: postgres:15-slim
    environment:
      - POSTGRES_USER=appuser
      - POSTGRES_PASSWORD=app123
      - POSTGRES_DB=appdb
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U appuser -d appdb"]
• 执行 docker-compose up -d 启动，postgres-data 文件夹会自动生成并持续保存所有数据
• 好处：配置集中、支持健康检查、便于后续加 pgAdmin 或 n8n 等配套服务

持久化必须注意的三个细节

很多“数据丢了”问题其实卡在这几个地方：

• 权限不能错：PostgreSQL 容器内以用户 postgres（UID 999）运行，宿主机挂载目录需允许该 UID 写入。Linux/macOS 下建议：sudo chown -R 999:999 /data/pgdata
• 路径别写反：-v 宿主机路径:容器内路径，顺序颠倒会导致空目录挂载，数据仍存在容器临时层里
• 别用 latest 标签：PostgreSQL 大版本升级（如 15→16）可能不兼容旧数据格式。始终指定明确版本，例如 postgres:15.8 或 postgres:15-slim

验证持久化是否生效

做完部署，花 1 分钟确认一下：

• 连进数据库建个表、插条数据：docker exec -it my-postgres psql -U appuser -d appdb
• 删掉容器：docker rm -f my-postgres
• 用同样命令重启容器：docker-compose up -d 或再跑一遍 docker run...
• 重新连接，查刚才的表——如果数据还在，说明持久化成功；如果表没了，回头检查挂载路径和权限