valterseu/gammu-sms

Gammu SMSD Docker镜像文档

镜像概述和主要用途

Gammu SMSD是一个基于Gammu库的服务，用于批量发送和接收SMS消息。Gammu库提供了与不同厂商（包括诺基亚、索尼爱立信、摩托罗拉、三星、西门子、华为等）的手机以及3G/4G加密狗交互的抽象层，实现跨设备兼容的短信通信功能。

核心功能和特性

• 批量发送与接收SMS消息
• 支持多品牌手机及3G/4G加密狗
• 集成MySQL数据库存储短信数据
• 可配置设备重置机制（软重置/硬重置）
• 自定义短信检查频率（接收、连接状态、发送队列）
• 拒绝来电功能，避免通信干扰
• SIM卡安全检查与PIN码验证
• 失败短信自动重试机制（次数和间隔可调）

使用场景和适用范围

• 客户通知系统：向用户批量发送业务通知
• 短信自动化：集成到业务流程实现自动短信触发
• 嵌入式应用：在树莓派等小型设备上部署本地短信服务
• 3G/4G网络依赖场景：需通过移动网络发送短信的应用

使用方法和配置说明

前提准备

1. 将3G/4G加密狗连接到主机（笔记本、PC、服务器或树莓派）
2. 检查加密狗是否被系统识别：

   bash
   lsusb
   

3. 创建MySQL容器及数据库（推荐使用官方MySQL镜像）：

   bash
   docker run --name mysql-sms -e MYSQL_ROOT_PASSWORD=your_password -e MYSQL_DATABASE=smsdb -d mysql
   

部署Docker容器

使用以下命令启动Gammu SMSD容器：

bash
docker run --name sms-sender --restart always -i --device=/dev/ttyUSB1 --publish-all -p 802:80 -d valterseu/gammu-sms

注意：/dev/ttyUSB1路径需根据实际系统和USB端口连接情况调整

配置文件设置

容器运行后，需修改配置文件/etc/gammu-smsdrc，关键配置如下：

ini
# 设备连接配置
port = /dev/ttyUSB1          # 设备端口（根据实际情况调整）
connection = AT              # 连接类型
speed = 9600                 # 通信速率

# 设备重置配置
ResetFrequency = 11          # 软重置频率（分钟，防止设备 stuck）
HardResetFrequency = 20      # 硬重置频率（分钟，针对3G加密狗）

# 检查频率配置
ReceiveFrequency = 10        # 接收短信检查间隔（分钟）
StatusFrequency = 30         # GSM连接状态检查间隔（建议30分钟）
CommTimeout = 5              # 发送队列检查间隔（建议15分钟）

# 发送超时配置
SendTimeout = 3              # 等待运营商响应时间（秒）
MultipartTimeout = 6         # 长短信发送等待时间（建议6秒）

# 功能配置
HangupCalls = 1              # 拒绝来电（1=启用）
CheckSecurity = 1            # 检查SIM卡PIN码（1=启用）
MaxRetries = 1               # 发送失败重试次数
RetryTimeout = 5             # 重试间隔（秒）
LoopSleep = 0                # 无活动时是否待机（0=禁用）

# SMSD数据库配置
[smsd]
service = sql                # 服务类型
driver = native_mysql        # 数据库驱动
host = MySQL_HOST            # MySQL主机地址
user = MySQL_USER            # MySQL用户名
password = MySQL_USER_PASSWORD  # MySQL密码
database = MySQL_DB_NAME     # 数据库名称

OutboxFormat = unicode       # 发件箱格式
TransmitFormat = unicode     # 传输格式
PIN = 0000                   # SIM卡PIN码（如有）
logfile = /var/log/sms_log   # 日志文件路径
debuglevel = 255             # 调试级别（255=详细）

发送SMS方法

1. Web请求方式

通过HTTP GET请求发送短信：

http://<容器IP或127.0.0.1:802>/index.php?rec=37122222222&text=Text%20Message

• rec：接收方电话号码
• text：URL编码的短信内容

2. 容器终端方式

进入容器执行命令：

bash
gammu-smsd-inject --config=/etc/gammu-smsdrc TEXT 371222222 -unicode -textutf8 "短信内容"

额外资源

• 详细教程：Valters.eu博客
• 源代码：https://github.com/valterseu/docker-gammu-sms
• 视频指南：***教程
• 更多资源：***@valters_eu