Diango博客--Nginx + Gunicorn + Supervisor 方式部署

0.部署前準備

1）使用比較流行的 Nginx + Gunicorn 的方式將 django 開發的博客部署到自己的服務器，讓別人能夠通過域名訪問博客。

2）開發使用的本地環境爲 Windows 10，服務器環境爲 CentOS 7（64 位）

3）輔助工具 Xshell

1.創建一個超級用戶

adduser fxd
passwd fxd
usermod -aG wheel fxd
su - fxd

新用戶創建並切換成功了。如果是新服務器的話，最好先更新一下系統，避免因爲版本太舊而給後面安裝軟件帶來麻煩。運行下面的兩條命令：

sudo yum update
sudo yum upgrade

2.更新 SQLite3

爲了方便，我們博客使用了 SQLite3 數據庫，django 2.2 要求 SQLite3 數據庫版本在 3.8.3 以上，而 CentOS 7 系統自帶版本低於 django 2.2 所要求的最低版本，所以首先來更新 SQLite3 的版本。

注意：有可能你使用的服務器系統發行版 SQLite3 已經高於 3.8.3，這一步就可以跳過。請執行 sqlite3 --version 查看 SQLite3 的版本

首先登陸到 sqlite 的官方下載地址，查看最新發布的版本，本教程使用版本爲 3.29.0，找到該版本的源碼壓縮包，複製其下載鏈接，然後通過 wget 命令下載到服務器（一般將源碼放在 ~/src 目錄下。）

mkdir -p ~/src
cd ~/src

下載 sqlite3 源碼並解壓安裝

wget https://sqlite.org/2019/sqlite-autoconf-3290000.tar.gz
tar zxvf sqlite-autoconf-3290000.tar.gz
cd sqlite-autoconf-3290000
./configure
make
sudo make install

注意：如果 wget 命令不存在，使用 sudo yum install -y wget 安裝即可。

報錯：./configure報錯

解決方法：sudo yum install -y gcc glibc
之後執行 ./configure

查看sqlite3版本：
Xshell中重新打開一個終端：

sqlite3 --version

3.安裝 Python3 、pip3.6以及 Pipenv

CentOS 7 自帶的 Python 發行版爲 2.7，因此需要安裝 Python3，爲了兼容性，我們安裝 Python 3.6.4。
首先安裝可能的依賴：

sudo yum install -y openssl-devel bzip2-devel expat-devel gdbm-devel readline-devel sqlite-devel

然後下載 Python 3.6.4 的源碼並解壓：

cd ~/src
wget https://www.python.org/ftp/python/3.6.4/Python-3.6.4.tgz
tar -zxvf Python-3.6.4.tgz

最後編譯安裝：

cd Python-3.6.4
./configure LD_RUN_PATH=/usr/local/lib LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include"
make LD_RUN_PATH=/usr/local/lib
sudo make install

注意這裏安裝 Python 時，Python 會依賴 SQLite3 的庫，所以在 configure 時通過 LD_RUN_PATH 指定依賴的搜索目錄（因爲我們之前更新了 SQLite3 的版本，指定依賴搜索目錄確保使用新的 SQLite3 依賴庫），另外兩個參數作用類似。

然後輸入 python3.6 -V 和 pip3.6 -V 命令測試安裝結果，輸出版本號說明安裝成功了。

有了 pip，就可以安裝 Pipenv 了：

首先建立軟連接：

sudo ln -s /usr/local/bin/pip3.6 /usr/bin/pip3.6
sudo ln -s /usr/local/bin/pip3 /usr/bin/pip3

然後安裝：

sudo pip3.6 install pipenv

注意：
python2.7和python3.6的區別
pip2.7和pip3.6的區別
以下部分列出兩種指令的輸出情況，供參考：

[fxd@instance-6lf3j8lp Python-3.6.4]$ python --version
Python 2.6.6
[fxd@instance-6lf3j8lp Python-3.6.4]$ python3.6 --version
Python 3.6.4


[fxd@instance-6lf3j8lp Python-3.6.4]$ pip --version
pip 7.1.0 from /usr/lib/python2.6/site-packages (python 2.6)
[fxd@instance-6lf3j8lp Python-3.6.4]$ pip3.6 --version
pip 9.0.1 from /usr/local/lib/python3.6/site-packages (python 3.6)


[fxd@instance-6lf3j8lp Python-3.6.4]$ pip freeze
argparse==1.2.1
backports.ssl-match-hostname==3.4.0.2
boto==2.34.0
chardet==2.2.1
Cheetah==2.4.1
cloud-init==0.7.5
configobj==4.6.0
ethtool==0.6
iniparse==0.3.1
jsonpatch==1.2
jsonpointer==1.0
M2Crypto==0.20.2
Markdown==2.0.1
oauth==1.0.1
ordereddict==1.2
policycoreutils-default-encoding==0.1
prettytable==0.7.2
pycurl==7.19.0
Pygments==1.1.1
pygpgme==0.1
python-dmidecode==3.10.15
PyYAML==3.10
requests==2.6.0
setools==1.0
six==1.9.0
urlgrabber==3.9.1
urllib3==1.10.2
yum-metadata-parser==1.1.2

[fxd@instance-6lf3j8lp Python-3.6.4]$ pip3.6 freeze
certifi==2019.11.28
pipenv==2018.11.26
virtualenv==16.7.8
virtualenv-clone==0.5.3

4.部署代碼

1）首先要對項目做一點配置，打開 settings.py，找到 ALLOWED_HOSTS，將其修改爲：

ALLOWED_HOSTS = [‘127.0.0.1’, 'localhost ', ‘.zmrenwu.com’]

指定了 ALLOWED_HOSTS 的值後，django 將只允許通過指定的域名訪問我們的應用，比如這裏只允許通過 127.0.0.1，localhost 以及 zmrenwu.com 和其任意子域名（域名前加一個點表示允許訪問該域名下的子域名）訪問（即 HTTP 報文頭部中 Host 的值必須是以上指定的域名，通常你在瀏覽器輸入域名訪問網站時，Host 的值就會被設置爲網站的域名），這樣可以避免 HTTP Host 頭攻擊。

2）Django 項目中會有一些 CSS、JavaScript 等靜態文件，爲了能夠方便地讓 Nginx 處理這些靜態文件的請求，我們把項目中的全部靜態文件收集到一個統一的目錄下，這個目錄通常位於 django 項目的根目錄，並且命名爲 static。爲了完成這些任務，需要在項目的配置文件裏做一些必要的配置：
文件位置：blogproject/settings.py

# 其他配置...

STATIC_URL = '/static/'
# 加入下面的配置
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

STATIC_ROOT 即指定靜態文件的收集路徑，這裏指定爲 BASE_DIR（項目根目錄，在 settings.py 文件起始處定義）下的 static 文件夾。

3）使用 git上傳代碼至服務器。首先安裝 git：

sudo yum install -y git

將代碼上傳到 GitHub 等代碼託管平臺，這樣我們就可以方便地把代碼拉取到服務器了。如何將pycharm中的項目上傳至github上，請戳這裏。

通常將應用代碼放在 ~/apps/ 目錄下，先來設置一下服務器的文件結構，用於存放應用代碼等相關文件：

#在用戶目錄下創建 apps 目錄並進入
mkdir -p ~/apps
cd ~/apps
#拉取博客代碼
git clone https://github.com/fanxindong/HelloDjango-blog-tutorial-fxd.git

注意：上傳的項目代碼，需要將其中數據庫遷移時生成的代碼刪除，在服務器上重新遷移！

然後進入到項目根目錄，安裝項目依賴：

cd ~/apps/HelloDjango-blog-tutorial
pipenv install --deploy --ignore-pipfile

然後創建一下數據庫：

pipenv run python manage.py makemigrations
pipenv run python manage.py migrate

此時查看目錄發現已經生成數據庫文件db.sqlite3

4)啓動開發服務器：

pipenv run python manage.py runserver 0.0.0.0:8000

在瀏覽器中輸入服務器域名和端口號，出現博客內容！

5.使用 Gunicorn

首先進入到項目根目錄，安裝 Gunicorn：

pipenv install gunicorn

由於我們在服務端修改安裝了 gunicorn，代碼中 Pipfile 文件和 Pipfile.lock 文件會被更新，因此別忘了把改動同步到本地，具體做法可以自行學習，以下是一個參考：

#服務端提交代碼
git add Pipfile Pipfile.lock

若此時報錯，則按照要求輸出github的name和email
[root@instance-6lf3j8lp HelloDjango-blog-tutorial-fxd]# git config --global user.name “your-name”
[root@instance-6lf3j8lp HelloDjango-blog-tutorial-fxd]# git config --global user.email your-email

git commit -m “add gunicorn dependency”
git push

#本地電腦中拉取代碼
git pull

如此時出現錯誤，請戳這裏

然後回到線上服務器，在項目根目錄，執行下面的命令啓動服務：

pipenv run gunicorn blogproject.wsgi -w 2 -k gthread -b 0.0.0.0:8000

打開瀏覽器顯示如下：

各個參數的含義：

1）-w 2 表示啓動 2 個 worker 用於處理請求（一個 worker 可以理解爲一個進程），通常將 worker 數目設置爲 CPU 核心數的 2-4 倍。

2）-k gthread 指定每個 worker 處理請求的方式，根據大家的實踐，指定爲 gthread 的異步模式能獲取比較高的性能，因此我們採用這種模式。

3）-b 0.0.0.0:8000，將服務綁定到 8000 端口，運行通過公網 ip 和 8000 端口訪問應用。

4）訪問 ip:8000（ip 爲你服務器的公網 ip），應用成功訪問了，但是我們看到樣式完全亂了。別急，這不是 bug！此前我們使用 django 自帶的開發服務器，它會自動幫我們處理靜態樣式文件，但是 Gunicorn 並不會幫我們這麼做。因爲處理靜態文件並不是 Gunicorn 所擅長的事，應該將它交給更加專業的服務應用來做，比如 Nginx。

6.啓動 Nginx 服務器

Nginx是一個高性能的 HTTP 和反向代理 web 服務器，它的功能非常多，這裏我們主要用它來處理靜態文件以及將非靜態文件的請求反向代理給 Gunicorn。當我們訪問一個博客文章詳情頁面時，服務器會接收到下面兩種請求：

1. 顯示文章的詳情信息，這些信息通常保存在數據庫裏，因此需要調用數據庫獲取數據。
2. 圖片、css、js 等存在服務器某個文件夾下的靜態文件。

對於前一種請求，博客文章的數據需要藉助 django 從數據庫中獲取，Nginx 處理不了，它就會把這個請求轉發給運行在 Gunicorn 服務中的 django 應用，讓 django 去處理。

用 django 去獲取靜態文件是很耗時的，但 Nginx 可以很高效地處理，因此對於後一種靜態文件的請求，只需要去這些靜態文件所在的文件夾獲取，Nginx 就會代爲處理，不再麻煩 django。

首先安裝 Nginx：

sudo yum install epel-release -y
sudo yum install nginx -y

運行下面的命令啓動 Nginx 服務

service nginx start

小貼士：
service nginx start(啓動)
service nginx stop（停止）
service nginx reload（重啓）

在瀏覽器輸入 ip（不輸入端口則默認爲 80 端口，Nginx 默認在 80 端口監聽請求），看到 Nginx 的歡迎界面說明 Nginx 啓動成功：

7.配置 Nginx

Nginx 的配置位於 /etc/nginx/nginx.conf 文件中，其內容如下：

user nobody nobody;
...
http {
    # Load modular configuration files from the /etc/nginx/conf.d directory.
    # See http://nginx.org/en/docs/ngx_core_module.html#include
    # for more information.
    include /etc/nginx/conf.d/*.conf;

    server {
        listen       80 default_server;
        listen       [::]:80 default_server;
        server_name  _;
        root         /usr/share/nginx/html;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {
        }
    }
}

在 http 配置下有一個 server 模塊，server 模塊用於配置一個虛擬服務，使這個虛擬服務監聽指定的端口和域名。你可以配置多個 server，這樣就會啓動多個虛擬服務，用於監聽不同端口，或者是同一個端口，但是不同的域名，這樣你就可以在同一服務器部署多個 web 應用了。

再來看看 server 下的 include，include 會將指定路徑中配置文件包含進來，這樣便於配置的模塊化管理，例如我們可以把不同 web 應用的配置放到 /etc/nginx/conf.d/ 目錄下，這樣 nginx 會把這個目錄下所有以 .conf 結尾的文件內容包含到 nginx.conf 的配置中來，而無需把所有配置都堆到 nginx.conf 中，使得配置文件十分臃腫。

我們來配置博客應用，爲了模塊化管理，我們將配置寫到 /etc/nginx/conf.d/ 目錄下。先在服務器的 conf.d 目錄下新建一個配置文件，把它叫做 HelloDjango-blog-tutorial-fxd.conf。寫入下面的配置內容：
文件位置：/etc/nginx/conf.d/HelloDjango-blog-tutorial-fxd.conf

server {
    charset utf-8;
    listen 80;
    server_name www.fanxindong.com;

    location /static {
        alias /home/fxd/apps/HelloDjango-blog-tutorial-fxd/static;
    }

    location / {
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:8000;
    }
}

首先我們配置了一個虛擬服務，編碼方式爲 utf-8，監聽於 80 端口。

服務的域名爲 www.fanxindong.com，所以來自這個域名的請求都會被這個服務所處理。

所有URL 匹配 /static 的請求均由 Nginx 處理，alias 指明瞭靜態文件的存放目錄，這樣 Nginx 就可以在這個目錄下找到請求的文件返回給客戶端。

其它請求轉發給運行在本機 8000 端口的應用程序處理，我們會在這個端口啓動 Gunicorn 用於處理 Nginx 轉發過來的請求。

重啓 nginx 使得配置生效：

service nginx reload

8.關閉 DEBUG 模式，收集靜態文件

開發環境下，django 爲了調試方便，會將 settings.py 文件中的 DEBUG 選項配置爲 True，這樣如果程序運行出錯，調試信息將一覽無餘，這在開發時很方便，但部署到線上就會帶來巨大安全隱患，所以我們把 DEBUG 選項設置爲 False，關閉調試模式，在本地將 settings.py 中的 DEBUG 爲：

DEBUG=False

線上服務器更新最新的代碼，然後運行命令收集靜態文件到之前配置的 STATIC_ROOT 目錄下：

pipenv run python manage.py collectstatic

然後使用 Gunicorn 啓動服務。

pipenv run gunicorn blogproject.wsgi -w 2 -k gthread -b 0.0.0.0:8000

9.使用 Supervisor管理 Gunicorn 進程

現在 Gunicorn 是我們手工啓動的，一旦我們退出 shell，服務器就關閉了，博客無法訪問。就算在後臺啓動 Gunicorn，萬一哪天服務器崩潰重啓了又得重新登錄服務器去啓動，非常麻煩。爲此使用 Supervisor 來管理 Gunicorn 進程，這樣當服務器重新啓動或者 Gunicorn 進程意外崩潰後，Supervisor 會幫我們自動重啓 Gunicorn。

先按 Ctrl + C 停止剛纔啓動的 Gunicorn 服務進程。

首先安裝 Supervisor。

sudo pip3 install supervisor

設置如下的目錄結構（位於 ~/etc 目錄下）來管理 Supervisor 有關的文件：

~/etc
├── supervisor
│ ├── conf.d
│ └── var
│ ├── log
└── supervisord.conf

其中 supervisord.conf 是 Supervior 的配置文件，它會包含 conf.d 下的配置。var 目錄下用於存放一些經常變動的文件，例如 socket 文件，pid 文件，log 下則存放日誌文件。

指令：
mkdir -p ~/etc/supervisor/conf.d
mkdir -p ~/etc/supervisor/var/log

然後進入 ~/etc 目錄下生成 Supervisor 的配置文件：

cd ~/etc
echo_supervisord_conf > supervisord.conf

---

1. 修改 supervisor.conf，讓 Supervisor 進程產生的一些文件生成到上面我們創建的目錄下，而不是其默認指定的地方。

首先找到 [unix_http_server] 版塊，將 file 設置改爲如下的值：

[unix_http_server]
file=/home/fxd/etc/supervisor/var/supervisor.sock

即讓 socket 文件生成在 ~/etc/supervisor/var/ 目錄下。注意 supervisor 不支持將 ~ 展開爲用戶 home 目錄，所以要用絕對路徑指定

2. 類似的修改 [supervisord] 板塊下的 logfile 和 pidfile 文件的路徑，還有 user 改爲系統用戶，這樣 supervisor 啓動的進程將以系統用戶運行，避免可能的權限問題：

logfile=/home/fxd/etc/supervisor/var/log/supervisord.log
pidfile=/home/fxd/etc/supervisor/var/supervisord.pid
user=fxd

3. 還有 [supervisorctl] 板塊下：

serverurl=unix:///home/fxd/etc/supervisor/var/supervisor.sock

4. [include] 版塊，將 /home/yangxg/etc/supervisor/conf.d/ 目錄下所有以 .ini 結尾的文件內容包含到配置中來，這樣便於配置的模塊化管理，和之前 Nginx 配置文件的處理方式是類似的。

files = /home/fxd/etc/supervisor/conf.d/*.ini

5. 然後我們到 conf.d 文件夾下，新建我們博客應用的配置hellodjango-blog-tutorial-fxd.ini：

[program:hellodjango-blog-tutorial]
command=pipenv run gunicorn blogproject.wsgi -w 2 -k gthread -b 127.0.0.1:8000
directory=/home/fxd/apps/HelloDjango-blog-tutorial-fxd
autostart=true
autorestart=unexpected
user=fxd
stdout_logfile=/home/fxd/etc/supervisor/var/log/Hellodjango-blog-tutorial-fxd-stdout.log
stderr_logfile=/home/fxd/etc/supervisor/var/log/Hellodjango-blog-tutorial-fxd-stderr.log

各項配置的含義：

[program:hellodjango-blog-tutorial] 指明運行應用的進程，名爲 hellodjango-blog-tutorial。
command 爲進程啓動時執行的命令。
directory 指定執行命令時所在的目錄。
autostart 隨 Supervisor 啓動自動啓動進程。
autorestart 進程意外退出時重啓。
user 進程運行的用戶，防止權限問題。
stdout_logfile，stderr_logfile 日誌輸出文件。

6. 啓動 Supervisor

supervisord -c ~/etc/supervisord.conf

-c 指定 Supervisr 啓動時的配置文件。

進入 supervisorctl 進程管理控制檯：

supervisorctl -c ~/etc/supervisord.conf

執行 update 命令更新配置文件並啓動應用。

瀏覽器輸入域名，可以看到服務已經正常啓動了。

10.使用 CDN 加快 Bootstrap 和 jQuery 的加載速度

我們的項目使用了 Bootstrap 和 jQuery，這兩個文件我們是從本地加載的。如果服務器性能比較差的話，加載需要耗費很長的時間，網站打開的速度就變得無法忍受。我們使用 CDN 來加快加載速度。具體來說，替換 base.html 的幾個靜態文件的加載標籤：

文件位置：base.html

- <link rel="stylesheet" href="{% static 'blog/css/bootstrap.min.css' %}">
- <script src="{% static 'blog/js/jquery-2.1.3.min.js' %}"></script>
- <script src="{% static 'blog/js/bootstrap.min.js' %}"></script>
+ <link href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
+ <script src="https://cdn.bootcss.com/jquery/2.1.3/jquery.min.js"></script>
+ <script src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>

本地修改代碼後，將代碼同步到線上服務器，執行下面的命令重啓 hellodjango-blog-tutorial 應用進程：

supervisorctl -c ~/etc/supervisord.conf restart hellodjango-blog-tutorial

這樣網站訪問的速度將大大提升！