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

短信服务

Novaix 支持通过短信发送验证码,用于用户注册、登录和密码重置。短信服务采用插件化设计,支持多种短信渠道。

支持的渠道

渠道说明
阿里云短信阿里云 SMS 服务,国内常用
腾讯云短信腾讯云 SMS 服务
通用 HTTP适配任意支持 HTTP 接口的短信平台
短信宝低价短信平台,无需企业认证(官方插件)

每个渠道的配置项会以动态表单展示,填写并保存后即可使用。配置完成后,建议点击「测试」按钮发送一条测试短信,确认渠道配置正确。

阿里云短信

字段说明
AccessKey ID阿里云 RAM 用户的 AccessKey
AccessKey Secret对应的 Secret
短信签名已审核通过的签名内容
模板 CODE已审核通过的验证码模板 ID,如 SMS_123456789
接入地址API 接入地址,默认 dysmsapi.aliyuncs.com,通常无需修改

TIP

模板内容中需要包含 ${code} 变量,系统会自动替换为生成的验证码。例如模板内容:您的验证码是${code},5分钟内有效。

腾讯云短信

字段说明
SecretId腾讯云 API 密钥 ID
SecretKey对应的密钥
短信应用 ID短信应用 SDK AppID(SmsSdkAppId)
短信签名已审核通过的短信签名
模板 ID已审核通过的验证码模板 ID
模板参数顺序按模板占位符顺序填写参数名,逗号分隔,如 code,minutes(默认 code
国家码号码无 + 前缀时自动补全,默认 +86
地域API 请求地域,默认 ap-guangzhou

通用 HTTP

通用 HTTP 渠道可以对接任意支持 HTTP 接口的短信平台。系统通过参数名映射的方式构建请求,支持签名验证。

字段说明
请求地址短信网关 API 完整地址
请求方法POST 或 GET
POST 编码POST 请求的编码方式:form(表单)或 json,仅 POST 生效
手机号参数名传递手机号的参数名,默认 phone
短信内容参数名传递短信内容的参数名,默认 text
短信内容模板短信内容模板,{code} 会被替换为验证码,如 您的验证码是 {code},5分钟内有效
附加参数每行一个 key=value,会作为额外参数一起发送
请求头自定义请求头,每行一个 Key: Value
签名方式支持 MD5HMAC-SHA256 三种签名方式
签名参数名签名结果放入的参数名,默认 sign
签名密钥用于计算签名的密钥
时间戳参数名如需传递时间戳,填写参数名
成功标识响应内容包含该字符串时视为发送成功

TIP

通用 HTTP 渠道非常灵活,可以对接大多数国内外短信平台。系统会将手机号和短信内容按照配置的参数名发送到指定地址,您只需在短信平台文档中找到对应的参数名填入即可。

短信宝

短信宝是面向中小站长的低价短信平台,无需企业认证即可使用,作为官方内置插件提供。

字段说明
用户名短信宝平台用户名
ApiKey在短信宝后台获取,推荐使用 ApiKey 而非密码 MD5
短信签名短信内容中的签名,如填写 Novaix 则发送时自动添加【Novaix】前缀
短信模板短信内容模板,{code} 会被替换为实际验证码

TIP

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

配合手机号注册使用

配置好短信渠道后,用户即可通过手机号注册和登录。手机号注册入口由短信服务是否启用决定,无需额外开关。但用户注册本身仍受「系统设置」→「注册设置」中的「开放注册」开关控制,请确保已开启。详见用户管理