容器化现有Django应用报错：runserver参数192.168.1.135:8000不被识别

1. 先明确错误根源 #

你遇到的manage.py runserver: error: unrecognized arguments: 192.168.1.135:8000，本质是启动命令的参数格式不对，Django的runserver没识别到正确的地址端口参数。

2. 修正启动命令格式 #

Django的runserver接受的地址端口格式是[addr]:[port]，正确写法要注意：

• 直接写完整的地址端口，比如python manage.py runserver 0.0.0.0:8000
• 不要把地址和端口拆成两个独立参数（比如192.168.1.135 8000）
• 不要给整个地址端口加多余的引号（避免shell解析出错）

3. 检查entrypoint.sh脚本 #

如果你的启动逻辑写在entrypoint.sh里，确保脚本内的启动命令格式正确：

#!/bin/sh
set -e

# 可选：执行数据库迁移等前置操作
python manage.py migrate

# 正确启动服务
python manage.py runserver 0.0.0.0:8000

给脚本加执行权限：chmod +x entrypoint.sh

4. 修正docker-compose.yml的command配置 #

如果是在docker-compose里指定启动命令，两种正确写法：

• 字符串形式：

services:
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    ports:
      - "8000:8000"
    # 其他配置（数据库、环境变量等）

• 数组形式（避免shell解析问题）：

services:
  web:
    build: .
    command: ["python", "manage.py", "runserver", "0.0.0.0:8000"]
    ports:
      - "8000:8000"

注意：不要把0.0.0.0:8000拆成0.0.0.0和8000两个独立数组元素，这会触发参数错误。

5. 容器网络适配要点 #

容器内部不要绑定宿主机的具体IP（比如192.168.1.135），因为容器网络和宿主机隔离，绑定0.0.0.0才能让服务接收外部请求，再通过docker-compose的ports映射把容器8000端口转到宿主机8000端口即可。

6. 验证settings.py配置 #

确保ALLOWED_HOSTS包含你的宿主机IP或域名，开发环境可以暂时用通配符：

ALLOWED_HOSTS = ['192.168.1.135', 'localhost', '0.0.0.0']
# 开发环境临时用：ALLOWED_HOSTS = ['*']

7. 适配Pipfile的Dockerfile参考 #

针对你的Pipfile环境，Dockerfile可以这么写：

FROM python:3.11-slim

WORKDIR /app

# 安装pipenv
RUN pip install --upgrade pip && pip install pipenv

# 复制依赖文件并安装
COPY Pipfile Pipfile.lock ./
RUN pipenv install --deploy --system

# 复制项目代码和入口脚本
COPY . .
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

ENTRYPOINT ["/entrypoint.sh"]

最后测试启动 #

修改完所有配置后，重新构建并启动：

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

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