Skip to content

climashscape/TOTP-2FA

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TOTP 身份验证器 (TOTP Authenticator) - 用户手册

欢迎使用 TOTP 身份验证器!这是一个安全、跨平台、美观的桌面工具,用于生成双因素认证 (2FA) 验证码。它功能对标 Google Authenticator,但运行在您的电脑上,让您无需掏出手机即可快速登录。

✨ 核心功能

  • 🔒 安全存储:所有账户密钥均加密存储在本地,绝不上传云端。
  • 🖥️ 跨平台:完美支持 Windows、macOS 和 Linux。
  • ⚡️ 极速体验:Rust 强力驱动,秒级启动,资源占用极低。
  • 🎨 现代界面
    • 深色模式:自动跟随系统主题,夜间使用更护眼。
    • 一键复制:点击验证码即可自动复制到剪贴板。
    • 倒计时提醒:直观的进度条,最后5秒变红闪烁提醒。
  • ⌨️ 命令行支持:对于开发者,我们也提供了强大的 CLI 工具,数据与桌面版完全互通。

🚀 快速入门

第一步:准备工作

在使用前,您需要先从目标网站(如 GitHub, Google, Amazon 等)获取 密钥 (Secret Key)

  • 通常在开启 2FA 时,点击二维码下方的 "Can't scan barcode?" 或 "Setup key" 即可看到一串字符(例如:JBSWY3DPEHPK3PXP)。

第二步:启动应用

桌面版 (推荐)

  1. 进入 desktop 目录:cd desktop
  2. 安装依赖(仅首次):npm install
  3. 启动:npm run tauri dev

命令行版 (极客之选)

  1. 进入 cli 目录:cd cli
  2. 安装依赖:pip install -r requirements.txt
  3. 使用:python get2fa.py --help

📖 详细使用指南

1. 添加账户

  • 桌面版:点击右上角的 "+ Add Account" 按钮,输入账户名称(如 "GitHub")和密钥,点击保存即可。
  • 命令行python get2fa.py add GitHub JBSWY3DPEHPK3PXP

2. 查看验证码

  • 桌面版:打开应用,所有账户以卡片形式展示。验证码每 30 秒自动刷新。
    • 复制:直接点击卡片上的 6 位数字,显示 "Copied!" 即表示复制成功。
  • 命令行python get2fa.py list

3. 删除账户

  • 桌面版:鼠标悬停在账户卡片上,点击右上角的 垃圾桶图标,确认后即可删除。
  • 命令行python get2fa.py delete GitHub

4. 数据备份与迁移

所有数据均存储在您电脑用户目录下的 .totp-secrets.json 文件中。

  • 备份:只需复制该文件到安全的地方(如加密的 U 盘)。
  • 迁移:在新电脑上安装本软件后,将该文件复制到新电脑的用户目录下即可。

❓ 常见问题解答 (FAQ)

Q: 验证码提示错误怎么办? A: TOTP 算法依赖于时间。请检查您电脑的系统时间是否准确,误差超过 30 秒会导致验证码无效。建议开启系统的 "自动设置时间" 功能。

Q: 密钥区分大小写吗? A: 通常不区分。我们的程序会自动处理密钥中的空格和大小写问题,您只需直接粘贴即可。

Q: 安全性如何? A: 密钥文件存储在您的本地硬盘 (~/.totp-secrets.json)。只要您的电脑未被入侵,数据就是安全的。对于极高安全需求的场景,建议结合系统级加密(如 BitLocker 或 FileVault)使用。


🛠️ 开发者指南

如果您想参与开发或自行构建:

技术栈

  • 前端:React + TypeScript + Vite + Tailwind CSS (Styled)
  • 后端:Rust + Tauri
  • 图标:Lucide React

构建发布版

cd desktop
npm run tauri build

构建产物将位于 desktop/src-tauri/target/release/ 目录下。

About

安全、跨平台、美观的桌面 TOTP 身份验证器 — 对标 Google Authenticator,Rust + Tauri 驱动,支持 CLI。密钥本地加密存储,绝不上传云端。

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors