一、前言

獻給和我一樣懵懂中不斷汲取知識，進步的人們。

霓虹閃爍，但人們真正需要的，只是一個可以照亮前路的燭光

二、必要的前提

2.1 準備知識

• django

一個基於python的開源web框架，請確保自己熟悉它的框架目錄結構。

• uWSGI

一個基於自有的uwsgi協議、wsgi協議和http服務協議的web閘道器

• nginx

常用高效能代理伺服器

• wsgi.py

django專案攜帶的一個wsgi介面檔案
如果專案名叫destiny的話，此檔案就位於[destiny/destiny/wsgi.py]

2.2 相關資料

wsgi

：一種實現python解析的通用介面標準/協議，是一種通用的介面標準或者介面協議，實現了python web程式與伺服器之間互動的通用性。
利用它，web.py或bottle或者django等等的python web開發框架，就可以輕鬆地部署在不同的web server上了；

uwsgi:同WSGI一樣是一種通訊協議
uwsgi協議是一個uWSGI伺服器自有的協議，它用於定義傳輸資訊的型別，它與WSGI相比是兩樣東西。

uWSGI :一種python web server或稱為Server/Gateway
uWSGI類似tornadoweb或者flup，是一種python web server，uWSGI是實現了uwsgi和WSGI兩種協議的Web伺服器，負責響應python 的web請求。
因為apache、nginx等，它們自己都沒有解析動態語言如php的功能，而是分派給其他模組來做，比如apache就可以說內建了php模組，讓人感覺好像apache就支援php一樣。
uWSGI實現了wsgi協議、uwsgi協議、http等協議。 Nginx中HttpUwsgiModule的作用是與uWSGI伺服器進行交換。

2.3 專案流程
其實網上很多教程，都是關於uwsgi+nginx部署django的，StackOverflow也有一些解決常見錯誤的方法，但是部署還是容易出問題，新手難解決。
歸根到底是自己不瞭解整個專案的流程。教程都只教方法，但為什麼這樣部署，這樣部署有什麼好處，每個元件都起什麼作用卻隻字不提。致使只要部署稍微有那麼一點不同，就無可是從了。
所以說，專案流程和每個元件的用途才是此次部署最重要的部分。

首先客戶端請求服務資源，
nginx作為直接對外的服務介面,接收到客戶端傳送過來的http請求,會解包、分析，
如果是靜態檔案請求就根據nginx配置的靜態檔案目錄，返回請求的資源，
如果是動態的請求,nginx就通過配置檔案,將請求傳遞給uWSGI；uWSGI 將接收到的包進行處理，並轉發給wsgi，
wsgi根據請求呼叫django工程的某個檔案或函式，處理完後django將返回值交給wsgi，
wsgi將返回值進行打包，轉發給uWSGI，
uWSGI接收後轉發給nginx,nginx最終將返回值返回給客戶端(如瀏覽器)。
*注:不同的元件之間傳遞資訊涉及到資料格式和協議的轉換
 

作用:
1. 第一級的nginx並不是必須的，uwsgi完全可以完成整個的和瀏覽器互動的流程；
2. 在nginx上加上安全性或其他的限制，可以達到保護程式的作用；
3. uWSGI本身是內網介面，開啟多個work和processes可能也不夠用，而nginx可以代理多臺uWSGI完成uWSGI的負載均衡；
4. django在debug=False下對靜態檔案的處理能力不是很好，而用nginx來處理更加高效。

三、安裝與配置

首先，確保你已經安裝好了nginx並可以正常使用。
其次，確保自己安裝完成了python，並已經完成了pip的安裝。如果沒有，請先安裝。
接著，別忘了確認自己專案所需的django已經完成安裝並正常工作。
沒有的話參考以下命令安裝django , 建立一個工程或利用已經寫好的工程，開啟瀏覽器，輸入部署地址(如:http://127.0.0.1:8000/)(或http://內網ip:8000、或http://外網ip:8000)測試，確認是否可正常開啟瀏覽。

安裝:sudo pip install django==1.10
測試:python manage.py runserver 0.0.0.0:8000

上面的工作都完成了，接著安裝uWSGI

sudo pip install uwsgi

測試uWSGI: 新建檔案test.py，寫入以下內容

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

執行

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

如果端口占用，使用

lsof -i :8000

列出佔用埠的程式的pid號，並使用以下命令殺掉所有佔用埠的程式

sudo kill -9 pid

然後瀏覽 http://127.0.0.1:8000(或http://內網ip:8000、或http://外網ip:8000)檢視效果，有”Hello World”輸出即安裝成功。

下一步，建立工程單獨的nginx配置檔案
首先確認自己準確的知道nginx的預設配置檔案目錄(nginx.conf)的路徑，如果不清楚，請使用如下命令獲取:

nginx -t

大概會列出以下類似資訊:

nginx: the configuration file /etc/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/conf/nginx.conf test is successful

裡面說明了nginx預設配置檔案的路徑是:/etc/nginx/conf/nginx.conf；

然後，確保nginx.conf的同目錄下有uwsgi_params檔案(/etc/nginx/conf/uwsgi_params)，沒有的話根據連結獲取， 後面要用到。

在自己的工程目錄下，建立如destiny.conf（/wwwroot/destiny/destiny.conf）的配置檔案；複製nginx.conf裡面全部的內容，全部寫入destiny.conf中。
然後按照下面寫的，把destiny.conf配置檔案中的server段部分全部替換掉。

server {
    listen 80;
    server_name localhost;
    charset     utf-8;
    access_log      /wwwroot/destiny/nginx_access.log;
    error_log       /wwwroot/destiny/nginx_error.log;
    client_max_body_size 75M;


    location /static {
        alias /wwwroot/destiny/destiny/static;
    }

    location / {
        include     /etc/nginx/conf/uwsgi_params;
        uwsgi_pass  127.0.0.1:9090;
    }
}

其中的 listen 80代表伺服器開放80埠；
location [目錄名]代表專案路徑的引導;
access_log 和error_log是定義nginx訪問日誌和錯誤日誌的存放路徑。
“location /static”中的”/static”是自己定義的專案引用靜態檔案時，瀏覽器中顯示的靜態資源所在的根目錄名;這樣的話，使用者在瀏覽器中檢視到的所有image、css或js資源都是處在http://127.0.0.1/static下的。
django靜態檔案的絕對路徑是根據自己的實際情況來確定的，一般在自己的django的app名/static目錄下,或自己python manage.py collectstatic後的路徑下。像我的是在/wwwroot/destiny/destiny/static根目錄下。
“location /”是指訪問專案根目錄時，nginx要做的事。其中需要指定 uwsgi_params檔案的絕對路徑，上面已經提到了；如果還有media檔案之類的靜態目錄，仿照static的寫法，自己補充。
127.0.0.1:9090是指uWSGI繫結的監聽地址，這裡使用了9090埠。
需要注意的是，請確認自己django的靜態檔案目錄所有者是www使用者，如果不是，請用以下命令更改靜態目錄許可權歸屬者:

sudo chown -R www:www /wwwroot/destiny/destiny/static

下面接著建立uWSGI的配置檔案，在自己工程目錄下建立uwsgi.ini檔案,寫入以下內容

[uwsgi]
socket = 127.0.0.1:9090
chdir=/wwwroot/destiny
module=destiny.wsgi
master = true         
processes=2
threads=2
max-requests=2000
chmod-socket=664
vacuum=true
daemonize = /wwwroot/destiny/uwsgi.log

其中的socket欄位值”127.0.0.1:9090”必須要和上面寫的density.conf配置檔案中的uWSGI監聽地址完全一樣;
chdir指自己工程的絕對路徑;
module指的是wsgi.py在自己工程中的相對路徑，”.”指代一層目錄;我的django工程的wsgi.py檔案是在”/wwwroot/destiny/destiny/wsgi.py”，所以寫成destiny.wsgi;
daemonize指定uWSGI日誌的儲存路徑。

好了，現在理一下路徑:

工程路徑:                  /wwwroot/destiny
工程靜態檔案路徑:            /wwwroot/destiny/destiny/static
wsgi.py的路徑:             /wwwroot/destiny/destiny/wsgi.py
uwsgi.ini的路徑:           /wwwroot/destiny/uwsgi.ini
uwsgi日誌路徑:             /wwwroot/destiny/uwsgi.log
destiny.conf的路徑:        /wwwroot/destiny/destiny.conf
uwsgi_params的路徑:        /etc/nginx/conf/uwsgi_params
nginx訪問日誌路徑:          /wwwroot/destiny/nginx_access.log
nginx錯誤日誌路徑:          /wwwroot/destiny/nginx_error.log

可以發現，我幾乎把所有有關工程的配置檔案和日誌檔案都放在工程目錄下了，方便後期維護與查錯。
啟動uWSGI

sudo uwsgi --ini /wwwroot/destiny/destiny.ini

啟動nginx
在這之前，我們要先去nginx配置檔案的根目錄拷貝mime.types(/etc/nginx/conf/mime.types)到工程目錄(/wwwroot/destiny/mime.types)，和destiny.conf放在一起。
否則用配置檔案啟動nginx會報錯:

nginx: [emerg] open() "/**/**/**/mime.types" failed (2: No such file or directory)

當然，如果不想拷貝mime.types檔案，也可以將配置檔案中“include mime.types;”一項，改成絕對路徑“include /etc/nginx/conf/mime.types;”
如果nginx已經開啟，先關閉nginx(service nginx stop或nginx -s stop)，再執行以下命令:

nginx -c /wwwroot/destiny/destiny.conf

這裡的-c 表示載入配置檔案啟動

四、後記

到這裡，工作基本就做完了，可以開啟瀏覽器，輸入自己專案的IP地址，如http://127.0.0.1/檢視效果了。

1. 如果啟動時就報錯，檢視終端資訊，解決錯誤。
   如果終端沒有報錯，但是瀏覽時出現500、502等錯誤，就去專案目錄檢視nginx日誌和uWSGI日誌，解決錯誤。

2. 自己在部署時，遇到很多坑，網上的教程大多附帶virtualenv和supervisor的部署，但是連最基本的部署都說不明白，部署出來的東西效能再好也沒指導意義。基於自己踩坑脫坑的過程，寫下此文。

3. 正如以上所說，我只是用單獨的一個conf檔案，在nginx上部署了一個工程，沒有說明部署多個工程的問題；也沒有使用virtualenv開發環境、使用supervisor來管理程序等。請根據個人愛好和需要去實踐擴充套件。