django通过mod_wsgi在apache2上部署

2019年4月23日编辑 2 阅读量:219

将django项目部署在apache2.4.*上，可以进行如下步骤：
1、关闭模板Debug模式（DEBUG=False后，media、static都会交给apache2处理，settings中定义的STATIC_ROOT之类的就没什么用处，除了在生产环境必须做的collectstatic ，所以第3步很重要）
2、实现一个404、500、403模板，将模板放在模版根目录中
3、安装mod_wsgi:    sudo apt-get install libapache2-mod-wsgi
配置apache2的网站配置文件（在ubuntu下）：sudo vi /etc/apache2/sites-available/sitename.conf

```
<VirtualHost *:80>
    ServerName localhost
    # ServerAlias otherdomain.com
    # ServerAdmin 1029645297@qq.com
  
    # Alias 代表client访问该目录是，apache2进入服务器的真实目录内，跟你django项目中的views.py自己定义的上传目录无关，比如你在浏览器访问:http://localhost/static/ 就表明进入了服务器的/home/ctg/project/Blog/blog/static/内（可能会没提示没权限访问，看服务器那边怎么设置了，apache2默认的用户组为www-data，在/etc/apache2/envvars定义），但是访问：http://localhost/static时，网址会交给django的urls.py处理，'/'很重要
    Alias /media/ /home/ctg/project/Blog/blog/media/
    Alias /static/ /home/ctg/project/Blog/blog/static/
  
    //如果下面的media/少掉'/'的话，会导致media内的文件无法访问，用户头像如果上传到media目录，就无法在网页上显示
    <Directory /home/ctg/project/Blog/blog/media/>
        Require all granted
    </Directory>
  
    <Directory /home/ctg/project/Blog/blog/static/>
        Require all granted
    </Directory>
  
    WSGIScriptAlias / /home/ctg/project/Blog/blog_project/wsgi.py
   
    <Directory /home/ctg/project/Blog/blog_project>
    <Files wsgi.py>
        Require all granted
    </Files>
    </Directory>
</VirtualHost>
```
接着，修改/etc/apache2/apache2.conf， 在最后一行添加ServerName localhost:80
4、配置wsgi，注意wsgi的目录与apache2中的路径一致：

```
import os
import sys 
from os.path import join,dirname,abspath
 
PROJECT_DIR = dirname(dirname(abspath(__file__)))
sys.path.append(PROJECT_DIR) 
 
os.environ["DJANGO_SETTINGS_MODULE"] = "blog_project.settings" 
 
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()
```

5、设置文件、目录权限

```
# 项目名为Blog
cd /home/ctg/project
sudo chmod -R 644 Blog
sudo find Blog -type d -exec chmod 755 \{\} \;
sudo chmod -R 777 Blog/whoosh_index;
cd Blog/blog/media/ # 进入media文件夹
sudo chgrp -R www-data uploads # apache2 所属用户组为www-data
sudo chmod -R g+w uploads
```

注意，当nginx与apache2同时生效时，uwsgi一般是由当前用户创建进程，所以客户端上传的文件所属是当前用户，而apache2用www-data身份开启的进程，所以用户上传的文件所属是www-data。这点要注意

6、激活apache2配置

```
sudo a2ensite sitename.conf
```

如果激活了却没生效，进入/etc/apache2/site-enabled， 查看有多少个配置生效，只保留当前的就OK。
如果在部署的过程中，有意外的error，可以开启debug=True进行调试（比如，二维码功能报错，后面发现是qrcode所需要的pillow没有安装）
另外，注意文件的权限、用户，最好不要属于root

总的来说，一般过程是这样的：sitename.conf --> wsgi.py --> settings.py --> urls.py --> views.py

6、说明
```
    在部署后，碰到注册后却无法上传头像的错误。一开始以为是权限的问题，各种改权限，但并没有什么用。正确的做法是，首先，应该定位开启Debug，查看问题的原因。这里提示是目录不存在。
然后，定位apache2的工作流程:根据配置文件(/etc/apache2/sites-available/sitename.conf)，找到对应的wsgi，然后wsgi在找到进行处理，后面定位到目录在/home/ctg/project/Blog中（manage.py所在目录）
之后，尝试用绝对路径的方式，并且设置好权限，发现果然是那个目录，所以接下来根据那个目录来修改views.py文件就可以了。
ps:配置过程中可能要经常重启apache2，因为它没那么快生效。
```
   
```
    部署前，最好运行一下python manage.py collectstatic，否则admin页面可能显示不正常。
```

```bash
禁止apache2自启动的办法：
$ sudo update-rc.d apache2 disable  
```

django通过mod_wsgi在apache2上部署

附件: