3步搞定2FA密钥迁移：extract_otp_secrets工具全攻略

换新手机后2FA账号丢失怎么办？误删认证应用导致无法登录重要平台？extract_otp_secrets工具让Google Authenticator迁移不再头疼。这款开源工具能轻松从2FA应用导出的二维码中提取OTP密钥，支持相机捕获、图片读取和文本解析，帮你安全备份和迁移双因素认证信息。

快速上手：3分钟安装指南

准备工具

• 安装Python 3.6+环境
• 确保系统已安装pip包管理器

执行命令

git clone https://gitcode.com/gh_mirrors/ex/extract_otp_secrets
cd extract_otp_secrets
pip install -r requirements.txt

验证安装

运行以下命令检查是否安装成功：

python src/extract_otp_secrets.py --help

💡 小贴士：如果出现"缺少依赖"错误，尝试安装系统依赖：sudo apt install libzbar0（Linux）或通过brew安装zbar（macOS）。

功能特性解析

多源输入支持

• 相机捕获：直接通过摄像头扫描导出的二维码
• 图片识别：从本地图片文件中解析二维码
• 文本解析：处理纯文本格式的密钥信息

灵活输出格式

• JSON格式：适合开发人员导入其他系统
• CSV格式：可直接导入Excel或密码管理器
• 控制台打印：即时查看提取结果

实战教程：从Google Authenticator迁移密钥

第一步：获取导出二维码

1. 打开Google Authenticator应用
2. 点击"转移账户"选项
3. 选择"导出账户"生成二维码

第二步：使用相机捕获功能

运行相机捕获命令：

python src/extract_otp_secrets.py --camera

将手机上的二维码对准摄像头，工具会自动识别并提取密钥。

🔑 关键步骤：确保光线充足，二维码完整显示在摄像头范围内，工具会用绿色框标记识别到的二维码。

第三步：导出为CSV文件

python src/extract_otp_secrets.py --camera --csv otp_backup.csv

验证结果

打开生成的otp_backup.csv文件，确认包含账户名称和对应的密钥信息。

常见错误排查

二维码识别失败

• ⚠️ 确保二维码清晰无反光
• 尝试调整摄像头距离，保持二维码在画面中央
• 使用--image参数从保存的图片中识别：

  python src/extract_otp_secrets.py --image path/to/qr_code.png
  

依赖缺失错误

• 错误提示：ImportError: No module named 'zbar'
• 解决方案：安装zbar库和Python绑定

  pip install pyzbar
  

扩展阅读

• 高级导出功能：支持按账户类型筛选导出
• 批量处理技巧：一次迁移多个2FA账户
• 安全最佳实践：如何安全存储导出的OTP密钥

通过extract_otp_secrets工具，即使是非技术用户也能轻松完成2FA密钥的备份与迁移。无论是更换设备还是重装应用，都能确保你的双因素认证信息安全无虞。