🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具

0 阅读10分钟

前言

verification-relay-demo-poster.jpg

可能我是一个比较喜欢折腾小工具的人,平时遇到一些不算严重、但每天都会重复出现的小问题,就总想写点东西把它解决掉。

这次的问题非常简单:我在 Mac 上登录网站时,验证码却在 Android 手机上。

正常流程大概是:手机亮屏 → 解锁 → 打开短信 → 记住六位数字 → 回到 Mac → 输入验证码。有时刚记住前三位,切回来时后三位又忘了,只能再拿一次手机 🥲。

一次两次当然没什么,但每天重复几次之后,“懒人精神”就开始发挥作用了:既然手机和 Mac 都在同一个 Wi-Fi 下,为什么不能让验证码自己走到 Mac 上呢?

所以,验证码接力这个小工具就诞生了 🥳!

🎯 Android 手机收到短信验证码后,只提取验证码和发送方名称,通过同一局域网端到端加密发送到 Mac。

🔒 不使用云服务器,不上传完整短信,手机与 Mac 的设备私钥都不会离开本机。

🍎 Mac 端是菜单栏应用;收到验证码后可以一键复制,验证码过期后会自动从界面清除。

快速安装

安装 Mac 应用

  1. 打开项目的 Releases 页面;
  2. 下载 OtpBridge-macOS.zip 并解压;
  3. 将“验证码接力.app”拖进“应用程序”文件夹;
  4. 第一次启动时允许局域网和通知权限。

Mac 端只会显示在状态栏,不会出现在 Dock 中。关闭主窗口不会退出应用,如果想完全退出,需要在状态栏菜单中点击“退出”。

当前自动构建使用 ad-hoc 签名,还没有经过 Apple 公证。如果 macOS 阻止第一次打开,请确认安装包来自项目 Release,随后在 Finder 中右键应用并选择“打开”。

安装 Android 应用

  1. 在 Releases 页面下载 VerificationRelay-Android.apk;
  2. 允许浏览器或文件管理器“安装未知应用”;
  3. 点击 APK 完成安装。

如果电脑已经配置了 ADB,也可以使用下面的命令:

adb install -r -g VerificationRelay-Android.apk

其中 -r 表示覆盖升级,并保留已有的配对与设置。

开始使用

整个配置流程其实只有四步:

  1. 确认 Android 手机和 Mac 连接到同一个 Wi-Fi;
  2. 打开 Mac 应用,在“连接与配对”页面生成二维码;
  3. 打开 Android 应用,点击“扫描 Mac 配对二维码”;
  4. 授予短信接收权限,然后点击“发送测试验证码”。

如果 Mac 成功显示测试验证码 123456,就说明整条接力链路已经准备好了 🚀。

二维码中只有一次性配对令牌,有效期为 5 分钟,而且使用一次后就会失效。如果二维码过期,点击“生成新的配对码”即可。

功能展示

验证码自动提取

Android 收到新短信后,会在手机本地查找 4~8 位数字,并结合“验证码”“校验码”“OTP”“code”等关键词进行判断。

应用只发送提取后的验证码与发送方名称,不会把完整短信发送到 Mac。

为了兼容部分对短信权限限制比较严格的系统,我还做了一个“通知读取(备用)”通道。不过这个通道只会处理系统当前默认短信 App 的通知,微信、支付宝和邮件等其他应用的通知不会被解析。

扫码安全配对

第一次使用时,Mac 会生成一个五分钟有效的一次性二维码。Android 扫描后,两台设备交换公钥并完成配对。

这里有一个比较重要的设计:二维码中没有私钥。

Mac 的私钥保存在 macOS Keychain 中,Android 的私钥保存在手机本地的加密存储中。二维码只负责传递一次性配对令牌、设备信息和建立连接所需的数据。

codex-clipboard-c6ca81ee-eee1-432e-be35-8ac9153a74e5.png

双端在线诊断

这种跨设备工具最麻烦的地方,往往不是“能不能运行”,而是出问题时不知道卡在了哪里。

所以 Android 首页会同时展示:

  1. Mac 是否已经配对;
  2. Mac 接收服务是否可用;
  3. 短信接收权限是否授权;
  4. 通知读取备用通道是否启用;
  5. Android 后台服务是否运行;
  6. 最近一次操作的状态。

Mac 端也会展示手机服务是“服务在线”还是“未发现服务”。至少当验证码没有出现时,不需要靠猜来判断是哪一端出了问题 😃。

Mac 状态栏一键复制

验证码抵达 Mac 后,状态栏菜单会自动展开,并展示验证码与发送方名称。点击复制按钮后,就可以直接粘贴到浏览器或其他应用中。

系统通知会作为辅助提醒;验证码到期后,也会自动从界面清除,避免旧验证码一直留在桌面上。

配对设备与密钥管理

Mac 端可以查看已经配对的 Android 手机、配对时间和在线状态,也可以单独移除某一台设备。

在“安全设置”中,还可以查看设备 ID、公钥指纹,或者重置整个设备密钥。重置后所有手机都需要重新扫码配对,但不会影响 APK 的安装签名。

codex-clipboard-d020eec8-49f4-4a69-97cd-dba2b0af8119.png

国产 Android 的额外设置

部分小米、Redmi、POCO、OPPO、vivo、荣耀等机型,会在 Android 标准短信权限之外,再增加“通知类短信”或“验证码短信”权限。

如果普通状态下可以接力,但锁屏后收不到验证码,可以依次检查:

  1. “接收短信”是否允许;
  2. “通知类短信 / 验证码类短信”是否允许;
  3. 是否开启自启动;
  4. 是否允许后台活动;
  5. 电池策略是否设置为“不限制”;
  6. 手机和 Mac 是否仍连接同一个 Wi-Fi。

需要注意的是,手机重启以后、完成第一次解锁之前,Android 的凭证加密存储还不可用,因此此时不会转发验证码。解锁一次后就会恢复,这和普通锁屏不是同一种情况。

为什么坚持不使用云服务器?

验证码本身就是非常敏感的信息。如果为了少拿一次手机,却要把完整短信发送到某个远程服务器,我觉得这个交换并不划算。

所以这个项目从一开始就确定了几个原则:

  1. 手机和 Mac 只在同一局域网中直接通信;
  2. 不依赖账号体系,也不需要登录;
  3. 不上传完整短信,只发送验证码与发送方名称;
  4. 每台设备独立生成私钥,私钥永远不通过网络发送;
  5. 即使局域网流量被截获,也不能直接读取验证码内容。

目前使用的加密组合是:

P-256 ECDH
    ↓
HKDF-SHA256 派生 32 字节会话密钥
    ↓
AES-256-GCM 认证加密验证码消息

代码实现

在 Android 本地提取验证码

验证码提取器会查找独立的 4~8 位数字,并结合常见关键词进行判断:

private static final Pattern DIGITS =
        Pattern.compile("(?<![A-Za-z0-9])([0-9]{4,8})(?![A-Za-z0-9])");

private static final String[] KEYWORDS = {
        "验证码", "校验码", "动态码", "认证码",
        "一次性密码", "otp", "verification", "code", "passcode"
};

public static String extract(String text) {
    if (text == null || text.isBlank()) return null;
    Matcher matcher = DIGITS.matcher(text);
    if (!matcher.find()) return null;

    String firstMatch = matcher.group(1);
    String lower = text.toLowerCase(Locale.ROOT);
    for (String keyword : KEYWORDS) {
        if (lower.contains(keyword)) return firstMatch;
    }
    return firstMatch;
}

短信的解析全部发生在 Android 本地,提取完成后才会进入加密和发送流程。

在局域网中发现 Mac

Mac 使用 Bonjour / DNS-SD 广播接收服务,Android 则通过 NsdManager 自动发现服务,不需要让用户手动填写 IP 和端口。

manager.discoverServices(
    serviceType,
    NsdManager.PROTOCOL_DNS_SD,
    discoveryListener
);

发现服务后,Android 会解析 Mac 的局域网地址和端口,再建立连接。如果在超时时间内没有发现对应服务,就会提示用户检查 Wi-Fi 和后台运行状态。

派生会话密钥

两台设备完成 P-256 ECDH 后,不会直接把共享秘密当作加密密钥,而是使用 HKDF-SHA256 派生固定长度的会话密钥:

let secret = try privateKey.sharedSecretFromKeyAgreement(with: publicKey)
let deviceIDs = [localDeviceID, peerDeviceID]
    .sorted()
    .joined(separator: ":")

return secret.hkdfDerivedSymmetricKey(
    using: SHA256.self,
    salt: Data(deviceIDs.utf8),
    sharedInfo: BridgeProtocol.keyInfo,
    outputByteCount: 32
)

随后使用 AES-GCM 加密消息,并把设备 ID 作为认证数据的一部分:

let sealed = try AES.GCM.seal(
    plaintext,
    using: key,
    authenticating: Data(authenticatedDeviceID.utf8)
)

这样不仅可以保护验证码内容,也可以校验消息有没有被修改,以及消息是不是来自预期设备。

Mac 接收服务

Mac 使用 Network.framework 创建 TCP 监听器,同时把服务发布到局域网:

let listener = try NWListener(using: .tcp)
listener.service = NWListener.Service(
    name: serviceName,
    type: BridgeProtocol.serviceType
)

listener.newConnectionHandler = { connection in
    accept(connection)
}

listener.start(queue: queue)

接收到消息后,会先检查协议版本和设备配对状态,再派生会话密钥并解密。只有已经配对的设备才能发送有效验证码。

开发过程中遇到的一些问题

后台运行比前台页面更难处理

刚开始测试时,打开 Android App 一切正常,但锁屏一段时间后服务就可能被系统暂停。不同厂商对后台活动、自启动和电池优化的处理又不完全一样。

最后只能同时做好前台服务、开机恢复、在线状态诊断,并在文档中明确告诉用户需要检查哪些厂商权限。

“通知读取备用”不能什么都读

通知监听权限非常强,如果简单地扫描所有通知,微信、邮件甚至支付应用中的数字都可能被误判。

因此备用通道会检查通知来源,只接受系统当前默认短信 App 发出的通知。宁可少支持一些场景,也不要扩大读取范围。

配对二维码不能永久有效

如果二维码长期有效,截图泄露后就可能被重复利用。所以配对令牌设置了五分钟有效期,并且成功使用一次后立即失效。需要添加另一台手机时,必须重新生成二维码。

作者的话

这个项目的起点其实非常简单:我就是不想每次登录网站都拿起手机抄一遍验证码。

不过真正做下来以后,会发现一个看起来只有“把六位数字发过去”的功能,背后还涉及局域网发现、跨平台通信、设备身份、密钥管理、认证加密、Android 后台限制和 macOS 菜单栏交互等问题。

目前项目已经开源,也准备了完整的官网和操作视频。如果你正好是 Android + Mac 用户,可以下载体验一下哈!如果觉得有帮助,欢迎在 GitHub 点个 ⭐,也欢迎提交 Issue 反馈 BUG 或新的想法 🥺。

如果大家对 Android 与 macOS 的局域网通信、端到端加密或者菜单栏应用开发感兴趣,后面也可以单独整理一篇更详细的开发过程 😌。

后续规划:

  • 实现自动填充验证码至输入框
  • 还有什么好的想法与建议可以评论区讨论,因为博主没有 Windows 电脑和 iOS 手机,无法做全平台适配的 APP 适配