auth_http_timeout
为 NGINX 邮件模块中的 HTTP 授权请求设置超时时间。 — NGINX Mail Core
auth_http_timeout
mailmail server
语法auth_http_timeout time;
默认值none
上下文mail, mail server
模块NGINX Mail Core
参数1
说明
`auth_http_timeout` 指令定义了与用于身份验证的 HTTP 服务器通信的超时时间(用于 NGINX 邮件模块)。当与外部身份验证系统集成时,这一点尤为重要,因为获取响应可能比预期或所需的时间更长。`auth_http_timeout` 的参数以时间格式指定,可以包含诸如秒 (s)、分钟 (m)、小时 (h) 等时间单位。 如果超过指定的超时时间,邮件服务器会向客户端返回错误响应。这有助于防止由于身份验证响应缓慢而导致邮件事务被无限期阻塞。管理员需要选择一个在为合法身份验证过程留出足够时间与限制等待时间以确保用户响应性之间取得平衡的值。在许多使用场景中,几秒钟的超时通常就足够了。 该指令可以放在 `mail` 或 `mail server` 上下文中,这意味着它必须在与邮件服务相关的 NGINX 配置文件的相应块内进行定义。作为配置设置的一部分,务必正确配置此指令以确保邮件服务器的最佳性能,尤其是在需要针对外部服务进行用户身份验证的环境中。
配置示例
mail {
auth_http_timeout 5s;
server {
listen 110;
protocol pop3;
}
}⚠
确保 timeout 值合理,以避免拒绝合法的身份验证尝试。
⚠
验证外部 HTTP 身份验证服务器在给定的 timeout 时段内是否有响应。
⚠
检查时间格式的有效性;使用无效的格式可能导致配置错误。