# sms_forwarding **Repository Path**: tf5488/sms_forwarding ## Basic Information - **Project Name**: sms_forwarding - **Description**: 基于 https://gitee.com/top-software/sms_forwarding 进行二次开发的短信转发固件仓库 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-02-05 - **Last Updated**: 2026-02-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 低成本短信转发器 > 当前分支为新方案，老方案请前往[luatos分支](https://github.com/chenxuuu/sms_forwarding/tree/old-luatos)。 本项目仅用于接收短信与进行保号相关功能。 多卡控制、通话、拨号、开放接口、自动化等功能永远不会支持，请勿提出相关需求。 [后台页面演示](https://sms.j2.cx/) 本项目旨在使用低成本的硬件设备，实现短信的自动转发功能，支持多种推送方式同时启用。 > 视频教程：[B站视频](https://www.bilibili.com/video/BV1cSmABYEiX) ## 功能 - 支持使用通用AT指令与模块进行通信 - 开启后支持通过WEB界面配置短信转发参数、查询当前状态 - **支持多达5个推送通道同时启用**，每个通道可独立配置 - 支持将收到的短信转发到指定的邮箱 - 支持通过WEB界面主动发送短信，以便消耗余额 - 支持通过WEB界面进行Ping测试，以极低的成本消耗余额 - 支持长短信自动合并（30秒超时） - 支持管理员短信远程发送短信和重启设备 - **无需编辑代码配置 WiFi**：首次上电或 WiFi 未配置/连接失败时，设备自动开启热点 `SMSForwarder`（密码 `12345678`），连接后访问 **http://192.168.4.1** 即可进入管理页并保存 WiFi，保存后设备将重启并连接该网络 - **管理员可通过短信配置 WiFi**：在配置页设置「管理员手机号」后，向设备 SIM 卡发送 `WIFI:SSID,密码`（SSID 与密码用英文逗号分隔），设备保存后重启并连接；WiFi 连接失败时下发的通知短信中会附带该格式说明 ## 推送通道支持 支持以下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×tamp=xxx`（自动URL编码） - **钉钉机器人**: 文本消息格式，支持加签验证 - **PushPlus**: 使用Token推送，支持HTML格式 - **Server酱**: 使用SendKey推送，支持Markdown格式 - **自定义模板**: 使用`{sender}`、`{message}`、`{timestamp}`占位符 - **飞书机器人**: 文本消息格式，支持加签验证 |状态信息|主动ping| |-|-| |![](assets/status.png)|![](assets/ping.png)| ## 硬件搭配 如果希望自行焊接硬件，参考下面的硬件搭配，总成本约¥27.8，仅支持移动/联通卡。 - ESP32C3开发板，当前选用[ESP32C3 Super Mini](https://item.taobao.com/item.htm?id=852057780489&skuId=5813710390565)，¥9.5包邮 - ML307R-DC开发板，当前选用[小蓝鲸ML307R-DC核心板](https://item.taobao.com/item.htm?id=797466121802&skuId=5722077108045)，¥16.3包邮 - [4G FPC天线](https://item.taobao.com/item.htm?id=797466121802&skuId=5722077108045)，¥2，与核心板同购 若希望直接使用成品，可选直接购以下套件，支持移动/联通/电信卡： - [小蓝鲸WIFI短信宝](https://item.taobao.com/item.htm?id=1003711355912) - [4G FPC天线](https://item.taobao.com/item.htm?id=1003711355912&skuId=6162872574943)，与开发板同购 ## 硬件连接 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天线) │ └─────────────────┘ ``` 改变接线方式，核心板不再和en短接而是和esp32c3的GPIO5连接，使模块能够被控制上下电(代码也同步改动)。 可通过USB连接ESP32C3进行编程和供电，正常工作时，ESP32C3的虚拟串口数据将直接被转发到ML307R-DC，方便调试。 ## 软件组成 - ESP32C3运行自己的`Arduino`固件，负责连接WiFi和接收ML307R-DC发送过来的短信数据，然后转发到指定HTTP接口或邮箱；WiFi 仅通过热点模式下的网页配置（NVS 存储），无需修改源码 - ML307R-DC运行默认的AT固件，不用动 需要在`Arduino IDE`中单独安装这些库： - **ReadyMail** by Mobizt - **pdulib** by David Henry 需要在`Arduino IDE`中安装ESP32开发板支持，参考[官方文档](https://docs.espressif.com/projects/arduino-esp32/en/latest/installing.html)，版型选`MakerGO ESP32 C3 SuperMini`。