Nginx的ngx_http_userid_module模块用于生成和传递用户标识符（UID），通常通过Cookie实现。该模块可以帮助跟踪用户会话或进行用户行为分析。

模块指令

  1. userid: 启用或禁用用户标识符生成。

    • 语法: userid on | off | v1 | log;

    • 默认值: off;

    • 上下文: http, server, location;

  2. userid_name: 设置Cookie的名称。

    • 语法: userid_name name;

    • 默认值: uid;

    • 上下文: http, server, location;

  3. userid_domain: 设置Cookie的域名。

    • 语法: userid_domain domain;

    • 默认值: none;

    • 上下文: http, server, location;

  4. userid_path: 设置Cookie的路径。

    • 语法: userid_path path;

    • 默认值: /;

    • 上下文: http, server, location;

  5. userid_expires: 设置Cookie的过期时间。

    • 语法: userid_expires time;

    • 默认值: off;

    • 上下文: http, server, location;

  6. userid_p3p: 设置P3P策略。

    • 语法: userid_p3p policy;

    • 默认值: none;

    • 上下文: http, server, location;

  7. userid_mark: 设置Cookie的标记。

    • 语法: userid_mark letter;

    • 默认值: none;

    • 上下文: http, server, location;

案例

以下是一个简单的配置示例，用于生成并传递用户标识符：

http {
    userid on;
    userid_name uid;
    userid_domain example.com;
    userid_path /;
    userid_expires 365d;
    userid_p3p "CP=\"IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT\"";
    userid_mark U;

    server {
        listen 80;
        server_name example.com;

        location / {
            proxy_pass http://backend;
        }
    }
}

解释

  • userid on;：启用用户标识符生成。

  • userid_name uid;：设置Cookie名称为uid。

  • userid_domain example.com;：设置Cookie的域名为example.com。

  • userid_path /;：设置Cookie的路径为根路径/。

  • userid_expires 365d;：设置Cookie的过期时间为365天。

  • userid_p3p "CP=\"IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT\"";：设置P3P策略。

  • userid_mark U;：设置Cookie的标记为U。

结果

当用户访问example.com时，Nginx会生成一个名为uid的Cookie，并将其传递给后端服务器。该Cookie的有效期为365天，路径为根路径，域名为example.com。

本篇文章内容来源于：Nginx用户cookie模块详细说明以及案例