詳解python使用Nginx和uWSGI來(lái)運(yùn)行Python應(yīng)用

uWSGI是一個(gè)Web應(yīng)用服務(wù)器，它具有應(yīng)用服務(wù)器，代理，進(jìn)程管理及應(yīng)用監(jiān)控等功能。它支持WSGI協(xié)議，同時(shí)它也支持自有的uWSGI協(xié)議，該協(xié)議據(jù)說(shuō)性能非常高，而且內(nèi)存占用率低，為mod_wsgi的一半左右，我沒(méi)有實(shí)測(cè)過(guò)。它還支持多應(yīng)用的管理及應(yīng)用的性能監(jiān)控。雖然uWSGI本身就可以直接用來(lái)當(dāng)Web服務(wù)器，但一般建議將其作為應(yīng)用服務(wù)器配合Nginx一起使用，這樣可以更好的發(fā)揮Nginx在Web端的強(qiáng)大功能。本文我們就來(lái)介紹如何搭建uWSGI+Ngnix環(huán)境來(lái)運(yùn)行Python應(yīng)用。

安裝uWSGI    
pip install uwsgi
讓我們來(lái)寫(xiě)個(gè)Hello World的WSGI應(yīng)用，并保存在”server.py”文件中：
  
def application(environ, start_response):
  status = '200 OK'
  output = 'Hello World!'
 
  response_headers = [('Content-type', 'text/plain'),
            ('Content-Length', str(len(output)))]
  start_response(status, response_headers)
 
  return [output]

讓我們?cè)趗WSGI中運(yùn)行它，執(zhí)行命令：    
uwsgi --http :9090 --wsgi-file server.py

然后打開(kāi)瀏覽器，訪問(wèn)”http://localhost:9090″，你就可以看到”Hello World!”字樣了。

上面的命令中”- -http”參數(shù)指定了HTTP監(jiān)聽(tīng)地址和端口，”- -wsgi-file”參數(shù)指定了WSGI應(yīng)用程序入口，uWSGI會(huì)自動(dòng)搜尋名為”application”的應(yīng)用對(duì)象并調(diào)用它。

更進(jìn)一步，uWSGI可以支持多進(jìn)程和多線程的方式啟動(dòng)應(yīng)用，也可以監(jiān)控應(yīng)用的運(yùn)行狀態(tài)。我們將啟動(dòng)的命令改為：

復(fù)制代碼 代碼如下:

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

執(zhí)行它后，uWSGI將啟動(dòng)4個(gè)應(yīng)用進(jìn)程，每個(gè)進(jìn)程有2個(gè)線程，和一個(gè)master主進(jìn)程（監(jiān)控其他進(jìn)程狀態(tài)，如果有進(jìn)程死了，則重啟）。同時(shí)，你可以訪問(wèn)”127.0.0.1:9191″來(lái)獲取JSON格式的應(yīng)用運(yùn)行信息，uWSGI還提供了工具命令”uwsgitop”來(lái)像top一樣監(jiān)控應(yīng)用運(yùn)行狀態(tài)，你可以用pip來(lái)安裝它。

上面的命令參數(shù)太多了,我們可以將參數(shù)寫(xiě)在配置文件里，啟動(dòng)uWSGI時(shí)指定配置文件即可。配置文件可以是鍵值對(duì)的格式，也可以是XML，YAML格式，這里我們使用鍵值對(duì)的格式。讓我們創(chuàng)建一個(gè)配置文件”myapp.ini”：    
[uwsgi]
http=:9090
wsgi-file=server.py
master=true
processes=4
threads=2
stats=127.0.0.1:9191

然后就可以將啟動(dòng)命令簡(jiǎn)化為：    
$ uwsgi myapp.ini

配置Nginx

Nginx的安裝可以參考這篇文章，文本采用的環(huán)境就是Ubuntu Linux，對(duì)于其他系統(tǒng)如Mac，基本上差不太多

首先，我們將uWSGI的HTTP端口監(jiān)聽(tīng)改為socket端口監(jiān)聽(tīng)，即將配置文件中的”http”項(xiàng)去掉，改為”socket”項(xiàng)：    
[uwsgi]
socket=127.0.0.1:3031
wsgi-file=server.py
master=true
processes=4
threads=2
stats=127.0.0.1:9191

然后，打開(kāi)Nginx的配置文件，Ubuntu上默認(rèn)是”/etc/nginx/sites-enabled/default”文件，將其中的根路徑部分配置為：
    
location / {
  include uwsgi_params;
  uwsgi_pass 127.0.0.1:3031;
}

這段配置表明Nginx會(huì)將收到的所有請(qǐng)求都轉(zhuǎn)發(fā)到”127.0.0.1:3031″端口上，即uWSGI服務(wù)器上?，F(xiàn)在讓我們重啟Nginx，并啟動(dòng)uWSGI服務(wù)器：    
$ sudo service nginx restart
$ uwsgi myapp.ini

訪問(wèn)”http://localhost”，我們會(huì)再次看到”Hello World!”。

運(yùn)行Flask應(yīng)用

其實(shí)很簡(jiǎn)單，只要將上例中server.py的內(nèi)容改為Flask應(yīng)用即可，當(dāng)然你需要先把Flask包安裝好：    
from flask import Flask
application = Flask(__name__)
 
@application.route('/')
def index():
  return '<h1>Hello World</h1>'

很多人習(xí)慣將Flask應(yīng)用對(duì)象取名為”app”，但是WSGI標(biāo)準(zhǔn)是”application”。uWSGI提供了一個(gè)功能，可以指定應(yīng)用對(duì)象，方法就是在配置文件中加上”callable”項(xiàng)：
    
[uwsgi]
...
callable=app

現(xiàn)在，我們的Flask應(yīng)用就可以使用”app”作為對(duì)象名了
    
from flask import Flask
app = Flask(__name__)
 
@app.route('/')
def index():
  return '<h1>Hello World</h1>'

使用Python虛擬環(huán)境

我們永遠(yuǎn)都是建議采用虛擬環(huán)境來(lái)避免應(yīng)用間沖突，uWSGI可以非常容易做到這點(diǎn)，就是在配置文件中加上”virtualenv”項(xiàng)：    
[uwsgi]
...
virtualenv＝/home/bjhee/virtualenv

部署多個(gè)應(yīng)用

 一個(gè)Nginx中，可以同時(shí)運(yùn)行多個(gè)應(yīng)用，不一定是Python的應(yīng)用。我們期望通過(guò)不同的路徑來(lái)路由不同的應(yīng)用，因此就不能像上例那樣直接修改根目錄的配置。假設(shè)我們希望通過(guò)”http://localhost/myapp”來(lái)訪問(wèn)我們的應(yīng)用，首先要在Nginx的配置文件中，加入下面的內(nèi)容：    
location /myapp {
  include uwsgi_params;
  uwsgi_param SCRIPT_NAME /myapp;
  uwsgi_pass 127.0.0.1:3031;
}

這里我們定義了一個(gè)uWSGI參數(shù)”SCRIPT_NAME”，值為應(yīng)用的路徑”/myapp”。接下來(lái)，在uWSGI的啟動(dòng)配置中，去掉”wsgi-file”項(xiàng)，并加上：    
[uwsgi]
...
mount=/myapp=server.py
manage-script-name=true

“mount”參數(shù)表示將”/myapp”地址路由到”server.py”中，”manage-script-name”參數(shù)表示啟用之前在Nginx里配置的”SCRIPT_NAME”參數(shù)。再次重啟Nginx和uWSGI，你就可以通過(guò)”http://localhost/myapp”來(lái)訪問(wèn)應(yīng)用了。

補(bǔ)充內(nèi)容

上面的所有例子中，我們是通過(guò)”127.0.0.1:3031″Socket端口來(lái)連接Nginx和uWSGI的，其實(shí)我們也可以采用socket文件的方式，這樣可以不用寫(xiě)死端口。在uWSGI的啟動(dòng)配置中，我們要修改”socket”項(xiàng)：    
[uwsgi]
socket=/tmp/uwsgi.sock
...

啟動(dòng)uWSGI服務(wù)器后，它會(huì)自動(dòng)創(chuàng)建一個(gè)”/tmp/uwsgi.sock”文件。然后讓我們修改Nginx配置文件，將”uwsgi_pass”配置項(xiàng)改為文件：    
location /myapp {
  include uwsgi_params;
  uwsgi_param SCRIPT_NAME /myapp;
  uwsgi_pass unix:/tmp/uwsgi.sock;
}
重啟Nginx服務(wù)器即可。這里我開(kāi)始一直沒(méi)跑通，研究了好久才發(fā)現(xiàn)，Nginx的用戶（默認(rèn)的www-date:adm），必須要對(duì)該文件有讀寫(xiě)的權(quán)限才行。因?yàn)檫\(yùn)行uWSGI的用戶與運(yùn)行Nginx的用戶不一樣，而”/tmp/uwsgi.sock”是由uWSGI的用戶創(chuàng)建的，導(dǎo)致Nginx沒(méi)有足夠的權(quán)限。如果朋友們也遇到同樣的問(wèn)題，那就只能chmod了。
另外，還是要提一下”.egg”包的解壓縮臨時(shí)目錄，我們?cè)诮榻Bmod_wsgi的最后提到過(guò)，在uWSGI應(yīng)用中也一樣，Linux上默認(rèn)是在用戶主目錄下，比如”/home/bjhee/.python-eggs”。你可以通過(guò)設(shè)置系統(tǒng)環(huán)境變量”P(pán)YTHON_EGG_CACHE”來(lái)改變它。