配置例子

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;
  }
}

指令

定義一組服務(wù)器。 這些服務(wù)器可以監(jiān)聽(tīng)不同的端口。 而且，監(jiān)聽(tīng)在TCP和UNIX域套接字的服務(wù)器可以混用。

例子：

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

默認(rèn)情況下，nginx按加權(quán)輪轉(zhuǎn)的方式將請(qǐng)求分發(fā)到各服務(wù)器。 在上面的例子中，每7個(gè)請(qǐng)求會(huì)通過(guò)以下方式分發(fā)： 5個(gè)請(qǐng)求分到backend1.example.com， 一個(gè)請(qǐng)求分到第二個(gè)服務(wù)器，一個(gè)請(qǐng)求分到第三個(gè)服務(wù)器。 與服務(wù)器通信的時(shí)候，如果出現(xiàn)錯(cuò)誤，請(qǐng)求會(huì)被傳給下一個(gè)服務(wù)器，直到所有可用的服務(wù)器都被嘗試過(guò)。 如果所有服務(wù)器都返回失敗，客戶端將會(huì)得到最后通信的那個(gè)服務(wù)器的（失?。╉憫?yīng)結(jié)果。

定義服務(wù)器的地址address和其他參數(shù)parameters。 地址可以是域名或者IP地址，端口是可選的，或者是指定“unix:”前綴的UNIX域套接字的路徑。如果沒(méi)有指定端口，就使用80端口。 如果一個(gè)域名解析到多個(gè)IP，本質(zhì)上是定義了多個(gè)server。

你可以定義下面的參數(shù)：weight=number設(shè)定服務(wù)器的權(quán)重，默認(rèn)是1。max_fails=number設(shè)定Nginx與服務(wù)器通信的嘗試失敗的次數(shù)。在fail_timeout參數(shù)定義的時(shí)間段內(nèi)，如果失敗的次數(shù)達(dá)到此值，Nginx就認(rèn)為服務(wù)器不可用。在下一個(gè)fail_timeout時(shí)間段，服務(wù)器不會(huì)再被嘗試。 失敗的嘗試次數(shù)默認(rèn)是1。設(shè)為0就會(huì)停止統(tǒng)計(jì)嘗試次數(shù)，認(rèn)為服務(wù)器是一直可用的。 你可以通過(guò)指令proxy_next_upstream、 fastcgi_next_upstream和memcached_next_upstream來(lái)配置什么是失敗的嘗試。 默認(rèn)配置時(shí)，http_404狀態(tài)不被認(rèn)為是失敗的嘗試。fail_timeout=time設(shè)定

• 統(tǒng)計(jì)失敗嘗試次數(shù)的時(shí)間段。在這段時(shí)間中，服務(wù)器失敗次數(shù)達(dá)到指定的嘗試次數(shù)，服務(wù)器就被認(rèn)為不可用。
• 服務(wù)器被認(rèn)為不可用的時(shí)間段。

默認(rèn)情況下，該超時(shí)時(shí)間是10秒。backup標(biāo)記為備用服務(wù)器。當(dāng)主服務(wù)器不可用以后，請(qǐng)求會(huì)被傳給這些服務(wù)器。down標(biāo)記服務(wù)器永久不可用，可以跟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;
}

指定服務(wù)器組的負(fù)載均衡方法，請(qǐng)求基于客戶端的IP地址在服務(wù)器間進(jìn)行分發(fā)。 IPv4地址的前三個(gè)字節(jié)或者IPv6的整個(gè)地址，會(huì)被用來(lái)作為一個(gè)散列key。 這種方法可以確保從同一個(gè)客戶端過(guò)來(lái)的請(qǐng)求，會(huì)被傳給同一臺(tái)服務(wù)器。除了當(dāng)服務(wù)器被認(rèn)為不可用的時(shí)候，這些客戶端的請(qǐng)求會(huì)被傳給其他服務(wù)器，而且很有可能也是同一臺(tái)服務(wù)器。

從1.3.2和1.2.2版本開(kāi)始支持IPv6地址。

如果其中一個(gè)服務(wù)器想暫時(shí)移除，應(yīng)該加上down參數(shù)。這樣可以保留當(dāng)前客戶端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版本開(kāi)始，ip_hash的負(fù)載均衡方法才支持設(shè)置服務(wù)器權(quán)重值。

這個(gè)指令出現(xiàn)在版本 1.1.4.

激活對(duì)上游服務(wù)器的連接進(jìn)行緩存。

connections參數(shù)設(shè)置每個(gè)worker進(jìn)程與后端服務(wù)器保持連接的最大數(shù)量。這些保持的連接會(huì)被放入緩存。 如果連接數(shù)大于這個(gè)值時(shí)，最久未使用的連接會(huì)被關(guān)閉。

需要注意的是，keepalive指令不會(huì)限制Nginx進(jìn)程與上游服務(wù)器的連接總數(shù)。 新的連接總會(huì)按需被創(chuàng)建。 connections參數(shù)應(yīng)該稍微設(shè)低一點(diǎn)，以便上游服務(wù)器也能處理額外新進(jìn)來(lái)的連接。

配置memcached上游服務(wù)器連接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;
  }

}

對(duì)于HTTP代理，proxy_http_version指令應(yīng)該設(shè)置為“1.1”，同時(shí)“Connection”頭的值也應(yīng)被清空。

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協(xié)議的持久連接也可以通過(guò)發(fā)送“Connection: Keep-Alive”頭來(lái)實(shí)現(xiàn)。不過(guò)不建議這樣用。

對(duì)于FastCGI的服務(wù)器，需要設(shè)置 fastcgi_keep_conn 指令來(lái)讓連接keepalive工作：

upstream fastcgi_backend {
  server 127.0.0.1:9000;

  keepalive 8;
}

server {
  ...

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

當(dāng)使用的負(fù)載均衡方法不是默認(rèn)的輪轉(zhuǎn)法時(shí)，必須在keepalive 指令之前配置。

針對(duì)SCGI和uwsgi協(xié)議，還沒(méi)有實(shí)現(xiàn)其keepalive連接的打算。

這個(gè)指令出現(xiàn)在版本 1.3.1 和 1.2.2.

指定服務(wù)器組的負(fù)載均衡方法，根據(jù)其權(quán)重值，將請(qǐng)求發(fā)送到活躍連接數(shù)最少的那臺(tái)服務(wù)器。 如果這樣的服務(wù)器有多臺(tái)，那就采取有權(quán)重的輪轉(zhuǎn)法進(jìn)行嘗試。

嵌入的變量

ngx_http_upstream_module模塊支持以下嵌入變量：

$upstream_addr保存服務(wù)器的IP地址和端口或者是UNIX域套接字的路徑。 在請(qǐng)求處理過(guò)程中，如果有多臺(tái)服務(wù)器被嘗試了，它們的地址會(huì)被拼接起來(lái)，以逗號(hào)隔開(kāi)，比如： “192.168.1.1:80, 192.168.1.2:80, unix:/tmp/sock”。 如果在服務(wù)器之間通過(guò)“X-Accel-Redirect”頭或者error_page有內(nèi)部跳轉(zhuǎn)，那么這些服務(wù)器組之間會(huì)以冒號(hào)隔開(kāi)，比如：“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以毫秒的精度保留服務(wù)器的響應(yīng)時(shí)間，（輸出）單位是秒。 出現(xiàn)多個(gè)響應(yīng)時(shí)，也是以逗號(hào)和冒號(hào)隔開(kāi)。$upstream_status保存服務(wù)器的響應(yīng)代碼。 出現(xiàn)多個(gè)響應(yīng)時(shí)，也是以逗號(hào)和冒號(hào)隔開(kāi)。$upstream_http_...保存服務(wù)器的響應(yīng)頭的值。比如“Server”響應(yīng)頭的值可以通過(guò)$upstream_http_server變量來(lái)獲取。 需要注意的是只有最后一個(gè)響應(yīng)的頭會(huì)被保留下來(lái)。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論