学习Nginx配置

news2024/12/24 0:00:32

1.下载地址

官网地址：NGINX - 免费试用、软件下载、产品定价 (nginx-cn.net)

我这边选择NGINX 开源版 nginx: download

2.nginx的基本配置

配置文件语法

配置文件组成：注释行，指令块配置项和一系列指令配置项组成。

单个指令组成：配置项名称和值参数，值参数可以是一个或多个附加参数，取决于解析该条指令的模块。

# user nobody;
worker_processes 4;
events {
    worker_connections 1024;
}

块配置项组成：一个块配置顶名和一对大括号组成。 块配置后面是否带有参数，如location /webstatic {}，取决于解析该配置块的模块。

  • 指令配置项总是以分号结尾（;）。
  • 字符“#”表示改行是注释行，nginx在读取配置文件时将忽略的文本。

指令特点

  • 指令都有作用域，如上面例子，worker_connections 只能放在events区块才有意义。
  • 配置块能相互嵌套。在某些情况下不同配置块能够相互嵌套。如在http区段，可以声明一个或多个server区段，server区段又可以插入一个或多个location区段。
  • 最后同样重要的是配置的继承。在一个区段中嵌套其他区段，那么被嵌套的区段会继承其父区段的配置。在嵌套模块中重新声明指令会覆盖该继承。

指令值的单位

可以使用下面单位来指定配置文件所在上下文中指令值的单位。

  • k或K:千字节
  • m或M:兆字节
  • ms:Milliseconds(毫秒)
  • s:Seconds(秒)
  • m:Minutes(分钟)
  • h:Hours(小时)
  • d:Days(天)
  • w:Weeks(星期)
  • M:Months(月)
  • y:Years(年)

字符串值

注意：如果指令值中包含空格、分号或者是大括号等特殊字符，需要使用单引号或双引号将其括起。

nginx基本模块

nginx是由一系列模块组成的，大致可以分为核心模块、Http核心模块和其他模块。其中核心模块在编译时不能被禁用。核心模块包含main模块、events模块和include包含指令。

main模块重要指令

main模块位于配置文件根部。提供如进程管理和安全的能力。

daemon on; #启用或禁用守护进程模式。

user  nobody; #worker进程运行的用户和组，如果没有提供则使用nginx的master进程的用户和用户组。   
worker_processes  4;#定义worker进程数量一般和cpu核数一致。

#错误日志，这里的级别由debug,info,notice,warn,error和crit(debug记录了全部日志，crit仅报告关键错误)
#作用域：main, http, mail, stream, server, location
error_log  logs/error.log error; 
pid        logs/nginx.pid; #存放nginx守护进程的pid文件路径。
log_not_found on; #开启或禁用记录404错误。
...
#除上面指令外还有worker_rlimit_core、worker_rlimit_nofile、worker_cpu_affinity、worker_priority等。

events模块

事件模块提供的指令可以用来配置网络机制

accept_mutex:on; #默认值on，启用或禁用使用一个接受互斥锁来打开套接字监听。   
use epoll; #指定nginx所使用的网络事件模型，可选值有/dev/poll,epoll,kqueue等，通常不需要显式指定它，默认情况下nginx将使用最有效方法。
worker_connections 1024; #定义一个worker进程能够同时连接的数量。

configuration模块

提供的include 指令能够将其他文件包含在nginx配置文件中。在配置文件的任何地方均可插入该指令。注意如果没有指定绝对路径，那么文件路径将和配置文件的目录相关。

include /file/path.conf;
include sites/*.conf;

3.HTTP配置

HTTP 核心模块是Nginx中最大的一个模块，它包含了所有的基本的区段、指令和变量。

区段结构

通过下面的例子，来认识http模块的区段结构。

http {
    #在http区段中启用gzip压缩
    gzip on;
    server {
        server_name localhost;
        listen 80;
        location /downloads/ {
             #在此location区段禁用gzip压缩
            gzip off;
        }
    }
}
  • http 区段位于配置文件的根部，在这个区段中允许定义HTTP模块的指令和HTTP模块的相关区段。
  • server区段用于声明一个站点，该区段只能用在http区段中。
  • location 区段应用于网站特定的URI位置，该区段能够用于server区段中，也能嵌套在其他location中。

模块指令

在http/server/location三个层次的每个层次都可以插入指令，下面介绍的指令都主要由http模块引入，对于每条指令都有它的使用环境。指令对应的级别包括http块、server块、location块，另外还有rewrite模块的if块。注意：一些指令不能用于某些级别。
下面介绍一些常见指令，如无特殊说明作用域为http,server,location。

套接字和主机配置指令

下表指令可以根据主机名或IP地址和端口的组合创建一个server区段。并通过一些指令来配置TCP套接字选项，以便调整网络设置。

  • listen:用于设置监听套接字使用的ip端口号。
    语法：listen [address][:port][其他选项]
    其他选项：
    default:指定监听的默认套接字，该server区段被用于默认的网站，在该IP地址和端口上接受任何客户端的请求。 ssl：指定的网站提供SSL服务。 其他选项依赖于bind和listen系统调用:backlog=num,rcvbuf=size,sndbuf=size,accept_filter=filter,deferred和bind。
    作用域：server
  • server_name：在server区段中指定一个或多个主机名。
    nginx收到http请求时，根据请求header中Host值与所有server区段比较，第一个与主机名匹配的server块将被选中，否则如果没有server区段与客户端请求的主机名匹配，nginx会选择第一个server区段，匹配监听参数（如listen *:80）,另外具有default选项的listen会被优先选择。注意该指令接受通配符。
    作用域：server
server_name www.website.com website.com;
server_name *.website.com;
server_name *.website.*;
  • tcp_nodelay：开启或关闭使用TCP_NODELAY套接字选项，仅用于keep-alive连接。它禁用了Nagle 缓冲算法。
  • tcp_nopush
    开启或禁用TCP_NOPUSH(FreeBSD)或TCP_CORK(Linux)的scoket选项。如果tcp_nopush开启，则nginx将尝试在整个tcp数据包中发送整个http响应头。
  • sendfile
    指定nginx是否调用sendfile系统函数来输出文件，减少内核空间和用户空间的上下文切换。对于普通应用设为 on，如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平衡磁盘与网络I/O处理速度，降低系统的负载。

另外还有sendfile_max_chunk、send_lowat等指令。

路径和文档

下表指令用来设置根目录、主页、错误页等。

  • root：定义文档的根目录。
    作用域：http,server,location,if。
  • alias：location 指定uri路径的别名，它不会改变root的值。
    作用域：location
location  /i/ {
  alias  /spool/w3/images/;
}
#例如：请求"/i/top.gif",将返回这个文件: "/spool/w3/images/top.gif"。
#正如你所看到的，uri中location后面的部分会追加到这个目录后面，而location自身指定的uri路径是"丢弃的"
  • error_page
    允许修改访问URI所产生的HTTP相应代码，并选择性地将它替换为其他代码。
    作用域：http,server,location,if。
    语法：error_page code1 [code2 ...] [=replacement code] [=@block|URI]
    例如：
error_page 404 html/404/html;
error_page 500 502 503 504 html/5x.html;
#跳转到命名的location区段。
error_page 404 @notfound; 
#在出现404错误时 ，内部重定向到index.html,并且返回200 OK响应码。
error_page 404 =200/index/html;
  • index：定义默认的页面，如果请求中没有指定文件名，nginx则使用默认页面提供服务。默认值index.html。

语法：index file1 [file2...]

#例如： 
index index.php index.html index.htm;
  • try_files:试图找到指定的文件，如果指定的这些文件都不是，就跳转到命名location区段（最后一个参数）或者指定的URI。
    作用域：location。
#例如
location / { 
    try_files $uri $uri.php @proxy; 
} 
location @proxy {
    proxy_pass 127.0.0.1:8080;
}

客户端请求

下面描述的是nginx处理客户端请求机制，如配置keepalive、客户端缓冲区设置等。

  • keepalive相关指令：keepalive_requests、keepalive_timeout、send_timeout。
  • 缓冲区相关指令：client_body_buffer_size、client_header_buffer_size、large_client_header_buffers等。
  • 其他客户端指令：client_body_timeout、client_header_timeout、client_max_body_size、lingering_time、ligering_timeout、ignore_invalid_header等。

MIME类型

MIME类型会在HTTP响应头中Content-Type中发送，这个头通常影响浏览器对文件的处理，如MIME类型是application/octet-stream，那么浏览器会下载该文件，而非显示；如果MEMEE类型是text/plain，那么该文件在浏览器中会作为纯文本而不用html解释提供。

Nginx提供了两个配置MINE类型的指令。分别是types和default_types；

http {
    include mime.types;
    location /downloads/ {
        #移除所有的MIME类型
        types {};
        default_type application/octet-stream.
    }
}

记录相关

  • log_not_found:开启或禁用404没有找到的HTTP错误，如果日志中由于找不到favicon.ico或robots.txt而充满404错误日志，则可以通过这个选项关闭掉。
    作用域：http,server,location。
    默认值：on
  • log_subrequest:启用或禁用记录子请求（被内部请求指令（如rewrite）或SSI请求触发的请求）。
    作用域：http,server,location。
    默认值：off

其他

除了以上介绍的指令外，还有限制和约束以及文件处理和缓存相关指令，需要时可查阅相关文档。 但这里有必要介绍下internal指令。

#internal：该指令指定location区段只能用于内部访问。内部重定向参考Rewrite模块。
server {
    server_name *.website.com;
    location /admin/ {
        internal;
    }
}

模块变量

HTTP核心模块引入了大量的变量，可以使用这些变量应用到配置文件中。nginx的变量分为请求头变量、响应头变量和Nginx产生的各种变量。

客户端请求头变量

nginx允许你可以访问客户端请求头，以$http_为前缀的格式访问，如下表。

  • $http_host：HTTP头中的Host值。
  • $http_referer:HTTP头中的referer值。
  • $http_x_forward_for：HTTP头中的X-Forward-For的值。 除此之外还有$http_user_agent、$http_via、$http_cookie等。

响应头变量

这类变量发生在响应发送后，nginx允许你访问客户端响应头。以$send_http...为前缀，如下表。

  • $send_http_content_type：HTTP头中的Content-Type的值。
  • $send_http_content_length：HTTP头中的Content-Length的值。 除此之外还有$send_http_location、$send_http_connection等。

nginx产生的变量

  • $arg_XXX：访问查询字符串中的参数。
  • $args 所有结合在一起的查询字符串，同$query_string。
  • $body_bytes_sent：在响应头中发送的字节数。
  • $content_length:相当于HTTP头中的Content-Length。
  • $content_type:相当于HTTP头中的Content-Type。
  • $cookie_XXX:允许访问cookie数据，这里XXX替换为具体参数。
  • $document_root:返回root指令的值。
  • $document_uri:返回当前请求的uri，如果内部重定向被执行，将返回重定向后的uri。它与变量$uri相同。
  • $request_uri:原始请求的uri，在整个处理过程中保持不变（不像$document_uri/$uri）。
  • $host：相当于HTTP请求头中的Host,如果请求头没有Host，nginx会给这个变量赋一个值。
  • $hostname：返回服务器的系统名称。
  • $is_args：如果$args变量为空，那么$is_args也为空。
  • $request_filename:返回当前请求文件的绝对路径。 除此之外还有$nginx_version、$hostname、$remote_addr、$request_body、$request_method、$server_name、$scheme等。

深入location区段

nginx location区段可以通过指定的模式与客户端请求URI相匹配，location区段语法如下：

Syntax:	location [ = | ~ | ~* | ^~ ] uri { ... }
        location @name { ... }
Default:	—
Context:	server, location

注意：location只是对URI进行匹配，不管查询字符串参数。

修饰符描述

  • = :URI必须与指定模式精确匹配。这里的模式为简单字符串，不可使用正则表达式。
# uri必须与/abcd精确匹配（优先级最高），如:
# http://www.website.com/abcd 可用
location = /abcd {
    ...
}
  • (无)：URI必须以指定模式开始，不可使用正则表达式。
#uri必须与指定模式开始，以下uri可用:
# http://www.website.com/abcd
# http://www.website.com/abcd/
# http://www.website.com/abcde
location /abcd {
    ...
}
  • ～：URI与指定的正则表达式模式匹配，区分大小写。
#正则表达式^/abcd$,指定模式必须以/开始，后根abc，以d字符结尾。如：
http://website.com/abcd 可用
http://website.com/abcd?param1&param2 可用
location ~ ^/abcd$ {
    ...
}
  • ～*：URI与指定正则表达式模式匹配，不区分大小写。
  • ^~：URI以指定模式开始，如果模式匹配，则停止搜索其他模式，
  • @ 定义命名location区段。这些区段只能由内部产生的请求访问，如try_files或error_page。

修饰符优先级

  1. =
  2. 无
  3. ^~
  4. ~或～*
  5. (无)

4.模块配置

主要有关Rewrite模块及可能会用到的其他模块。

Rewrite模块

nginx rewrite模块使用Perl兼容正则表达式库，在安装nginx时需要预先安装perl和perl-dev。

正则表达式

元字符

  • ^ ：以^后跟的字符开始
  • $ ：以$前的字符结尾
  • . ：匹配任何字符
  • [ ] ：组，匹配指定字符集合内的任何字符。
  • [^ ] ：否定组，匹配不包括在指定字符集内的字符。
  • | ：匹配符号“|”之前或之后的实体。
  • ( ) ：分组，组成一组匹配的实体，常和“|”配合使用。
  • \ ：对特殊字符进行转义。

量词

使用量词可以扩展实体匹配次数。

  • *：0或多次
  • +：1或多次
  • ?：0或1次
  • {x}：x次
  • {x,}：至少x次
  • {x,y}：x到y次

捕获

正则表达式最后一个功能是能够捕获自表达式，放在“( )”之间的任何文本，在被捕获后都能用于后面的处理。 例如：

server {
    server_name website.com;
    location ~* ^/(downloads|files)/(.*)$ {
        add_header capture1 $1;
        add_header capture2 $2;
    }
    
}

关于内部请求

nginx有两种类型的内部请求：

  1. 内部重定向： nginx在内部重定向客户端的请求。URI被改变，请求可能匹配到其他的location区段。常见的内部重定向指令有error_page、rewrite、try_files。
  2. 子请求： 另一种触发内部请求而产生内容的就是子请求，如使用Addition模块或SSI模块的指令。

注意：error_log 日志级别设置为debug时能够捕获到内部请求日志，详情可参阅error_log指令。

rewrite模块指令

条件结构

Rewrite模块引入了if条件结构。
语法：if (condition) { ... }
作用域：server, location

条件运算符说明：

  • 一个变量名 : 如果指定的变量或数据不等于空字符串或0，则条件为真。
  • =或!= : 相等或不等比较
  • ~ , ~* : 模式匹配，除此之外还有,!,!*
  • -f,!-f : 测试文件是否存在
  • -d,!-d : 测试一个目录是否存在
  • -e,!-e : 测试文件、目录或符号链接是否存在
  • -x,!-x : 测试文件是否存在且可执行。

例如：

if ($http_user_agent ~ MSIE) {
        rewrite ^(.*)$ /msie/$1 break;
    }
    
    if ($http_cookie ~* "id=([^;]+)(?:;|$)") {
        set $id $1;
    }
    
    if ($request_method = POST) {
        return 405;
    }
    
    if ($slow) {
        limit_rate 10k;
    }
    
    if ($invalid_referer) {
        return 403;
    }

注意：if和location都能实现类似的效果，它们的不同之处在于能够在这两个区段使用的指令不同。换句话说就是有些指令可以用在if区段，有的则不可以，但几乎所有指令都可以在location中使用。比较常见的是在if区段中使用rewrite指令。
rewrite
语法：rewrite regex replacement [flag];
如果指定的正则表达式与URI匹配，则URI将按照replacement指定的字符串进行更改。该rewrite指令将按其在配置文件中出现的顺序执行。可以使用flag终止指令的进一步处理。如果replacement以“http://”、“https://”或“$scheme”开头，则处理将停止并将重定向返回给客户端。 flag标志说明：

  • last：停止处理后面的rewrite指令集，并使用新的URI重新发起一个内部请求。
  • break:停止处理后面的rewrite指令集，相当于执行了break指令。如果重定向后的文件不存在返回404。
  • redirect:临时重定向，返回302 Moved temporarily HTTP 重定向响应，Location Header显示跳转后的URL地址。
  • permanent：永久重定向，返回301响应。
server {
    ...
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 last;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  last;
    return  403;
    ...
}
# 如上配置，如果放到location区块中，则last标志应该替换称break，否则nginx将执行10次循环，并返回500错误。
location /download/ {
    rewrite ^(/download/.*)/media/(.*)\..*$ $1/mp3/$2.mp3 break;
    rewrite ^(/download/.*)/audio/(.*)\..*$ $1/mp3/$2.ra  break;
    return  403;
}

注意：

  • 如果URI重写后发生循环，则重复该循环，但不超过10次。nginx将返回“500 Internal Server Error”。
  • last和break都不再匹配后面的rewrite规则，但last应用完当前规则后，会重新发起一个内部请求查找一个location.

break
停止处理后面的rewrite指令集，阻止进一步改写请求URI。

if (-e $request_filename) {
    break;
}
//因为break指令，后面的指令集不会执行
if ($uri ~ ^/search/(.*)$){
    rewrite ^/search.php?q=$1;
}

return
中断请求处理过程，并返回一个指定的HTTP状态码。
语法：return code [text] | [codURL] ; return URL;

if ($uri ~ ^/admin/) {
    return 403;
    #因为已经完成了请求，此条指令不会执行。
    rewrite ^ http://website.com; 
}

set
初始化或重定义一个变量。注意有些变量不能修改，如$uri。
语法：set $variable value;

rewrite_log
如果设置为on，nginx将在“notice”错误级别对rewrite引擎处理的每个操作记录日志。
默认值：off

Log模块

该模块指令作用域：http,server,location
access_log:设置日志写入的路径，格式。
语法：access_log path [format [buffer=size] | off;

  • path：日志记录的文件路径，路径中可以使用变量。
  • format：用log_format指令声明一个模版名称。
  • off：关闭日志记录

log_format:定义一个模版，用于表述日志中一个条目包含的内容。 语法：log_format template_name format_string; 默认的模版为combined。定义为：

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

变量
Log模块除了可以使用公用变量之外，也带来了下面一些新的变量，但这些变量只能在写日志条目时使用。

  • $connection：连接号
  • $msec：写入日志时的微秒时间
  • $request_time：处理请求花费的总时间。
  • $status：响应状态码
  • $bytes_sent：发送到客户端的字节总数
  • $body_bytes_sent：发送到客户端body的总字节数
  • $reqeust_length 请求体长度。
    此外还有$time_ios8601、$time_local、$connection_requests、$pipe几个变量。

headers模块

该模块允许将“ Expires”和“ Cache-Control”头字段以及任意添加响应头字段。主要有两个指令：

  • add_header: 允许在响应头中添加一个新行。 如果响应码为200、204、301、302、304，则该行被添加到响应头中。可以在value中使用变量。如果指定了always参数，则无论响应码如何，都会添加到响应头。 语法：add_header name value [always];
  • expires：该指令能够控制发送到客户端Expires和Cache-Control HTTP header的值，它影响的代码和前面一样。 语法：expires [modified] time | epoch | max | off;
    参数说明：
    • time:过期时间值，如expires 30d;
    • epoch：将文件有效期设置为January 1970。Cache-Control header设置为no-cache。
    • max：将文件设置为Decemeber 31,2037。Cache-Control header被设置为缓存10年。
    • off：两个头都不修改

referer模块

该模块有一个简单的指令：valid_referers。它的目的是检查来自客户端请求的referer HTTP头。如果referer被认为无效,则$invalid_referer设置为1。
语法：valid_referers none | blocked | server_names | string ...;
例如:

valid_referers none blocked server_names
               *.example.com example.* www.example.org/galleries/
               ~\.google\.;

if ($invalid_referer) {
    return 403;
}

注意：可以使用该模块实现网站防盗链功能，对其他网站链接的图片禁止访问。

Secure link模块

该模块与SSL模块无关，对访问的链接提供了基本的保护。该模块提供两种模式：

  • 通过 secure_link_secret 指令启用，用于检查请求链接的真实性，和保护未授权的资源访问。
  • 通过secure_link and和secure_link_md5 指令请用，也用于限制链接的生存周期。 常用作下载防盗链功能。

Image filter模块

该模块提供图像处理功能，通过GD Graphics Library(gdlib)来实现。默认编译的Nginx不包含这个模块

其他模块

除此之外比较重要的还有Index模块、gzip模块、realip模块、ssl模块等。另外在有特殊需要时还有 AutoIndex模块、auth_basic模块、Limit zone模块、Limit request模块，Empty GIF模块、Addtion模块、Gzip模块、Charset模块、Browser模块、GeoIp模块等等。其他模块根据需要查阅nginx文档。

5.fastcgi模块

基本概念：

  • CGI协议（通用网关接口）：描述了Web服务器和应用程序网关之间的信息如何交换。
  • FastCGI：它是一个基于套接字的通信协议，使Web服务器能够将客户端请求转发到应用程序网关，它使用了能够处理多个请求的常驻进程，因而效率比较高。

默认情况下fastcgi模块默认是启用的，通过该模块提供的指令，能够使nginx将请求传递给FastCGI程序。
注意：nginx配置目录下的fastcgi.conf，包含了fastcgi预定义的一些参数。对所有fastcgi来说，有两个参数是必须的SCRIPT_FILENAME和QUERY_STRING。 例如:

#/etc/nginx/fastcgi.conf 

fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
fastcgi_param  QUERY_STRING       $query_string;
fastcgi_param  REQUEST_METHOD     $request_method;
fastcgi_param  CONTENT_TYPE       $content_type;
fastcgi_param  CONTENT_LENGTH     $content_length;
....

#示例
location ~ \.php($|/) {
    fastcgi_pass unix:/dev/shm/php.sock;
    fastcgi_index  index.php;
    # 根据正则表达式分割为$fastcgi_script_name和$fastcgi_path_info两个变量。
    # 比如请求/show.php/article/0001，被分割为/show.php和/article/0001
    fastcgi_split_path_info  ^(.+\.php)(/.*)$;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    # 设置PATH_INFO SEVER变量
    fastcgi_param  PATH_INFO $fastcgi_path_info;
    fastcgi_param APP_ENV 'production';
    include fastcgi.conf;
}

模块指令

下面简要介绍几个主要指令，其他指令用是可以查看官方文档。注意：如无特殊说明该模块指令作用域为：http、server、location

  • fastcgi_pass：将请求转发给fastcgi服务器。 语法：fastcgi_pass address; 作用域：location, if in location
    //对于TCP fastcgi_pass localhost:9000; //对于UNIX fastcgi_pass unix:/tmp/fastcgi.socket;
  • fastcgi_param：允许将配置传递给Fastcgi服务器。
  • fastcgi_index：设置索引文件名，如果请求URI以斜杠结尾，则请求URI，带上由fastcgi_index指令附加上的索引文件名。
  • fastcgi_split_path_info：根据正则表达式，将指令分割为$fastcgi_script_name和$fastcgi_path_info两个变量。

变量

  • $fastcgi_script_name：请求uri.

6.upstream模块

upstream模块用来定义一组服务器，从而可以由proxy_pass,fastcgi_pass等指令引用。在upstream模块中，默认的方法是轮询，这种方法会带来Session会话问题，会出现同一个访问者的两个请求可能会被不同的两个服务器处理。

模块指令（整理自 nginx.org upstream模块 ）

upstream:定义一组服务器，服务器可以监听不同端口，另外，可以混合监听TCP和UNIX域套接字。
语法：upstream name { ... }
作用域：http
注意：默认情况下，使用加权轮询均衡方法。在下面例子中，每7个请求，将有5个分配给172.16.0.50，第2和第3个服务器各一个请求。如果服务器通信期间发生错误，该请求将被传递到下一个服务器。依此类推，直到尝试所有正常运行的服务器为止，如果无法从任何一台服务器获得成功响应，则客户端收到最后一台服务器的响应结果。
示例：

upstream backend {
    server 172.16.0.50 weight=5;
    server 127.0.0.1:8080       max_fails=3 fail_timeout=30s;
    server unix:/tmp/backend3;

    server 172.16.0.49  backup;
}

除upstream指令外，其他指令的作用域是：upstream

server指令：定义后端服务器的地址和参数，这些参数将影响nginx对后端服务器的选择。

语法：server address [parameters];
参数说明：

  • weight=n:设置服务器的权重，默认为1。注意：如果使用ip_hash模式，weight选项会被忽略。
  • max_conns=number:限制连接到该服务器上的最大活动连接数，默认值为0，表示没有限制。作用是可以对单个服务器进行限流，防止服务器超负荷运转。
  • max_fails=n:设置在fail_timeout参数设置的期间内与服务器通信失败的尝试次数，超过这个次数服务器将不可用，默认设置为1。认定失败的条件由proxy_next_upstream、fastcgi_next_upstream等指令定义。
  • fail_timeout=time：指定服务器不可用的尝试时间范围。默认情况下，该参数设置为10s。
  • backup：将服务器标记为备份服务器，当主服务器全部不可用时，才传递请求。
    此参数不能和hash,ip_hash和random负载均衡方法一起使用。
  • down：标记服务器为离线状态。

hash
语法：hash key [consitent]; 指定服务器组的负载均衡方法。客户端-服务器的映射是基于散列key值。key中可以使用nginx变量。如果指定consistent将使用一致性hash方法，可确保将服务器添加到组中或从组中删除服务器时，只有少量的key被重新映射到不同服务器。
注意：从组中添加或删除服务器，可能会导致key值重新映射到其他服务器。

ip_hash
语法：ip_hash;
指定服务器组的负载均衡方法，它是基于客户端ip在服务器间分配请求。注意：1.如果其中一台服务器需要临时删除，需使用down参数标记该服务器，以保留客户端ip地址的当前哈希值。2.在运营商移动网络下，ip经常是会变化的。

keepalive指令
语法：keepalive connections;
每个 worker 进程连接上游服务器的最大长连接数（默认情况下是短连接）。超过此数量时，将关闭最近最少使用的连接。

对于HTTP，应将 proxy_http_version指令设置为“1.1”，并清除 “Connection” 头字段：

upstream http_backend {
    server 127.0.0.1:8080;

    keepalive 16;
}

server {
    location /api/ {
        proxy_pass http://http_backend;
        proxy_http_version 1.1;
        #即使客户端和代理服务器使用的是短链接，代理服务器和上游服务器之间也将使用长连接。
        proxy_set_header Connection ""; 
        ...
    }
}

和它一起使用的还有两个参数，分别是：

  • keepalive_requests:设置通过一个keepalive连接可以处理的最大请求数。
  • keepalive_timeout 空闲keepalive保持打开的超时时间。

注意：对于fastcgi服务器，需要开启fastcgi_keep_conn才能使keepalive连接正常工作。

last_conn
指定服务器组的负载均衡方法,将请求传递到活动连接数最少的服务器，同时需要考虑权重。如果有多个这样的服务器，就使用轮询的方法。

random
语法：random [two [method]]; 指定服务器组的负载均衡方法，其中将请求随机传递到选择的服务器，同时需要考虑服务器权重。

resolver
语法：resolver address ... [valid=time] [ipv6=on|off] [status_zone=zone]; 配置用于解析上游服务器名的域名解析服务器。

变量

upstream模块支持以下变量：

  • $upstream_addr:上游服务器的ip和端口活着UNIX套接字的路径。
  • $upstream_bytes_received:从上游服务器中收到的字节数。
  • $upstream_bytes_send：发送到上游服务器的字节数。
  • $upstream_connect_time：与上游服务器建立连接的时间。
  • $upstream_cookie_name：上游服务器在“Set-Cookie”响应头字段中发送的具有指定值的cookie。
  • $upstream_header_time：从上游服务器接收header耗费的时间。
  • $upstream_response_length：从上游服务器接收响应的长度（bytes）。
  • $upstream_response_time：接收上游服务器接收响应耗费的时间。
  • $upstream_status：上游服务器的响应状态。

7.nginx反向代理

默认情况下proxy模块默认是启用的，通过该模块能够将客户端的HTTP请求转发到后端服务器。 注意：如无特殊说明，指令的作用域都为：http,server,location。
示例：

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

模块指令

下面简要介绍几个主要指令，其他指令用是可以查看官方文档。注意：如无特殊说明该模块指令作用域为：http、server、location

主要指令
proxy_pass：指定转发给后端服务器的协议和地址。

语法：proxy_pass 协议://地址[/URI];

协议可以是http或https。地址可以是TCP套接字（域名或者ip地址+port）、UNIX域套接字，还可以指向upstream区段。URI是可选部分，如果指定了URI，location 后面指定的路径将被替换。

作用域：location, location中的if

proxy_pass http://localhost:8080;
proxy_pass http://127.0.0.1:8080;
proxy_pass http://unix:/tmp/backend.sock;
proxy_pass https://192.168.0.1;
proxy_pass http://localhost:8080/uri/;
proxy_pass http://unix:/tmp/backend.sock:/uri/:
# URL中还可以使用变量
proxy_pass http://$server_name:8080;

#指向upstream区段
#格式：proxy_pass http://myblock;
upstream backend {
    server 127.0.0.1:8080;
    server 127.0.0.1:8081;
}
location ~ \.php($|/) {
    fastcgi_pass http://backend;
}

注意：如果proxy_pass指定了URI，那么location匹配不能使用正则表达式。如果代理的URI需要使用正则表达式，则可以使用rewrite和proxy_pass结合的方式来定义转发路径。此时proxy_pass 后面定义的URL不再生效。

location /static_js/ {
    rewrite /static_js/(._)$ /$1 break;
    proxy_pass http://js.test.com;
}

proxy_next_upstream：指定哪种情况将请求传递到下一个服务器。
语法：proxy_next_upstream error | timeout | invalid_header | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | http_429 | non_idempotent | off ...;
默认：proxy_next_upstream error timeout;

参数说明：

  • error：与服务器建立连接或传递请求或读取响应头时发生错误。
  • timeout：与服务器建立连接或传递请求或读取响应头时发生超时。
  • invalid_header：后端服务器返回空或无效的响应
  • http_xxx：发生对应HTTP错误。
  • off:禁止将请求传递到下一个服务器。
proxy_next_upstream error timeout http_504;

proxy_ignore_headers：禁用来自后端服务器的某些响应头字段。可以忽略以下字段：X-Accel-Redirect、Expires、Cache-Control、Set-Cookie和Vary。

proxy_set_body：用于重新定义传递给后端服务器的请求正文，一般用于调试目的。

proxy_set_header：用于重新定义或增加传递给后端服务器的请求头字段。 语法：proxy_set_header field value; 默认值：proxy_set_header Host $proxy_host; proxy_set_header Connection close;

除以上外还有proxy_method、proxy_hide_header、proxy_pass_header、proxy_pass_request_body、proxy_pass_request_header、proxy_redirect等指令。

缓冲、缓存和临时文件
proxy_buffer_size：设置缓冲区大小，该缓冲区用于存放来自后端服务器响应数据的开始不分。默认情况下，缓冲区的大小等于一个内存页（根据平台不同,4k或8k）

porxy_buffering:定义是否缓冲后端服务器的响应，如果禁用，响应就直接转发给客户端。
语法：proxy_buffering on | off;
默认：proxy_buffering on;

proxy_buffers ：设置缓冲区数量和大小，用于存放从后端服务器读取的响应数据。默认情况下，缓冲区的大小等于一个内存页。
语法：proxy_buffers number size；
默认：proxy_buffers 8 4k | 8k;

proxy_busy_buffers_size:在缓冲区中，收到后端服务器数据总大小超过该指令指定大小时，缓冲区就会被刷新，并且数据被发送到客户端。默认为2*proxy_buffer_size。
默认值：proxy_busy_buffers_size 8k | 16k;

proxy_cache_前缀开头的指令：用于定义存放缓存文件目录等。
例如：proxy_cache、proxy_cache_key、proxy_cache_path等。

超时、错误及限制
proxy_connect_timeout:定义连接到后端服务器的超时时间。
默认：proxy_connect_timeout 60s;

proxy_read_timeout:定义从后端服务器读取数据的超时时间，超时设置仅表示在两个连续的读操作之间，而不是整个响应的传输。如果上游服务器未传输任何内容，则连接被关闭。
默认：proxy_read_timeout 60s;

proxy_send_timeout：定义从发送数据到后端服务器的超时时间，超时设置仅表示在两个连续写操作之间，而不是整个请求的传输。如果后端服务器在这期间未收到任何数据，则连接被关闭。
默认：proxy_send_timeout 60s;

proxy_ignore_client_abort：确定当客户端关闭和代理服务器间的连接时，是否关闭与后端服务器的连接。 默认值：proxy_ignore_client_abort off;

除此之外还有proxy_intercept_errors、proxy_send_lowat、 proxy_headers_hash_max_size、proxy_headers_hash_bucket_size、proxy_store、proxy_store_access等指令等指令。

变量

  • $proxy_host：当前请求后端服务器的名称；
  • $proxy_port：当前请求后端服务器的端口。
  • $proxy_add_x_forwarded_for：该变量包含“X-Forwarded-For”请求头的值，后跟远程客户端的ip地址，这两个值由逗号分割，如果客户端请求头中不存在“X-Forwarded-For”字段，则该变量等于$remote_addr的值。

8.扩展阅读

nginx 官方文档：https://nginx.org/en/docs/

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1185957.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

自动控制原理--面试问答题

自动控制原理--面试问答题

以下文中的，例如 s_1 为 s下角标1。面试加油！ 控制系统的三要素：稳准快。稳，系统最后不能震荡、发散，一定要收敛于某一个值；快，能够迅速达到系统的预设值；准，最后稳态值…
阅读更多...
【MATLAB源码-第71期】基于matlab的萤火虫算法(FA)的无人机三维地图路径规划，输出最短路径和适应度曲线。

【MATLAB源码-第71期】基于matlab的萤火虫算法(FA)的无人机三维地图路径规划，输出最短路径和适应度曲线。

操作环境： MATLAB 2022a 1、算法描述 萤火虫算法（Firefly Algorithm，FA）是由剑桥大学的Xin-She Yang在2008年提出的一种元启发式优化算法。该算法的灵感来源于萤火虫闪烁的行为特征，主要用于解决连续的优化问题。萤…
阅读更多...
线性代数（二）| 行列式性质 求值 特殊行列式 加边法 归纳法等多种方法

线性代数（二）| 行列式性质 求值 特殊行列式 加边法 归纳法等多种方法

文章目录 1. 性质1.1 重要性质梳理1.1.1 转置和初等变换1.1.2加法行列式可拆分1.1.3 乘积行列式可拆分 1.2 行列式性质的应用1.2.1 简化运算1.2.2 将行列式转换为（二）中的特殊行列式 2 特殊行列式2.1 上三角或下三角行列式2.2 三叉行列式2.3 行列式行和&…
阅读更多...
TensorFlow（1）：深度学习的介绍

TensorFlow（1）：深度学习的介绍

1 深度学习与机器学习的区别 学习目标：知道深度学习与机器学习的区别 区别：深度学习没有特征提取 1.1 特征提取方面 机器学习的特征工程步骤是要靠手动完成的，而且需要大量领域专业知识深度学习通常由多个层组成，它们通常将更简…
阅读更多...
配置简单VLAN

配置简单VLAN

1、 需求 ： 1）创建VLAN 10、20、30 2）将端口加入VLAN 3）查看VLAN信息 2、方案 使用eNSP搭建实验环境，如图所示。 3、步骤 实现此案例需要按照如下步骤进行。 1）交换机创建VLAN 10、20、30 [sw1]vla…
阅读更多...
云架构师学习------腾讯云通识-存储与数据库

云架构师学习------腾讯云通识-存储与数据库

云架构师学习------腾讯云通识-存储与数据库 云架构师学习------腾讯云通识-存储与数据库存储基础存储服务对象存储-COS产品概述功能概览产品优势 云硬盘-CBS产品概述产品功能产品优势云硬盘类型 文件存储-CFS产品概述产品功能产品优势文件存储类型及性能规格存储类型性能与规格…
阅读更多...
《LeetCode力扣练习》代码随想录——数组（长度最小的子数组---Java）

《LeetCode力扣练习》代码随想录——数组（长度最小的子数组---Java）

《LeetCode力扣练习》代码随想录——数组（长度最小的子数组—Java） 刷题思路来源于 代码随想录 209. 长度最小的子数组 滑动窗口——O(n) class Solution {public int minSubArrayLen(int target, int[] nums) {if(nums.length1){return nums[0]>targ…
阅读更多...
“2024杭州国际物联网展览会”定于4月份在杭州国际博览中心召开

“2024杭州国际物联网展览会”定于4月份在杭州国际博览中心召开

随着科技的飞速发展，物联网已经成为当今社会的一个重要组成部分。物联网技术正在逐渐渗透到各个领域，为人们的生活带来更多的便利和智慧。物联网的发展趋势将受到技术、应用、安全等多方面的影响和推动。未来，物联网将更加智能化、自主化和安…
阅读更多...
10个手机通讯录恢复软件，请收好以备不时之需！

10个手机通讯录恢复软件，请收好以备不时之需！

随着我们的生活变得越来越数字化，我们中的许多人严重依赖智能手机和其他设备也就不足为奇了。我们在其中存储了大量有价值的信息，包括我们的联系人、笔记、消息等等。然而，这意味着当我们无法使用手机时，这可能是一个大问题。无法…
阅读更多...
【FI】FB02中Coding Block字段如何设置为可修改

【FI】FB02中Coding Block字段如何设置为可修改

本文基于S/4 HANA 2022 关于FB02下会计凭证行上的可更改字段的控制，以前以为只受“凭证明细行更变规则”（OB32）的影响。 今天碰到了Coding Block字段的情况，它不受OB32的影响，而是受表TCOBX控制。 如何确认该字段是Cod…
阅读更多...
论文阅读——Detection Hub（cvpr2023）

论文阅读——Detection Hub（cvpr2023）

Detection Hub: Unifying Object Detection Datasets via Query Adaptation on Language Embedding 一、要解决的问题 大规模数据集可以提高模型性能，但是当训练多类别单一模型时，大规模数据集不能用在目标检测任务上，因为两个困难&#xff1…
阅读更多...
windows内存取证-简单

windows内存取证-简单

使用工具： volatility3-develop 题干： 作为 Security Blue 团队的成员，您的任务是使用 Redline 和 Volatility 工具分析内存转储。您的目标是跟踪攻击者在受感染计算机上采取的步骤，并确定他们如何设法绕过网络入侵检测系统“N…
阅读更多...
设计模式—结构型模式之装饰器模式

设计模式—结构型模式之装饰器模式

设计模式—结构型模式之装饰器模式 适配器是连接两个类，可以增强一个类，装饰器是增强一个类。 向一个现有的对象添加新的功能，同时又不改变其结构。属于对象结构型模式。 创建了一个装饰类，用来包装原有的类，并在保…
阅读更多...
【Linux】进程的基本概念和进程控制

【Linux】进程的基本概念和进程控制

TOC 目录 一.冯诺依曼体系结构 二. 操作系统(Operator System) 概念 设计OS的目的 定位 总结 系统调用和库函数概念 进程 基本概念 描述进程-PCB task_struct-PCB的一种 task_ struct内容分类 组织进程 查看进程 通过系统调用获取进程标识符 进程状态 D--深度…
阅读更多...
使用决策树预测隐形眼镜类型

使用决策树预测隐形眼镜类型

任务描述 本关任务：编写一个例子讲解决策树如何预测患者需要佩戴的隐形眼镜类型。使用小数据集，我们就可以利用决策树学到很多知识：眼科医生是如何判断患者需要佩戴的镜片类型，一旦理解了决策树的工作原理，我们甚至也…
阅读更多...
Process Monitor 进程监控器 exe监控 windows程序监控

Process Monitor 进程监控器 exe监控 windows程序监控

以查看 百度网盘 为例 Process Monitor 进程监控器 Process Monitor(进程监视器) 这个Windows系统进程监控工具相关。Process Monitor是一个免费的系统监视和故障排除工具,可以实时监视系统进程、线程、文件操作、注册表操作等,生成活动日志,可以用来分析系统和程序的行为。 下…
阅读更多...
Redis系列之常见数据类型应用场景

Redis系列之常见数据类型应用场景

文章目录 String简单介绍常见命令应用场景 Hash简单介绍常见命令应用场景 List简单介绍常见命令应用场景 Set简单介绍常见命令应用场景 Sorted Set(Zset)简单介绍常见命令应用场景 Bitmap简单介绍常见命令应用场景 附录 Redis支持多种数据类型，比如String、hash、li…
阅读更多...
基于JavaWeb的网上销售系统设计与实现

基于JavaWeb的网上销售系统设计与实现

项目描述 临近学期结束，还是毕业设计，你还在做java程序网络编程，期末作业，老师的作业要求觉得大了吗?不知道毕业设计该怎么办?网页功能的数量是否太多?没有合适的类型或系统?等等。这里根据疫情当下，你想解决的问…
阅读更多...
基于OCC+OSG集成框架下的GMSH之二阶网格划分探索

基于OCC+OSG集成框架下的GMSH之二阶网格划分探索

二阶网格相对于一阶网格，其计算节点数量更多，具体表现在一个一阶网格下的三角形中的每个边的中点构建一个点，对一阶三角形网格划分成四个三角形。gmsh提供了网格阶数设置，一般默认是一阶网格，本人根据gmsh文档&#xf…
阅读更多...
To create the 45th Olympic logo by using CSS

To create the 45th Olympic logo by using CSS

You are required to create the 45th Olympic logo by using CSS. The logo is composed of five rings and three rectangles with rounded corners. The HTML code has been given. It is not allowed to add, edit, or delete any HTML elements. 私信完整源码 <!DOCT…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023