userid_mark

'userid_mark' 指令用于在 NGINX 中设置用于用户跟踪的唯一标识符。 — NGINX HTTP Core

userid_mark
httpserverlocation
语法userid_mark string;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

'userid_mark' 指令允许管理员定义一个将与用户会话关联的字符串。该标识符可用于跨多个请求跟踪用户交互或状态。该指令对于分析用户行为、管理会话或与分析工具集成特别有用。通过设置此唯一标识符,NGINX 可以在各种应用中(例如 Web 应用或跟踪工具)保持用户连续性。 配置后,'userid_mark' 将被附加到 NGINX 处理的每个请求的头部。它可接受一个参数,该参数指定标记本身,并且可以包含在 'http'、'server' 或 'location' 上下文中以控制标识符生效的范围。这种配置灵活性允许实现全局和局部的用户跟踪。 此外,由于此指令处理用户标识符,应该考虑隐私和用户数据保护方面的敏感问题。应采取适当措施以确保标识符为匿名且不会暴露可识别个人身份的信息(PII)。

配置示例

http {
    userid_mark "$session_id";
    server {
        location / {
            # additional configuration
        }
    }
}

确保传入的参数不包含空白字符,因为这可能导致意外行为。

如果在多个上下文中设置了 'userid_mark',请注意其层级和覆盖性,因为更具体的配置可能会覆盖全局配置。