PostgreSQL 18 Docker 环境搭建与部署实战。涵盖 Docker 核心概念、多系统安装步骤、基本命令使用、容器化部署方法（含数据卷挂载与自定义配置）、Docker Compose 编排实践，以及 PostgreSQL 与 SQL Server、MySQL 在 Docker 部署上的对比分析。通过实际项目演练掌握镜像拉取、容器运行、连接测试及资源清理流程，帮助开发者快速构建一致且隔离的数据库开发测试环境。
Docker 是一种容器化技术，它允许开发者将应用程序及其依赖项打包到一个标准化的单元（容器）中，以便在任何环境中都能一致地运行。Docker 容器是轻量级、可移植、自给自足的，包含运行应用程序所需的一切：代码、运行时、系统工具、系统库和配置。
docker --versiondocker run hello-world以 Ubuntu 24.04 为例：
（可选）将当前用户添加到 docker 组，无需 sudo 即可运行 docker 命令：
sudo usermod -aG docker $USER
注销并重新登录后生效。
验证 Docker 安装是否成功：
sudo docker --version
sudo docker run hello-world
安装 Docker CE（社区版）：
sudo apt-get install docker-ce docker-ce-cli containerd.io
再次更新系统包：
sudo apt-get update
添加 Docker 稳定版仓库：
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
添加 Docker 官方 GPG 密钥：
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
安装必要的依赖包：
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
更新系统包：
sudo apt-get update
docker --versiondocker run hello-world| 命令 | 描述 | 示例 |
|---|---|---|
docker pull | 从仓库拉取镜像 | docker pull postgres:18 |
docker images | 列出本地镜像 | docker images |
docker rmi | 删除本地镜像 | docker rmi postgres:18 |
docker build | 从 Dockerfile 构建镜像 | docker build -t myapp . |
docker tag | 为镜像添加标签 | docker tag myapp myusername/myapp:latest |
docker push | 将镜像推送到仓库 | docker push myusername/myapp:latest |
| 命令 | 描述 | 示例 |
|---|---|---|
docker run | 运行容器 | docker run -d --name mypostgres postgres:18 |
docker ps | 列出运行中的容器 | docker ps |
docker ps -a | 列出所有容器 | docker ps -a |
docker start | 启动容器 | docker start mypostgres |
docker stop | 停止容器 | docker stop mypostgres |
docker restart | 重启容器 | docker restart mypostgres |
docker rm | 删除容器 | docker rm mypostgres |
docker exec | 在运行的容器中执行命令 | docker exec -it mypostgres psql -U postgres |
docker logs | 查看容器日志 | docker logs mypostgres |
docker inspect | 查看容器详细信息 | docker inspect mypostgres |
| 命令 | 描述 | 示例 |
|---|---|---|
docker network ls | 列出所有网络 | docker network ls |
docker network create | 创建网络 | docker network create mynetwork |
docker network connect | 将容器连接到网络 | docker network connect mynetwork mypostgres |
docker network disconnect | 将容器从网络断开 | docker network disconnect mynetwork mypostgres |
从 Docker Hub 拉取官方的 PostgreSQL 18 镜像：
docker pull postgres:18
docker run -d \
--name pg18 \
-e POSTGRES_PASSWORD=mysecretpassword \
-p 5432:5432 \
postgres:18
参数说明：
-d：在后台运行容器--name：为容器指定名称-e POSTGRES_PASSWORD：设置 PostgreSQL 超级用户密码-p 5432:5432：将容器的 5432 端口映射到主机的 5432 端口为了持久化存储数据，我们可以将 PostgreSQL 的数据目录挂载到主机：
# 创建数据目录
sudo mkdir -p /opt/pg18/data
# 设置目录权限
sudo chown -R 999:999 /opt/pg18/data
# 运行容器并挂载数据卷
docker run -d \
--name pg18 \
-e POSTGRES_PASSWORD=mysecretpassword \
-p 5432:5432 \
-v /opt/pg18/data:/var/lib/postgresql/data \
postgres:18
参数说明：
-v /opt/pg18/data:/var/lib/postgresql/data：将主机的 /opt/pg18/data 目录挂载到容器的 /var/lib/postgresql/data 目录我们还可以挂载自定义的 PostgreSQL 配置文件：
# 创建配置目录
sudo mkdir -p /opt/pg18/config
# 创建自定义配置文件
vi /opt/pg18/config/postgresql.conf
在配置文件中添加自定义配置：
listen_addresses = '*'
max_connections = 200
shared_buffers = 512MB
运行容器并挂载配置文件：
docker run -d \
--name pg18 \
-e POSTGRES_PASSWORD=mysecretpassword \
-p 5432:5432 \
-v /opt/pg18/data:/var/lib/postgresql/data \
-v /opt/pg18/config/postgresql.conf:/etc/postgresql/postgresql.conf \
postgres:18 \
-c config_file=/etc/postgresql/postgresql.conf
# 方法 1：直接在容器内运行 psql
docker exec -it pg18 psql -U postgres
# 方法 2：使用本地 psql 连接（需要安装 psql）
psql -h localhost -p 5432 -U postgres
Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具，使用 YAML 文件来配置应用程序的服务。
Docker Compose 通常与 Docker Desktop 一起安装，无需单独安装。如果需要单独安装，可以参考官方文档：https://docs.docker.com/compose/install/
创建一个名为 docker-compose.yml 的文件：
version: '3.8'
services:
postgres:
image: postgres:18
container_name: pg18
environment:
POSTGRES_PASSWORD: mysecretpassword
POSTGRES_USER: postgres
POSTGRES_DB: mydb
ports:
- "5432:5432"
volumes:
- pgdata:/var/lib/postgresql/data
- ./init.sql:/docker-entrypoint-initdb.d/init.sql
restart: always
volumes:
pgdata:
driver: local
创建一个名为 init.sql 的文件，用于初始化数据库：
-- 创建测试表
CREATE TABLE users (
id SERIAL PRIMARY KEY,
name VARCHAR(50) NOT NULL,
email VARCHAR(100) NOT NULL UNIQUE
);
-- 插入测试数据
INSERT INTO users (name, email) VALUES
('张三', '[email protected]'),
('李四', '[email protected]'),
('王五', '[email protected]');
在包含 docker-compose.yml 文件的目录中运行：
docker-compose up -d
docker-compose down
通过本次实践，掌握使用 Docker 部署 PostgreSQL 18 的方法，包括：
docker pull postgres:18
docker run -d \
--name pg18-practice \
-e POSTGRES_PASSWORD=practice123 \
-e POSTGRES_USER=practiceuser \
-e POSTGRES_DB=practicedb \
-p 5432:5432 \
postgres:18
docker ps
docker exec -it pg18-practice psql -U practiceuser -d practicedb
在 psql 中运行：
-- 创建学生表
CREATE TABLE students (
id SERIAL PRIMARY KEY,
name VARCHAR(50) NOT NULL,
age INTEGER NOT NULL,
grade VARCHAR(10) NOT NULL
);
-- 插入测试数据
INSERT INTO students (name, age, grade) VALUES
('小明', 18, '高三'),
('小红', 17, '高二'),
('小刚', 16, '高一');
-- 查询数据
SELECT * FROM students;
-- 退出 psql
\q
创建 docker-compose.yml 文件：
version: '3.8'
services:
postgres:
image: postgres:18
container_name: pg18-compose
environment:
POSTGRES_PASSWORD: compose123
POSTGRES_USER: composeuser
POSTGRES_DB: composedb
ports:
- "5432:5432"
volumes:
- pgdata-compose:/var/lib/postgresql/data
restart: always
volumes:
pgdata-compose:
driver: local
启动服务：
docker-compose up -d
连接到数据库：
docker exec -it pg18-compose psql -U composeuser -d composedb
# 停止并删除单个容器
docker stop pg18-practice
docker rm pg18-practice
# 停止并删除 Compose 服务
docker-compose down
# 删除镜像（可选）
docker rmi postgres:18
为了帮助你更全面地理解不同数据库的 Docker 部署方式，本节将对比 PostgreSQL 18、SQL Server 2019+ 和 MySQL 8.0+ 在 Docker 部署方面的差异。
| 特性 | PostgreSQL 18 | SQL Server 2019+ | MySQL 8.0+ |
|---|---|---|---|
| 官方镜像维护 | 官方维护，更新频繁 | 官方维护，定期更新 | 官方维护，更新频繁 |
| 镜像大小 | 约 300MB（alpine 版本更小） | 约 1.5GB（较大，因为包含完整的 SQL Server） | 约 500MB（alpine 版本约 150MB） |
| 镜像标签 | 提供多种标签：latest、18、18-alpine 等 | 提供多种标签：latest、2019、2022、2022-latest 等 | 提供多种标签：latest、8.0、8.0-alpine 等 |
| 基础镜像 | 基于 Debian，也提供 Alpine 版本 | 基于 Ubuntu | 基于 Debian，也提供 Alpine 版本 |
| 多平台支持 | 支持 amd64、arm64 等多种架构 | 主要支持 amd64，部分版本支持 arm64 | 支持 amd64、arm64 等多种架构 |
| 镜像分层 | 合理的分层设计，便于缓存和更新 | 分层较多，更新时可能需要较多带宽 | 合理的分层设计，便于缓存和更新 |
| 部署方面 | PostgreSQL 18 | SQL Server 2019+ | MySQL 8.0+ |
|---|---|---|---|
| 基本部署命令 | docker run -d --name pg18 -e POSTGRES_PASSWORD=mypassword -p 5432:5432 postgres:18 | docker run -d --name mssql -e SA_PASSWORD=MyPass123 -e ACCEPT_EULA=Y -p 1433:1433 mcr.microsoft.com/mssql/server:2022-latest | docker run -d --name mysql8 -e MYSQL_ROOT_PASSWORD=mypassword -p 3306:3306 mysql:8.0 |
| 默认用户名 | postgres | sa | root |
| 环境变量 | 支持 POSTGRES_PASSWORD、POSTGRES_USER、POSTGRES_DB 等 | 支持 SA_PASSWORD、ACCEPT_EULA、MSSQL_PID 等 | 支持 MYSQL_ROOT_PASSWORD、MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD 等 |
| 端口映射 | 默认 5432 | 默认 1433 | 默认 3306 |
| 数据目录 | /var/lib/postgresql/data | /var/opt/mssql | /var/lib/mysql |
| 配置文件位置 | /var/lib/postgresql/data/postgresql.conf | /var/opt/mssql/mssql.conf | /etc/mysql/my.cnf 或 /etc/mysql/conf.d/ |
| 日志位置 | /var/log/postgresql | /var/opt/mssql/log | /var/log/mysql |
| 存储方面 | PostgreSQL 18 | SQL Server 2019+ | MySQL 8.0+ |
|---|---|---|---|
| 数据卷挂载 | docker run -v pgdata:/var/lib/postgresql/data postgres:18 | docker run -v mssqldata:/var/opt/mssql mcr.microsoft.com/mssql/server:2022-latest | docker run -v mysqldata:/var/lib/mysql mysql:8.0 |
| 主机目录挂载 | docker run -v /host/path:/var/lib/postgresql/data postgres:18 | docker run -v /host/path:/var/opt/mssql mcr.microsoft.com/mssql/server:2022-latest | docker run -v /host/path:/var/lib/mysql mysql:8.0 |
| 权限要求 | 数据目录需要 uid/gid 999:999 权限 | 数据目录需要特定权限配置 | 数据目录需要正确的权限配置 |
| 存储驱动支持 | 支持多种存储驱动 | 支持多种存储驱动，但对某些驱动有性能影响 | 支持多种存储驱动 |
| 数据备份 | 可通过 docker exec 运行 pg_dump，或直接备份数据卷 | 可通过 docker exec 运行 sqlcmd，或直接备份数据卷 | 可通过 docker exec 运行 mysqldump，或直接备份数据卷 |
version: '3.8'
services:
postgres:
image: postgres:18
container_name: pg18
environment:
POSTGRES_PASSWORD: mysecretpassword
POSTGRES_USER: postgres
POSTGRES_DB: mydb
ports:
- "5432:5432"
volumes:
- pgdata:/var/lib/postgresql/data
- ./init.sql:/docker-entrypoint-initdb.d/init.sql
restart: always
volumes:
pgdata:
driver: local
version: '3.8'
services:
mssql:
image: mcr.microsoft.com/mssql/server:2022-latest
container_name: mssql
environment:
SA_PASSWORD: MyPass123
ACCEPT_EULA: Y
MSSQL_PID: Developer
ports:
- "1433:1433"
volumes:
- mssqldata:/var/opt/mssql
- ./init.sql:/docker-entrypoint-initdb.d/init.sql
restart: always
volumes:
mssqldata:
driver: local
version: '3.8'
services:
mysql:
image: mysql:8.0
container_name: mysql8
environment:
MYSQL_ROOT_PASSWORD: mysecretpassword
MYSQL_DATABASE: mydb
MYSQL_USER: myuser
MYSQL_PASSWORD: mypassword
ports:
- "3306:3306"
volumes:
- mysqldata:/var/lib/mysql
- ./init.sql:/docker-entrypoint-initdb.d/init.sql
- ./my.cnf:/etc/mysql/conf.d/my.cnf
restart: always
volumes:
mysqldata:
driver: local
| 初始化方面 | PostgreSQL 18 | SQL Server 2019+ | MySQL 8.0+ |
|---|---|---|---|
| 初始化脚本 | 支持将.sql/.sh/.sql.gz 文件放入/docker-entrypoint-initdb.d/目录 | 支持通过环境变量或外部脚本初始化 | 支持将.sql/.sh/.sql.gz 文件放入/docker-entrypoint-initdb.d/目录 |
| 配置文件挂载 | 可挂载 postgresql.conf 和 pg_hba.conf | 可挂载 mssql.conf | 可挂载 my.cnf 或在/etc/mysql/conf.d/目录下挂载配置文件 |
| 命令行配置 | 支持通过 docker run 命令行参数传递配置（如-c shared_buffers=256MB） | 配置主要通过环境变量或配置文件 | 支持通过命令行参数传递配置（如–default-authentication-plugin=mysql_native_password） |
| 扩展安装 | 可通过 docker exec 安装扩展（如 apt-get install postgresql-18-postgis-3） | 可通过 docker exec 安装扩展包 | 可通过 docker exec 安装插件（如 apt-get install mysql-server-plugin-*） |
| 资源方面 | PostgreSQL 18 | SQL Server 2019+ | MySQL 8.0+ |
|---|---|---|---|
| CPU 使用率 | 适中，默认配置下 CPU 使用率较低 | 较高，尤其是在启动时和执行复杂查询时 | 适中，默认配置下 CPU 使用率较低 |
| 内存使用率 | 可通过 shared_buffers 等参数调整，默认约 128MB | 较大，默认至少需要 2GB 内存 | 可通过 innodb_buffer_pool_size 等参数调整，默认约 128MB |
| 磁盘 I/O | 可通过 WAL 配置调整 I/O 模式 | 较高，尤其是在执行大量写入操作时 | 可通过 innodb_flush_log_at_trx_commit 等参数调整 I/O 模式 |
| 启动时间 | 较快，约 5-10 秒 | 较慢，约 30-60 秒（因为需要初始化 SQL Server） | 较快，约 5-10 秒 |
| 并发连接支持 | 默认支持 100 个并发连接，可调整 | 默认支持 32767 个并发连接 | 默认支持 151 个并发连接，可调整 |
| 场景类型 | PostgreSQL 18 | SQL Server 2019+ | MySQL 8.0+ |
|---|---|---|---|
| 开发环境 | 非常适合，镜像较小，启动快，功能全面 | 适合需要 SQL Server 特定功能的开发环境 | 非常适合，镜像小，启动快，易于配置 |
| 测试环境 | 适合，支持多种配置，易于部署和销毁 | 适合，可快速部署不同版本的 SQL Server | 适合，支持多种配置，易于自动化测试 |
| 生产环境 | 适合，稳定性高，支持高可用配置 | 适合，企业级支持，功能全面 | 适合，高并发性能好，资源占用低 |
| 微服务架构 | 适合，可作为微服务的后端数据库 | 适合，尤其是与.NET 微服务集成 | 适合，轻量级，适合微服务架构 |
| CI/CD 流水线 | 适合，镜像小，启动快，易于集成 | 可以使用，但镜像较大，可能影响 CI/CD 速度 | 非常适合，镜像小，启动快，易于集成 |
| 边缘计算 | 适合，alpine 版本体积小，资源占用低 | 不适合，镜像太大，资源占用高 | 适合，alpine 版本体积小，资源占用低 |
本章节我们学习了 Docker 的基本概念、安装方法和基本命令，以及如何使用 Docker 部署 PostgreSQL 18。同时，我们对比了 PostgreSQL 18、SQL Server 2019+ 和 MySQL 8.0+ 在 Docker 部署方面的差异，包括镜像特性、部署命令、持久化存储、Docker Compose 配置、初始化和配置、性能和资源使用以及适用场景等方面。
主要内容包括：
Docker 是现代应用开发和部署的重要工具，掌握 Docker 可以帮助我们更高效地开发、测试和部署应用程序。通过对比不同数据库的 Docker 部署方式，我们可以更好地理解它们的特点和适用场景，选择最适合我们需求的数据库。
在接下来的章节中，我们将学习如何在本地安装 PostgreSQL 18，以及如何使用 PostgreSQL 进行数据操作和管理。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
在线格式化和美化您的 SQL 查询（它支持各种 SQL 方言）。 在线工具，SQL 美化和格式化在线工具，online
解析 INSERT 等受限 SQL，导出为 CSV、JSON、XML、YAML、HTML 表格（见页内语法说明）。 在线工具，SQL转CSV/JSON/XML在线工具，online
CSV 与 JSON/XML/HTML/TSV/SQL 等互转，单页多 Tab。 在线工具，CSV 工具包在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online