1583 字
8 分钟
用 Docker 快速搭建三大数据库:一份 Compose 全搞定
2026-11-15

为什么用 Docker 装数据库#

上一篇 《数据库怎么选》 讲完了三者的分工,接下来自然是把它们跑起来。传统装法要在系统里装三个服务、改三套配置、卸载还卸不干净;用 Docker 则是一份配置文件描述全部环境,docker compose up -d 一条命令拉起,docker compose down 一条命令清场,还不会污染宿主机。

本文的目标:一份 Compose 文件同时跑 PostgreSQL 17、MySQL 8.4、Redis 7.4,数据都持久化到命名卷,带健康检查,并逐个验证能连上。这套环境就是本系列后面所有篇目的实验场:《SQL 基础速成》 里的练习、《PostgreSQL 安装与初始配置》 里的调优,都会在它上面做。

前置要求:宿主机已装好 Docker Engine 和 Docker Compose v2(docker compose version 能输出版本号)。没装的先看本博客 Docker 系列的部署篇。

端口与规划#

先把基本规划定下来,避免和宿主机已有服务冲突:

服务镜像容器内端口宿主机端口数据库/账号规划
PostgreSQLpostgres:1754325432库 appdb,用户 appuser
MySQLmysql:8.433063306库 appdb,用户 appuser
Redisredis:7.463796379开启密码认证

如果宿主机上已经跑着同名服务占用了这些端口,把宿主机侧改成 15432、13306、16379 之类即可,容器内端口不要动。

WARNING

本文的密码只是示例。任何要暴露到公网的数据库,必须改成强密码,并且不要把数据库端口直接对公网开放;确需远程访问时,优先走内网、VPN 或 SSH 隧道,原因和做法在《MySQL 用户权限与安全管理》一篇里还会再强调。

编写 Compose 文件#

新建目录并写入 docker-compose.yml:

Terminal window
mkdir -p ~/db-lab && cd ~/db-lab
services:
postgres:
image: postgres:17
container_name: lab-postgres
restart: unless-stopped
environment:
POSTGRES_DB: appdb
POSTGRES_USER: appuser
POSTGRES_PASSWORD: pg_password_123
TZ: Asia/Shanghai
ports:
- "127.0.0.1:5432:5432"
volumes:
- pg_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U appuser -d appdb"]
interval: 5s
timeout: 3s
retries: 10
mysql:
image: mysql:8.4
container_name: lab-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: mysql_root_123
MYSQL_DATABASE: appdb
MYSQL_USER: appuser
MYSQL_PASSWORD: mysql_password_123
TZ: Asia/Shanghai
ports:
- "127.0.0.1:3306:3306"
volumes:
- mysql_data:/var/lib/mysql
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-uroot", "-pmysql_root_123"]
interval: 5s
timeout: 3s
retries: 15
redis:
image: redis:7.4
container_name: lab-redis
restart: unless-stopped
ports:
- "127.0.0.1:6379:6379"
volumes:
- redis_data:/data
command: redis-server --appendonly yes --requirepass redis_password_123
healthcheck:
test: ["CMD", "redis-cli", "-a", "redis_password_123", "ping"]
interval: 5s
timeout: 3s
retries: 10
volumes:
pg_data:
mysql_data:
redis_data:

几个关键点逐个说明:

  • 端口只绑 127.0.0.1:写成 "127.0.0.1:5432:5432" 后端口只对本机开放,局域网和公网都连不进来。省掉 IP 直接写 "5432:5432" 等于绑到所有网卡,这是新手最常踩的坑,很多数据库被入侵都是因为这一步图省事。
  • 数据必须进命名卷:不挂卷的话容器一删数据全没。命名卷由 Docker 管理,docker compose down 不带 -v 时不会删除。
  • Redis 开了 AOF 和密码:--appendonly yes 让数据持久化到卷里,--requirepass 设访问密码;持久化策略的取舍后面《Redis 持久化:RDB 与 AOF 怎么选》一篇专门讲。
  • MySQL 字符集钉死 utf8mb4:MySQL 历史上默认字符集存不下 emoji 和部分汉字,8.4 虽然默认已是 utf8mb4,显式写明可以避免被旧配置覆盖。
  • 环境变量只在首次初始化生效:POSTGRES_USER、MYSQL_DATABASE 这类变量只在数据目录为空、第一次启动时执行。改密码、改库名不能靠改环境变量重启,得进数据库里改,或者删卷重建。

启动与验证#

Terminal window
docker compose up -d
docker compose ps

等十几秒到几十秒(MySQL 首次初始化最慢),docker compose ps 里三个服务的 STATUS 都变成 Up ... (healthy) 就说明健康检查全过。然后逐个验证连接:

PostgreSQL:

Terminal window
docker exec -it lab-postgres psql -U appuser -d appdb -c "SELECT version();"

MySQL:

Terminal window
docker exec -it lab-mysql mysql -uappuser -p'mysql_password_123' -e "SELECT VERSION();"

Redis:

Terminal window
docker exec -it lab-redis redis-cli -a redis_password_123 PING
# 正常返回 PONG
docker exec -it lab-redis redis-cli -a redis_password_123 SET hello world
docker exec -it lab-redis redis-cli -a redis_password_123 GET hello

三条都通,练功房就建好了。核心结论记住一句:Compose 管生命周期,命名卷管数据命根子,两者配合,删容器永远不等于删数据。

日常管理命令#

Terminal window
docker compose stop # 停服务,数据保留
docker compose start # 再启动
docker compose restart mysql # 只重启 MySQL
docker compose logs -f postgres # 跟踪 PostgreSQL 日志
docker compose down # 删容器和网络,卷保留
docker compose down -v # 连卷一起删,数据清零,慎用
WARNING

docker compose down -v 会把三个命名卷一并删除,所有数据库数据不可恢复。执行前先确认这是你想要的,生产环境更要三思;正经备份的做法看 《数据库备份与恢复全攻略》,删卷不是备份的替代品。

排障:常见启动失败#

Q:容器一直 Restarting 或直接 Exited? A:先 docker compose logs <服务名> 看日志。数据库容器起不来九成是三类原因:数据卷里已有旧版本数据(比如卷里是 PostgreSQL 15 的数据却用 17 的镜像,大版本之间数据目录不兼容);环境变量缺失(MySQL 没给 MYSQL_ROOT_PASSWORD 会直接拒绝初始化);宿主机端口被占用(日志里会有 bind 相关报错,ss -tlnp 一查便知)。

Q:改了 Compose 里的密码,重启后旧密码还能连、新密码不行? A:这是上面说的「环境变量只在首次初始化生效」。卷里已经有初始化好的数据,后续启动直接跳过初始化。要么进库里用 SQL 改密码,要么 docker compose down -v 删卷重来(数据清零)。

Q:docker compose ps 显示 unhealthy? A:先看日志确认服务本身是否正常。有时是服务已就绪但健康检查命令写错,比如 Redis 改了密码而 healthcheck 里的密码没同步。用 docker exec 手动执行一遍 healthcheck 里的命令就能定位。

Q:宿主机上的客户端连不上,只能在容器里连? A:检查端口映射是否绑了 127.0.0.1(那就只能本机连,属预期行为);再检查宿主机防火墙;最后确认连接用的端口是宿主机侧端口而不是容器内端口。

小结#

一份 Compose 文件把 PostgreSQL、MySQL、Redis 三件套全拉了起来:命名卷保数据、健康检查报状态、端口只绑本机保安全。这套环境会贯穿整个数据库系列,下一篇就用它来练 SQL 的基本功。

用 Docker 快速搭建三大数据库:一份 Compose 全搞定
https://www.anexns.cloudns.org/posts/database-docker-quickstart/
作者
Anexns
发布于
2026-11-15
许可协议
CC BY-NC-SA 4.0