Apache 模块 mod_usertrack
| Description: | 点击流记录网站上的用户活动 |
|---|---|
| Status: | Extension |
| Module Identifier: | usertrack_module |
| Source File: | mod_usertrack.c |
Summary
通过浏览器 cookie 通过您的网站跟踪用户。
Logging
mod_usertrack设置 cookie，该 cookie 可以通过mod_log_config可配置的日志记录格式进行记录：
LogFormat "%{Apache}n %r %t" usertrack
CustomLog "logs/clickstream.log" usertrack
CookieDomain Directive
| Description: | 跟踪 Cookie 适用的域 |
|---|---|
| Syntax: | CookieDomain domain |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
此伪指令控制跟踪 cookie 应用于的域的设置。如果不存在，则 cookie Headers 字段中不包含任何域。
域字符串“必须”以点开头，并且“必须”至少包含一个嵌入式点。也就是说，.example.com是合法的，而www.example.com和.com不是合法的。
Note
当今使用的大多数浏览器都不允许为两部分的顶级域(例如.co.uk)设置 cookie，尽管这种域表面上可以满足上述要求。
这些域等效于诸如.com之类的顶级域，并且允许此类 cookie 可能会带来安全风险。因此，如果您是由两部分组成的顶级域，则仍应使用您的实际域，就像使用其他任何顶级域(例如.example.co.uk)一样。
CookieDomain .example.com
CookieExpires Directive
| Description: | 跟踪 Cookie 的到期时间 |
|---|---|
| Syntax: | CookieExpires expiry-period |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
使用时，此伪指令在 usertrack 模块生成的 cookie 上设置到期时间。 “有效期限”可以以秒为单位，也可以以“ 2 周 3 天 7 小时”之类的格式给出。有效面额是：年，月，周，天，小时，分钟和秒。如果到期时间采用除表示秒数的数字以外的任何格式，则必须用双引号引起来。
如果不使用此指令，则 cookie 仅在当前浏览器会话中持续存在。
CookieExpires "3 weeks"
CookieHTTPOnly Directive
| Description: | 将“ HTTPOnly”属性添加到 cookie |
|---|---|
| Syntax: | CookieHTTPOnly on|off |
| Default: | CookieHTTPOnly off |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
| Compatibility: | 2 .4.42 及更高版本 |
设置为“ ON”时，“ HTTPOnly” cookie 属性将添加到此模块跟踪 cookie。此属性指示浏览器阻止 javascript 读取 cookie 的值。
CookieName Directive
| Description: | 跟踪 Cookie 的名称 |
|---|---|
| Syntax: | CookieName token |
| Default: | CookieName Apache |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
此伪指令允许您更改此模块用于其跟踪目的的 cookie 的名称。默认情况下，cookie 的名称为“ Apache”。
您必须指定一个有效的 cookie 名称；如果使用包含不寻常字符的名称，结果将无法预测。有效字符包括 A-Z，a-z，0-9，“ _”和“-”。
CookieName clicktrack
CookieSameSite Directive
| Description: | 将“ SameSite”属性添加到 Cookie |
|---|---|
| Syntax: | CookieSameSite None|Lax|Strict |
| Default: | unset |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
| Compatibility: | 2 .4.42 及更高版本 |
当设置为“ None”，“ Lax”或“ Strict”时，“ SameSite” cookie 属性将以相应的值添加到此模块中，以跟踪 cookie。此属性指示浏览器在跨站点上下文中请求 Cookie 时如何处理。
Note
值“ None”设置为“ SameSite = None”，这是最宽松的设置。要忽略此属性，请完全忽略该指令。
CookieSecure Directive
| Description: | 将“安全”属性添加到 Cookie |
|---|---|
| Syntax: | CookieSecure on|off |
| Default: | CookieSecure off |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
| Compatibility: | 2 .4.42 及更高版本 |
设置为“开”时，“安全” cookie 属性将添加到此模块跟踪 cookie。此属性指示浏览器仅通过 HTTPS 传输 cookie。
CookieStyle Directive
| Description: | Cookie Headers 字段的格式 |
|---|---|
| Syntax: | CookieStyle Netscape|Cookie|Cookie2|RFC2109|RFC2965 |
| Default: | CookieStyle Netscape |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
此伪指令控制 cookie Headers 字段的格式。允许的三种格式是：
-
Netscape ，它是原始但现在已弃用的语法。这是默认设置，也是 Apache 过去使用的语法。
-
Cookie 或 RFC2109 ，它是取代 Netscape 语法的语法。
-
Cookie2 或 RFC2965 ，这是最新的 cookie 语法。
并非所有 Client 端都能理解所有这些格式，但是您应该使用用户浏览器通常可以接受的最新格式。在撰写本文时，大多数浏览器都支持这三种格式，其中Cookie2是首选格式。
CookieStyle Cookie2
CookieTracking Directive
| Description: | 启用跟踪 Cookie |
|---|---|
| Syntax: | CookieTracking on|off |
| Default: | CookieTracking off |
| Context: | 服务器配置，虚拟主机，目录，.htaccess |
| Override: | FileInfo |
| Status: | Extension |
| Module: | mod_usertrack |
加载mod_usertrack并设置CookieTracking on后，Apache 将为所有新请求发送一个用户跟踪 cookie。此伪指令可用于按服务器或按目录打开或关闭此行为。默认情况下，启用mod_usertrack将 不 激活 cookie。
CookieTracking on
