
使用Centos7.5+Nginx+Gunicorn+Django+Python3部署blog项目
本项目开发环境是 Python3.5.2+Django1.10.6+Sqlite3+Centos7.5+Nginx1.12.2+Gunicorn
使用Centos7.5+Nginx+Gunicorn+Django+Python3部署blog项目
本项目开发环境是 Python3.5.2+Django1.10.6+Sqlite3+Centos7.5+Nginx1.12.2+Gunicorn
blog虽然已经上线测试有一段时间了(2018.8.7上线),但是项目部署的笔记由于内容较多,没时间整理。今天抽空整理了一下午,发布出来供需要的同学借鉴参考。文中如有错误请多多指正
部署前的准备
服务器
要部署项目就要先购买服务器,如腾讯云,阿里云等等
注意:服务器在国内的话,必须要备案!不然无法使用。
阿里云优惠券:点击前往领取
腾讯云代金券:点击前往领取
腾讯云首页:点击直达
腾讯云西南区云产品促销链接:点击直达
腾讯云服务器购买链接:点击直达
域名
域名购买选择,可以到百度云,腾讯云,阿里云,GoDaddy,namecheap等等
购买域名后就是解析域名,打开域名解析面板,添加解析记录
记录类型:A
主机记录:test.markhoo.com,这个markhoo.com是你的一级域名,二级域名你可以设置为www.markhoo.com
解析线路:可以默认也可以选别的
记录值:填写你的服务器IP地址
TTL:域名生效时间,也就是多久生效
设置好以上内容,点击确定。解析完成
主机记录中这个markhoo.com是你的一级域名,二级域名你也可以设置为 www.markhoo.com 或者别的 xxx.markhoo.com 也可以。
注意:域名是否在国内购买不重要,只要服务器不在大陆购买,即使未备案照样可以使用。要是要解析的服务器是大陆服务商则必须要备案。备案后一个域名可以同时接入多个服务商。
域名解析记录类型说明:
- A:将域名指向一个IPv4地址
- AAAA:将域名指向一个IPv6地址
- CNAME:将域名指向另外一个域名
- NS:将子域名指定其他DNS服务器解析
- MX:将域名指向邮件服务器地址
- SRV:记录提供特定的服务的服务器
- TXT:文本长度限制512,通常做SPF记录(反垃圾邮件)
- CAA:CA证书颁发机构授权校验
- 显性URL:将域名302重定向到另外一个地址
- 隐性URL:与显性URL类似,但是会隐藏真实目标地址
xshell下载与安装
主要用于远程登录服务器进行相关操作。在官网注册后发送下载链接到你的注册邮箱,或者到搜索引擎搜索下载。
个人版免费,企业版收费。
下载后一路点击下一步,完成。
登录服务器步骤:
点击左上角’文件’–’新建’
然后弹出对话框
常规:名称,这个你可以随便取什么名字
协议:SSH,一般默认
主机:空,填上你的服务器IP地址
端口号:22,默认的就行
填好以上选项内容,点击左侧的’用户身份验证’,然后看右侧,方法选择’Password’,在下面输入你的服务器登录用户名和密码,最后点击下面的’连接’。
登录成功!进入界面。
百度网盘官网软件下载链接:
链接: https://pan.baidu.com/s/19K5q1JkmD9qnYaGRTALyLg 密码: r6hx
安装Nginx
首先用xshell登录服务器
通过 yum 安装 Nginx
1 |
|
启动 Nginx 服务
1 |
|
或者
1 |
|
访问服务器IP地址,可以看到 nginx 的欢迎界面
Nginx相关命令:
停止nginx
1 |
|
重启nginx
1 |
|
Centos7.5安装Python3
由于centos7.5原本默认安装了Python2,而且这个Python2不能被删除,因为有很多系统命令,比如yum都要用到。
以下操作首先要用xshell登录到服务器
输入Python命令,查看可以得知是Python2.7.5版本
输入
1 |
|
可以查看位置,一般是位于/usr/bin/python目录下。
下面介绍安装Python3的方法
首先安装依赖包
1 |
|
然后根据自己需求下载不同版本的Python3,我下载的是Python3.5.2
注:如果速度不够快,可以直接去官网下载,利用WinSCP等软件传到服务器上指定位置。
我的存放目录是/usr/local/python3,使用命令:
1 |
|
建立好一个空文件夹,进入该目录
1 |
|
使用一下命令下载压缩包
1 |
|
然后解压压缩包安装Python3
1 |
|
最后创建软链接
1 |
|
在命令行中输入python3测试
升级pip3命令:
1 |
|
部署前的项目配置
Django 项目中会有一些 CSS、JavaScript 等静态文件,为了能够方便地让 Nginx 处理这些静态文件的请求,我们把项目中的全部静态文件收集到一个统一的目录下,这个目录通常位于 Django 项目的根目录,并且命名为 static。为了完成这些任务,需要在项目的配置文件里做一些必要的配置:
1 |
|
STATIC_ROOT 指明了静态文件的收集目录,即项目根目录(BASE_DIR)下的 static 文件夹。
为了安全起见,在生产环境下需要关闭 DEBUG 选项以及设置允许访问的域名。打开 settings.py 文件,找到 DEBUG 和 ALLOWED_HOSTS 这两个选项,将它们设置成如下的值:
1 |
|
ALLOWED_HOSTS 是允许访问的域名列表,127.0.0.1 和 localhost 是本地访问的域名,.markhoo.com 是访问服务器的域名(换成你自己的域名)。域名前加一个点表示允许访问该域名下的子域名,比如 www.markhoo.com test.markhoo.com 等二级域名同样允许访问。如果不加前面的点则只允许访问 markhoo.com。
项目还会依赖一些第三方 Python 库,为了方便在服务器上一次性安装,我们将全部依赖写入一个叫 requirements.txt 的文本文件中。激活本地的虚拟环境(如果你使用了虚拟环境的话),并进入项目的根目录,运行 pip freeze > requirements.txt 命令:
1 |
|
这时项目根目录下会生成了一个 requirements.txt 的文本文件,其内容记录了项目的全部依赖。由于有一些依赖包也有先后依赖关系,该调整的需要进去txt文件调整一下。
如果上传到服务器后修改,可以使用 ‘vi (文件名称)’ 打开文件,然后点击键盘 ‘i’ 键切换到输入模式。
修改完需要退出,先按键盘 ‘Esc’ 键,然后输入 ‘:wq’ 保存退出。如果不想修改又无法退出可以用 ‘:q!’ 强制退出,这样不会保存你修改的内容
更多的vi、vim命令使用方法可以自行到搜索引擎搜索学习,这里就不一一讲解了。
将代码上传到 GitHub 、 Gitee 、 或者Coding
将代码上传到 GitHub 等代码托管平台,这样我们就可以方便地把代码拉取到服务器了。
如果访问慢或者打不开GitHub的话,可以上传到国内的Gitee或者Coding
Git的安装和上传代码的简单方法
安装Git可以到官网 https://git-scm.com 下载,安装的话可以一直下一步,完成。
首先你需要一个GitHub 、 Gitee 、 或者Coding账号,所以还没有的话先去注册吧!
https://github.com
https://gitee.com
https://coding.net
1.进入Github首页,点击New repository新建一个项目
2.填写相应信息后点击create即可
Repository name: 仓库名称
Description(可选): 仓库描述介绍
Public, Private : 仓库权限(公开共享,私有或指定合作者)
Initialize this repository with a README: 添加一个README.md
gitignore: 不需要进行版本管理的仓库类型,对应生成文件.gitignore
license: 证书类型,对应生成文件LICENSE
一般可以填写项目仓库名称,点击create就可以了。因为免费用户只有 Gitee 才可以创建私有仓库
3.创建好项目仓库后,在项目仓库页面点击Clone or dowload会出现一个地址,copy这个地址备用。
4.接下来就到本地操作了,首先右键你的项目,如果你之前安装git成功的话,右键会出现两个新选项,分别为Git Gui Here,Git Bash Here,这里我们选择Git Bash Here进入界面,我的本地项目名为myblog。
5.接下来输入如下代码(关键步骤),把github上面的仓库克隆到本地
1 |
|
6.操作步骤5以后你的本地项目文件夹下面就会多出个文件夹,该文件夹名即为你github上面的项目名,如我多出了个myblogsite文件夹,我们把本地项目文件夹下的所有文件(除了新多出的那个文件夹不用),其余都复制到那个新多出的文件夹下。
7.接着继续输入命令 cd myblogsite
,进入myblogsite文件夹
8.接下来依次输入以下代码即可完成其他剩余操作:
1 |
|
注意:数据库文件不要上传!要是SQLLITE3里面有你测试的重要数据,将可能会泄露。
设置服务器目录结构
接下来需要把代码上传到服务器了。我服务器上存放代码的目录结构一般是这样的:
1 |
|
一台服务器可能部署多个网站,所有网站代码都放在 sites/ 目录下。markhoo.com/ 这个文件夹以网站的域名命名,便于区分。myblog_env 是 python 虚拟环境目录。myblog 是 Django 博客项目目录。
创建这个目录结构,注意目录名替换为你自己的域名,以后涉及到 markhoo.com 的地方通常都要替换你自己的域名,后面就不再一一指出了。
备注:上面的我的目录结构.可能会有新手看不懂,解释一下,就像下面这样一直创建下去
1 |
|
最后的 myblog_env 和 myblog 是同级目录位于markhoo.com下,这里自己先不要创建。
创建目录的命令为: mkdir (文件夹名称)
删除目录的命令为: rmdir (文件夹名称)
安装virtualenv
为了不影响外界环境的清洁,所以我们使用虚拟环境来配置 Django 项目
首先用xshell登录到你的服务器,然后按一下步骤操作
1 |
|
接下来创建虚拟环境,先进入到 markhoo.com 目录下,然后运行 virtualenv
命令创建虚拟环境:
1 |
|
命令说明:
-p: 指定你要虚拟的Python版本,这里选择了本地的python3
–-no-site-packages:表示在建立虚拟环境时不将原版本中的第三方库拷贝过来,这样就能获得一个纯净的Python环境。
myblog_env:表明在该目录下,建立一个叫做myblog_env的虚拟环境,这样的命名方式,让你一眼就能看出这个虚拟环境是为谁建立的。
virtualenv的命令使用方法:
创建虚拟环境: $ virtualenv -p /usr/bin/python3.5 –-no-site-packages myblog_env
启动虚拟环境: $ source myblog_env/bin/activate
退出虚拟环境: $ deactivate
删除虚拟环境: $ rm –r myblog_env
检查一下虚拟环境是否创建成功,运行 ls 命令列出当前目录下的文件和文件夹,看到 myblog_env 这个文件夹说明虚拟环境创建成功。
1 |
|
venv的使用
由于我只是测试项目,所以使用了Python自带的venv。
先进入到 markhoo.com 目录下,然后运行 python3 -m venv myblog_env
创建虚拟环境:
1 |
|
检查一下虚拟环境是否创建成功,运行 ls 命令列出当前目录下的文件和文件夹,看到 myblog_env 这个文件夹说明虚拟环境创建成功。
1 |
|
在虚拟环境中安装 django 以及依赖包并初始化项目
接着再从代码仓库把项目代码拉取过来,把 git clone
后的地址换成你自己的 GitHub 仓库地址!
1 |
|
运行 ls 命令检查一下是否拉取成功:
1 |
|
多了 myblog 文件夹(文件夹名称由你的 GitHub 仓库名决定),说明拉取成功了。
接下来执行命令,启动虚拟环境
1 |
|
安装项目环境依赖
1 |
|
收集静态文件
运行 python manage.py collectstatic 命令收集静态文件到 static 目录下
1 |
|
生成数据库
1 |
|
创建超级用户
1 |
|
然后就会出现以下内容,第一个是用户名,第二个是邮箱,第三和第四是密码(输入时没有任何显示,实际上已经输入了)。最后显示创建成功!
1 |
|
备注:这里使用的是Django默认生成的sqlite3数据库,我使用了这个,简单写写博客够用了。
启动 Django
1 |
|
如果没有报错,就说明 Django 已经安装成功了,打开浏览器输入你的服务器IP:8000,就可以看到你的网站了
退出 Django
按 ctrl+c
退出 Django 服务
安装 Mysql (使用MySQL数据库同学可以借鉴)
安装并启动 mariadb
因为 CentOS 7 之后的版本都不在提供 Mysql 安装源,这里我们使用 mariadb 代替 mysql,依次执行下列命令
1 |
|
对 mariadb 进行初始化设置
- 执行下面命令,根据提示操作
- 设置新密码为 test
- 默认密码为空,直接回车即可使用设置的密码登陆 mariadb
1
$ mysql_secure_installation
- 登陆 db,这里假设密码被设置为 admin123创建一个数据库
1
$ mysql -uroot -ptest
成功后,输入 exit 命令退出 db1
$ create database myblog;
修改配置文件,与 Mysql 数据库相关联1
> exit
编辑 myblog/settings.py
1 |
|
创建 Django 数据库
1 |
|
创建超级用户
1 |
|
然后就会出现以下内容,第一个是用户名,第二个是邮箱,第三和第四是密码(输入时没有任何显示,实际上已经输入了)。最后显示创建成功!
1 |
|
启动 Django
1 |
|
如果没有报错,就说明 Django 已经安装成功了,并且跟 Mysql 的连接正常。打开浏览器输入你的服务器IP:8000,就可以看到你的网站了
退出 Django
按 ctrl+c
退出 Django 服务
使用 Gunicorn
Gunicorn 一般用来管理多个进程,有进程挂了Gunicorn 可以把它拉起来,防止服务器长时间停止服务,还可以动态调整 worker 的数量,请求多的时候增加 worker 的数量,请求少的时候减少。
在虚拟环境下,安装 Gunicorn:
1 |
|
测试Gunicorn是否能启动你的项目服务
1 |
|
注意:myblog.wsgi:application这里的myblog对应的是 /home/markhoo/sites/markhoo.com/myblog/myblog, 根据自己的修改。浏览器输入域名,可以看到访问成功了!
访问ip地址看浏览器是否能正常查看内容(此时没有退出虚拟环境)
完成测试后,按 CTRL-C
停止 Gunicorn 运行
退出虚拟环境
1 |
|
创建一个 Gunicorn Systemd Service 文件,直接运行以下命令
1 |
|
修改内容如下:
1 |
|
一定要注意自己的项目路径和虚拟环境路径
WorkingDirectory与ExecStart 修改为自己的路径
开启Gunicorn服务并开机自启,运行以下命令
1 |
|
配置 Nginx
接下是配置 Nginx 来处理用户请求
配置nginx代理通过Gunicorn
依次运行以下命令
1 |
|
或者直接运行
1 |
|
打开后默认的内容如下:
1 |
|
找到server内容进行修改,具体内容如下:
1 |
|
注意修改自己的IP地址或域名,还有文件路径
server_domain_or_IP 代表你的IP地址或域名
- 这里的域名为 markhoo.com,其次一定要添加 0.0.0.0 否则无法访问,两个之间用空格隔开。
- 所有URL 带有 /static 的请求均由 Nginx 处理,alias 指明了静态文件的存放目录。
- 其它请求转发给 Django 处理。proxy_pass 后面使用了 unix 套接字,其作用是防止端口冲突,这里就不再详述。
修改所涉及到的vim命令使用方法:使用 ‘vi (文件名称)’ 是打开文件,然后点击键盘 ‘i’ 键切换到输入模式。修改完需要退出vim编辑器,先按键盘 ‘Esc’ 键,然后输入 ‘:wq’ 保存退出。如果不想修改又无法退出可以用 ‘:q!’ 强制退出,这样不会保存你修改的内容。
更多的vi、vim命令的具体使用方法可以自行到搜索引擎搜索学习,这里也不一一讲解了。
修改nginx的权限
1 |
|
如果没有报错,就行下一步操作
开启nginx服务并开机自启
1 |
|
现在,一切配置完成!你可以访问你的域名了!