Akismet/reCAPTCHA
Akismet/reCAPTCHA
Akismet/reCAPTCHA 用于拦截垃圾留言和评论,并用人机验证阻止自动化攻击。
入口路径
后台顶部菜单 →「功能」→「触达渠道」→「Akismet/reCAPTCHA」。实际地址:/system/plugin/channel/akismet,需要管理员权限(canAdmin)。
功能说明
页面分为 Akismet 与 reCAPTCHA 两部分。Akismet 按检测类型过滤留言或评论,reCAPTCHA 提供人机验证。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 开启Akismet | 是否启用垃圾检测 | 关闭 / 开启 | 按业务需要选择启用或停用 | 状态变更立即影响可用性 |
| Akismet API Key | 服务密钥 | 在 Akismet 官网获取 | 从对应平台获取,不要使用真实值做演示 | 敏感信息,泄露等同于权限泄露 |
| 检测类型 | 检测哪些内容 | 留言 / 评论;默认只检测留言 | 简明描述,避免空泛 | 是否展示由模板决定 |
| 开启reCAPTCHA | 是否启用人机验证 | 关闭 / 开启 | 按业务需要选择启用或停用 | 状态变更立即影响可用性 |
| reCAPTCHA Site Key | 网站密钥 | Google reCAPTCHA 获取 | 从对应平台获取,不要使用真实值做演示 | 敏感信息,泄露等同于权限泄露 |
| reCAPTCHA Private Key | 通信密钥 | 敏感信息 | 从对应平台获取,不要使用真实值做演示 | 敏感信息,泄露等同于权限泄露 |
配置项详解
Akismet 垃圾检测
出现条件:开启 Akismet 后生效;API Key 在 Akismet 官网获取 [源码]。
check_type 为多选:1=留言、2=评论,默认只检测留言 [源码]。
推荐值:留言和评论都容易被垃圾内容攻击时两项都勾选。
填错后果:API Key 无效时检测不生效;密钥属敏感信息,不要公开。
reCAPTCHA 人机验证
出现条件:开启 reCAPTCHA 后需填写 Site Key 与 Private Key(Google reCAPTCHA 获取)[源码]。
推荐值:垃圾留言严重时与 Akismet 同时启用。
填错后果:密钥错误或前台未渲染验证组件会导致用户无法提交留言/评论。
操作步骤
- 到 Akismet 与 Google reCAPTCHA 官网申请密钥。
- 进入「功能 → 触达渠道 → Akismet/reCAPTCHA」。
- 填写对应密钥,选择检测类型。
- 点击「提交」保存。
- 在前台提交测试留言,确认拦截生效。
适用场景与建议
- 垃圾留言严重的站点可同时启用 Akismet 与 reCAPTCHA。
- 只希望过滤评论时,把检测类型切到「评论」。
注意事项
- 密钥属于敏感信息,不要写进公开文档或截图。
- reCAPTCHA 依赖 Google 服务,网络不通时前台验证会失败。
- 启用后前台模板必须正确渲染验证码组件,否则用户无法提交。