Django部署

前段时间，由于实验室项目的需要，要搭建一个web服务器，可怜我只会写python，所以就去研究了一下Django。学习Django是一个愉快的过程，本来就该如此嘛，Python提倡INTERESTING TO CODE，所以很快，我就完成了Django的本地部署，然而在把Django搭到服务器上的是，却是让我捣鼓了一个星期，真真是把我坑苦了。

---

1.我的环境

在把Django搭建到Apache上时候，首先你需要明确你使用的Django和Apache的版本，嗯，还有Python的版本（这很重要）！

很多人依照网上的教程，BALABALA的输入pip install Django、sudo apt-get install Apache2，改了Apache配置文件，调了Django的setting，最后弄完了发现一直不成功，对着命令和配置文件看了半天也没发现有什么错误，怎么就一直不行呢？很可能你一开始就错了呀！人家是Python2，你的是Python3；人家的是Apache2.2，你的是Apache2.4。底子都不一样，搭起来能用才怪，所以第一步，一定要清楚自己的环境，具体的说就是你使用的版本号！

如果你是看我的文章，从头开始安装的话，那么我建议你使用pip install Django==1.x来代替pip install Django，甚至在你安装pip的时候，我都建议你明确的指明是用python2或者python3来安装（现在大多数的云服务器都包含Py2和Py3两个版本）。

接下来，我告诉你我搭建的环境，我的配置都是在此环境基础上配置的，如果其他环境，我了解我也会提一句。

• OS: Ubuntu 14.04
• Apache: Apache2.4
  sudo apt-get install apache2 #安装Apache
apachectl -v #检查Apache版本，ubunt 14.04没经过其他设置，默认应该是Apache2.4
• Python: Python2
• Django: Django1.8
  pip install Django==1.8

---

2.建立Python与Apache的链接

简单的来说就是Apache如何识别你的Django代码。无论如何，你的Django都是用Python写的，所以不恰当的说法就是给你的Apache安装Python解释器。

  sudo apt-get install libapache2-mod-wsgi      #Python2
  sudo apt-get install libapache2-mod-wsgi-py3  #Python3

第一条是对于Python2用户的，第二条是对于Python3用户的。

如果你是Python2用户又恰巧不小心输入了第二条命令，那么不要怕，再输入第一条命令就好啦，同样的Python3也可以通过再输入第二条命令来重置Apache的Python解释器（这种说法不一定对，但是我相信你懂我意思！）！

---

3.为Django安家，让Apache找到它

大致可以分为四步：

1. 将Django工程放在/var/www/下；
2. sudo vi /etc/apache2/sites-available/yoursite.conf 修改配置文件；
3. sudo a2ensite yoursite.conf 配置文件生效；
4. sudo service apache2 restart 重启Apache。

Apache默认的网站目录是/var/www/。通常来说，如果你只是自己搭着玩玩也没有必要更改这个目录，直接就将你的Django工程文件夹放在这就行了。

如果你想要放在别处的话，可以通过修改/etc/apache2/apache2.conf中的<Directory /var/www>，将其改为<Directory /where/you/want>，不过配套的你需要修改其权限。具体的修改方法这里。

以上只是完成了为Django安家这一步，但是我们还需要让Apache找到Django（方便查水表）。

新建一个网站配置文件：

     sudo vi /etc/apache2/sites-available/yoursite.conf。

这里边包含了你所有的网站配置信息，包括Apache如何查找静态文件(js/css/images)，网站上传的文件存在哪里，最重要的，包含了Apache识别Django的wsgi文件。
#<VirtualHost *:80>
ServerName www.yourdomain.com
#ServerAlias otherdomain.com
#ServerAdmin youremail@gmail.com

# 存放用户上传图片等文件的位置，注意去掉#号
#Alias /media/ /var/www/ProjectName/media/ 
            
# 静态文件(js/css/images)的存放位置
Alias /static/ /var/www/ProjectName/static/                

# 允许通过网络获取static的内容
<Directory /var/www/ProjectName/static/>                  
    Require all granted
</Directory>

# 最重要的！通过wsgi.py让Apache识别这是一个Django工程，别漏掉前边的 /
WSGIScriptAlias / /var/www/ProjectName/ProjectName/wsgi.py     
# wsgi.py文件的父级目录，第一个ProjectName为Django工程目录，第二个ProjectName为Django自建的与工程同名的目录
<Directory /var/www/ProjectName/ProjectName/>                  
<Files wsgi.py>
    Require all granted
</Files>
</Directory>

</VirtualHost>

通过修改上面的文件，你就可以让Apache找到你的Django工程，上边可以修改的内容包括：

• 80：修改80为其他数字，可以更改你的端口号，国内的电信貌似把80端口给封了（如果你的域名没有备案的话）。注意，还要修改/etc/apache2/port.conf文件中的Listen *port*。
• ServerName：后边改成你自己的域名，如果没有的话就用IP代替。注意，如果改成了域名，还需要修改Django工程下的seeting.py文件，将其ALLOWED_HOSTS=[]改为ALLOWED_HOSTS=['www.yourdomain.com']，多个域名可以通过逗号隔开。
• ServerAlias：你的其他域名或IP。

最后要让这个配置文件生效，你需要运行

     sudo a2ensite yoursite.conf

有时候，你可能需要让它失效（因为你将yoursite.conf改名为其他名字？），可以运行

    sudo a2dissite yoursite.conf

做完以上步骤，Apache会提醒你要执行sudo service apache2 relaod，这条命令主要是你手动命令Apache根据你刚才配置的yoursite.conf去寻找Django工程，当然我一般都是restart，如果你的Apache不为其他的网站提供服务，那么你也restart吧，因为重启大法好！

每次你修改Django工程文件之后，都要restart一下，它才会生效。

---

4.修改Django的wsgi.py文件

修改上面说的/var/www/ProjectName/ProjectName/wsgi.py为如下格式

    import os
    from os.path import join,dirname,abspath
    PROJECT_DIR = dirname(dirname(abspath(__file__)))

    import sys
    sys.path.insert(0,PROJECT_DIR)
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "examsys.settings")

    from django.core.wsgi import get_wsgi_application
    application = get_wsgi_application()

这个配置文件的作用也是让Apache找到Djanog，毕竟不能一厢情愿吗，Apache同意和Django“交往”了，但是万一人家Django不乐意呢？
最后，还记得我说的嘛？

每次你修改Django工程文件之后，都要restart一下，它才会生效。

---

5.调试错误

1. 如果你的网站没有加载静态文件(js/css/images)，请检查你的静态文件是不是在ProjectName/static下，而不是在ProjectName/AppName/static下（改这里边的文件是不用重启Apache的）。
2. 不知道啥问题，就是不管用，请查看Apache的错误文档。
   cat /var/log/apache2/error.log
3. No module named xxxx。首先检查一下你所依赖的库是否安装全了，没有的话就pip install。
4. No module named django或者其他含django的错误。这说明你的环境搭错了。往上翻error.log，找到AH00489开头的错误，看看你到底用的是什么环境。一般都是你第二步Apache的Python解释器安装错误。

本文讲述部署的方法和常见的问题，并给出了在 BAE, SAE 等上面部署的实例。

如果不是在自己的服务器上部署，当开发完成后可以部署到 BAE, SAE, 也可以使用阿里云的服务器。

部署到BAE的例子：https://github.com/twz915/BAE_Django（实测，推荐）

部署到SAE的例子：https://github.com/twz915/django-sae（Fork smallcode同学的，没有测试过，SAE 有一定的免费份额）

Django + nginx + Gunicorn/uwsgi 部署方式，参见另一篇：Django 部署（nginx）

 

自己的服务器（比如用的阿里云服务器）请看下文：

如果是新手，个人推荐用ubuntu,除非你对linux非常熟悉，ubuntu服务器的优点：

一，开机apache2等都自动启动，不需要额外设置

二，安装软件非常方便 apt-get 搞定

三，安装ssh，git等也非常容易，几乎是傻瓜化

如果你在虚拟机或个人电脑中安装，也可以试试 Linux Mint, 它用起来更简单，和ubuntu兼容。

下面是ubuntu上的部署详细步骤：

1. 安装 apache2 和 mod_wsgi

1 2 3 4 5 6 7

sudo apt-get install apache2   # Python 2 sudo apt-get install libapache2-mod-wsgi   # Python 3 sudo apt-get install libapache2-mod-wsgi-py3

2. 确认安装的apache2版本号

1	apachectl -v

Server version: Apache/2.4.6 (ubuntu)

Server built:   Dec  5 2013 18:32:22

3. 准备一个新网站

ubuntu的apache2配置文件在 /etc/apache2/ 下

备注：centos 用户 apache 名称为 httpd 在 /etc/httpd/ 中（可以参考文章下面置顶的评论）

新建一个网站配置文件

1	sudo vi /etc/apache2/sites-available/sitename.conf

示例内容如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26

<VirtualHost *:80>     ServerName www.yourdomain.com     ServerAlias otherdomain.com     ServerAdmin tuweizhong@163.com        Alias /media/ /home/tu/blog/media/     Alias /static/ /home/tu/blog/static/        <Directory /home/tu/blog/media>         Require all granted     </Directory>        <Directory /home/tu/blog/static>         Require all granted     </Directory>        WSGIScriptAlias / /home/tu/blog/blog/wsgi.py     # WSGIDaemonProcess ziqiangxuetang.com python-path=/home/tu/blog:/home/tu/.virtualenvs/blog/lib/python2.7/site-packages     # WSGIProcessGroup ziqiangxuetang.com        <Directory /home/tu/blog/blog>     <Files wsgi.py>         Require all granted     </Files>     </Directory> </VirtualHost>

如果你的apache版本号是 2.2.x（第二步有方法判断）

用下面的代替  Require all granted

1 2	Order deny,allow Allow from all

备注：把上面配置文件中这两句的备注去掉，可以使用 virtualenv 来部署网站，当然也可以只写一个 /home/tu/blog

1 2	# WSGIDaemonProcess ziqiangxuetang.com python-path=/home/tu/blog:/home/tu/.virtualenvs/blog/lib/python2.7/site-packages     # WSGIProcessGroup ziqiangxuetang.com

4. 修改wsgi.py文件

注意：上面如果写了 WSGIDaemonProcess 的话，这一步可以跳过，即可以不修改 wsgi.py 文件。

上面的配置中写的 WSGIScriptAlias / /home/tu/blog/blog/wsgi.py

就是把apache2和你的网站project联系起来了

1 2 3 4 5 6 7 8 9 10 11

import os from os.path import join,dirname,abspath   PROJECT_DIR = dirname(dirname(abspath(__file__)))#3 import sys # 4 sys.path.insert(0,PROJECT_DIR) # 5   os.environ["DJANGO_SETTINGS_MODULE"] = "blog.settings" # 7   from django.core.wsgi import get_wsgi_application application = get_wsgi_application()

第 3，4，5 行为新加的内容，作用是让脚本找到django项目的位置，也可以在sitename.conf中做，用WSGIPythonPath,想了解的自行搜索, 第 7 行如果一台服务器有多个django project时一定要修改成上面那样，否则访问的时候会发生网站互相串的情况，即访问A网站到了B网站，一会儿正常，一会儿又不正常（当然也可以使用 mod_wsgi daemon 模式,点击这里查看）

5. 设置目录和文件权限

一般目录权限设置为 755，文件权限设置为 644 

假如项目位置在 /home/tu/zqxt （在zqxt 下面有一个 manage.py，zqxt 是项目名称）

1 2 3

cd /home/tu/ sudo chmod -R 644 zqxt sudo find zqxt -type d | xargs chmod 755

apache 服务器运行用户可以在 /etc/apache2/envvars 文件里面改，这里使用的是默认值，当然也可以更改成自己的当前用户，这样的话权限问题就简单很多，但在服务器上推荐有 www-data 用户，更安全。以下是默认设置：

1 2 3 4 5 6

# Since there is no sane way to get the parsed apache2 config in scripts, some # settings are defined via environment variables and then used in apache2ctl, # /etc/init.d/apache2, /etc/logrotate.d/apache2, etc.   export APACHE_RUN_USER=www-data export APACHE_RUN_GROUP=www-data

上传文件夹权限

media 文件夹一般用来存放用户上传文件，static 一般用来放自己网站的js，css，图片等，在settings.py中的相关设置

STATIC_URL 为静态文件的网址 STATIC_ROOT 为静态文件的根目录，

MEDIA_URL 为用户上传文件夹的根目录，MEDIA_URL为对应的访问网址

在settings.py中设置：

1 2 3 4 5 6 7 8

# Static files (CSS, JavaScript, Images) # https://docs.djangoproject.com/en/dev/howto/static-files/ STATIC_URL = '/static/' STATIC_ROOT = os.path.join(BASE_DIR,'static')   # upload folder MEDIA_URL = '/media/' MEDIA_ROOT = os.path.join(BASE_DIR,'media')

在 Linux 服务器上，用户上传目录还要设置给 www-data 用户的写权限，下面的方法比较好，不影响原来的用户的编辑。

假如上传目录为 zqxt/media/uploads 文件夹,进入media文件夹，将 uploads 用户组改为www-data，并且赋予该组写权限:

1 2 3

cd media/ # 进入media文件夹 sudo chgrp -R www-data uploads sudo chmod -R g+w uploads

备注：这两条命令，比直接用sudo chown -R www-data:www-data uploads 好，因为下面的命令不影响文件原来所属用户编辑文件，fedora系统应该不用设置上面的权限，但是个人强烈推荐用ubuntu,除非你对linux非常熟悉，你自己选择。

如果你使用的是sqlite3数据库，还会提示 Attempt to write a readonly database,同样要给www-data写数据库的权限

进入项目目录的上一级，比如project目录为 /home/tu/blog 那就进入 /home/tu 执行下面的命令（和修改上传文件夹类似）

1 2 3 4

sudo chgrp www-data blog sudo chmod g+w blog sudo chgrp www-data blog/db.sqlite3  # 更改为你的数据库名称 sudo chmod g+w blog/db.sqlite3

备注：上面的不要加 -R ,-R是更改包括所有的子文件夹和文件，这样不安全。个人建议可以专门弄一个文件夹,用它来放sqlite3数据库，给该文件夹www-data写权限，而不是整个项目给写权限，有些文件只要读的权限就够了，给写权限会造成不安全。

6. 激活新网站

1	sudo a2ensite sitename 或 sudo a2ensite sitename.conf

如果顺利，这样网站就搭建成功，访问你的网址试试看，如果出现问题就接着看下面的。

7. 错误排查

一，没有静态文件，网站打开很乱，没有布局，多半是静态文件没有生效。

1. 确保你的配置文件中的路径是正确的

2. 确保你的settings.py中的文件设置正确

3. 收集静态文件(详细静态文件部署教程）

1	python manage.py collectstatic

二，网站打开后报错

这时你可以把settings.py更改

1	DEBUG = True

重启服务器

1	sudo service apache2 restart

再访问网站 来查看具体的出错信息。

如果这样做还看不到出错信息，只是显示一个服务器错误，你可以查看apache2的错误日志

1	cat /var/log/apache2/error.log

根据错误日志里面的内容进行修正！

总结:

部署时文件对应关系:

sitename.conf --> wsgi.py --> settings.py --> urls.py --> views.py

扩展

明白了上面的关系, 一个 Django project 使用多个域名或让app使用子域名很简单,只要新建一个 wsgi.py 文件,更改里面对应的settings文件,新的settings文件可以对应新的urls.py,从而做到访问与原来不同的地址!

本文主要讲解 nginx + uwsgi socket 的方式来部署 Django，比 Apache mod_wsgi 要复杂一些，但这是目前主流的方法。

1. 运行开发服务器测试

1 2	cd zqxt # 进入项目 zqxt 目录 python manage.py runserver

运行开发服务器测试，确保开发服务器下能正常打开网站。

2. 安装 nginx 和 需要的包

2.1 安装 nginx 等软件

ubuntu / Linux Mint 等，下面简写为 (ubuntu):

1	sudo apt-get install python-dev nginx

 

centos / Fedora/ redhat 等，下面简写为 (centos)

1 2	sudo yum install epel-release sudo yum install python-devel nginx

2.2 安装 supervisor, 一个专门用来管理进程的工具，我们用它来管理 uwsgi 进程

1	sudo pip install supervisor

Ubuntu用户 请直接看 3，以下是CentOS 注意事项：

CentOS下，如果不是非常懂 SELinux 和 iptables 的话，为了方便调试，可以先临时关闭它们，如果发现部署了之后出不来结果，可以临时关闭测试一下，这样就知道是不是 SELinux 和 iptables 的问题

CentOS 7 iptables如何使用：http://stackoverflow.com/questions/24756240/

将 SELinux 设置为宽容模式，方便调试：

1	sudo setenforce 0

防火墙相关的设置：

1 2 3 4 5

可以选择临时关闭防火墙 sudo service iptables stop   或者开放一些需要的端口，比如 80 sudo iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT

上面的两条命令，如果是 CentOS 7 用

1 2 3 4 5 6

临时关闭防火墙 sudo systemctl stop firewalld   或者 开放需要的端口 sudo firewall-cmd --zone=public --add-port=80/tcp --permanent sudo firewall-cmd --reload

备注：由于我还没有用 最新版本的 Fedora ，新版 Fedora 需要用 dnf 来安装包，有需求的同学自测，可以参考这里。

3. 使用 uwsgi 来部署

安装 uwsgi

1	sudo pip install uwsgi --upgrade

使用 uwsgi 运行项目

1	uwsgi --http :8001 --chdir /path/to/project --home=/path/to/env --module project.wsgi

这样就可以跑了，--home 指定virtualenv 路径，如果没有可以去掉。project.wsgi 指的是 project/wsgi.py 文件

如果提示端口已经被占用:

1 2	probably another instance of uWSGI is running on the same address (:8002). bind(): Address already in use [core/socket.c line 764]

这时可以把相关的进程 kill 掉:

按照端口进行查询：

1	lsof -i :8002

可以查出：

1 2 3

COMMAND  PID USER   FD   TYPE             DEVICE SIZE/OFF NODE NAME uwsgi   2208   tu    4u  IPv4 0x53492abadb5c9659      0t0  TCP *:teradataordbms (LISTEN) uwsgi   2209   tu    4u  IPv4 0x53492abadb5c9659      0t0  TCP *:teradataordbms (LISTEN)

这时根据 PID 可以用下面的命令 kill 掉相关程序：

1	sudo kill -9 2208 2209

按照程序名称查询：

1	ps aux | grep uwsgi

补充内容：

使用 gunicorn 代替 uwsgi 的方法

1 2 3 4

sudo pip install gunicorn   在项目目录下运行下面的命令进行测试： gunicorn -w4 -b0.0.0.0:8001 zqxt.wsgi

-w 表示开启多少个worker，-b 表示要使用的ip和port，我们这里用的是 8001，0.0.0.0代表监控电脑的所有 ip。

如果使用了 virtualenv 可以这样

1	/path/to/env/bin/gunicorn --chdir /path/to/project --pythonpath /path/to/env/ -w4 -b0.0.0.0:8017 project.wsgi:application

用 --pythonpath 指定依赖包路径，多个的时候用逗号,隔开，如：'/path/to/lib,/home/tu/lib'

4. 使用supervisor来管理进程

安装 supervisor 软件包

1	(sudo) pip install supervisor

生成 supervisor 默认配置文件，比如我们放在 /etc/supervisord.conf 路径中：

1	(sudo) echo_supervisord_conf > /etc/supervisord.conf

打开 supervisor.conf 在最底部添加（每一行前面不要有空格，防止报错）：

1 2 3 4 5 6 7

[program:zqxt] command=/path/to/uwsgi --http :8003 --chdir /path/to/zqxt --module zqxt.wsgi directory=/path/to/zqxt startsecs=0 stopwaitsecs=0 autostart=true autorestart=true

command 中写上对应的命令，这样，就可以用 supervisor 来管理了。

启动 supervisor

1	(sudo) supervisord -c /etc/supervisord.conf

重启 zqxt 程序（项目）：

1	(sudo) supervisorctl -c /etc/supervisord.conf restart zqxt

启动，停止，或重启 supervisor 管理的某个程序 或 所有程序：

1	(sudo) supervisorctl -c /etc/supervisord.conf [start|stop|restart] [program-name|all]

以 uwsgi 为例，上面这样使用一行命令太长了，我们使用 ini 配置文件来搞定，比如项目在 /home/tu/zqxt 这个位置，

在其中新建一个 uwsgi.ini 全路径为 /home/tu/zqxt/uwsgi.ini

1 2 3 4 5 6 7 8 9 10 11 12 13

[uwsgi] socket = /home/tu/zqxt/zqxt.sock chdir = /home/tu/zqxt wsgi-file = zqxt/wsgi.py touch-reload = /home/tu/zqxt/reload   processes = 2 threads = 4   chmod-socket = 664 chown-socket = tu:www-data   vacuum = true

注意上面的 /home/tu/zqxt/zqxt.sock ，一会儿我们把它和 nginx 关联起来。

在项目上新建一个空白的 reload 文件，只要 touch 一下这个文件（touch reload) 项目就会重启。

注意：不建议把 sock 文件放在 /tmp 下，比如 /tmp/xxx.sock (不建议)！有些系统的临时文件是 namespaced 的，进程只能看到自己的临时文件，导致 nginx 找不到 uwsgi 的 socket 文件，访问时显示502，nginx 的 access log 中显示 unix: /tmp/xxx.sock failed (2: No such file or directory)，所以部署的时候建议用其它目录来放 socket 文件，比如放在运行nginx用户目录中，也可以专门弄一个目录来存放 sock 文件，比如 /tmp2/

1 2	sudo mkdir -p /tmp2/ && sudo chmod 777 /tmp2/ 然后可以用 /tmp2/zqxt.sock 这样的路径了

详细参考 http://stackoverflow.com/questions/32974204/got-no-such-file-or-directory-error-while-configuring-nginx-and-uwsgi

修改 supervisor 配置文件中的 command 一行：

1 2 3 4

[program:zqxt] command=/path/to/uwsgi --ini /home/tu/zqxt/uwsgi.ini directory=/path/to/zqxt startsecs=0

然后重启一下 supervisor：

1 2 3

(sudo) supervisorctl -c /etc/supervisord.conf restart zqxt 或者 (sudo) supervisorctl -c /etc/supervisord.conf restart all

5. 配置 Nginx

新建一个网站 zqxt

1	sudo vim /etc/nginx/sites-available/zqxt.conf

写入以下内容：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

server {     listen      80;     server_name www.ziqiangxuetang.com;     charset     utf-8;       client_max_body_size 75M;       location /media  {         alias /path/to/project/media;     }       location /static {         alias /path/to/project/static;     }       location / {         uwsgi_pass  unix:///home/tu/zqxt/zqxt.sock;         include     /etc/nginx/uwsgi_params;     } }

激活网站：

1	sudo ln -s /etc/nginx/sites-available/zqxt.conf /etc/nginx/sites-enabled/zqxt.conf

测试配置语法问题

1	sudo service nginx configtest 或 /path/to/nginx -t

重启 nginx 服务器：

1	sudo service nginx reload 或 sudo service nginx restart 或 /path/to/nginx -s reload

一些有用的参考教程：

Django 官网部署教程：

https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/gunicorn/

https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/uwsgi/

nginx 与 socket

http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configure-nginx-for-your-site

防火墙：

iptables: https://www.digitalocean.com/community/tutorials/how-to-setup-a-basic-ip-tables-configuration-on-centos-6

centos 7 FireWalld: http://stackoverflow.com/questions/24756240/how-can-i-use-iptables-on-centos-7

ubuntu ufw 防火墙：http://wiki.ubuntu.org.cn/Ufw%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97

uwsgi ini 配置文件：http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html#configuring-uwsgi-to-run-with-a-ini-file

转载自：https://www.jianshu.com/p/b40a4a12fff1
https://code.ziqiangxuetang.com/django/django-deploy.html
https://code.ziqiangxuetang.com/django/django-nginx-deploy.html