使用Nginx和Gunicorn部署Django项目

最新推荐文章于 2024-08-13 11:48:11 发布

小飞侠wyf

最新推荐文章于 2024-08-13 11:48:11 发布

阅读量863

点赞数

CC 4.0 BY-SA版权

文章标签：后端

本文链接：https://blog.youkuaiyun.com/qq_37543361/article/details/83688259

本文详细介绍如何使用Django创建并部署一个简单的博客系统至云服务器，包括环境搭建、代码上传、Nginx及Gunicorn配置等关键步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Django实践以及服务器部署

Django的安装以及环境配置可以通过 Django入门与实践来学习。
Django入门指南

常见命令

数据库移植

python manage.py makemigrations
python manage.py migrate

创建超级管理员

python manage.py createsuperuser

启动服务器

python manage.py runserver(默认是8000端口)

导出数据

python manage.py dumpdata appname > appname.json
python manage.py loaddata appname.json

清空数据库
```
python manage.py flush
```
Django项目环境终端
```
python manage.py shell
```
数据库命令行
```
python manage.py dbshell
```
创建新项目
```
django-admin startproject project_name
```
创建新App
```
python manage.py startapp app_name
```

项目结构

Painting

mainapp

init.py

migrations

admin.py

apps.py

forms.py

models.py

serializers.py

tests.py

urls.py

views.py

media

Painting

init.py

settings.py

urls.py

wsgi.py

static

db.sqilte3

manage.py

requirements.txt

Painting
- settings.py：app配置文件。
- urls.py：URL配置文件，配置页面URL。
- wsgi.py：python服务器网关接口。
manage.py：项目与命令行交互，项目管理器。
db.sqlite3：数据库
media：存储图片，音乐
static：存储静态文件，比如.jsp，.html，.css。
migrations：数据库移植模块，自动生成。
mainapp
- admin.py：后台管理系统配置
- apps.py：
- models.py：数据库建立代码
- forms.py：表结构代码
- serializers.py：序列化数据
- tests.py：自动化测试模块
- urls.py：前端URL
- views.py：执行响应的逻辑代码

简单小例子

建立一个博客系统，需要进行一下代码编码。

models.py

class Blog(models.Model):
    BlogId = models.CharField(max_length=100, primary_key=True)  # Id
    BlogName = models.CharField(max_length=30)  # 博客名
    Author = models.CharField(max_length=30)  # 作者

    def __str__(self):
        return self.BlogId

serializers.py

class BlogSerializer(serializers.ModelSerializer):
    class Meta:
        model = Blog
        fields = '__all__'

views.py

class BlogSet(viewsets.ModelViewSet):
    queryset = Blog.objects.all()
    serializer_class = BlogSerializer

myBlog/urls.py

url(r'blog/$',views.BlogSet)

settings.py

INSTALLED_APPS = ['myBlog']

LANGUAGE_CODE 设置为'zh_hans'，也可以设置为'zh-Hans'，但是在部署的时候第二个会出错，建议第一个。

blog/urls.py

url(r'',include('myBlog.urls',namespqce='myBlog))

以上代码就是建立一个博客系统，没有前端，可以通过127.0.0.1:8000/blog访问，返回json对象。

访问static/media文件

settings.py

STATIC_URL = '/static/'
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR,'media')
STATIC_ROOT = os.path.join(BASE_DIR,'static')

blog/urls.py

url(r'^static/(?P<path>.*)$', serve, {'document_root': settings.STATIC_ROOT}),
url(r'^media/(?P<path>.*)$', serve, {'document_root': settings.MEDIA_ROOT}),

以上就是编写简单的博客系统，下面讲解一下将博客系统部署到云服务器上，生产上线。

使用Nginx和Gunicorn部署Django项目

满足条件
- 可以通过外网访问的服务器
- 域名(当然没有域名也可以，直接通过IP进行访问)

搭建服务器

本教程使用的本地环境是Windows10，服务器环境为Ubuntu 16.01（64位）。

安装软件

不懂Linux命令的可以先查看一下基本的使用命令。
新的服务器的用户是root，我们需要新建一个拥有超级权限的新用户。

#在root下创建一个新用户，wangyufei是用户名
root@localhost:~# useradd -m -s /bin/bash wangyufei

#把新创建的用户加入到超级权限组
root@localhost:~# usermod -a -G sudo wangyufei

#为新用户设置密码
root@localhost:~# passwd wangyufei

#切换到新用户
root@localhost:~# su - wangyufei

#切换成功，注意到root已经变为wangyufei了
wangyuyfei@localhost:~$

如果是新服务器的话，需要更新一下系统。

wangyuyfei@localhost:~$ sudo apt-get update
wangyuyfei@localhost:~$ sudo apt-get upgrade

安装软件，用到的软件有Nginx、Git、pip、Django、virtualenv和Anaconda。

#安装Anaconda，找到最新的Anaconda版本https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/

#下载
wangyuyfei@localhost:~$ wget https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-5.0.1-Linux-x86_64.sh

#安装
wangyuyfei@localhost:~$ bash Anaconda3-5.0.1-Linux-x86_64.sh

#Linux里面默认的是python2.7，我们需要切换到python3.6
wangyuyfei@localhost:~$ echo 'export PATH="/home/hqy/anaconda2/bin:$PATH"' >> ~/.bashrc
wangyuyfei@localhost:~$ source ~/.bashrc
#检查一下，看是否是python3.6
wangyuyfei@localhost:~$ python --version

#安装Nginx
wangyuyfei@localhost:~$ sudo apt-get install nginx

#安装git
wangyuyfei@localhost:~$ sudo apt-get install git

#安装pip
wangyuyfei@localhost:~$ sudo apr-get install python3-pip

#安装virtualenv
wangyuyfei@localhost:~$ sudo pip install virtualenv(可能需要更新pip,使用命令更新)

#安装Django
sudo pip install django

解析域名

将域名和服务器的IP地址绑定后，可以通过域名访问服务器。

启动Nginx服务

Nginx是用来处理静态文件请求的，比如说访问一个博客文章的页面时，服务器会收到两种请求：
- 显示文章的详细信息，这些信息保存在数据库中
- 图片、CSS、js等存在服务器某个文件夹下的静态文件。
前面我们已经安装了Nginx，并且域名已经和IP地址绑定了，运行下面的命令启动Nginx服务：
```
wangyuyfei@localhost:~$ sudo service nginx start(这里需要注意一下，服务器需要开放80端口，外网才能进行访问)
```
在浏览器输入域名，看到如下页面说明Nginx启动成功了。

部署代码

部署前的配置

Django项目中会有一些CSS、JS等静态文件，这个目录通常位于根目录下，命名为static，需要在项目的settings.py里做一些配置。
```
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR,'static)#指明静态文件的收集目录
```
为了安全起见，在生产环境下关闭DEBUG选项以及设置允许访问的域名。
```
DEBUG = False
ALLOWED_HOSTS = ['127.0.0.1','localhost','39.105.110.19']
```
ALLOWED_HOSTS是允许访问的域名列表，前两个是本地域名，最后一个是服务器IP地址。

项目还会依赖一些第三方python库，为了在服务器上安装，我们需要将全部依赖写入requirements.txt文件中激活本地的虚拟环境，进入项目的根目录，运行pip freeze >requirements.txt命令。
```
E:\Painting>
pip freeze > requirements.txt
```
这时项目的根目录下会生成一个requirement.txt的文本文件，里面是项目的所有依赖。

将代码上传到Github

这里对于大多数人来说已经很熟悉了。

git add .
git commit -m "blog"
git push origin master

设置服务器目录结构

我的服务器上存放代码的目录结构是这样的：

/home/wangyufei
    sites/
        39.105.110.19/
            env/    #python虚拟环境目录
            Painting/   #项目目录

运行下面的命令：

wangyuyfei@localhost:~$ mkdir -p ~/sites/39.105.110.19

创建虚拟环境，进入到39.105.110.19目录下，运行virtualenv命令创建虚拟环境：

wangyuyfei@localhost:~$ cd ~/sites/39.105.110.19
wangyuyfei@localhost:~/sites/39.105.110.19$ virtualenv --python=python3 env

检查一下虚拟环境是否创建成功，运行ls命令查看，看到env这个文件夹说明虚拟环境创建成功。

wangyuyfei@localhost:~/sites/39.105.110.19$ ls
env

接着从代码仓库把项目拉取下来，git clone后面的地址换成自己项目的仓库地址。

wangyuyfei@localhost:~/sites/39.105.110.19$ git clone https://github.com/wangyufei1006/Painting.git

运行ls命令检查是否拉取成功。

wangyuyfei@localhost:~/sites/39.105.110.19$ ls
AICopyBook env

安装项目依赖

激活虚拟环境，再进入到项目根目录，安装项目的全部依赖：

wangyuyfei@localhost:~/sites/39.105.110.19$ source env/bin/activate
(env) wangyuyfei@localhost:~/sites/39.105.110.19$ cd Painting/
(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ pip install -r requirements.txt

收集静态文件

虚拟环境下继续运行python manage.py collectstatic命令收集静态文件到static目录下：
```
(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ python manage.py collectstatic
```

生成数据库

虚拟环境下运行python manage.py migrate命令创建数据库文件：

(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ python manage.py migrate

创建超级用户

虚拟环境下运行python manage.py createsuperuser命令创建一个超级用户，方便进入Django管理后台。
```
(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ python manage.py createsuperuser
```

配置Nginx

先在服务器的/etc/nginx/sites-available/目录下新建一个配置文件sudo vim 39.105.110.19，文件名设置为域名，写上下面的配置内容：

/etc/nginx/sites-available/39.105.110.19

server {
    charset utf-8;
    listen 80;
    server_name 39.105.110.19;	#服务器域名
    
    location /static {
        alias /home/wangyufei/sites/39.105.110.19/Painting/static		#指明静态文件存放目录
    }
    
    location / {
        proxy_set_header Host $host;
        proxy_pass http://unix:/tmp/39.105.110.19.socket; 	#使用Unix套接字，防止端口冲突
    }
}

接下来需要创建一个符号链接，把这个配置文件加入到启用的网站列表中去，被启用网站的目录在/etc/nginx/sites-enabled/，具体命令如下：

(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ sudo ln -s /etc/nginx/sites-available/39.105.110.19 /etc/nginx/sites-enabled/39.105.110.19

使用Gunicorn

Gunicorn一般用来管理多个进程。

在虚拟环境下，安装Gunicorn：

(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ pip install gunicorn

用Gunicorn启动服务器进程：

(env) wangyuyfei@localhost:~/sites/39.105.110.19/Painting$ gunicorn --bind unix:/tmp/39.105.110.19.socket Painting.wsgi:application

浏览器输入域名，可以看到访问成功了。

注意：此时如果访问到的还是Nginx的欢迎界面，需要删除/etc/nginx/sites_available/default和/etc/nginx/sites_enabled/default。

自启动Gunicorn

现在Gunicorn是我们手动启动的，万一哪天服务器重启了我们又得手工启动。为此写一个脚本，当服务器重新启动后，脚本会帮我们重启Gunicorn，按Ctrl+c停止服务器进程。

写一个启动脚本，脚本位于/etc/init目录下，且脚本文件名必须以.conf结尾：
```
/etc/init/gunicorn-39.105.110.19.conf

start on net-device-up	#在服务器联网时才启动gunicorn
stop on shutdown	

respawn		#重启gunicorn

setuid wangyufei	#用户名
chdir /home/wangyufei/static/39.105.110.19/Painting	#进入到指定目录

exec ../env/bin/gunicorn --bind unix:/tmp/39.105.110.19.socket Painting.wsgi:application	#执行进程
```
通过start命令启动gunicorn：
```
sudo start gunicorn-39.105.110.19
```
以后代码更新了，只要运行下面的命令重启一下Nginx和Gunicorn可以使新的代码生效了：
```
sudo service nginx reload 
sudo restrt gunicorn-39.105.110.19
```

还有另外一种方法也可以实现自启动：

# 新建目录
sudo mkdir -p /usr/lib/systemd/system

# 新建自启动的服务文件
sudo vim /usr/lib/systemd/system/39.105.110.19.service

[Unit]
After=syslog.target network.target remote-fs.target nss-lookup.target
[Service]
# 你的用户
User=wangyufei
# 你的目录
WorkingDirectory=/home/wangyufei/sites/39.105.110.19/Painting
# gunicorn启动命令
ExecStart=/home/wangyufei/sites/env/bin/gunicorn --bind unix:/tmp/39.105.110.19.socket Painting.wsgi:application
Restart=on-failure
[Install]
WantedBy=multi-user.target

# 启动服务
sudo systemctl start 39.105.110.19

# 添加服务到开机自动运行
sudo systemctl enable 39.105.110.19.service

# 查看进程,看看gunicorn是否已经启动,有两个进程
ps -ef | grep gunicorn

好了，基本的部署到生产中已经完成了，可以通过域名或者IP地址访问了。不懂的欢迎大家留言或者查看我的项目代码。

Github欢迎star。