Python Django项目部署 Linux 服务器

项目依赖: Linux Centos7 (阿里云轻量级服务器) + Python 3.7.2 + Django 2.2.1 + restframework 3.9.4 + mysql 5.7

1 安装 python3 到 Centos7， 先安装软件管理包和可能使用的依赖

yum -y groupinstall "Development tools"
yum install openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel

2 下载Pyhton3到/usr/local 目录

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

3 解压

tar -zxvf Python-3.7.2.tgz

​

4 进入到解压好的python文件中

cd Python-3.7.2

​

5 编译安装到指定路径

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

​

6 安装python3

make

make install

7 安装完成之后 建立软链接 添加变量 方便在终端中直接使用python3

ln -s /usr/local/python3/bin/python3.7 /usr/bin/python3

​

8 Python3安装完成之后pip3也一块安装完成，不需要再单独安装一样建立软链接
同样给pip3建立软链接

ln -s /usr/local/python3/bin/pip3.7 /usr/bin/pip3

注： 如果软链建立完成，但是却无法使用的时候执行下面命令：
   mv pip pip2  # (将文件 pip 更名为 pip2 )
   ln -s /usr/local/python3/bin/pip3 /usr/bin/pip  

9 安装virtualenv, 方便不同版本项目管理。

pip3 install virtualenv

​

10 建立软链接

ln -s /usr/local/python3/bin/virtualenv /usr/bin/virtualenv3

​

11 安装成功在根目录下建立两个文件夹，主要用于存放env和网站文件的 （文件创建随意，根据实际需求）。

mkdir -p /data/env   # 存放虚拟环境
 
mkdir -p /data/wwwroot   # 存放web项目

​

12 切换到/data/env/下，创建指定版本的虚拟环境。

       virtualenv3 --python=/usr/bin/python qize_demo (项目名) # 创建虚拟环境

       # 然后进入
       cd /data/env/qize_demo/bin 

       # 进入bin目录后开启虚拟环境，执行命令
       source activate  

    # 注：(启动后出现 (qize_demo)，说明是成功进入虚拟环境。)

13 虚拟环境里用pip3安django和uwsgi (留意：uwsgi要安装两次，先在系统里安装一次，然后进入对应的虚拟环境安装一次。)

pip3 install django  #（如果用于生产的话，则需要指定安装和你项目相同的版本）

pip3 install uwsgi

# 给uwsgi建立软链接，方便使用

ln -s /usr/local/python3/bin/uwsgi /usr/bin/uwsgi

​

14 在本地项目目录下用下面的命令把当前的环境依赖包导出到requirements.txt文件

pip freeze > requirements.txt 

​
15 把项目源码压缩打包。把项目上传到服务器对应的目录里(/data/wwwroot/)，解压。

16 进入解压好的项目根路径中安装requirements.txt里的依赖包。

pip3 install -r requirements.txt

​

17 导入数据库到服务器。（如果用的是Mysql的话）

导出Mysql,django为你的数据库

mysqldump -uroot -p password django>django.sql

把django.sql上传到服务器，在服务器里用下面命令导入

mysql -uroot -ppassword

use dajngo;

source your Path\django.sql

​

18 通过 python3 manage.py runserver 运行一下项目，如果能正常启动则进行下一步，不能正常运行往上检查 （下面给出几个常见错误和解决方案）。

报错1：django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.3 or newer is required; you have 0.7.11 解决方案：

解决：编辑Python安装路径下的 Python36-32\Lib\site-packages\django\db\backends\mysql\base.py

将文件中的如下代码注释

#if version < (1, 3, 3):
#    raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__)

报错2： File "/usr/local/python3/lib/python3.7/site-packages/django/db/backends/mysql/operations.py", line 146, in last_executed_query query = query.decode(errors='replace')

AttributeError: 'str' object has no attribute 'decode'

解决：编辑

/usr/local/python3/lib/python3.7/site-packages/django/db/backends/mysql/operations.py

的 第146 行，

# 将 decode 改为 encode 保存并退出
query = query.decode(errors='replace') 改为 query = query.encode(errors='replace')

19 在项目根目录里添加uwsgi配置文件 (qize_demo.xml)

<uwsgi>       

 <socket>127.0.0.1:8070/</socket><!-- 内部端口，自定义 --> 

 <chdir>/data/wwwroot/qize_demo/</chdir><!-- 项目路径 -->            

 <module>qize_demo.wsgi</module> 

 <processes>4</processes> <!-- 进程数 -->     

 <daemonize>uwsgi.log</daemonize><!-- 日志文件 -->

</uwsgi>

​

20 配置Nginx配置文件（把原先的配置文件可以备份以下，然后将下面的替换进去）。

events {

    worker_connections  1024;

}

http {

    include       mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    server {
        listen 80;
        server_name  127.0.0.1:80;  # 改为自己的域名，没域名修改为127.0.0.1:80
        charset utf-8;
        location / {
           include uwsgi_params;
           uwsgi_pass 127.0.0.1:8070;  #端口要和uwsgi里配置的一样
           uwsgi_param UWSGI_SCRIPT qize_demo.wsgi;     #wsgi.py所在的目录名+.wsgi
           uwsgi_param UWSGI_CHDIR /data/wwwroot/qize_demo/; #项目路径
           
        }
        location /static {
            alias /data/wwwroot/qize_demo/static; #静态资源路径
        }
    
        location /templates {
            alias /data/wwwroot/qize_demo/templates;
        }
    }

}

留意：一定要注意Uwsgi和Nginx配置文件里的项目路径和静态资源路径，填写正确了才能成功访问。不然会出现502错误。还有就是，修改Django文件和其它配置文件之后，一定要重启Uwsgi和Nginx，不然不生效。

21 Uwsgi和Nginx重启方法：

uwsgi 启动方法

uwsgi -x qize_demo.xml

Nginx 重启方法

nginx -s reload

然后在浏览器里访问服务器ip（或域名），就能查看到项目。

如果想使用域名访问项目，先在域名管理后台把域名解析到服务器IP上来，之后在Nginx配置文件里绑定域名。然后在浏览器里通过绑定的域名访问项目。

以下总结一些问题：

1 如果访问出现 500 以上的错误信息并有nginx的信息，一般是nginx配置出了问题。去查看nginx.conf配置中的项目路径是否正确，uwsgi_pass 参数的端口和 uwsgi的xml 文件中端口是否一致，是否修改完配置后重新启动了nginx。还有就是可以去项目根路径下 python manage.py runserver 启动下项目，看看有没有报错，也有可能是程序本身就有问题。

2 如果访问出现 400 以上的错误信息，重点检查项目路径，包括 tempates / static 静态路径是否正确，和项目中 settings 是否配置了 tempates / static 文件的访问路径，以及 url 是否正确，其次还有html文件中引入的 css, js, img 等文件路径是否正确, 比如：

  css文件：<link rel="stylesheet" href="/static/css/q.css">
  js文件 ：<script src="/static/js/q.js"></script>

​

以下总结下注意事项：

1 项目上线后记得 DEBUG = False 这样设置，这样的话你的项目访问失败就不会有 Django 的错误信息了

2 设置所有 IP 都可访问 (settings.py)

     ALLOWED_HOSTS = ['*']

3 数据库设置（settings.py）

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'sql_base',       # 库名 （根据实际数据库名进行修改）
        'PORT': 3306,         # 端口（不用改）
        'HOST': '127.0.0.1',  # 本地host(不用改)
        "USER": 'root',           # 用户名
        'PASSWORD': '123456'  # 密码
    }
}

​