部署 Django

阅读: 56491 评论：21

补充说明：关于项目部署，历来是开发和运维人员的痛点。造成部署困难的主要原因是大家的Linux环境不同，这包括发行版、解释器、插件、运行库、配置、版本级别等等太多太多的细节。因此，一个成功的部署案例，往往很难移植到别的环境下，总是要填许多坑。那么，别人的案例就没有参考价值了么?当然不是，部署的过程其实就是参考很多的成功案例，摸索出自己适用的方式！这过程中需要什么？熟练的Linux技能是最基本的！一些部署的经验和灵活的思维也是要有的。不惧怕满屏的英文错误信息，能从中抓住问题的耐心更是要有的。

鉴于以上原因，我在这一节并没有介绍得太详细，因为多说多错。但肯定是一个成功的案例，不能说你按照我的方案没有部署成功，那么我这个就是错误的，这有失偏颇。

那么有没有比较好的大家都能用起来的部署方案呢？Docker了解一下！

基本概念

首先介绍一些Django部署的基本概念。

本节不涉及ASGI部署，在前面的章节有介绍，其实两者类同。

Django 的主要部署的方式是 WSGI，它是 Web 服务器和 Web 应用的 Python 标准，也是所谓的同步服务和默认服务。

Django支持：

Gunicorn
uWSGI
Apache
Nginx

它们可以混搭。个人推荐Nginx配合uWSGI。

`application` 对象

用 WSGI 部署的关键是一个叫做application 的可调用对象，应用服务器用它与你的代码交互，是所有请求的接口和入口。

application 一般位于一个 Python 模块中，以名为 application 的对象的形式出现，且对服务器可见。

我们使用startproject 命令创建项目时会自动创建 /wsgi.py文件，其中就包含了 application 对象，直接使用即可。Django 开发服务器和生产环境的 WSGI 部署都使用它。

WSGI 服务器从其配置文件中获取 application 对象的路径。Django 的开发服务器（ runserver ），从配置项 WSGI_APPLICATION 中获取。默认值是 .wsgi.application，指向 /wsgi.py 中的 application 。

配置 settings 模块

当 WSGI 服务器（uWSGI、Gunicorn等）加载应用时，Django 需要导入配置模块。

Django 利用 DJANGO_SETTINGS_MODULE 环境变量来决定使用哪个settings.py模块，它的值是一个圆点路径字符串。开发环境和生产环境可以配置不同的settings.py。

若未设置该变量， wsgi.py 默认将其设置为 your_site.settings， your_site 即工程名字。

注意：由于环境变量是进程级的，所以如果在同一进程运行多个 Django 站点将出错。为了避免此问题，可以为每个站点使用 mod_wsgi 的daemon模式。或者在 wsgi.py 中强制设置 os.environ["DJANGO_SETTINGS_MODULE"] = "mysite.settings" ，重写来自环境变量的值。

WSGI 中间件

如果你想使用WSGI 中间件，可以如下将原来的application包裹起来：

from helloworld.wsgi import HelloWorldApplication
application = HelloWorldApplication(application)

部署架构

本节将重点介绍基于下面的架构部署Django：

Python3.8 + ubuntu 16.04 + Nginx + uWSGI + Django3.1

首先，你得有一台ubuntu机器，真实物理机和虚拟机都行，如果是阿里云ECS主机并且带有独立公网IP，那是最好不过。

我这里和大家一样，什么都没有，只有虚拟机，囧。

至于如何安装ubutun、Python3.8和Django3.1，不是本节的内容，请自行解决。下面我假定你已将安装好了这三者。

在部署之前请务必按照部署清单检查完毕后，收集静态文件和媒体文件，并将DEBGU设置为False。

一、安装Nginx

我不太推荐Apache2，偏爱Nginx。

Ubuntu默认源里面的Nginx版本比较旧，需要先添加一个Nginx的源，再通过apt-get安装Nginx。

sudo add-apt-repository ppa:nginx/stable
apt-get update
apt-get install nginx

一般这个都没问题，Nginx是居家必备软件，各家Linux下都可以顺利安装。

使用service --status-all命令查看一下，安装好后，服务应该会自动启动：

......
 [ + ]  network-manager
 [ + ]  networking
 [ + ]  nginx
 [ + ]  ondemand
 [ - ]  plymouth
 [ - ]  plymouth-log
......

如果能看到带+号的nginx，表明一切ok！

然后，通过ifconfig，查看一下你的ubuntu虚拟机的ip地址，我这里是192.168.1.121。使用同一局域网内的主机，通过浏览器访问192.168.1.121，如果能看到下面的界面，说明Nginx服务正常。

二、安装uWSGI

Django的主要部署平台是WSGI，它也是Python的标准web服务器和应用。

uWSGI是实现了WSGI协议的WSGI服务器。

uWSGI 是一个快速的、自我驱动的、对开发者和系统管理员友好的应用容器服务器，完全由 C 编写。

uWSGI的官网地址：https://uwsgi-docs.readthedocs.io/en/latest/index.html

根据血和泪的经验教训，请确保安装的是最新版本的uwsgi，否则可能出现各种坑。

所以不建议使用：pip3 install uwsgi(不一定是最新版)

不建议使用：pip install https://projects.unbit.it/downloads/uwsgi-lts.tar.gz(也不一定是最新版)

而是建议到https://uwsgi-docs.readthedocs.io/en/latest/Download.html页面，下载Stable/LTS版本的源文件。

为什么要最新版？因为现在的官方教程和相关技术文章全是以新版编写的，很多参数名，用法有较大改变。用旧版，你可能连跑都跑不起来。

我这里下载的是uwsgi-2.0.14.tar.gz，可能等到你看到此文时，已经不是最新的了。

在ubuntu中，解压源码，然后指定安装位置，将uWSGI 安装好：

# 解压文件
tar -zxvf uwsgi 

# 进入解压目录
sudo python3 setup.py install

注意！注意！一定要注意！如果你使用了虚拟环境，那么你必须使用虚拟环境的Python解释器安装uWSGI！！！也就是说，你的Django代码使用的哪个Python解释器，你的uWSGI服务器也必须使用同一个解释器。

安装完毕后，尝试运行一下uwsgi：

[feixue@feixue-VirtualBox: ~/soft]$ uwsgi
*** Starting uWSGI 2.0.14 (64bit) on [Wed Dec 20 22:41:46 2017] ***
compiled with version: 5.4.0 20160609 on 20 December 2016 12:48:11
os: Linux-4.4.0-101-generic #124-Ubuntu SMP Fri Nov 10 18:29:59 UTC 2017
nodename: feixue-VirtualBox
machine: x86_64
clock source: unix
detected number of CPU cores: 2
current working directory: /home/feixue/soft
detected binary path: /usr/local/bin/uwsgi
!!! no internal routing support, rebuild with pcre support !!!
*** WARNING: you are running uWSGI without its master process manager ***
your processes number limit is 15648
your memory page size is 4096 bytes
detected max file descriptor number: 1024
lock engine: pthread robust mutexes
thunder lock: disabled (you can enable it with --thunder-lock)
The -s/--socket option is missing and stdin is not a socket.

虽然运行出错了，但至少表明你的uWSGI在系统可执行命令路径中。

如果出现找不到命令的提示，那么建议创建一个指向/usr/local/bin目录的软链接。这些都是Linux管理员的业务领域，不展开介绍了。

需要提醒大家注意的是权限的问题，该sudo的时候要sudo。还有读写权限，看看当前用户是否具备相关文件的读写能力。很多时候部署失败，都不是Python和Django层面的原因，而是你的Linux管理业务还不够熟练。

三、配置uwsgi

软件安装好了后，首先是要拷贝项目代码。

因为我这里是在Windows下使用Pycharm编写的代码，不是在ubuntu虚拟机内编写的代码，所以需要将项目文件先整体拷贝到虚拟机中。（当然，最佳的方式是通过Pycharm进行远程开发。堡垒机视频中有教学。）

这个过程，也是八仙过海，各有奇招，我就当你将项目文件拷贝过去了。

在项目的根目录下，也就是有manage.py的目录下，新建一个uwsgi.ini文件。文件名可以随便，但后缀必须是ini。

在里面写入下面的配置内容：

[uwsgi]
chdir = /home/feixue/python/www/for_test    //项目根目录
module = for_test.wsgi:application     //  指定wsgi模块下的application对象
socket = 127.0.0.1:8000         //对本机8000端口提供服务
master = true                   //主进程

# 以上4个是核心配置项

#vhost = true          //多站模式
#no-site = true        //多站模式时不设置入口模块和文件
#workers = 2           //子进程数
#reload-mercy = 10
#vacuum = true         //退出、重启时清理文件
#max-requests = 1000
#limit-as = 512
#buffer-size = 30000
#pidfile = /var/run/uwsgi9090.pid    //pid文件，用于下脚本启动、停止该进程
daemonize = /home/feixue/python/www/for_test/run.log    // 日志文件
disable-logging = true   //不记录正常信息，只记录错误信息

详细说明：

配置项中以‘#’开头的都是被注释的项目，不起作用；
以双斜杠开头，表示注释；
chdir是你的项目根目录。我这里的项目名叫for_test；
moudule是你的入口wsgi模块，将for_test替换成你的项目名称；
socket是通信端口设置，和我一样就行；
master=True表示以主进程模式运行；
demonize是你的日志文件，会自动建立
disable-logging = true 表示不记录正常信息，只记录错误信息。否则你的日志可能很快就爆满了。
env：指定DJANGO_SETTINGS_MODULE的值
home：可选的项目虚拟环境路径

也可以通过命令参数的方式，不过就显得复杂可不可修改了：

uwsgi --chdir=/path/to/your/project \
    --module=mysite.wsgi:application \
    --env DJANGO_SETTINGS_MODULE=mysite.settings \
    --master --pidfile=/tmp/project-master.pid \
    --socket=127.0.0.1:49152 \      # can also be a file
    --processes=5 \                 # number of worker processes
    --uid=1000 --gid=2000 \         # if root, uwsgi can drop privileges
    --harakiri=20 \                 # respawn processes taking more than 20 seconds
    --max-requests=5000 \           # respawn processes after serving 5000 requests
    --vacuum \                      # clear environment on exit
    --home=/path/to/virtual/env \   # optional path to a virtual environment
    --daemonize=/var/log/uwsgi/yourproject.log      # background the process

四、配置Nginx

uWSGI设置好了，就配置一下Nginx。

备份/etc/nginx/sites-available文件夹内的default文件，然后编辑它（不同的Nginx版本可能配置方法不一样）：

##
# You should look at the following URL's in order to grasp a solid understanding
# of Nginx configuration files in order to fully unleash the power of Nginx.
# http://wiki.nginx.org/Pitfalls
# http://wiki.nginx.org/QuickStart
# http://wiki.nginx.org/Configuration
#
# Generally, you will want to move this file somewhere, and start with a clean
# file but keep this around for reference. Or just disable in sites-enabled.
#
# Please see /usr/share/doc/nginx-doc/examples/ for more detailed examples.
##

# Default server configuration
#
server {
    listen 80;
    listen [::]:80;

    # SSL configuration
    #
    # listen 443 ssl default_server;
    # listen [::]:443 ssl default_server;
    #
    # Note: You should disable gzip for SSL traffic.
    # See: https://bugs.debian.org/773332
    #
    # Read up on ssl_ciphers to ensure a secure configuration.
    # See: https://bugs.debian.org/765782
    #
    # Self signed certs generated by the ssl-cert package
    # Don't use them in a production server!
    #
    # include snippets/snakeoil.conf;

    # root /var/www/html;

    # Add index.php to the list if you are using PHP
    # index index.html index.htm index.nginx-debian.html;

    server_name 192.168.1.121;

    location / {
        # First attempt to serve request as file, then
        # as directory, then fall back to displaying a 404.
        # try_files $uri $uri/ =404;
        include  uwsgi_params;
                uwsgi_pass  127.0.0.1:8000;  
    }
    location /static {

    alias /home/feixue/python/www/for_test/static;
    }
    # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
    #
    #location ~ \.php$ {
    #   include snippets/fastcgi-php.conf;
    #
    #   # With php7.0-cgi alone:
    #   fastcgi_pass 127.0.0.1:9000;
    #   # With php7.0-fpm:
    #   fastcgi_pass unix:/run/php/php7.0-fpm.sock;
    #}

    # deny access to .htaccess files, if Apache's document root
    # concurs with nginx's one
    #
    #location ~ /\.ht {
    #   deny all;
    #}
}


# Virtual Host configuration for example.com
#
# You can move that to a different file under sites-available/ and symlink that
# to sites-enabled/ to enable it.
#
#server {
#   listen 80;
#   listen [::]:80;
#
#   server_name example.com;
#
#   root /var/www/example.com;
#   index index.html;
#
#   location / {
#       try_files $uri $uri/ =404;
#   }
#}

关键是这一部分：

server {
    listen 80;

    listen [::]:80;

    server_name 192.168.1.121;

    location / {
        include  uwsgi_params;
        uwsgi_pass  127.0.0.1:8000;  
    }

    location /static {
        alias /home/feixue/python/www/for_test/static;
    }
}

请将server_name改成你的实际IP。include uwsgi_params一定要一样。uwsgi_pass和你uWSGI配置中的socket要一样。location /static的alias改成你的实际情况，让静态文件得以部署。

修改完毕，保存退出，然后重启nginx服务：

sudo service nginx restart

五、启动服务

下面我们可以尝试启动服务了！进入项目的根目录，也就是有uwsgi.ini文件的地方，运行：

sudo uwsgi uwsgi.ini

系统提示：

[uWSGI] getting INI configuration from uwsgi.ini

到主机浏览器中访问‘192.168.1.121’，却看见下面的错误提示页面：

DisallowedHost at /
Invalid HTTP_HOST header: '192.168.1.121'. You may need to add '192.168.1.121' to ALLOWED_HOSTS.
Request Method: GET
Request URL:    http://192.168.1.121/
Django Version: 1.11.3
Exception Type: DisallowedHost
Exception Value:    
Invalid HTTP_HOST header: '192.168.1.121'. You may need to add '192.168.1.121' to ALLOWED_HOSTS.
Exception Location: /usr/local/lib/python3.5/dist-packages/django/http/request.py in get_host, line 113
Python Executable:  /usr/local/bin/uwsgi
Python Version: 3.5.2
......

不要被它们吓到！很多人都不愿意仔细看错误信息，其实解决办法，人家已经提示得非常清楚了，需要在ALLOWED_HOSTS配置项目中添加'192.168.1.121'。

进入相应目录，编辑settings.py文件：

DEBUG = False

ALLOWED_HOSTS = ['192.168.1.121']

同时将DEBUG设置为False。

在ubuntu中，运行下面的命令：

sudo killall -9 uwsgi

这会删除先前的uWSGI进程。

过几秒，一定要过几秒，数5下，然后：

sudo uwsgi uwsgi.ini

为什么要过几秒？因为端口释放有延迟啦。

再次在浏览器中访问192.168.1.121，看到欢迎信息则说明部署成功了。

上面的信息是因为我配置了一条url和一个简单的视图：

# 根urls.py

from django.urls import path
from django.contrib import admin
from app1 import views

urlpatterns = [
    url('admin/', admin.site.urls),
    url('', views.index),
]

# app1/views.py

from django.shortcuts import HttpResponse

def index(request):

    return HttpResponse("恭喜你，成功部署了DJango！")

到此一个基本的Django项目就部署好了。

contenttypes框架实战一：基于Django2.2可重用登录与注册系统

评论总数： 21

点击登录后方可评论

老师您好，小白请问项目部署必须进行在 linux 环境下吗？如果项目很简单不复杂，是否可以直接在 Windows 环境下进行部署？

By 用户4025215504 On 2023年1月24日 20:03 回复

我看过最简洁明了的教程。太感谢了

By 用户7368033275 On 2021年11月10日 12:01 回复

老师您好，完成后在浏览器中访问得到的是Internal Server Error，是什么原因呢？

By SENGEL666 On 2021年2月3日 20:13 回复

你好，如果我想把整个django，部署到服务器域名子目录下面，例如：abc.com/shop/django，然后admin在 abc.com/shop/django/admin，这样需要怎样配置呢？我是在nginx里面，将shop/django开头的请求，转发到了127.0.0.1:8000，但是由于django里面页面之间、admin的css、login，都需要去访问shop/django开头的url资源了，找不到，导致失败了。谢谢！

By powersite On 2020年6月13日 16:32 回复

你好，我对nginx不太熟悉，请教一下，上面uwsgi配置的端口是8000，nginx的端口是80，这样对吗？不应该是保持一致的吗？

By BigBoySunshine On 2020年2月26日 12:42 回复

又搞了一下，跑起来了，端口的问题大概明白了，nginx的端口是针对公网的，uwsgi的是本机的，

BigBoySunshine 回复 BigBoySunshine 2020年2月26日 16:22 回复

刘老师，您好。如果项目部署在客户的离线数据中心，不想源码暴露给客户，有啥保护的方法吗？谢谢！

By jenkin1227 On 2019年11月27日 12:09 回复

没有，Python本身就是开源的。所以，最好不是卖软件拷贝，而是卖服务。

博主回复 jenkin1227 2019年11月27日 13:30 回复

老师，您好。请教一个白痴的问题。Windows下用pycharm写的项目可以部署到Linux服务器吗？

By 落花流水_本无意 On 2019年11月26日 12:00 回复

当然可以。甚至可以通过pycharm，使用ssh直接基于Linux开发和部署!

博主回复落花流水_本无意 2019年11月26日 16:26 回复

谢谢老师、早上重新梳理下您以前关于Linux环境搭建的过程、结合这节Django部署的内容终于在云服务器上部署好了。谢谢☺

落花流水_本无意回复博主 2019年11月27日 10:11 回复

能分享一下你的笔记么？微信：Jiabcdefh

AI悦创回复落花流水_本无意 2021年2月22日 23:00 回复

十分感谢江哥，学习了很多特来评价一下，成功部署上线

By 我是一颗小草72661 On 2019年11月12日 21:05 回复

自己琢磨了好久没搞成功过，看完本文之后恍然大悟！！才从坑里爬出来，终于搞成功了！

By PJ狗 On 2019年10月19日 16:14 回复

用了1年的时间断断续续再看刘江老师的这个博客，看了很多遍，也把小实验跟着做了好几次。但是脱离了这些东西总是有种秀才提笔忘字的感觉。知道框架和步骤，说不出其中的细节。直到我把这个网页上的内容全部打印下来通背了好几边。很多事情觉得都是信手捏来。

By 用户6464458407 On 2019年6月17日 15:06 回复

其实我在这里有讲过学习方法http://www.liujiangblog.com/blog/30/ 核心观点就是和你一样的四个字：死记硬背

博主回复用户6464458407 2019年6月17日 16:57 回复

做小程序后端也参考了这个，很简洁。在uwsgi的使用，以及如何设置更合理的日志记录，这个还需要再研究。

By Veyron_Rui On 2018年12月8日 11:48 回复

文明发言

By 博主 On 2018年11月6日 08:49 回复

https://www.cnblogs.com/wcwnina/p/8728430.html

By 蔷薇-Nina On 2018年6月4日 23:40 回复

Python3 + Nginx + Django 1.11 + Gunicorn + Ubuntu16.04 部署项目会不会简单一点呢?

By piaomiao93 On 2018年1月16日 17:52 回复

这个建议也不错

蔷薇-Nina 回复 piaomiao93 2018年11月4日 22:03 回复