短信服务
短信服务
短信服务用于配置验证码短信厂商与限流策略,覆盖登录、注册、找回密码、换绑手机号等场景。
入口路径
后台顶部菜单 →「功能」→「触达渠道」→「短信服务」。实际地址:/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,造成误限流。
操作步骤
- 进入「功能 → 触达渠道 → 短信服务」。
- 填写所选厂商的账号与密钥参数。
- 设置生效厂商和启用场景。
- 配置验证码与限流参数(默认值已预填,可按需调整)。
- 点击「保存配置」,再用「发送测试」验证,到「发送记录」核对。
适用场景与建议
- 站点前面挂了 CDN 或反向代理时,必须填写可信代理网段,否则 IP 限流不准。
- 只开启实际使用的场景,减少短信费用和被滥发风险。
注意事项
- 厂商密钥属于敏感信息,不要写进公开文档或截图。
- 可信代理网段填写错误会导致 IP 限额失效,或全站用户被算作同一个 IP。
- 短信发送会产生费用,测试时注意账户余额。