首页 (28) - 码厩

ISMG: Internet Short Message Gateway
SMPP: Short Message Peer to Peer
一个国际上比较通用的短信网关协议
CMPP 可能兼容 SMPP，因为 Wireshark 会将 CMPP 会话识别成 SMPP
CMPP: China Mobile Peer to Peer
中国移动开发的的短信网关协议
SMC: Short Message Center
GNS: Gateway Name Server
相当于 CMPP 网络的路由器
SP: Service Provider
SMC: Short Message Control
ISMG_Id: 网关代码
SP_Id: SP 企业代码
SP_Code: SP 服务代码
Service_Id: SP 业务类型
MO: 手机发送 Originate
MT: 手机接收 Terminated

网络连接

CMPP 基于 TCP 协议。可以长连接，也可以短连接。
长连接支持一次连接发送多次 CMPP 消息，没有消息的时候需要维持心跳。
短连接则是一次 CMPP 通信之后就断开连接。

关于心跳：
建议每 3 分钟一次心跳，如果 60 秒内没有心跳响应，应该再次心跳，总共 3 次没有响应就断开连接。
关于重试（网关与 SP 之间，网关之间）：
60 秒之后没有响应，立即重试，总共 3 次没有响应就停发。

消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数 W 可配置，现阶段建议为 16，即接收方在应答前一次收到的消息最多不超过 16 条。

关于短连接：
60 秒超时，重试 2 次。

端口

7890 长连接（SP 与网关之间）
7900 短连接（SP 与网关之间，网关之间）
7930 长连接（网关之间）
9168 短连接（网关与 GNS 之间）

数据类型

var Total_Length uint32 // 消息总长度
var Command_Id uint32   // 命令或响应类型
var Sequence_Id uint32  // 消息流水号, 递增, 步长为 1, 循环使用

命令	Command_Id
CMPP_CONNECT	`0x00000001`
CMPP_TERMINATE	`0x00000002`
CMPP_SUBMIT	`0x00000004`
CMPP_DELIVER	`0x00000005`
CMPP_QUERY	`0x00000006`
CMPP_CANCEL	`0x00000007`
CMPP_ACTIVE_TEST	`0x00000008`
CMPP_FWD	`0x00000009`
CMPP_MT_ROUTE	`0x00000010`
CMPP_MO_ROUTE	`0x00000011`
CMPP_GET_ROUTE	`0x00000012`
CMPP_MT_ROUTE_UPDATE	`0x00000013`
CMPP_MO_ROUTE_UPDATE	`0x00000014`
CMPP_PUSH_MT_ROUTE_UPDATE	`0x00000015`
CMPP_PUSH_MO_ROUTE_UPDATE	`0x00000016`

RESP Command_Id 则是对应的 Command_Id 最高 4 位为 8，即 0x8X。

SP 与 ISMG 之间的通信

对于一般开发来说就这 7 个接口。

建立连接 CMPP_CONNECT
断开连接 CMPP_TERMINATE
提交信息 CMPP_SUBMIT
获取状态 CMPP_DELIVER
撤回信息 CMPP_CANCEL
查询信息 CMPP_QUERY
只是一些统计信息，我想不到这个接口的应用场景
链路检测 CMPP_ACTIVE_TEST

连接 `CMPP_CONNECT`

var Source_Addr [6]byte // SP_Id
var AuthenticatorSource [16]byte // SP_Code
// md5(Source_Addr + 9 字节 0 + shared secret + timestamp)
// timestamp: MMDDHHMMSS, 月日时分秒, 补 0
var Version uint8 // 版本号, 高 4 位表示主版本号, 低 4 位表示次版本号, 最大 15.15
var Timestamp uint32 // 时间戳, 默认为 0

CMPP_CONNECT_RESP

var Status uint8 // 状态, 0 正确, 1 结构错误, 2 非法源地址, 3 认证错误, 4 版本错误, 5 其他错误
var AuthenticatorISMG [16]byte // ISMG 认证码
// md5(Status + AuthenticatorSource + shared secret)
// 如果认证错误, 此项为空
var Version uint8 // 服务器支持的最大版本号

断开连接 `CMPP_TERMINATE`

无请求消息体，无响应消息体

提交信息 `CMPP_SUBMIT`

var Msg_Id uint64       // 消息标识, 网关负责自主生成，SP 留空
var Pk_total uint8      // 消息总条数, 从 1 开始
var Pk_number uint8     // 消息序号, 从 1 开始
var Registered_Delivery uint8 // 是否要求返回状态确认报告, 0 不需要, 1 需要, 2 产生 SMC 话单 (该类型短信仅供网关计费使用，不发送给目的终端)
var Msg_level uint8     // 信息级别, 0 低, 1 中, 2 高
var Service_Id [10]byte // 业务类型
var Fee_UserType uint8  // 计费用户类型, 0 普通用户, 1 行业用户, 2 用户组
var Fee_terminal_Id [32]byte // 被计费用户的号码
var TP_pid uint8        // GSM协议类型, 0 GSM 03.40, 1 CDMA, 2 WCDMA, 3 CDMA2000, 4 联通移动TD专用协议
var TP_udhi uint8       // GSM协议类型
var Msg_Fmt uint8       // 信息格式, 0 ASCII 串, 3 短信写卡操作, 4 二进制, 8 UCS2 编码, 15 含 GB 汉字
var Msg_src [6]byte     // 消息发送者, SP_Id
var FeeType [2]byte     // 资费类别
var FeeCode [6]byte     // 资费代码, 以分为单位
var ValId_Time [17]byte // 存活有效期，格式遵循 SMPP3.3 协议
var At_Time [17]byte    // 定时发送时间, YYMMDDhhmmsstnnp, t 是 1/10 秒，nn 是与 UTS 时间的差值 00-48，p `+/-`
var Src_Id [21]byte     // 源号码
// SP 的服务代码或前缀为服务代码的长号码,
// 网关将该号码完整的填到 SMPP 协议 Submit_SM 消息相应的 source_addr 字段
// 该号码最终在用户手机上显示为短消息的主叫号码
var DestUsr_tl uint8    // 接收信息的用户数量, 小于 100
var Dest_terminal_Id [][21]byte // 接收短信的用户号码 (MSISDN), 21 * DestUsr_tl
var Msg_Length uint8    // 短消息长度
var Msg_Content []byte  // 短消息内容
var Reserve [8]byte     // 保留

注意：关于短信群发的问题，若 SP 对于群发消息不要求状态报告的回送时，才可以考虑群发，否则必须逐条发送。

关于 TP_udhi 的解释：

如果 = 1，则需要在 Msg_Content 中加入一个 udhi 头，定义如下：

六字节
05 00 03 开头，分别表示剩余 5 字节，xxx，剩余标识长度为 3
第四字节，唯一标识
第五字节，短信条数
第六字节，序号
七字节
06 08 04 开头，分别表示剩余 6 字节，xxx，剩余标识长度为 4
第四五字节，唯一标识
第六字节，短信条数
第七字节，序号

CMPP_SUBMIT_RESP

var Msg_Id uint64       // 消息表示, SP 自主生成
var Result uint8        // 结果, 0 正确, 1 消息结构错, 2 命令字错, 3 消息序号重复, 4 消息长度错,
                        //       5 资费代码错, 6 超过最大信息长, 7 业务代码错, 8 流量控制错, 9~ 其他错误

MMDDHHMMSS，26 位
月份 4 位, 1-12
日期 5 位, 1-31
小时 5 位, 0-23
分钟 6 位, 0-59
秒钟 6 位, 0-59
网关代码，22 位
序列号，16 位，递增, 步长为 1, 循环使用

查询 `CMPP_QUERY`

var Time [8]byte // YYYYMMDD
var Query_Type uint8 // 查询类型, 0 总数查询, 1 按业务类型查询
var Query_Code [10]byte // 查询码, 查询类型为 0 时无效, 查询类型为 1 时此处为业务类型
var Reserve [8]byte // 保留

CMPP_QUERY_RESP

var Time [8]byte
var Query_Type uint8
var Query_Code [10]byte
var MT_TLMsg uint32 // 接收消息总数
var MT_TLusr uint32 // 接收用户总数
var MT_Scs uint32   // 转发成功总数
var MT_WT uint32    // 待转发总数
var MT_FL uint32    // 转发失败总数
var MO_Scs uint32   // 发送成功总数
var MO_WT uint32    // 待发送总数
var MO_FL uint32    // 发送失败总数

送交短信 `CMPP_DELIVER`

从网关发送出来的消息

var Msg_Id uint64
var Dest_Id [21]byte            // 目的号码
var Service_Id [10]byte
var TP_pid uint8
var TP_udhi uint8
var Msg_Fmt uint8
var Src_terminal_Id [21]byte    // 源号码
var Registered_Delivery uint8
var Msg_Length uint8
var Msg_Content []byte          // Msg_Length
var Reserved [8]byte

var Msg_Id uint64
var Stat [7]byte
// DELIVRD 送达
// EXPIRED 过期
// DELETED 删除
// UNDELIV 未送达
// ACCEPTD 接收
// UNKNOWN 非法
// REJECTD 拒绝
var Submit_time [10]byte
var Done_time [10]byte
var Dest_terminal_Id [21]byte
var SMSC_sequence uint32

SP 等待状态报告 48 小时。

CMPP_DELIVER_RESP

var Msg_Id uint64
var Result uint8

删除短信 `CMPP_CANCEL`

var Msg_Id uint64

CMPP_CANCEL_RESP

var Success_Id uint8 // 0 成功, 1 失败

链路检测 `CMPP_ACTIVE_TEST`

无消息体。

CMPP_ACTIVE_TEST_RESP

var Reserved [8]byte

#776 转载：防火墙的原理

计算机网络网络安全 2022-03-25

每一个中国开发者都必须去了解这个我们无法避开的网络特性。

#775 进击的巨人

漫画动画日本文化 2022-03-17

#774 Git 提交信息

Git 2022-03-11

关于提交信息相关的规范中，被最多提及的应该是 Angular 的 Commit Message Format：

<type>(<scope>): <short summary>
  │       │             │
  │       │             └─⫸ Summary in present tense. Not capitalized. No period at the end.
  │       │
  │       └─⫸ Commit Scope: animations|bazel|benchpress|common|compiler|compiler-cli|core|
  │                          elements|forms|http|language-service|localize|platform-browser|
  │                          platform-browser-dynamic|platform-server|router|service-worker|
  │                          upgrade|zone.js|packaging|changelog|docs-infra|migrations|
  │                          devtools
  │
  └─⫸ Commit Type: build|ci|docs|feat|fix|perf|refactor|test

build 构建
ci 持续集成
docs 文档（documentation）
feat 新功能（feature）
fix BUG 修复
perf 性能优化
refactor 重构
test 测试代码

Vue 也有一个 Git Commit Message Convention

/^(revert: )?(feat|fix|polish|docs|style|refactor|perf|test|workflow|ci|chore|types)(\(.+\))?: .{1,50}/

比 Angular 增加了：

polish 优化
style 样式修改
workflow 工作流改进
chore 构建过程或辅助工具的变动
style：格式（不影响代码运行的变动）
refactor：重构（即不是新增功能，也不是修改 bug 的代码变动）
- improvement: 改进
- types: 类型定义文件修改
chore：构建过程或辅助工具的变动
- build: 打包
- ci: 持续集成
其他
1. revert: 撤销，版本回退
2. wip: 开发中

参考

Using Git Commit Message Templates to Write Better Commit Messages
https://gist.github.com/lisawolderiksen/a7b99d94c92c6671181611be1641c733
git commit 提交信息规范入门(配合 vscode)
https://blog.csdn.net/weixin_40780243/article/details/108900691
技巧 - 如何写好一个 Git 提交信息及几种不同的规范
https://zhuanlan.zhihu.com/p/27501055
Commit message 和 Change log 编写指南
https://ruanyifeng.com/blog/2016/01/commit_message_change_log.html

#773 关于 LVS 不支持后端节点做客户端的问题 [编辑中]

LVS 负载均衡 2022-03-10

我之前没有用过 LVS 做负载均衡，只是做过一点了解。今天听说 LVS 不支持后端节点做 Client，我很好奇，想分析一下具体原因。

#772 阿里云 SLB 连接超时问题

负载均衡网络编程 2022-03-10

现象：SYN 包会丢，可能有 1.5% 的连接丢了一次，0.1% 的可能性会丢失两次。
最后反馈是 SLB 实例规格太低, 升级 SLB 解决问题。

#771 CopyQ: 跨平台剪贴板

工具 2022-03-08

安装和使用

Ubuntu 上安装:

wget https://github.com/hluk/CopyQ/releases/download/v6.1.0/copyq_6.1.0_Debian_11-1_amd64.deb -P ~/Resources/
sudo gdebi ~/Resources/copyq_6.1.0_Debian_11-1_amd64.deb

点击打开之后，在右上角会有一个小图标。

Windows 版本下载地址：

https://github.com/hluk/CopyQ/releases/download/v6.1.0/copyq-6.1.0-setup.exe

PS: Windows 版本安装程序不支持中文，但是安装之后支持中文。

就是会监听剪切板，在第一个标签页中（默认只开一个标签，不会显示标签页切换栏）新建条目。

不只是剪贴板，可以用来存储各种需要复制粘贴的小片段。可以固定，加标记，支持搜索。
太可惜了，我的工作中不需要导出复制粘贴内容，对我的工作效率帮助不会很大。
但是用来跨平台同步剪贴板，还是非常不错的。

这个小工具真是不错，要是可以进一步提升颜值，改进体验，今后大有发展。

配置

Windows：C:\Users\用户名\AppData\Roaming\copyq
PS：Portable（压缩包，免安装）版本直接就是在 copyq 子目录。
Linux：~/.config/copyq

如何同步剪切板

首选项 > 条目 > 同步

指定标签页，和存储目录，然后就会自动将当前剪贴板的内容在存储目录创建一个文件(txt/html/png)，每次剪贴板内容更新就会再新建一个。
PS: 文件名包含当前 UTC 时间，精确到毫秒, 比如 copyq_20220308085614369.txt。

将存储目录选定为一个同步目录，比如我用的坚果云，直接同步到多台机器上。然后多台机器都配置相同的同步目录就行了。

PS：默认的那个标签名是 &Clipboard，用来同步剪切板。可以选中任意一个标签同步剪贴板。

其他

主题我用 wine，感觉看着还行。
solarized-dark 主体会导致一些复制的代码看不清。

一	二	三	四	五	六	日

#780 Gin + Vue3 (ElementPlus) 开发一个通用管理后台 [编辑中]

:) 本文正在编辑中，暂时不提供浏览...

#779 Go 语言有什么优势

存在的问题

场景

#778 解释解释什么叫 “包容性命名”

#777 CMPP 短信网关协议

术语