演示地址：

https://javayong.cn/smsadmin

1 简介

一个简单易用的短信网关服务，提供客户端SDK，支持阿里云、腾讯云、亿美短信发送，适用于中小型公司。

功能包含：应用管理、渠道管理、单发短信、延时短信。

客户端和服务端两种发送短信的模式，可以参考这篇文章： Java应用中如何发送短信

2 工作原理

核心流程如下：

前端调用应用服务接口发送短信；
应用服务收到短信请求后，调用SDK接口根据模板发送短信；
短信平台服务收到请求，根据路由算法选择配置的渠道（比如阿里云、腾讯云）发送短信；
短信成功发送到用户手机。

3 环境准备

短信平台服务是JAVA应用，所以必须安装JDK（1.8或更高版本），安装并配置环境变量JAVA_HOME，然后将包含在JAVA_HOME中的bin目录追加到PATH变量中。

短信平台服务依赖外部MySQL和Redis两个服务，所以在部署之前必须安装好前置数据库。

4 部署流程

选择最新的部署包：

4.1 创建数据库以及相关表

创建数据库tech_platform，执行doc/sql目录下的tech_platform.sql。

执行后效果如下：

4.2 修改部署包配置

从Release下载platform-sms-admin.tar.gz，解压缩后，进入conf目录。

编辑application.yml文件：

进入bin目录，启动服务：

bin/startup.sh

5 操作流程

5.1 登录页面

服务启动后，访问地址：http://localhost:8089。

用户名和密码存储在conf目录的application.yml，默认用户名密码分别是：admin/admin1984。

5.2 新建应用

应用信息包含应用名称、应用appKey，应用秘钥，备注。其中，应用key和密钥在使用客户端SDK时需要配置。

5.3 新建渠道

注意：由于腾讯云 SDK 请求中需要携带 APPID，因此 Beta 版中将 appId 存储在附件属性中。

5.4 创建模板

在"模板管理"模块，点击"新建模板"按钮。

创建模板时，签名名称必须与渠道申请的签名保持一致。

下图展示了作者在腾讯云申请的签名，创建的模板必须与腾讯云账号的签名保持一致。

创建模板后，需要绑定渠道。我们需要先在第三方渠道创建短信模板，然后提交绑定。

1、先在第三方渠道创建短信模板

如上图所示，作者创建了编号为 1955325 的短信模板。因为我们需要在绑定界面绑定该渠道的模板，理论上在短信平台创建的模板可以绑定多个渠道。

2、绑定渠道

绑定完成后，可以在模板管理页面查看模板列表。

5.5 发送短信

发送短信可以参考 DEMO 模块：

01 添加依赖

<dependency>
    <groupId>cn.javayong</groupId>
    <artifactId>platform-sms-client</artifactId>
    <version>0.6.1</version>
</dependency>

02 客户端配置

首先在 application.yml 中配置如下：

sms:
  smsServerUrl: http://localhost:8089
  appKey: qQjEiFzn80v8VM4h
  appSecret: 9c465ece754bd26a9be77f3d0e2606bd

然后编写配置类：

@Configuration
public class SmsConfiguration {

    @Value("${sms.smsServerUrl}")
    private String smsServerUrl;

    @Value("${sms.appKey}")
    private String appKey;

    @Value("${sms.appSecret}")
    private String appSecret;

    @Bean
    public SmsSenderClient createClient() {
        SmsConfig smsConfig = new SmsConfig();
        smsConfig.setAppKey(appKey);
        smsConfig.setSmsServerUrl(smsServerUrl);
        smsConfig.setAppSecret(appSecret);
        SmsSenderClient smsSenderClient = new SmsSenderClient(smsConfig);
        return smsSenderClient;
    }

}

03 单发短信

@Autowired
private SmsSenderClient smsSenderClient;

@GetMapping("/test")
public String test() {
    String mobile = "15011319235";
    String templateId = "523419101760679938";
    // 你好，你的信息是：${code}
    Map<String, String> param = new HashMap<String, String>();
    param.put("code", "1234");
    SmsSenderResult senderResult = smsSenderClient.sendSmsByTemplateId(mobile, templateId, param);
    System.out.println("senderResult:" + JSON.toJSONString(senderResult));
    return "hello , first short message !";
}

04 单发延时短信

@Autowired
private SmsSenderClient smsSenderClient;
@GetMapping("/test")
public String test() {
    String mobile = "15011319235";
    String templateId = "523419101760679938";
    // 你好，你的信息是：${code}
    Map<String, String> param = new HashMap<String, String>();
    param.put("code", "1234");
    // 1个半小时之后发送
    String attime = String.valueOf(System.currentTimeMillis() + 3600 * 1500L);
    SmsSenderResult senderResult = smsSenderClient.sendSmsByTemplateId(mobile, templateId, attime, param);
    System.out.println("senderResult:" + JSON.toJSONString*(senderResult));
    return "hello , first short message !";
}