Django线上部署教程:腾讯云+Ubuntu+Django+Uwsgi

终于将Django成功部署到了腾讯云上,也实现了HTTPS的功能。现将步骤方法,部署环境一一列举如下,方便日后查看。

网站源码已经在github开源:https://github.com/mxdshr/DjangoEast,欢迎克隆使用,并给个star~

1.部署环境与工具

  • 腾讯云
  • Ubuntu Server 16.04.1 LTS 64位
  • Django2.0.8
  • python3.6.7
  • Git
  • Nginx1.10.3
  • Uwsgi
  • Filezilla 其中Filezilla是用来向服务器上传文件的,之前我一直尝试给Ubuntu安装vsftpd,以为得搭建ftp才能传文件,其实不然,用Filezilla登录root账户也能进行传文件,端口是22。

2.部署步骤

在进行部署前,请保证你的Ubuntu是刚刚装好的,纯净的!也要确保系统的登录用户是root,如果不是root,使用下面的命令切换到root即可。

sudo su

2.1 安装python3.6

由于Ubuntu自带python2.7和python3.5,但这并不是我所需要的版本,因此需要额外安装python3.6,如果你用的是其他的版本,方法是一样的。命令如下:

代码语言:javascript
复制
apt-get install software-properties-common
add-apt-repository ppa:jonathonf/python-3.6
apt-get update
apt-get install python3.6

安装完之后,在终端输入python使用的还是2.7的版本,因此我们需要做下面的更改,使终端默认打开我们安装的python3.6:

cd /usr/bin rm python3 ln -s python3.6 python3

2.2安装pip3

pip的作用不用多说了,主要是用来管理安装Python的各种包,安装方法如下:

代码语言:javascript
复制
apt-get install python3-pip

安装完还只是第一步,与Python一样,我们在终端输入pip,使用的还是系统自带的版本。我们需要做一下更改,原理与上面的python是一样的。

代码语言:javascript
复制
cd /usr/bin
rm pip3
ln -s pip3.6 pip3

重新登录可生效,然后就可以用pip3装库了

代码语言:javascript
复制
pip3 install --upgrade pip

不知道是什么原因,这样操作之后不会立马生效,需要你重新登录一下服务器才行。好,假设你现在重新登录了,在终端输入pip3也是我们所要的了,现在需要给pip做一下升级。

代码语言:javascript
复制
pip3 install --upgrade pip
2.3安装并配置虚拟环境virtualenv

建议大家在一个独立的Python虚拟环境中对网站进行操作,安装命令如下:

代码语言:javascript
复制
pip3 install virtualenv

进入一个你想要存放虚拟环境的目录,这里我选择/home,虚拟环境名我取为django,然后创建并激活虚拟环境:

代码语言:javascript
复制
virtualenv django
source /home/django/bin/activate

以后大家在进行操作的时候,一定要记得先激活虚拟环境,在django的环境下安装python包或者操作django的manage.py文件。

2.4 安装git,下载网站

使用Git可以很方便的与github进行交互操作,帮我们更新网站源码文件,安装方式如下:

代码语言:javascript
复制
apt-get install git

安装完之后需要选择一个存放网站程序的目录,这里我选择/home/mysite,mysite目录默认是没有的,需要你创建,然后进入到此目录中,用Git将网站pull下来,这里我以我的已经开源到github上的Django博客为例,下载网站程序的方法如下:

代码语言:javascript
复制
git init
git remote add origin https://github.com/mxdshr/DjangoEast.git
git pull origin master

好了,现在我们已经获取了网站的程序,接下来我们安装Django程序所需python包

2.5安装网站运行环境

进行此操作前,请保证你现在已经处于Django这个虚拟环境中:

代码语言:javascript
复制
pip install -r requirements.txt

这个时候,Django程序运行所需要的所有python包,都已经装入到你的环境中了,现在网站还不能运行,我们需要安装数据库。

2.6安装数据库MySQL

这里我选择的是MySQL5.8版本,安装步骤如下:

代码语言:javascript
复制
cd /home
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb
dpkg -i mysql-apt-config_0.8.12-1_all.deb
*选择8.0即可*
apt-get update
apt-get install mysql-server

安装的过程中会提示你输入密码,一定要记好哈!安装完之后需要创建数据库,创建用户并授权:

代码语言:javascript
复制
mysql -uroot -p
CREATE DATABASE `数据库名` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER '用户名'@'%' IDENTIFIED BY '密码';
GRANT ALL PRIVILEGES ON *.* TO '用户名'@'%';
FLUSH PRIVILEGES;

这个时候数据库的配置我们就弄完了,接下来,请先修改网站程序中djangoblog/settings.py中的数据库配置,修改完之后的操作分为两种情况: - 如果你想用之前的数据库,请用MySQL客户端(如Navicat)对其进行数据导入。 - 如果你没有数据库,请在网站根目录下运行下面的命令,创建数据表。

代码语言:javascript
复制
python manage.py makemigrations
python manage.py migrate

好了,Django程序和数据库已经配置好了。我们可以简单地运行一下网站了,先切换到网站根目录下,然后执行:

代码语言:javascript
复制
python manage.py runserver 0.0.0.0:80

0.0.0.0:80表示任意ip可访问,这样设置你就可以使用服务器ip地址访问你的网站了。但是仅使用python自带的runserver工具运行网站程序是远远不够的。我们还需要nginx或Apache等服务器管理软件来更好的运行我们的网站,另外我们还需要安装uwsgi。

2.7安装uwsgi

安装uwsgi之前我们需要安装python开发包:

代码语言:javascript
复制
apt-get install python3.6-dev

然后再安装uwsgi,安装之前请先退出django这个虚拟环境,我们在公共环境中安装它.

代码语言:javascript
复制
pip3 install uwsgi

安装完之后,我们就可以用uwsgi来测试网站是否能成功运行了,使用下面的命令:

代码语言:javascript
复制
uwsgi --http :8888 --chdir /home/mysite --home /home/django --module djangoblog.wsgi:application

--http :用于指定端口,这里我指定8888,请先在腾讯云安全组中开放此端口 --chdir:用于指定网站根目录 --home:用于指定虚拟环境地址 --module:用于指定你的Django项目地址 然后我们在浏览器地址中输入http://你的服务器ip地址:8888,就可以看到没有css样式的页面了。之所以看不到样式,是因为uwsgi只能提供动态链接服务,要是访问静态文件需要安装nginx:

2.8安装nginx
代码语言:javascript
复制
apt-get install nginx

安装完之后我们需要对nginx进行一些配置,不过首先我们需要知道nginx的配置文件都有哪些:

代码语言:javascript
复制
主配置文件:/etc/nginx/nginx.conf一般不用动
可用配置文件:/etc/nginx/sites-available我们一般更改这里的配置文件
已用配置文件:/etc/nginx/sites-enabled,已经启用的配置文件 我们在可用配置文件目录,新建一个mysite.conf此文件用于配置我们的项目。
代码语言:javascript
复制
cd /etc/nginx/sites-available
vim mysite.conf

然后在文件中写入下面的配置:

代码语言:javascript
复制
upstream django {
    server 127.0.0.1:8888; # for a web port socket (we'll use this first)
}

server{
listen 80;
server_name mysite;
charset utf-8;
client_max_body_size 75M; #上传文件大小限制

# 网站静态文件所在目录
location /static{
    alias /home/mysite/static;
}

# 上传文件所在目录
location /media{
    alias /home/mysite/media;
}

# 动态文件交给uwsgi处理
location / {
    uwsgi_pass 127.0.0.1:8888;
    include /etc/nginx/uwsgi_params;
}

}

然后将此文件再sites-enabled中创建一个软连接,表示此配置文件已经启用:

代码语言:javascript
复制
ln -s /etc/nginx/sites-available/mysite.conf   /etc/nginx/sites-enabled/mysite.conf

另外我们还需要将启动nginx的用户改为root,要不然会出现403 forbidden的错误。打开/etc/nginx/nginx.conf文件,将第一行中user后面的用户改为root即可。

2.9配置uwsgi

之前我们只是简单的测试了一下uwsgi,但是还没有对它进行配置。现在需要进行配置,首先在/home目录下创建一个mysite_uwsgi目录,然后在目录中创建一个mysite.ini文件用于保存uwsgi的配置选项。

代码语言:javascript
复制
cd /home
mkdir mysite_uwsgi
cd mysite_uwsgi
vim mysite.ini

写入下面的内容

代码语言:javascript
复制
[uwsgi]
chdir = /home/mysite
home = /home/django
module = djangoblog.wsgi:application
master = True
processes = 4
max-requests = 5000
harakiri = 60
socket = 127.0.0.1:8888
uid = root
gid = root
pidfile = /home/mysite_uwsgi/master.pid
daemonize = /home/mysite_uwsgi/mysite.log
vacuum = True

好了,现在nginx配置完了,uwsgi也配置完了,我们就可以测试网站是否能够成功了,于是用mysite.ini文件打开uwsgi。

代码语言:javascript
复制
uwsgi --ini /home/mysite_uwsgi/mysite.ini 

检查uwsgi是否启动成功的命令:

代码语言:javascript
复制
ps -aux | grep uwsgi

如果结果中有多个进程,我们就可以看到它启动成功了。

2.10 配置HTTPS

现在的网站基本都标配HTTPS,如果不是的话浏览器会提示你的网站不安全。也会影响搜索引擎收录,因此我们需要将网站升级到HTTPS。

我用的是腾讯云,腾讯云可以免费申请一个TrustAsia TLS RSA CA证书,该SSL证书可用一年,申请之后你就可以得到两个文件一个.crt,一个是.key。我们需要将这两个文件用Filezilla传到/etc/nginx/目录下。

然后在/etc/nginx/nginx.conf文件里的http模块中写入下面的配置文件,这个内容是将http请求转到https请求,网站域名改成你自己的:

代码语言:javascript
复制
server{
listen 80;
server_name eastnotes.com www.eastnotes.com;
rewrite ^(.) https://$host$1 permanent;
}

然后打开/etc/nginx/sites-available/mysite.conf在里面填入一下内容:

代码语言:javascript
复制
listen 443 ssl http2;
server_name www.eastnotes.com,eastnotes.com;
ssl_certificate 1_www.eastnotes.com_bundle.crt;
ssl_certificate_key 2_www.eastnotes.com.key;
ssl_session_timeout 5m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
ssl_prefer_server_ciphers on;

重启nginx

代码语言:javascript
复制
nginx -t
service nginx restart

好了,现在打开网站应该就看到https的前缀了,但是还不够,我们需要将所有的不带www的连接进行301重定向到带www的连接,在/etc/nginx/sites-available的location里面添加如下代码:

代码语言:javascript
复制
if ($host != 'www.eastnotes.com' ) {
rewrite ^/(.
)$ https://www.eastnotes.com/$1 permanent;
}

至此,Django的线上部署全部完成......真TM费劲啊!!!

3.常用命令

# 检查nginx配置文件是够有错误

nginx -t

重启nginx

service nginx restart

查看uwsgi进程

ps -aux | grep uwsgi

正常关闭uwsgi进程

uwsgi --stop /home/mysite_uwsgi/master.pid

强制关闭全部uwsgi进程

ps -aux | grep uwsgi |awk '{print $2}'|xargs kill -9

重新加载uwsgi

uwsgi --reload /home/mysite_uwsgi/master.pid

x lsof -i:9000 #查看端口占用状态​

netstat -lnp| grep 9000 #查看端口占用状态​

kill -9 +PID号

用到的服务器:

新客户无门槛领取总价值高达2860元代金券

云服务器3折活动