短信服务
Novaix 支持通过短信发送验证码,用于用户注册、登录和密码重置。短信服务采用插件化设计,支持多种短信渠道。
支持的渠道
| 渠道 | 说明 |
|---|---|
| 阿里云短信 | 阿里云 SMS 服务,国内常用 |
| 腾讯云短信 | 腾讯云 SMS 服务 |
| 通用 HTTP | 适配任意支持 HTTP 接口的短信平台 |
| 短信宝 | 低价短信平台,无需企业认证(官方插件) |
每个渠道的配置项会以动态表单展示,填写并保存后即可使用。配置完成后,建议点击「测试」按钮发送一条测试短信,确认渠道配置正确。
阿里云短信
| 字段 | 说明 |
|---|---|
| Access Key ID | 阿里云 RAM 用户的 Access Key |
| Access Key Secret | 对应的 Secret |
| 签名名称 | 已审核通过的短信签名 |
| 模板代码 | 已审核通过的验证码模板 ID |
TIP
模板内容中需要包含 ${code} 变量,系统会自动替换为生成的验证码。例如模板内容:您的验证码是${code},5分钟内有效。
腾讯云短信
| 字段 | 说明 |
|---|---|
| Secret ID | 腾讯云 API 密钥 ID |
| Secret Key | 对应的密钥 |
| SDK App ID | 短信应用 SDK AppID |
| 签名内容 | 已审核通过的短信签名 |
| 模板 ID | 已审核通过的验证码模板 ID |
通用 HTTP
通用 HTTP 渠道可以对接任意支持 HTTP 接口的短信平台。您需要配置请求的 URL、方法、请求头和请求体模板。
| 字段 | 说明 |
|---|---|
| 请求 URL | 短信平台的 API 地址,支持 {phone} 和 {code} 变量 |
| 请求方法 | GET 或 POST |
| Content-Type | 请求体格式,如 application/json |
| 请求头 | 自定义请求头(JSON 格式) |
| 请求体模板 | 请求体内容,支持 {phone} 和 {code} 变量 |
| 成功判断字段 | 响应 JSON 中表示成功的字段路径 |
| 成功判断值 | 该字段值等于多少时表示发送成功 |
TIP
通用 HTTP 渠道非常灵活,可以对接大多数国内外短信平台。例如对接某短信平台时,请求体模板可能是:
json
{"mobile": "{phone}", "content": "您的验证码是{code}"}短信宝
短信宝是面向中小站长的低价短信平台,无需企业认证即可使用,作为官方内置插件提供。
| 字段 | 说明 |
|---|---|
| 用户名 | 短信宝平台用户名 |
| ApiKey | 在短信宝后台获取,推荐使用 ApiKey 而非密码 MD5 |
| 短信签名 | 短信内容中的签名,如填写 Novaix 则发送时自动添加【Novaix】前缀 |
| 短信模板 | 短信内容模板,{code} 会被替换为实际验证码 |
TIP
短信宝是通过插件系统提供的渠道。安装后需要在「插件管理」中配置参数,然后到「短信服务」设置中将当前渠道切换为短信宝。
配合手机号注册使用
配置好短信渠道后,您还需要在「系统设置」→「注册设置」中开启手机号注册功能,用户才能通过手机号注册和登录。详见用户管理。
