nginx+uwsgi部署Django项目到Ubuntu服务器全过程,以及那些坑!!!
body, td { font-family: 微软雅黑; font-size: 12pt }
前言:自己在windows上用PyCharm编写的Django项目,编写完后在windows上运行一点问题都没有,但是部署到服务器上时却Bug百出。百度,CSDN,sf,各种搜索寻求解决方案在历时3天后终于让它在服务器上与在windows的运行效果一样了。看了各种博客后得出的一个结论是:过期教程害死人!!!所以在写博客的时候一定要写上自己的开发环境(尤其是各种软件的版本)
我的环境:
nginx 1.10.3
uwsgi 2.0.18
Django 2.0
python 3.6
部署服务器:阿里云轻量应用服务器 Ubuntu16.04
注:Django1.8前后版本有很大差别;python2与python3有很大差别;Ubuntu系统与Centos系统命令行有些差别。
前提条件:Django项目能在windows上正常运行,有一个Ubuntu服务器(我的是云服务器)。
步骤: 1,在windows下迁移自己python虚拟环境的包
2,把自己的项目以及备份的包发送到Ubuntu服务器上
3,Ubuntu上Python环境的安装
4,安装配置uwsgi
5,安装配置nginx
6,静态文件404问题
7,图片能加载,但是CSS样式丢失问题
8,可能出现的错误,以及解决方法和注意事项
1,在windows下迁移自己python虚拟环境的包
说明:这一步主要是可以一次性把你在windows下的python包安装到ubuntu上。
激活环境:如果你开发时使用了virtualenv虚拟环境(推荐使用),首先用命令行进入到虚拟环境下的 Scripts目录下,输入:activate;如果没有用虚拟环境则不需要激活。
备份python包:在命令行输入:pip freeze >myPackage.txt # 这个操作会在你的python环境下生成一个myPackage.txt文件,里面记录了你这个环境的所有python包名和版本号。
2,把自己的项目以及备份的包发送到Ubuntu服务器上
说明:如果是用的xShell和xFTP会更方便,这里不使用。
迁移项目:把myPackage.txt从python环境目录下移到项目的根目录下。
在cmd下输入:scp -r <D://MyProject> root@39.108.123.114:/usr/MyProject/ # <D://MyProject>是项目的根目录;root是服务器的用户名;39.108.123.114是你服务器的公网IP;/usr/MyProject/ 是ubuntu服务器上的文件位置;
会提示输入你的Ubuntu登录密码,密码正确后就会开始发送。
3,Ubuntu上Python环境的安装
说明:Ubuntu16.04上会自带Python2.7和Python3.5,千万不要把Python2.7删了,因为Ubuntu系统还会用到Python2.7。
安装Python3.6: wget http://www.python.org/ftp/python/3.6.4/Python-3.6.4.tgz # 下载Python3.6压缩包
tar -xvzf Python-3.6.4.tgz # 解压
cd Python-3.6.4 # 进入到解压后的文件
./configure –with-ssl # 执行配置文件
make
sudo make install # 安装
python3 # 检验python版本。
使用virtualenv(强烈推荐):pip virtualenv # 安装
virtualenv -p python3 MyEnv # 创建虚拟环境,并指定python版本
激活虚拟环境: cd MyEnv/bin
source activate # 激活环境(注:以下步骤都是在这个虚拟环境下进行的)
deactivate # 退出环境
迁移包:先进入到myPackage.txt所在的目录,然后输入:pip instatll -r myPackage.txt # 安装myPackage.txt中记录的所有包。
到这里你的Python环境就算安装好了!
验证:进入到项目的根目录下,输入:python manage.py runserver 0.0.0.0:80 # 运行你的项目。如果是阿里云服务器,一定要检查80端口是否处于开放状态。
在你windows的浏览器中输入你服务器的公网IP就可以访问到你的项目了。
4,安装配置uwsgi
说明:uwsgi是一个服务器,用于部署你的Django项目。即:与Django项目进行通信。
安装:pip install uwsgi # 会安装在你的虚拟python环境中。
验证是否安装成功:在你项目的同级目录下新建一个uwsgi_test.py文件,内容如下(内容是官网提供的):
1 def application(env, start_response): 2 start_response(\'200 OK\',[(\'Content-Type\', \'text/html\')]) 3 #return [\'Hello world\'] # Python2 4 return [b\'Hello world\'] # Python3
保存退出后,输入:uwsgi –http :80 –wsgi-file uwsgi_test.py # 在windows中的浏览器输入你服务器的公网IP,如果出现“Hello world”则表示运行成功。
用uwsgi部署你的Django项目:更改项目中的settings文件:
DEBUG = False # 关闭调试模式。
ALLOWED_HOSTS = [\’*\’] # 允许所有主机访问。
在你的项目根目录下(与manage.py同级)新建一个uwsgi.ini文件,内容如下:
[uwsgi]
#如果单独使用uwsgi来部署Django项目时,就用这一行。
http=0.0.0.0:80
#如果使用nginx+uwsgi来部署Django项目时,就用这行。其中,8001端口用来跟nginx通信。也要在阿里云防火墙中添加8001端口。
# socket=0.0.0.0:8001
#你项目的完整路径。
chdir=/usr/DjangoProject/MyProject/
#给socket文件赋权限,这里不用管。
# chmod-socket=664
#启用主线程。
master=true
processes=4
threads=2
#指定日志文件(会自动创建)。这个很重要,如果uwsgi出现错误,可以通过日志文件来查错。
logto=uwsgi.log
#指定进程号文件(会自动创建)。这个也很重要,如果要重启和关闭uwsgi,则需要这个文件,里面记录了进程号。
pidfile=uwsgi.pid
#指定wsgi文件。在与settings.py同级目录中会有一个wsgi.py文件。
module=MyProject.wsgi:application
保存退出后,输入:uwsgi –ini uwsgi.ini # 启动uwsgi,并指定配置文件。
验证:在windows的浏览器中输入服务器公网IP就可以访问到你的项目了。如果不能,一定要查看日志文件uwsgi.log中的错误信息,文章结尾会有几个简单操作。
5,安装配置nginx
说明:nginx是一个反向代理服务器,用来接收浏览器的请求。如果是静态文件则由nginx处理;如果是动态请求则交给uwsgi处理。
安装:sudo apt-get nginx
验证是否安装成功:输入:server nginx start # 在Windows浏览器中可以看到nginx的欢迎界面。
配置:找到nginx.conf文件,一般会在/etc/nginx/下。如果没有,使用whereis nginx命令查看nginx的位置。
备份nginx.conf文件:cp nginx.conf nginx.conf.bar
删除nginx.conf文件,并重新建一个nginx.conf文件,内容如下:
events {
worker_connections 1024; # 不用管
}
http{
server {
listen 80; #这个端口用来监听浏览器的请求。
server_name 0.0.0.0; # 不用管,如果有域名可以填上域名。
charset UTF-8;
#日志文件。如果nginx出现问题,都可以通过日志文件来查错。
access_log /var/log/nginx/MyProject_access.log;
error_log /var/log/nginx/MyProject_error.log;
client_max_body_size 75M;
location / {
include uwsgi_params; # 使用uwsgi服务器。
uwsgi_pass 0.0.0.0:8001; # 把浏览器发来的请求转发到8001端口,而uwsgi也正在监听8001端口,所以就实现了nginx与uwsgi的通信。
uwsgi_read_timeout 30; #链接超时时间
}
location /static/{ # 处理静态文件,处理链接是以/static/开头的请求。即:如果是静态文件,就不用发给uwsgi了,nginx自己处理。
alias /usr/DjangoProject/MyProject/static/; # 项目静态文件的绝对路径。即:告诉nginx应该去哪里找静态文件。后面会介绍。
}
}
}
验证是否配置成功:
保存并退出,进入到项目根目录下:修改uwsgi.ini文件,把http=0.0.0.0:80注释掉,使用socket=0.0.0.0:8001 # 用来监听8001端口,与上面nginx对接。
保存并退出,输入: uwsgi -d –ini uwsgi.ini # 启动uwsgi服务器。-d表示在后台运行。这样就不会占用当前窗口了。
server nginx start # 启动nginx服务器。
在浏览器中输入服务器公网IP就可以访问了。如果出现错误,后面会介绍。
6,静态文件404问题
说明:由于静态文件(图片, css, js)是由nginx来处理,所以就不会把请求通过uwsgi发送到我们的Django项目。于是我们还要告诉我们的项目应该到哪里去找这些 静态文件。
在settings.py文件中添加这一行:STATIC_ROOT = os.path.join(BASE_DIR, \’static\’) # DASE_DIR为项目的绝对路径(已经获取到了)。
在urls.py文件中添加:
from django.conf.urls.static import static
from ShenDengBlog import settings
urlpatterns += static(\’/static/\’, document_root=settings.STATIC_ROOT) # 这一行不要放在urlpatterns里面了。这一句就是告诉我们的项目,以/static/开头 的静态文件路径都会转到项目根目录下的static文件夹中去找。
保存并退出,在项目根目录中,输入:python manage.py collectstatic # 收集静态文件,把所有app下static文件中的内容都复制到项目根目录中的static文件 夹中,包括admin中的静态文件。
重启uwsgi。如果出现错误,文章结尾会有解决方法。
再次在windows浏览器中访问你的公网IP,应该就可以加载静态文件了。
7,图片能加载,但是CSS样式丢失问题
说明:在访问网页时,发现图片能加载,而CSS样式全部丢失;但是在浏览器中F12->网络(network)发现css文件已经发送过来了(状态码为200或304)。
解决:只需要把模板文件第一行的<!DOCTYPE html>改成<!DOCTYPE>,或者直接删掉就好了。
原因:在segmentfault上找到了解释。因为<!DOCTYPE html>会让浏览器用标准模式来解析你的这个文档,而不加的话就会用兼容模式。这是链接
8,可能出现的错误,以及解决方法和注意事项
说明:在重启uwsgi或nginx时有时候会出现重启报错,或者是不报错也不成功的情况。
注意事项1:如果修改了uwsgi配置文件,或者修改了项目中的文件,一定要重启uwsgi,不然修改无效或者会出现一些奇怪的Bug。
注意事项2:在使用uwsgi和nginx时,不管出现什么问题,都先去日志文件中查看错误记录,最有可能导致错误的原因是“端口占用”;如果解决不了再去百度。
开启uwsgi:uwsgi –ini uwsgi.ini # uwsgi还支持其他文件格式,比如xml和json。建议使用ini文件。
重启uwsgi:uwsgi –reload uwsgi.pid # uwsgi.pid是在uwsgi.ini中指定的。
关闭uwsgi:uwsgi –stop uwsgi.pid # 同上。
开启nginx:server nginx start
重启nginx:server nginx restart
关闭nginx:server nginx stop
测试nginx:nginx -t # 如果是nginx的问题,可以通过测试发现原因。
启动或重启uwsgi失败:在重启或开启uwsgi时,有时候会出现各种各样的错误,很有可能是你上一个uwsgi进程占用端口搞的鬼,所以万能的办法就是先杀死所有uwsgi进程,然后再开启。
杀死uwsgi进程:sudo killall -9 uwsgi # 通过程序名强制杀死所有uwsgi进程。
再开启uwsgi:uwsgi -d –ini uwsgi.ini
访问网页时报502错误:因为uwsgi服务器没有开启。502是网关错误。既然有返回错误代码,就表示nginx服务器没有问题,所以是nginx无法与uwsgi通信,那 就是uwsgi的问题了;
我也是刚刚接触Django和用nginx+uwsgi来部署Django,如有表述错误的地方,欢迎留言指正!
版权声明:本文为shendeng23原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。