2FA4G 使用指南
2FA4G 用来在手机端管理 OTP，并把支持的验证码同步到 Garmin 手表中离线查看。本文覆盖导入方式、Garmin 同步、兼容性限制以及常见故障排查。
快速开始
- 安装 Garmin Connect Mobile，并正常完成手表配对。
- 在手机上打开 2FA4G，先导入一个 token。
- 点击 App 顶部的手表按钮，选择 Garmin 设备；如果系统提示，先安装手表端应用。
- 开始同步。支持的 token 会写入手表，之后可离线查看。
2FA4G 支持什么
2FA4G 面向常见的 OTP 使用场景，例如邮箱、开发平台、VPN、效率工具和后台管理系统。
手机端支持
- TOTP 与 HOTP
otpauth://二维码导入otpauth-migration://Google Authenticator 批量迁移导入- 手动录入账号名、issuer、secret、位数、类型、counter 和 period
手表端支持
当前 Garmin 手表构建支持：
- TOTP
- HOTP
- SHA1
- SHA256
- 常见 6 位和 8 位验证码
当前手表构建 暂不支持 SHA512 同步。如果你在手机端添加了 SHA512 token，它会保留在手机本地，但不会被传到手表。
导入 OTP
扫码导入
点击顶部导入按钮，选择 Scan QR code，直接扫描服务商提供的 OTP 配置二维码。
从相册导入
如果二维码已经保存在相册中，选择 Import from photo。2FA4G 会请求相册权限，并尝试识别所选图片中的二维码。
从剪贴板导入
如果你复制了 otpauth:// 或 otpauth-migration:// 链接，选择 Import from clipboard 即可。
手动录入
如果服务商直接给你 secret，而不是二维码，选择 Enter manually。录入时至少确认：
- 账号标签
- issuer
- secret
- TOTP 还是 HOTP
- digits
- TOTP 的 period
- HOTP 的 counter
同步到 Garmin
同步前确认
请先确认：
- 已安装并登录 Garmin Connect Mobile
- 手表与手机连接正常
- 2FA4G 手表端应用已经安装
- 同步期间手机端和手表端应用都保持可通信状态
同步流程
2FA4G 会把当前激活 token 集合从手机端发送到手表。写入成功后，支持的 token 会保存在手表本地，因此手机不在身边时仍可查看验证码。
免费版最多同步前 3 个激活 token。升级 Pro 后，可同步完整的激活 vault。
HOTP 计数器
如果你在手表端生成 HOTP，计数器会在手表上递增。下次同步时，2FA4G 会合并 counter，避免回退。
导出到 Google Authenticator
打开某个 token 的二维码页面后，2FA4G 支持导出两种形式：
- 标准
otpauth://二维码 - Google Authenticator migration 二维码
如果 token 使用了 Google migration 不能完整保留的自定义 period，2FA4G 会在导出前给出提示。
本地存储与隐私
2FA4G 会把 token secret 保存在你的设备本地。只有当你主动执行同步时，支持的 token 才会额外写入 Garmin 手表。本产品的核心流程不依赖单独云账号。
购买权益通过 RevenueCat 和 App Store / Google Play 计费系统校验。详情请阅读 隐私政策。
免费版与 Pro
免费版
- 最多 3 个激活 token
- 这 3 个激活 token 可同步到 Garmin
- 完整的手机端导入流程
Pro
- 可超过 3 个激活 token
- 支持完整激活 vault 的 Garmin 同步
- 不再触发额外 token 的免费限制锁定
常见问题排查
没有发现 Garmin 设备
- 先打开一次 Garmin Connect Mobile
- 确认蓝牙已开启
- 确认手表在 Garmin Connect 中显示已连接
- 返回手表同步 sheet，刷新设备列表
手表端应用未安装
在手表同步 sheet 中点击 Install watch app，完成 Garmin Connect IQ 安装流程。
同步提示某个 token 不受支持
最常见原因是 SHA512。手机端可以保留这个 token，但当前手表构建只支持 SHA1 和 SHA256。
同步超时或失败
- 保持 Garmin Connect Mobile 正常运行
- 保持手机端应用在前台
- 先打开手表端应用，再重试同步
- 刷新设备列表后重新尝试
验证码不正确
请逐项检查导入信息是否与服务商提供的一致：
- secret 是否正确
- 类型是否为 TOTP 或 HOTP
- period 是否正确
- digits 是否正确
- HOTP counter 是否正确
联系我们
如果仍需帮助，请访问 支持页面 或发送邮件到 [email protected]。