阿里云PNVS号码认证融合套件使用手册
PNVS 套件使用手册
适用于最新版 EMLOG Pro(2.6.37 及以上)
一套插件解决三件事:短信验证码登录、图形滑块验证、手机号一键登录。
一、这套插件是做什么的
PNVS 套件把阿里云「号码认证服务」的三项能力接进 EMLOG,用户不需要记密码,手机号就能直接登录:
| 模块 | 作用 | 前台表现 |
|---|---|---|
| 短信验证码 | 输入手机号,收到阿里云下发的验证码,验证后登录;未注册的号码自动建号 | 登录弹窗里多一个「手机号 + 验证码」入口 |
| 图形验证 | 用阿里云滑块验证替换系统自带的图形验证码 | 原来显示验证码图片的地方,变成「点击这里开始验证」 |
| 一键登录 | 移动端浏览器直接读取本机流量号码,一点即登录 | 手机端底部/挂载点出现「本机号码一键登录」按钮 |
三项能力物理合并在一个插件里,逻辑上彼此独立:各自有独立的开关、独立的凭证、独立的限流设置,关掉其中一个完全不影响另外两个。
二、优点与特性
1. 验证码云端生成、云端校验
短信验证码由阿里云生成并校验,本地数据库不保存任何验证码。即使站点被拖库,也拿不到用户的验证码;也没有「验证码表被刷爆」的运维负担。
2. 不修改系统核心文件
- 图形验证是接管系统验证码位:页面上出现
checkcode.php的地方,服务端渲染阶段就换成了插件的验证组件,登录、注册、找回密码、评论全部生效,主题不用改。 - 短信、一键登录走挂载点输出,位置由你在模板里决定。
- 关掉或卸载插件,系统立刻回到原生状态,不会留下"半残"的页面。
3. 一个挂载点管两个入口
统一挂载点 pnvs_suite_login_box 会把短信登录与一键登录按钮聚合成一行(flex 居中),手机上自动换行不挤压布局,PC 端表现不变。
4. 手机号一键登录只对手机端生效
PC 端没有"数据流量"这回事,插件在服务端就判断设备,PC 端不输出任何按钮、不加载 SDK、不消耗额度。
5. 三层防刷,专治"验证码被别人刷成话费"
- 发送冷却:同一号码 N 秒内只能发一次
- 单号码每日上限
- 单 IP 每日上限 + 触顶封禁 N 天(最大 30 天)
三者都在插件里控制,不需要去阿里云后台封号——阿里云那边一旦禁用,正常用户也会被一起挡住。
6. 票据一次性,防重放
图形验证通过后签发一次性票据,提交时消费掉。每次提交都要一次新的有效验证,票据被拿去重放没有意义。密码输错、页面刷新、切换窗口,状态都会回到"未验证",不会出现"一直显示验证通过却登不进去"。
7. 未注册号码的处理可控
短信模块可设置:手机号不存在时「自动注册」或「仅提示未注册」。一键登录同理,点击前会弹确认框说明"已注册将直接登录,未注册将自动创建账户"。
8. 个人中心支持绑定 / 解绑
已登录用户可以在个人中心绑定手机号(填号码 → 收验证码 → 写入),也可以解绑(读取当前号码 → 收验证码 → 删除)。入口是独立挂载点,与登录入口分开。
9. 配置与旧插件隔离
三个模块的配置分别存在 pnvs_suite_sms / pnvs_suite_captcha / pnvs_suite_oneclick 三个命名空间,卸载任何旧版独立插件都不会连带删除套件的配置。
三、安装
- 后台「应用商店」搜索本套件 → 在线安装 → 启用。本插件只通过站长应用商店分发,不提供独立安装包,也不支持手动上传 zip 解压安装。
- 启用后左侧菜单出现「PNVS 套件」,点进去是四个选项卡:
- 短信验证码
- 图形验证
- 一键登录
- 挂载代码与说明
- 顶部「模块开关」决定哪几个模块生效,默认三个全开。关掉的模块等同于没装:不加载、不输出、不消耗额度。
环境要求
| 项 | 要求 |
|---|---|
| EMLOG | 最新版 Pro(2.6.37 及以上),不支持旧版本 |
| 扩展 | curl、json(一般默认都有) |
| 服务器出网 | 需要能访问 dypnsapi.aliyuncs.com、captcha.aliyun.com 等阿里云域名 |
四、去阿里云拿参数
三个模块用的是同一个阿里云账号下的三项不同产品,凭证不通用,请分别获取。
控制台入口:https://dypns.console.aliyun.com/ (号码认证服务)
4.1 短信验证码:AccessKey + 签名 + 模板
① 开通服务
控制台 → 「短信验证码」→ 开通。个人实名账号即可开通,无需企业资质(这是本方案相对普通短信服务的最大优势)。
② 创建 AccessKey
右上角头像 → AccessKey 管理 → 创建 AccessKey(建议用子账号/RAM 用户创建,权限更小)。
拿到两个值:
AccessKey ID(形如LTAI5t...)AccessKey Secret(只在创建时显示一次,务必保存)
③ 拿签名和模板
控制台 → 「短信验证码」→「签名管理」/「模板管理」。
开通时会赠送一个默认签名和默认模板,把签名名称和模板编号(形如 SMS_123456789)抄下来,填进插件:
| 插件字段 | 填什么 |
|---|---|
| PNVS赠送签名名称 | 控制台里的签名名称,例如「某某科技」 |
| PNVS赠送模板编号 | 模板 CODE,例如 SMS_460000000 |
④ 给 RAM 子账号授权(重要)
如果用的是子账号 AccessKey,必须先在 RAM 控制台给它授权,否则调用接口会报 Forbidden.NoPermission / You are not authorized to do this operation。
最简单的做法:RAM 控制台 → 身份管理 → 用户 → 找到该子账号 → 权限管理 → 新增授权 → 策略搜索 AliyunDypnsFullAccess(管理号码认证服务的权限)→ 确认。绑定这一条系统策略后,短信发送、核验以及一键登录所需的接口权限即全部具备,无需再逐条配置 Action。
只读场景可选
AliyunDypnsReadOnlyAccess,但本套件需要下发短信、核验、取号,必须用 FullAccess。若坚持自建自定义策略做最小授权,号码认证服务的 RAM 前缀为
dypns(旧前缀dypnsapi已废止),短信模块涉及以下 Action:dypns:SendSmsVerifyCode dypns:CheckSmsVerifyCode
⑤ 在插件里测试
填完先点「保存配置」,再用「测试发送」发一条到自己的手机。收到即通。
签名和模板必须审核通过且与账号归属一致,否则接口返回签名/模板不合法。
4.2 图形验证:AppId + AppKey
① 开通
控制台 → 「图形验证」(也叫「验证码」/ 人机验证)→ 开通,创建应用。
② 拿 AppId / AppKey
应用详情页里直接能看到:
AppId(应用 ID)AppKey(应用密钥)
这两个值与短信的 AccessKey 完全不是一回事,不能混用。
③ 前端运行库(已内置)
图形验证的 ct4.js 已随插件一起集成,无需单独下载或上传;库版本由插件在后续更新中一并升级。设置页「SDK 地址」留空即用内置库,只有在你需要替换为自己的 CDN 或静态目录版本时,才填外部可访问地址。
填好后点设置页的「检查 SDK」按钮,会直接告诉你当前地址能不能访问、返回什么 HTTP 状态。
④ 填进插件
图形验证选项卡里填 AppId、AppKey,保存。
⑤ 前提:系统开关要开着
图形模块是接管系统验证码位,所以后台「设置 → 用户注册/登录」里的图形验证码开关必须是开启状态。系统关着,页面上根本没有验证码位可接管,插件也就无从生效——设置页会给出提示。
4.3 一键登录:AccessKey + SceneCode + 页面地址 + 源地址
① 开通
控制台 → 「一键登录」或「本机号码校验」→ 开通。
② 创建号码认证方案
控制台 → 「号码认证方案管理」→ 新增方案:
| 项 | 说明 |
|---|---|
| 方案名称 | 自己起,例如「我的站点」 |
| 终端类型 | 选 H5(网页端) |
| 页面地址 | https://你的域名/ —— 注意末尾那个斜杠,示例写的是 https://www.aliyun.com/ |
| 源地址 | https://你的域名 —— 不带末尾斜杠,示例是 https://www.aliyun.com |
保存后拿到 方案 Code(SceneCode),形如 XXXXXX。
页面地址与源地址写错,是最常见的失败原因:表现为取号阶段直接被拒(
获取 token 失败、预授权失败)。两者必须与你实际访问的域名逐字符一致,www与裸域也算不同站点。
③ 拿 AccessKey
一键登录与短信登录同属号码认证服务,需要各自配置一组 AccessKey(可以复用短信那组,也可以单独建一组)。
安全建议:短信和一键登录分两组 AccessKey,一组泄露不至于全线失守。插件里也做了提示。
若一键登录单独使用 RAM 子账号,授权方式与 4.1④ 相同:绑定系统策略 AliyunDypnsFullAccess 即可。自建自定义策略时,取号流程涉及以下 Action:
dypns:GetAuthToken
dypns:GetPhoneWithToken
④ 前端运行库(已内置)
H5 端的 numberAuth-web-sdk.js 已随插件一起集成,无需单独下载或上传;库版本由插件在后续更新中一并升级。「SDK 地址」留空即用内置库,需要替换为外部 CDN 或静态目录版本时再填外部地址。
⑤ 填进插件
一键登录选项卡里填 AccessKeyId、AccessKeySecret、SceneCode、页面地址、源地址,保存。
⑥ 计费提醒
一键登录按次计费(取号成功才计费)。插件的「点击后先确认」选项会让用户先看到"未注册将自动创建账户"的提示,用户确认后才真正发起取号,避免误触消耗额度。
五、挂载点
进「挂载代码与说明」选项卡,代码框里的内容可以直接复制进模板。
| 挂载点 | 输出内容 | 是否必需 |
|---|---|---|
pnvs_suite_login_box |
统一入口:短信登录 + 一键登录按钮聚合居中 | 推荐 |
pnvs_sms_login_box |
只有短信登录按钮 | 可选 |
pnvs_oneclick_box |
只有一键登录按钮(PC 端自动不输出) | 可选 |
pnvs_sms_bind_box |
个人中心的「绑定 / 解绑手机号」按钮 | 必需,且不能由统一挂载点代替 |
写法:
<?php doAction('pnvs_suite_login_box'); ?>
注意事项
- 统一挂载点 ≠ 绑定入口。统一挂载点只负责"登录按钮",个人中心资料页的绑定/解绑必须单独挂
pnvs_sms_bind_box。 - 统一挂载点与分挂载点不要放在同一位置,否则会出现两套按钮。
- 关掉某个模块后,它对应的挂载点输出为空,不会留下空壳。
- 图形验证不需要挂载点,它自动接管全站验证码位。
六、各模块配置项说明
短信验证码
| 字段 | 说明 |
|---|---|
| AccessKey ID / Secret | 阿里云凭证(建议用只授权 dypnsapi 两个接口的 RAM 子账号) |
| PNVS赠送签名名称 | 控制台签名管理里的名称 |
| PNVS赠送模板编号 | 控制台模板管理里的 CODE |
| 验证码长度 | 默认 6 位 |
| 有效期 | 验证码几分钟内有效,默认 5 |
| 发送冷却 | 同一号码两次发送的最小间隔,默认 60 秒 |
| 单号码每日上限 | 超过当日拒绝,默认 10 条 |
| 单 IP 每日上限 | 防止换号批量刷,默认 20 条 |
| IP 超限封禁天数 | 触顶后封该 IP N 天,0 = 只当日限制;最大 30 |
| 手机号不存在时 | 「自动注册」或「仅提示未注册」 |
| 测试发送 | 填手机号 → 点测试,会真实下发一条短信 |
图形验证
| 字段 | 说明 |
|---|---|
| AppId / AppKey | 图形验证应用凭证,与短信 AccessKey 不同 |
| SDK 地址 | 留空用插件内置的 ct4.js;仅替换为外部 CDN/静态目录版本时填写;点「检查 SDK」可验证可达性 |
| 语言 | 验证组件界面语言 |
| 文案 | 「点击这里开始验证」/「验证通过」的自定义文字 |
| 票据有效期 | 验证通过后票据可用的分钟数,默认 5 |
一键登录
| 字段 | 说明 |
|---|---|
| AccessKeyId / Secret | 号码认证凭证 |
| 方案 Code(SceneCode) | 控制台号码认证方案里拿到的 Code |
| 页面地址 | https://域名/(带末尾斜杠) |
| 源地址 | https://域名(不带斜杠) |
| SDK 地址 | 留空用插件内置的 numberAuth-web-sdk.js;仅替换为外部 CDN/静态目录版本时填写 |
| 按钮文字 | 例如「本机号码一键登录」 |
| 登录成功跳转 | 留空则刷新当前页 |
| 点击后先确认 | 开启后先弹"将自动登录/自动注册"的确认框,用户同意才取号 |
| 确认框文案 | 上面的提示文字,可自定义 |
| WiFi 环境提示 | 检测到 WiFi 时提示用户切到移动数据,避免取号失败 |
| 手机端进站自动提示 | 同一浏览器进程内只提示一次,关掉浏览器再进会重新提示 |
七、常见问题
图形验证一直提示"验证未通过"
AppId/AppKey是否填对(注意区分大小写、别和短信 AccessKey 搞混);- 控制台里该应用是否已开通、是否被禁用;
ct4.js是否可访问:访问
https://你的站点/content/plugins/pnvs_suite/modules/captcha/ct4.js
返回 200 才算正常;404 说明内置库缺失,请到应用商店把插件升级到最新版;- 后台系统「图形验证码」开关是否开启。
保存后配置又变空了
历史原因:早期把三个模块和独立插件共用同一个存储键,卸载独立插件时核心会把同一命名空间的数据一起清掉。现在三个模块各自独立命名空间,卸载旧插件不会再带走套件配置。
若升级后仍丢失,请确认是通过应用商店完成的本次升级(不要手动改动插件目录文件),并在插件页停用再启用一次。
一键登录报「获取 token 失败」「预授权失败」
这是运营商取号阶段就被拒,不是插件逻辑问题。按顺序排查:
- 测试时 WiFi 是否关着(必须走移动数据;部分浏览器的"免流/代理"也会导致失败);
- 手机卡是移动 / 联通 / 电信,与报错明细对应(如
CM WAP 网关 IP 错误是移动侧未识别); - 控制台方案的页面地址、源地址与当前域名是否逐字符一致(含
www、末尾斜杠); - 方案类型是不是「一键登录」(不是「本机号码校验」)。
插件里对这类错误只给用户友好提示,不会把错误码暴露到前台。
验证码发了但提示不对
- 检查「有效期」是否太短;
- 确认服务器时间准确(时区/时间漂移会导致校验失败);
- 若开启了图形模块,先完成图形验证再点发送。
评论 / 找回密码的验证码还是系统自带的
图形模块是服务端接管,页面里只要存在 checkcode.php 就会被替换。若仍是系统图片,说明模块没生效(多半是 AppId 缺失或系统开关关闭)。可以访问
https://你的站点/content/plugins/pnvs_suite/modules/captcha/diag.php(仅管理员),
看 should_inject、app_key_filled、ct4_in_suite 三项是否为 y。
手机端按钮和登录框不对齐
统一挂载点内部已做 flex 居中与换行处理,按钮保持自身宽度、整体居中。若仍不对齐,通常是模板把挂载点包在固定宽度的容器里,把这段移出容器即可。
前台出现 "登录组件加载失败"
内置的 numberAuth-web-sdk.js 未被正常加载。先确认插件已是应用商店最新版;若仍异常,可在一键登录设置页的「SDK 地址」填一个可访问的外部 CDN/静态目录地址作为覆盖。
八、升级与卸载
- 升级:本套件只在后台「应用商店」内在线更新,不提供安装包、不做手动目录覆盖。检测到新版本后按后台提示一键升级即可,配置存在数据库里,不会丢。升级完成后建议到插件页点一次「启用」以触发初始化回调。
- 卸载:核心会清掉模块开关,但三个模块的配置仍在各自命名空间。重新安装后配置还在(如不希望保留,卸载前可手动清空)。
- 关闭某模块:在顶部「模块开关」里取消勾选即可,等同于该模块未安装。
九、安全建议
- AccessKey 只给最小权限:短信与一键登录分别建 RAM 子账号,绑定系统策略
AliyunDypnsFullAccess;有条件自建自定义策略时,只放行dypns:SendSmsVerifyCode、dypns:CheckSmsVerifyCode、dypns:GetAuthToken、dypns:GetPhoneWithToken等必需接口。 - 短信与一键登录不要共用同一组 AK,降低单点泄露风险。
- 必开限流:单号码 + 单 IP 双重限制,是对付"刷验证码烧钱"最有效的一道墙。
- 票据一次性是刻意设计:宁可用户多验证一次,也不要留下可重放的票据。
- 不要把 AccessKey 写进模板、JS 或任何前端可见的位置——插件所有调用都在服务端完成。
发表评论