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 部分。
HunyuanImage-3.0
HunyuanImage-3.0 统一多模态理解与生成,基于自回归框架,实现文本生成图像,性能媲美或超越领先闭源模型00- DDeepSeek-V3.2-ExpDeepSeek-V3.2-Exp是DeepSeek推出的实验性模型,基于V3.1-Terminus架构,创新引入DeepSeek Sparse Attention稀疏注意力机制,在保持模型输出质量的同时,大幅提升长文本场景下的训练与推理效率。该模型在MMLU-Pro、GPQA-Diamond等多领域公开基准测试中表现与V3.1-Terminus相当,支持HuggingFace、SGLang、vLLM等多种本地运行方式,开源内核设计便于研究,采用MIT许可证。【此简介由AI生成】Python00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0369Hunyuan3D-Part
腾讯混元3D-Part00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++095AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02Spark-Chemistry-X1-13B
科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00GOT-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).Dockerfile09
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
项目优选









