django 项目部署详细教程【uwsgi + nginx】

ゝ一世哀愁。 2023-03-05 11:57 15阅读 0赞

###  ###

*  项目部署
 *   *  1. 环境搭建
     *   *  1.1 Anaconda 下载
         *  1.2 Anaconda 安装
         *  1.3 环境配置
         *  1.4 创建虚拟环境
     *  2. 项目拉到服务器
     *   *  2.1 项目迁移
         *   *  2.1.1 方法一（Xftp）
             *  2.2.2 方法二（git）
         *  2.2 安装项目依赖包
     *  3. uwsgi
     *   *  3.1 uwsgi 的安装
         *  3.2 uwsgi 的配置
         *  3.3 uwsgi 的启动和停止
     *  4. nginx
     *   *  4.1 nginx 配置转发请求给 uwsgi
         *  4.2 nginx配置处理静态文件
         *  4.3 nginx转发请求给另外地址
         *  4.4 nginx 配置 upstream 实现负载均衡

# 项目部署 #

## 1. 环境搭建 ##

> 不使用 Anaconda 可直接跳到创建虚拟环境

### 1.1 Anaconda 下载 ###

*  anaconda + virtualenv
 *  anaconda下载： [清华大学开源软件镜像][Link 1] or [官网][Link 2]

### 1.2 Anaconda 安装 ###

*  下载好后传到Linux  
    ![在这里插入图片描述][20200804110240133.png]
 *  安装

root@iZwz9ijwralw5z37wd16xsZ:~# bash ~/Downloads/Anaconda3-5.3.1-Linux-x86_64.sh

![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-uxvB4xoo-1596510168906)(C:\\Users\\user\\AppData\\Roaming\\Typora\\typora-user-images\\image-20200726085008704.png)\]][img-uxvB4xoo-1596510168906_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726085008704.png]

*  回车安装到默认路径即可  
    ![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-QVZgCMiB-1596510168908)(C:\\Users\\user\\AppData\\Roaming\\Typora\\typora-user-images\\image-20200726085429443.png)\]][img-QVZgCMiB-1596510168908_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726085429443.png]
 *  建议输入yes，输入No的话还需要自己手动添加路径，否则conda将无法正常运行  
    ![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xnxv4n7e-1596510168910)(C:\\Users\\user\\AppData\\Roaming\\Typora\\typora-user-images\\image-20200726085610006.png)\]][img-xnxv4n7e-1596510168910_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726085610006.png]
 *  是否安装VSCode，随便，我这里不安装
 *  启动服务
    
        root@iZwz9ijwralw5z37wd16xsZ:~# source ~/.bashrc
 *  输入`conda list` , 安装成功会显示包名

### 1.3 环境配置 ###

*  创建 anaconda 环境
    
     *  conda create -n name python版本号
        
            root@iZwz9ijwralw5z37wd16xsZ:~# conda create -n MyDjango python=3.6.2

### 1.4 创建虚拟环境 ###

*  下载虚拟环境pip包
    
     *  pip install virtualenv
     *  pip install virtualenvwrapper
 *  修改 .bashrc 文件

vim ~/.bashrc
    # 添加下面代码
    export WORKON_HOME=$HOME/.virtualenvs
    export PROJECT_HOME=$HOME/workspace
    source /usr/local/bin/virtualenvwrapper.sh
    
    # 使 .bashrc 生效
    source ~/.bashrc

*  使用 anaconda环境/python环境 创建新虚拟环境
    
     *  mkvirtualenv --python=‘指定路径’ 环境名称
     *  eg：
    
        mkvirtualenv --python='/root/anaconda3/envs/MyDjango/bin/python' MyDjango
    
    > 默认情况下，新创建的环境将会被保存在/Users/<user\_name>/anaconda3/env目录下，其中，<user\_name>为当前用户的用户名。  
    > 不指定python环境的话，默认会选择本地的python版本
 *  进入虚拟环境
    
     *  workon MyDjango

## 2. 项目拉到服务器 ##

### 2.1 项目迁移 ###

#### 2.1.1 方法一（Xftp） ####

*  通过 Xftp 将项目文件从本机直接拉到服务器  
    ![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-VIpr7KCT-1596510168912)(C:\\Users\\user\\AppData\\Roaming\\Typora\\typora-user-images\\image-20200726094725914.png)\]][img-VIpr7KCT-1596510168912_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726094725914.png]

#### 2.2.2 方法二（git） ####

*  服务器安装git
    
     *  apt-get install git
 *  通过 `git clone` 命令将仓库克隆到服务器
    
     *  git clone https://gitee.com/ruochenchen/saas.git

### 2.2 安装项目依赖包 ###

*  在本机项目中通过 `pip freeze > requirement.txt` 命令将项目所需包输出到 requirement.txt 文件中
 *  服务器端项目中。通过 `pip install -r requirements.txt` 命令安装包

## 3. uwsgi ##

*  遵循 wsgi 协议的 web 服务器

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5MzM5NDY3_size_16_color_FFFFFF_t_70]

### 3.1 uwsgi 的安装 ###

*  pip install uwsgi

### 3.2 uwsgi 的配置 ###

*  项目部署时，需要修改 `settings.py` 文件
    
        DEBUG=FALSE
        ALLOWED_HOSTS=['*']
 *  在项目中新建一个文件 `uwsgi.ini`，方便启动/终止 uwsgi 服务
    
        [uwsgi]
        # 使用nginx链接时使用
        # socket=127.0.0.1:8000
        # 直接做web服务器使用 python manage.py runserver ip:port
        http=127.0.0.1:8000
        # 项目目录 [pwd查看 直接填，不需要引号]
        chdir=
        # 项目中wsgi.py文件的目录，相对于项目目录
        wsgi-file=
        # 指定启动的工作进程数
        processes=4
        # 指定工作进程中的线程数
        threads=2
        # 进程中，有一个主进程
        master=True
        # 保存启动之后主进程的pid
        pidfile=uwsgi.pid
        # 设置uwsgi后台运行, uwsgi.log 保存日志信息
        daemonize=uwsgi.log
        # 设置虚拟环境的路径 [cd .virtualenvs]
        virtualenv=

> 下面是我的`uwsgi.ini` 文件配置，可以参考一下。

[uwsgi]
    # 使用nginx链接时使用
    socket=127.0.0.1:8000
    # 直接做web服务器使用 python manage.py runserver ip:port
    # http=127.0.0.1:8000
    # 项目目录 [pwd查看 直接填，不需要引号]
    chdir=/root/MyDjango
    # 项目中wsgi.py文件的目录，相对于项目目录
    wsgi-file=MyDjango/wsgi.py
    # 指定启动的工作进程数
    processes=4
    # 指定工作进程中的线程数
    threads=2
    # 进程中，有一个主进程
    master=True
    # 保存启动之后主进程的pid
    pidfile=uwsgi.pid
    # 设置uwsgi后台运行, uwsgi.log 保存日志信息
    daemonize=uwsgi.log
    # 设置虚拟环境的路径 [cd .virtualenvs]
    virtualenv=/root/.virtualenvs/MyDjango

### 3.3 uwsgi 的启动和停止 ###

*  启动： uwsgi --ini 配置文件路径
    
     *  例如： uwsgi --ini uwsgi.ini
     *  启动后，`ps aux | grep uwsgi` 命令可以查看uwsgi 进程
 *  停止： uwsgi --stop uwsgi.pid 路径
    
     *  例如： uwsgi --stop uwsgi.pid

> 这里有一个小问题，如果遇到可以看一下解决方法
> 
> 问题：
> 
>  执行启动后，报错信息 uwsgi: error while loading shared libraries: libpcre.so.1: cannot open shared object file: No such file or directory
> 
> 解决方法：
> 
>  sudo apt-get install libpcre3 libpcre3-dev \# 安装需要的包
> 
>  find / -name libpcre.so.3 \# 找到libpcre.so.3（一般在根目录/lib/x86\_64-linux-gnu下）
> 
>  找到 /lib/x86\_64-linux-gnu/libpcre.so.3
> 
>  sudo ln -s /lib/x86\_64-linux-gnu/libpcre.so.3 /usr/lib/libpcre.so.1 \# 做软链接即可

> 仅仅使用uwsgi，首页的静态文件不能显示

> 解决方法：
> 
> 在uwsgi前面在加一个nginx服务器
> 
> nginx中进行配置
> 
> 1.  如果是动态请求，转交请求给uwsgi
> 2.  如果是静态请求，提前把项目用到的静态文件放到nginx所在电脑的某个目录中
>     
>     根据配置，nginx就会去目录下方找到静态文件，直接返回给用户

## 4. nginx ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5MzM5NDY3_size_16_color_FFFFFF_t_70 1]

### 4.1 nginx 配置转发请求给 uwsgi ###

*  uwsgi 需要更改配置文件
    
        [uwsgi]
        # 使用nginx链接时使用
        socket=127.0.0.1:8080
        # 直接做web服务器使用 python manage.py runserver ip:port
        # http=127.0.0.1:8080
        # 项目目录 [pwd查看 直接填，不需要引号]
        chdir=
        # 项目中wsgi.py文件的目录，相对于项目目录
        wsgi-file=
        # 指定启动的工作进程数
        processes=4
        # 指定工作进程中的线程数
        threads=2
        # 进程中，有一个主进程
        master=True
        # 保存启动之后主进程的pid
        pidfile=uwsgi.pid
        # 设置uwsgi后台运行, uwsgi.log 保存日志信息
        daemonize=uwsgi.log
        # 设置虚拟环境的路径 [cd .virtualenvs]
        virtualenv=
 *  nginx配置转发请求给 uwsgi，配置路径为 `/etc/nginx/sites-available/default`
    
        http{
        	server {
        		listen 80;
        		server_name localhost;
        		
        		location / {
                    # 包含uwsgi的请求参数
                    include uwsgi_params;
                    # 转交请求给uwsgi
                    uwsgi_pass 127.0.0.1:8000  # uwsgi服务器的ip:port
            	}
        	}
        }
 *  下面是我的 `default` 配置信息，加了静态文件处理【静态文件处理请继续往下看】，可以参考一下
    
        upstream MyDjango {
                server 127.0.0.1:8000;
        }
        
        server {
                listen 80;
                server_name localhost;
        
                location / {
                        include uwsgi_params;
                        uwsgi_pass MyDjango;
                }
        
                location /static {
                        alias /var/www/MyDjango/static;
                }
        }

> ps aux | grep nginx \# 查看是否有nginx进程

*  启动nginx
    
     *  /etc/init.d/nginx start 【终止命令为： /etc/init.d/nginx stop】

> 也可以用如下命令  
> service nginx start  
> service nginx stop  
> service nginx restart  
> service nginx reload

*  启动uwsgi
    
     *  uwsgi --ini uwsgi.ini

### 4.2 nginx配置处理静态文件 ###

http{
    	server {
    		listen 80;
    		server_name localhost;
    		
    		location / {
                # 包含uwsgi的请求参数
                include uwsgi_params;
                # 转交请求给uwsgi
                uwsgi_pass 127.0.0.1:8080  # uwsgi服务器的ip:port;
        	}
        	
        	# 请求的路径中以static开头，就匹配下列地址
        	location /static {
        		# 指定静态文件存放的目录
        		alias 目录 例如： /var/xxx/static;
        						/var/www/MyDjango/static;
        	}
    	}
    }

*  django settings.py 中配置收集静态文件路径
    
        # settings.py 中设置
        STATIC_ROOT=收集的静态文件路径  例如: /var/xxx/static
        # 例如，我的路径为 STATIC_ROOT = '/var/www/MyDjango/static'
 *  创建文件夹
    
    `sudo mkdir -p /var/www/MyDjango/static`
    
    > 普通用户没有权限，需要修改文件权限
    > 
    > sudo chmod 777 /var/xxx/static/
 *  django 收集静态文件的命令
    
     *  python manage.py collectstatic
     *  执行上面的命令会把项目中所使用的静态文件收集到 STATIC\_ROOT 指定的目录下
 *  重启nginx服务
    
    `/etc/init.d/nginx reload`

> 到这里，项目就部署完成了，还有其他需求可以继续往下看。

### 4.3 nginx转发请求给另外地址 ###

*  在 location 对应的配置项中增加 proxy\_pass 转发的服务器地址，
    
    如当用户访问 127.0.0.1 时，在nginx 中配置把这个请求转发给 172.10.179.115:80(nginx)服务器，让这台服务器提供静态页面
 *  nginx配置如下：
    
        http{
        	server {
        		listen 80;
        		server_name localhost;
        		
        		location / {
                    # 包含uwsgi的请求参数
                    include uwsgi_params;
                    # 转交请求给uwsgi
                    uwsgi_pass 127.0.0.1:8080  # uwsgi服务器的ip:port;
            	}
            	
            	# 请求的路径中以static开头，就匹配下列地址
            	location /static {
            		# 指定静态文件存放的目录
            		alias 目录 例如： /var/xxx/static;
            	}
            	
            	# 等号为精确匹配
            	location = / {
            		# 传递请求给静态文件服务器上的nginx
            		proxy_pass http://ip;
            	}
        	}
        }

### 4.4 nginx 配置 upstream 实现负载均衡 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5MzM5NDY3_size_16_color_FFFFFF_t_70 2]

*  nginx 配置负载均衡时，在 server 配置的前面增加 upstream 配置项
    
        http{
            # 名称随便起
            upstream ruochen {
                server 127.0.0.1:8080;
                server 127.0.0.1:8081;
            }
        
        	server {
        		listen 80;
        		server_name localhost;
        		
        		location / {
                    # 包含uwsgi的请求参数
                    include uwsgi_params;
                    # 转交请求给uwsgi
                    # uwsgi_pass 127.0.0.1:8080  # uwsgi服务器的ip:port;
                    uwsgi_pass ruochen;  # 上面名字是啥，这里就是啥
            	}
            	
            	# 请求的路径中以static开头，就匹配下列地址
            	location /static {
            		# 指定静态文件存放的目录
            		alias 目录 例如： /var/xxx/static;
            	}
            	
            	# 等号为精确匹配
            	location = / {
            		# 传递请求给静态文件服务器上的nginx
            		proxy_pass http://ip;
            	}
        	}
        }

[Link 1]: https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/
[Link 2]: https://www.anaconda.com/products/individual#linux
[20200804110240133.png]: /images/20230208/d36e6d18799c41be8b9c3c23b3e4e8fd.png
[img-uxvB4xoo-1596510168906_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726085008704.png]: /images/20230208/0050815995be4c3fbf8a8a0b9969500e.png
[img-QVZgCMiB-1596510168908_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726085429443.png]: /images/20230208/beccdccc4b5b4108a62193d14f618856.png
[img-xnxv4n7e-1596510168910_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726085610006.png]: /images/20230208/f8845d6af19e4c8496217f21a62e7f1a.png
[img-VIpr7KCT-1596510168912_C_Users_user_AppData_Roaming_Typora_typora-user-images_image-20200726094725914.png]: /images/20230208/664c354466c64b02a08d4cc94f014089.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5MzM5NDY3_size_16_color_FFFFFF_t_70]: /images/20230208/4f6676374b74453eaa0b2ba0c897c741.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5MzM5NDY3_size_16_color_FFFFFF_t_70 1]: /images/20230208/70268eb3d92749158d3afde03f464189.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI5MzM5NDY3_size_16_color_FFFFFF_t_70 2]: /images/20230208/fa00f0d21eb0470284e338c8719196f3.png