captcha_font

'captcha_font' 指令设置用于在验证码图像中渲染文本的字体文件。

语法captcha_font path;
默认值/usr/share/fonts/ttf-liberation/LiberationSans-Regular.ttf
上下文http, server, location
参数1

说明

'captcha_font' 指令允许您指定用于渲染由 NGINX Captcha Module 生成的验证码图像中显示文本的字体文件。该字体可以是 TrueType 字体 (TTF) 或 OpenType Font (OTF)。指定的字体文件将决定字符的视觉表现方式,这对于创建独特且不易被识别的验证码挑战至关重要。字体选择的灵活性有助于将您的验证码与那些可能更容易被机器人读取的标准验证码区分开,从而增强安全性。

在配置该指令时,您需要提供一个 NGINX 进程可访问的有效字体文件路径。由于验证码图像的生成依赖于正确的字体渲染,请确保所选字体文件存在且可读取;否则,NGINX 可能无法正确生成验证码图像。此外,该指令应在 'http'、'server' 或 'location' 上下文中定义,以便根据您的应用架构提供足够的控制。

captcha_font 与其他验证码指令(例如 captcha_heightcaptcha_sizecaptcha_charset)结合使用,可以帮助微调验证码的视觉外观,以符合您的设计偏好,同时在防止自动提交方面保持安全性。

配置示例

location =/captcha {
    captcha;
    captcha_font /usr/share/fonts/ttf-liberation/LiberationSans-Regular.ttf;
}

确保字体文件路径正确,并且 NGINX 工作进程可以访问该路径。

使用过于花哨的字体可能会降低验证码的可读性,从而降低其有效性。

确保字体文件受支持(TTF 或 OTF),并已在服务器上正确安装。

← 返回所有指令