Zibll子比主题腾讯智能验证接口配置教程：腾讯验证码人机验证

本文详细介绍如何在 Zibll 子比主题中配置腾讯智能验证（腾讯验证码）人机验证接口，涵盖从腾讯云注册账号、开通验证码功能、获取 CaptchaAppId/AppSecretKey 及 SecretId/SecretKey，到主题后台配置及功能验证的完整流程，帮助站长快速为网站接入专业的人机验证服务。

适用人群：使用 Zibll 子比主题并希望提升网站安全防护能力的 WordPress 站长

核心价值：通过腾讯云验证码（天御验证码 2.0）接口，为网站的登录、注册、评论、发帖、提交链接等场景增加人机验证防护，有效抵御机器程序恶意攻击。

配置前准备

在开始配置之前，需要先了解以下几点：

主题版本要求：Zibll 子比主题 V6.3 及以上版本。V8.1 版本已更新为腾讯天御验证码 2.0 版。
腾讯验证码说明：腾讯验证码是原腾讯防水墙的升级版，安全性和可靠性都很高。
费用说明：腾讯验证码为付费产品，但首次开通可免费试用 7 天。如需长期使用，需购买相应套餐。
备选方案：如果暂时不想付费，子比主题也支持极验行为验 4.0 作为替代方案。

注册腾讯云账号

注册账号

访问腾讯云官网：cloud.tencent.com
点击右上角“注册”，完成账号注册（可使用微信或 QQ 快速登录）
根据要求完成实名认证（个人或企业均可）

进入控制台

登录腾讯云后，点击右上角“控制台”，进入腾讯云管理后台。

开通验证码功能

进入验证码控制台

在腾讯云控制台顶部搜索栏输入 “验证码”，选择 “验证码” 服务。
或直接访问验证码控制台：https://console.cloud.tencent.com/captcha

开通服务

首次进入验证码控制台，会提示开通服务，点击 “开通”。
按照页面提示完成开通流程（首次开通可免费试用 7 天）。

创建验证码配置

在验证码控制台中，点击 “新建验证” 或 “创建验证”。
填写验证名称（如“网站登录验证”），选择验证类型（通常选择“智能验证”或“滑动验证”）。
根据页面提示完成配置创建。

Zibll子比主题腾讯智能验证接口配置教程

获取腾讯验证码参数

创建验证配置后，需要获取两组关键参数：

获取 CaptchaAppId 和 AppSecretKey

在验证码控制台的验证列表中，找到刚创建的验证配置。
点击进入详情页，即可看到 CaptchaAppId 和 AppSecretKey。
将这两个参数复制保存。

Zibll子比主题腾讯智能验证接口配置教程

获取 SecretId 和 SecretKey（API 密钥）

进入腾讯云控制台，点击右上角头像 → “访问管理” → “API密钥管理”。
点击 “新建密钥”，系统会生成 SecretId 和 SecretKey。
将这两个参数复制保存。

Zibll子比主题腾讯智能验证接口配置教程

重要提示：

⚠️ 重要提示：

SecretKey 仅在创建时显示一次，请务必及时保存，关闭后无法再次查看。
这四个参数都是你的核心机密，切勿泄露给他人，否则存在安全风险。

配置教程

完成 AppCode 获取后，进入 WordPress 后台配置子比主题。

进入主题设置：登录 WordPress 后台，进入 后台->主题设置->扩展&增强->网络安全->人机验证类型。
选择验证接口：在人机验证方式中，选择 「腾讯云智能验证」。

填入参数

将获取到的四个参数分别填入对应的输入框：

参数	说明
CaptchaAppId	验证码应用 ID
AppSecretKey	验证码应用密钥
SecretId	腾讯云 API 密钥 ID
SecretKey	腾讯云 API 密钥 Key

保存设置：点击页面底部的 「保存设置」 按钮，完成配置。

Zibll子比主题腾讯智能验证接口配置教程

配置人机验证功能选项

保存接口配置后，可以根据需要开启各场景的人机验证。

可开启验证的场景

场景	说明
登录验证	用户登录时进行人机验证
注册验证	用户注册时进行人机验证
评论验证	发表评论时进行人机验证
发帖验证	发布论坛帖子时进行人机验证
提交链接验证	提交链接时进行人机验证
短信/邮件验证	发送短信或邮件时进行人机验证

根据网站实际需求，勾选需要启用验证的场景即可。

⚠️ 重要提醒：设置排除账号

这是配置第三方人机验证时最关键的一步。

为什么要设置排除账号？

当启用第三方人机验证后，如果出现参数错误、接口异常或极验服务不可用等情况，可能导致所有用户都无法登录，包括管理员。

如何设置

在主题设置的“登录人机验证排除账号”中，至少设置一个管理员账号的用户名。这样即使验证接口出现异常，该管理员账号仍可正常登录后台进行修复。

建议：设置 2-3 个管理员账号作为备用，避免单一账号也无法登录的极端情况。

功能测试

配置完成后，务必进行实际测试以验证接口是否正常工作。

保存配置：确保已点击保存按钮。
打开前台页面：访问已开启验证的场景（如登录页面、评论区域）。
触发验证：执行对应操作（如点击登录、提交评论）。
验证结果：确认腾讯验证码弹窗是否正常显示，滑动/点击验证是否能通过。

Zibll子比主题腾讯智能验证接口配置教程

排障指引

如未显示物流信息，请依次检查：

CaptchaAppId、AppSecretKey、SecretId、SecretKey 是否复制完整、无多余空格
腾讯云账号是否已完成实名认证
验证码服务是否已开通且套餐有效（或仍在 7 天试用期内）
排除账号是否已正确设置（避免自己被锁在后台外）
主题版本是否满足 V6.3 及以上要求

常见问题

问题	解决方法
验证弹窗不显示	检查主题版本是否满足要求；确认接口配置已保存；清除网站缓存
参数无效或接口调用失败	检查四个参数是否复制完整；确认腾讯云账号已实名认证；确认验证码服务已开通
免费试用到期	前往腾讯云验证码控制台购买套餐包
管理员无法登录	通过排除账号登录后台；检查验证码接口状态；临时关闭第三方验证
接口调用超限	确认套餐余量；检查是否被恶意刷量
密钥泄露风险	立即登录腾讯云 API 密钥管理重新生成 SecretId 和 SecretKey