ngx_http_userid_module 模块

ngx_http_userid_module 模块设置适用于客户端标识的 cookie。可以使用嵌入式变量 $uid_got 和 $uid_set 记录接收和设置的 cookie。此模块与 Apache 的 mod_uid 模块兼容。

userid         on;
userid_name    uid;
userid_domain  example.com;
userid_path    /;
userid_expires 365d;
userid_p3p     'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';

userid off;

启用或禁用设置 cookie 和记录接收的 cookie

on

启用设置版本 2 cookie 和记录接收的 cookie；

v1

启用设置版本 1 cookie 和记录接收的 cookie；

log

禁用设置 cookie，但启用记录接收的 cookie；

off

禁用设置 cookie 和记录接收的 cookie。

userid_domain none;

定义设置 cookie 的域。none 参数禁用为 cookie 设置域。

userid_expires off;

设置浏览器应保留 cookie 的时间。参数 max 将导致 cookie 在“31 Dec 2037 23:55:55 GMT”过期。参数 off 将导致 cookie 在浏览器会话结束时过期。

userid_flags off;

如果参数不是 off，则为 cookie 定义一个或多个附加标志：secure、httponly、samesite=strict、samesite=lax、samesite=none。

userid_mark off;

如果参数不是 off，则启用 cookie 标记机制并设置用作标记的字符。此机制用于在保留客户端标识符的同时添加或更改 userid_p3p 和/或 cookie 过期时间。标记可以是英语字母（区分大小写）、数字或“=”字符的任何字母。

如果设置了标记，则将其与 cookie 中传递的客户端标识符的 base64 表示中的第一个填充符号进行比较。如果不匹配，则使用指定的标记、过期时间和“P3P”标头重新发送 cookie。

userid_name uid;

设置 cookie 名称。

userid_p3p none;

设置将与 cookie 一起发送的“P3P”标头字段的值。如果指令设置为特殊值 none，则“P3P”标头将不会在响应中发送。

userid_path /;

定义设置 cookie 的路径。

userid_service IP address of the server;

如果标识符由多个服务器（服务）发出，则应为每个服务分配其自己的 number 以确保客户端标识符是唯一的。对于版本 1 cookie，默认值为零。对于版本 2 cookie，默认值是由服务器 IP 地址的最后四个八位字节组成的数字。

ngx_http_userid_module 模块支持以下嵌入式变量

$uid_got

cookie 名称和接收的客户端标识符。

$uid_reset

如果变量设置为非空字符串（不为“0”），则客户端标识符将被重置。特殊值“log”还会导致将有关重置标识符的消息输出到 error_log。

$uid_set

cookie 名称和发送的客户端标识符。