如何将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 644 zqxt sudo find zqxt -type d -exec chmod 755 \{\} \;
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写权限,而不是整个项目给写权限,有些文件只要读的权限就够了,给写权限会造成不安全。