Skip to content
Novaix 目前处于早期开发阶段,功能尚未稳定,可能存在严重的 Bug。请勿用于生产环境。

短信服务

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

短信宝是通过插件系统提供的渠道。安装后需要在「插件管理」中配置参数,然后到「短信服务」设置中将当前渠道切换为短信宝。

配合手机号注册使用

配置好短信渠道后,您还需要在「系统设置」→「注册设置」中开启手机号注册功能,用户才能通过手机号注册和登录。详见用户管理