为什么用 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 系列的部署篇。
端口与规划
先把基本规划定下来,避免和宿主机已有服务冲突:
| 服务 | 镜像 | 容器内端口 | 宿主机端口 | 数据库/账号规划 |
|---|---|---|---|---|
| PostgreSQL | postgres:17 | 5432 | 5432 | 库 appdb,用户 appuser |
| MySQL | mysql:8.4 | 3306 | 3306 | 库 appdb,用户 appuser |
| Redis | redis:7.4 | 6379 | 6379 | 开启密码认证 |
如果宿主机上已经跑着同名服务占用了这些端口,把宿主机侧改成 15432、13306、16379 之类即可,容器内端口不要动。
WARNING本文的密码只是示例。任何要暴露到公网的数据库,必须改成强密码,并且不要把数据库端口直接对公网开放;确需远程访问时,优先走内网、VPN 或 SSH 隧道,原因和做法在《MySQL 用户权限与安全管理》一篇里还会再强调。
编写 Compose 文件
新建目录并写入 docker-compose.yml:
mkdir -p ~/db-lab && cd ~/db-labservices: 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这类变量只在数据目录为空、第一次启动时执行。改密码、改库名不能靠改环境变量重启,得进数据库里改,或者删卷重建。
启动与验证
docker compose up -ddocker compose ps等十几秒到几十秒(MySQL 首次初始化最慢),docker compose ps 里三个服务的 STATUS 都变成 Up ... (healthy) 就说明健康检查全过。然后逐个验证连接:
PostgreSQL:
docker exec -it lab-postgres psql -U appuser -d appdb -c "SELECT version();"MySQL:
docker exec -it lab-mysql mysql -uappuser -p'mysql_password_123' -e "SELECT VERSION();"Redis:
docker exec -it lab-redis redis-cli -a redis_password_123 PING# 正常返回 PONGdocker exec -it lab-redis redis-cli -a redis_password_123 SET hello worlddocker exec -it lab-redis redis-cli -a redis_password_123 GET hello三条都通,练功房就建好了。核心结论记住一句:Compose 管生命周期,命名卷管数据命根子,两者配合,删容器永远不等于删数据。
日常管理命令
docker compose stop # 停服务,数据保留docker compose start # 再启动docker compose restart mysql # 只重启 MySQLdocker 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 的基本功。