reCAPTCHA 项目技术文档
1. 安装指南
1.1 获取 API 密钥
首先,访问 reCAPTCHA 管理控制台 获取 reCAPTCHA API 密钥。根据你的需求选择 reCAPTCHA 类型(v2 Checkbox、v2 Invisible 或 v3),并生成相应的密钥。
1.2 配置环境变量
在开发环境中,你可以使用环境变量来存储 API 密钥。例如,使用 dotenv
gem 来管理环境变量:
export RECAPTCHA_SITE_KEY = '6Lc6BAAAAAAAAChqRbQZcn_yyyyyyyyyyyyyyyyy'
export RECAPTCHA_SECRET_KEY = '6Lc6BAAAAAAAAKN3DRm6VA_xxxxxxxxxxxxxxxxx'
如果你使用的是企业版 API 密钥,还需要设置以下环境变量:
export RECAPTCHA_ENTERPRISE = 'true'
export RECAPTCHA_ENTERPRISE_API_KEY = 'AIzvFyE3TU-g4K_Kozr9F1smEzZSGBVOfLKyupA'
export RECAPTCHA_ENTERPRISE_PROJECT_ID = 'my-project'
2. 项目安装方式
2.1 Rails 安装
在 Rails 项目中,首先在 Gemfile
中添加 recaptcha
gem:
gem "recaptcha"
然后运行 bundle install
安装 gem。
2.2 Sinatra / Rack / Ruby 安装
在 Sinatra 或 Rack 项目中,同样需要在 Gemfile
中添加 recaptcha
gem:
gem 'recaptcha'
然后设置环境变量,并在需要的地方包含 Recaptcha::Adapters::ViewMethods
和 Recaptcha::Adapters::ControllerMethods
。
3. 项目的使用说明
3.1 在视图中嵌入 reCAPTCHA
在需要保护的表单中,使用 recaptcha_tags
方法嵌入 reCAPTCHA:
<%= form_for @foo do |f| %>
# …
<%= recaptcha_tags %>
# …
<% end %>
3.2 在控制器中验证 reCAPTCHA
在表单提交的控制器中,使用 verify_recaptcha
方法验证 reCAPTCHA 响应:
# app/controllers/users_controller.rb
@user = User.new(params[:user].permit(:name))
if verify_recaptcha(model: @user) && @user.save
redirect_to @user
else
render 'new'
end
4. 项目 API 使用文档
4.1 reCAPTCHA V2 API 使用
recaptcha_tags
当你的 reCAPTCHA 类型为 "v2 Checkbox" 时,使用此方法。
可用选项:
:theme
:指定主题,可选值为dark
或light
(默认:light
)。:ajax
:渲染动态 AJAX reCAPTCHA(默认:false
)。:site_key
:覆盖配置中的站点 API 密钥。:error
:覆盖 reCAPTCHA API 返回的错误代码(默认:nil
)。:size
:指定大小(默认:nil
)。:nonce
:可选。为脚本设置 nonce 属性(默认:nil
)。:id
:指定 HTML id 属性(默认:nil
)。:callback
:可选。成功回调函数的名称。:expired_callback
:可选。过期回调函数的名称。:error_callback
:可选。错误回调函数的名称。:noscript
:包含<noscript>
内容(默认:true
)。
verify_recaptcha
此方法返回 true
或 false
,用于处理 reCAPTCHA 小部件的响应令牌。通常在控制器中调用。
可用选项:
:model
:设置错误的模型。:attribute
:模型属性接收错误(默认::base
)。:message
:自定义错误消息。:secret_key
:覆盖配置中的密钥 API 密钥。:enterprise_api_key
:覆盖企业 API 密钥。:enterprise_project_id
:覆盖企业项目 ID。:timeout
:等待 reCAPTCHA 服务器的秒数(默认:3
)。:response
:自定义响应参数(默认:params['g-recaptcha-response-data']
)。
4.2 reCAPTCHA V3 API 使用
recaptcha_v3
当你的 reCAPTCHA 类型为 "v3" 时,使用此方法。
verify_recaptcha
(用于 v3)
与 v2 类似,但用于验证 v3 的响应。
recaptcha_reply
获取 reCAPTCHA 响应的详细信息。
5. 国际化支持
reCAPTCHA 支持多语言,可以通过 :hl
选项指定语言代码。
6. 测试
在测试环境中,可以通过设置 RECAPTCHA_TESTING
环境变量为 true
来跳过 reCAPTCHA 验证。
7. 其他 API 密钥设置
除了环境变量,还可以通过其他方式配置或覆盖 API 密钥,具体参考项目的 Alternative API Key Setup 部分。
- QQwen3-Next-80B-A3B-InstructQwen3-Next-80B-A3B-Instruct 是一款支持超长上下文(最高 256K tokens)、具备高效推理与卓越性能的指令微调大模型00
- QQwen3-Next-80B-A3B-ThinkingQwen3-Next-80B-A3B-Thinking 在复杂推理和强化学习任务中超越 30B–32B 同类模型,并在多项基准测试中优于 Gemini-2.5-Flash-Thinking00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0266cinatra
c++20实现的跨平台、header only、跨平台的高性能http库。C++00AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02- HHunyuan-MT-7B腾讯混元翻译模型主要支持33种语言间的互译,包括中国五种少数民族语言。00
GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile06
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
热门内容推荐
最新内容推荐
项目优选









