在前面的章节中我们使用 python manage.py runserver 来运行服务器。这只适用测试环境中使用。

正式发布的服务,我们需要一个可以稳定而持续的服务器,比如三大WEB服务器:apache, Nginx, lighttpd等,本文将以 Nginx 为例。

Ubuntu18.04安装Web服务nginx

一、安装 uwsgi

uWSGI是一个Web服务器,它实现了WSGI协议、uwsgi、http等协议,旨在提供专业的 Python web应用发布和开发。Nginx中HttpUwsgiModule的作用就是与uWSGI服务器进行交换。WSGI是一种Web服务器网关接口。它是一个Web服务器(如nginx,uWSGI等服务器)与web应用(如用Flask框架写的程序)通信的一种规范。


1、通过 pip 命令:

pip install uwsgi

2、通过源代码安装

wget http://projects.unbit.it/downloads/uwsgi-latest.tar.gz tar zxvf uwsgi-latest.tar.gz cd uwsgi-latest make

安装完成后,在当前目录下,你会获得一个 uwsgi 二进制文件。

3、测试 uwsgi 是否正常:

uwsgi --version    # 查看 uwsgi 版本

1、第一个 WSGI 应用

让我们从一个简单的 "Hello World" 开始,新建 test.py 文件,内容如下:

def application(env, start_response):     start_response('200 OK', [('Content-Type','text/html')])     return "Hello World"

uWSGI Python 加载器将会搜索的默认函数 application 。

接下来我们启动 uWSGI 来运行一个 HTTP 服务器,将程序部署在HTTP端口 8001上:

uwsgi --http :8001 --wsgi-file test.py

在浏览器内输入:http://127.0.0.1:8001,查看是否有"Hello World"输出,若没有输出,请检查你的安装过程。

2、添加并发和监控

默认情况下,uWSGI 启动一个单一的进程和一个单一的线程。

你可以用 --processes 选项添加更多的进程,或者使用 --threads 选项添加更多的线程 ,也可以两者同时使用。

uwsgi --http :9090 --wsgi-file foobar.py --master --processes 4 --threads 2

以上命令将会生成 4 个进程, 每个进程有 2 个线程。

如果你要执行监控任务,可以使用 stats 子系统,监控的数据格式是 JSON:

uwsgi --http :9090 --wsgi-file foobar.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

我们可以安装 uwsgitop(类似 Linux top 命令) 来查看监控数据:

pip install uwsgitop

3、uwsgi 配置

uwsgi支持ini、xml等多种配置方式,本文以 ini 为例, 在/etc/目录下新建uwsgi9090.ini,添加如下配置:

[uwsgi] socket = 127.0.0.1:9090 master = true         //主进程 vhost = true          //多站模式 no-site = true        //多站模式时不设置入口模块和文件 workers = 2           //子进程数 reload-mercy = 10      vacuum = true         //退出、重启时清理文件 max-requests = 1000    limit-as = 512 buffer-size = 30000 pidfile = /var/run/uwsgi9090.pid    //pid文件,用于下面的脚本启动、停止该进程 daemonize = /website/uwsgi9090.log

二、安装 Nginx

我们可以将 uWSGI 和 Nginx Web 服务器结合使用,实现更高的并发性能。

安装命令如下:

cd ~ wget http://nginx.org/download/nginx-1.5.6.tar.gz tar xf nginx-1.5.6.tar.gz cd nginx-1.5.6 ./configure --prefix=/usr/local/nginx-1.5.6 \ --with-http_stub_status_module \ --with-http_gzip_static_module make && make install

你可以阅读 Nginx 安装配置 了解更多内容。

一个常用的nginx配置如下:

location / {     include uwsgi_params;     uwsgi_pass 127.0.0.1:3031; }

以上代码表示使用 nginx 接收的 Web 请求传递给端口为 3031 的 uWSGI 服务来处理。

现在,我们可以生成 uWSGI 来本地使用 uwsgi 协议:

uwsgi --socket 127.0.0.1:3031 --wsgi-file foobar.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

如果你的 Web 服务器使用 HTTP,那么你必须告诉 uWSGI 本地使用 http 协议 (这与会自己生成一个代理的–http不同):

uwsgi --http-socket 127.0.0.1:3031 --wsgi-file foobar.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

1、Nginx 配置

找到nginx的安装目录(如:/usr/local/nginx/),打开conf/nginx.conf文件,修改server配置:

server {         listen       80;         server_name  localhost;                  location / {                         include  uwsgi_params;             uwsgi_pass  127.0.0.1:9090;              //必须和uwsgi中的设置一致             uwsgi_param UWSGI_SCRIPT demosite.wsgi;  //入口文件,即wsgi.py相对于项目根目录的位置,“.”相当于一层目录             uwsgi_param UWSGI_CHDIR /demosite;       //项目根目录             index  index.html index.htm;             client_max_body_size 35m;         }     }

你可以阅读 Nginx 安装配置 了解更多内容。

设置完成后,在终端运行:

uwsgi --ini /etc/uwsgi9090.ini & /usr/local/nginx/sbin/nginx

在浏览器输入:http://127.0.0.1,你就可以看到 django 的 "It work" 了。

三、部署 Django

Django 是最常使用的 Python web 框架,假设 Django 项目位于 /home/foobar/myproject:

uwsgi --socket 127.0.0.1:3031 --chdir /home/foobar/myproject/ --wsgi-file myproject/wsgi.py --master --processes 4 --threads 2 --stats 127.0.0.1:9191

--chdir 用于指定项目路径。

我们可以把以上的命令弄成一个 yourfile.ini 配置文件:

[uwsgi] socket = 127.0.0.1:3031 chdir = /home/foobar/myproject/ wsgi-file = myproject/wsgi.py processes = 4 threads = 2 stats = 127.0.0.1:9191

接下来你只需要执行以下命令即可:

uwsgi yourfile.ini

四、部署 Flask

Flask 是一个流行的 Python web 框架。

创建文件 myflaskapp.py ,代码如下:

from flask import Flask  app = Flask(__name__)  @app.route('/') def index():     return "I am app 1"

执行以下命令:

uwsgi --socket 127.0.0.1:3031 --wsgi-file myflaskapp.py --callable app --processes 4 --threads 2 --stats 127.0.0.1:9191