转载自：https://blog.csdn.net/qq_15028721/article/details/129298393

前言

Django程序有很多方式部署，不同系统采取的方式也不一样。使用gunicorn启动Django的服务可以提高并发能力。

一、Gunicorn是什么？

Gunicorn是一个 Python 的 WSGI HTTP 服务器。它所在的位置通常是在反向代理（如 Nginx）和一个 web 应用（如django）之间，支持eventlet也支持greenlet。

Gunicorn启动项目之后一定会有一个主进程Master和一个或者多个工作进程。工作进程的数量可以指定。工作进程是实际处理请求的进程。主进程维护服务器的运行。

二、Gunicorn基本使用

1.引入库

代码如下（示例）：

# gunicorn是python库,根据参数不同,需要导入的库会有差别

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple gunicorn 

2.常用命令

gunicorn安装后，可以在命令行使用gunicorn的相关命令，gunicorn -h 可以看到全部命令参数和对应注释（英文）。命令及配置后边会用到，配置的内容有很多，参考Gunicorn-配置详解。

gunicorn -h # 查看gunicorn的命令参数

gunicorn -v # gunicorn的版本

3.gunicorn快速启动

-w：是workers参数配置的简写

-b：是bind参数配置简写

projectname是项目目录中的项目文件，与manage.py同级

cd django项目目录（目录包含manage.py和projectname目录）

gunicorn -w 4 -b 127.0.0.1:8000 projectname.wsgi:application

三、基于配置和服务Gunicorn启动django

1.创建gunicorn_config.py文件

在gunicorn -h命令中，参数配置很多，根据项目不同参数的使用也有差距，可以想象参数多的情况下，gunicorn 命令会很长。gunicorn 中有一个参数-c，这个参数允许我们编写config.py配置文件，通过命令gunicorn -c config.py启动。

为了方便与其他文件区分，配置文件名字为gunicorn_config.py，位置为django项目目录，与manage.py同级。

代码如下（示例）：

# -*- coding:utf-8 _*-

"""

@author:lenovo

@file: gunicorn_config.py

@time: 2023/3/2  9:57

"""

import os

import multiprocessing

bind = '127.0.0.1:8000'  # 指定监听的地址和端口，用于nginx转发

backlog = 2048  # 服务器中排队等待的最大连接数，建议值64-2048，超过2048时client连接会得到一个error。

workers = multiprocessing.cpu_count() * 2 + 1  # 用于处理工作的进程数，这里使用了文档建议的值

worker_class = 'gthread'  # worker进程的工作方式，有sync、eventlet、gevent、tornado、gthread, 缺省值sync, django使用gthread的方式好一些。

worker_connections = 1000  # 最大客户端并发数量，默认情况下这个值为1000。此设置将影响gevent和eventlet工作模式

threads = int(480 / workers)  # 数据库连接数=workers*threads*2

timeout = 60  # 访问超时时间，默认30s

graceful_timeout = 60  # 接收到restart信号后，worker可以在graceful_timeout时间内，继续处理完当前requests。

keepalive = 2  # server端保持连接时间，默认情况下值为2。一般设定在1~5秒之间。

limit_request_line = 4094  # HTTP请求行的最大大小，默认值为4094。范围是0~8190,此参数可以防止任何DDOS攻击

limit_request_fields = 100  # 限制HTTP请求中请求头字段的数量,默认值为100，范围是0~32768,此参数可以防止任何DDOS攻击

limit_request_field_size = 8190  # 限制HTTP请求中请求头的大小，默认值为8190

reload = False  # 代码更新时不重启项目

daemon = False  # Gunicorn是否为守护进程（后端进程），默认为False

# max_requests = 1000  # 有内存泄露时使用此选项重启work

# max_requests_jitter = 50  # 重启work的抖动幅度，一般设置为max_requests的5%

pidfile = '/tmp/gunicorn.pid'  # pid文件的文件名

# keyfile = '.../server.key'  # ssl证书密钥文件路径

# certfile = '.../server.crt'  # ssl证书文件路径

accesslog = '-'  # 访问日志文件路径，'-'表示输出到终端

access_log_format = '%(t)s %(h)s "%(r)s" %(s)s %(b)s "%(f)s" "%(L)s"'  # 访问日志文件格式

errorlog = '/tmp/gunicorn.log'  # 错误日志文件路径，'-'表示输出到终端

# loglevel = '-'  # 错误级别，debug(调试)、info(信息)、warning(警告)、error(错误)、critical(危急)

pythonpath = '/home/ubuntu/anaconda3/bin/python -u'  # 逗号分隔的Python执行路径，可以加上参数，这里只有一个路径，-u表示使用无缓冲的二进制终端输出流

project_name = 'Discern'

proc_name = 'gunicorn_%s' % project_name  # 设置进程名称

os.environ.setdefault('DJANGO_SETTINGS_MODULE', '%s.settings' % project_name)  # 设置环境变量指定Django运行使用的配置文件

os.environ.setdefault('WERKZEUG_RUN_MAIN', 'true')  # 设置环境变量告诉wekzeug这个是用于reload的主进程

2.创建gunicorn.service文件

在Linux系统，我们可以创建自己的服务来管理我们的配置，我们需要创建gunicorn.service文件。

文件位置与gunicorn_config.py同级。

这里有几个参数需要注意，User和Group应使用当前登录的linux用户和组，WorkingDirectory是django项目目录，ExecStart是步骤1中的参数启动命令。

代码如下（示例）：

[Unit]

Description=gunicorn daemon

After=network.target

[Service]

Type=simple

pidfile=/tmp/gunicorn.pid

User=ubuntu

Group=ubuntu

RuntimeDirectory=gunicorn

WorkingDirectory=/opt/Mercury/Discern/

ExecStart=/home/ubuntu/anaconda3/bin/gunicorn -c /opt/Mercury/Discern/gunicorn_config.py Discern.wsgi:application

ExecReload=/bin/kill -s hup $mainpid

ExecStop=/bin/kill -s quit $mainpid

PrivateTmp=true

[Install]

WantedBy=multi-user.target

三、Django项目一键部署

1.创建nginx.conf文件

nginx.conf的位置为django项目目录，与manage.py同级。

代码如下（示例）：

server{

    listen 80;

    listen [::]:80;

    server_name xxx.com;

    # rewrite ^(.*)$ https://$host$1 permanent;

    location / {

        proxy_pass http://127.0.0.1:8000;

        proxy_http_version 1.1;

        proxy_redirect off;

        # 后端的Web服务器可以通过X-Forwarded-For获取用户真实IP;

        proxy_set_header Host $host;

        proxy_set_header X-Real-IP $remote_addr;

        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

    }

}

2.创建deploy.sh文件

deploy.sh的位置为django项目目录，与manage.py同级。

代码如下（示例）：

#! /bin/bash

cd /opt/django项目/ && git pull && python3 manage.py makemigrations && python3 manage.py migrate && sudo systemctl restart gunicorn && sudo systemctl restart nginx

3.Linux部署Django项目

gunicorn_config.py、gunicorn.service、nginx.conf、deploy.sh4个文件需要与项目一同上传git，便于后期更新和修改。

3.1 通过ssh连接至linux服务器

参考：通过SSH连接到Linux服务器

3.2 linux安装git、nginx

sudo apt update && sudo apt upgrade -y  # 软件一键升级至最新

sudo apt install git nginx

git --version

nginx -v

3.3 通过git clone 将代码拉取到/opt/目录

cd /opt

git clone https://xx.git

pip3 install xx # 创建项目的环境，安装python三方库

# django 项目git更新和数据库更新命令已写入deploy.sh文件

3.4 通过软连接建立gunicorn服务

pip3 install gunicorn

sudo rm /etc/systemd/system/gunicorn.service

sudo ln -s /opt/Mercury/Discern/gunicorn.service /etc/systemd/system/gunicorn.service

服务建立后可以使用3个命令管理gunicorn，启动命令已写入deploy.sh文件

sudo systemctl start gunicorn # 启动

sudo systemctl enable gunicorn # 暂停

sudo systemctl status gunicorn  # 查看状态

3.5 通过软连接配置nginx

sudo ln -s /opt/Mercury/Discern/nginx.conf /etc/nginx/conf.d/nginx.conf

可以使用3个命令管理nginx服务，启动命令已写入deploy.sh文件

sudo systemctl start nginx # 启动

sudo systemctl enable nginx  # 暂停

sudo systemctl status nginx   # 查看状态

3.6 通过软连接建立sh一键更新

sudo ln -s /opt/Mercury/Discern/deploy.sh /home/ubuntu/deploy.sh

通过1-6的相关配置，后期git代码更新后，我们只需要ssh用户登录后，一条sh deploy.sh命令即可实现django项目一键更新。(更新的时候需要输入git账户密码和ssh用登陆密码)

3.7 sh一键更换django分支项目

我们平时使用git都会有很多分支，常见分支是master和develop，一般情况下，master分支是线上版本分支，develop是开发或测试分支。我们可以修改deploy.sh文件，实现测试服务和线上服务的一键更新或分支切换。主需要更改git pull 命令。

代码如下（示例）：

#! /bin/bash

cd /opt/django项目/ && git pull origin develop:develop&& git checkout develop && python3 manage.py makemigrations && python3 manage.py migrate && sudo systemctl restart gunicorn && sudo systemctl restart nginx

总结

使用gunicorn部署django程序有很多方式，本片博客是本人用的比较多的方式，一键更新主要是为了节省时间