1. 程式人生 > >跨過Nginx上基於uWSGI部署Django項目的坑

跨過Nginx上基於uWSGI部署Django項目的坑

sse djiango weight http 自帶 true 自己的 eve setting

先說說他們的關系,Nginx和uWSGI都是Web服務器,Nginx負責靜態內容,uWSGI負責Python這樣的動態內容,二者配合共同提供Web服務以實現提高效率和負載均衡等目的。uWSGI實現了多個協議,如WSGI,HTTP協議,還有它自己的uwsgi協議,想了解更多關於uWSGI和uwsgi協議內容可以查閱這裏。這樣和fastcgi類似,請求和響應的流程如下:

Request > Nginx > uWSGI > Django > uWSGI > Nginx > Response

請求先交由Nginx,如果是靜態內容就自己處理了,如果是動態內容就交給uWSGI服務器,uWSGI服務器處理整個Django項目的Python代碼,響應請求,原路返回,但是與fastcgi不同,Nginx、uWSGI和Django可以獨立部署,然後整合。那麽我們從Django開始,這裏的服務器環境是Ubuntu 16.10。

1. 部署Django的項目

安裝Python和Django,Ubuntu自帶2.7和3.5版本的Python,安裝相應的Django版本,註意在Ubuntu中不同版本Python都有相應的命令

[email protected]:~$ python --version
Python 2.7.12+
[email protected]-vm-ub01:~$ python3 --version
Python 3.5.2+
[email protected]-vm-ub01:~$ pip -V
pip 9.0.1 from /home/wisesoe/.local/lib/python2.7
/site-packages (python 2.7) [email protected]-vm-ub01:~$ pip3 -V pip 9.0.1 from /home/wisesoe/.local/lib/python3.5/site-packages (python 3.5) pip3 install django

將已經完成開發的Django項目pro(pro是Django項目名)拷貝到服務器,這裏拷貝到了www用戶(www是服務器可登錄用戶名)路徑下,最後相對路徑是~/work/project/pro,絕對路徑是/home/www/project/pro

進入以上目錄,使用Django的內置服務器測試看看pro項目是否運行正常。

python3 ./manage.py runserver 127.0.0.1:8080

2. 部署uWSGI服務器

通過pip安裝uWSGI。

pip3 install uwsgi

測試uWSGI是否正常,在~/work/project/pro目錄中創建一個測試用的Python文件uwsgi_test.py

def application(env, start_response):
        start_response(200 OK,[(Content-Type, text/html)])
        #return [‘Hello world‘] # Python2
        return [bHello world] # Python3

在pro項目路徑下,基於HTTP協議運行uWSGI,如果uWSGI安裝正常的話,可以在瀏覽器中訪問9090端口,看到Hello world字樣

uwsgi --http 127.0.0.1:9090 --wsgi-file uwsgi_test.py

接下來啟動uWSGI加載Django項目,這裏依然使用HTTP協議,將指向具體Python文件--wsgi-file參數替換為指向Django項目的--module參數,參數的值pro.wsgi指向~/work/project/pro/pro/wsgi.py模塊,如果正常可以在瀏覽器http://127.0.0.1:9090端口打開了項目,但是靜態文件路徑有問題,不過沒關系後面再處理。

[email protected]:~/work/project/pro$ uwsgi --http 127.0.0.1:9090 --module pro.wsgi

對於uWSGI服務器的配置,如上命令加上很多參數非常麻煩,可以寫成配置文件的方式,在~/work/project/pro中創建一個配置文件uwsgi.ini,註釋掉參數暫時忽略,Django 1.4以前的版本需要配置如env,pythonpath等參數,這裏不再深究了。

其中http參數用於以上測試,而與Nginx交互需要使用socket參數,即使用TCP協議,WSGI和uwsgi協議都在TCP協議之上。socket參數也可以配置為網絡地址,如socket=127.0.0.1:7070,但如果Nginx和uWSGI同在一個服務器上,可以使用socket文件的形式。chmod-socket是為了動態配置socket文件的權限,因為socket文件會在每次uWSGI啟動時被重新創建。

[uwsgi]
http=127.0.0.1:8000
#socket=/home/www/work/project/pro/nginx_uwsgi.socket
chdir=/home/www/work/project/pro/
#chmod-socket=664
master=true
processes=4
threads=2
module=pro.wsgi
#wsgi-file=uwsgi_test.py
#stats=127.0.0.1:9000

通過下面命令同樣可以啟動uWSGI加載Djiango項目

uwsgi --ini uwsgi.ini

3. 部署Nginx服務器

通過apt安裝Nginx

sudo apt install nginx

Nginx可以通過以下命令控制。正常安裝和啟動Nginx後,通過http://127.0.0.1:80可以看到Nginx的歡迎頁

sudo service nginx start
sudo service nginx stop
sudo service nginx restart

接下來修改配置Nginx配置與uWSGI服務器交互。Nginx的主要配置文件在/etc/nginx/nginx.conf和sites-enabled文件夾裏,nginx.conf是全局設置,sites-enabled文件夾裏的可以針對不同站點進行配置,其中有個默認的default配置文件,該文件其實是sites-available文件夾裏的default文件的軟鏈接,sites-avaliable像個倉庫,但只有sites-enabled裏的才有效。我們可以將sites-enabled的default刪除,再cp一份sites-available的default到sites-enabled裏重名為nginx-pro,同時cp /etc/nginx/uwsgi_params ~/work/project/pro裏以備nginx-pro配置文件調用。

#nginx-pro
 
upstream django{
        server unix:///home/wisesoe/Work/Project/Python/duty/nginx_uwsgi.sock; # file socket
        #server 127.0.0.1:7070; # TCP socket
}


server {
        listen 80 default_server;
        listen [::]:80 default_server;
        root /var/www/html;
        index index.html index.htm index.nginx-debian.html;
        server_name 127.0.0.1; # IP or FQDN

        location /static {
                alias /home/www/work/project/pro/static;
        }

        location / {
                uwsgi_pass django;
                include /home/www/work/project/pro/uwsgi_params;
                #try_files $uri $uri/ =404;
        }
}

uwsgi_params文件是Nginx向uWSGI傳遞的參數,uwsgi_pass的意思動態內容請求都通過名為django的upstream傳遞給uWSGI,這使用文件socket的方式,那麽與之前uwsgi.ini裏的socket參數配置一致。

4. Nginx權限問題

以上全部配置完成了,但是還有一個重要的權限問題,如果啟動uWSGI和Nginx(以下需要兩個終端窗口,因為uwsgi命令會占據一個),會報錯

uwsgi --ini uwsgi.ini
sudo service nginx restart

在/var/log/nginx/error.log中會看到Permission denied字樣,是對home/www/work/project/pro/nginx_uwsgi.socket文件沒有讀寫權限,即運行Nginx工作進程的用戶需要socket文件的讀寫權限。

運行Nginx的工作進程的用戶在/etc/nginx/nginx.conf中有配置,是user的值www-data,但查看/etc/group發現www-data是個用戶組

user www-data;
worker_processes auto;
pid /run/nginx.pid;

events {
        worker_connections 768;
        # multi_accept on;
}

我們可以將www用戶加入該用戶組

usermod -G www-data www

也可以將socket文件及其上級目錄pro的用戶組改為www-data,並為該用戶組授予讀寫權限

chown :www-data ~/home/work/project/pro
chown :www-data ~/home/work/project/pro/nginx_uwsgi.socket
chmod g+rw ~/home/work/project/pro/nginx_uwsgi.socket

5.Nginx和Django靜態文件處理

Django項目可以正常打開,但是靜態文件引用路徑還有問題,在Django開發時Django自己可以正確處理靜態文件的路徑,但是部署後Nginx去無法找到靜態文件路徑。

檢查Nginx配置文件夾sites-enabled裏的nginx-pro文件,確保裏面默認的try_files要刪掉或者註釋掉,否則Nginx會因此檢查靜態文件是否存在。

將Django的靜態文件集中起來,Django為此有專門的工具

現在Django的Settings文件中加上StATIC_ROOT,把靜態文件都集中到這個路徑下

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

執行命令

python3 ./manage.py collectstatic

這樣所有Django前後臺的靜態文件都會集中到項目文件夾pro下static中,另外nginx-pro其中一個配置location /static即可讓Nginx來處理靜態內容。

跨過Nginx上基於uWSGI部署Django項目的坑