# 开启验证码仅限最新的 Current 版本

当你的站点受到 CC 攻击时开启验证码是不错的选择，因为验证码可以帮助你进行人机识别。

本模块目前支持三种验证码，分别是 hCaptcha (opens new window)、reCAPTCHAv2 (opens new window) 和 reCAPTCHAv3 (opens new window)。你应该选择一个并从其网站上申请到 Sitekey 和 Secret。

修改 nginx 的配置文件

为整个站点开启验证码。

server {
    waf_captcha on prov=hCaptcha secret=your_secret sitekey=your_sitekey;
}

为某个路径开启验证码

location {
    waf_captcha on prov=hCaptcha secret=your_secret sitekey=your_sitekey;
}

当访问频率过高时开启验证码

http {
    waf_zone name=waf size=20m;
    server {
        waf_cc_deny on rate=1000r/m duration=1h zone=waf:cc;
        waf_captcha off prov=hCaptcha secret=your_secret sitekey=your_sitekey;
        waf_action cc_deny=CAPTCHA zone=waf:action;
    }
}

重启 nginx。

警告

如果你配置了伪静态规则，或者配置了路径重写，你需要保证路径 /captcha 不被重写。下面是一个修改示例。

# BEGIN 修改前
if (! -e $request_filename) {
    rewrite ^(.*)$ index.php?s=$1 last break;
}
# END   修改前

# BEGIN 修改后
try_files $uri $uri/ index.php?s=$1;
# END   修改后

SEO 优化

开启验证码会影响到搜索引擎的工作，所有你可以使用 waf_verify_bot 来放行某些搜索引擎的爬虫。

waf_verify_bot on;

# 开启验证码 仅限最新的 Current 版本

# 开启验证码仅限最新的 Current 版本