Bridge 网络怎么配置端口映射将内部服务暴露给宿主机？

很多刚接触 Docker 桥接网络的人都会踩一个坑：以为接入 bridge 网络，外部就能直接连通容器服务。实际上 bridge 网络不会自动开放端口，想要宿主机或者外网访问容器，必须手动做端口映射。下面把日常最常用的映射写法、Compose 配置以及排查要点整理出来。

使用 -p 参数运行容器时映射端口

这是最常用的方式，适用于 docker run 命令：

• 基础写法：

  docker run -d -p 8080:80 nginx

  —— 把宿主机的 8080 端口映射到容器的 80 端口

• 绑定指定 IP：

  -p 127.0.0.1:3306:3306

  —— 只允许本机访问，提升安全性

• 映射 UDP：

  -p 53:53/udp

  —— 显式加 /udp，否则默认为 TCP

• 批量映射端口范围：

  -p 8000-8010:8000-8010

  —— 适合多端口服务

在 docker-compose.yml 中配置 ports 字段

适用于 Compose 编排场景，更清晰、可复用：

• 基本格式：ports: ["8080:80"] 或 ports: ["127.0.0.1:8080:80"]
• 支持多行写法，便于阅读：

  ports:
  - "8080:80"
  - "443:443/tcp"
  - "53:53/udp"

• 注意：ports 是暴露给宿主机的，同一 bridge 网络内其他容器仍可通过服务名+内部端口直接通信，无需映射

自定义 bridge 网络不影响端口映射逻辑

无论是默认 bridge 还是手动创建的自定义网络（如 app-network），端口映射机制完全一致：

• 创建网络：

  docker network create app-network

• 运行容器并加入网络：

  docker run -d --network app-network -p 8080:80 nginx

• 网络本身只解决容器间互通（通过服务名或 IP），对外暴露仍依赖 -p 或 ports。

验证和调试要点

映射后不是一定就能访问，需确认几件事：

• 宿主机防火墙是否放行目标端口（如 ufw allow 8080 或 firewalld 规则）；
• 容器内服务是否真正监听在映射端口上（如 Nginx 默认监听 0.0.0.0:80，不是 127.0.0.1:80）；
• 用

  docker port <容器名>

  查看实际绑定情况，例如输出 80/tcp -> 0.0.0.0:8080 表示成功；

• 宿主机执行

  curl http://localhost:8080

  测试；若失败，再查容器日志：

  docker logs <容器名>

总结

自定义 bridge 只负责容器之间互相通信，对外访问始终依靠端口映射。配置完成后如果无法连通，不要一味修改网络，优先检查防火墙、容器监听地址和端口绑定状态。掌握这些用法，基本可以搞定大部分 Docker 网络访问类问题。

以上关于Bridge 网络怎么配置端口映射将内部服务暴露给宿主机？的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。