将本地Django项目部署到服务器上（Ubuntu20.04）

最近因为项目的需求开始正在搭建一个个人网站。在本地完成了项目后端的内容后需要部署到服务器上以供用户访问。因为后端使用的是Django框架，就在网上找了很多有关将Django项目部署到网站上的教程。由于本人在网络这块属于小白，原理了解甚少，在一边参照各种教程一边实操的过程中碰了不少壁，总算是成功实现…因此写这篇博客来记录自己配置的过程，也希望能对正在学习Django的小伙伴提供一些帮助~
本文主要是参考了极客点儿的博客进行配置，是我在网上众多教程中找到的最清晰的一篇，为原博主疯狂点赞！！！

一、云服务器

1.1 购买云服务器

首先搭建一个网站需要一个远程服务器来运行项目。阿里云有个飞天免费试用计划，可以免费试用1核2G的云服务器ECS，试用期为3个月，个人用为仅用来学习网站搭建足矣。

试用（或购买）服务器后选择操作系统等就可以开始使用。这里不建议选Windows系统。本人选择的是Ubuntu20.04。不同版本的Ubuntu在配置上也有一些区别，这里建议选择版本旧一些的如16.04，后面会详细说明。

1.2 连接云服务器

在阿里云控制台实例处可以看到自己购买的服务器，一般第一次连接是无法使用WorkBench或SSH登录的，会提示服务器禁用了密码登录的方式。这是因为在服务器SSH配置文件 /etc/ssh/sshd_config中的 PasswordAuthentication 被设置为 no 。解决方法是通过VNC连接服务器后将上述项修改为 yes 。阿里云官方文档中也提供了对该问题完整的解决步骤，这里就不再赘述。

如果提示 访问公网IP地址需要在实例安全组白名单中增加Workbench的服务器白名单 ，则在控制台的 安全组 -> 配置规则 -> 入方向 中增加22端口。

22端口是远程连接端口，因此要通过SSH方式登录服务器肯定需要这个端口开放。这里可以顺便把80（http端口），3306（MySQL）也设置开放。

二、部署项目环境

连接好服务器后，我们需要开始在服务器部署项目需要的环境，安装一些必要的包。以下是本项目中使用到工具和包。

Python 3.8.1
Django 4.2
Nginx 1.18.0 
uWSGI 2.0.21

这里解释一下各个工具的用途。Django项目部署到服务器的方式有很多种，本项目是基于Django+Nginx+uWSGI的方式。这种方式的工作原理是将 Nginx 作为服务器最前端来接收 web 的所有请求，统一管理请求。Nginx 把所有静态请求自己来处理，将所有非静态请求通过 uWSGI 传递给 Django，由 Django 来进行处理，从而完成一次 web 请求。

2.1 安装Python

​
打开终端，输入以下指令下载Python 3.8.1安装包，如果是其他版本则要按官方下载链接修改，不要选择3.5以下的！！！

wget https://www.python.org/ftp/python/3.8.1/Python-3.8.3.tgz

然后新建一个安装目录：

sudo mkdir -p /usr/local/python3

解压安装包：

tar -zxvf Python-3.8.1.tgz

进入解压后的目录：

cd Python-3.8.1

配置安装的目录：

./configure --prefix=/usr/local/python3

编译Python 3.8.1的代码，并安装：

sudo make install

由于Linux中自带Python2.7，因此需要在终端建立软连接将python3指向Python3.8。
建立软连接运行的名称：

sudo ln -s /usr/local/python3/bin/python3.8 /usr/local/bin/python38
sudo ln -s /usr/local/python3/bin/pip3.8 /usr/bin/pip3

完成以上过程后在命令行输入python3后有回显>>>就表示安装成功，进入Python环境了。

2.2 安装Django

这个比较简单，直接pip3 install就可以了。

pip3 install Django==4.0

2.3 安装Nginx

使用apt之前可以先更新一下可用软件包列表和已安装的包

sudo apt update
sudo apt upgrade

然后install

sudo apt install nginx

安装完之后可以在本地输入你的服务器公网IP查看是否显示Nginx欢迎页，显示的话则证明安装成功。

2.3 安装uWSGI

执行pip install安装uWSGI

pip3 install uwsgi

安装完后可以测试一下，先创建一个test.py

#test.py
def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return [b"Hello World"] # python3
    #return ["Hello World"] # python2

然后在test.py所在目录下运行：

uwsgi --http :8000 --wsgi-file test.py

运行结果跟下图一样就是正常的啦。

三、配置uWSGI与Django，Nginx之间的通信

3.1 上传本地Django项目到服务器

首先需要将本地的项目上传到阿里云服务器上，这里提供两种方式作为参考：一种是将自己的Django项目上传到GitHub后再在服务器上git clone下来；另一种是通过ftp软件将本地项目传输给服务器。题主原本使用第一种方式但后来发现git仓库不能上传太大的文件（T~T），故改用第二种。
这里我使用的是FileZilla，连接后上传项目文件即可。

3.2 配置uWSGI

上传项目文件后，cd 进入项目文件夹的根目录创建uwsgi.ini文件。

cd myproject #我的Django项目文件
vi uwsgi.ini

配置uwsgi.ini内容如下：

[uwsgi]

socket          = :8888 
chdir           = /root/myroject
module          = myproject.wsgi
master          = true
processes       = 4
vacuum          = true

socket=:8888 表示指定项目的端口号为8888，chdir为指定的项目目录。
这一步在网上很多教程中，wsgi.py文件的位置都跟我不一样，不知道是不是因为Django版本的问题。我的项目文件中，wsgi.py文件是在同名子目录myproject下的，所以module处应为myproject.wsgi。这里show一下我的项目文件结构，有一样问题的配置文件可以参考这么写。

myproject/
├── manage.py
├── myproject
│   ├── asgi.py
│   ├── __init__.py
│   ├── __pycache__
│   │   ├── __init__.cpython-310.pyc
│   │   └── ...
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
├── uwsgi.ini
└── ...

之后就是运行uwsgi --ini uwsgi.ini读取uwsgi.ini启动项目。正常运行结果如下：

如果报以下错误则需要检查以下该端口是否已被占用，可以执行uwsgi --stop uwsgi.pid和pkill -f uwsgi -9关闭进程。

然后我们可以将uWSGI配置为开机自启。网上一些教程是在/etc/rc.local下添加开机命令，但Ubuntu在20.04版本已经取消了rc.local文件，所以这里提供另一种方法设置开机自启动

首先设置rc-local.service

sudo vi /etc/systemd/system/rc-local.service

内容如下：

[Unit]
 Description=/etc/rc.local Compatibility
 ConditionPathExists=/etc/rc.local

[Service]
 Type=forking
 ExecStart=/etc/rc.local start
 TimeoutSec=0
 StandardOutput=tty
 RemainAfterExit=yes
 SysVStartPriority=99

[Install]
 WantedBy=multi-user.target

然后激活rc-local.service

sudo systemctl enable rc-local.service

创建rc.local文件

sudo vi /etc/rc.local

内容如下：

#!/bin/sh -e
# 
# rc.local
#
# This script is executed at the end of each multiuser runlevel.
# Make sure that the script will "exit 0" on success or any other
# value on error.
#
# In order to enable or disable this script just change the execution
# bits.
#
# By default this script does nothing.

# 开机启动的命令
uwsgi --ini /root/myproject/uwsgi.ini & # 开机自动启动项目，并在后台运行

exit 0

保存退出后，给予脚本执行权限。

sudo chmod +x /etc/rc.local

这样开机自启动就设置好了。

3.3 配置Nginx

首先需要查看一下nginx配置文件，Ubuntu20.04的nginx配置文件为/etc/nginx/sites-available下的default，有些版本的Linux系统下配置文件为/etc/nginx/nginx.conf。
修改配置文件运行：

sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak #这里先对原来的配置文件进行备份
sudo vi /etc/nginx/sites-available/default

在文件后面添加这段：

server {

    listen          80;
    server_name     xx.xxx.xxx.xx #有域名填域名，没有就写自己的公网IP
    charset         UTF-8;
    access_log      /var/log/nginx/myweb_access.log;
    error_log       /var/log/nginx/myweb_error.log;

    client_max_body_size 800M;

    location / {

        include uwsgi_params;
        uwsgi_pass 127.0.0.1:8888; #这里的端口号要与uwsgi.ini中填写的一样
        uwsgi_read_timeout 2;
    }

    location /static {

        expires 30d;
        autoindex on;
        add_header Cache-Control private;
        alias myproject/static/;
    }
}

这里建议直接复制粘贴进去修改，因为这个配置文件对格式检查比较严格。
配置完后重新启动Nginx：

sudo /etc/init.d/nginx restart

现在在自己的主机或其他设备上的浏览器输入服务器的IP:端口号，就能正常访问自己的项目了。

总结

这两天在完成项目部署的过程中确实是碰了很多壁，加上原先对网络通信这块确实不是很了解，查阅了各种资料后对那些配置文件的内容等还是一头雾水，不懂得背后的原理，报错也不知道从何解决。好在最后还是一点一点的搞定了。希望我的这篇记录能够为同样正在学习Django的朋友提供一些些帮助吧！