天天看點

超詳細的Nginx簡易教程,一學就會!

什麼是Nginx?

Nginx (engine x) 是一款輕量級的Web 伺服器 、反向代理伺服器及電子郵件(IMAP/POP3)代理伺服器。本文的作者為「靜默虛空」 ,可點選文章底部的閱讀原文關注作者部落格。

什麼是反向代理?

反向代理(Reverse Proxy)方式是指以代理伺服器來接受internet上的連接配接請求,然後将請求轉發給内部網絡上的伺服器,并将從伺服器上得到的結果傳回給internet上請求連接配接的用戶端,此時代理伺服器對外就表現為一個反向代理伺服器。

超詳細的Nginx簡易教程,一學就會!

安裝與使用

安裝

nginx官網下載下傳位址:

http://nginx.org

,釋出版本分為 Linux 和 windows 版本。

也可以下載下傳源碼,編譯後運作。

從源代碼編譯 Nginx

把源碼解壓縮之後,在終端裡運作如下指令:

$ ./configure
$ make
$ sudo make install
           

預設情況下,Nginx 會被安裝在 /usr/local/nginx。通過設定編譯選項,你可以改變這個設定。

Windows 安裝

為了安裝 Nginx / Win32,需先下載下傳它。然後解壓之,然後運作即可。下面以 C 盤根目錄為例說明下:

cd C:
cd C: ginx-0.8.54   start nginx
           

Nginx / Win32 是運作在一個控制台程式,而非 windows 服務方式的。伺服器方式目前還是開發嘗試中。

使用

nginx 的使用比較簡單,就是幾條指令。

常用到的指令如下:

nginx -s stop :快速關閉Nginx,可能不儲存相關資訊,并迅速終止web服務。

nginx -s quit :平穩關閉Nginx,儲存相關資訊,有安排的結束web服務。

nginx -s reload :因改變了Nginx相關配置,需要重新加載配置而重載。

nginx -s reopen :重新打開日志檔案。

nginx -c filename :為 Nginx 指定一個配置檔案,來代替預設的。

nginx -t :不運作,而僅僅測試配置檔案。nginx 将檢查配置檔案的文法的正确性,并嘗試打開配置檔案中所引用到的檔案。

nginx -v:顯示 nginx 的版本。

nginx -V:顯示 nginx 的版本,編譯器版本和配置參數。

如果不想每次都敲指令,可以在nginx安裝目錄下新添一個啟動批處理檔案startup.bat,輕按兩下即可運作。内容如下:

@echo off

rem 如果啟動前已經啟動nginx并記錄下pid檔案,會kill指定程序

nginx.exe -s stop

rem 測試配置檔案文法正确性

nginx.exe -t -c conf/nginx.conf

rem 顯示版本資訊

nginx.exe -v

rem 按照指定配置去啟動nginx

nginx.exe -c conf/nginx.conf

如果是運作在 Linux 下,寫一個 shell 腳本,大同小異。

nginx 配置實戰

我始終認為,各種開發工具的配置還是結合實戰來講述,會讓人更易了解。

http反向代理配置

我們先實作一個小目标:不考慮複雜的配置,僅僅是完成一個 http 反向代理。

nginx.conf 配置檔案如下:

注:conf / nginx.conf 是 nginx 的預設配置檔案。你也可以使用 nginx -c 指定你的配置檔案

#運作使用者
#user somebody;

#啟動程序,通常設定成和cpu的數量相等
worker_processes  1;

#全局錯誤日志
error_log  D:/Tools/nginx-1.10.1/logs/error.log;
error_log  D:/Tools/nginx-1.10.1/logs/notice.log  notice;
error_log  D:/Tools/nginx-1.10.1/logs/info.log  info;

#PID檔案,記錄目前啟動的nginx的程序ID
pid        D:/Tools/nginx-1.10.1/logs/nginx.pid;

#工作模式及連接配接數上限
events {
   worker_connections 1024;    #單個背景worker process程序的最大并發連結數
}

#設定http伺服器,利用它的反向代理功能提供負載均衡支援
http {
   #設定mime類型(郵件支援類型),類型由mime.types檔案定義
   include       D:/Tools/nginx-1.10.1/conf/mime.types;
   default_type  application/octet-stream;
   
   #設定日志
   log_format  main  '[$remote_addr] - [$remote_user] [$time_local] "$request" '
                     '$status $body_bytes_sent "$http_referer" '
                     '"$http_user_agent" "$http_x_forwarded_for"';
                     
   access_log    D:/Tools/nginx-1.10.1/logs/access.log main;
   rewrite_log     on;
   
   #sendfile 指令指定 nginx 是否調用 sendfile 函數(zero copy 方式)來輸出檔案,對于普通應用,
   #必須設為 on,如果用來進行下載下傳等應用磁盤IO重負載應用,可設定為 off,以平衡磁盤與網絡I/O處理速度,降低系統的uptime.
   sendfile        on;
   #tcp_nopush     on;

   #連接配接逾時時間
   keepalive_timeout  120;
   tcp_nodelay        on;
   
   #gzip壓縮開關
   #gzip  on;

   #設定實際的伺服器清單 
   upstream zp_server1{
       server 127.0.0.1:8089;
   }

   #HTTP伺服器
   server {
       #監聽80端口,80端口是知名端口号,用于HTTP協定
       listen       80;
       
       #定義使用www.xx.com通路
       server_name  www.helloworld.com;
       
       #首頁
       index index.html
       
       #指向webapp的目錄
       root D:_WorkspaceProjectgithubzpSpringNotesspring-securityspring-shirosrcmainwebapp;
       
       #編碼格式
       charset utf-8;
       
       #代理配置參數
       proxy_connect_timeout 180;
       proxy_send_timeout 180;
       proxy_read_timeout 180;
       proxy_set_header Host $host;
       proxy_set_header X-Forwarder-For $remote_addr;

       #反向代理的路徑(和upstream綁定),location 後面設定映射的路徑
       location / {
           proxy_pass http://zp_server1;
       } 

       #靜态檔案,nginx自己處理
       location ~ ^/(images|javascript|js|css|flash|media|static)/ {
           root D:_WorkspaceProjectgithubzpSpringNotesspring-securityspring-shirosrcmainwebappiews;
           #過期30天,靜态檔案不怎麼更新,過期可以設大一點,如果頻繁更新,則可以設定得小一點。
           expires 30d;
       }
   
       #設定檢視Nginx狀态的位址
       location /NginxStatus {
           stub_status           on;
           access_log            on;
           auth_basic            "NginxStatus";
           auth_basic_user_file  conf/htpasswd;
       }
   
       #禁止通路 .htxxx 檔案
       location ~ /.ht {
           deny all;
       }
       
       #錯誤處理頁面(可選擇性配置)
       #error_page   404              /404.html;
       #error_page   500 502 503 504  /50x.html;
       #location = /50x.html {
       #    root   html;
       #}
   }
}
           

好了,讓我們來試試吧:

啟動 webapp,注意啟動綁定的端口要和nginx中的 upstream 設定的端口保持一緻。

更改 host:

在 C:WindowsSystem32driversetc 目錄下的host檔案中添加一條DNS 記錄127.0.0.1 www.helloworld.com

啟動前文中 startup.bat 的指令

在浏覽器中通路 www.helloworld.com,不出意外,已經可以通路了。

負載均衡配置

上一個例子中,代理僅僅指向一個伺服器。

但是,網站在實際營運過程中,多半都是有多台伺服器運作着同樣的app,這時需要使用負載均衡來分流。

nginx也可以實作簡單的負載均衡功能。

假設這樣一個應用場景:将應用部署在 192.168.1.11:80、192.168.1.12:80、192.168.1.13:80 三台linux環境的伺服器上。網站域名叫 www.helloworld.com,公網IP為 192.168.1.11。在公網IP所在的伺服器上部署 nginx,對所有請求做負載均衡處理。

nginx.conf 配置如下:

http {
    #設定mime類型,類型由mime.type檔案定義
   include       /etc/nginx/mime.types;
   default_type  application/octet-stream;
   #設定日志格式
   access_log    /var/log/nginx/access.log;

   #設定負載均衡的伺服器清單
   upstream load_balance_server {
       #weigth參數表示權值,權值越高被配置設定到的幾率越大
       server 192.168.1.11:80   weight=5;
       server 192.168.1.12:80   weight=1;
       server 192.168.1.13:80   weight=6;
   }

  #HTTP伺服器
  server {
       #偵聽80端口
       listen       80;
       
       #定義使用www.xx.com通路
       server_name  www.helloworld.com;

       #對所有請求進行負載均衡請求
       location / {
           root        /root;                 #定義伺服器的預設網站根目錄位置
           index       index.html index.htm;  #定義首頁索引檔案的名稱
           proxy_pass  http://load_balance_server ;#請求轉向load_balance_server 定義的伺服器清單

           #以下是一些反向代理的配置(可選擇性配置)
           #proxy_redirect off;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           #後端的Web伺服器可以通過X-Forwarded-For擷取使用者真實IP
           proxy_set_header X-Forwarded-For $remote_addr;
           proxy_connect_timeout 90;          #nginx跟後端伺服器連接配接逾時時間(代理連接配接逾時)
           proxy_send_timeout 90;             #後端伺服器資料回傳時間(代理發送逾時)
           proxy_read_timeout 90;             #連接配接成功後,後端伺服器響應時間(代理接收逾時)
           proxy_buffer_size 4k;              #設定代理伺服器(nginx)儲存使用者頭資訊的緩沖區大小
           proxy_buffers 4 32k;               #proxy_buffers緩沖區,網頁平均在32k以下的話,這樣設定
           proxy_busy_buffers_size 64k;       #高負荷下緩沖大小(proxy_buffers*2)
           proxy_temp_file_write_size 64k;    #設定緩存檔案夾大小,大于這個值,将從upstream伺服器傳
           
           client_max_body_size 10m;          #允許用戶端請求的最大單檔案位元組數
           client_body_buffer_size 128k;      #緩沖區代理緩沖使用者端請求的最大位元組數
       }
   }
}
           

網站有多個webapp的配置

當一個網站功能越來越豐富時,往往需要将一些功能相對獨立的子產品剝離出來,獨立維護。這樣的話,通常,會有多個 webapp。

舉個例子:假如 www.helloworld.com 站點有好幾個webapp,finance(金融)、product(産品)、admin(使用者中心)。通路這些應用的方式通過上下文(context)來進行區分:

www.helloworld.com/finance/
www.helloworld.com/product/
www.helloworld.com/admin/
           

我們知道,http的預設端口号是80,如果在一台伺服器上同時啟動這3個 webapp 應用,都用80端口,肯定是不成的。是以,這三個應用需要分别綁定不同的端口号。

那麼,問題來了,使用者在實際通路 www.helloworld.com 站點時,通路不同 webapp,總不會還帶着對應的端口号去通路吧。是以,你再次需要用到反向代理來做處理。

配置也不難,來看看怎麼做吧:

http {
   #此處省略一些基本配置
   
   upstream product_server{
       server www.helloworld.com:8081;
   }
   
   upstream admin_server{
       server www.helloworld.com:8082;
   }
   
   upstream finance_server{
       server www.helloworld.com:8083;
   }

   server {
       #此處省略一些基本配置
       #預設指向product的server
       location / {
           proxy_pass http://product_server;
       }

       location /product/{
           proxy_pass http://product_server;
       }

       location /admin/ {
           proxy_pass http://admin_server;
       }
       
       location /finance/ {
           proxy_pass http://finance_server;
       }
   }
}
           

https反向代理配置

一些對安全性要求比較高的站點,可能會使用 HTTPS(一種使用ssl通信标準的安全HTTP協定)。

這裡不科普 HTTP 協定和 SSL 标準。但是,使用 nginx 配置 https 需要知道幾點:

HTTPS 的固定端口号是 443,不同于 HTTP 的 80 端口

SSL 标準需要引入安全證書,是以在 nginx.conf 中你需要指定證書和它對應的 key

其他和 http 反向代理基本一樣,隻是在 Server 部配置設定置有些不同。

#HTTP伺服器
 server {
     #監聽443端口。443為知名端口号,主要用于HTTPS協定
     listen       443 ssl;

     #定義使用www.xx.com通路
     server_name  www.helloworld.com;

     #ssl證書檔案位置(常見證書檔案格式為:crt/pem)
     ssl_certificate      cert.pem;
     #ssl證書key位置
     ssl_certificate_key  cert.key;

     #ssl配置參數(選擇性配置)
     ssl_session_cache    shared:SSL:1m;
     ssl_session_timeout  5m;
     #數字簽名,此處使用MD5
     ssl_ciphers  HIGH:!aNULL:!MD5;
     ssl_prefer_server_ciphers  on;

     location / {
         root   /root;
         index  index.html index.htm;
     }
 }
           

靜态站點配置

有時候,我們需要配置靜态站點(即 html 檔案和一堆靜态資源)。

舉例來說:如果所有的靜态資源都放在了 /app/dist 目錄下,我們隻需要在 nginx.conf 中指定首頁以及這個站點的 host 即可。

配置如下:

worker_processes  1;

events {
   worker_connections  1024;
}

http {
   include       mime.types;
   default_type  application/octet-stream;
   sendfile        on;
   keepalive_timeout  65;

   gzip on;
   gzip_types text/plain application/x-javascript text/css application/xml text/javascript application/javascript image/jpeg image/gif image/png;
   gzip_vary on;

   server {
       listen       80;
       server_name  static.zp.cn;

       location / {
           root /app/dist;
           index index.html;
           #轉發任何請求到 index.html
       }
   }
}
           

然後,添加 HOST:

127.0.0.1 static.zp.cn,此時,在本地浏覽器通路 static.zp.cn ,就可以通路靜态站點了。

跨域解決方案

web 領域開發中,經常采用前後端分離模式。這種模式下,前端和後端分别是獨立的 web 應用程式,例如:後端是 Java 程式,前端是 React 或 Vue 應用。

各自獨立的 web app 在互相通路時,勢必存在跨域問題。解決跨域問題一般有兩種思路:

CORS

在後端伺服器設定 HTTP 響應頭,把你需要運作通路的域名加入加入 Access-Control-Allow-Origin 中。

jsonp

把後端根據請求,構造json資料,并傳回,前端用 jsonp 跨域。

這兩種思路,本文不展開讨論。

需要說明的是,nginx 根據第一種思路,也提供了一種解決跨域的解決方案。

舉例:www.helloworld.com 網站是由一個前端 app ,一個後端 app 組成的。前端端口号為 9000, 後端端口号為 8080。

前端和後端如果使用 http 進行互動時,請求會被拒絕,因為存在跨域問題。來看看,nginx 是怎麼解決的吧:

首先,在 enable-cors.conf 檔案中設定 cors :

# allow origin list
set $ACAO '*';

# set single origin
if ($http_origin ~* (www.helloworld.com)$) {
 set $ACAO $http_origin;
}

if ($cors = "trueget") {
   add_header 'Access-Control-Allow-Origin' "$http_origin";
   add_header 'Access-Control-Allow-Credentials' 'true';
   add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
   add_header 'Access-Control-Allow-Headers' 'DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type';
}

if ($request_method = 'OPTIONS') {
 set $cors "${cors}options";
}

if ($request_method = 'GET') {
 set $cors "${cors}get";
}

if ($request_method = 'POST') {
 set $cors "${cors}post";
}
           

接下來,在你的伺服器中 include enable-cors.conf 來引入跨域配置:

# ----------------------------------------------------
# 此檔案為項目 nginx 配置片段
# 可以直接在 nginx config 中 include(推薦)
# 或者 copy 到現有 nginx 中,自行配置
# www.helloworld.com 域名需配合 dns hosts 進行配置
# 其中,api 開啟了 cors,需配合本目錄下另一份配置檔案
# ----------------------------------------------------
upstream front_server{
 server www.helloworld.com:9000;
}
upstream api_server{
 server www.helloworld.com:8080;
}

server {
 listen       80;
 server_name  www.helloworld.com;

 location ~ ^/api/ {
   include enable-cors.conf;
   proxy_pass http://api_server;
   rewrite "^/api/(.*)$" /$1 break;
 }

 location ~ ^/ {
   proxy_pass http://front_server;
 }
}
           

到此,就完成了。

繼續閱讀