Docker 部署 PostgreSQL 数据库教程-平芜编程栈

PostgreSQL是一款开源免费的高级关系型数据库管理系统，始于1986年，由全球开发者社区持续维护迭代，兼具悠久历史与前沿特性。它严格遵循ACID事务原则，确保数据读写的一致性与可靠性，同时突破传统关系型数据库局限，支持多模型存储——既能兼容标准SQL，又可高效处理JSON、数组、地理空间（GIS）等复杂数据类型。

其核心优势在于极强的扩展性：可通过自定义函数、存储过程及丰富插件（如PostGIS用于地理信息分析）拓展功能，适配从中小型应用到企业级海量数据场景（如电商交易、日志分析、科学计算）。此外，它采用多版本并发控制（MVCC）优化高并发读写性能，内置数据加密、访问控制等安全机制，是平衡功能深度、稳定性与运维友好性的主流开源数据库优选。

1、查看 PostgreSQL 镜像详情

你可以在轩辕镜像中找到 PostgreSQL 镜像页面：
👉 postgres Docker Image Overview | PostgreSQL database...

在镜像页面中，你会看到多种拉取方式，下面逐一说明如何下载与部署。

2、下载 PostgreSQL 镜像

2.1 使用轩辕镜像登录验证方式拉取

docker pull xxx.xuanyuan.run/library/postgres:latest

2.2 拉取后改名

docker pull xxx.xuanyuan.run/library/postgres:latest \ && docker tag xxx.xuanyuan.run/library/postgres:latest library/postgres:latest \ && docker rmi xxx.xuanyuan.run/library/postgres:latest

说明：

docker pull：从轩辕镜像加速拉取
docker tag：重命名为 library/postg xxx.xuanyuan.runres:latest，保持与官方一致
docker rmi：删除临时标签，避免重复占用空间

2.3 使用免登录方式拉取（推荐）

免登录方式无需配置账户，新手可直接使用。

docker pull xxx.xuanyuan.run/library/postgres:latest

带重命名的完整命令：

docker pull xxx.xuanyuan.run/library/postgres:latest \ && docker tag xxx.xuanyuan.run/library/postgres:latest library/postgres:latest \ && docker rmi xxx.xuanyuan.run/library/postgres:latest

2.4 官方直连方式

若网络可直连 Docker Hub，或已配置加速器，可直接：

docker pull postgres:latest

2.5 查看镜像是否拉取成功

docker images

输出类似：

REPOSITORY TAG IMAGE ID CREATED SIZE postgres latest 5d2f9e78c6f1 2 weeks ago 374MB

3、部署 PostgreSQL

以下示例均基于已下载的library/postgres:latest镜像，提供三种部署方式。

3.1 快速部署（最简方式）

适合测试或学习：

docker run -d --name pg-test \ -e POSTGRES_PASSWORD=123456 \ -p 5432:5432 \ library/postgres:latest

参数说明：

--name pg-test：容器名称
-e POSTGRES_PASSWORD=123456：设置 postgres 超级用户密码（必填）
-p 5432:5432：将宿主机端口映射到容器 5432 端口

验证方式：

docker exec -it pg-test psql -U postgres

若成功进入 psql，说明部署完成。

3.2 挂载目录（推荐方式，适合生产环境）

持久化数据与配置，避免容器删除后数据丢失。

第一步：创建宿主机目录

mkdir -p /data/postgres/{data,conf,logs}

第二步：启动容器并挂载目录

docker run -d --name pg-web \ -e POSTGRES_PASSWORD=123456 \ -p 5432:5432 \ -v /data/postgres/data:/var/lib/postgresql/data \ -v /data/postgres/logs:/var/log/postgresql \ library/postgres:latest

目录说明

宿主机目录	容器目录	说明
/data/postgres/data	/var/lib/postgresql/data	数据持久化目录
/data/postgres/logs	/var/log/postgresql	日志目录
/data/postgres/conf	/etc/postgresql（可选）	配置目录（需扩展）

3.3 docker-compose 部署（适合企业级场景）

统一管理配置与容器，支持一键启动。

第一步：编写 docker-compose.yml

version: '3' services: postgres: image: library/postgres:latest container_name: pg-service restart: always environment: POSTGRES_USER: admin POSTGRES_PASSWORD: 123456 POSTGRES_DB: mydb ports: - "5432:5432" volumes: - ./data:/var/lib/postgresql/data - ./logs:/var/log/postgresql

第二步：启动服务

docker compose up -d

补充说明：

默认会自动创建数据库 mydb 和用户 admin
修改配置/网页可直接操作挂载目录

4、结果验证

查看容器状态

docker ps

应看到 postgres 容器 Up 状态。

进入 PostgreSQL

docker exec -it pg-service psql -U admin -d mydb

创建测试表

CREATE TABLE test(id SERIAL PRIMARY KEY, name TEXT); INSERT INTO test(name) VALUES('Hello Xuanyuan!'); SELECT * FROM test;

输出结果即表示数据库可用。

5、常见问题

5.1 无法连接数据库？

确认防火墙或安全组放行 5432 端口
检查数据库密码是否正确
执行docker logs 容器名查看错误原因

5.2 如何持久化配置？

官方镜像会在/var/lib/postgresql/data存储数据，建议挂载宿主机目录。如需自定义配置，可拷贝默认配置：

docker exec -it pg-web bash cat /var/lib/postgresql/data/postgresql.conf

复制出来后放到宿主机目录再挂载回去。

5.3 数据库时区不正确？

启动时指定：

-e TZ=Asia/Shanghai

5.4 如何启用远程访问？

在postgresql.conf中修改：
```
listen_addresses = '*'
```
在pg_hba.conf添加：
```
host all all 0.0.0.0/0 md5
```
然后重启容器：
```
docker restart pg-web
```

5.5 日志文件过大？

挂载日志目录后，使用宿主机 logrotate 管理：

/data/postgres/logs/*.log { daily rotate 7 compress missingok notifempty }

结尾

至此，你已掌握基于轩辕镜像的 PostgreSQL 部署全流程：从镜像下载、快速运行、持久化目录挂载，再到 docker-compose 企业级部署与问题排查。

初学者可直接用「快速部署」验证数据库，高级工程师则可基于「目录挂载 + docker-compose」实现生产环境部署。随着使用深入，你还可以探索主从复制、备份恢复、性能优化、监控等进阶功能，让 PostgreSQL 成为业务的核心数据库引擎。

Docker 部署 PostgreSQL 数据库教程