20美元安卓机搭建SMS网关：零费用无限短信

来源：https://jonno.nz/posts/built-an-sms-gateway-with-a-20-dollar-android-phone/
作者：John Gregoriadis
整理时间：2026-04-15
标签：#SMS网关 #Android #Twilio替代 #开源 #Webhook #RESTAPI #物联网

一、项目概述

1.1 痛点问题

对于 MVP 来说，这是笔”智商税”。

1.2 解决方案

20美元安卓机 + 开源App = 无限免费短信

核心思路：
- 用一台廉价安卓机作为 SMS 网关
- 通过 REST API 控制收发短信
- 短信费用 = 手机套餐费（ prepaid 卡可为零）

二、技术架构

2.1 整体架构

┌─────────────┐     REST API      ┌─────────────┐
│  安卓手机    │ ◄───────────────► │  你的后端    │
│  SMS Gateway│    HTTP/Webhook    │  (Next.js)  │
│  App        │                   │             │
└─────────────┘                   └─────────────┘
     ▲                                 │
     │         短信收发                  │
     └─────────────────────────────────┘
              真实移动网络

2.2 应用：SMS Gateway for Android

三、两种运行模式

3.1 Local Server 模式（本地）

你的后端 ──HTTP──► 安卓手机:8080 ──► 发送短信

配置步骤：
1. 开启 Local Server
2. 设置端口（默认8080）、用户名（≥3字符）、密码（≥8字符）
3. 记录手机 IP 地址

发送示例：

curl -X POST http://192.168.1.50:8080/message \
  -u "admin:yourpassword" \
  -H "Content-Type: application/json" \
  -d '{
    "textMessage": { "text": "Hello!" },
    "phoneNumbers": ["+15551234567"]
  }'

3.2 Cloud Server 模式（云端）

中转架构：

你的后端 ──HTTPS──► api.sms-gate.app ◄──Firebase◄── 安卓手机

发送示例：

curl -X POST https://api.sms-gate.app/3rdparty/v1/messages \
  -u "YOUR_USERNAME:YOUR_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{
    "textMessage": { "text": "Hello from the cloud!" },
    "phoneNumbers": ["+15551234567"]
  }'

四、Webhook 事件系统

4.1 支持的事件

4.2 Webhook Payload 示例

{
  "id": "Ey6ECgOkVVFjz3CL48B8C",
  "webhookId": "LreFUt-Z3sSq0JufY9uWB",
  "event": "sms:received",
  "payload": {
    "message": "Hello!",
    "sender": "+15551234567",
    "recipient": "+15559876543",
    "receivedAt": "2026-04-01T12:41:59.000+00:00"
  }
}

4.3 安全机制

Webhook 使用 HMAC-SHA256 签名验证：

import crypto from 'crypto';

function verifyWebhook(
  signingKey: string,
  payload: string,
  timestamp: string,
  signature: string
): boolean {
  const expected = crypto
    .createHmac('sha256', signingKey)
    .update(payload + timestamp)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected, 'hex'),
    Buffer.from(signature, 'hex')
  );
}

4.4 重试机制

五、Next.js 集成代码

5.1 Provider 抽象接口

// src/lib/sms/provider.ts

export interface InboundSms {
  from: string;
  body: string;
  receivedAt?: Date;
}

export interface SmsProvider {
  send(to: string, body: string): Promise<string>;
  parseWebhook(req: Request): Promise<InboundSms | null>;
  webhookResponse(replyText?: string): Response;
}

export async function getSmsProvider(): Promise<SmsProvider> {
  const provider = process.env.SMS_PROVIDER || "sms-gate";

  switch (provider) {
    case "sms-gate": {
      const { SmsGateProvider } = await import("./sms-gate");
      return new SmsGateProvider();
    }
    case "console": {
      const { ConsoleProvider } = await import("./console");
      return new ConsoleProvider();
    }
    default:
      throw new Error(`Unknown SMS provider: ${provider}`);
  }
}

5.2 Webhook 处理示例

// src/app/api/sms/webhook/route.ts

export async function POST(req: NextRequest) {
  const provider = await getSmsProvider();
  const sms = await provider.parseWebhook(req);

  if (!sms) {
    return new Response("Bad request", { status: 400 });
  }

  const { from, body } = sms;
  console.log(`[SMS from ${from}]: ${body}`);

  // 回复短信
  await provider.send(from, "Got it — we're on it!");
  return provider.webhookResponse();
}

六、生产环境注意事项

6.1 手机配置

6.2 常见坑

七、成本对比

节省：80%+

八、适用场景

九、一句话总结

20美元安卓机 + SMS Gateway App = 零成本的无限短信网关，Webhook 实时接收 + REST API 发送，比 Twilio 节省80%成本。

本文由 AI 辅助整理，供技术学习参考。