Podman Compose多实例服务端口冲突问题及解决方法咨询

问题根源 #

Docker Compose默认会为每个项目创建独立的网桥网络，每个容器拥有专属的网络命名空间，因此容器内部的5000端口可以重复使用而不冲突。但Podman Compose在部分环境下未自动创建隔离的网桥网络，导致所有容器直接绑定到宿主机的127.0.0.1:5000，引发端口占用冲突。

解决方案 #

方法1：使用自定义网桥网络（推荐） #

通过显式定义自定义网桥网络，强制Podman为容器创建隔离的网络环境，和Docker Compose的默认行为对齐。

修改后的docker-compose.yml：

version: '3.7'

networks:
  app-network:
    driver: bridge

services:
  back:
    build:
      context: .
    scale: 2
    networks:
      - app-network

  other-back:
    build:
      context: .
    networks:
      - app-network

配置完成后，每个容器会在app-network网桥内获得独立IP，容器内的5000端口可正常复用，服务之间通过服务名（如back、other-back）即可互相访问。

方法2：动态端口映射（需宿主机访问时用） #

如果需要将容器端口暴露给宿主机，避免固定端口冲突，可以让Podman自动分配宿主机端口：

修改后的docker-compose.yml：

version: '3.7'

services:
  back:
    build:
      context: .
    scale: 2
    ports:
      - "5000"

  other-back:
    build:
      context: .
    ports:
      - "5000"

启动后执行podman-compose ps，就能看到每个容器对应的宿主机随机端口（比如0.0.0.0:49153->5000/tcp），通过这些端口即可访问对应实例。

验证 #

启动服务后，执行podman inspect <容器ID>查看网络配置，确认容器处于独立的网络命名空间，而非直接使用主机网络。

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