Skip to content

验证码 ​

Artalk 内置图片验证码功能,你可以配置操作频率限制,当超过限度时激活验证码。

此外,你也可以接入各种验证服务提供商,获得多样化的验证功能。

目前 Artalk 支持:Turnstile、reCAPTCHA、hCaptcha、极验、Cap。

你可以在 控制中心 的设置界面修改此配置,也可以通过 配置文件 或 环境变量 进行配置。

配置文件 ​

完整的 captcha 配置如下:

yaml
# 验证码
captcha:
  enabled: true # 总开关
  always: false # 总是需要验证码
  captcha_type: image # 验证码类型
  action_limit: 3 # 激活验证码所需操作次数
  action_reset: 60 # 重置操作计数器超时 (单位:s, 设为 -1 不重置)
  # Turnstile
  # (https://www.cloudflare.com/products/turnstile/)
  turnstile:
    site_key: ''
    secret_key: ''
  # reCaptcha
  # (https://www.google.com/recaptcha/about/)
  recaptcha:
    site_key: ''
    secret_key: ''
  # hCaptcha (https://www.hcaptcha.com/)
  hcaptcha:
    site_key: ''
    secret_key: ''
  # Geetest 极验 (https://www.geetest.com)
  geetest:
    captcha_id: ''
    captcha_key: ''
  # Cap (https://capjs.js.org/)
  capjs:
    key_id: ''
    secret_key: ''
    api_endpoint: ''
  • always:当该项为 true 时,总是需要输入验证码。
  • captcha_type:验证码类型,可选:image、turnstile、recaptcha、hcaptcha、geetest、capjs。
  • action_limit:激活评论所需的操作次数。
  • action_reset:当时间超过该值时会重置操作计数器,单位为秒,设为 -1 将永不重置。

注:当 always 开启时,action_limit 和 action_reset 配置将失效。

配置举例 ​

例 1 ​

在 60s 时间范围内,当操作次数超过 3 次,将一直被要求输入验证码:

yaml
captcha:
  action_limit: 3
  action_reset: 60

在 60s 后将自动重置计数器,即重新获得 3 次不用输入验证码的机会。

例 2 ​

无论多少时间范围内,这个 IP 地址操作次数只要超过 5 次时,将一直被要求输入验证码:

yaml
captcha:
  action_limit: 5
  action_reset: -1

例 3 ​

总是要求输入验证码,无论这个 IP 操作多少次:

yaml
captcha:
  always: true

操作的定义 ​

一个 IP 地址的一次「评论、投票、图片上传、密码验证」都算作一次「操作」。

Turnstile ​

Turnstile 是 Cloudflare 推出的无感验证服务,可在 CF 后台申请获得 site_key 和 secret_key,之后在 Artalk 控制中心设置页填入 Key 并将 captcha_type 修改为 turnstile 即可。

图示:

对应配置文件如下:

yaml
captcha:
  # 省略其他配置...
  captcha_type: turnstile
  turnstile:
    site_key: ''
    secret_key: ''

reCAPTCHA ​

reCAPTCHA 是 Google 推出的验证服务,Artalk 支持接入 reCAPTCHA v3。可在谷歌开发者后台申请获得 site_key 和 secret_key,之后在 Artalk 控制中心设置页填入 Key 并将 captcha_type 修改为 recaptcha 即可。

对应配置文件如下:

yaml
captcha:
  # 省略其他配置...
  captcha_type: recaptcha
  recaptcha:
    site_key: ''
    secret_key: ''

注:国内访问 Google API 也许需要配置系统代理。

reCAPTCHA 官方提供了用于测试的 Keys:可见此处。

hCaptcha ​

hCaptcha 是一个验证服务,可在其官网申请获得 site_key 和 secret_key,之后在 Artalk 控制中心设置页填入 Key 并将 captcha_type 修改为 hcaptcha 即可。

对应配置文件如下:

yaml
captcha:
  # 省略其他配置...
  captcha_type: hcaptcha
  hcaptcha:
    site_key: ''
    secret_key: ''

hCaptcha 官方提供了用于测试的 Keys:可见此处。

Geetest 极验 ​

Artalk 支持接入 Geetest 极验 第四代行为验。

首先在 Geetest 官网注册账号申请获得 captcha_id 和 captcha_key,然后在 Artalk 控制中心修改配置,并将 captcha_type 修改为 geetest 即可。

对应配置文件如下:

yaml
captcha:
  # 省略其他配置...
  captcha_type: geetest
  geetest:
    captcha_id: ''
    captcha_key: ''

Cap ​

Cap 是可自部署的验证服务。Artalk 对接 Cap Standalone,在服务端验证一次性 token。

先部署 Cap Standalone 及 Redis 或 Valkey,设置 ENABLE_ASSETS_SERVER=true,启用组件及 WebAssembly 文件服务。在 Cap 控制台创建站点密钥,然后配置:

yaml
captcha:
  captcha_type: capjs
  capjs:
    key_id: 'YOUR_SITE_KEY_ID'
    secret_key: 'YOUR_SITE_SECRET'
    api_endpoint: 'https://cap.example.com'

api_endpoint 填写 Cap 服务地址,不包含站点密钥或 /siteverify 路径。浏览器和 Artalk 服务端都需要能访问它。Artalk 使用 HTTPS 时,Cap 也使用 HTTPS。密钥仅保存在服务端。如果在 Cap 限制来源,请允许承载验证框的 Artalk 服务端来源。

已测试 Cap Standalone 3.1.13、组件 0.1.58 和 WebAssembly 0.0.8。可在 Cap 设置 WIDGET_VERSION=0.1.58 和 WASM_VERSION=0.0.8 固定资源版本。Cap 在服务端下载资源,浏览器从你的 Cap 地址加载。

Cap 提高自动化请求的成本,但不能保证访问者是真人。请按需保留 Artalk 的限流和评论审核。

贡献者

页面历史