FreeSmsGateway 是一个轻量级的开源短信网关解决方案，专为开发者设计，用于通过 Android 设备（如运行 Termux 的智能手机）或专用设备发送和接收短信。其核心原理是在本地部署 sms-gate.app 实例，利用 Android 设备的 SMS 功能作为通信桥梁，将短信收发能力集成到自动化流程中。该工具支持完整的短信生命周期管理，包括消息发送、状态追踪、历史记录查询以及基于 Webhook 的实时回调机制。由于所有操作均通过本地 API 完成，数据无需经过第三方云服务，既保障了隐私安全，又降低了使用成本，非常适合需要自建通信基础设施的场景。 FreeSmsGateway 采用 Python 脚本封装底层 HTTP API，提供简洁的命令行接口，便于与现有系统快速集成。用户只需配置环境变量即可启动服务，支持 HTTP Basic Auth 认证，确保访问安全。无论是简单的短信通知还是复杂的业务流程触发，均可通过调用标准化脚本实现。此外，项目结构清晰，包含健康检查、消息列表、Webhook 管理等实用模块，文档详尽，上手门槛较低。对于希望绕过商业短信平台限制、实现本地化通信控制的开发者而言，它是一个高效且可定制的选择。
核心功能特点
- 通过 Android 设备本地运行 sms-gate.app 实例，实现短信的发送与接收
- 支持完整的短信生命周期管理：发送、状态追踪（Pending→Sent→Delivered/Failed）、历史记录查询
- 内置 Webhook 机制，可实时接收新短信及送达确认通知，支持自定义回调端点
- 提供命令行脚本封装，涵盖发送短信、检查状态、列出消息、管理 Webhook 等常用操作
- 采用 HTTP API 架构，易于集成至自动化脚本或后端服务中，支持环境变量配置与基础认证
适用场景
FreeSmsGateway 特别适用于那些需要自主控制短信通信链路、避免依赖第三方服务商配额或延迟的场景。例如，在物联网（IoT）项目中，设备可通过本地网络向手机发送状态告警短信，而无需接入公有云平台；企业内部的运维监控系统也可利用该工具实现关键事件的双因子验证通知。由于其部署完全本地化，非常适合对数据主权有严格要求的环境，如政府内部系统、金融行业合规应用或私有云部署场景。 另一个典型应用场景是开发测试阶段的身份验证模拟。当应用尚未上线但需测试短信验证码流程时，开发者可在本地搭建 FreeSmsGateway，配合 ngrok 隧道暴露 Webhook 接口，快速验证前端与后端之间的消息流转逻辑。这不仅节省了真实号码资源，也避免了频繁调用付费短信服务的开销。此外，对于需要批量处理短信任务的小型团队或个人项目，该工具提供了灵活的消息队列管理和状态轮询机制，能够有效提升自动化效率。无论是构建私有通知系统、实现离线环境下的远程通信，还是进行安全敏感的通信协议测试，FreeSmsGateway 都能以低成本和高可控性满足多样化需求。