Split Clients#

该模块用于 A/B 测试、金丝雀发布或其他需要将一部分客户端路由到一个服务器或配置，同时将其余部分路由到其他地方的场景。

配置示例#

http {
    split_clients "${remote_addr}AAA" $variant {
                   0.5%               .one;
                   2.0%               .two;
                   *                  "";
    }

    server {
        location / {
            index index${variant}.html;

指令#

split_clients#

语法

split_clients string $variable { ... }

默认值

—

上下文

http

通过哈希 string 创建一个 $variable； string 中的变量被替换， 替换结果被哈希， 然后将哈希值用于选择 $variable 的字符串值。

哈希函数使用 MurmurHash2 （32 位）， 其整个值范围 （0 到 4294967295） 按出现顺序映射到桶中； 百分比决定了桶的大小。 通配符 (*) 可以出现在最后； 不属于其他桶的哈希值会映射到其指定的值。

示例：

split_clients "${remote_addr}AAA" $variant {
               0.5%               .one;
               2.0%               .two;
               *                  "";
}

在这里，替换 $remote_addrAAA 字符串后， 哈希值分布如下：

  • 值从 0 到 21474835（0.5%）产生 .one；

  • 值从 21474836 到 107374180（2%）产生 .two；

  • 值从 107374181 到 4294967295（所有其他值）产生 "" （空字符串）。