Akismet/reCAPTCHA

📅 2026-11-21 👁️ 0

Akismet/reCAPTCHA

Akismet/reCAPTCHA 用于拦截垃圾留言和评论,并用人机验证阻止自动化攻击。

入口路径

后台顶部菜单 →「功能」→「触达渠道」→「Akismet/reCAPTCHA」。实际地址:/system/plugin/channel/akismet,需要管理员权限(canAdmin)。

功能说明

页面分为 Akismet 与 reCAPTCHA 两部分。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 同时启用。

填错后果:密钥错误或前台未渲染验证组件会导致用户无法提交留言/评论。

操作步骤

  1. 到 Akismet 与 Google reCAPTCHA 官网申请密钥。
  2. 进入「功能 → 触达渠道 → Akismet/reCAPTCHA」。
  3. 填写对应密钥,选择检测类型。
  4. 点击「提交」保存。
  5. 在前台提交测试留言,确认拦截生效。

适用场景与建议

  • 垃圾留言严重的站点可同时启用 Akismet 与 reCAPTCHA。
  • 只希望过滤评论时,把检测类型切到「评论」。

注意事项

  • 密钥属于敏感信息,不要写进公开文档或截图。
  • reCAPTCHA 依赖 Google 服务,网络不通时前台验证会失败。
  • 启用后前台模板必须正确渲染验证码组件,否则用户无法提交。

相关文档