Monica
Monica is an open-source password manager with a local-first approach to storing passwords and private information.
Automatically checked · GitHub checked 2026-11-12

Before you switch
Evaluate hosting, migration and feature requirements before switching.
Overview
Monica 本地密码库
中文 | English | 日本語 | Tiếng Việt | Русский | 黑羽川
聚合 Bitwarden 与 KeePass 的本地优先密码库
Android · Local Vault · TOTP · WebDAV Backup
Monica 是一个聚合 Bitwarden 与 KeePass 的本地密码库(Local Vault)。 它以本地存储优先为核心,帮助你在 Android 设备上统一管理账号密码、2FA、私密笔记与敏感附件。
官网入口: https://monica-pass.github.io/MonicaDocs/
用户先看
Monica 适合谁
- 需要本地优先密码管理,不希望账号数据托管到第三方云。
- 既使用 Bitwarden,也维护 KeePass (
.kdbx) 数据。 - 需要在 Android 应用和手机浏览器中使用自动填充。
你能得到什么
- 本地加密保险箱: 登录信息、银行卡、身份信息、私密笔记、附件。
- 双生态聚合: Android 端包含 Bitwarden API/同步能力与 KeePass (
.kdbx) 读写能力。 - 可选同步与备份: WebDAV 备份及远端库同步、OneDrive 备份与文件访问,以及配对后的局域网传输。
- 内置 TOTP: 在同一应用内完成密码与二次验证码管理。
MDBX 本地数据库格式
跨端开发与 AI 适配请先遵守 Monica MDBX 存储兼容契约,其中区分了核心格式、业务类型、未知字段保留和同步验收要求。 MDBX 是 Monica 正在推进的本地优先加密 vault 格式。它不是简单的密码表,而是围绕嵌套文件夹、附件、提交历史、冲突检测、tombstone 删除链路、快照恢复和 Tiga 安全模式设计的数据库格式。
如果你要在其他客户端接入 MDBX,请先读 MDBX workspace 说明 和 MDBX 客户端接入指南。完整格式规范在 mdbx/docs。
快速安装
- 从 Releases 下载最新 APK。
- 在 Android 8.0+ 设备安装并初始化主密码。
已知限制
- 由于系统兼容性原因,Monica for Android 目前在部分小米 HyperOS 设备上无法创建通行密钥(Passkey)。可以尝试酷 U 提供的解决模块:HyperMonica。
Android 版本重点
核心功能
- 本地 Vault: 所有核心凭据本地加密存储。
- 聚合导入: 支持 KeePass 数据迁移与 Bitwarden 兼容接入。
- 智能检索: 按标题、域名、标签快速定位凭据。
- 生物识别解锁: 使用系统级生物识别能力提升安全与可用性。
- TOTP 管理: 统一存储并生成动态验证码。
实现说明
- UI 层: Jetpack Compose + Material 3 Expressive + Navigation Compose。
- 数据层: Room(
PasswordDatabase)+ DAO + Repository,并接入原生 KDBX 与 MDBX 存储。 - 并发模型: Kotlin Coroutines + Flow。
- 依赖装配: 通过构造函数、工厂及应用入口显式传递依赖。
- 安全能力: Android Keystore、EncryptedSharedPreferences、BiometricPrompt。
- 同步任务: WorkManager(
AutoBackupWorker)用于自动 WebDAV 备份。 - 协议与集成: Retrofit + OkHttp(Bitwarden API)、kotpass(KeePass)、sardine-android(WebDAV)。
安全模型
- 本地敏感字段: 由
SecurityManager使用 AES-256-GCM 认证加密。 - 本地主密码校验及 MDK 密码包装密钥:PBKDF2-HMAC-SHA256,1.0.327 新写入使用 600,000 次迭代。历史 100,000 次 PBKDF2 和 Argon2id 数据保留兼容,成功验证原密码后迁移,保留原 MDK 与记录密文。
- 便携加密备份:兼容 V1 使用 PBKDF2-HMAC-SHA256/100,000 次,增强 V2 使用 600,000 次;备份格式与本地主密码保护分别处理。
- 主密码找回:安全问题答案加本次系统锁屏凭据确认(Android 11+),一次性授权在取消、后台或锁定时撤销。新答案采用随机盐与 600,000 次 PBKDF2-HMAC-SHA256,旧 SHA-256 答案和备份保留兼容;尝试次数跨页面和进程重启保留。
- Bitwarden、KeePass 与 MDBX: 使用各自格式和配置规定的加密及密钥派生方式。
- 本地保护: 主密码哈希与安全配置由本地安全组件管理。
- 网络边界: 应用声明网络权限,用于 Bitwarden、WebDAV、OneDrive、局域网传输和更新检查等功能。
赞助支持
如果 Monica 对你有帮助,欢迎支持持续开发与安全投入。
微信 / 支付宝扫码支持
你的支持将优先用于:
- 安全审计与加密方案强化。
- Android 体验优化与稳定性改进。
- 跨端功能统一与文档维护。
爱发电鸣谢
感谢每一位支持 Monica 的朋友!
本月打赏金额:¥10.00
开发者信息
项目分层(代码现状)
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_ng: 自动填充服务与流程。takagi/ru/monica/passkey: Android 14+ Credential Provider 相关实现。takagi/ru/monica/workers: 后台任务(如自动 WebDAV 备份)。mdbx: Monica MDBX 本地数据库格式的 Rust workspace 与客户端接入文档。
主要组件(源码可验证)
- Android UI: Jetpack Compose, Material 3 Expressive, 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 + ZXing(二维码扫描), Credentials API(Passkey)。
构建与贡献
下表对应当前开发源码,不代表这些版本已包含在最新发布的 APK 中。
| 组件 | 当前源码配置 |
|---|---|
| 构建 JDK / Java 与 Kotlin 字节码 | JDK 17 / target 11 |
| Android SDK | compile 37 · target 34 · minimum 26(Android 8.0) |
| Gradle Wrapper / Android Gradle Plugin | 9.7.0 / 9.3.1 |
| Kotlin / KSP | 2.4.21 / 2.3.13 |
| Compose BOM | 2026.09.00 |
| Material 3 Expressive | 1.5.0-rc01,独立固定,不随 BOM |
| Room / Navigation Compose | 2.8.5 / 2.10.2 |
| Lifecycle Runtime 与 ViewModel | 2.11.0 |
| DataStore / WorkManager / CameraX | 1.3.0 / 2.12.0 / 1.6.2 |
使用与当前 AGP 兼容的 Android Studio,或直接运行 Gradle Wrapper。构建前准备 SDK Platform 37、Android NDK、Rust 和 cargo-ndk;JNI 库会从源码构建。
版本以依赖目录、Gradle Wrapper和应用构建配置为准。完整环境准备见 Android 构建说明。
cd "Monica for Android"
./gradlew :app:assembleDebug
./gradlew :app:testDebugUnitTest
# 为 x86_64 模拟器准备主包与设备测试包:
./gradlew :app:assembleDebug :app:assembleDebugAndroidTest -PincludeX86TestAbi
从仓库根目录进入 Android 工程后执行 Gradle 命令;Windows PowerShell 使用 ./gradlew.bat。默认 APK 面向 ARM;最后一条增加 x86_64 并打包测试 APK,不会自动运行设备测试。
欢迎通过 Issue / PR 参与功能和安全改进。
致谢
Monica 的设计、兼容性适配与部分功能方向,受到了以下优秀开源项目和软件的启发与帮助:
- AtomGit - 在国内托管 Monica,帮助中国大陆用户更快访问项目。
- Keyguard - Android 端密码管理器的交互设计与体验参考。
- PixelPlayer - Android 端密码库滚动条样式参考。
- Bitwarden - 开源密码管理生态、Vault 模型与同步能力的重要参考。
- KeePass - 本地密码库理念与
.kdbx生态兼容的重要基础。 - Stratum Auth - 身份验证器体验、图标资源与相关兼容支持参考。
- Steam Desktop Authenticator - Steam maFile 格式、Steam Guard 与交易确认兼容性的参考。
- steamguard-cli - Steam Guard 登录、令牌迁移与确认协议实现的参考。
- AnotherVaporAuth - Steam 移动验证器、登录批准与确认流程体验的参考。
友情链接
Star History
贡献者
社区与支持
- Telegram 群组:加入 Monica 社区
许可证
Copyright (c) 2025 JoyinJoester
Monica 基于 GNU General Public License v3.0 开源发布。
第三方图标标注
- 本项目本地打包了来自 Stratum Auth app 的图标资源(版本 v1.4.0,目录 icons / extraicons,GPL-3.0)。
- 银行卡/支付卡图标来源:SVG Credit Card & Payment Icons(Apache-2.0)。
- 品牌名称与 Logo 的商标权归各自权利人所有。
F-Droid contact
For F-Droid metadata or packaging issues, contact: [email protected]
HyperOS 参考项目与致谢
感谢以下开源项目对 Monica 的 HyperOS 兼容适配提供帮助:
- Howard20181/HyperPasskey(GPL-3.0):内置可选模块的部分 Hook 实现来源,包括安全中心配置重置拦截、系统设置页、凭据选择界面及跨设备兼容。
- dingwen07/CredentialProviderManager(GPL-3.0):凭据提供方、自动填充服务及系统配置诊断的设计参考。
- cr-zhichen/password-manager-switch(MIT):默认密码管理器配置工具的系统设置读写、校验与恢复逻辑来源。
具体参考版本与适配范围见HyperOS 来源说明;随包保留 HyperPasskey GPL-3.0 许可证及 password-manager-switch MIT 声明。1.0.328 的内置模块为实验功能,默认关闭,需要兼容的模块框架,尚未经过 HyperOS 实体机验证。
Shizuku default password manager / 默认密码管理器
The Android 14+ helper in developer and autofill settings adapts the secure-settings transaction logic from cr-zhichen/password-manager-switch (MIT, copyright 2026 cr-zhichen). It targets the installed Monica edition for the current Android user, verifies writes, and supports restoring the previous configuration. The original MIT notice is included in MIT notice.
开发者设置与自动填充设置中的 Shizuku 入口参考上述原项目(MIT),用于 HyperOS 隐藏第三方密码管理器设置入口的情况。仅设置当前 Monica 版本,不导入原项目的自更新等功能;系统设置读回成功不代表所有 HyperOS 通行密钥流程均已验证。
On multi-user devices, Shizuku may also require Monica to be installed for the owner user before starting the helper for a secondary user. Only the calling user settings are changed. 多用户设备上,Shizuku 可能需要主用户也安装 Monica 才能启动副用户的辅助服务;实际更改仍限定于调用用户。





