短信服务

📅 2026-11-21 👁️ 0

短信服务

短信服务用于配置验证码短信厂商与限流策略,覆盖登录、注册、找回密码、换绑手机号等场景。

入口路径

后台顶部菜单 →「功能」→「触达渠道」→「短信服务」。实际地址:/system/plugin/channel/sms,需要管理员权限(canAdmin)。

功能说明

页面支持阿里云、腾讯云、Twilio 三家厂商,配置生效厂商、启用场景、验证码参数、限流阈值和反向代理信任网段,并提供发送测试与发送记录。

界面截图

短信服务配置(含各项实测默认值):

短信服务

短信服务展开配置

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
生效厂商 选择实际使用的短信服务商 radio:关闭(实测默认)/ 阿里云 / 腾讯云 / Twilio [实测] 按已开通的厂商选择 选「关闭」则不发送任何短信
启用场景 哪些业务发送验证码 多选:登录、注册、找回密码、换绑旧号、换绑新号 [源码] 只勾选实际需要的场景 留空表示全部关闭
验证码长度 验证码位数 数字,实测默认 6 [实测] 保持 6 位即可 过短安全性低
验证码有效期(秒) 验证码多久过期 数字,实测默认 300(5 分钟)[实测] 5–10 分钟较合理 过短用户体验差
重发间隔(秒) 两次发送的最小间隔 数字,实测默认 60 [实测] 60 秒防刷 过短会被滥用
**验证次数 验证码最多尝试次数 数字,实测默认 5 [实测] 5 次即可 用完需重发
单号码每日上限 同手机号每日发送上限 数字,实测默认 10 [实测] 按业务量调整 防止恶意刷单号码
单 IP 每小时上限 同 IP 每小时发送上限 数字,实测默认 10 [实测] — 依赖可信代理网段配置
单 IP 每日上限 同 IP 每日发送上限 数字,实测默认 30 [实测] — 同上
日志保留天数 发送记录保留时长 数字,实测默认 90 [实测] 按合规要求设置 —
可信代理网段 CDN/反向代理的回源网段 文本,一行一个 IP 或 CIDR [源码] 挂 CDN 时填回源网段;直连公网留空 填错会导致 IP 限额失效,或全站用户被算作同一 IP

配置项详解

生效厂商与凭证

出现条件:选择具体厂商后显示对应凭证字段 [源码]。

阿里云、腾讯云、Twilio 各自需要 AccessKey/Secret 等凭证,按厂商控制台获取。

推荐值:国内站选阿里云或腾讯云;海外站可用 Twilio。

填错后果:凭证错误会导致短信发送失败;密钥属敏感信息,不要写进公开文档或截图。

可信代理网段

出现条件:始终显示 [源码]。

仅在站点前面挂了 CDN 或反向代理时填写——填 CDN 的回源网段(IP 或 CIDR,如 203.0.113.0/24)[源码+i18n]。留空表示不信任任何代理,IP 限额按 TCP 对端计。

填错后果:填错会导致 IP 限额失效,或全站用户被算成同一个 IP,造成误限流。

操作步骤

  1. 进入「功能 → 触达渠道 → 短信服务」。
  2. 填写所选厂商的账号与密钥参数。
  3. 设置生效厂商和启用场景。
  4. 配置验证码与限流参数(默认值已预填,可按需调整)。
  5. 点击「保存配置」,再用「发送测试」验证,到「发送记录」核对。

适用场景与建议

  • 站点前面挂了 CDN 或反向代理时,必须填写可信代理网段,否则 IP 限流不准。
  • 只开启实际使用的场景,减少短信费用和被滥发风险。

注意事项

  • 厂商密钥属于敏感信息,不要写进公开文档或截图。
  • 可信代理网段填写错误会导致 IP 限额失效,或全站用户被算作同一个 IP。
  • 短信发送会产生费用,测试时注意账户余额。

相关文档