Monica

KO | EN

gitlite — search

#hacktoberfest #llm #golang #machine-learning #rust #deep-learning #linux #awesome #cli #kubernetes #awesome-list #pytorch #security #mcp

(★ 921)

Monica Pass，Password Management, 2FA Generator

Monica Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">Monica 本地密码库</h1>

聚合 Bitwarden 与 KeePass 的本地优先密码库
Android / Browser · Local Vault · TOTP · WebDAV Backup

友情链接：
	<a href="https://linux.do" title="Linux.do">
		<img src="https://www.google.com/s2/favicons?domain=linux.do&sz=64" alt="Linux.do" width="22" />
		Linux.do
	</a>

[![Release](https://img.shields.io/github/v/release/Monica-Pass/Monica-for-Android?style=flat-square)](https://github.com/Monica-Pass/Monica-for-Android/releases)
[![Downloads](https://img.shields.io/github/downloads/Monica-Pass/Monica-for-Android/total?style=flat-square)](https://github.com/Monica-Pass/Monica-for-Android/releases)
[![Last Commit](https://img.shields.io/github/last-commit/Monica-Pass/Monica-for-Android?style=flat-square)](https://github.com/Monica-Pass/Monica-for-Android/commits)
[![QQ群](https://img.shields.io/badge/QQ群-1087865010-12B7F5?style=flat-square&logo=tencentqq&logoColor=white)](https://qm.qq.com/q/2vTdTkHV3u)
[![Telegram](https://img.shields.io/badge/Telegram-Monica%20Community-26A5E4?style=flat-square&logo=telegram&logoColor=white)](https://t.me/+IZUDLL-vWOA1Y2U1)

[![爱发电](https://img.shields.io/badge/爱发电-JoyinJoester-ea4aaa?style=flat-square)](https://afdian.com/a/JoyinJoester)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-joyinjoester-29ABE0?style=flat-square&logo=kofi&logoColor=white)](https://ko-fi.com/joyinjoester)
[![PayPal](https://img.shields.io/badge/PayPal-Support%20Monica-FFD140?style=flat-square&logo=paypal&logoColor=00457C)](https://www.paypal.com/ncp/payment/BHSYWK73CA8FW)
 
<a href="https://trendshift.io/repositories/27059" target="_blank"><img src="https://trendshift.io/api/badge/repositories/27059" alt="JoyinJoester%2FMonica | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

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

### 重要的事：
Monica Pass的开发者就是一个大啥比，现在他为了偷懒连代码都很少review了，还在群里说“反正ai写的比我好，我还不如ai呢”，大家不要相信这种人开发的软件，一定要好好的做好备份，数据隐私无价！不要把所有数据都放到这一个软件里面

官网入口: https://monica-pass.github.io/MonicaDocs/

> Monica for Windows 已归档。历史代码见: [Monica-for-Windows](https://github.com/JoyinJoester/Monica-for-Windows)
>
> Monica for Browser 已归档。新的 Monica Extension 正在重写开发中，敬请期待。
>
> 由于目前项目主要由我一人维护，时间与精力都比较有限，因此 Monica for Wear 暂时无法保持持续更新。现阶段我会将主要重心放在 Monica for Android 的功能完善、体验优化与稳定性维护上，也感谢大家的理解与支持。

---

## 用户先看

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

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

### MDBX 本地数据库格式
MDBX 是 Monica 正在推进的本地优先加密 vault 格式。它不是简单的密码表，而是围绕嵌套文件夹、附件、提交历史、冲突检测、tombstone 删除链路、快照恢复和 Tiga 安全模式设计的数据库格式。

如果你要在其他客户端接入 MDBX，请先读 [MDBX workspace 说明](mdbx/README.md) 和 [MDBX 客户端接入指南](mdbx/CLIENT_INTEGRATION_GUIDE.zh-CN.md)。完整格式规范在 [mdbx/docs](mdbx/docs/README.zh-CN.md)。

### 快速安装

Android:
1. 从 [Releases](https://github.com/Monica-Pass/Monica-for-Android/releases) 下载最新 APK。
2. 在 Android 8.0+ 设备安装并初始化主密码。

浏览器插件 (Chrome / Edge):
1. 在 `Monica for Browser` 目录构建插件。
2. 打开 `chrome://extensions/` 并启用开发者模式。
3. 选择“加载已解压的扩展程序”，导入 `dist` 目录。

### 已知限制
- 由于系统兼容性原因，Monica for Android 目前在部分小米 HyperOS 设备上无法创建通行密钥（Passkey）。

---

## 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 对你有帮助，欢迎支持持续开发与安全投入。

<div align="center">
<img src="image/support_author.jpg" alt="Support Monica" width="320"/>
 
微信 / 支付宝扫码支持
</div>

你的支持将优先用于:
- 安全审计与加密方案强化。
- Android 体验优化与稳定性改进。
- 跨端功能统一与文档维护。

### 爱发电鸣谢

感谢每一位支持 Monica 的朋友！

**本月打赏金额：¥10.00**

<table>
<tbody>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="1503384107"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="1503384107" width="56" height="56" /></a> 1503384107 ¥180.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="名字太长会有傻子跟着念吗"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="名字太长会有傻子跟着念吗" width="56" height="56" /></a> 名字太长会有傻子跟着念吗 ¥20.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="洛初"><img src="https://pic1.afdiancdn.com/user/user_upload_osl/a3a8b7f7e037e52e0ce6a9251964a78c_w132_h132_s7.jpeg" alt="洛初" width="56" height="56" /></a> 洛初 ¥15.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="御坂07833号"><img src="https://pic1.afdiancdn.com/user/e40f486c7bb911ee8ca25254001e7c00/avatar/f4c8da76d80fd5a7cd276f6b5d7a6a54_w300_h300_s61.jpeg" alt="御坂07833号" width="56" height="56" /></a> 御坂07833号 ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_vR9n"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_vR9n" width="56" height="56" /></a> 爱发电用户_vR9n ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_ff493"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_ff493" width="56" height="56" /></a> 爱发电用户_ff493 ¥10.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_a991e"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_a991e" width="56" height="56" /></a> 爱发电用户_a991e ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_U9rq"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-blue.png" alt="爱发电用户_U9rq" width="56" height="56" /></a> 爱发电用户_U9rq ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_d4f2c"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_d4f2c" width="56" height="56" /></a> 爱发电用户_d4f2c ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_edaa4"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_edaa4" width="56" height="56" /></a> 爱发电用户_edaa4 ¥10.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="海之南"><img src="https://pic1.afdiancdn.com/user/8a041df8860411edb23752540025c377/avatar/dad5974d3fca49d1aca5835d6818ea98_w2064_h2016_s3434.png" alt="海之南" width="56" height="56" /></a> 海之南 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="重逢海风"><img src="https://pic1.afdiancdn.com/user/886243ac044b11edad3752540025c377/avatar/f50842fe3af48d89f4dfe2b95e2a4c66_w690_h647_s46.jpg" alt="重逢海风" width="56" height="56" /></a> 重逢海风 ¥5.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="yagaojun"><img src="https://pic1.afdiancdn.com/user/b3c6a738350e11ed8f3752540025c377/avatar/2322f1ee3d40356f3d97a4e93d0b4bb2_w1080_h1080_s91.jpeg" alt="yagaojun" width="56" height="56" /></a> yagaojun ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="可恶"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="可恶" width="56" height="56" /></a> 可恶 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_97324"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_97324" width="56" height="56" /></a> 爱发电用户_97324 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Jursin"><img src="https://pic1.afdiancdn.com/user/user_upload_osl/34d612b1c80939392ab74bae307ae41a_w132_h132_s6.jpeg" alt="Jursin" width="56" height="56" /></a> Jursin ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Memories white"><img src="https://pic1.afdiancdn.com/user/152f9a2c797011eba47252540025c377/avatar/505d7046fd33ebae8ff1af167177ef20_w800_h800_s409.jpeg" alt="Memories white" width="56" height="56" /></a> Memories white ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_hAKP"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png" alt="爱发电用户_hAKP" width="56" height="56" /></a> 爱发电用户_hAKP ¥5.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="森王"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-orange.png" alt="森王" width="56" height="56" /></a> 森王 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_43357"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_43357" width="56" height="56" /></a> 爱发电用户_43357 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="坏名字qwq"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="坏名字qwq" width="56" height="56" /></a> 坏名字qwq ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Draking"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-yellow.png" alt="Draking" width="56" height="56" /></a> Draking ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="希莉卡"><img src="https://pic1.afdiancdn.com/user/fd7a69c6e64c11f0b3cb52540025c377/avatar/5a619e16a1e05c140e7b838b556e0ca1_w1024_h1280_s179.jpeg" alt="希莉卡" width="56" height="56" /></a> 希莉卡 ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="airem"><img src="https://pic1.afdiancdn.com/user/26696d60ee9111ee832a5254001e7c00/avatar/1267d3f1a84cc1d6b6ea9e7ae4bac522_w791_h791_s327.jpeg" alt="airem" width="56" height="56" /></a> airem ¥5.00</td></tr>
<tr><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="Janson"><img src="https://pic1.afdiancdn.com/user/ad16e57c584511ef8a9152540025c377/avatar/d318e7eb2a040a0e53696a38eb982e52_w160_h160_s4.png" alt="Janson" width="56" height="56" /></a> Janson ¥5.00</td><td align="center" width="120"><a href="https://afdian.com/a/JoyinJoester" title="爱发电用户_0e739"><img src="https://pic1.afdiancdn.com/default/avatar/avatar-purple.png?imageView2/1/" alt="爱发电用户_0e739" width="56" height="56" /></a> 爱发电用户_0e739 ¥5.00</td></tr>
</tbody>
</table>

---

## 开发者信息

### 项目分层（代码现状）
- `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 备份）。
- `mdbx`: Monica MDBX 本地数据库格式的 Rust workspace 与客户端接入文档。

### 当前已使用的成熟组件（仓库可验证）
- 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 配置: `compileSdk 35`，`targetSdk 34`，`minSdk 26`（见 `Monica for Android/app/build.gradle`）。
- Android 构建基线: AGP `8.6.0`，Kotlin `2.0.21`，Compose BOM `2026.03.00`（Material3 跟随 BOM）。
- 版本信息以 `Monica for Android/gradle/libs.versions.toml` 与 `Monica for Android/app/build.gradle` 为准。
- 浏览器端技术栈: React + TypeScript + Vite（见 `Monica for Browser/package.json`）。
- 欢迎通过 Issue / PR 参与功能和安全改进。

---

## 致谢

Monica 的设计、兼容性适配与部分功能方向，受到了以下优秀开源项目和软件的启发与帮助：

- [Keyguard](https://github.com/AChep/keyguard-app) - Android 端密码管理器的交互设计与体验参考。
- [Bitwarden](https://bitwarden.com/) - 开源密码管理生态、Vault 模型与同步能力的重要参考。
- [KeePass](https://keepass.info/) - 本地密码库理念与 `.kdbx` 生态兼容的重要基础。
- [Stratum Auth](https://github.com/stratumauth/app) - 身份验证器体验、图标资源与相关兼容支持参考。
- [Steam Desktop Authenticator](https://github.com/Jessecar96/SteamDesktopAuthenticator) - Steam maFile 格式、Steam Guard 与交易确认兼容性的参考。
- [steamguard-cli](https://github.com/dyc3/steamguard-cli) - Steam Guard 登录、令牌迁移与确认协议实现的参考。
- [AnotherVaporAuth](https://github.com/freefrank/AnotherVaporAuth) - Steam 移动验证器、登录批准与确认流程体验的参考。

---

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=Monica-Pass/Monica-for-Android&type=Date)](https://star-history.com/#Monica-Pass/Monica-for-Android&Date)

---

## 贡献者

![贡献者](https://raw.githubusercontent.com/Monica-Pass/Monica/main/.github/assets/contributor-flag.svg)

---

## 社区与支持

- Telegram 群组：[加入 Monica 社区](https://t.me/+IZUDLL-vWOA1Y2U1)

---

## 许可证

Monica 基于 [GNU General Public License v3.0](LICENSE) 开源发布。

## 第三方图标标注

- 本项目本地打包了来自 [Stratum Auth app](https://github.com/stratumauth/app) 的图标资源（版本 [v1.4.0](https://github.com/stratumauth/app/releases/tag/v1.4.0)，目录 [icons](https://github.com/stratumauth/app/tree/v1.4.0/icons) / [extraicons](https://github.com/stratumauth/app/tree/v1.4.0/extraicons)，GPL-3.0）。
- 银行卡/支付卡图标来源：本地目录 [SVG Credit Card & Payment Icons](svg-credit-card-payment-icons-main)（Apache-2.0）。
- 品牌名称与 Logo 的商标权归各自权利人所有。

Monica

Monica Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Monica

Monica Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README