如何在docker-compose.yml中配置host网络与端口，解决启动访问报错

问题根因分析 #

• Host网络模式下容器直接复用宿主机的网络命名空间，不需要也不能再配置端口映射（ports字段），二者功能互斥，所以同时配置就会触发host network_mode is incompatible with port_bindings报错。
• 注释端口后连接重置有两个核心原因：
  1. Python服务默认绑定127.0.0.1，Host模式下这个地址仅支持宿主机本地访问，外部机器请求会被直接拒绝
  2. 原有数据库连接配置用容器名classifier_db作为数据库地址，Host模式下没有Docker内置DNS解析，无法通过容器名访问服务

具体解决步骤 #

1. 调整docker-compose.yml配置 #

删除所有ports字段，给两个服务都配置Host网络模式，修改后配置如下：

services:
  classifier_backend:
    build:
      context: ./
      dockerfile: Dockerfile
    volumes: 
      - ./ADM/:/ADM/
    command: python main.py
    depends_on: 
      - classifier_db
    network_mode: host

  classifier_db:
    image: postgres:13-alpine
    environment: 
      POSTGRES_PASSWORD: postgres 
      POSTGRES_USER: postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    network_mode: host

volumes:
  postgres_data:

2. 修改Python服务监听地址 #

找到main.py中服务启动的代码，把绑定地址从127.0.0.1改为0.0.0.0：

• 若使用FastAPI+uvicorn：将uvicorn.run(app, host="127.0.0.1", port=8000)改为uvicorn.run(app, host="0.0.0.0", port=8000)
• 若使用Flask：将app.run(host="127.0.0.1", port=8000)改为app.run(host="0.0.0.0", port=8000)

3. 修改数据库连接配置 #

找到database.py中的数据库连接地址，把容器名地址改为127.0.0.1，示例修改：
原有配置：postgresql://postgres:postgres@classifier_db:5432/postgres
修改后：postgresql://postgres:postgres@127.0.0.1:5432/postgres

4. 重启服务 #

执行以下命令清理旧容器后重新启动：

docker-compose down -v
docker-compose up --build

启动完成后直接访问http://宿主机IP:8000即可正常访问服务。

内容的提问来源于stack exchange，提问作者Muhammad Daniyal