Nginx Ingress运维相关知识点

Nginx配置文件结构。

下面是一个示例Nginx.conf文件，其中包含一些常见的指令块：

# the number of worker processes to use
worker_processes 4;

# include additional configuration files
include /etc/nginx/conf.d/*.conf;

http {
  # HTTP server settings
  server {
    # listen on port 80
    listen 80;

    # server name
    server_name www.example.com;

    # default location
    location / {
      # root directory
      root /var/www/html;

      # index file
      index index.html;
    }
  }
}

在此示例中：

• worker_processes：指令指定Nginx应使用的工作进程数。

• include：指令用于包含其他配置文件。

• server：块包含特定服务器的设置。

• location：块指定默认位置的设置，即服务器的根URL。

了解更多的指令详细信息，请参见Nginx官方文档。

接下来，我们将概述在Nginx配置文件中最关键的几个部分。

指令块

HTTP块

HTTP块在Nginx配置文件中定义了HTTP服务器的全局配置参数。这些参数包括运行的工作进程的数量、允许的最大连接数、日志记录的细节等。以下是一个Nginx配置文件中HTTP块的示例：

http {
    worker_processes 4;  
    worker_rlimit_nofile 8192; 
    client_max_body_size 128m; 

    access_log /var/log/nginx/access.log; 
    error_log /var/log/nginx/error.log; 

    server {
        ...
    }
}

在该示例中，HTTP块设定了工作进程的数量、文件描述符的最大数量以及客户端请求允许的最大正文大小。它还指定了访问和错误日志的位置，并且该HTTP块内嵌了一个server块，用于指定Web服务器的配置。

Server块

在Nginx配置中，Server块用于定义特定域名或一组域名的流量请求处理规则。允许您为同一服务器上托管的多个网站或应用程序定义不同的设置和行为。

以下是Nginx配置文件中服务器块的示例：

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

    location / {
        root /var/www/html/example;
        index index.html index.htm;
    }

    location /app {
        proxy_pass http://localhost:3000;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

在此示例中，服务器只处理端口80上www.example.com域的未加密流量。

• listen指定服务器应侦听端口80上的传入连接。

• server_name指定此服务器块应处理的域名。

• listen和server_name一起使用来定义服务器应该侦听和处理流量的域和端口。

server_name指令

指定虚拟主机域名。

server_name name1 name2 name3

# example：
server_name www.example.com;

域名匹配的四种写法：

• 精确匹配：server_name www.example.com

• 左侧通配：server_name *.example.com

• 右侧通配：server_name www.example.*

• 正则匹配：server_name ~^www\.example\.*$

匹配优先级：精确匹配 > 左侧通配符匹配 > 右侧通配符匹配 > 正则表达式匹配。

Location块

在Nginx中，Location块是用来定义服务器对于特定URL路径或URL模式的请求处理规则。允许您根据网站或应用程序的不同部分定义不同的行为，如为特定目录提供静态文件，或将请求代理到另一台服务器。

以下是Nginx配置文件中位置块的示例：

server {
    ...

    location / {
        root /var/www/html/example;
        index index.html index.htm;
    }

    location /app {
        proxy_pass http://localhost:3000;
    }

    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}

在此例子中：

• / 的位置块指定应通过提供/var/www/html/example目录中的文件来处理对网站根URL的请求。

• /app的位置块指定对/appURL的请求应代理到端口3000上的localhost。

• /50x.html的位置块指定服务器应如何通过提供特定文件来处理服务器错误。

在Nginx中，当存在多个location块时，请求的处理将根据location的匹配规则和优先级被第一个相匹配的location块捕获并处理。

语法拼接：

• location [ = | ~ | ~* | ^~ ] uri { ... }

• location @name { ... }

匹配优先级： = > ^~ > ~ > ~* > 不带任何字符。

参考示例如下：

# 通用的默认匹配，所有未匹配location的都会匹配此种匹配；
# 正则和最长字符串会优先匹配
location / {

}


# 精确匹配 / ，主机名后面不能带任何字符串
location = / {

}

# 前缀匹配
location ^~ /xx/ {
     # 匹配任何以 /xx/ 开头的请求并且停止搜索。
}
# 不带正则描述的前缀匹配；
location  /uri {
}

# 正则匹配
location ~*.(gif|jpg|jpeg)$ {
     # 匹配任何以 gif、jpg 或 jpeg 结尾的请求。
}

Nginx Ingress会将Host下多个Ingress path按长度降序进行排序。了解更多详情，请参见Ingress路径匹配和Nginx的服务器和位置块选择算法。

指令继承和覆盖

在Nginx配置中，指令遵循从外到内的继承机制，位于内部的子上下文会从其外层的父上下文中继承配置指令。例如，在http{}上下文中设置的指令会被所有嵌套于其下的server{}和location{}上下文所继承，同样，server{}上下文中的指令会被它所包含的所有location{}上下文继承。需要注意的是，当同一个指令在父子上下文中均被定义时，子上下文中的配置将覆盖父上下文中的相应设置，而不是叠加。

参考示例如下：

http {
    add_header X-HTTP-LEVEL-HEADER 1;
    add_header X-ANOTHER-HTTP-LEVEL-HEADER 1;

    server {
        listen 8080;
        location / {
            return 200 "OK";
        } 
    }

    server {
        listen 8081;
        add_header X-SERVER-LEVEL-HEADER 1;

        location / {
            return 200 "OK";
        }

        location /test {
            add_header X-LOCATION-LEVEL-HEADER 1;
            return 200 "OK";
        }

        location /correct {
            add_header X-HTTP-LEVEL-HEADER 1;
            add_header X-ANOTHER-HTTP-LEVEL-HEADER 1;

            add_header X-SERVER-LEVEL-HEADER 1;
            add_header X-LOCATION-LEVEL-HEADER 1;
            return 200 "OK";
        } 
    }
}

Nginx的反向代理配置

proxy_pass指令

Nginx反向代理配置使得Nginx作为代理服务器运行，它监听客户端请求并将其转发至一个或多个后端服务器。这使得Nginx能够接收请求并将其路由至合适的后端服务进行处理。配置Nginx反向代理，可以在Nginx配置中的位置块中使用proxy_pass指令。

以下是配置Nginx反向代理的示例：

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

    location / {
        proxy_pass http://localhost:3000;
    }
}

在此示例中，/的位置块指定对www.example.com域的所有请求都应代理到端口3000上的本地主机。这意味着Nginx将把接收到的请求转发到在localhost:3000上运行的服务器。

proxy_set_header指令

还可以使用proxy_set_header指令指定要添加到代理请求中的其他标头。

示例如下：

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

    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_pass http://localhost:3000;
    }
}

在此示例中，proxy_set_header指令指定应将Host和X-Real-IP标头添加到代理请求中，并将传入请求的主机名和发出请求的客户端的IP地址分别设置为对应的值。这对于将传入请求的信息传递到上游服务器非常有用。

Nginx常用指令

Nginx常用命令