nginx+uwsgi部署Django项目到Ubuntu服务器全过程,以及那些坑!!!

时间:2021-12-07 19:18:06

前言:自己在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,如有表述错误的地方,欢迎留言指正!