Docker运行Docker Hub拉取的Django项目镜像无法自启动问题排查

镜像没有配置容器启动时的默认执行命令，容器启动后不会自动运行Django服务，所以直接执行docker run时服务不会启动。你进入交互式终端手动执行启动命令能跑，说明镜像本身的文件、依赖都没问题，只是缺启动步骤配置。

方案1：修改Dockerfile配置默认启动命令（最推荐，一次配置后续无需额外参数） #

在项目的Dockerfile末尾添加以下配置，重新构建推送镜像后，直接执行docker run -p 8000:8000 你的镜像名即可自动启动服务：

# 先确认工作目录是manage.py文件所在的路径，和你手动执行命令时所在目录保持一致
WORKDIR /your/django/project/path
# 用exec格式配置启动命令，保证进程信号能正常传递
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

注意：必须指定监听地址0.0.0.0:8000，不能用默认的127.0.0.1，否则宿主机无法通过映射端口访问容器内服务。

方案2：启动容器时直接追加启动命令 #

如果不想重新构建镜像，可以在docker run命令末尾直接加上启动指令，覆盖镜像默认启动逻辑：

docker run -p 8000:8000 你的镜像名 python manage.py runserver 0.0.0.0:8000

执行后容器会直接启动Django服务，不需要进入交互式终端手动操作。

方案3：通过YAML文件配置（适合多服务编排场景） #

可以编写docker-compose.yml配置文件实现启动逻辑，示例配置如下：

version: '3.8'
services:
  django-service:
    image: 你从Docker Hub拉取的镜像地址
    ports:
      - "8000:8000"
    command: python manage.py runserver 0.0.0.0:8000
    # 按需补充环境变量、目录挂载、依赖服务等配置即可

配置完成后在文件所在目录执行docker-compose up -d，就能自动创建并启动容器。

• 不要把CMD的exec格式参数写成整串，错误写法CMD ["python manage.py runserver 0.0.0.0:8000"]会导致命令执行失败，必须把命令和每个参数拆成数组单独元素
• 配置前确认工作目录正确，否则启动时会报找不到manage.py的错误
• 生产环境不建议直接用runserver启动服务，建议搭配gunicorn/uwsgi部署

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