django部署详细版教程（ubuntu+apache2+virtualenv)

阿里云高性能服务器2折起：点我购买

学生云服务器114/年：点我购买

在经历了无数的大坑后，终于按照网上一个比较简单的教程把自己的Blog做好了。后来在部署的时候又发现了无数的坑，于是有了这篇django部署教程，希望看到这篇教程的同学能少入坑，顺顺利利的部署成功自己的Blog。

希望同学们能认认真真看完此教程，我会尽我所能把每一步都讲的明白（虽然我也是个小白），下面让我们开始这坑爹而又有趣的部署之旅吧：

一、前提和环境

首先，本教程是假设你已经有了一个django项目且能在本机正常运行的外加一个可以正常使用的ubuntu。其次你可以不懂linux，因为照着教程走，不会有太大的问题，但最好有一点python和django基础。

环境：

python 3.4 （一般ubuntu自带py2和py3）

ubuntu-14.10-desktop、ubuntu-14.04-server（可以在win7下使用虚拟机）

django 1.7.1

apache 2.4.7

坑一：务必保持你的开发环境和我上述三个一样，否则可能会出现莫名其妙的问题，这是一个大坑。

二、入坑

virtualenv和django配置

1、首先ctrl+alt+t进入终端，然后我们安装python3-pip，pip类似ubuntu的apt-get可以方便的安装各种python库：

sudo apt-get install python3-pip


坑二：ubuntu默认安装py2和py3，终端输入“python”是py2环境，输入“python3”是py3环境。在ubuntu中如果想使用py3的pip请使用：“pip3”命令。“pip”命令为py2的，这点请注意。

2、安装python的虚拟环境virtualenv，virtualenv是一个可以虚拟多个python环境的东东，比如我的a网站是py2+django1.7开发，b网站是py3+django1.8开发。他们两个想共存于一台电脑上就要用到这个东东：

sudo pip3 install virtualenv


3、创建虚拟环境，此命令会创建一个名为venv的文件夹，位置就在你终端所显示的位置，里面包含了一个python环境。可以把它理解成类似与windows上的一个虚拟机系统，只不过他只是python的。

virtualenv venv


4、激活虚拟环境，相当于开启虚拟机系统，激活后，在这个激活的终端内执行的任何python命令都不会影响真实环境。注意如果你现在没有在venv的上级目录下，下面的命令是会报错的。可以用source后面跟完整的venv的路径。

source venv/bin/activate


5、安装django，到这里，就离最终成功迈出了关键的一步了，终于开始安装我们的主角django了，这里我安装的版本是1.7.1，安装前请再次确认你所开发的或者下载别人的django网站的版本和你安装的保持一致。

pip install -v django==1.7.1


小知识：在这里，我们使用pip而不是pip3的原因是虚拟环境里只有py3的存在，所以我们输入“python”和“pip”所关联的都会是py3的。你可以自己实验下在虚拟环境中输入是不会报错的，而在真实的环境里则会是显示py2。

6、安装所必须的python包，这里请根据你自己所开发的网站需要的包用“pip”进行安装，下面命令是我的blog所需要用到的包：

pip install django-ckeditor
pip install django-haystack
pip install whoosh
pip install jieba
pip install django-pagination-py3==1.1.1


坑三：安装分页插件pagination的时候，如果你是py3，请使用pip install django-pagination-py3==1.1.1命令安装，网上很多文章针对的都是py2的，当你用网上的命令安装这个插件后，在py3下是不会有效果的。

7、安装git，因为我是在server上面部署的，没有图形界面，所以我用git来下载我开发好的网站去部署就需要用到git了。git部分这里不再讲解，原因很简单，因为博主也不是很会啊！其实只要会上传到github然后会下载下来对于此文章来说就够了。如果你不是用的server版那就直接复制粘贴就更方便啦。（复制粘贴的请无视7和8条）

sudo apt-get install git


8、下载所需要的网站，这里我给出一个我的blog的源码，当然这也只是我做实验用的，你完全可以下载下来去学习，修改它。前提是你明白这是一个十分简陋的博客，仅供开发学习使用。

git clone https://github.com/juventusryp/test.git


坑四：如果你是新手刚开始学习django，下载下来后，请使用“mv test my_blog_2&＃8243;更改文件夹名字，会省去你很多麻烦。

9、初始化数据库，删除根目录下的数据库文件：db.sqlite3和article目录下的migrations文件夹。命令是“sudo rm -rf”加文件名。

然后运行下面的命令初始化数据库：

python manage.py migrate


初始化完毕后，建立后台管理员：

python manage.py createsuperuser


10、至此，一个网站应该是可以正常浏览了，请使用“python manage.py runserver”测试看是否可以正常浏览，如果正常，那么恭喜你，下面再只需要几步，就可以把你的网站部署到服务器上让大家都看到了。

二、部署部分

1、进入ubuntu，安装apache2和mod_wsgi：

sudo apt-get install apache2 libapache2-mod-wsgi-py3


坑五：此处如果你是py2开发的话去掉上述命令最后的“-py3”，否则最好加上。

2、查看apache2版本：

apachectl -v


看看是否是2.4.7版本

3、新建一个网站，这里是创建一个网站的配置文件，具体不再阐述，请自行学习apache的相关文档。

sudo vim /etc/apache2/sites-available/sitename.conf


我的sitename.conf如下，此文件仅作参考，请自行修改里面的相关路径和网址:


# The ServerName directive sets the request scheme, hostname and port that
# the server uses to identify itself. This is used when creating
# redirection URLs. In the context of virtual hosts, the ServerName
# specifies what hostname must appear in the request's Host: header to
# match this virtual host. For the default virtual host (this file) this
# value is not decisive as it is used as a last resort host regardless.
# However, you must set it for any further virtual host explicitly.
#ServerName www.example.com
ServerName localhost:80
ServerAlias otherdomain.com
ServerAdmin xxx@qq.com
Alias /media/ /home/user/my_blog_2/media/
Alias /static/ /home/user/my_blog_2/static/

Require all granted


Require all granted

WSGIDaemonProcess http://127.0.0.1:80 python-path=/home/user/my_blog_2:/home/user/venv/lib/python3.4/site-packages
WSGIProcessGroup http://127.0.0.1:80
WSGIScriptAlias / /home/user/my_blog_2/my_blog_2/wsgi.py


Require all granted


# Available loglevels: trace8, ..., trace1, debug, info, notice, warn,
# error, crit, alert, emerg.
# It is also possible to configure the loglevel for particular
# modules, e.g.
#LogLevel info ssl:warn
ErrorLog ${APACHE_LOG_DIR}/error-my_blog_2.log
CustomLog ${APACHE_LOG_DIR}/access-my_blog_2.log combined
# For most configuration files from conf-available/, which are
# enabled or disabled at a global level, it is possible to
# include a line for only one particular virtual host. For example the
# following line enables the CGI configuration for this host only
# after it has been globally disabled with "a2disconf".
#Include conf-available/serve-cgi-bin.conf

# vim: syntax=apache ts=4 sw=4 sts=4 sr noet


坑六; 如果在服务器上使用了虚拟环境，配置文档里加上下面三行应该才可以，这里网上很多文章都没有说清楚，当初坑了博主相当长时间。

WSGIDaemonProcess http://127.0.0.1:80 python-path=/home/user/my_blog_2:/home/user/venv/lib/python3.4/site-packages
WSGIProcessGroup http://127.0.0.1:80
WSGIScriptAlias / /home/user/my_blog_2/my_blog_2/wsgi.py


4、修改wsgi文件，我的路径就是/home/user/my_blog_2/my_blog_2/wsgi.py 请找到你的路径修改如下：

"""
WSGI config for my_blog_2 project.
It exposes the WSGI callable as a module-level variable named ``application``.
For more information on this file, see
https://docs.djangoproject.com/en/1.7/howto/deployment/wsgi/
"""
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["DJANGO_SETTINGS_MODULE"] = "my_blog_2.settings"
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()


是不是已经有点看不下去了？不要急，到最后一步了，坚持一下。完成下面的，我们的部署坑之路就算走完了。

5、设置权限，linux下对权限很敏感，建议大家先对这块有所了解。博主就不是很懂，所以很多地方都是根据log来一步一步调试的。

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

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

cd media/
sudo chgrp -R www-data uploads
sudo chmod -R g+w uploads


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

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

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


坑七：如果你是用我的test的网站学习，应该还会有些小问题，比如在写好文章发布的时候会报错，那是因为有个插件的权限问题，请打开debug模式，修改那个插件所在文件夹的权限即可。

6、纳尼！不是说已经可以正常访问了吗，怎么还有！博主保证下面一定是最后一步

切换到目录：/etc/apache2/sites-available/ 运行：

sudo service apache2 reload
sudo a2dissite 000-default && sudo a2ensite sitename.conf
sudo service apache2 restart


如果一切顺利，你的网站就可以通过域名（当然前提是请解析到你的服务器）或者ip来访问了

PS：如果你有任何不懂的地方，欢迎给我留言，我会尽力解答。

其实博主也真的是个小白，希望能有更多的小白来一起交流python，交流django。