nginx配置技巧匯總

scq000 發(fā)布于2019-07-25 13:22 / 3158人閱讀

摘要：本文記錄了一些作為反向代理和文件服務(wù)器的配置技巧和解決方案，原文會持續(xù)更新作為文件服務(wù)避免瀏覽器自動播放文件有時對于圖片視頻，瀏覽器會視能力，自動為用戶顯示或播放。

本文記錄了一些nginx作為反向代理和文件服務(wù)器的配置技巧和解決方案，原文會持續(xù)更新

Nginx作為文件服務(wù) 避免瀏覽器自動播放文件

有時對于圖片、視頻，瀏覽器會視能力，自動為用戶顯示或播放。這主要是由于Web服務(wù)器在返回文件本身數(shù)據(jù)的同時，返回了一些特殊的MIME類型，比如：image/jpeg（JPEG圖像）,application/pdf（PDF文檔）,video/mpeg（MPEG動畫）。這些MIMIE類型實際上是告訴瀏覽器，文件數(shù)據(jù)到底是什么，這樣瀏覽器就能更好的為用戶展示數(shù)據(jù)。現(xiàn)在像圖片、pdf、甚至是視頻基本都是可以直接在瀏覽器中展示和播放的。但是有時，我們需要瀏覽器為用戶下載文件而不是直接播放，而Nginx在默認(rèn)配置下，會根據(jù)文件的后綴來匹配相應(yīng)的MIME類型，并寫入Response header，導(dǎo)致瀏覽器播放文件而不是下載，這時需要通過配置讓Nginx返回的MIME類型為下面這個類型：

application/octet-stream

這個類型會讓瀏覽器認(rèn)為響應(yīng)是普通的文件流，并提示用戶下載文件。可以通過在Nginx的配置文件中做如下配置達(dá)到這樣的目的：

location /download/ {
    types        { }
    default_type application/octet-stream;
}

這樣當(dāng)Url路徑中包含/download/時，MIME類型會被重置為application/octet-stream。另外，nginx自帶的MIME類型映射表保存在conf/mime.types中。

文件上傳大小限制放開

有的時候后端的Web-Server提供文件上傳的服務(wù)，但是如果前端使用Nginx做反向代理時，會出現(xiàn)文件無法上傳的問題，這可能是由于Ngxin默認(rèn)對客戶端請求的body的限制。因為，默認(rèn)情況下Nginx對客戶端請求的大小限制是1m，而上傳的文件往往超過1m。可以通過修改如下配置項，來放寬這個限制：

client_max_body_size 10m;

將這個值設(shè)置為0，可以取消這個限制。這個配置項可以用在http, server, location配置節(jié)中。詳見client_max_body_size

下載文件重命名

通常情況下，為了保證用戶上傳的文件在服務(wù)器的文件系統(tǒng)中不至于重名，一般會將文件名修改成guid后保存，并在數(shù)據(jù)庫中保持guid與文件名的映射。此時，如果使用Nginx來提供對這些用戶文件的下載功能的話，文件下載到用戶瀏覽器，會以文件的guid名作為文件名，這顯然是用戶不想看到的。可以考慮用這個方案。
假設(shè)我們有一個文件的原始文件名為test.txt，對應(yīng)的guid文件名是21EC2020-3AEA-1069-A2DD-08002B30309D.txt，文件的虛擬路徑是/download/

使用服務(wù)器端編程語言，在輸出的html中使用如下鏈接提供文件的下載：

下載test.txt

可以看到，將原始文件名以QueryString的方式帶在請求中，這樣可以在Nginx端，利用$arg_name變量來取到這個QueryString的值，從而重寫response header：

add_header Content-Disposition "attachment; filename=$arg_n";

這會在response header中加入如下鍵值：

Content-Disposition: "attachment; filename=test.txt";

經(jīng)測試，無論是IE還是Chrome都可以支持這個header。

  關(guān)于Content-Disposition，詳見這里
  
  關(guān)于Nginx的標(biāo)準(zhǔn)http模塊的嵌入變量，詳見這里

Nginx作為反向代理 一個IP多個域名

如果只有一個公網(wǎng)IP，但是網(wǎng)站功能需要劃分為多個不同的子網(wǎng)站或者子域名，可以用Nginx來搭建反向代理來“復(fù)用”IP資源。假設(shè)有如下幾個域名都是abc.com這個主域的：

www.abc.com
image.abc.com
video.abc.com

1. 首先在DNS出注冊這3個域名同時指向同一個IP，Nginx作為前端的web服務(wù)器，讓所有訪問這個IP地址80端口的請求全部指向Nginx
2. 然后，配置Nginx，根據(jù)域名將請求轉(zhuǎn)發(fā)轉(zhuǎn)發(fā)給內(nèi)網(wǎng)的上游服務(wù)器，例如下面的配置：

    server {
        listen 80;
        server_name www.abc.com;
        location / {
                proxy_pass http://192.168.1.100;
        }
     }

    server {
        listen 80;
        server_name image.abc.com;
        location / {
                alias /var/www/image;
        }
     }

    server {
        listen 80;
        server_name video.abc.com;
        location / {
                proxy_pass http://192.168.1.100:8081/video;
        }
     }

在上述配置中，將三個域名分發(fā)給了不同的模塊處理：

www.abc.com 分發(fā)給上游的http://192.168.1.100服務(wù)器處理

image.abc.com 則直接映射到了Nginx本機(jī)的一個目錄

video.abc.com 分發(fā)給上游的http://192.168.1.100:8081/video服務(wù)器處理（video是上游web-server的某虛擬目錄)

上游服務(wù)器超時

Nginx作為反向代理的時候，如果上游服務(wù)器處理時間過長的話，有時會返回504網(wǎng)關(guān)超時，從nginx的錯誤日志看出如果是upstream timed out，就表示是上游服務(wù)器處理時間過長，Nginx認(rèn)為服務(wù)超時。Nginx在請求上游服務(wù)器時默認(rèn)的超時時間為1分鐘，可以通過調(diào)整proxy_read_timeout屬性增加這個超時時間