Docker容器端口映射与跨容器通信问题：FastAPI与MongoDB互联及本地访问

1. 创建自定义Docker网络 #

自定义网络是Docker容器间通信的标准方案，同一网络内的容器可通过容器名称直接解析通信，无需依赖宿主机网络。

docker network create app-network

2. 启动MongoDB容器并加入自定义网络 #

让MongoDB仅在自定义网络内提供服务（若无需本地直接连接MongoDB，可省略端口映射）：

docker run --rm --name mongo-db --network app-network mongo

如果需要本地也能连接MongoDB，保留端口映射即可（确保宿主机27017端口未被其他服务占用）：

docker run --rm --name mongo-db --network app-network -p 27017:27017 mongo

3. 修改FastAPI的MongoDB连接配置 #

在.env文件中，将MongoDB连接地址从localhost:27017替换为容器名称mongo-db:27017，例如：

MONGO_URI=mongodb://mongo-db:27017/your-target-db

同一自定义网络内，Docker会自动将容器名称解析为对应容器的IP地址。

4. 修正FastAPI的Dockerfile #

默认uvicorn仅监听容器内部的127.0.0.1，外部无法通过端口映射访问，需修改启动命令绑定到0.0.0.0：

CMD uvicorn api.main:app --host 0.0.0.0

重新构建FastAPI镜像：

docker build -t my-api .

5. 启动FastAPI容器并加入同一自定义网络 #

映射8000端口到宿主机，同时加入自定义网络以访问MongoDB容器：

docker run -it --env-file .env --network app-network -p 8000:8000/tcp my-api

问题根源说明 #

• --network=host模式：容器与宿主机共享网络栈，但在Windows/macOS的Docker Desktop环境中该模式实现有限，导致端口暴露不符合预期；且该模式下-p端口映射参数会被直接忽略，无法正常暴露8000端口。
• 无自定义网络时连接localhost:27017：容器内的localhost指向容器自身而非宿主机，因此无法访问宿主机上运行的MongoDB容器。
• 尝试映射27017端口到FastAPI容器：宿主机的同一端口不能被多个容器绑定，而MongoDB容器已占用27017端口，因此触发端口冲突报错。

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