容器与云原生 / 系统课时

ports 怎样映射宿主机端口

ports 怎样映射宿主机端口

ports 解决的是“宿主机上的哪个地址和端口,要转发到容器里的哪个端口”。掌握左侧是宿主机、右侧是容器这一条规则后,就能正确处理公开访问、本机限定、动态端口和端口冲突。

学习目标

  • 能读写 ports 的短语法和长语法
  • 能把服务限制为仅从宿主机本地访问
  • 能定位宿主机端口冲突并选择合适的修复方式

读懂端口映射方向

最常见的短语法是 "8080:80",表示访问宿主机的 TCP 8080 端口时,把连接转发到容器的 80 端口。不要把顺序写反:左边是宿主机发布端口,右边是容器实际监听端口。

写法 含义
"8080:80" 宿主机所有接口的 8080 转到容器 80
"127.0.0.1:8080:80" 只在宿主机回环地址发布 8080
"8080:80/tcp" 显式指定 TCP 协议
"80" 只给出容器端口,由运行时分配宿主机端口

短语法最好始终加引号,避免 YAML 把带冒号的值按其他标量规则解释。未指定协议时默认使用 TCP。

跑通一个只监听本机的映射

下面的 compose.yaml 启动 Nginx,并只把宿主机 127.0.0.1:8080 映射到容器的 80 端口:

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

启动服务后,用宿主机上的 curl 验证 HTTP 状态码:

bash
docker compose up -d
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/

预期输出

text
200

实际启动日志、容器 ID 和时间会因环境不同而变化;这里用固定的 HTTP 状态码作为验收结果。完成练习后可以运行 docker compose down 清理容器和默认网络。

什么时候绑定 127.0.0.1

写成 "8080:80" 而不指定宿主机 IP 时,端口默认绑定到宿主机的 0.0.0.0。对有公网地址的主机,这可能让服务从外部网络直接可达。

如果数据库管理页、调试接口或后端服务只需要被宿主机上的反向代理访问,可以显式写成 "127.0.0.1:8080:80"。如果确实要让局域网或公网客户端连接,再根据主机网络和防火墙策略选择合适的监听地址。

需要更清楚地表达字段时,可以改用长语法:

yaml
services:
  web:
    image: nginx:alpine
    ports:
      - target: 80
        published: "8080"
        host_ip: 127.0.0.1
        protocol: tcp

这里 target 是容器端口,published 是宿主机发布端口,host_ip 控制绑定地址。长语法适合团队配置,因为字段含义比多个冒号更直观。

端口冲突怎样处理

端口冲突发生在宿主机侧:如果另一个进程或容器已经占用了宿主机 8080,新服务就无法再次发布同一个地址和端口。容器内部多个服务都监听 80 并不冲突,只要它们映射到不同的宿主机端口。

常见修复方式有三种:停止原来占用端口的进程或容器;把左侧发布端口改成其他未占用值,例如 "8081:80";如果调用方不要求固定端口,只写 "80" 让运行时分配宿主机端口,再查询实际映射。

ports 和 expose 不要混用概念

ports 会把容器端口发布到宿主机;expose 只描述容器内部可供其他容器使用的端口,并不会自动创建宿主机端口映射。在同一个 Compose 网络中,服务之间通常直接通过服务名和容器端口通信,不需要先绕到宿主机发布端口。

另外,使用 network_mode: host 时不要再配置 ports,因为容器已经直接使用宿主机网络栈,没有额外的端口发布层。设计端口时先区分“容器之间通信”和“宿主机或外部客户端访问”,就能避免大多数映射错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

ports 怎样映射宿主机端口

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

登录哪都通