Docker Compose 中配置 Host 网络模式

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

1. 基础配置示例

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

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

  api:
    image: my-api:latest
    network_mode: "host"
    depends_on:
      - web

2. 多服务协同配置

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

version: '3.8'
services:
  frontend:
    image: frontend-app
    network_mode: "host"

  backend:
    image: backend-service
    network_mode: "host"
    environment:
      - DB_HOST=localhost  # 宿主机本地服务可直接通过 localhost 访问

  redis:
    image: redis
    network_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. 与自定义网络的对比

5. 高级用法

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

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

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

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

完整示例文件

version: '3.8'
services:
  nodejs:
    image: node:18
    network_mode: "host"
    volumes:
      - ./app:/app
    command: npm start

  prometheus:
    image: prom/prometheus
    network_mode: "host"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml

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