超實用 Nginx 極簡教程，覆蓋了經常使用場景

時間  2020-06-17
標籤 實用 nginx 教程 覆蓋 經常 使用 場景 欄目 Nginx 简体版
原文   原文鏈接

做者：dunwu
https://github.com/dunwu/ngin...

概述

什麼是 Nginx?javascript

Nginx (engine x) 是一款輕量級的 Web 服務器 、反向代理服務器及電子郵件（IMAP/POP3）代理服務器。css

什麼是反向代理？html

反向代理（Reverse Proxy）方式是指以代理服務器來接受 internet 上的鏈接請求，而後將請求轉發給內部網絡上的服務器，並將從服務器上獲得的結果返回給 internet 上請求鏈接的客戶端，此時代理服務器對外就表現爲一個反向代理服務器。前端

安裝與使用

安裝

詳細安裝方法請參考：Nginx服務介紹與安裝java

使用

nginx 的使用比較簡單，就是幾條命令。node

經常使用到的命令以下：linux

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，雙擊便可運行。內容以下：nginx

@echo off
rem 若是啓動前已經啓動nginx並記錄下pid文件，會kill指定進程
nginx.exe -s stop

rem 測試配置文件語法正確性
nginx.exe -t -c conf/nginx.conf

rem 顯示版本信息
nginx.exe -v

rem 按照指定配置去啓動
ginxnginx.exe -c conf/nginx.conf

若是是運行在 Linux 下，寫一個 shell 腳本，大同小異。git

nginx 配置實戰

我始終認爲，各類開發工具的配置仍是結合實戰來說述，會讓人更易理解。github

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的進程IDpid        
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:\01_Workspace\Project\github\zp\SpringNotes\spring-security\spring-shiro\src\main\webapp; 

#編碼格式        
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:\01_Workspace\Project\github\zp\SpringNotes\spring-security\spring-shiro\src\main\webapp\views;  
#過時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;       
#}    
  }
 }

好了，讓咱們來試試吧：

  1. 啓動 webapp，注意啓動綁定的端口要和 nginx 中的 upstream 設置的端口保持一致。
  2. 更改 host：在 C:\Windows\System32\drivers\etc 目錄下的 host 文件中添加一條 DNS 記錄
127.0.0.1 www.helloworld.com
  1. 啓動前文中 startup.bat 的命令
  2. 在瀏覽器中訪問 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參數表示權值，權值越高被分配到的概率越大  
server192.168.1.11:80   weight=5;  
server192.168.1.12:80   weight=1;  
server192.168.1.13:80   weight=6;  
    }  
  
#HTTP服務器  
server {  
#偵聽80端口  
listen80;  
  
#定義使用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_timeout90;          #nginx跟後端服務器鏈接超時時間(代理鏈接超時)  
proxy_send_timeout90;             #後端服務器數據回傳時間(代理髮送超時)  
proxy_read_timeout90;             #鏈接成功後，後端服務器響應時間(代理接收超時)  
proxy_buffer_size4k;              #設置代理服務器（nginx）保存用戶頭信息的緩衝區大小  
proxy_buffers432k;               #proxy_buffers緩衝區，網頁平均在32k如下的話，這樣設置  
proxy_busy_buffers_size64k;       #高負荷下緩衝大小（proxy_buffers*2）  
proxy_temp_file_write_size64k;    #設定緩存文件夾大小，大於這個值，將從upstream服務器傳  
  
client_max_body_size10m;          #容許客戶端請求的最大單文件字節數  
client_body_buffer_size128k;      #緩衝區代理緩衝用戶端請求的最大字節數  
        }  
    }  
}

網站有多個 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 ，就能夠訪問靜態站點了。

搭建文件服務器

有時候，團隊須要歸檔一些數據或資料，那麼文件服務器必不可少。使用 Nginx 能夠很是快速便捷的搭建一個簡易的文件服務。

Nginx 中的配置要點：

  • 將 autoindex 開啓能夠顯示目錄，默認不開啓。
  • 將 autoindex_exact_size 開啓能夠顯示文件的大小。
  • 將 autoindex_localtime 開啓能夠顯示文件的修改時間。
  • root 用來設置開放爲文件服務的根路徑。
  • charset 設置爲 charset utf-8,gbk;，能夠避免中文亂碼問題（windows 服務器下設置後，依然亂碼，本人暫時沒有找到解決方法）。

一個最簡化的配置以下：

autoindex on;
# 顯示目錄
autoindex_exact_size on;
# 顯示文件大小
autoindex_localtime on;
# 顯示文件時間

server {    
charset      utf-8,gbk; 
# windows 服務器下設置後，依然亂碼，暫時無解    
listen       9050 default_server;    
listen       [::]:9050 default_server;    
server_name  _;    
root         /share/fs;
}

跨域解決方案

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; 
}
}

到此，就完成了。

若有錯誤或其它問題，歡迎小夥伴留言評論、指正。若有幫助，歡迎點贊+轉發分享。

歡迎你們關注民工哥的公衆號：民工哥技術之路
image.png

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程