captcha_star
在 NGINX 中启用验证码图片的生成。
NGINX Captcha Module
·
httpserverlocation
语法captcha;
默认值none
上下文http, server, location
参数1
说明
captcha_star 指令是 NGINX Captcha Module 的一部分,用于 HTTP、server 和 location 块的上下文中。当启用此指令时,它会指示 NGINX 生成用于用户验证的验证码图片。这在防止表单的自动提交方面尤其有用,通过确保用户为真人来增强安全性。该指令与其他相关设置配合使用,允许自定义验证码的功能,例如图像大小、字符集和过期时间。
默认情况下,该模块提供若干配置选项来控制验证码图片的外观和行为,包括图像尺寸(宽度和高度)、文本长度、用于验证码文本的字符集,以及验证码 cookie 的过期时间。可以根据应用需求设置这些参数,确保验证码既安全又对用户友好。值得注意的是,该指令本身没有默认值,因为它在被调用时定义了一个行为,这与设置特定参数或开关的指令形成对比。
配置示例
location =/captcha {
captcha;
}⚠
确保验证码图片可访问,否则用户可能会遇到验证问题。
⚠
在表单提交时,记得正确处理验证码校验,以避免不必要的错误。
⚠
检查用于生成验证码的字体路径和 CSRF 变量设置是否已正确配置。