在开发或测试场景中，使用Docker部署PostgreSQL可以跳过复杂的本地环境配置，快速获得可用的数据库服务。部署过程主要围绕容器运行参数展开，核心涉及端口映射、数据持久化以及环境变量配置三个部分，下面逐步说明具体操作。
基础部署命令与核心参数
部署PostgreSQL最基础的方式是使用docker run命令，通过指定官方镜像和必要参数启动容器。以下是一个包含基础映射和环境变量配置的示例命令：
# 拉取PostgreSQL最新稳定版镜像 docker pull postgres:latest # 启动PostgreSQL容器 docker run -d --name pg-container -p 5432:5432 -v pg-data:/var/lib/postgresql/data -e POSTGRES_PASSWORD=mysecretpassword -e POSTGRES_USER=myuser -e POSTGRES_DB=mydb postgres:latest
端口映射说明
命令中的-p 5432:5432参数就是端口映射配置，格式为宿主机端口:容器端口。PostgreSQL容器内部默认监听5432端口，通过映射可以将宿主机的5432端口请求转发到容器内的5432端口，这样外部应用就可以通过宿主机的IP和5432端口访问容器内的数据库服务。
如果宿主机的5432端口已经被占用，可以修改映射的宿主机端口，例如-p 5433:5432，此时外部访问需要使用5433端口。
数据卷映射说明
命令中的-v pg-data:/var/lib/postgresql/data是数据卷挂载配置，作用是实现数据持久化。PostgreSQL的数据默认存储在容器内的/var/lib/postgresql/data目录，如果不做挂载，容器删除后数据会全部丢失。通过挂载宿主机的命名卷pg-data，数据会保存在宿主机的Docker卷中，即使容器被删除，重新启动新容器挂载同一个卷就可以恢复原有数据。
也可以使用宿主机本地目录进行挂载，例如-v /opt/pg-data:/var/lib/postgresql/data，直接将容器数据目录映射到宿主机的指定本地路径。
环境变量配置详解
PostgreSQL官方镜像支持多个环境变量用于初始化数据库，常用的环境变量作用如下：
| 环境变量名 | 作用说明 | 是否必填 |
|---|---|---|
| POSTGRES_PASSWORD | 设置PostgreSQL超级用户postgres的密码，也可作为自定义用户的密码 | 是 |
| POSTGRES_USER | 创建指定名称的超级用户，默认不设置时使用postgres用户 | 否 |
| POSTGRES_DB | 容器启动时自动创建的数据库名称，默认不设置时创建与用户名同名的数据库 | 否 |
| POSTGRES_INITDB_ARGS | 传递给initdb命令的额外参数，用于自定义数据库初始化配置 | 否 |
部署后验证
容器启动后，可以通过以下方式验证部署是否成功：
- 查看容器运行状态：执行
docker ps，确认pg-container的状态为Up - 进入容器连接数据库：执行以下命令，输入设置的密码后如果能进入psql命令行说明部署成功
docker exec -it pg-container psql -U myuser -d mydb
也可以在宿主机安装PostgreSQL客户端，通过psql -h 127.0.0.1 -p 5432 -U myuser -d mydb命令连接验证，输入密码后能正常进入数据库交互界面即表示部署完成。
DockerPostgreSQL容器映射环境变量修改时间：2026-06-09 03:12:12