淺談Django+Gunicorn+Nginx部署之路
前言
最近,我已經(jīng)成功將我的個(gè)人網(wǎng)站從 Flask 遷移到 Django 了,最早接觸 Django 的時(shí)候大概是在 4 年前,我記得那個(gè)時(shí)候 Django 中的路由配置使用 正則 來(lái)進(jìn)行的,但是我有特別煩這個(gè)東西,所以就果斷棄坑了。然后今年年初的時(shí)候,我用 Flask 寫了一個(gè)我的個(gè)人網(wǎng)站,剛開(kāi)始的時(shí)候功能還是比較簡(jiǎn)單,看著路由配置和部署規(guī)則都很方便,就果斷采用了。但是后來(lái)我想添加的功能越來(lái)越多的時(shí)候,我發(fā)現(xiàn)我已經(jīng)越來(lái)越難掌控它了,正好最近我稍微看了一下 Django 這幾年的變化,最新的 2.2 版本還是很不錯(cuò)的,路由規(guī)則和 Flask 已經(jīng)一致了,所以我就重新入坑了。
目前我的個(gè)人網(wǎng)站基本功能已經(jīng)遷移完畢。但是在部署的時(shí)候,我遇到了一些問(wèn)題,在網(wǎng)上看了一些解決方法,要么太亂,要么太舊,個(gè)人覺(jué)得都已經(jīng)不太適用了。所以在這里記錄一下我的部署過(guò)程。
部署
網(wǎng)上有很多都是用 UWSGI 的方式來(lái)部署,但是我個(gè)人比較喜歡 Gunicorn,所以以下內(nèi)容我只是記錄了 Django + Gunicorn + Nginx 在 Ubuntu 上的部署方式相關(guān)內(nèi)容。
步驟一
上傳網(wǎng)站源碼至目標(biāo)服務(wù)器
由于我的源碼是用 Github 來(lái)托管的,所以我直接執(zhí)行下述命令來(lái)克隆我的網(wǎng)站源碼到服務(wù)器即可。
git clone https://github.com/your-name/repo-name.git # 進(jìn)入項(xiàng)目目錄 cd repo-name # 創(chuàng)建并激活虛擬環(huán)境 python3 -m virtualenv venv source venv/bin/activate # 安裝項(xiàng)目依賴 pip install -r requirements.txt
目前我的網(wǎng)站采用的相關(guān)依賴包如下:
autopep8 Django django-bootstrap4 django-ckeditor gunicorn Markdown Pillow python-slugify requests
這里有個(gè)坑需要注意,如果你使用了 awesome-slugify,請(qǐng)嘗試使用 python-slugify,因?yàn)橛械姆?wù)器可能無(wú)法正常安裝 awesome-slugify,具體 BUG 可參考:Clashes with python-slugify package。
步驟二
修改項(xiàng)目相關(guān)配置,并進(jìn)行靜態(tài)資源收集
由于我需要將我的網(wǎng)站部署到生產(chǎn)環(huán)境,所以我需要關(guān)閉 Django 的調(diào)試模式,并修改靜態(tài)資源相關(guān)配置,示例配置如下所示:
settings.py
SECRET_KEY = os.environ.get('DJANGO_SECRET_KEY') DEBUG = os.environ.get('DJANGO_DEBUG', False) TEMPLATE_DEBUG = os.environ.get('DJANGO_TEMPLATE_DEBUG', False) ALLOWED_HOSTS = ["*"] TEMPLATES = [ { 'BACKEND': 'django.template.backends.django.DjangoTemplates', 'DIRS': [os.path.join(BASE_DIR, 'templates')], 'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ 'django.template.context_processors.debug', 'django.template.context_processors.request', 'django.contrib.auth.context_processors.auth', 'django.contrib.messages.context_processors.messages', ], }, }, ] STATIC_URL = '/static/' STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') STATICFILES_DIRS = [ os.path.join(BASE_DIR, 'static'), ] MEDIA_URL = '/media/' MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
然后執(zhí)行如下命令進(jìn)行靜態(tài)資源收集:
python manage.py collectstatic
之后,我還需要?jiǎng)?chuàng)建一個(gè) Gunicorn 進(jìn)程的相關(guān)配置,示例配置如下所示:
gunicorn.conf.py
# 安裝 # sudo pip3 install gunicorn import sys import os import logging import logging.handlers from logging.handlers import WatchedFileHandler import multiprocessing BASE_DIR = '/home/hippie/hippiezhou.fun/src' sys.path.append(BASE_DIR) LOG_DIR = os.path.join(BASE_DIR, 'log') if not os.path.exists(LOG_DIR): os.makedirs(LOG_DIR) # 綁定的ip與端口 bind = "0.0.0.0:8000" # 以守護(hù)進(jìn)程的形式后臺(tái)運(yùn)行 daemon = True # 最大掛起的連接數(shù),64-2048 backlog = 512 # 超時(shí) timeout = 30 # 調(diào)試狀態(tài) debug = False # gunicorn要切換到的目的工作目錄 chdir = BASE_DIR # 工作進(jìn)程類型(默認(rèn)的是 sync 模式,還包括 eventlet, gevent, or tornado, gthread, gaiohttp) worker_class = 'sync' # 工作進(jìn)程數(shù) workers = multiprocessing.cpu_count() # 指定每個(gè)工作進(jìn)程開(kāi)啟的線程數(shù) threads = multiprocessing.cpu_count() * 2 # 日志級(jí)別,這個(gè)日志級(jí)別指的是錯(cuò)誤日志的級(jí)別(debug、info、warning、error、critical),而訪問(wèn)日志的級(jí)別無(wú)法設(shè)置 loglevel = 'info' # 日志格式 access_log_format = '%(t)s %(p)s %(h)s "%(r)s" %(s)s %(L)s %(b)s %(f)s" "%(a)s"' # 其每個(gè)選項(xiàng)的含義如下: ''' h remote address l '-' u currently '-', may be user name in future releases t date of the request r status line (e.g. ``GET / HTTP/1.1``) s status b response length or '-' f referer a user agent T request time in seconds D request time in microseconds L request time in decimal seconds p process ID ''' # 訪問(wèn)日志文件 accesslog = os.path.join(LOG_DIR, 'gunicorn_access.log') # 錯(cuò)誤日志文件 errorlog = os.path.join(LOG_DIR, 'gunicorn_error.log') # pid 文件 pidfile = os.path.join(LOG_DIR, 'gunicorn_error.pid') # 訪問(wèn)日志文件,"-" 表示標(biāo)準(zhǔn)輸出 accesslog = "-" # 錯(cuò)誤日志文件,"-" 表示標(biāo)準(zhǔn)輸出 errorlog = "-" # 進(jìn)程名 proc_name = 'hippiezhou_fun.pid' # 更多配置請(qǐng)執(zhí)行:gunicorn -h 進(jìn)行查看
之后可用通過(guò)如下方式啟動(dòng)我們的網(wǎng)站:
# 啟動(dòng)方式(首先需要切換到項(xiàng)目根目錄,即和 manage.py 在同級(jí)目錄下): gunicorn -c gunicorn.conf.py website.wsgi:application # 或 gunicorn website.wsgi:application -b 0.0.0.0:8000 -w 4 -k gthread # 或 gunicorn website.wsgi:application -b 0.0.0.0:8000 -w 4 -k gthread --thread 40 --max-requests 4096 --max-requests-jitter 512 # 查看進(jìn)程 ps aux | grep gunicorn
步驟三
配置 Nginx
通過(guò)前兩步,我們可以成功將我們的網(wǎng)站跑起來(lái),但是目前還只能在內(nèi)部訪問(wèn),所以我們需要通過(guò) Nginx 來(lái)做反向代理,供外網(wǎng)訪問(wèn)。
執(zhí)行下述命令進(jìn)行安裝和配置
sudo apt-get install nginx sudo service nginx start # 備份默認(rèn)配置 sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.bak # 啟動(dòng) Vim 修改我們的網(wǎng)站配置 sudo vim /etc/nginx/sites-available/default
示例配置如下所示:
server{ ... server_name hippiezhou.fun *.hippiezhou.fun; access_log /var/log/nginx/access.log; error_log /var/log/nginx/error.log; ... location / { # First attempt to serve request as file, then # as directory, then fall back to displaying a 404. # try_files $uri $uri/ =404; proxy_pass http://127.0.0.1:8000; #此處要和你 gunicore 的 ip 和端口保持一致 proxy_redirect off; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location /static { alias /root/hippiezhou.fun/src/staticfiles; # 此次需要配置為你的網(wǎng)站對(duì)應(yīng)的靜態(tài)資源的絕對(duì)路徑 } location /media { alias /root/hipiezhou.fun/src/media; # 如果你的網(wǎng)站有上傳功能,需要配置該結(jié)點(diǎn)并指向目標(biāo)路徑 } ... }
配置完成后執(zhí)行下述操作即可將我們的網(wǎng)站運(yùn)行起來(lái)
# 若網(wǎng)站未啟動(dòng)執(zhí)行該命令 gunicorn -c gunicorn.conf.py website.wsgi:application sudo nginx -t sudo service nginx restart
如果不出意外,網(wǎng)站應(yīng)該是可以正常訪問(wèn),如果靜態(tài)資源依然不能訪問(wèn),打開(kāi)網(wǎng)站的 開(kāi)發(fā)者工具看一下是什么錯(cuò)誤。
- 如果是 404 的問(wèn)題,請(qǐng)確保你的 settings 相關(guān)配置和我上面列出來(lái)的是一致的;
- 如果是 403 的問(wèn)題,應(yīng)該是 Nginx 無(wú)權(quán)訪問(wèn)你指定的靜態(tài)資源,你需要修改 Nginx 的用戶類型,親執(zhí)行下述命令
sudo vim /etc/nginx/nginx.conf
將 user 后面的值修改為 root,然后重啟 Nginx 即可。
最后,關(guān)于如何配置 HTTPS,這里就不過(guò)多介紹了,直接列出相關(guān)示例腳本:
sudo apt-get update sudo apt-get install software-properties-common sudo add-apt-repository universe sudo add-apt-repository ppa:certbot/certbot sudo apt-get update sudo apt-get install certbot python-certbot-nginx sudo certbot --nginx # sudo certbot renew --dry-run sudo ufw allow https sudo systemctl restart nginx
總結(jié)
在部署的過(guò)程中,其實(shí)遇到最多的問(wèn)題就是關(guān)于靜態(tài)資源無(wú)法問(wèn)題的問(wèn)題,但是看到網(wǎng)上很多文章,都不一樣,并且有的寫的還是錯(cuò)誤的。所以這里就總結(jié)一些。還好,一切順利。算是填了 4 年前的一個(gè)坑吧。
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
python類的方法屬性與方法屬性的動(dòng)態(tài)綁定代碼詳解
這篇文章主要介紹了python類的方法屬性與方法屬性的動(dòng)態(tài)綁定代碼詳解,具有一定借鑒價(jià)值,需要的朋友可以參考下2017-12-12在tensorflow下利用plt畫論文中l(wèi)oss,acc等曲線圖實(shí)例
這篇文章主要介紹了在tensorflow下利用plt畫論文中l(wèi)oss,acc等曲線圖實(shí)例,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-06-06django 實(shí)現(xiàn)手動(dòng)存儲(chǔ)文件到model的FileField
這篇文章主要介紹了django 實(shí)現(xiàn)手動(dòng)存儲(chǔ)文件到model的FileField,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-03-03python實(shí)現(xiàn)圖像隨機(jī)裁剪的示例代碼
這篇文章主要介紹了python實(shí)現(xiàn)圖像隨機(jī)裁剪的示例代碼,幫助大家更好的理解和使用python處理圖片,感興趣的朋友可以了解下2020-12-12基于python批量處理dat文件及科學(xué)計(jì)算方法詳解
今天小編就為大家分享一篇基于python批量處理dat文件及科學(xué)計(jì)算方法詳解,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-05-05深入淺析Python 函數(shù)注解與匿名函數(shù)
這篇文章主要介紹了Python 函數(shù)注解與匿名函數(shù)的相關(guān)知識(shí),本文通過(guò)實(shí)例代碼給大家介紹的非常詳細(xì),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-02-02Python實(shí)現(xiàn)的堆排序算法原理與用法實(shí)例分析
這篇文章主要介紹了Python實(shí)現(xiàn)的堆排序算法,簡(jiǎn)單描述了堆排序的原理,并結(jié)合實(shí)例形式分析了Python實(shí)現(xiàn)堆排序的相關(guān)操作技巧,代碼中備有較為詳細(xì)的注釋便于理解,需要的朋友可以參考下2017-11-11