如何用 uWSGI和nginx部署django

寫在前面的話：

??????? 本文參考了其他人寫的很多文章，在后面的附錄中列舉出來，未能及時(shí)列出的引用還望作者理解，本文僅僅作為技術(shù)交流。

part1 基礎(chǔ)概念

（一）何為uWSGI：

??????? uWSGI是類似于nginx的一個(gè)服務(wù)器開發(fā)部署選項(xiàng)。在使用uWSGI協(xié)議使用WSGI應(yīng)用的時(shí)候需要uWSGI服務(wù)。uWSGI不僅是一個(gè)協(xié)議，同時(shí)是一個(gè)應(yīng)用服務(wù)器，它實(shí)現(xiàn)了uWSGI，F(xiàn)astCGI和HTTP協(xié)議[1]。nginx中的HttpUwsgiModule正是負(fù)責(zé)與uWSGI服務(wù)器進(jìn)行交換。

（二）何為nginx：

Nginx是什么？

??????? Nginx是一款面向性能設(shè)計(jì)的輕量級(jí)HTTP服務(wù)器，它能反向代理HTTP,HTTPS, SMTP, POP3,IMAP的協(xié)議鏈接，以及提供一個(gè)負(fù)載均衡器和一個(gè)HTTP緩存。相較于Apache、lighttpd具有占有內(nèi)存少，穩(wěn)定性高等優(yōu)勢(shì)。它不采用每客戶機(jī)一線程的設(shè)計(jì)模型，而是充分使用異步邏輯，削減了上下文調(diào)度開銷，所以并發(fā)服務(wù)能力更強(qiáng)[2]。

??????? Nginx具有穩(wěn)定性強(qiáng)、模塊庫豐富、配置靈活和系統(tǒng)資源占有率低的特點(diǎn)。具體優(yōu)勢(shì)請(qǐng)參看參考[3]、參考[4]中內(nèi)容。

正向代理和反向代理

??????? A找B直接溝通，這就等于沒有什么代理；然而中間夾一個(gè)傳話的C，C就是代理了，A通過C把信息傳遞給B，然后C再把B的反饋轉(zhuǎn)達(dá)給A。

??????? 在這個(gè)過程中，A知道溝通的直接目標(biāo)是B，只不過由于各種原因無法直接和B面對(duì)面，需要中間人C，這就是所謂“正向代理”。此時(shí)，A對(duì)于B是透明的。其實(shí)我們很少說正向代理，在英文原文里，這個(gè)叫Forward Proxy，一般就直接叫代理，你翻譯成“轉(zhuǎn)交代理”或“傳達(dá)代理”都比“正向代理”強(qiáng)，然而沒必要，因?yàn)榇磉@個(gè)詞的本意就是如此。

??????? 另外一種情況則是：A并不知道B的存在，它只知道找C就可以得到想要的回復(fù)，對(duì)于A來說有沒有B或者有多少個(gè)B、D、E、F……都不重要，只要有C就夠了。而C則根據(jù)情況去獲取反饋然后響應(yīng)給A，這種就叫反向代理了[5]，此時(shí)B對(duì)于A是透明的。

為什么要結(jié)合使用？

??????? Nginx相對(duì)來說，更加適合取處理靜態(tài)文件，如css、javascript、png、html等，而動(dòng)態(tài)的文件最好由Nginx轉(zhuǎn)交給uWSGI去進(jìn)行處理。

Part2 部署過程

如何部署

基礎(chǔ)頁面輸出的模型：

英文描述：the web client <-> the web server <-> the socket <-> uwsgi <-> Django

中文描述：網(wǎng)頁客戶端<->網(wǎng)頁服務(wù)器<->網(wǎng)絡(luò)套接字<->uwsgi<-> Django應(yīng)用

部署步驟：

1.準(zhǔn)備Django工程。

例：安裝Django，創(chuàng)建一個(gè)新的Django工程，名字為mysite，利用cd命令進(jìn)入工程。

sudo pip install Django==1.8.11（此處填入要安裝的Django版本）

django-admin.py startproject mysite

cd mysite

2.基礎(chǔ)的uWSGI安裝與配置

sudo pip install uwsgi（注意：這里需要一個(gè)依賴環(huán)境，如果之前沒安裝過，請(qǐng)安裝，sudo apt-get install python2.7-dev）

安裝完成后可以進(jìn)行測試，在工程的根目錄下創(chuàng)建一個(gè)test.py文件，寫入以下內(nèi)容：

#test.py

def application(env, start_response):

start_response('200 OK', [('Content-Type','text/html')])

# return [b"Hello World"] # python3

return ["Hello World"] # python2

寫入完成后執(zhí)行以下命令：

sudo uwsgi --http :8000 --wsgi-file test.py

瀏覽器訪問http://localhost：8000，看瀏覽器是否正常輸出“Hello World”

如果上述的一切正常，則表明以下環(huán)節(jié)已經(jīng)配置成功

the web client <-> uWSGI <-> Python

現(xiàn)在測試自己的Django工程

進(jìn)入到自己創(chuàng)建的工程的根目錄下，我的工程目錄在/home/jason/code/interface

cd /home/jason/code/interface

sudo python manage.py runserver 127.0.0.1:8000

使用瀏覽器打開http://127.0.0.1:8000，看工程是否啟動(dòng)

如果成功啟動(dòng)，則嘗試下面的命令

sudo uwsgi --http :8000 --module mysite.wsgi

再次使用瀏覽器，打開http://127.0.0.1:8000，看工程是否啟動(dòng)

如果上述的一切正常，則表明以下環(huán)節(jié)已經(jīng)配置成功

the web client <-> uWSGI <-> Django

3.基礎(chǔ)的ngnix配置

sudo apt-get install ngnix

一些簡單的nginx命令

啟動(dòng)nigix服務(wù)

sudo /etc/init.d/nginx start或者sudo service nginx start

停止nigix服務(wù)

sudo /etc/init.d/nginx stop或者sudo service nginx stop

重啟nigix服務(wù)

sudo /etc/init.d/nginx restart或者sudo service nginx restart

啟動(dòng)nigix服務(wù)后，打開瀏覽器，訪問127.0.0.1:80，出現(xiàn)如下圖示則表明配置成功。

如果上述的一切正常，則表明以下環(huán)節(jié)已經(jīng)配置成功

the web client <-> the web server

注意：我們一般不推薦使用80端口作為nginx的服務(wù)端口。

在配置你的應(yīng)用到nginx服務(wù)器之前我們需要一個(gè)uwsgi_params文件，你可以在你的nigix目錄（/etc/nginx/）下找到它，或者訪問nigix的github目錄（https://github.com/nginx/nginx/blob/master/conf/uwsgi_params）拷貝到它。

將它拷貝到你的工程目錄下，此處我在工程的根目錄下創(chuàng)建了一個(gè)conf目錄來存放它，具體如下圖：

現(xiàn)在創(chuàng)建一個(gè)nginx的配置文件，我的文件名稱為interface_nginx.conf

在文件中輸入如下內(nèi)容：

# interface.conf

# configuration of the server

server {

# the port your site will be served on

listen 8099;

# the domain name it will serve for

server_name 127.0.0.1;? # substitute your machine's IP address or FQDN

charset utf-8;

# max upload size

client_max_body_size 75M; # adjust to taste

# Django media

location /media? {

alias /home/jason/code/interface/media;? # your Django project's media files - amend as required

}

location /static {

expires 30d;

autoindex on;

add_header Cache-Control private;

alias /home/jason/code/interface/static;? # your Django project's static files - amend as required

}

# Finally, send all non-media requests to the Django server.

location / {

uwsgi_pass? 127.0.0.1:8000;

include /home/jason/code/interface/conf/uwsgi_params;? ? ? # the uwsgi_params file you installed

}

}

這個(gè)配置告訴nginx我們使用8099作為服務(wù)的端口，同時(shí)提供了static和media的handle處理，路徑分別為

/home/jason/code/interface/static和/home/jason/code/interface/media

（注意此處路徑的表示為：你工程的地址/static），其他的服務(wù)通過127.0.0.1:8000這個(gè)handle服務(wù)去處理。

為了讓你的nginx服務(wù)器取能識(shí)別這個(gè)配置，我們需要?jiǎng)?chuàng)建一個(gè)鏈接給該文件，具體指令如下:

sudo ln -s /home/jason/code/interface/conf/interface_nginx.conf /etc/nginx/sites-enabled

這個(gè)時(shí)候你就可以將你網(wǎng)站使用到的靜態(tài)文件搜集起來放到nginx指定的目錄下了，具體操作如下：

在工程的mysite/settings.py文件中加入

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

然后執(zhí)行sudo python manage.py collectstatic

此時(shí)你的靜態(tài)文件就都放入你之前指定的那個(gè)目錄下了。

重啟nigix服務(wù)，sudo /etc/init.d/nginx restart

打開瀏覽器，訪問你工程中的一個(gè)靜態(tài)文件，看是否能正常返回，返回則配置表明成功。

http://127.0.0.1:8099/static/bootstrap/css/bootstrap.min.css

返回如下：

完成上述工作，回到系統(tǒng)根目錄下，執(zhí)行sudo uwsgi --socket :8099 --wsgi-file test.py

通過瀏覽器訪問127.0.0.1:8000，如果能正常顯示”Hello World“則表明以下環(huán)節(jié)已經(jīng)配置成功

the web client <-> the web server <-> the socket <-> uWSGI <-> Python

4.通過.ini文件去執(zhí)行uWSGI。

在工程的根目錄下創(chuàng)建一個(gè)interface_uwsgi.ini文件，寫入以下內(nèi)容：

# mysite_uwsgi.ini file

[uwsgi]

# Django-related settings

uid=jason

pid=jason

# the base directory (full path)

chdir=/home/jason/code/interface

# Django's wsgi file

module=mysite.wsgi

# process-related settings

# master

master=true

# maximum number of worker processes

processes=10

# the socket (use the full path to be safe

socket=127.0.0.1:8000

# ... with appropriate permissions - may be needed

# chmod-socket? ? = 664

# clear environment on exit

vacuum=true

# export JSON

stats=127.0.0.1:9191

# a monitor (managed by the master process) that will destroy processes stuck for more than the specified number of seconds

harakiri=30

其中：

chdir填入你工程所在的目錄；

module填入你工程要加載的wsgi文件，此處是mysite目錄下的wsgi文件

socket填入你要使用的套接字，因?yàn)榇颂帥]使用socket所以使用tcp端口8000，如果使用了套接字則填入套接字文件的目錄。（例如：/home/jason/code/interface/mysite/mysock.sock）

配置完成上述的文件，在終端輸入：sudo uwsgi --ini interface_uwsgi.ini

通過瀏覽器訪問127.0.0.1:8099，你會(huì)發(fā)現(xiàn)你工程的主頁再次展現(xiàn)在了你的面前。至此，則表明你的配置已經(jīng)成功。

參考文檔：

（1）http://flask.pocoo.org/docs/0.10/deploying/uwsgi/

（2）https://zh.wikipedia.org/wiki/Nginx

（3）http://lnmp.org/nginx.html

（4）http://blog.csdn.net/liutengteng130/article/details/46700939（內(nèi)含正向代理和反向代理的模型說明）

（5）https://segmentfault.com/q/1010000003491873

（6）官方文檔：http://uwsgi-docs.readthedocs.org/en/latest/tutorials/Django_and_nginx.html

（7）基于nginx和uWSGI在Ubuntu上部署Djangohttp://www.itdecent.cn/p/e6ff4a28ab5a

（8）uWSGI配置例子http://projects.unbit.it/uwsgi/wiki/Example

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容