Python web实战 | Docker+Nginx部署python Django Web项目详细步骤【干货】

本文介绍: 在这篇文章中，我将介绍如何使用 Doc k e r 和 Ngin x 部署 Django We b 项目。一步步讲解如何构建 Doc k e r 镜像、如何编写 Doc ker Com pose 文件和如何配置 Ngin x。

在这篇文章中，我将介绍如何使用 Doc ker 和 Ngin x 部署 Django Web 项目。一步步讲解如何构建 Docker 镜像、如何编写 Docker Compose 文件和如何配置 Ngin x。

在开始之前，我们需要有一个 Django 项目。如果你还没有 Django 项目，可以按照 Django 官方文档的指导创建一个。我们将 Django 项目放在一个名为 myproject 的目录中。

接下来，我们需要编写 Dockerfile。Dockerfile 是用来构建 Docker 镜像的脚本。在 myproject 目录下创建一个名为 Dockerfile 的文件，并在其中添加以下内容：

# 基础镜像
FROM python:3.9

# 在容器中创建项目目录
RUN mkdir /code

# 设置工作目录
WORKDIR /code

# 将当前目录下的所有文件复制到容器中的 /code 目录
COPY . /code/

# 安装项目依赖
RUN pip install -r requirements.txt

在上面的 Dockerfile 中，我们首先指定 Pyt h on 3.9 作为基础镜像。然后在容器中创建一个名为 /code 的目录，并将当前目录下的所有文件复制到容器中的 /code 目录中。最后，我们安装项目所需的依赖。

现在我们可以使用 Dockerfile 来构建 Docker 镜像了。在 myproject 目录下打开终端，运行以下命令：

docker build -t myproject .

上面的命令将使用 myproject 目录下的 Dockerfile 构建一个名为 myproject 的 Docker 镜像。

docker run -it --rm -p 8000:8000 myproject

上面的命令将运行一个名为 myproject 的 Docker 镜像，并将容器的端口 8000 映射到主机的端口 8000。现在你可以在浏览器中访问 http://localhost:8000 来查看你的 Django 项目是否正常工作了。

在 myproject 目录下创建一个名为 docker-compose.yml 的文件，并在其中添加以下内容：

version: '3'

services:
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/code
    ports:
      - "8000:8000"
    environment:
      - DJANGO_SETTINGS_MODULE=myproject.settings
      - DATABASE_URL=postgres://postgres:postgres@db:5432/postgres

  db:
    image: postgres
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres

在上面的 Docker Comp ose 文件中，我们定义了两个服务：一个是 web 服务，另一个是 db 服务。web 服务是我们刚才构建的 Django Web 项目，db 服务是一个 PostgreSQL 数据库。

在 web 服务中，我们使用了 build 关键字来指定 Dockerfile 的路径。command 关键字用来指定容器启动时要运行的命令，这里我们运行 Django 的开发服务器。volumes 关键字用来将本地目录与容器内的目录进行映射，这样我们可以在本地编辑文件并在容器内运行它们。ports 关键字用来将容器内的端口映射到主机上的端口。environment 关键字用来设置环境变量，这里我们设置了 Django 的配置和数据库连接的 URL。

在 db 服务中，我们使用了 image 关键字来指定使用 PostgreSQL 官方镜像。environment 关键字用来设置 PostgreSQL 的用户名、密码和数据库名称。

docker-compose up

上面的命令将使用 docker-compose.yml 文件来构建和运行 Docker 镜像。在容器启动后，你可以在浏览器中访问 http://localhost:8000 来查看你的 Django 项目是否正常工作了。

在 myproject 目录下创建一个名为 nginx.conf 的文件，并在其中添加以下内容：

upstream web {
    server web:8000;
}

server {
    listen 80;

    location / {
        proxy_pass http://web;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

在上面的配置文件中，我们定义了一个名为 web 的 up stream，将其指向 Docker Compose 中的 web 服务。然后我们定义了一个 Nginx 服务器监听 80 端口。在 location 中，我们将请求代理到 up stream 中的 web 服务，并设置了 Host 和 X-Real-IP 头。

upstream web {
    server web:8000;
}

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://web;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

在 myproject 目录下创建一个名为 Dockerfile.nginx 的文件，并在其中添加以下内容：

# 基础镜像
FROM nginx:latest

# 删除默认配置文件
RUN rm /etc/nginx/conf.d/default.conf

# 将自定义配置文件复制到容器中的 /etc/nginx/conf.d/ 目录下
COPY nginx.conf /etc/nginx/conf.d/

在上面的 Dockerfile 中，我们首先指定 Nginx 最新版本作为基础镜像。然后我们删除默认的配置文件，并将我们编写的配置文件复制到容器中的 /etc/nginx/conf.d/ 目录下。

docker build -t myproject-nginx -f Dockerfile.nginx .

上面的命令将使用 Dockerfile.nginx 构建一个名为 myproject-nginx 的 Docker 镜像。

接下来，我们需要使用 Docker Compose 来启动 Nginx 服务。在 docker-compose.yml 中添加以下内容：

version: '3'

services:
  web:
    build: .
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .
    ports:
      - "8000:8000"
    environment:
      - DJANGO_SETTINGS_MODULE=myproject.settings
      - DATABASE_URL=postgres://postgres:postgres@db:5432/postgres

  db:
    image: postgres
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres

  nginx:
    build: .
    ports:
      - "80:80"
    depends_on:
      - web

在上面的 Docker Compose 文件中，我们定义了一个名为 nginx 的服务，使用之前编写的 Dockerfile.nginx 来构建 Docker 镜像。我们将容器的端口 80 映射到主机的端口 80，并且在 depends_on 中指定了 web 服务，这样 Nginx 就可以将请求代理到 web 服务中。

docker-compose up

上面的命令将使用 docker-compose.yml 文件来构建和运行 Docker 镜像。在容器启动后，你可以在浏览器中访问 http://localhost 来查看你的 Django 项目是否正常工作了，这时请求会被 Nginx 代理到 web 服务中。

为了让 Nginx 作为静态文件服务，我们需要在 nginx.conf 文件中添加以下内容：

upstream web {
    server web:8000;
}

server {
    listen 80;

    location /static/ {
        alias /code/static/;
    }

    location / {
        proxy_pass http://web;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

在上面的配置文件中，我们添加了一个名为 /static/ 的 location，并设置其别名为 /code/static/，这样 Nginx 就可以将静态文件服务到客户端了。

sudo certbot certonly --webroot --webroot-path=/code/static -d example.com

上面的命令将使用 webroot 插件来申请证书。--webroot-path 选项将 Certbot 配置为在指定目录下查找验证文件。-d 选项指定了你的域名。

最后，将以下内容添加到 nginx.conf 文件中：

upstream web {
    server web:8000;
}

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    location /static/ {
        alias /code/static/;
    }

    location / {
        proxy_pass http://web;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

在上面的配置文件中，我们定义了两个服务器：第一个服务器监听 80 端口，并将请求重定向到 443 端口；第二个服务器监听 443 端口，并使用 SSL 证书来启用 HTTPS 支持。ssl_certificate 和 ssl_certificate_key 分别指定了 SSL 证书和私钥的路径。

version: "3"

services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8000:8000"
    environment:
      - DJANGO_SETTINGS_MODULE=myproject.settings
      - DATABASE_URL=postgres://postgres:postgres@db:5432/postgres

  db:
    image: postgres
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres

  nginx:
    build:
      context: .
      dockerfile: Dockerfile.nginx
    ports:
      - "80:80"
      - "443:443"
    depends_on:
      - web
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./certbot:/etc/letsencrypt

在上面的 Docker Compose 文件中，我们添加了一个名为 nginx 的服务，并将其端口 443 映射到主机的端口 443，以支持 HTTPS。此外，我们将 /etc/nginx/nginx.conf 和 /etc/letsencrypt 目录挂载到主机上，以便在容器外部进行配置和证书的管理。

现在，你可以使用 Docker Compose 来构建和运行 Docker 镜像，并在浏览器中访问 https://example.com 来查看你的 Django 项目是否正常工作了。