Skip to content

README_VI.md

Latest commit

 

History

History
209 lines (151 loc) · 10.4 KB

README_VI.md

File metadata and controls

209 lines (151 loc) · 10.4 KB
Raw

Kho Mat Khau Cuc Bo Monica

中文 | English | 日本語 | Tiếng Việt | Русский | 黑羽川

Monica App Icon

Kho mat khau uu tien local, ket noi Bitwarden va KeePass

Android / Browser · Local Vault · TOTP · WebDAV Backup

Lien ket ban be: Linux.do Linux.do

Release Downloads Last Commit QQ Group Telegram

Afdian Ko-fi PayPal
JoyinJoester%2FMonica | Trendshift

Monica la kho mat khau cuc bo tong hop Bitwarden va KeePass. Ung dung uu tien luu tru local, giup quan ly mat khau, 2FA, ghi chu bao mat va tep dinh kem tren Android va trinh duyet.

Du an nay co su ho tro cua AI. Hay tap tho quen sao luu du lieu thuong xuyen de tranh mat mat du lieu. Quyen rieng tu du lieu la vo gia, vi vay khong nen de tat ca du lieu cua ban nam trong chi mot ung dung.

Trang web: https://monica-pass.github.io/MonicaDocs/

Monica for Windows da duoc luu tru (archived). Ma nguon lich su: Monica-for-Windows

Monica for Browser da duoc luu tru (archived). Monica Extension moi dang duoc viet lai va phat trien tich cuc — hay don cho.

Hien tai du an chu yeu do mot minh toi duy tri, nen thoi gian va nguon luc deu rat gioi han. Vi vay, Monica for Wear tam thoi chua the duoc cap nhat lien tuc. Trong giai doan nay, toi se tap trung uu tien cho Monica for Android, bao gom hoan thien tinh nang, cai thien trai nghiem va duy tri do on dinh. Cam on ban da thong cam va ung ho.

Thong Tin Cho Nguoi Dung

Monica phu hop voi ai

  • Nguoi can quan ly mat khau local-first, khong muon phu thuoc hoan toan vao cloud.
  • Nguoi su dung ca du lieu Bitwarden va file KeePass (.kdbx).
  • Nguoi dung Android hang ngay va can autofill tren trinh duyet.

Gia tri ban nhan duoc

  • Kho du lieu ma hoa local cho dang nhap, the, thong tin dinh danh, ghi chu va tep.
  • Tich hop hai he sinh thai: Android co kha nang Bitwarden API/sync va doc-ghi KeePass (.kdbx).
  • Dong bo/backup tuy chon qua ha tang WebDAV cua chinh ban.
  • Quan ly TOTP tich hop trong cung mot ung dung.

Dinh dang co so du lieu local MDBX

MDBX la dinh dang vault ma hoa, uu tien local dang duoc Monica phat trien. No khong chi la mot bang mat khau; MDBX duoc thiet ke xoay quanh thu muc long nhau, tep dinh kem, lich su commit, phat hien xung dot, chuoi xoa tombstone, khoi phuc snapshot va cac che do bao mat Tiga.

Neu ban muon tich hop MDBX vao client khac, hay bat dau voi MDBX workspace README va MDBX client integration guide. Dac ta dinh dang day du nam trong mdbx/docs.

Cai dat nhanh

Android:

  1. Tai APK moi nhat tai Releases.
  2. Cai dat tren Android 8.0+ va khoi tao master password.

Tien ich trinh duyet (Chrome / Edge):

  1. Build tu Monica for Browser.
  2. Mo chrome://extensions/ va bat Developer mode.
  3. Chon Load unpacked va tro den thu muc dist.

Gioi han da biet

  • Do han che tuong thich he thong, Monica for Android hien tai khong the tao passkey tren mot so thiet bi Xiaomi HyperOS.

Trong Tam Android

Tinh nang cot loi

  • Vault local de luu tru thong tin dang nhap.
  • Nhap/tich hop du lieu KeePass va Bitwarden.
  • Tim kiem nhanh theo tieu de, domain va tag.
  • Mo khoa bang sinh trac hoc cua he thong Android.
  • Luu tru va sinh ma TOTP tap trung.

Chi tiet trien khai

  • UI: Jetpack Compose + Material 3 + Navigation Compose.
  • Data layer: Room (PasswordDatabase) + DAO + Repository.
  • Bat dong bo: Kotlin Coroutines + Flow.
  • DI: Koin (khoi tao trong MonicaApplication).
  • Bao mat: Android Keystore, EncryptedSharedPreferences, BiometricPrompt.
  • Nen task: WorkManager (AutoBackupWorker) cho auto backup WebDAV.
  • Giao thuc va tich hop: Retrofit + OkHttp (Bitwarden API), kotpass (KeePass), sardine-android (WebDAV).

Mo hinh bao mat

  • Ma hoa: AES-256-GCM (authenticated encryption).
  • KDF: PBKDF2-HMAC-SHA256 (tham so lap cao).
  • Bao ve local: hash master password va cai dat bao mat duoc quan ly tren thiet bi.
  • Ranh gioi mang: ung dung co khai bao quyen mang, chu yeu de tich hop Bitwarden va dong bo/backup WebDAV.

Ung Ho

Neu Monica huu ich cho ban, hay can nhac ung ho de duy tri phat trien va nang cap bao mat.

Support Monica
Ho tro qua WeChat / Alipay

Hỗ trợ Monica qua PayPal

Nguon ung ho duoc uu tien cho:

  • Tang cuong bao mat va kiem toan.
  • Cai tien UX va do on dinh tren Android.
  • Dong bo tinh nang da nen tang va bao tri tai lieu.

Ghi Chu Cho Nha Phat Trien

Cau truc ma nguon hien tai

  • takagi/ru/monica/ui: man hinh va thanh phan Compose.
  • takagi/ru/monica/data: entity Room, DAO, migration co so du lieu.
  • takagi/ru/monica/repository: lop truy cap du lieu.
  • takagi/ru/monica/security: ma hoa, quan ly khoa, logic xac thuc.
  • takagi/ru/monica/bitwarden: API, crypto, mapper, sync, viewmodel.
  • takagi/ru/monica/autofill: dich vu va luong autofill.
  • takagi/ru/monica/passkey: Credential Provider cho Android 14+.
  • takagi/ru/monica/workers: task nen nhu auto backup WebDAV.
  • mdbx: Rust workspace va tai lieu tich hop client cho dinh dang co so du lieu local Monica MDBX.

Thanh phan da duoc su dung (co the doi chieu trong repo)

  • Android UI: Jetpack Compose, Material 3, Navigation Compose.
  • Data va state: Room, DataStore Preferences, ViewModel.
  • Bao mat: Android Keystore, EncryptedSharedPreferences, BiometricPrompt.
  • Network va protocol: Retrofit, OkHttp, Kotlinx Serialization.
  • Dong bo va he sinh thai: sardine-android (WebDAV), kotpass (KeePass), tich hop Bitwarden API.
  • Bat dong bo va job: Coroutines, Flow, WorkManager.
  • Tinh nang bo sung: CameraX + ML Kit (quet QR), Credentials API (Passkey).

Build va dong gop

  • Android Studio: phien ban stable moi nhat.
  • JDK: 17+.
  • Cau hinh Android: compileSdk 35, targetSdk 34, minSdk 26 (xem Monica for Android/app/build.gradle).
  • Moc build Android: AGP 8.6.0, Kotlin 2.0.21, Compose BOM 2026.03.00 (Material3 dong bo theo BOM).
  • Nguon thong tin phien ban: Monica for Android/gradle/libs.versions.toml va Monica for Android/app/build.gradle.
  • Cong nghe browser: React + TypeScript + Vite (xem Monica for Browser/package.json).
  • Hoan nghenh dong gop qua Issue va PR.

Loi Cam On

Thiet ke, kha nang tuong thich va mot so dinh huong tinh nang cua Monica da nhan duoc nhieu cam hung va ho tro tu cac du an ma nguon mo va phan mem xuat sac sau:

  • Keyguard - tai lieu tham khao cho thiet ke tuong tac va trai nghiem nguoi dung cua trinh quan ly mat khau Android.
  • Bitwarden - nguon tham khao quan trong cho he sinh thai quan ly mat khau ma nguon mo, mo hinh vault va kha nang dong bo.
  • KeePass - nen tang cho triet ly local vault va kha nang tuong thich voi he sinh thai .kdbx.
  • Stratum Auth - tham khao ve trai nghiem authenticator, tai nguyen icon va cac ho tro tuong thich lien quan.
  • Steam Desktop Authenticator - tham khao ve dinh dang Steam maFile, Steam Guard va kha nang tuong thich xac nhan giao dich.
  • steamguard-cli - tham khao ve dang nhap Steam Guard, chuyen authenticator va trien khai giao thuc xac nhan.
  • AnotherVaporAuth - tham khao ve Steam mobile authenticator, phe duyet dang nhap va trai nghiem xac nhan.

Star History

Star History Chart

Dong Gop Vien

Dong Gop Vien

Cong Dong Va Ho Tro

Giay Phep

Copyright (c) 2025 JoyinJoester

Monica duoc phat hanh theo GNU General Public License v3.0.

Ghi Chu Ve Bieu Tuong Ben Thu Ba