2025最新Nginx入門教學

本文阅读导航 展开

2021最新Nginx入門教學，本文是一個Nginx極簡教程，目的在於幫助新手快速入門Nginx，轉載自其他公眾號，方便讀者也方便自己的收藏。

Nginx簡介

什麼是Nginx？

Nginx（引擎x）是一個輕量級的Web服務器，反向代理服務器和電子郵件（IMAP / POP3）代理服務器。

什麼是反向代理？

反向代理（Reverse Proxy）方式是指以代理服務器來接受Internet上的連接請求，然後將請求轉發給內部網絡上的服務器，從服務器上得到的結果返回給Internet上請求連接的客戶端。

此時代理服務器對外就表現為一個反向代理服務器，如下圖：

Nginx入門教學

詳細安裝方法請參考：

https://github.com/dunwu/nginx-tutorial/blob/master/docs/nginx-ops.md

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配置文件如下：

#運行用戶
#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: 1_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: 1_WorkspaceProjectgithubzpSpringNotesspring-securityspring-shirosrcmainwebappviews;
            #過期 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;
        #}
    }
}

注：conf / nginx.conf是Nginx的替代配置文件。您也可以使用nginx -c指定您的配置文件。

好了，讓我們來試試吧：

啟動webapp，注意啟動綁定的端口要和Nginx中的上游設置的端口保持一致。

更改host，在C： Windows System32 drivers etc目錄下的host文件中添加一條DNS記錄：

127.0.0.1 www.jhrs.com

啟動前文中startup.bat的命令。

在瀏覽器中訪問https://www.jhrs.com，不出意外，已經可以訪問了。

HTTPS反向代理

一些對安全性要求比較高的站點，可能會使用HTTPS（一種使用ssl通信標準的安全HTTP協議）。

這裡不科普HTTP協議和SSL標準。但是，使用Nginx的配置HTTPS需要知道幾點：

HTTPS的固定端口號是443，分為HTTP的80範圍。
SSL標準需要約會安全證書，所以在nginx.conf中你需要指定證書和它對應的密鑰。

其他和HTTP反向代理基本一樣，只是在Server部分配置有些不同。

#HTTP 服務器
  server {
      #監聽 443 端口。 443 為知名端口號，主要用於 HTTPS 協議
      listen 443 ssl;

      #定義使用 www.xx.com 訪問
      server_name www.jhrs.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;
      }
  }

負載均衡

前面的示例中，代理僅指向一個服務器。但是，網站在實際運營過程中，大部分都是以累積的方式運行，這時需要使用負載均衡來分流。

Nginx也可以實現簡單的負載均衡功能。

假設這樣一個應用場景：將應用部署在192.168.1.11:80、192.168.1.12:80、192.168.1.13:80三台Linux環境的服務器上。網站域名叫www.jhrs.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.jhrs.com 訪問
        server_name www.jhrs.com;

        #對所有請求進行負載均衡請求
        location / {
            root /root; #定義服務器的默認網站根目錄位置
            index index.html index.htm; #定義首頁索引文件的名稱
            proxy_pass http://jhrs.com ;#請求轉向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; #緩衝區代理緩衝用戶端請求的最大字節數
        }
    }
}

負載均衡策略

Nginx提供了多種負載均衡策略，讓我們來一一了解一下：

負載均衡策略在各種分佈式系統中基本上原理一致，對於原理有興趣，不妨參考：

https://dunwu.github.io/blog/design/theory/load-balance-theory/

預期：

upstream bck_testing_01 {
  # 默認所有服務器權重為 1
  server 192.168.250.220:8080
  server 192.168.250.221:8080
  server 192.168.250.222:8080
}

最佳出價：

upstream bck_testing_01 {
  server 192.168.250.220:8080   weight=3
  server 192.168.250.221:8080              # default weight=1
  server 192.168.250.222:8080              # default weight=1
}

最少連接：

upstream bck_testing_01 {
  least_conn;

  # with default weight for all (weight=1)
  server 192.168.250.220:8080
  server 192.168.250.221:8080
  server 192.168.250.222:8080
}

推薦的最小連接：

upstream bck_testing_01 {
  least_conn;

  server 192.168.250.220:8080   weight=3
  server 192.168.250.221:8080              # default weight=1
  server 192.168.250.222:8080              # default weight=1
}

IP哈希：

upstream bck_testing_01 {

  ip_hash;

  # with default weight for all (weight=1)
  server 192.168.250.220:8080
  server 192.168.250.221:8080
  server 192.168.250.222:8080

}

普通哈希：

upstream bck_testing_01 {

  hash $request_uri;

  # with default weight for all (weight=1)
  server 192.168.250.220:8080
  server 192.168.250.221:8080
  server 192.168.250.222:8080

}

網站有多個webapp的配置

當一個網站功能越來越豐富時，往往需要將一些功能相對獨立的模塊替換出來，獨立維護。這樣的話，通常，會有多個webapp。

舉個例子：如果www.jhrs.com站點有好幾個webapp，finance（金融），product（產品），admin（用戶中心）。

訪問這些應用的方式通過上下文（上下文）來進行區分：

www.jhrs.com/finance/
www.jhrs.com/product/
www.jhrs.com/admin/

我們知道，HTTP的默認端口號是80，如果在一台台服務器上同時啟動這3個webapp應用，都用80端口，肯定是不成的。所以，這三個應用需要分別綁定不同的端口號。那麼，問題來了，用戶在實際訪問www.helloworld.com站點時，訪問不同的webapp，總不會還帶有對應的端口號去訪問吧。所以，你再次需要用到反向代理來做處理。

配置也不難，來看看怎麼做吧：

http {
    #此處省略一些基本配置

    upstream product_server{
        server www.jhrs.com:8081;
    }

    upstream admin_server{
        server www.jhrs.com:8082;
    }

    upstream finance_server{
        server www.jhrs.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;
        }
    }
}

靜態站點
有時候，最新Nginx入門教學，我們需要配置靜態站點（即html文件和一堆靜態資源）。舉例來說：如果所有的靜態資源都放在/ app / dist目錄下，我們只需要在nginx.conf中指定首頁以及該站點的主機即可。

配置如下：

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

然後，添加主機：

127.0.0.1 www.by3.org

然後，在本地瀏覽器訪問www.by3.org，就可以訪問靜態站點了。

建造文件服務器

有時候，最新Nginx入門教學，團隊需要還原一些數據或資料，那麼文件服務器必不可少。使用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應用。各自獨立的網絡應用在相互訪問時，勢必存在跨域問題。解決跨域問題一般有兩種思路：

CORS，在遠程服務器設置HTTP響應頭，把你需要允許訪問的域名加入Access-Control-Allow-Origin中。
jsonp，把目標根據請求，構造json數據，並返回，前端用jsonp跨域。

這兩種思路，此處不展開討論。需要說明的是，Nginx根據第一種思路，也提供一種解決跨域的解決方案。表示：www.helloworld.com網站是由一個前端應用程序，一個重定向應用程序組成的。前端端口號為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";
}

接下來，最新Nginx入門教學，在你的服務器中包括enable-cors.conf來進行跨域配置：

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

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

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

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

到此，最新Nginx入門教學就完成了。作者：張鵬

編輯：陶家龍

出處：github.com/dunwu/nginx-tutorial

本文转载自dotnet9，原文链接：https://mp.weixin.qq.com/s/6NlP0aQ9zFAdFSHY9AI5Qw，本文观点不代表江湖人士立场，转载请联系原作者。