Docker Compose怎样让服务使用host网络模式

Docker Compose 中让某个服务使用 host 网络，核心配置只有一处：把 network_mode: host 写在目标服务下面，并删除这个服务的 ports。这样容器会共享宿主机的网络命名空间，应用监听的端口直接就是宿主机端口；它不再拥有独立的容器 IP，也不能依赖 Compose 默认网络里的服务名解析。

官方地址：https://docs.docker.com/

先判断 host 模式是否适合这个服务

Compose 默认给项目创建 bridge 网络，同一网络里的服务可以通过服务名互相访问，端口映射负责把容器端口暴露给宿主机。network_mode: host 会改变这两个前提：服务直接使用宿主机网络栈，没有单独的容器 IP，服务名 DNS 也不再是可靠的访问入口。

因此，host 模式更适合网络监控、需要处理大量端口或必须直接访问宿主机 TCP/UDP 端口的场景。如果只是希望浏览器访问一个 Web 服务，继续使用默认 bridge 网络和 ports 通常更清晰，也更容易隔离端口。

第1步：进入服务级网络设置

打开项目根目录的 compose.yaml，沿着“项目文件 → services → 目标服务 → 网络设置”找到要改的服务。这里的关键是服务级字段，不是顶层 networks；只改目标服务，其他服务仍可留在 Compose 默认网络中。

在编辑器中看到目标服务后，先记录它原来使用的端口和依赖关系。特别要确认：应用自身会监听哪个宿主机端口，以及是否还有其他服务要通过服务名访问它。

第2步：写入 network_mode 并删除 ports

把 network_mode 放在目标服务的同一层级。下面的 metrics 只是示例服务名，镜像名和端口请换成自己的实际值：

services:
  metrics:
    image: your-registry/metrics:stable # 替换成实际镜像，服务本身监听 8000
    network_mode: host # 让容器共享宿主机网络命名空间
    # host 模式下不要再写 ports，应用监听的 8000 就是宿主机端口
    restart: unless-stopped # 主进程退出后按需要自动拉起

不要把下面两种写法混在一起：

services:
  metrics:
    network_mode: host # 只能保留一种网络模式
    # ports:             # 不能与 host 模式同时声明端口映射
    #   - "8000:8000"

Compose 文件规范明确要求 network_mode: host 时不要配置 ports；host 模式已经让进程直接占用宿主机网络端口，继续写映射既没有意义，也可能导致 Compose 报错。

第3步：渲染配置后再启动服务

先让 Compose 把最终配置渲染出来，再启动目标服务。下面的命令只检查配置结构并启动服务，不需要为 host 模式额外增加端口参数：

# 在包含 compose.yaml 的项目目录执行，先展开并检查服务配置
docker compose config

# 只启动目标服务；host 模式下不使用 -p 或 ports 映射
docker compose up -d metrics

# 查看服务是否处于运行状态
docker compose ps metrics

进入下一步前，界面上应能看到服务已经启动，配置中保留了 network_mode: host，并且没有为该服务生成端口映射行。应用实际监听的端口由进程自己的配置决定，例如它监听 0.0.0.0:8000 时，宿主机也应直接使用 8000 端口。

第4步：按平台和访问方式排查不生效

启动时报端口映射错误

回到“compose.yaml → services → 目标服务 → ports”，删除残留的 ports。不要用改宿主机端口的方式绕开冲突，因为 host 模式没有端口映射层；如果宿主机端口已经被其他进程占用，应修改应用监听端口或停止占用者。

服务之间突然不能用服务名访问

host 服务不再像默认 bridge 服务那样依赖 Compose 的服务名 DNS。需要访问另一个容器时，应重新设计两者的网络连接方式；如果目标只是普通的服务间通信，把该服务改回默认网络通常比硬套 host 更合适。

Docker Desktop 上配置了却没有效果

Linux Docker Engine 可以直接使用 host 网络。Docker Desktop 则需要在“Settings → Resources → Network → Enable host networking → Apply & restart”开启对应能力；功能未开启时，不要把桌面环境的表现当成 Linux 上的结果。

什么时候应该回退到 bridge

如果服务需要独立端口映射、需要用服务名发现数据库，或者希望保留容器网络隔离，就删除 network_mode: host，恢复 ports 和默认 bridge 网络。设置排错的最后一步不是坚持某个模式，而是让网络模型与服务的真实需求一致。

常见问题

host 模式还需要写 ports 吗？

不需要。应用监听的端口直接位于宿主机网络命名空间中，Compose 的端口映射不再承担作用；同一服务应删除 ports。

host 模式能不能和 networks 一起写？

不要这样组合。network_mode 决定服务采用的网络模型，普通 Compose 网络字段解决的是另一种接入方式；需要服务名 DNS 时，使用默认 bridge 或自定义网络。