Ubuntu部署Django项目方法详细讲解

教程使用的软件版本:Ubuntu 18.04.1 LTS,django2.0,Python 3.6.5、nginx-1.13.7、uWSGI (2.0.17.1),Ubuntu是纯净的,全新的。下面我们开始来部署。

如果觉得看文字没意思,想看视频教程的,请点击这里:Django项目部署视频教程

一、更新操作系统和安装依赖包

#更新操作系统软件库
sudo apt-get update
sudo apt-get upgrade

#安装上传rz、下载sz工具
sudo apt-get install lrzsz

#安装gcc g++的依赖库
sudo apt-get install build-essential
sudo apt-get install libtool

#安装 pcre依赖库
sudo apt-get install libpcre3 libpcre3-dev

#安装 pcre依赖库
sudo apt-get install zlib1g-dev

#安装 ssl依赖库
sudo apt-get install openssl

二、安装Python3和PIP3

sudo apt install python3
sudo apt install python3-pip

三、建立两个文件夹,用于存放virtualenv环境和项目

#放虚拟环境的
sudo mkdir -p /data/env

#放项目的
sudo mkdir -p /data/wwwroot

四、安装virtualenv

sudo pip3 install virtualenv

进入env目录

cd /data/env

指定Python版本,创建名为pyweb的虚拟环境,

sudo virtualenv -p /usr/bin/python3 pyweb

指定Python版本的时候,如果不知道Python3的路径,可以使用下面的命令查看

which python

五、启动虚拟环境

#启动虚拟环境
source /data/env/pyweb/bin/activate

六、上传项目并安装依赖软件库(虚拟环境下)

把我们开发好的项目上传到 /data/wwwroot/目录,然后进入该目录,先安装项目所需要的依赖包,然后启动项目,测试是否能正常启动。

我这里给大家一个测试项目,大家可以用来测试,帐号和密码分别为:admin  qq445813。mysite.zip

sudo pip3 install -r requirements.txt
python3 manage.py runserver

如果能正常启动,说明项目没啥问题。

七、安装uwsgi

sudo pip3 install uwsgi

留意:uwsgi要安装两次,先在系统里安装一次,然后进入对应的虚拟环境安装一次。

安装成功之后,我们进入项目根目录/data/wwwroot/mysite/新建一个 mysite.xml文件,在里面输入代码:

<uwsgi>    
   <socket>127.0.0.1:8997</socket><!-- 内部端口,自定义 --> 
   <chdir>/data/wwwroot/mysite/</chdir><!-- 项目路径 -->            
   <module>mysite.wsgi</module> 
   <processes>4</processes> <!-- 进程数 -->     
   <daemonize>uwsgi.log</daemonize><!-- 日志文件 -->
</uwsgi>

要留意里面的项目路径和.wsgi那里填写方法,你找到wsgi.py这个文件所在的目录,然后填写目录名+.wsgi即可。

八、安装nginx,并配置

/usr/local 目录执行下面命令下载nginx源码:

wget http://nginx.org/download/nginx-1.13.7.tar.gz

然后解压它:

tar -zxvf nginx-1.13.7.tar.gz

cd 进入解压后的nginx-1.13.7文件夹,依次执行以下命令:

sudo ./configure 
sudo make 
sudo make install

nginx一般默认安装好的路径为/usr/local/nginx

进入/usr/local/nginx/conf/目录,然后备份一下nginx.conf文件,以防意外。

sudo cp nginx.conf nginx.conf.bak

然后打开nginx.conf文件,把里面的内容全部删除,输入下面代码:

events {
    worker_connections  1024;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen       80;
        server_name  www.django.cn;
        charset utf-8;
        location / {
           include uwsgi_params;
           uwsgi_pass 127.0.0.1:8997;
           uwsgi_param UWSGI_SCRIPT mysite.wsgi;
           uwsgi_param UWSGI_CHDIR /data/wwwroot/mysite/; #项目路径
           
        }
        location /static/ {
        alias /data/wwwroot/mysite/static/; #静态资源路径
        }
    }
}

需要留意的是,下图长方形里我标记的代码要和UWSGI配置文件mysite.xml一致,否则会出错。

1.jpg

至于静态资源路径,自己settings.py里怎么设置,你就按那个设置就好。

进入/usr/local/nginx/sbin/目录

执行下面命令先检查配置文件是否有错:

./nginx -t

没有错就执行以下命令:

./nginx

终端没有任何提示就证明nginx启动成功。

之后进入网站项目目录

cd /data/wwwroot/mysite/

执行下面命令(虚拟环境下):

uwsgi -x mysite.xml

以上步骤都没有出错的话。

进入/usr/local/nginx/sbin/目录

执行:

./nginx -s reload

平滑重启nginx 。然后在浏览器里访问你的项目地址!这时项目就能成功访问。

关于后台样式丢失问题,解决方法和Centos解决方法一样,我就不在这里重复。

更多关于其它服务器部署Django的,请查看下面的文章:

CentOS7下部署Django项目详细操作步骤

Windows server iis部署Django详细操作

Ubuntu部署Django项目方法详解

使用宝塔面板快速部署Django项目(新手建议直接使用这种方法)

在部署的过程中,如果发现其它问题,可以文章后面留言,方便我收集错误和更新处理方法。


文章评论 15

  • ubuntu18.04 ,django2.0.6 项目名称 Papi ,py文件 papi.wsgi 按以上流程配置 执行命令: ./nginx 后没有任何提示 浏览器打开服务器ip地址报错 502 Bad Gateway mysite.xlm 文件 与 nginx.conf 文件 <div class="codehilite"><pre> <uwsgi>
    <socket>127.0.0.1:8000</socket><!-- 内部端口,自定义 --> <chdir>/data/wwwroot/Papi/</chdir><!-- 项目路径 -->
    <module>papi.wsgi</module> <processes>4</processes> <!-- 进程数 -->
    <daemonize>uwsgi.log</daemonize><!-- 日志文件 --> </uwsgi>

    events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; server { listen 80; server_name www.django.cn; charset utf-8; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8000; uwsgi_param UWSGI_SCRIPT papi.wsgi; uwsgi_param UWSGI_CHDIR /data/wwwroot/Papi;

        }
        location /static/ {
        alias /data/wwwroot/Papi/static/;
        }
    }

    } </pre></div>

  • <p>项目上传到服务器后,你先python3 manage.py runserver运行一下,看项目能不能正常运行。然后再对比配置文件。还有www.django.cn 修改成你的域名。如果没有域名的话就修改成127.0.0.1:80</p>

  • 502 Bad Gateway 怎么解决

  • 在服务器里 通过python manage.py runserver 命令,检查你项目能不能正常运行,能的话再进行下一步,不能就检查源码。出现这样的错误大多是源码有错误的。

  • sudo pip3 install -r requirements.txt什么意思,为什么我一运行就显示没有这个文件,还有我用rz上传文件上传不了,一运行rz就是两行乱码,怎么办啊

  • 就是你在你的项目里新建requirements.txt文件,里面存放着你所需要的Python包,会批量帮你下载,如果只有一两个,你可以一个个使用pip install下载。

  • 我按照你的方法把环境搭建好了,也能访问了,但是我添加了一个路由以后重启了一下服务器(我用你的重启命令重启了以后没有效果就重启了服务器)就不能访问了,提示服务器错误(Internal Server Error),代码在Django中是可以跑起来的!只是添加了一下模板和路由,请问是不是还需要修改什么配置?

  • 部署成功了,各位小伙伴可以留下网址互相踩一踩啊。欢迎大家访问(http://xiaocan.site)。感谢老师。

  • 你好,有个问题想问一下。我按您这个教程,做完了django博客,也按照这个部署方式部署到我的ubuntu服务器上了,但是出现了一个问题是,我进入后台管理页面,想增加博客文章,点击增加文章就会报 Server Error (500)。 这是nginx 的配置文件

    server {
            listen 8848;
            server_name  127.0.0.1:8848; #改为自己的域名,没域名修改为127.0.0.1:80
            charset utf-8;
            location / {
               include uwsgi_params;
               uwsgi_pass 127.0.0.1:8997;  #端口要和uwsgi里配置的一样
               uwsgi_param UWSGI_SCRIPT sychen_blog.wsgi;  #wsgi.py所在的目录名+.wsgi
               uwsgi_param UWSGI_CHDIR /data/wwwroot/sychen_blog/; #项目路径
    
            }
            location /static/ {
            alias /data/wwwroot/mysite/static/; #静态资源路径
            }
        }

    这是uwsgi的配置文件

    #添加配置选择
    [uwsgi]
    
    #配置和nginx连接的socket连接的
    #http=127.0.0.1:8997
    socket=127.0.0.1:8997
    #配置项目路径,项目的所在目录
    chdir=/data/wwwroot/sychen_blog/
    #配置wsgi接口模块文件路径,也就是wsgi.py这个文件所在的目录名
    wsgi-file=sychen_blog/wsgi.py
    #配置启动的进程数
    processes=4
    #配置每个进程的线程数
    threads=2
    #配置启动管理主进程
    master=True
    #配置存放主进程的进程号文件
    pidfile=uwsgi.pid
    #配置dump日志记录
    daemonize=uwsgi.log
    virtualenv=/home/ubuntu/venv_/venv_django_2.1.1

  • ====非常感谢本文作者,也感谢本网站===== ++++学习django项目的部署,真的是很艰难,很想让人放弃+++++ ++++但是没有放弃,不断的在CSDN,各种QQ群,公众号上搜索答案操作步骤++++ ++++直到在一个叫django中文网的QQ群上发现此网站,照着这个方法做了下来,终于成功了+++ ///////感谢\\\\\

  • 请求帮助! 环境:阿里云Ubtuntu服务器 版本:nginx version: nginx/1.18.0 (Ubuntu) Django version 4.0.2

    问题:输入IP后,显示 500 Internal Server Error python manage.py runserver 可以运行


    nginx.conf 配置文件信息 events { worker_connections 1024; } http { include mime.types; default_type application/octet-stream; sendfile on; server { listen 80; server_name XXX.XXX.XXX.XXX; #自己的云服务器公网IP charset utf-8; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:8997; uwsgi_param UWSGI_SCRIPT /data/wwwroot/course_recommend/course_recommend/wsgi.py; uwsgi_param UWSGI_CHDIR /data/wwwroot/course_recommend/; #项目路径

        }
        location /static/ {
        alias /data/wwwroot/course_recommend/static/; #静态资源路径
        }
    }

    }


    course_recommend.xml <uwsgi> <socket>127.0.0.1:8997</socket><!-- 内部端口,自定义 --> <chdir>/data/wwwroot/course_recommend/</chdir><!-- 项目路径 --> <module>/data/wwwroot/course_recommend/course_recommend/wsgi.py</module> <processes>4</processes> <daemonize>uwsgi.log</daemonize><!-- 日志文件 --> </uwsgi>