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