全部产品
Search
文档中心

阿里云验证码:非中国内地业务集成验证码最佳实践

更新时间:Jul 02, 2026

若您的业务场景涉及海外接入,本文以 Web 接入方式为例,介绍验证码海外接入的操作流程及核心注意事项。

前提条件

  • 开通阿里云验证码2.0服务

  • 已新建接入方式Web/H5验证场景

  • 已为阿里云账号创建AccessKey

    重要

    严禁使用主账号 AccessKey 进行接入,主账号 AccessKey 泄露将导致所有云资源面临安全风险。请使用 RAM 用户的 AccessKey 完成接入,以最小化权限泄露的影响范围。接入阿里云验证码前,需为 RAM 用户授予验证码服务权限策略 AliyunYundunAFSFullAccess。

步骤一:客户端接入

在控制台添加验证场景后,需要在使用验证功能的Web或H5页面中,集成验证码初始化代码,实现客户端接入。更多具体操作,请参见Web和H5客户端接入

重要

若接入方式为非中国内地接入,请注意以下配置事项:

  • language:默认为cn(简体中文),验证码提供了17种语言类型,可以根据业务需求,在客户端接入时设置自定义验证码的文案与多语言。更多详情,请参见自定义文案与多语言设置

  • region:请设置为sgp(新加坡),如果不设置则默认为cn(中国内地)。若希望在除新加坡以外的其他非中国地域实现加速接入,请设置为ga(全球加速)。

更多参数说明,请参见参数说明

步骤二:服务端接入

完成客户端接入后,还需要在服务端调用接口,发起验证请求。更多具体操作,请参见服务端接入

重要

若您的业务接入方式为非中国内地,请严格确保服务端 Endpoint 与客户端 Region 参数在“国内/海外”属性上保持一致,严禁混用,否则会导致验证请求返回错误。具体配置规则如下:

  1. 国内环境配置:当 Region 参数设置为 cn 时,必须使用国内调用地址,不可使用海外地址。

  2. 海外环境配置:当 Region 参数设置为 sgp(新加坡)或 ga(全球加速)时,必须使用以下任一海外调用地址,不可使用国内地址:

    • 新加坡节点captcha.ap-southeast-1.aliyuncs.com

    • 全球加速节点(就近接入,流量最终路由至新加坡):captcha-open-ga.aliyuncs.com

重要提示:在使用全球加速域名时,系统不支持透出客户端的真实源 IP,服务端获取到的 IP 将为全球加速节点的 IP。

步骤三:查看统计数据

接入后,可以通过概览页面,查询近期验证数据,实时了解验证码的防护数据。更多具体详情,请参见查看统计数据