Docker Compose 中配置 Host 网络模式

在 Docker Compose 中配置 Host 网络模式时，需通过 network_mode 参数直接指定容器使用宿主机的网络栈。以下是具体配置方法及注意事项：

---

1. 基础配置示例

在 docker-compose.yml 文件中，为需要启用 Host 模式的服务添加 network_mode: "host" 参数，无需额外定义网络层：

version: '3.8'  # 推荐使用 3.8 及以上版本
services:web:image: nginxnetwork_mode: "host"  # 关键配置，使容器共享宿主机网络environment:- TZ=Asia/Shanghai# 注意：Host 模式下 ports 映射无效，可省略# ports:#   - "80:80"api:image: my-api:latestnetwork_mode: "host"depends_on:- web

---

2. 多服务协同配置

若多个服务需通过 Host 模式通信，所有服务均需单独启用 network_mode：

version: '3.8'
services:frontend:image: frontend-appnetwork_mode: "host"backend:image: backend-servicenetwork_mode: "host"environment:- DB_HOST=localhost  # 宿主机本地服务可直接通过 localhost 访问redis:image: redisnetwork_mode: "host"command: redis-server --bind 0.0.0.0

---

3. 注意事项

• 端口冲突：
  Host 模式下容器直接使用宿主机端口，需避免端口重复绑定。例如，若宿主机已占用 80 端口，容器内的 Nginx 无需再配置 ports 。
• 服务发现：
  容器间可通过 localhost 或宿主机 IP 直接通信。例如，backend 服务可通过 http://localhost:3306 访问宿主机 MySQL 。
• 兼容性：
  部分 Docker 版本可能要求 Compose 文件版本不低于 3.8，否则会报错 。
• 安全性：
  Host 模式削弱了网络隔离性，建议仅用于性能敏感场景（如高频通信的微服务）。

---

4. 与自定义网络的对比

特性	Host 模式	自定义 Bridge 网络
网络性能	零开销，直接使用宿主机网络	存在 NAT 转换开销
端口管理	直接占用宿主机端口	需显式映射端口（ports）
服务发现	通过 localhost 或宿主机 IP	通过容器名称或别名（DNS 解析）
适用场景	高性能需求、短连接密集型应用	需要隔离和灵活端口管理的生产环境

---

5. 高级用法

• 混合网络模式：
  可部分服务使用 Host 模式，其他服务使用自定义网络：

  services:high_perf_service:network_mode: "host"internal_db:networks:- mynetnetworks:mynet:driver: bridge
  

• 调试工具：
  通过 docker exec 进入容器，验证网络接口是否与宿主机一致：

  docker exec -it web ip addr  # 应显示宿主机网卡信息
  

---

完整示例文件

version: '3.8'
services:nodejs:image: node:18network_mode: "host"volumes:- ./app:/appcommand: npm startprometheus:image: prom/prometheusnetwork_mode: "host"volumes:- ./prometheus.yml:/etc/prometheus/prometheus.yml

---

通过上述配置，可快速实现容器与宿主机网络的无缝集成，适用于需要低延迟和高吞吐量的场景（如实时数据处理、游戏服务器等）。如需进一步优化，可结合 extra_hosts 或环境变量动态配置服务地址 。