容器与云原生 / 系统课时

服务之间为什么直接用名称访问

服务之间为什么直接用名称访问

容器 IP 会随重建而变化,把数据库或缓存地址写成固定 IP 很快就会失效。Compose 在共享网络上提供基于服务名的发现机制,因此应用应连接 db、redis、web 这类稳定名称,而不是追踪某次启动得到的地址。

学习目标

  • 说明服务名如何成为容器间通信的主机名。
  • 正确区分容器端口与发布到宿主机的端口。
  • 排查“名称能解析但服务仍连接失败”的常见边界。

服务名是稳定的访问入口

同一 Compose 网络中的服务会注册可发现的服务名,其他容器可以直接把服务名当作主机名使用。例如应用连接 PostgreSQL 时写 db:5432,连接 Redis 时写 redis:6379,不需要先查询目标容器 IP。Docker 官方文档也明确建议在容器重建时依赖名称而不是 IP,因为新容器可能获得不同地址。([Docker Documentation][1])

这一机制的前提是通信双方至少共享一张 Compose 网络。服务名提供的是网络定位能力,不代表目标进程一定已经完成启动,也不代表任意网络中的容器都能访问它。

Compose 服务名解析与端口访问路径

用服务名完成一次访问

下面让 web 发布宿主机端口 8080,同时启动一个 client 容器。client 与 web 没有显式网络配置,因此都会加入 Project 的默认网络。

yaml
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"

  client:
    image: alpine:3.20
    command: ["sh", "-c", "while true; do sleep 3600; done"]

启动项目后,从 client 内部直接请求 web:80:

bash
set -e
docker compose -p name-demo up -d >/dev/null 2>&1
docker compose -p name-demo exec -T client sh -c "wget -qO- http://web:80 | grep -o 'Welcome to nginx!'"

预期输出

text
Welcome to nginx!

这里没有查询 web 的 IP。wget 把 web 交给容器网络中的名称解析机制,再连接解析出的当前地址。即使以后重新创建 web 容器,只要服务仍叫 web 并与 client 共享网络,调用方通常不需要改配置。

容器间为什么用 80 而不是 8080

ports 中的 "8080:80" 表示把宿主机的 8080 发布到容器的 80。从宿主机访问时使用 http://localhost:8080;从同一 Compose 网络的其他服务访问时,直接使用目标服务实际监听的容器端口,也就是 http://web:80。官方 Compose 网络文档同样区分了宿主机端口与容器端口,并说明服务间通信使用容器端口。([Docker Documentation][1])

同理,在 client 容器里写 localhost:8080 也不会回到宿主机上的 web 映射;容器里的 localhost 指向 client 自己。

名称正确仍连接失败时看什么

先把问题分成“解析”与“服务可用性”两层。若两个服务没有共享网络,名称发现的前提就不成立;若名称已经能解析,但请求得到 connection refused 或超时,则继续检查目标进程是否监听正确端口、是否已经就绪,以及应用配置是否误用了宿主机端口。

服务名因此不是某个容器 IP 的别名常量,而是 Compose 网络中的稳定服务入口。业务配置依赖 db、redis、web 这样的名称,可以把容器地址变化留给网络层处理,并让重建、更新和本地开发环境更容易维护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

服务之间为什么直接用名称访问

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通