主頁 > 作業系統 > Nginx 的配置指令

Nginx 的配置指令

2020-09-23 15:50:13 作業系統

我們已經了解了 Nginx 的基本命令和架構原理,下面該到最讓人頭疼也是最不容易理解的部分了,那就是 nginx.conf 這個組態檔,下面從 Nginx 的指令開始,一步步來講解 Nginx 的配置,

Nginx 指令

先來看一個典型的 Nginx 組態檔示例,

main
http {
	upstream { … }
	split_clients {…}
	map {…}
	geo {…}
	server {
		if () {…}
		location {
			limit_except {…}
		}
		location {
			location {
			}
		}
	}
	server {
	}
}

從上面可以看到,這個組態檔中包含了多個指令塊,有些指令塊還是重復的,那么這在 Nginx 中是一個什么樣的規則?接下來會慢慢介紹,

指令塊的嵌套

在 Nginx 組態檔中,指令塊是可以互相嵌套的,例如上面的示例,http 塊中可以包含多個 server 塊,server 塊中還會包含多個 location 塊,每一個塊中都有相應的指令,

而每一個指令都有 Context 背景關系,也就是生效的環境,這在 Nginx 的官方檔案中說的很清楚,例如下面的兩條指令,Context 中都表明了各自可以生效的環境,access_log 指令可以在多個背景關系中生效:

Syntax:  access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]];
		     access_log off;
Default: access_log logs/access.log combined; 
Context: http, server, location, if in location, limit_except

Syntax:  log_format name [escape=default|json|none] string ...;
Default: log_format combined "..."; 
Context: http

指令的合并

在 Nginx 中,指令分為兩種,一種是值指令,一種是動作類指令:

  • 值指令:存盤配置項的值,是用來配置某一個配置項的
    • 可以合并
    • 示例
      • root
      • access_log
      • gzip
  • 動作類指令:指定行為動作,往往表示接下來要做一件事情
    • 不可以合并
    • 示例
      • rewrit
      • proxy_pass
    • 生效階段
      • server_rewrite 階段
      • rewrite 階段
      • content 階段

這里面的示例以及生效階段,后面都還會詳細講,這里可以不用過多關注,既然指令分為兩種,那么就有不同的繼承規則,下面就來說一下,

值指令的繼承規則

例如下面的組態檔,這里面在 server 塊和 location 塊中都配置了 root 指令,Nginx 的繼承規則如下:

  • 子配置不存在時,直接使用父配置塊的指令
  • 子配置存在時,覆寫父配置塊
server {
	listen 8080;
	root /home/geek/nginx/html;
	access_log logs/geek.access.log main;
	location /test {
		root /home/geek/nginx/test;
		access_log logs/access.test.log main;
	}
	location /dlib {
		alias dlib/;
	}
	location / {
	}

根據上面這兩條規則,第一個 location 使用自家的 root 指令,后面兩個 location 則使用 server 塊的 root 指令,這和編程語言中變數的作用域也是類似的,作用域更小的變數優先級往往更高,Nginx 的指令也是一樣,

檔案中沒有的指令如何判斷生效范圍

對于很多第三方模塊,很可能檔案并不完善,這時候需要通過原始碼來查看指令的生效范圍,需要明確下面幾個問題:

  1. 指令在哪個塊下生效?
  2. 指令允許出現在哪些塊下?

這兩個問題是在原始碼中定義的,例如:

static ngx_command_t  ngx_http_core_commands[] = {

    { ngx_string("variables_hash_max_size"),
      NGX_HTTP_MAIN_CONF|NGX_CONF_TAKE1,
      ngx_conf_set_num_slot,
      NGX_HTTP_MAIN_CONF_OFFSET,
      offsetof(ngx_http_core_main_conf_t, variables_hash_max_size),
      NULL },
    ......

從上面第三行可以看到,variables_hash_max_size 指令是在 main 塊下生效的,

還會有兩個回呼方法:

  • 在 server 塊生效,從 http 向 server 合并
    • char *(*merge_srv_conf)(ngx_conf_t*cf, void *prev, void *conf);
  • 向 location 合并
    • char *(*merge_loc_conf)(ngx_conf_t*cf, void *prev, void *conf);

例如:

static ngx_http_module_t  ngx_http_core_module_ctx = {
    ngx_http_core_preconfiguration,        /* preconfiguration */
    ngx_http_core_postconfiguration,       /* postconfiguration */

    ngx_http_core_create_main_conf,        /* create main configuration */
    ngx_http_core_init_main_conf,          /* init main configuration */

    ngx_http_core_create_srv_conf,         /* create server configuration */
    ngx_http_core_merge_srv_conf,          /* merge server configuration */

    ngx_http_core_create_loc_conf,         /* create location configuration */
    ngx_http_core_merge_loc_conf           /* merge location configuration */
};

ngx_http_module_t 這個結構體里面,定義了很多回呼方法,最后一個 ngx_http_core_merge_loc_conf 方法,就是制定合并規則的,這個方法定義了兩個引數,一個是父配置,一個是子配置:

static char *ngx_http_core_merge_loc_conf(ngx_conf_t *cf, void *parent, void *child)
{
    ngx_http_core_loc_conf_t *prev = parent;
    ngx_http_core_loc_conf_t *conf = child;

    ngx_uint_t        i;
    ngx_hash_key_t   *type;
    ngx_hash_init_t   types_hash;

    if (conf->root.data =https://www.cnblogs.com/iziyang/p/= NULL) {
......

這個方法表明了從父配置向子配置合并,

listen 指令的用法

listen 指令在 server 塊中生效,用來配置監聽哪些埠,由這些埠來處理請求,listen 指令的配置如下:

如示例所示,listen 指令可以監聽的型別有多種,可以配置監聽地址和埠,也可以是僅地址和僅埠,還可以僅監聽 IPv6 等等,

究竟是哪個 server 來處理請求

server_name 指令的用法

一個指令:server_name

server_name 指令是用來配置究竟是哪個 server 來處理我們的請求的,有時候,一個 server_name 中可能會有多個域名,這時候是如何選擇的呢?

  1. server_name 指令后可以跟多個域名,第一個是主域名,多個域名之間空格分隔
  2. 泛域名:僅支持在最前或最后加 *,例如:server_name *.taohui.tech
  3. 正則運算式匹配:server_name www.taohui.tech ~^www\d+\.taohui\.tech$;

當 server_name 指令后有多個域名時,會有一個 server_name_in_redirect 的配置,這個配置默認關閉,它使用來控制域名重定向的,也就是這個配置開啟之后,請求過來會重定向到主域名訪問,

Syntax  server_name_in_redirect on | off;
Default server_name_in_redirect off; 
Context http, server, location
  1. 還可以用正則運算式創建變數

    • # 使用 $1/$2 的方式參考變數
      server { 
      	server_name ~^(www\.)?(.+)$; 
      	location / { root /sites/$2; } 
      }
      
    • # 還可以通過加一個 ?<> 的方式來命名變數
      server { 
      	server_name ~^(www\.)?(?<domain>.+)$;
      	location / { root /sites/$domain; } 
      }
      
  2. 特殊的配置規則

    • .test.tech 可以匹配 test.tech *.test.tech
    • _ 匹配所有域名請求
    • "" 匹配沒有傳遞 host 頭部的請求

server 匹配的順序

  1. 精確匹配(與順序無關)
  2. * 在前的泛域名(與順序無關)
  3. * 在后的泛域名(與順序無關)
  4. 按檔案中的順序匹配正則運算式域名
  5. default server
    • 第 1 個
    • listen 指定 default

這里面 default server 有兩種指定方式,假如沒有配置 default server,那么第一個 server 塊就會成為 default server,如果 listen 中配置了 default,那么就會由配置的塊進行處理,

關注公眾號回復 Nginx 領取知識圖譜

關注公眾號回復 Nginx 領取知識圖譜

轉載請註明出處,本文鏈接:https://www.uj5u.com/caozuo/112736.html

標籤:Linux

上一篇:windows2008R2 IIS6.0反向代理(URL重寫)怎么配置

下一篇:inno setup [registry]段使用變數

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • CA和證書

    1、在 CentOS7 中使用 gpg 創建 RSA 非對稱密鑰對 gpg --gen-key #Centos上生成公鑰/密鑰對(存放在家目錄.gnupg/) 2、將 CentOS7 匯出的公鑰,拷貝到 CentOS8 中,在 CentOS8 中使用 CentOS7 的公鑰加密一個檔案 gpg -a ......

    uj5u.com 2020-09-10 00:09:53 more
  • Kubernetes K8S之資源控制器Job和CronJob詳解

    Kubernetes的資源控制器Job和CronJob詳解與示例 ......

    uj5u.com 2020-09-10 00:10:45 more
  • VMware下安裝CentOS

    VMware下安裝CentOS 一、軟硬體準備 1 Centos鏡像準備 1.1 CentOS鏡像下載地址 下載地址 1.2 CentOS鏡像下載程序 點擊下載地址進入如下圖的網站,選擇需要下載的版本,這里選擇的是Centos8,點擊如圖所示。 決定選擇Centos8后,選擇想要的鏡像源進行下載,此 ......

    uj5u.com 2020-09-10 00:12:10 more
  • 如何使用Grep命令查找多個字串

    如何使用Grep 命令查找多個字串 大家好,我是良許! 今天向大家介紹一個非常有用的技巧,那就是使用 grep 命令查找多個字串。 簡單介紹一下,grep 命令可以理解為是一個功能強大的命令列工具,可以用它在一個或多個輸入檔案中搜索與正則運算式相匹配的文本,然后再將每個匹配的文本用標準輸出的格式 ......

    uj5u.com 2020-09-10 00:12:28 more
  • git配置http代理

    git配置http代理 經常遇到克隆 github 慢的問題,這里記錄一下幾種配置 git 代理的方法,解決 clone github 過慢。 目錄 git配置代理 git單獨配置github代理 git配置全域代理 配置終端環境變數 git配置代理 主要使用 git config 命令 git單獨 ......

    uj5u.com 2020-09-10 00:12:33 more
  • Linux npm install 裝包時提示Error EACCES permission denied解

    npm install 裝包時提示Error EACCES permission denied解決辦法 ......

    uj5u.com 2020-09-10 00:12:53 more
  • Centos 7下安裝nginx,使用yum install nginx,提示沒有可用的軟體包

    Centos 7下安裝nginx,使用yum install nginx,提示沒有可用的軟體包。 18 (flaskApi) [root@67 flaskDemo]# yum -y install nginx 19 已加載插件:fastestmirror, langpacks 20 Loading ......

    uj5u.com 2020-09-10 00:13:13 more
  • Linux查看服務器暴力破解ssh IP

    在公網的服務器上經常遇到別人爆破你服務器的22埠,用來挖礦或者干其他嘿嘿嘿的事情~ 這種情況下正確的做法是: 修改默認ssh的22埠 使用設定密鑰登錄或者白名單ip登錄 建議服務器密碼為復雜密碼 創建普通用戶登錄服務器(root權限過大) 建立堡壘機,實作統一管理服務器 統計爆破IP [root ......

    uj5u.com 2020-09-10 00:13:17 more
  • CentOS 7系統常見快捷鍵操作方式

    Linux系統中一些常見的快捷方式,可有效提高操作效率,在某些時刻也能避免操作失誤帶來的問題。 ......

    uj5u.com 2020-09-10 00:13:31 more
  • CentOS 7作業系統目錄結構介紹

    作業系統存在著大量的資料檔案資訊,相應檔案資訊會存在于系統相應目錄中,為了更好的管理資料資訊,會將系統進行一些目錄規劃,不同目錄存放不同的資源。 ......

    uj5u.com 2020-09-10 00:13:35 more
最新发布
  • vim的常用命令

    Vim的6種基本模式 1. 普通模式在普通模式中,用的編輯器命令,比如移動游標,洗掉文本等等。這也是Vim啟動后的默認模式。這正好和許多新用戶期待的操作方式相反(大多數編輯器默認模式為插入模式)。 2. 插入模式在這個模式中,大多數按鍵都會向文本緩沖中插入文本。大多數新用戶希望文本編輯器編輯程序中一 ......

    uj5u.com 2023-04-20 08:43:21 more
  • vim的常用命令

    Vim的6種基本模式 1. 普通模式在普通模式中,用的編輯器命令,比如移動游標,洗掉文本等等。這也是Vim啟動后的默認模式。這正好和許多新用戶期待的操作方式相反(大多數編輯器默認模式為插入模式)。 2. 插入模式在這個模式中,大多數按鍵都會向文本緩沖中插入文本。大多數新用戶希望文本編輯器編輯程序中一 ......

    uj5u.com 2023-04-20 08:42:36 more
  • docker學習

    ###Docker概述 真實專案部署環境可能非常復雜,傳統發布專案一個只需要一個jar包,運行環境需要單獨部署。而通過Docker可將jar包和相關環境(如jdk,redis,Hadoop...)等打包到docker鏡像里,將鏡像發布到Docker倉庫,部署時下載發布的鏡像,直接運行發布的鏡像即可。 ......

    uj5u.com 2023-04-19 09:26:53 more
  • 設定Windows主機的瀏覽器為wls2的默認瀏覽器

    這里以Chrome為例。 1. 準備作業 wsl是可以使用Windows主機上安裝的exe程式,出于安全考慮,默認情況下改功能是無法使用。要使用的話,終端需要以管理員權限啟動。 我這里以Windows Terminal為例,介紹如何默認使用管理員權限打開終端,具體操作如下圖所示: 2. 操作 wsl ......

    uj5u.com 2023-04-19 09:25:49 more
  • docker學習

    ###Docker概述 真實專案部署環境可能非常復雜,傳統發布專案一個只需要一個jar包,運行環境需要單獨部署。而通過Docker可將jar包和相關環境(如jdk,redis,Hadoop...)等打包到docker鏡像里,將鏡像發布到Docker倉庫,部署時下載發布的鏡像,直接運行發布的鏡像即可。 ......

    uj5u.com 2023-04-19 09:19:04 more
  • Linux學習筆記

    IP地址和主機名 IP地址 ifconfig可以用來查詢本機的IP地址,如果不能使用,可以通過install net-tools安裝。 Centos系統下ens33表示主網卡;inet后表示IP地址;lo表示本地回環網卡; 127.0.0.1表示代指本機;0.0.0.0可以用于代指本機,同時在放行設 ......

    uj5u.com 2023-04-18 06:52:01 more
  • 解決linux系統的kdump服務無法啟動的問題

    問題:專案麒麟系統服務器的kdump服務無法啟動,沒有相關日志無法定位問題。 1、查看服務狀態是關閉的,重啟系統也無法啟動 systemctl status kdump 2、修改grub引數,修改“crashkernel”為“512M(有的機器數值太大太小都會導致報錯,建議從128M開始試,或者加個 ......

    uj5u.com 2023-04-12 09:59:50 more
  • 解決linux系統的kdump服務無法啟動的問題

    問題:專案麒麟系統服務器的kdump服務無法啟動,沒有相關日志無法定位問題。 1、查看服務狀態是關閉的,重啟系統也無法啟動 systemctl status kdump 2、修改grub引數,修改“crashkernel”為“512M(有的機器數值太大太小都會導致報錯,建議從128M開始試,或者加個 ......

    uj5u.com 2023-04-12 09:59:01 more
  • 你是不是暴露了?

    作者:袁首京 原創文章,轉載時請保留此宣告,并給出原文連接。 如果您是計算機相關從業人員,那么應該經歷不止一次網路安全專項檢查了,你肯定是收到過資訊系統技術檢測報告,要求你加強風險監測,確保你提供的系統服務堅實可靠了。 沒檢測到問題還好,檢測到問題的話,有些處理起來還是挺麻煩的,尤其是線上正在運行的 ......

    uj5u.com 2023-04-05 16:52:56 more
  • 細節拉滿,80 張圖帶你一步一步推演 slab 記憶體池的設計與實作

    1. 前文回顧 在之前的幾篇記憶體管理系列文章中,筆者帶大家從宏觀角度完整地梳理了一遍 Linux 記憶體分配的整個鏈路,本文的主題依然是記憶體分配,這一次我們會從微觀的角度來探秘一下 Linux 內核中用于零散小記憶體塊分配的記憶體池 —— slab 分配器。 在本小節中,筆者還是按照以往的風格先帶大家簡單 ......

    uj5u.com 2023-04-05 16:44:11 more