docker nginx 配置文件要點及注意事項

更新時間：2025年02月13日 09:27:24 作者：忘憂人生

本文介紹了Nginx的配置要點及注意事項,包括訪問靜態(tài)資源、負(fù)載均衡等,在訪問靜態(tài)資源時,可以使用root或alias指令指定路徑,本文給大家介紹的非常詳細(xì),感興趣的朋友一起看看吧

在平常的開發(fā)工作中，我們經(jīng)常需要訪問靜態(tài)資源（圖片、HTML頁面等）、訪問文件目錄、部署項目時進(jìn)行負(fù)載均衡等。那么我們就會使用到Nginx，nginx.conf 的配置至關(guān)重要。那么今天主要結(jié)合訪問靜態(tài)資源、負(fù)載均衡等總結(jié)下 nginx.conf 的配置要點及注意事項。

1：概述

Nginx 是高性能、輕量級的 web 服務(wù)器和反向代理服務(wù)器。Nginx 可以作為靜態(tài)內(nèi)容服務(wù)，如訪問HTML頁面、圖片等。Nginx 可以作為作為反向代理服務(wù)器，隱藏服務(wù)器真實IP，用戶只知道 Nginx 的地址，這樣可以提高服務(wù)安全性。Nginx 可以將動態(tài)內(nèi)容請求轉(zhuǎn)發(fā)給后端應(yīng)用服務(wù)器。Nginx 可以將客戶端請求分發(fā)給后端服務(wù)器，通過配置實現(xiàn)負(fù)載均衡，提高系統(tǒng)的可用性。

2：訪問靜態(tài)資源

1：靜態(tài)資源在同一個目錄

(1)：掛載目錄配置

 # 頁面目錄 前面的為宿主機目錄 后面的為容器目錄，如果容器中的目錄不存在，則會自動創(chuàng)建
 - /docker/nginx/html:/usr/share/nginx/html

(2)：nginx.conf 配置文件

路徑 root 配置：適合 location 路徑與文件路徑一致的情況，路徑是拼接的。如 location 為 /wx/，root 配置為 /usr/share/html，則訪問的完整目錄為 /usr/share/html/wx/，會把 location 路徑拼接在 root 路徑后面。

user  nginx;
worker_processes  auto;
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
   server {
        listen 80;
        server_name localhost;
	    charset utf-8;
        location / {
           root /usr/share/nginx/html; #路徑為容器內(nèi)的路徑，通過掛載目錄，實際訪問到宿主機目錄
        }
    }
}

路徑 alias 配置：適合 location 路徑與文件路徑不一致的情況，路徑是替換的。如 location 配置為 test，alias 配置的文件目錄為 /usr/share/html/wx/，則訪問的目錄即為 /usr/share/html/wx/，會把 location 的路徑替換為 alias 配置的路徑。所以建議 alias 后面的路徑配置的盡可能就是靜態(tài)資源所在的目錄，這樣訪問起來更加方便。

user  nginx;
worker_processes  auto;
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    server {
        listen 80;
        server_name localhost;
	    charset utf-8;
        location /test/ {
           alias /usr/share/nginx/wx/;
        }
    }
}

(3) 訪問測試：http:ip:端口/文件路徑/test.jpg

2：靜態(tài)資源在多個目錄

(1)：掛載目錄配置，需要配置多個掛載目錄

# 頁面目錄
- /docker/nginx/html/images:/usr/share/nginx/html
- /docker/nginx/html/photo:/usr/share/nginx/wx

(2)：nginx.conf 配置文件：

user  nginx;
worker_processes  auto;
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
   server {
        listen 9016;
        server_name localhost;
	    charset utf-8;
        # 路徑 root 方式配置
        # 通過 /html/ 訪問，即文件路徑為 /usr/share/nginx/html/ 目錄
        location /html/ {
           root /usr/share/nginx;
        }
        # 通過 /wx/訪問，即文件夾路徑為 /usr/share/nginx/wx/ 目錄
        location /wx/ {
           root /usr/share/nginx;
        }
        # 路徑 alias 方式配置
        # 通過 /html/ 訪問，即文件路徑為 /usr/share/nginx/html/ 目錄
        location /html/ {
           alias /usr/share/nginx/html/;   # 配置后面帶 /
        }
        # 通過 /wx/訪問，即文件夾路徑為 /usr/share/nginx/wx/ 目錄
        location /wx/ {
           alias /usr/share/nginx/wx/;     # 配置后面帶 /
        }
    }
}

(3)：訪問圖片

????

(4) 總結(jié)：root 和 alias 都用于指定路徑，在 docker 容器中，指向的都是容器中的路徑，即需要配置掛載目錄，將宿主機的目錄掛載到容器指定的目錄。root 中路徑配置，特別注意最后面沒有 / ，根據(jù)路徑訪問時會將 location 的路徑拼接到 root 指定的路徑后面，root 配置路徑方式是進(jìn)行路徑拼接。alias 配置路徑，特別注意后面有 / ，alias 路徑配置方式訪問時，匹配對應(yīng)的 location，會將內(nèi)容替換為 alias 中配置的完整路徑。簡而言之，root 是路徑拼接，alias 是路徑替換。

3：訪問共享目錄

我們經(jīng)常需要將常用的軟件、文件等歸納整理放在服務(wù)器的某個文件夾下，為了使用更加的方便，這個時候，就需要訪問服務(wù)器上的某個目錄。

(1) nginx.conf 配置

user  nginx;
worker_processes  auto;
error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;
events {
    worker_connections  1024;
}
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  65;
    server {
        listen 80;
        server_name localhost;
	    charset utf-8;
        location /test/ {
           alias /usr/share/nginx/wx/;
           autoindex on;                   # 開啟自動索引，如果不需要可以去掉
	       autoindex_exact_size off;       # 顯示文件大小
	       autoindex_localtime on;         # 顯示文件時間 
        }
    }
}

上面配置中一定要注意，如果不添加 autoindex on，on 開啟自動索引，那么訪問文件夾時會報 403 forbidden。autoindex on 用于啟用目錄列表功能，當(dāng)訪問沒有默認(rèn)索引文件的目錄時，Nginx會自動生成包含該目錄及子目錄的 HTML 頁面并返回給客戶端。

(2)：測試如下：

4：負(fù)載均衡配置

(1)：如果服務(wù)是單節(jié)點，則不涉及負(fù)載均衡配置

user  nginx;
worker_processes  auto;
pid        /var/run/nginx.pid;
events {
    worker_connections  1024;
}
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    sendfile        on;
    keepalive_timeout  60;
	server {
        listen 80;
        server_name localhost;
	    charset utf-8;
        location / {
           proxy_pass  http://localhost:8008;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}

(2)：服務(wù)多節(jié)點負(fù)載均衡配置

負(fù)載均衡將請求分發(fā)到不同的后端服務(wù)節(jié)點，這樣可以減輕服務(wù)壓力，提高服務(wù)可用性。負(fù)載均衡可以更加合理的利用服務(wù)器的資源，有的服務(wù)器配置高，有的服務(wù)器剩余資源少，那么權(quán)重輪詢可以更加合理的使用服務(wù)器的資源。

負(fù)載均衡部署方式可以是同一個機器多個節(jié)點，也可以是多機器多節(jié)點。單機器多節(jié)點的有點在于資源利用率高、不存在跨節(jié)點通信的問題。通常用于開發(fā)環(huán)境、小型應(yīng)用、或者非關(guān)鍵服務(wù)。單機器多節(jié)點存在單點故障的問題，多節(jié)點共享資源，存在性能問題。多機器多節(jié)點性能高、方便拓展、不存在單點故障的問題，缺點是成本高、如果跨機通信，維護(hù)和配置復(fù)雜。多機器多節(jié)點適用于中大型應(yīng)用，對性能要求高的服務(wù)。

user  nginx;
worker_processes  auto;
error_log  /var/log/nginx/error.log notice;
pid        /var/run/nginx.pid;
events {
    worker_connections  1024;
}
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    access_log  /var/log/nginx/access.log  main;
    sendfile        on;
    #tcp_nopush     on;
    keepalive_timeout  65;
    #gzip  on;
    # 負(fù)載均衡，兩個節(jié)點的ip和端口，配置ip和端口即可，不需配置http頭信息
    # upstream 定義一組后端服務(wù)器
    # 默認(rèn)負(fù)載均衡方式，將請求依次發(fā)送給后端服務(wù)節(jié)點
    upstream backend {
        server 11.22.xx.xx:8001;
        server 11.22.xx.xx:8002;
    }
    # 加權(quán)輪詢，權(quán)重越大的節(jié)點處理的請求越多
    upstream backend {
        server 11.22.xx.xx:8001 weight=8;
        server 11.22.xx.xx:8002 weight=2;
    }
    # ip 哈希輪詢 根據(jù)客戶端的 IP 地址進(jìn)行哈希計算，確保同一個客戶端的請求總是分配給同一臺后端服務(wù)器。
    upstream backend {
        ip_hash;  # 啟用 IP 哈希
        server 11.22.xx.xx:8001;
        server 11.22.xx.xx:8002;
    }
   server {
        listen 80;
        server_name localhost;
        charset utf-8;
        location / {
           proxy_pass  http://backend; # 將請求轉(zhuǎn)發(fā)到 upstream 組，proxy_pass 將請求轉(zhuǎn)發(fā)給指定的目標(biāo)服務(wù)器
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}

nginx 常用輪詢方式：

默認(rèn)輪詢：默認(rèn)輪詢方式會將請求依次轉(zhuǎn)發(fā)給后端服務(wù)器

加權(quán)輪詢：配置不同的權(quán)重，權(quán)重越大的服務(wù)器處理的請求越多。主要常用于不同服務(wù)器的配置、性能有差距，或者剩余服務(wù)器資源的合理利用。

IP 哈希輪詢：根據(jù)客戶端的 IP 地址進(jìn)行哈希計算，確保同一個客戶端的請求總是分配給同一臺后端服務(wù)器。根據(jù)客戶端 IP 分配請求，適合會話保持。

以上為 Nginx 主要內(nèi)容，在平常的開發(fā)工作中，可以進(jìn)行靜態(tài)資源的訪問。如有小程序靜態(tài)資源、pc端靜態(tài)資源，則將不同的靜態(tài)資源放在不同的目錄下，配置不同的掛載目錄。root 類型配置的 location 路徑會拼接到 root 配置的路徑后面。alias 類型配置的 location 路徑主要是訪問使用，實際是將其替換為 alias 后面配置的路徑。所以 root 適用于訪問路徑和靜態(tài)資源路徑一致的場景，alias 適用于訪問路徑和靜態(tài)資源路徑不一致的場景。使用負(fù)載均衡配置配置，可以更加合理的使用服務(wù)器的資源，提高服務(wù)可用性。

到此這篇關(guān)于docker nginx 配置文件詳解的文章就介紹到這了,更多相關(guān)docker nginx 配置文件內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: