Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

JoyinJoester/Monica

Repository files navigation

Monica 本地密码库

中文 | English | 日本語 | Tiếng Việt

License Platform Security Website

Monica 是一个聚合 BitwardenKeePass 的本地密码库(Local Vault)。 它以本地存储优先为核心,帮助你在 Android 与浏览器端统一管理账号密码、2FA、私密笔记与敏感附件。

官网入口: https://joyinjoester.github.io/Monica/

Monica for Windows 已归档。历史代码见: Monica-for-Windows


用户先看

Monica 适合谁

  • 需要本地优先密码管理,不希望账号数据托管到第三方云。
  • 既使用 Bitwarden,也维护 KeePass (.kdbx) 数据。
  • 需要 Android 日常使用,同时在浏览器里完成自动填充。

你能得到什么

  • 本地加密保险箱: 登录信息、银行卡、身份信息、私密笔记、附件。
  • 双生态聚合: Android 端包含 Bitwarden API/同步能力与 KeePass (.kdbx) 读写能力。
  • 可选同步与备份: 通过自有 WebDAV 基础设施实现跨设备数据流转。
  • 内置 TOTP: 在同一应用内完成密码与二次验证码管理。

快速安装

Android:

  1. Releases 下载最新 APK。
  2. 在 Android 8.0+ 设备安装并初始化主密码。

浏览器插件 (Chrome / Edge):

  1. Monica for Browser 目录构建插件。
  2. 打开 chrome://extensions/ 并启用开发者模式。
  3. 选择"加载已解压的扩展程序",导入 dist 目录。

Android 版本重点

核心功能

  • 本地 Vault: 所有核心凭据本地加密存储。
  • 聚合导入: 支持 KeePass 数据迁移与 Bitwarden 兼容接入。
  • 智能检索: 按标题、域名、标签快速定位凭据。
  • 生物识别解锁: 使用系统级生物识别能力提升安全与可用性。
  • TOTP 管理: 统一存储并生成动态验证码。

实现说明(专业版)

  • UI 层: Jetpack Compose + Material 3 + Navigation Compose。
  • 数据层: Room(PasswordDatabase)+ DAO + Repository。
  • 并发模型: Kotlin Coroutines + Flow。
  • 依赖注入: Koin(应用启动于 MonicaApplication)。
  • 安全能力: Android Keystore、EncryptedSharedPreferences、BiometricPrompt。
  • 同步任务: WorkManager(AutoBackupWorker)用于自动 WebDAV 备份。
  • 协议与集成: Retrofit + OkHttp(Bitwarden API)、kotpass(KeePass)、sardine-android(WebDAV)。

安全模型

  • 加密算法: AES-256-GCM(认证加密)。
  • 密钥派生: PBKDF2-HMAC-SHA256(高迭代参数)。
  • 本地保护: 主密码哈希与安全配置由本地安全组件管理。
  • 网络边界: 应用声明网络权限,主要用于 Bitwarden 联动与 WebDAV 备份/同步等在线能力。

赞助支持

如果 Monica 对你有帮助,欢迎支持持续开发与安全投入。

Support Monica
微信 / 支付宝扫码支持

你的支持将优先用于:

  • 安全审计与加密方案强化。
  • Android 体验优化与稳定性改进。
  • 跨端功能统一与文档维护。

开发者信息

项目分层(代码现状)

  • takagi/ru/monica/ui: Compose 页面与组件。
  • takagi/ru/monica/data: Room 实体、DAO、数据库迁移。
  • takagi/ru/monica/repository: 数据访问封装。
  • takagi/ru/monica/security: 加密、密钥与鉴权相关实现。
  • takagi/ru/monica/bitwarden: API、加密、映射、同步与视图模型。
  • takagi/ru/monica/autofill: 自动填充服务与流程。
  • takagi/ru/monica/passkey: Android 14+ Credential Provider 相关实现。
  • takagi/ru/monica/workers: 后台任务(如自动 WebDAV 备份)。

当前已使用的成熟组件(仓库可验证)

  • Android UI: Jetpack Compose, Material 3, Navigation Compose。
  • 数据与状态: Room, DataStore Preferences, ViewModel。
  • 安全: Android Keystore, EncryptedSharedPreferences, BiometricPrompt。
  • 网络与协议: Retrofit, OkHttp, Kotlinx Serialization。
  • 同步与生态: sardine-android(WebDAV), kotpass(KeePass), Bitwarden API 对接。
  • 异步与任务: Coroutines, Flow, WorkManager。
  • 其他能力: CameraX + ML Kit(二维码扫描), Credentials API(Passkey)。

构建与贡献

  • Android Studio: 最新稳定版。
  • JDK: 17+。
  • Android 配置: minSdk 26,targetSdk 34(见 Monica for Android/app/build.gradle)。
  • 浏览器端技术栈: React + TypeScript + Vite(见 Monica for Browser/package.json)。
  • 欢迎通过 Issue / PR 参与功能和安全改进。

许可证

Copyright (c) 2025 JoyinJoester

Monica 基于 GNU General Public License v3.0 开源发布。

第三方图标标注

AltStyle によって変換されたページ (->オリジナル) /