容器与云原生 / 系统课时
配置网络与服务发现
配置网络与服务发现
Compose 会为同一项目中的服务提供默认网络和内置名称解析,因此容器之间通常不需要固定 IP。掌握这一机制后,你可以直接用服务名调用其他容器,并知道什么时候才需要端口映射或自定义网络。
学习目标
- 解释 Compose 默认网络与服务名解析的工作方式
- 使用服务名完成容器之间的稳定通信
- 区分容器内部通信、宿主机访问和网络隔离边界
默认网络如何提供稳定地址
在同一个 Compose 项目里,如果没有显式声明网络,Compose 会自动创建一个默认网络,并把各服务的容器连接进去。Docker 的内置 DNS 会把服务名解析为当前容器地址,因此调用方应该依赖 api、db 这类服务名,而不是记录可能随重建而变化的 IP。
例如 client 访问 http://api:8000 时,api 先由容器内 DNS 解析为目标容器地址,再建立连接。即使 api 容器被重新创建,只要服务名不变,调用配置通常无需修改。

用服务名完成容器间调用
在空目录中保存下面的 compose.yaml。api 在容器内监听 8000 端口,client 只用于发起请求;两者都没有声明 networks,因此会自动加入同一个默认网络。
services:
api:
image: python:3.13-alpine
command:
- python
- -c
- |
from http.server import BaseHTTPRequestHandler, HTTPServer
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
self.send_response(200)
self.end_headers()
self.wfile.write(b"api-ok\n")
def log_message(self, format, *args):
pass
HTTPServer(("0.0.0.0", 8000), Handler).serve_forever()
client:
image: alpine:3.22
command: ["sh", "-c", "while :; do sleep 3600; done"]启动后,从 client 直接以服务名访问 api:
set -e
docker compose up -d >/dev/null 2>&1
docker compose exec -T client wget -qO- http://api:8000预期输出:
api-ok这里没有配置 ports,请求依然成功,因为 client 访问的是 Compose 网络内的容器端口。首次执行可能需要先拉取镜像,但业务输出仍是上面的 api-ok。
区分内部端口与宿主机端口
服务之间通信时,应使用“服务名 + 容器端口”,例如 api:8000。ports 的作用是把容器端口发布给宿主机或宿主机外部的客户端,并不是容器互相发现的前提。
另一个常见错误是在 client 中访问 localhost:8000。容器里的 localhost 只指向当前容器自身,不会自动指向 api。只有两个进程真的运行在同一个容器里时,localhost 才表示同一个网络命名空间。
控制服务之间的网络边界
默认网络适合规模较小、服务之间普遍需要互通的项目。当前端代理、业务服务、数据库的访问边界需要收紧时,可以声明多个自定义网络,只让确实需要通信的服务加入同一网络;没有共享网络的服务不能仅靠服务名直接建立连接。
不要把 container_name 当成服务发现机制。Compose 的稳定抽象是服务名;显式固定容器名不仅降低项目隔离能力,还会限制同一服务的横向扩展。排查通信失败时,先确认目标进程确实监听了正确的容器端口,再确认两个服务处于同一 Compose 网络,最后检查应用是否错误地使用了 localhost 或宿主机端口。