如何将Django部署到Apache服务器上

操作环境：

• Ubuntu 16.04
• Apache 2.4
• Django 1.9
• Python 2.7
• mod_wsgi

---

 前言：本教程纯自己查阅资料后整理，望对大家有帮助！

1. 安装 mod_wsgi

这里默认大家已经会如何安装 Apache、Django、Python 了，直接教如何安装mod_wsgi。

需知：网上有很多用mod_python的，但是mod_python部署的方式在django的1.4及1.4之前是可以的，但是从django1.5开始，废弃了这种方式，django官网推荐使用wsgi方式，也就是我们用的mod_wsgi。

官方声明如下：

If you’re new to deploying Django and/or Python, we’d recommend you try mod_wsgi first. In most cases it’ll be the easiest, fastest, and most stable deployment choice.

安装：

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

官方文档：http://flask.pocoo.org/docs/0.10/deploying/mod_wsgi/

2. 建立一个Django工程

我们在 /var/www 下创建文件夹 mysite，然后键入mysite文件夹

cd /var/www

创建Django工程，我们命名为:testproject

django-admin startproject testproject

我的目录：（因为我的项目名是wangcwblog，所以就没做更改，如果按照教程来是testproject）

3. 修改Apache配置文件

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

新建一个网站配置文件：

sudo vi /etc/apache2/sites-available/testdjango.conf
#testdjango.conf名字可以随意换，这里为了直观

内容如下：

<VirtualHost *:80>
ServerName www.yourdomain.com
#ServerAlias otherdomain.com
#ServerAdmin youremail@gmail.com 

# 存放用户上传图片等文件的位置，注意去掉#号
#Alias /media/ /var/www/wangcwblog/media/

# 静态文件(js/css/images)的存放位置
#Alias /static/ /var/www/wangcwblog/collected_static/

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

# 最重要的！通过wsgi.py让Apache识别这是一个Django工程，别漏掉前边的 /
WSGIScriptAlias / /var/www/wangcwblog/wangcwblog/wsgi.py
# wsgi.py文件的父级目录，第一个ProjectName为Django工程目录，第二个ProjectName为Django自建的与工程同名的目录
<Directory /var/www/wangcwblog/wangcwblog/>
<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 testdjango.conf

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

sudo a2dissite testdjango.conf

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

4. 修改Django的wsgi.py文件

上面的配置中写的 WSGIScriptAlias 就是把apache2和你的网站Django project联系起来了。

切换到我们刚刚建立的django项目目录：

cd /var/www/wangcwblog

编辑 testproject/wsgi.py 文件：

sudo vi wangcwblog/wsgi.py

内容：

import os
import sys
from os.path import join,dirname,abspath
from django.core.wsgi import get_wsgi_application

PROJECT_DIR = dirname(dirname(abspath(__file__)))

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

application = get_wsgi_application()

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

6. 调试错误

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解释器安装错误。

这里根据可根据提示重启Apache，此时已经成功，访问云服务器的公网IP，或者打开本地IP（127.0.0.1）可以看到如下界面：

表示Django工程已经成功与Apache链接~~~

7. 设置目录和文件权限

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

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

cd /home/tu/
sudo chmod -R  zqxt
sudo find zqxt -type d -exec chmod  \{\} \;

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

# 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中设置：

# 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，并且赋予该组写权限:

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 执行下面的命令（和修改上传文件夹类似）

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写权限，而不是整个项目给写权限，有些文件只要读的权限就够了，给写权限会造成不安全。

---

以上皆参考涂伟忠老师的自强学堂，我自己搭建Django+Apache2时的心得，如果还不明白，可以去自强学堂看看。