Skip to content
Projects

chenxuuu/sms_forwarding has 1,574 GitHub stars and 284 forks. GitHot measured +2 stars in 24 hours and +10 in 7 days. Last checked 2026-11-09 03:23 UTC. Last push 2026-08-25.

How these counts are measured

超低成本硬件短信转发器,支持移动联通电信,ML307R+ESP32C3

Measured star growth

in 24h
+2
in 7 days
+10
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

低成本短信转发器

当前分支为新方案,2022年的老方案请前往luatos分支。
本项目仅用于接收短信与进行保号相关功能。
多卡控制、通话、拨号、开放接口、自动化等功能,永远不会考虑支持,请勿提出相关需求。

后台页面演示

本项目旨在使用低成本的硬件设备,实现短信的自动转发功能,支持多种推送方式同时启用。

视频教程:B站视频

功能

  • 支持使用通用AT指令与模块进行通信
  • 开启后支持通过WEB界面配置短信转发参数、查询当前状态
  • 支持多达5个推送通道同时启用,每个通道可独立配置
  • 支持将收到的短信转发到指定的邮箱
  • 支持通过WEB界面主动发送短信,以便消耗余额
  • 支持通过WEB界面进行Ping测试,以极低的成本消耗余额
  • 支持长短信自动合并(30秒超时)
  • 支持管理员短信远程发送短信和重启设备

推送通道支持

支持以下7种推送方式,可同时启用多个通道:

推送方式 说明 需要配置
POST JSON 通用HTTP POST URL
Bark iOS推送服务 Bark服务器URL
GET请求 URL参数方式 URL
钉钉机器人 企业群通知 Webhook URL,可选Secret加签
PushPlus 微信公众号推送 Token
Server酱 微信推送服务 SendKey
自定义模板 灵活的JSON模板 URL + 请求体模板
飞书机器人 自定义通知 Webhook URL

推送格式说明

  • POST JSON: {"sender":"发送者号码","message":"短信内容","timestamp":"时间戳"}
  • Bark: {"title":"发送者号码","body":"短信内容"}
  • GET请求: URL?sender=xxx&message=xxx&timestamp=xxx(自动URL编码)
  • 钉钉机器人: 文本消息格式,支持加签验证
  • PushPlus: 使用Token推送,支持HTML格式
  • Server酱: 使用SendKey推送,支持Markdown格式
  • 自定义模板: 使用{sender}、{message}、{timestamp}占位符
  • 飞书机器人: 文本消息格式,支持加签验证
状态信息 主动ping

硬件搭配

若没有焊接能力,希望直接使用成品,可选直接购以下套件(我看过了,和自己做的成本一样)
支持移动/联通/电信卡:

如果希望自行焊接硬件,参考下面的硬件搭配,总成本约¥27.8(会有浮动,可按实际自行组合搭配)
仅支持移动/联通卡:

硬件连接

ESP32C3 与 ML307R-DC 通过串口(UART)连接,接线如下:

┌───────────────────────────────────────────────┐
|                                               |
|   ESP32C3 Super Mini      ML307R-DC核心板     |
| ┌───────────────────┐    ┌─────────────────┐ |
└─┼─ GPIO5 (MODEM_EN) │    │                 │ |
  │       GPIO3 (TX) ─┼───►│ RX              │ |
  │                   │    │             EN ─┼─┘
  │       GPIO4 (RX) ◄┼────┤ TX              │ 
  │                   │    │                 │ 
  │              GND ─┼────┤ GND             │ 
  │                   │    │                 │ 
  │               5V ─┼────┤ VCC (5V)        |
  │                   │    │                 │
  └───────────────────┘    └─────────────────┘
                           │                 │
                           │  SIM卡槽        │
                           │  (插入Nano SIM) │
                           │                 │
                           │  天线接口       │
                           │  (连接4G天线)   │
                           └─────────────────┘

可通过USB连接ESP32C3进行编程和供电,正常工作时,可通过网页与模组进行AT通信,方便调试。

软件组成

  • ESP32C3运行自己的Arduino固件,负责连接WiFi和接收ML307R-DC发送过来的短信数据,然后转发到指定HTTP接口或邮箱
  • ML307R-DC运行默认的AT固件,不用动

需要在Arduino IDE中单独安装这些库:

  • ReadyMail by Mobizt
  • pdulib by David Henry

需要在Arduino IDE中安装ESP32开发板支持,参考官方文档,版型选MakerGO ESP32 C3 SuperMini。

Explore related projects