Django Simple Captcha 高级配置与自定义指南

原创于 2025-06-30 09:10:03 发布 · 979 阅读

6 ·

CC 4.0 BY-SA版权

Django Simple Captcha 高级配置与自定义指南

前言

Django Simple Captcha 是一个功能强大且易于集成的 Django 验证码应用。本文将深入探讨其高级配置选项和自定义方法，帮助开发者根据项目需求打造更安全、更个性化的验证码系统。

核心配置选项详解

字体与样式配置

CAPTCHA_FONT_PATH
支持指定 TrueType (TTF) 或 OpenType 字体文件路径，从 0.4.6 版本开始，可以传入字体路径列表，系统会随机选择字体渲染验证码。

CAPTCHA_FONT_SIZE
控制验证码文字大小，默认 22 像素。

CAPTCHA_LETTER_ROTATION
设置字符旋转角度范围（-35到35度），设为 None 可禁用旋转效果。

颜色配置

CAPTCHA_BACKGROUND_COLOR
验证码背景色，支持十六进制、RGB 或颜色名称格式。

CAPTCHA_FOREGROUND_COLOR
验证码前景色（文字颜色）。

CAPTCHA_LETTER_COLOR_FUNCT
高级功能：可通过自定义函数为每个字符设置不同颜色，函数接收字符索引和完整验证码字符串作为参数。

图像与噪声配置

CAPTCHA_IMAGE_SIZE
手动指定验证码图片尺寸（宽,高），不设置则自动计算。

CAPTCHA_NOISE_FUNCTIONS
噪声函数列表，用于增加验证码识别难度。默认包含弧线和点状噪声，调试时可使用 noise_null 空函数。

CAPTCHA_FILTER_FUNCTIONS
后处理过滤器，在渲染前对图像进行最终处理，默认使用平滑滤镜。

挑战类型配置

CAPTCHA_CHALLENGE_FUNCT
核心配置，决定验证码的生成逻辑。系统提供三种内置方案：

随机字符 (random_char_challenge)
生成指定长度的随机字母组合（不区分大小写）
简单数学题 (math_challenge)
生成基础算术题，可通过 CAPTCHA_MATH_CHALLENGE_OPERATOR 配置运算符显示样式
字典单词 (word_challenge)
从指定字典文件随机选取单词，需配合 CAPTCHA_WORDS_DICTIONARY 配置使用

音频验证码配置

CAPTCHA_FLITE_PATH
设置 flite 语音合成工具路径可启用音频验证码功能。

CAPTCHA_SOX_PATH
为防止音频验证码被彩虹表攻击，可配置 sox 工具路径添加随机噪声。

安全与性能配置

CAPTCHA_TIMEOUT
验证码有效期（分钟），默认5分钟。

CAPTCHA_TEST_MODE
测试模式下，输入 "PASSED" 即可通过验证，切勿在生产环境启用。

CAPTCHA_GET_FROM_POOL
启用验证码池模式，适合负载均衡环境，需配合定时任务定期生成验证码池。

自定义验证码生成器

开发者可以创建自己的挑战生成函数，只需满足返回格式 (挑战内容, 正确答案) 的元组即可。例如：

def custom_challenge():
    # 生成6位随机数字验证码
    code = ''.join(str(random.randint(0,9)) for _ in range(6))
    return code, code

然后在配置中指定：

CAPTCHA_CHALLENGE_FUNCT = 'your_app.utils.custom_challenge'

自定义渲染模板

从 Django 1.11 开始，支持通过继承 CaptchaTextInput 并重写 template_name 属性来自定义验证码字段的渲染方式。示例：

class BootstrapCaptchaInput(CaptchaTextInput):
    template_name = 'captcha/bootstrap_field.html'

对应的模板示例：

<div class="form-group">
  <label class="control-label">{{ label }}</label>
  <div class="input-group">
    <img src="{{ image }}" class="captcha-img" />
    {{ hidden_field }}
    {{ text_field }}
  </div>
</div>

注意：需在 INSTALLED_APPS 中添加 django.forms 并设置 FORM_RENDERER = 'django.forms.renderers.TemplatesSetting'。