配合备用机上的 SmsForwarder 使用, 两台手机无论相隔多远、是否同一网络,只要有网就能实时收到短信。
链路:
备用机 SmsForwarder ──Webhook──▶ ntfy.sh(公共中转,免费)──▶ 主力机本 App(长连接实时收)
- 接收端 App 主动长连接 ntfy.sh 订阅主题,不需要公网 IP、不需要服务器
- 低延迟:走流式长连接推送,不做轮询,通常 1 秒内弹通知
- 验证码识别 + 一键复制:收到含验证码的短信,通知栏直接显示验证码,带「复制验证码」按钮,点一下进剪贴板;App 内每条消息也有复制按钮
- 系统级自动填充:把本 App 设为系统自动填充服务后,在任意 App 的验证码框点一下,自动弹出「填入验证码 xxxxxx」,一键填入(见下方「开启自动填充」)
- 断网自动重连 + 按消息 id 去重,断线期间的消息重连后自动补收
- 前台服务 + 开机自启 + 忽略电池优化,保证息屏也能实时收
SmsReceiverApp/
├── app/src/main/
│ ├── AndroidManifest.xml # 权限:网络 / 前台服务 / 开机自启 / 通知
│ └── java/com/example/smsreceiver/
│ ├── MainActivity.kt # 界面:主题设置、订阅/断开、消息列表、复制验证码
│ ├── ReceiverService.kt # 前台服务:承载长连接 + 弹通知(含验证码一键复制)
│ ├── CodeExtractor.kt # 验证码自动识别(关键词正则 + 数字兜底)
│ ├── CopyCodeReceiver.kt # 通知栏复制按钮处理器
│ ├── SmsAutofillService.kt # 系统自动填充服务(验证码候选气泡)
│ ├── NtfySubscriber.kt # ntfy 长连接订阅(自动重连、去重、补拉)
│ ├── BootReceiver.kt # 开机自启恢复连接
│ ├── AppBus.kt # 服务 ↔ 界面的共享状态
│ └── SmsStore.kt # 数据模型 + JSON 文件持久化
│ ├── res/layout/
│ │ └── autofill_dataset_item.xml # 自动填充候选气泡布局
│ └── res/xml/
│ └── autofill_service.xml # 自动填充服务元数据和设置入口
├── app/build.gradle.kts # Kotlin + Compose + OkHttp + Gson
└── ...
最低支持 Android 8.0(minSdk 26)。
- 用 Android Studio(Hedgehog 及以上)打开
SmsReceiverApp,等待 Gradle 同步。 - 连接主力机(接收端),USB 调试开启,点 Run 安装;或
./gradlew assembleDebug生成 APK 手动安装。 - 打开 App:
- 输入一个主题名(如
sms-fwd-x7k9p2q8,要复杂、别人猜不到——主题名就是密码) - 点「订阅」,状态栏出现常驻通知「短信接收服务运行中」即成功
- 首次会请求通知权限;强烈建议点「忽略电池优化」按钮
- 输入一个主题名(如
-
「发送通道」→ 新建 → Webhook:
- URL:
https://ntfy.sh/你的主题名 - 请求类型:POST
- 消息模板(消息类型选 JSON):
{ "type": "sms", "from": "[[from]]", "msg": "[[msg]]", "device": "[[device_name]]", "time": [[timestamp]] } - URL:
-
「转发规则」→ 新建:匹配方式选「全部」或按发件人/关键词筛选,通道指向上面这个 Webhook。
备用机收到短信 → ntfy.sh 中转 → 主力机 1 秒内弹通知,App 内可回看历史。
用电脑或任何设备往主题发一条测试消息:
curl -d '{"type":"sms","from":"10086","msg":"测试短信","device":"备用机","time":1739939200}' \
https://ntfy.sh/你的主题名主力机应立即弹通知并在列表显示。
安卓不允许 App 静默往输入框填字(安全限制),标准做法是注册成系统自动填充服务, 由用户在系统设置里启用,填充时弹候选气泡让用户确认——和 Gboard、密码管理器的体验一致。
- 打开本 App,点「点此开启验证码自动填充(系统设置)」按钮,跳转到系统设置。
- 在「自动填充服务」里选择本 App(名称「短信接收端」)。
- 以后在任意 App(银行、社交、购物等)的验证码输入框点一下, 键盘上方会弹出「填入验证码 xxxxxx」候选,点一下即自动填入。
识别逻辑(SmsAutofillService.kt):
- 优先识别带 OTP/验证码/verification 语义的输入框(含 Android 标准 autofillHints);
- 兜底识别 4~10 位的纯数字输入框;
- 验证码来源是本 App 保存的最新一条转发短信,取不到就不弹,不会误填。
注意:自动填充用的是本机保存的最新验证码,所以要先收到转发的验证码短信、 且本 App 在后台运行中(前台服务常驻),才能填充。不同 App 的验证码框形态各异, 个别识别不到的可以在通知栏点「复制验证码」手动粘贴。
| 项 | 作用 |
|---|---|
| App 内点「忽略电池优化」 | 防止息屏后长连接被省电机制掐断(延迟的最大杀手) |
| 允许自启动 + 常驻通知 | 前台服务保活,进程被杀概率大幅降低 |
| 备用机 SmsForwarder 保活 | 备用机侧同样要关闭电池优化,否则发端就断了 |
| 收发两端网络质量 | ntfy.sh 服务器在国外,国内网络高峰期可能有 1~3 秒波动;要求更稳可自建 ntfy |
如果对延迟要求极高或介意消息经公共服务器,可自建 ntfy(单二进制,一条 Docker
命令跑起来),把 App 里 NtfySubscriber.kt 的 https://ntfy.sh 换成自己的域名即可。
- ntfy.sh 上任何知道主题名的人都能订阅看到消息,所以主题名务必设成足够长的随机串。
- ntfy.sh 缓存消息默认 12 小时,之后服务器上删除;App 本地历史永久保留,可随时清空。
- 验证码类短信介意经第三方服务器的,请自建 ntfy。
示例代码可自由修改使用。