nginx的upstream配置和作用是什麼-Nginx-PHP中文網

設定範例

upstream backend {
  server backend1.example.com    weight=5;
  server backend2.example.com:8080;
  server unix:/tmp/backend3;

  server backup1.example.com:8080  backup;
  server backup2.example.com:8080  backup;
}

server {
  location / {
    proxy_pass http://backend;
  }
}

登入後複製

指令

#語法:	upstream name { ... }
預設值:	—
#上下文:	#http

定義一組伺服器。這些伺服器可以監聽不同的連接埠。而且，監聽在tcp和unix域套接字的伺服器可以混用。

範例：

upstream backend {
  server backend1.example.com weight=5;
  server 127.0.0.1:8080    max_fails=3 fail_timeout=30s;
  server unix:/tmp/backend3;
}

登入後複製

預設情況下，nginx會依照加權輪替的方式將請求分發到各伺服器。在上面的範例中，每7個請求會透過以下方式分發： 5個請求分到backend1.example.com，一個請求分到第二個伺服器，一個請求分到第三個伺服器。與伺服器通訊的時候，如果發生錯誤，請求會傳給下一個伺服器，直到所有可用的伺服器都被嘗試過。如果所有伺服器都回傳失敗，客戶端將會得到最後通訊的那個伺服器的（失敗）回應結果。

語法:	server address [parameters];
預設值:	—
上下文:	upstream

#定義伺服器的位址address和其他參數parameters。位址可以是網域名稱或ip位址，連接埠是可選的，或是指定「unix:」前綴的unix域套接字的路徑。如果沒有指定端口，就使用80端口。如果一個網域解析到多個ip，本質上是定義了多個server。

你可以定義下面的參數：weight=number設定伺服器的權重，預設是1。 max_fails=number設定nginx與伺服器通訊的嘗試失敗的次數。在fail_timeout參數定義的時間段內，如果失敗的次數達到此值，nginx就認為伺服器不可用。在下一個fail_timeout時間段，伺服器不會再被嘗試。失敗的嘗試次數預設是1。設為0就會停止統計嘗試次數，認為伺服器是一直可用的。你可以透過指令proxy_next_upstream、 fastcgi_next_upstream和memcached_next_upstream來設定什麼是失敗的嘗試。預設配置時，http_404狀態不被認為是失敗的嘗試。 fail_timeout=time設定

統計失敗嘗試次數的時間段。在這段時間中，伺服器失敗次數達到指定的嘗試次數，伺服器就被認為不可用。
伺服器被認為不可用的時間段。

預設情況下，該超時時間是10秒。 backup標記為備用伺服器。當主伺服器無法使用以後，請求會傳給這些伺服器。 down標記伺服器永久不可用，可以跟ip_hash指令一起使用。

example:

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

  server backup1.example.com:8080 backup;
}

登入後複製

語法:	ip_hash;
默認值:	—
上下文:	upstream

##指定伺服器群組的負載均衡方法，請求基於客戶端的ip位址在伺服器間進行分發。 ipv4位址的前三個位元組或ipv6的整個位址，會被用來當作一個雜湊key。這種方法可以確保從同一個客戶端過來的請求，會傳給同一台伺服器。除了當伺服器被認為不可用的時候，這些客戶端的請求會被傳給其他伺服器，而且很有可能也是同一台伺服器。

從1.3.2和1.2.2版本開始支援ipv6位址。

如果其中一個伺服器想暫時移除，應該要加上down參數。這樣可以保留目前客戶端ip位址雜湊分佈。

範例：

upstream backend {
  ip_hash;

  server backend1.example.com;
  server backend2.example.com;
  server backend3.example.com down;
  server backend4.example.com;
}

登入後複製

從1.3.1和1.2.2版本開始，ip_hash的負載平衡方法才支援設定伺服器權重值。

語法:keepalive connections;預設值:—上下文:upstream#

这个指令出现在版本 1.1.4.

激活对上游服务器的连接进行缓存。

connections参数设置每个worker进程与后端服务器保持连接的最大数量。这些保持的连接会被放入缓存。如果连接数大于这个值时，最久未使用的连接会被关闭。

需要注意的是，keepalive指令不会限制nginx进程与上游服务器的连接总数。新的连接总会按需被创建。 connections参数应该稍微设低一点，以便上游服务器也能处理额外新进来的连接。

配置memcached上游服务器连接keepalive的例子：

upstream memcached_backend {
  server 127.0.0.1:11211;
  server 10.0.0.2:11211;

  keepalive 32;
}

server {
  ...

  location /memcached/ {
    set $memcached_key $uri;
    memcached_pass memcached_backend;
  }

}

登入後複製

对于http代理，proxy_http_version指令应该设置为“1.1”，同时“connection”头的值也应被清空。

upstream http_backend {
  server 127.0.0.1:8080;

  keepalive 16;
}

server {
  ...

  location /http/ {
    proxy_pass http://http_backend;
    proxy_http_version 1.1;
    proxy_set_header connection "";
    ...
  }
}

登入後複製

另外一种选择是，http/1.0协议的持久连接也可以通过发送“connection: keep-alive”头来实现。不过不建议这样用。

对于fastcgi的服务器，需要设置 fastcgi_keep_conn 指令来让连接keepalive工作：

upstream fastcgi_backend {
  server 127.0.0.1:9000;

  keepalive 8;
}

server {
  ...

  location /fastcgi/ {
    fastcgi_pass fastcgi_backend;
    fastcgi_keep_conn on;
    ...
  }
}

登入後複製

当使用的负载均衡方法不是默认的轮转法时，必须在keepalive 指令之前配置。

针对scgi和uwsgi协议，还没有实现其keepalive连接的打算。

语法:	least_conn;
默认值:	—
上下文:	upstream

这个指令出现在版本 1.3.1 和 1.2.2.

指定服务器组的负载均衡方法，根据其权重值，将请求发送到活跃连接数最少的那台服务器。如果这样的服务器有多台，那就采取有权重的轮转法进行尝试。

嵌入的变量

ngx_http_upstream_module模块支持以下嵌入变量：

$upstream_addr保存服务器的ip地址和端口或者是unix域套接字的路径。在请求处理过程中，如果有多台服务器被尝试了，它们的地址会被拼接起来，以逗号隔开，比如： “192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock”。如果在服务器之间通过“x-accel-redirect”头或者error_page有内部跳转，那么这些服务器组之间会以冒号隔开，比如：“192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock : 192.168.10.1:80, 192.168.10.2:80”。$upstream_response_time以毫秒的精度保留服务器的响应时间，（输出）单位是秒。出现多个响应时，也是以逗号和冒号隔开。$upstream_status保存服务器的响应代码。出现多个响应时，也是以逗号和冒号隔开。$upstream_http_...保存服务器的响应头的值。比如“server”响应头的值可以通过$upstream_http_server变量来获取。需要注意的是只有最后一个响应的头会被保留下来。

以上是nginx的upstream配置和作用是什麼的詳細內容。更多資訊請關注PHP中文網其他相關文章！