testcookie_refresh_status

testcookie_refresh_status 指令控制在 NGINX 的 testcookie 机器人缓解模块中挑战 cookie 刷新过程中返回的 HTTP 状态码。

语法testcookie_refresh_status status_code;
默认值200
上下文http, server, location
参数1

说明

testcookie_refresh_status 指令指定 NGINX 在处理刷新现有挑战 cookie 的请求时将返回的 HTTP 状态码。该指令允许您定义客户端如何被通知 cookie 刷新状态,从而确保您的应用能够适当地处理 cookie 刷新请求。通过配置此指令,您可以管理与 cookie 验证相关的可见性和用户体验,这对于维护会话完整性和用户导航流程尤为重要。

当收到刷新请求时,NGINX 会根据 testcookie_refresh_status 的配置值以指定的 HTTP 状态进行响应。这对于确保自动化系统(例如网页爬虫或机器人)不会误解 cookie 处理行为至关重要,避免误将合法用户阻断。此外,这可以与 testcookie 模块中的其他指令结合使用,以构建更健全的机器人缓解策略,从而更精细地控制 cookie 的设置与验证方式。

该指令接受一个参数,即要返回的状态码。它可以在诸如 httpserverlocation 等不同上下文中设置,从而适用于不同的应用结构。正确使用此指令可以增强服务器在处理挑战时的响应策略,确保在涉及 cookie 管理时为终端用户提供更顺畅的体验。建议设置符合标准 HTTP 状态码的值,以避免应用错误。

配置示例

location /check-cookies {
    testcookie_refresh_status 200;
}

确保使用的 status code 是有效的 HTTP status code,以避免客户端错误。

如果与其他错误配置的 cookie 设置一起使用,配置不正确可能导致客户端出现无限循环。

设置 status code 时要小心;返回 403 可能会阻止合法用户访问内容。

← 返回所有指令