Nginx系列教程：HTTP Upstream Request Hash模組

ngx_HTTP_upstream_hash_module

本模組由協力廠商提供，不包含在 Nginx 的源碼發佈版中。

upstream_hash該模組提供了簡單的上游負載分配，通過散列一個可配置的變數（例如，請求URI，傳入的HTTP標頭或一些組合）。 用法示例如下：

upstream backend {: server server1;: server server2;: hash $request_uri;}

在這裡，nginx將通過散列請求的URI（$ REQUEST_URI）選擇Server1或Server2。

指令

[#hash hash] [#hash_method hash_method] [#hash_again hash_again]

Template:Anchor

hash

語法： hash $variable
作用域： upstream
啟用上游$variable變數的散列。
目前，「伺服器」指令不能執行任何參數（"weight", "max_fails"，等）。
Template:Anchor

hash_method

語法： hash_method [ crc32 | simple ]
預設值： simple
作用域： upstream
該雜湊演算法使用 「crc32」取用crc32值的最後15位，並通過伺服器數量按模計算。 （此行為相容與libmemcache。 ）詳見如下描述的「The "simple" hash algorithm」。
Template:Anchor

hash_again

語法： hash_again number
預設值： 0
作用域： upstream
如果後端連接失敗時，用時間數量重新處理值，並選擇不同的伺服器。 增加該數位以提供高可用性。
Template:Anchor

安裝

該模組不是Nginx源的分佈。 您可以在這裡下載request_hash 模組：nginx_upstream_hash-0.2.tar.gz 。

解壓後，你將需要打補丁到最新的Nginx源（0.5.21版本）。 運行補丁如下：

: cd nginx-0.5.21: patch -p0 < /path/to/upstream/hash/directory/nginx-0.5.21.patch

然後添加以下選項到你的Nginx ./configure命令中:

: --add-module=path/to/upstream/hash/directory

然後，正常運行"make"和"make install"。

Template:Anchor

The "simple" hash algorithm

"simple" hash algorithm是與Nginx內部雜湊表中使用的相同。 該功能是：

u_int ngx_hash_key(u_char *data, size_t len){: u_int i, key;: key = 0;: for (i = 0; i < len; i++) {: key *= 31; : key += data[i] ;: }: return key;}

該雜湊值是被選擇伺服器數量的modulo'd 。 一個伺服器索引可以由出現在上游塊的順序來確定。