captcha_star

在 NGINX 中启用验证码图片的生成。

语法captcha;
默认值none
上下文http, server, location
参数1

说明

captcha_star 指令是 NGINX Captcha Module 的一部分,用于 HTTP、server 和 location 块的上下文中。当启用此指令时,它会指示 NGINX 生成用于用户验证的验证码图片。这在防止表单的自动提交方面尤其有用,通过确保用户为真人来增强安全性。该指令与其他相关设置配合使用,允许自定义验证码的功能,例如图像大小、字符集和过期时间。

默认情况下,该模块提供若干配置选项来控制验证码图片的外观和行为,包括图像尺寸(宽度和高度)、文本长度、用于验证码文本的字符集,以及验证码 cookie 的过期时间。可以根据应用需求设置这些参数,确保验证码既安全又对用户友好。值得注意的是,该指令本身没有默认值,因为它在被调用时定义了一个行为,这与设置特定参数或开关的指令形成对比。

配置示例

location =/captcha {
    captcha;
}

确保验证码图片可访问,否则用户可能会遇到验证问题。

在表单提交时,记得正确处理验证码校验,以避免不必要的错误。

检查用于生成验证码的字体路径和 CSRF 变量设置是否已正确配置。

← 返回所有指令