LogoLaunchSaaS

验证码

使用 Cloudflare Turnstile、Google reCAPTCHA、hCaptcha 或 CaptchaFox 保护 LaunchSaaS 表单免受机器人攻击。轻松集成到登录页面。

LaunchSaaS 支持多个验证码提供商,为表单和身份验证页面提供机器人防护。

支持的提供商

提供商NEXT_PUBLIC_CAPTCHA_PROVIDER
Cloudflare Turnstilecloudflare-turnstile(默认)
Google reCAPTCHA v2 Checkboxgoogle-recaptcha-v2-checkbox
Google reCAPTCHA v2 Invisiblegoogle-recaptcha-v2-invisible
Google reCAPTCHA v3google-recaptcha-v3
hCaptchahcaptcha
CaptchaFoxcaptchafox

设置

Cloudflare Turnstile(推荐)

  1. 前往 Cloudflare Dashboard→Turnstile
  2. 添加网站
  3. 复制站点密钥和密钥
  4. 添加到你的 .env
NEXT_PUBLIC_CAPTCHA_PROVIDER=cloudflare-turnstile
NEXT_PUBLIC_CAPTCHA_PUBLIC_KEY="your-site-key"
CAPTCHA_SECRET_KEY="your-secret-key"

Google reCAPTCHA

  1. 前往 Google reCAPTCHA 控制台
  2. 注册新站点并选择 reCAPTCHA 类型(v2 或 v3)
  3. 复制站点密鑰和密钒
  4. 添加到你的 .env
# 根据你的 reCAPTCHA 类型选择对应的 NEXT_PUBLIC_CAPTCHA_PROVIDER:
# google-recaptcha-v2-checkbox、google-recaptcha-v2-invisible 或 google-recaptcha-v3
NEXT_PUBLIC_CAPTCHA_PROVIDER=google-recaptcha-v3
NEXT_PUBLIC_CAPTCHA_PUBLIC_KEY="your-site-key"
CAPTCHA_SECRET_KEY="your-secret-key"

hCaptcha

  1. hcaptcha.com 注册
  2. 添加网站
  3. 复制站点密钥和密钥
  4. 添加到你的 .env
NEXT_PUBLIC_CAPTCHA_PROVIDER=hcaptcha
NEXT_PUBLIC_CAPTCHA_PUBLIC_KEY="your-site-key"
CAPTCHA_SECRET_KEY="your-secret-key"

CaptchaFox

  1. captchafox.com 注册
  2. 创建项目
  3. 复制站点密钥和密钥
  4. 添加到你的 .env
NEXT_PUBLIC_CAPTCHA_PROVIDER=captchafox
NEXT_PUBLIC_CAPTCHA_PUBLIC_KEY="your-site-key"
CAPTCHA_SECRET_KEY="your-secret-key"

禁用验证码

验证码在未设置 CAPTCHA_SECRET_KEY 时会自动禁用。要禁用,将 CAPTCHA_SECRET_KEY(以及可选的 NEXT_PUBLIC_CAPTCHA_PUBLIC_KEY)从 .env 中删除或注释掉:

# CAPTCHA_SECRET_KEY=   # 注释或删除即可禁用

NEXT_PUBLIC_CAPTCHA_PROVIDER 控制提供商类型,但单独设置它并不会启用验证码。

参考资料

下一步