目錄[-]

Django的部署可以有很多方式，採用nginx+uwsgi的方式是其中比較常見的一種方式。今天在Ubuntu上使用Nginx部署Django服務，雖然不是第一次搞這個了，但是發現還是跳進了好多坑，google了好久才搞定。想想還是把這個過程記錄下來，免得下次再來踩同樣的坑。

安裝Nginx

apt-get install nginx

ubantu安裝完Nginx後，檔案結構大致為： 　　所有的配置檔案都在 /etc/nginx下； 　　啟動程式檔案在 /usr/sbin/nginx下； 　　日誌檔案在 /var/log/nginx/下，分別是access.log和error.log； 　　並且在 /etc/init.d下建立了啟動指令碼nginx。

sudo /etc/init.d/nginx start    # 啟動
sudo /etc/init.d/nginx stop     # 停止
sudo /etc/init.d/nginx restart  # 重啟

安裝uwsgi

apt-get install python-dev
pip install uwsgi

至於為什麼要使用uwsgi,可以參見這邊部落格：快速部署Python應用：Nginx+uWSGI配置詳解(1)。 這樣大體的流程是：nginx作為伺服器最前端，負責接收client的所有請求，統一管理。靜態請求由Nginx自己處理。非靜態請求通過uwsgi傳遞給Django，由Django來進行處理，從而完成一次WEB請求。 通訊原理是： the web client <-> the web server(nginx) <-> the socket <-> uwsgi <-> Django

測試uwsgi

在Django專案下新建test.py檔案，

# test.py
def application(env, start_response):
    start_response('200 OK', [('Content-Type','text/html')])
    return ["Hello World"] # python2
    #return [b"Hello World"] # python3

然後執行shell命令：

uwsgi --http :8001 --plugin python --wsgi-file test.py

加上--plugin python是告訴uWSGI在使用python外掛，不然很有可能會出現類似這樣的錯誤：

uwsgi: unrecognized option '--wsgi-file'
getopt_long() error

執行成功在瀏覽器中開啟：http://localhost:8001顯示Hello World說明uwsgi正常執行。

測試Django

首先得保證Django專案沒有問題

python manage.py runserver 0.0.0.0:8001

訪問http://localhost:8001,專案執行正常。 然後連結Django和uwsgi，實現簡單的web伺服器，到Django專案目錄下執行shell:

uwsgi --http :8001 --plugin python --module blog.wsgi

blog為你的專案名。訪問http://localhost:8001，專案正常。注意這時專案的靜態檔案是不會被載入的，需要用nginx做靜態檔案代理。

配置uwsgi

uwsgi支援通過配置檔案的方式啟動，可以接受更多的引數，高度可定製。我們在Django專案目錄下新建uwsgi.ini

# Django-related settings

socket = :8001

# the base directory (full path)
chdir           = /home/ubuntu/blog

# Django s wsgi file
module          = blog.wsgi

# process-related settings
# master
master          = true

# maximum number of worker processes
processes       = 4

# ... with appropriate permissions - may be needed
# chmod-socket    = 664
# clear environment on exit
vacuum          = true

在shell中執行：

sudo uwsgi --ini uwsgi.ini 

ps:如果實在不想配置nginx的話，單uwsgi就已經能完成部署了（把socket換成http），你可以把Django中的靜態檔案放到雲平臺中如七牛等等，這樣你的Web也能被正常訪問。

配置nginx

nginx預設會讀取/etc/nginx/sites-enabled/default檔案中的配置，修改其配置如下:

server {
    # the port your site will be served on
    listen      80;
    # 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/ubuntu/blog/media;  # your Django project's media files - amend as required
    }

    location /static {
        alias /home/ubuntu/blog/static; # your Django project's static files - amend as required
    }

    # Finally, send all non-media requests to the Django server.
    location / {
        include     uwsgi_params; # the uwsgi_params file you installed
        uwsgi_pass 127.0.0.1:8001;
    }
}

收集Django靜態檔案

把Django自帶的靜態檔案收集到同一個static中，不然訪問Django的admin頁面會找不到靜態檔案。在django的setting檔案中，新增下面一行內容：

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

然後到專案目錄下執行:

python manage.py collectstatic

修改配置檔案

DEBUG = False
ALLOWED_HOSTS = ['*']

執行

一切配置好後直接重啟nginx即可。更加詳細的說明請參見官方文件

可能遇到的問題

如果監聽80埠，部署後訪問localhost自動跳轉到nginx預設的歡迎介面 uwsgi: option ‘--http‘ is ambiguous