Repository navigation
Home
English: See the English README for deployment and usage instructions. The full Wiki is currently maintained in Simplified Chinese.
2FA 是部署在 Cloudflare Workers 上的两步验证密钥管理工具。你可以在自己的实例中保存各网站的验证密钥，生成 TOTP / HOTP 验证码，通过网页、手机 PWA 和浏览器扩展使用。
扩展商店上架进度与源码版本独立，安装前请查看对应商店。项目采用 MIT 许可证。
| 你想做什么 | 阅读顺序 |
|---|---|
| 第一次使用 | 快速开始 → 日常使用 |
| 部署自己的实例 | 部署指南 → 配置参考 → 安全与隐私 |
| 从其他验证器迁移 | 导入与导出 → 备份与恢复 |
| 在手机或浏览器里取码 | PWA 与离线使用 / 浏览器扩展 |
| 配置异地备份 | 备份与恢复 → 远程存储配置 |
| 更新已部署的实例 | 升级与回滚 |
| 排查问题 | 常见问题与故障排查 |
| 接入 API 或参与开发 | API 参考 → 系统架构 → 开发与贡献 |
- 账户管理：扫码、二维码图片识别、粘贴截图或手动添加；支持搜索、排序和按服务聚合，可在当前浏览器设置默认显示方式。
- 验证码：网页支持基于时间的 TOTP 和基于计数器的 HOTP；浏览器扩展支持 TOTP 复制、手动填充和经授权的自动填充。
- 数据迁移：导入多种验证器导出文件及 Google Authenticator 迁移二维码，导出 TXT、JSON、CSV、HTML 等格式。
- 备份：账户数据变更触发备份，定时检查兜底；可推送到 WebDAV、S3 兼容存储、OneDrive 或 Google Drive。
- 多设备使用：各设备登录同一个实例读取账户；使用 Durable Object 协调账户修改，减少并发覆盖。
- 界面与安装：响应式网页、浅色/深色/跟随系统主题，支持多语言界面和手机 PWA。
- 这是一个实例共用管理密码的应用。 当前没有按用户隔离账户的注册、成员角色或团队权限系统。持有管理权限的人可以访问实例中的验证密钥。
-
存储加密需要配置
ENCRYPTION_KEY。 配置后由 Worker 加解密，不属于端到端加密；原始加密密钥需要独立保存，丢失后无法解密已有加密数据和备份。 - 离线使用会在设备保存密钥。 网页缓存和启用离线模式的扩展缓存没有额外密码加密，请在可信设备上使用。HOTP 计数器推进需要联网。
- 恢复备份会替换现有账户。 先导出当前数据；需要合并新旧账户时使用批量导入。
- 升级保留原实例。 使用 Sync Upstream 或 CLI 原地更新，保留 Worker、KV、Secrets；不要通过删除实例重装来升级。v1.11.0 的切换和回滚限制见升级与回滚。
源代码 · 版本发布与安装包 · 报告问题 · 贡献指南 · 私密报告安全漏洞
Wiki 是按主题组织的中文手册；仓库 README 提供多语言项目介绍，docs/ 保留专项指南和版本记录。各页末尾列出主要实现或原始文档，便于核查。
维护 Wiki 时，应同步修改受影响的功能页、配置/API 参数与侧边栏；新增页面使用稳定的英文文件名和中文标题，检查站内链接及示例后再发布。不要把实际验证密钥、备份、会话令牌或私人部署配置写入文档。