Nginx 通过 Cookie 做灰度就这么简单

由于业务需要，要做灰度发布测试，刚开始考虑通过 IP 来做判断，分发不同的后端，但是由于 IP 不好确定，有的客户端 IP 不固定，所以考虑用 cookie 来做

逻辑很简单，如下图：

在 nginx 做这个很简单，两个方法，map 或 if

首先看 map 怎么做

为了模拟环境，我又不想多开服务器，所以起了个 httpd，配置两个 vhost，当作两个后端，如下：

我给这两个 vhost，配置不同的 DocumentRoot，web 目录中只放了一个 index.html 的页面，内容分别是 Cookie1 和 Cookie2

后端就模拟完成了，在正式开始 map 配置前，先简单介绍下 map 这个模块

nginx 官方文档中的 example。map 指令是由 ngx_http_map_module 模块提供的，一般默认都会安装

map 的主要作用是创建自定义变量，做变量的映射，变量的值取决于第一个参数指定的一个或多个源变量的值

怎么理解呢，拿上面官网的配置案例来说，$http_host 映射第一列 example.com 等，也就是第一个参数，$name 映射第二列 0、1 等，也就是第二个参数，当 $http_host 值为 example.com 时，$name 值就是 1，以此类推，如果都没匹配到，那就是 default 的值，如果没有定义 default，那就是空

这么解释应该理解了吧

所以我这里就是要通过对 cookie 的值来设置 nginx 反向代理的 upstream 的变量，先看 map 配置(map 只能定义在 http 中)

这里为了方便，我就直接定义 cookie_name 为 001，值为 1、2 这样，方便测试，这里说一下，对于 cookie 值的获取，就是通过 cookie_NAME，NAME 为 cookie 的名称，通过这种方式可以获取到该 cookie 对应的值，然后通过 cookie 的值去定义变量

然后配置 upstream，分发到不同的后端

测试一下

这里安利一个 chrome 插件-EditThisCookie，可以直接修改 cookie

这里设置好 cookie 之后，访问

设置成 cookie=2

ok，没有问题。

if 方法其实是一样的，只是 if 的话，是通过 set 去给变量赋值，配置如下：

效果就不展示了，和上面一样，这样就可以结合业务，设置 cookie 的不同的值，来做到不同客户端的灰度，做测试也好，AB 也好，都是可以很方便的实现。

另外附一个 nginx 内置变量表

• $args                    #请求中的参数值

• $query_string            #同 $args

• $arg_NAME                #GET 请求中 NAME 的值

• $is_args                 #如果请求中有参数，值为"?"，否则为空字符串

• $uri                     #请求中的当前 URI(不带请求参数，参数位于 $args)，可以不同于浏览器传递的 $request_uri 的值，它可以通过内部重定向，或者使用 index 指令进行修改，$uri 不包含主机名，如"/foo/bar.html"。

• $document_uri            #同 $uri

• $document_root           #当前请求的文档根目录或别名

• $host                    #优先级：HTTP 请求行的主机名>"HOST"请求头字段>符合请求的服务器名

• $hostname                #主机名

• $https                   #如果开启了 SSL 安全模式，值为"on"，否则为空字符串。

• $binary_remote_addr      #客户端地址的二进制形式，固定长度为 4 个字节 $body_bytes_sent         #传输给客户端的字节数，响应头不计算在内；这个变量和 Apache 的 mod_log_config 模块中的"%B"参数保持兼容

• $bytes_sent              #传输给客户端的字节数

• $connection              #TCP 连接的序列号

• $connection_requests     #TCP 连接当前的请求数量

• $content_length          #"Content-Length" 请求头字段

• $content_type            #"Content-Type" 请求头字段

• $cookie_name             #cookie 名称

• $limit_rate              #用于设置响应的速度限制

• $msec                    #当前的 Unix 时间戳

• $nginx_version           #nginx 版本

• $pid                     #工作进程的 PID

• $pipe                    #如果请求来自管道通信，值为"p"，否则为"."

• $proxy_protocol_addr     #获取代理访问服务器的客户端地址，如果是直接访问，该值为空字符串

• $realpath_root           #当前请求的文档根目录或别名的真实路径，会将所有符号连接转换为真实路径

• $remote_addr             #客户端地址

• $remote_port             #客户端端口

• $remote_user             #用于 HTTP 基础认证服务的用户名

• $request                 #代表客户端的请求地址

• $request_body            #客户端的请求主体：此变量可在 location 中使用，将请求主体通过 proxy_pass，fastcgi_pass，uwsgi_pass 和 scgi_pass 传递给下一级的代理服务器

• $request_body_file       #将客户端请求主体保存在临时文件中。文件处理结束后，此文件需删除。如果需要之一开启此功能，需要设置 client_body_in_file_only。如果将次文件传递给后端的代理服务器，需要禁用 request body，即设置 proxy_pass_request_body off，fastcgi_pass_request_body off，uwsgi_pass_request_body off，or scgi_pass_request_body off

• $request_completion      #如果请求成功，值为"OK"，如果请求未完成或者请求不是一个范围请求的最后一部分，则为空

• $request_filename        #当前连接请求的文件路径，由 root 或 alias 指令与 URI 请求生成

• $request_length          #请求的长度 (包括请求的地址，http 请求头和请求主体)

• $request_method          #HTTP 请求方法，通常为"GET"或"POST"

• $request_time            #处理客户端请求使用的时间; 从读取客户端的第一个字节开始计时

• $request_uri             #这个变量等于包含一些客户端请求参数的原始 URI，它无法修改，请查看 $uri 更改或重写 URI，不包含主机名，例如："/cnphp/test.php?arg=freemouse"

• $scheme                  #请求使用的 Web 协议，"http" 或 "https"

• $server_addr             #服务器端地址，需要注意的是：为了避免访问 linux 系统内核，应将 ip 地址提前设置在配置文件中

• $server_name             #服务器名

• $server_port             #服务器端口

• $server_protocol         #服务器的 HTTP 版本，通常为 "HTTP/1.0" 或 "HTTP/1.1"

• $status                  #HTTP 响应代码

• $time_iso8601            #服务器时间的 ISO 8610 格式

• $time_local              #服务器时间（LOG Format 格式）

• $cookie_NAME             #客户端请求 Header 头中的 cookie 变量，前缀"$cookie_"加上 cookie 名称的变量，该变量的值即为 cookie 名称的值

• $http_NAME               #匹配任意请求头字段；变量名中的后半部分 NAME 可以替换成任意请求头字段，如在配置文件中需要获取 http 请求头："Accept-Language"，$http_accept_language 即可

• $http_cookie

• $http_post

• $http_referer

• $http_user_agent

• $http_x_forwarded_for

• $sent_http_NAME          #可以设置任意 http 响应头字段；变量名中的后半部分 NAME 可以替换成任意响应头字段，如需要设置响应头 Content-length，$sent_http_content_length 即可

• $sent_http_cache_control

• $sent_http_connection

• $sent_http_content_type

• $sent_http_keep_alive

• $sent_http_last_modified

• $sent_http_location

• $sent_http_transfer_encoding

持续更新，欢迎扫码关注，觉得有用，可以分享！