浅谈Django+Gunicorn+Nginx部署之路

前言

最近，我已经成功将我的个人网站从 Flask 迁移到 Django 了，最早接触 Django 的时候大概是在 4 年前，我记得那个时候 Django 中的路由配置使用 正则 来进行的，但是我有特别烦这个东西，所以就果断弃坑了。然后今年年初的时候，我用 Flask 写了一个我的个人网站，刚开始的时候功能还是比较简单，看着路由配置和部署规则都很方便，就果断采用了。但是后来我想添加的功能越来越多的时候，我发现我已经越来越难掌控它了，正好最近我稍微看了一下 Django 这几年的变化，最新的 2.2 版本还是很不错的，路由规则和 Flask 已经一致了，所以我就重新入坑了。

目前我的个人网站基本功能已经迁移完毕。但是在部署的时候，我遇到了一些问题，在网上看了一些解决方法，要么太乱，要么太旧，个人觉得都已经不太适用了。所以在这里记录一下我的部署过程。

部署

网上有很多都是用 UWSGI 的方式来部署，但是我个人比较喜欢 Gunicorn，所以以下内容我只是记录了 Django + Gunicorn + Nginx 在 Ubuntu 上的部署方式相关内容。

步骤一

上传网站源码至目标服务器

由于我的源码是用 Github 来托管的，所以我直接执行下述命令来克隆我的网站源码到服务器即可。

git clone https://github.com/your-name/repo-name.git# 进入项目目录cd repo-name# 创建并激活虚拟环境python3 -m virtualenv venvsource venv/bin/activate# 安装项目依赖pip install -r requirements.txt

目前我的网站采用的相关依赖包如下：

autopep8Djangodjango-bootstrap4django-ckeditorgunicornMarkdownPillowpython-slugifyrequests

这里有个坑需要注意，如果你使用了 awesome-slugify，请尝试使用 python-slugify，因为有的服务器可能无法正常安装 awesome-slugify，具体 BUG 可参考：Clashes with python-slugify package。

步骤二

修改项目相关配置，并进行静态资源收集

由于我需要将我的网站部署到生产环境，所以我需要关闭 Django 的调试模式，并修改静态资源相关配置，示例配置如下所示：

settings.py

SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY')DEBUG = os.environ.get('DJANGO_DEBUG', False)TEMPLATE_DEBUG = os.environ.get('DJANGO_TEMPLATE_DEBUG', False)ALLOWED_HOSTS = ["*"]TEMPLATES = [  {    'BACKEND': 'django.template.backends.django.DjangoTemplates',    'DIRS': [os.path.join(BASE_DIR, 'templates')],    'APP_DIRS': True,    'OPTIONS': {      'context_processors': [        'django.template.context_processors.debug',        'django.template.context_processors.request',        'django.contrib.auth.context_processors.auth',        'django.contrib.messages.context_processors.messages',      ],    },  },]STATIC_URL = '/static/'STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')STATICFILES_DIRS = [  os.path.join(BASE_DIR, 'static'),]MEDIA_URL = '/media/'MEDIA_ROOT = os.path.join(BASE_DIR, 'media')

然后执行如下命令进行静态资源收集：

python manage.py collectstatic

之后，我还需要创建一个 Gunicorn 进程的相关配置，示例配置如下所示：

gunicorn.conf.py

# 安装# sudo pip3 install gunicornimport sysimport osimport loggingimport logging.handlersfrom logging.handlers import WatchedFileHandlerimport multiprocessingBASE_DIR = '/home/hippie/hippiezhou.fun/src'sys.path.append(BASE_DIR)LOG_DIR = os.path.join(BASE_DIR, 'log')if not os.path.exists(LOG_DIR):  os.makedirs(LOG_DIR)# 绑定的ip与端口bind = "0.0.0.0:8000"# 以守护进程的形式后台运行daemon = True# 最大挂起的连接数，64-2048backlog = 512# 超时timeout = 30# 调试状态debug = False# gunicorn要切换到的目的工作目录chdir = BASE_DIR# 工作进程类型(默认的是 sync 模式，还包括 eventlet, gevent, or tornado, gthread, gaiohttp)worker_class = 'sync'# 工作进程数workers = multiprocessing.cpu_count()# 指定每个工作进程开启的线程数threads = multiprocessing.cpu_count() * 2# 日志级别，这个日志级别指的是错误日志的级别(debug、info、warning、error、critical)，而访问日志的级别无法设置loglevel = 'info'# 日志格式access_log_format = '%(t)s %(p)s %(h)s "%(r)s" %(s)s %(L)s %(b)s %(f)s" "%(a)s"'# 其每个选项的含义如下：'''h     remote addressl     '-'u     currently '-', may be user name in future releasest     date of the requestr     status line (e.g. ``GET / HTTP/1.1``)s     statusb     response length or '-'f     referera     user agentT     request time in secondsD     request time in microsecondsL     request time in decimal secondsp     process ID'''# 访问日志文件accesslog = os.path.join(LOG_DIR, 'gunicorn_access.log')# 错误日志文件errorlog = os.path.join(LOG_DIR, 'gunicorn_error.log')# pid 文件pidfile = os.path.join(LOG_DIR, 'gunicorn_error.pid')# 访问日志文件，"-" 表示标准输出accesslog = "-"# 错误日志文件，"-" 表示标准输出errorlog = "-"# 进程名proc_name = 'hippiezhou_fun.pid'# 更多配置请执行：gunicorn -h 进行查看