容器与云原生 / 系统课时
应用怎样连接数据库和 Redis
应用怎样连接数据库和 Redis
应用容器连接数据库和 Redis 时,主机名应写 Compose 服务名,而不是 localhost。因为每个容器都有自己的网络命名空间,localhost 只回到当前容器;本课用环境变量和健康检查固定正确地址并完成验证。
学习目标
- 使用
db、redis等服务名作为容器间连接主机 - 理解容器内
localhost与宿主机localhost的区别 - 配置依赖健康检查,避免应用在依赖尚未就绪时立即启动
连接地址应该写什么
Compose 会为同一网络上的服务提供基于服务名的发现,容器重建后 IP 可能变化,但服务名保持可用。因此应用代码应依赖 db、redis 这样的名字,而不是写死容器 IP。服务之间使用目标容器自己的端口,例如 PostgreSQL 的 5432 和 Redis 的 6379。([Docker Documentation][1])
| 连接来源 | 目标 | 应使用的地址 |
|---|---|---|
app 容器 |
PostgreSQL | db:5432 |
app 容器 |
Redis | redis:6379 |
| 宿主机 | 某个容器服务 | localhost:<宿主机映射端口>,前提是配置了 ports |

用 Compose 固定连接主机
下面的示例把三个服务放进同一张 backend 网络,并把数据库与 Redis 的主机名、端口作为环境变量传给应用。depends_on 使用 service_healthy 时,Compose 会等待对应健康检查通过后再启动依赖服务。([Docker Documentation][2])
services:
app:
image: busybox:1.36
command: ["sh", "-c", "sleep 3600"]
environment:
DB_HOST: db
DB_PORT: "5432"
REDIS_HOST: redis
REDIS_PORT: "6379"
depends_on:
db:
condition: service_healthy
redis:
condition: service_healthy
networks:
- backend
db:
image: postgres:16-alpine
environment:
POSTGRES_USER: app
POSTGRES_PASSWORD: change-me
POSTGRES_DB: appdb
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app -d appdb"]
interval: 5s
timeout: 3s
retries: 5
networks:
- backend
redis:
image: redis:7-alpine
healthcheck:
test: ["CMD", "redis-cli", "ping"]
interval: 5s
timeout: 3s
retries: 5
networks:
- backend
networks:
backend:示例中的口令只用于本地练习。真实项目应通过环境文件、Compose secrets 或部署平台的机密管理能力注入敏感值,而不要把生产口令直接提交到版本库。
验证应用拿到正确地址
启动服务后,从 app 容器打印连接配置。命令隐藏了启动阶段的动态容器名称与进度,只展示本课要验证的地址。
docker compose up -d >/dev/null 2>&1 && docker compose exec app sh -c 'printf "%s:%s\n%s:%s\n" "$DB_HOST" "$DB_PORT" "$REDIS_HOST" "$REDIS_PORT"'预期输出
db:5432
redis:6379这两个地址都只依赖 Compose 服务名,不依赖容器 IP。即使 db 或 redis 因重建获得新 IP,应用仍应重新通过服务名解析并建立连接。([Docker Documentation][1])
为什么 localhost 经常连错
在 app 容器中,localhost:5432 的含义是“访问 app 容器自己的 5432 端口”,并不会跳到 db 容器;localhost:6379 也不会自动指向 Redis。只有当数据库或 Redis 与应用运行在同一个容器里时,这种写法才可能成立,而多服务 Compose 正是把这些进程拆到不同容器中。
宿主机上的 localhost 又是另一回事:只有目标服务配置了 ports,宿主机才能通过映射端口访问它。容器到容器优先使用“服务名 + 容器端口”,宿主机到容器才考虑“localhost + 宿主机映射端口”。把这两套地址分开,能避免绝大多数 Compose 本地连接错误。