如何将Django项目拆分至多个Docker容器（使用SQLite3）

一、可行性确认 #

完全可行。SQLite是文件型数据库，虽不适合高并发场景，但个人博客这类低流量应用完全够用。核心通过Docker共享卷让Django容器读写同一个SQLite文件，同时用Nginx容器托管静态文件实现前后端分离。

二、具体实现步骤 #

1. 重构Docker Compose配置 #

修改docker-compose.yml，拆分出Django后端容器和Nginx前端容器，通过共享卷实现文件共享：

version: "3"

services:
  django:
    build: .
    volumes:
      # 共享数据库文件目录和静态文件目录
      - ./db:/code/db
      - ./static:/code/static
    # 仅在内部网络暴露端口，不对外直接开放
    expose:
      - "8000"
    command: ["python", "manage.py", "runserver", "0.0.0.0:8000"]

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      # 挂载静态文件到Nginx
      - ./static:/usr/share/nginx/html/static
      # 挂载自定义Nginx配置
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - django

2. 调整Django项目配置 #

在settings.py中更新数据库路径和静态文件配置：

# 数据库配置：指向共享卷中的db目录
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db' / 'db.sqlite3',
    }
}

# 静态文件配置
STATIC_URL = '/static/'
STATIC_ROOT = BASE_DIR / 'static'  # 用于收集静态文件的目录

3. 编写Nginx反向代理配置 #

创建nginx.conf文件，让Nginx处理静态文件并转发动态请求到Django：

server {
    listen 80;
    server_name localhost;

    # 静态文件直接由Nginx提供服务
    location /static/ {
        alias /usr/share/nginx/html/static/;
    }

    # 动态请求转发至Django容器
    location / {
        proxy_pass http://django:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

4. 优化Dockerfile（可选） #

在Dockerfile中加入收集静态文件的步骤，确保静态文件提前生成：

FROM python:3.12.3

ENV PYTHONUNBUFFERED=1

WORKDIR /code

COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .

# 收集静态文件到STATIC_ROOT目录
RUN python manage.py collectstatic --noinput

EXPOSE 8000

CMD ["python", "manage.py","runserver", "0.0.0.0:8000"]

5. 目录与权限准备 #

在项目根目录创建共享目录并设置权限：

mkdir db static
chmod 755 db static

6. 启动服务 #

执行命令构建并启动容器：

docker compose up --build

访问http://localhost即可，Nginx会自动分发静态请求和动态请求。

三、关键注意事项 #

• 适用场景：此方案仅适合低流量场景，高并发下SQLite会出现锁表问题，建议迁移至PostgreSQL等客户端-服务端数据库。
• 数据持久化：只要本地的db目录不被删除，数据库数据就会永久保留，不受容器销毁影响。
• 路径一致性：确保Docker Compose中的挂载路径与Django配置中的路径完全匹配，避免文件找不到的错误。

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