Django Web項目部署uWSGI+Nginx

• WSGI (Web Server Gateway Interface)Web服務器網關接口，是Python應用程序或框架和Web服務器之間的一種接口，被廣泛使用
• 它實現了WSGI協議、http等協議。Nginx中HttpUwsgiModule的作用是與uWSGI服務器進行交換。WSGI是一種Web服務器網關接口。

uWSGI 網關接口配置 (ubuntu 18.04 配置)

python manage.py runserver 通常只在開發和測試環境中使用。當開發結束後，完善的項目代碼需要在一個高效穩定的環境中運行，這時可以使用uWSGI。uWSGI是WSGI的一種,它可以讓Django、Flask等開發的web站點運行其中.

• 安裝uWSGI
  在線安裝 uwsgi
  $ sudo pip3 install uwsgi

• 離線安裝
  下載安裝包:
  $ pip3 download uwsgi
  下載後的文件爲 uwsgi-2.0.18.tar.gz
  離線安裝

    $ tar -xzvf uwsgi-2.0.18.tar.gz
    $ cd uwsgi-2.0.18
    $ sudo python3 setup.py install
  

• 配置uWSGI

  • 添加配置文件 項目文件夾/uwsgi.ini

    [uwsgi]
    # 套接字方式的 IP地址:端口號
    # socket=127.0.0.1:8000
    # Http通信方式的 IP地址:端口號
    http=127.0.0.1:8000
    # 項目當前工作目錄
    chdir=/home/tarena/.../my_project 這裏需要換爲項目文件夾的絕對路徑
    # 項目中wsgi.py文件的目錄，相對於當前工作目錄
    wsgi-file=my_project/wsgi.py
    # 進程個數
    process=4
    # 每個進程的線程個數
    threads=2
    # 服務的pid記錄文件
    pidfile=uwsgi.pid
    # 服務的目志文件位置
    daemonize=uwsgi.log
    

  • 修改settings.py將 DEBUG=True 改爲DEBUG=False
  • 修改settings.py 將ALLOWED_HOSTS = [] 改爲ALLOWED_HOSTS = ['*']

• uWSGI的運行管理

  • 啓動 uwsgi

    $ cd 項目文件夾
    $ sudo uwsgi --ini 項目文件夾/uwsgi.ini
    

  • 停止 uwsgi

    $ cd 項目文件夾
    $ sudo uwsgi --stop uwsgi.pid
    

  • 說明:
    當uwsgi 啓動後,當前django項目的程序已變成後臺守護進程,在關閉當前終端時此進程也不會停止。

nginx 反向代理配置

Nginx是輕量級的高性能Web服務器，提供了諸如HTTP代理和反向代理、負載均衡、緩存等一系列重要特性，在實踐之中使用廣泛。由C語言編寫，執行效率高。

• 原理:
  客戶端請求nginx,再由nginx 請求 uwsgi, 運行django下的python代碼

• ubuntu 下 nginx 安裝
  $ sudo apt install nginx

• nginx 配置
  修改nginx 的配置文件 /etc/nginx/sites-available/default

  # 在server節點下添加新的location項，指向uwsgi的ip與端口。
  server {
      ...
      location / {
          uwsgi_pass 127.0.0.1:8000;  # 重定向到127.0.0.1的8000端口
          include /etc/nginx/uwsgi_params; # 將所有的參數轉到uwsgi下
      }
      ...
  }
  

• nginx服務控制

  $ sudo /etc/init.d/nginx start|stop|restart|status
  # 或
  $ sudo service nginx start|stop|restart|status
  

  通過 start,stop,restart,status 可能實現nginx服務的啓動、停止、重啓、查撲克狀態等操作

• 修改uWSGI配置
  修改項目文件夾/uwsgi.ini下的Http通信方式改爲socket通信方式,如:

  [uwsgi]
  # 去掉如下
  # http=127.0.0.1:8000
  # 改爲
  socket=127.0.0.1:8000
  

• 重啓uWSGI服務

  $ sudo uwsgi --stop uwsgi.pid
  $ sudo uwsgi --ini 項目文件夾/uwsgi.ini
  

nginx 配置靜態文件路徑

• 解決靜態資源路徑問題

  # file : /etc/nginx/sites-available/default
  # 新添加location /static 路由配置，重定向到指定的絕對路徑
  server {
      ...
      location /static {
          # root static文件夾所在的絕對路徑,如:
           ; # 重定向/static請求的路徑，這裏改爲你項目的文件夾
      }
      ...
  }
  

• 修改配置文件後需要重新啓動 nginx 服務

404 界面

在模板文件夾內添加名爲 404.html 的模版，當視圖觸發Http404 異常時將會被顯示
404.html 僅在發佈版中(即setting.py 中的 DEBUG=False時) 才起作用
當相應的處理函數觸發Http404異常時就會跳轉到404界面

from django.http import Http404
def xxx_view(request):
    raise Http404  # 直接返回404