使用Docker Python SDK创建多个Chrome容器时报端口已被占用错误

使用Python Docker SDK批量创建多个基于selenium/standalone-chrome的容器时，已按容器序号递增宿主机侧的映射端口值，程序运行到第二个容器创建环节抛出宿主机端口绑定冲突的错误。

该端口绑定冲突的核心原因是对Docker SDK的ports参数格式定义理解偏差，键值顺序写反了：

• Docker SDK containers.run()方法要求的ports参数字典格式为 {容器内部服务端口: 宿主机侧绑定配置}
• 原代码中传入的ports={5550+i:4444}，实际运行时的含义是：将容器内部的5551/5552端口，绑定到宿主机的4444端口
• 两个容器启动时都尝试占用宿主机的4444端口，第一个容器绑定成功后，第二个容器启动时自然触发端口已分配的报错，和日志中Bind for 0.0.0.0:4444 failed: port is already allocated的错误描述完全匹配

除此之外代码还存在几处可触发运行异常的问题：

• pull_image方法内部直接引用了未定义的全局client变量，没有使用实例初始化时创建的self.client对象，调用该方法时会直接抛出变量未定义错误
• 主流程中没有在创建容器前主动调用镜像拉取逻辑，完全依赖本地已存在的镜像文件运行，本地无对应镜像时会直接执行失败
• 容器创建后立即读取日志的逻辑，没有等待容器进入运行状态，在容器启动异常时会抛出空值引用错误

• 调整端口映射字典的键值顺序，匹配Docker SDK的参数要求，实现预期的“宿主机递增端口 → 容器内部4444 Selenium服务端口”的映射关系
• 修复pull_image方法的变量引用问题，统一使用实例初始化时创建的Docker客户端对象
• 调整执行流程，在批量创建容器前先完成基础镜像的拉取
• 补充容器状态等待逻辑，避免读取日志时因为容器未启动抛出异常

import docker, sys

class CreateContainer:
    def __init__(self):
        self.client = self.create_client()

    @staticmethod
    def create_client():
        # 从环境变量初始化Docker客户端
        return docker.from_env()

    def pull_image(self, image_name):
        # 修复：使用实例自带的client对象拉取镜像
        image = self.client.images.pull(image_name)
        print(f"拉取镜像完成：{image.name}")

    def create_containers(self, image, container_name, expose_port):
        # 端口格式调整：{容器内端口: 宿主机绑定端口}
        container = self.client.containers.run(
            image,
            name=container_name,
            hostname=container_name,
            ports=expose_port,
            detach=True,
            auto_remove=False
        )

        # 等待容器进入运行状态后再读取日志
        container.wait(condition="running")
        for line in container.logs().decode("utf-8").splitlines():
            print(line)
        return container


if __name__ == '__main__':
    threads = int(sys.argv[1])
    c_obj = CreateContainer()
    # 创建容器前先拉取基础镜像
    target_image = "selenium/standalone-chrome"
    c_obj.pull_image(target_image)
    for i in range(1, threads + 1):
        host_port = 5550 + i
        # 正确的端口映射：容器4444端口 → 宿主机5551/5552端口
        c_obj.create_containers(
            target_image,
            f"Chrome_{i}",
            expose_port={4444: host_port}
        )

完成修复后，执行python test.py 2即可正常创建两个独立Chrome容器，分别可通过宿主机5551、5552端口访问对应容器内的Selenium服务，不再触发端口绑定冲突。

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