云服务器 ECS：使用Nginx+uWSGI部署Django项目

准备工作

创建部署Django项目的ECS实例，ECS实例必须满足以下条件：

• 实例已分配公网IP地址或绑定弹性公网IP（EIP）。具体操作，请参见绑定和解绑弹性公网IP。

• 操作系统必须为Alibaba Cloud Linux 3.2104、Alibaba Cloud Linux 2.1903、CentOS 7.x、Ubuntu 22.04、Ubuntu 20.04、Ubuntu 18.04。

  重要

  • 本教程以Alibaba Cloud Linux 3.2104和Ubuntu 20.04 64位操作系统为例。如果您购买的ECS服务器使用了其他版本的操作系统，操作可能与本教程略有差异。

  • 软件包或程序安装具体版本以您使用的实际版本为准。

• ECS实例安全组的入方向添加安全组规则并放行22、80、8001和8002端口。具体操作，请参见添加安全组规则。

步骤一：安装或核对Python版本

1. 远程连接Linux实例。

   具体操作，请参见通过密码或密钥认证登录Linux实例。

2. 运行以下命令，查看具体Python安装信息。

   本示例ECS实例中默认已经安装Python 3，如果您的ECS实例中未安装Python 3，请自行安装。

   Alibaba Cloud Linux 3.2104/Alibaba Cloud Linux 2.1903/CentOS 7.x

   which python3 
   ll /usr/bin/python*

   回显信息类似如下所示。

   [ecs-user@iZbp17st8t8txp6po87**** ~]$ which python3
   /usr/bin/python3
   [ecs-user@iZbp17st8t8txp6po87**** ~]$ ll /usr/bin/python*
   lrwxrwxrwx 1 root root 7 Feb 8 10:30 /usr/bin/python -> python2
   lrwxrwxrwx 1 root root 9 Feb 8 10:30 /usr/bin/python2 -> python2.7
   -rwxr-xr-x 1 root root 7144 Jun 28 2022 /usr/bin/python2.7
   lrwxrwxrwx 1 root root 9 Feb 8 10:25 /usr/bin/python3 -> python3.6
   -rwxr-xr-x 2 root root 11328 Nov 17 2020 /usr/bin/python3.6
   lrwxrwxrwx 1 root root 17 Feb 8 10:25 /usr/bin/python3.6-config -> python3.6m-config
   -rwxr-xr-x 2 root root 11328 Nov 17 2020 /usr/bin/python3.6m
   -rwxr-xr-x 1 root root 173 Nov 17 2020 /usr/bin/python3.6m-config
   -rwxr-xr-x 1 root root 3403 Nov 17 2020 /usr/bin/python3.6m-x86_64-config
   lrwxrwxrwx 1 root root 16 Feb 8 10:25 /usr/bin/python3-config -> python3.6-config

   Ubuntu 20.04

   which python3 
   ll /usr/bin/python*

   回显信息类似如下所示。

   ecs-user@iZjyfbxivbj****:~$ which python3 
   /usr/bin/python3
   ecs-user@iZjyfbxivbj****:~$ ll /usr/bin/python*
   -rwxr-xr-x 1 root root 3662032 Jul 1 2022 /usr/bin/python2.7*
   lrwxrwxrwx 1 root root 9 Feb 8 14:05 /usr/bin/python3 -> python3.8*
   -rwxr-xr-x 1 root root 5494584 Nov 14 20:59 /usr/bin/python3.8*
   lrwxrwxrwx 1 root root 33 Nov 14 20:59 /usr/bin/python3.8-config -> x86_64-linux-gnu-python3.8-config*
   lrwxrwxrwx 1 root root 16 Mar 13 2020 /usr/bin/python3-config -> python3.8-config*

步骤二：部署Nginx环境

1. 执行以下命令，安装Nginx。

   Alibaba Cloud Linux 3.2104/Alibaba Cloud Linux 2.1903/CentOS 7.x

   sudo yum -y install nginx

   Ubuntu 22.04/Ubuntu 20.04/Ubuntu 18.04

   sudo apt update
   sudo apt -y install nginx

2. 执行以下命令，启动并查看Nginx服务状态。

   sudo systemctl start nginx
   systemctl status nginx

   如果回显信息中出现Active: active (running)，表示Nginx服务已启动。

步骤五：配置Nginx、uWSGI、Django

1. 如需配置Django，请在对应目录添加相关文件，具体以您部署的网站项目为准。本步骤仅用于展示基本的Django网页，请忽略此步骤。

   1. 执行以下命令，修改Django配置文件settings.py。

      sudo vim /home/myblog/uwsgi_project/uwsgi_project/settings.py

   2. 按i键，进入编辑模式。

   3. 将DEBUG = True修改为DEBUG = False。

      

   4. 在settings.py文件开头添加如下参数。

      import os

   5. 在settings.py文件末尾添加如下参数。

      STATIC_ROOT = os.path.join(BASE_DIR, "static/")

   6. 按Esc键，输入:wq保存并退出文件。

   7. 执行如下命令，收集所有静态文件。

      sudo python3 manage.py collectstatic 

      

2. 执行以下命令，打开Nginx配置文件。

   Alibaba Cloud Linux 3.2104/Alibaba Cloud Linux 2.1903/CentOS 7.x

   sudo vim /etc/nginx/nginx.conf

   Ubuntu 22.04/Ubuntu 20.04

   sudo vim /etc/nginx/sites-enabled/default

3. 按i键进入编辑模式，在server中修改或添加以下参数。编辑完成后，按Esc键，输入:wq保存并退出文件。

       upstream django {
           server 127.0.0.1:8001; #具体端口必须与您uWSGI配置文件中定义的端口一致
       }
       server {
           listen       80; #设置的nginx访问端口
           server_name  test;
           charset      utf-8;
           location /static {
               autoindex on;
               alias /home/myblog/uwsgi_project/static; #具体目录以您现场具体部署的目录为准
           }
   
           location / {
               uwsgi_pass 127.0.0.1:8001;
               include uwsgi_params; #具体目录以您现场具体部署的目录为准
               include /etc/nginx/uwsgi_params; #具体目录以您现场具体部署的目录为准
               uwsgi_param UWSGI_SCRIPT iCourse.wsgi; #具体目录以您现场具体部署的目录为准
               uwsgi_param UWSGI_CHDIR /iCourse; #具体目录以您现场具体部署的目录为准
               index  index.html index.htm;
               client_max_body_size 35m;
               index index.html index.htm;
           }
       }

   

4. 执行以下命令，新建uWSGI配置文件uwsgi_config.ini。

   sudo vim uwsgi_config.ini

   按i键进入编辑模式，在文件中添加以下参数。编辑完成后，按Esc键，输入:wq保存并退出文件。

   [uwsgi]
   socket = 127.0.0.1:8001
   chdir = /home/myblog/uwsgi_project/
   wsgi-file = uwsgi_project/wsgi.py
   processes = 4
   threads = 2
   vacuum = true
   buffer-size = 65536

   上述参数配置说明如下所示：

   • socket：此处的8001端口需要和nginx配置文件中定义的uwsgi_pass端口一致。

   • chdir：指定项目目录，本示例中为/home/myblog/uwsgi_project，根据项目修改。

   • wsgi-file：指定Django's wsgi file文件，根据项目修改。

   • processes：最大工作进程。

   • threads：每个工作进程processes启动后开启的线程个数。

   • vacuum：环境退出时自动清理。

   • buffer-size：设置用于uwsgi包解析的内部缓存区大小为64k，默认是4k。

   

   其他参数配置请根据项目自定义添加。

5. 启动程序。

   1. 执行以下命令，重启Nginx服务。

      sudo systemctl restart nginx

   2. 执行以下命令，重启uWSGI服务。

      1. 执行以下命令，停止已启动的uWSGI程序。

         ps aux |grep uwsgi
         sudo kill -9 13187 #13187指通过上述命令获取的pid，具体pid以您现场实时获取的为准

         

      2. 执行以下命令，启动uWSGI服务。

         Alibaba Cloud Linux 3.2104/Alibaba Cloud Linux 2.1903/CentOS 7.x

         uwsgi --ini uwsgi_config.ini

         

         Ubuntu 22.04/Ubuntu 20.04

         sudo uwsgi --ini uwsgi_config.ini

6. 在本地电脑浏览器的地址栏输入http://<ECS实例的公网IP地址>，即可访问相关Django页面。