告别Google Authenticator换应用:用google-authenticator-exporter二维码模式迁移账户到Aegis/2FAS
告别Google Authenticator换应用:用google-authenticator-exporter二维码模式迁移账户到Aegis/2FAS
google-authenticator-exporter 是一个免费的 2FA 账户迁移工具:它能把 Google Authenticator 官方"导出账户"功能生成的二维码(otpauth-migration:// URI)解码,并转换成 Aegis、2FAS 等主流验证器可直接扫描的标准 otpauth:// 二维码,全程 3 步即可完成 TOTP 账户迁移,无需逐个重新设置双因素认证。
为什么 Google Authenticator 的账户这么难迁移?
- Google Authenticator 不支持导入账户,数据加密存放在本机,官方也不提供备份文件;
- 换手机、或想换到 Aegis / 2FAS 时,只能去每个网站重新开启 2FA——不少老账号早已丢失开启入口;
- 官方虽有「转移账户 → 导出账户」功能,但导出的二维码没有任何验证器能直接读,格式太新。
👉 google-authenticator-exporter 正是补上这最后一环:解码导出二维码,重新生成通用格式的二维码。
一键迁移三步走:二维码模式(qrcode mode)全流程
第 1 步:从 Google Authenticator 导出二维码
- 打开 Google Authenticator → 右上角 ⋮ → 转移账户 → 导出账户
- 按提示验证身份,选择要导出的账户(默认全选)
- 点击"下一步",屏幕会显示二维码
- 用摄像头给二维码拍照——官方应用禁止截图,需用笔记本摄像头、数码相机或另一台手机
- 账户很多时会连续出现多张二维码,点"下一步"逐张拍完
第 2 步:把照片解码成 URI
用扫码 App 识别照片:Android 推荐 ZXing,桌面端推荐 ZBar,得到形如:
otpauth-migration://offline?data=CiIKCkhlbGwPId6tvugSD...
⚠️ 安全提醒:这个 URI 包含你的邮箱、站点名和全部 2FA 密钥,请勿粘贴到在线解码网站,防止被留存窃取。
第 3 步:运行 google-authenticator-exporter 生成新二维码
git clone https://gitcode.com/gh_mirrors/go/google-authenticator-exporter
cd google-authenticator-exporter
npm install
npm run start:qrcode
终端提示 Enter the URI from Google Authenticator QR code. 时,粘贴第 2 步得到的 otpauth-migration://... 字符串并回车。工具会自动完成:
| 处理环节 | 说明 | 对应源码 |
|---|---|---|
| URI 解码 | Base64 → 还原 protobuf 负载 | src/index.js |
| 协议解析 | 按 MigrationPayload 结构取出每个账户 | src/google_auth.proto |
| 密钥转换 | Base64 密钥 → 标准 Base32 TOTP 密钥 | src/edbase32.js |
| 输出二维码 | 每个账户一张 otpauth:// PNG |
src/index.js 的 saveToQRCodes |
最终在当前目录生成 ./qrCodes/ 文件夹,一个账户一张二维码,文件名形如 站点名 (账户名).png。多张导出二维码就重复粘贴多次 URI 即可,账户总数保持不变。
导入 Aegis / 2FAS 完成迁移
- 把
./qrCodes/文件夹传到手机(数据线、网盘均可) - Aegis:主界面「扫描」→ 逐张选取 PNG 图像导入
- 2FAS:「添加账户」→ 扫描二维码 → 逐张导入
- 核对生成的 6 位动态验证码与原应用一致后,即可删掉 Google Authenticator 里的旧账户
💡 二维码模式最大的好处:密钥全程不经过复制粘贴,扫完即可,最大限度降低泄露风险。
备选:JSON 模式与 Docker 运行
JSON 模式:批量导出密钥
npm run start
按提示粘贴 URI,回答是否保存(y)及文件名(如 accounts.json),输出所有账户的 name / issuer / totpSecret 等字段。
注意:在其他工具中录入密钥时,应使用
totpSecret字段(Base32 格式),而不是原始的secret字段——工具也会用醒目文字再次提醒。
测试向量可参考 test-assets/test-qr-codes.json,它包含单张、多张及 SHA512-8 位验证码等真实导出样例。
Docker 模式:无需安装 Node.js
docker build . --tag google-authenticator-exporter:0.0.1
docker run -it --rm google-authenticator-exporter:0.0.1
粘贴 URI 后,解码结果会直接打印在终端(未挂载卷时不能保存文件,后续提问按回车跳过即可)。镜像构建见 Dockerfile。
常见问题
Q:为什么不能截图 Google Authenticator 的导出二维码? A:应用禁用了截屏。拍照是唯一方式,光线充足、对焦清晰可提高解码成功率。
Q:URI 特别长,复制不全怎么办?
A:data= 参数通常有数百字符,请整体复制并在扫码 App 中确认完整后再粘贴,截断会导致 protobuf 解析失败。
Q:导出数据里包含敏感信息,如何保护自己?
A:全程在本地离线处理,不上传任何内容;迁移完成后删除照片、otpauth-migration URI 文本及 ./qrCodes/ 目录。
项目结构速览
| 文件 | 作用 |
|---|---|
| src/index.js | 主程序:CLI 交互、URI 解码、二维码/JSON 输出 |
| src/google_auth.proto | Google Authenticator 导出数据的 protobuf 定义 |
| src/edbase32.js | Base32 编码实现(RFC 3548) |
| src/index.test.js | 解码功能测试 |
| test-assets/test-qr-codes.json | 真实导出二维码的测试 URI |
整个项目代码量很小、逻辑透明,适合想弄清 otpauth 协议细节的同学通读一遍源码。迁移完成后,你的双因素认证就能完整"搬家",再也不用为每个账号折腾重置流程了 ✅
