将本地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的朋友提供一些些帮助吧！