ctdozlite README

README проекта с github.com/ctdoteam1110/ctdozlite. Одним файлом markdown: README.md.

ctdozlite

Tiếng Việt · English · 한국어 · 日本語 · 简体中文

Client Zalo Desktop viết bằng Rust (eframe/egui + ratatui), giao tiếp trực tiếp với hệ thống API và WebSocket của Zalo Web/PC mà không qua Electron hay Chromium.

Chưa rõ tính năng bạn cần đã hoạt động chưa? Đọc Tính năng & giới hạn trước khi mở issue — bảng đó ghi rõ cái gì đang chạy, cái gì chỉ chạy một phần và issue nào đang theo dõi.

[!NOTE] Tuyên bố miễn trừ trách nhiệm (Disclaimer): Dự án này là một nghiên cứu kỹ thuật hệ thống độc lập mã nguồn mở vì mục đích học tập, giáo dục và tương thích giao thức (Educational & Interoperability Research Purposes Only). Dự án KHÔNG có bất kỳ mối liên hệ, hợp tác, tài trợ hay bảo trợ nào từ VNG Corporation hay Zalo, và hoàn toàn phi thương mại (100% mã nguồn mở, không thu phí, không quảng cáo, không bán dữ liệu, không có bất kỳ hình thức kiếm tiền nào).

Để hiểu định dạng gói tin và luồng ký request, nhóm phát triển có thực hiện phân tích tĩnh (static analysis) trên gói cài đặt công khai của Zalo và các thư viện native đi kèm. Kết quả chỉ dùng để viết lại độc lập bằng Rust — không sao chép, không tái phân phối mã máy, mã nguồn JS/WASM hay tài nguyên đồ hoạ/âm thanh nào của Zalo. Chi tiết và giới hạn đầy đủ ở mục Phân tích tĩnh & tài nguyên bên thứ ba.

Người dùng tự chịu mọi trách nhiệm khi sử dụng phần mềm này. Website Release CI & Release Rust Platform License: MIT OR Apache-2.0

Giao diện ctdozlite Native trên Windows


Tổng quan

Bản Zalo PC chính thức đóng gói trên Electron thường chiếm 350–600 MB RAM khi chạy nền. ctdozlite được viết lại từ đầu bằng Rust dựa trên phân tích luồng giao thức của Zalo Web/PC (zpw_ver=694, zpw_type=30), tập trung vào tốc độ phản hồi, mức tiêu thụ tài nguyên thấp và khả năng đóng gói thành một binary duy nhất.

Chỉ số thực tế Zalo PC 26.10.11 (Electron) ctdozlite (Rust Native — Kết quả đo mới nhất)
RAM khi chờ (Working Set) 1.800 – 1.975 MB ~156,1 MB khi chờ / ~162,1 MB khi nạp đầy đủ DB & hội thoại (Private: ~61,6 – 80,4 MB, tiết kiệm >91% RAM)
Số tiến trình chạy nền 7 tiến trình 1 tiến trình duy nhất
Kích thước file thực thi ~136 MB ~47,6 MB (Windows release giữ PE symbols tránh false-positive Defender; ~17,2 MB khi strip symbols)
Thời gian khởi chạy cửa sổ 2.5 – 4.0s ~0,04 – 0,15 giây (< 160ms warm start)
Phụ thuộc runtime Chromium, Node.js Native binary thuần (ffmpeg tùy chọn nếu gọi video)

Kết quả đo thực tế mới nhất (cập nhật sau khi tích hợp thêm Wasmtime Sync v2, Rhai Scripting & Document Preview) trên Windows 11 (Intel Core i7-12700H, PowerShell Get-Process WorkingSet64 & PrivateMemorySize64, đo trung vị sau 15 giây chạy ổn định ở bản --release). Ở chế độ phát triển (debug --dev --gui), Working Set dao động khoảng ~213,8 – 239,5 MB.


Các tính năng chính


Cấu trúc & Quy mô mã nguồn (Codebase LoC — Kết quả đo mới nhất v0.1.1)

Hạng mục Số tệp Tổng số dòng
Rust Source (src/**/*.rs) 56 80,962
Integration Tests (tests/*.rs) 5 1,803
Tài liệu & Kiến trúc (docs/*.md, README*) 29 2,125
Đóng gói & CI/CD (packaging/, .github/) 22 1,161

Số liệu đo thực tế mới nhất tại phiên bản v0.1.1 (tổng cộng hơn 86,050+ dòng mã nguồn, bài kiểm thử, tài liệu và quy trình CI/CD).

src/ (80,962 lines across 56 files)
├── main.rs            # (369 lines)    Điểm vào CLI, phân tích tham số (--gui, --tui, --dev, --profile, --proxy)
├── lib.rs             # (50 lines)     Khai báo các module thư viện
├── chat.rs            # (10,068 lines) API hội thoại, tin nhắn, nhóm, RTF/Markdown, link preview & tìm kiếm sticker
├── call.rs            # (5,254 lines)  Báo hiệu VoIP, điều khiển phiên gọi 1-1 và bắt tay ZRTP
├── gui.rs             # (4,432 lines)  Khởi tạo trạng thái ZaloGuiApp, bộ lọc, đồng bộ & vòng lặp sự kiện
├── store.rs           # (3,618 lines)  Lưu trữ SQLite theo từng tài khoản (accounts/<uin>_history.db)
├── media.rs           # (3,238 lines)  Đóng gói/giải mã RTP/RTCP, H.264 FU-A và luồng webcam/video
├── tui.rs             # (2,689 lines)  Giao diện dòng lệnh (ratatui)
├── session.rs         # (1,888 lines)  Quản lý phiên, cookie jar (zpw_sek), khóa (zpw_enk), proxy & multi-profile
├── history_sync.rs    # (1,287 lines)  Đồng bộ lịch sử, giải mã RSA 2048 + AES-256 + LZMA2 & Sync v2 Curve25519
├── feed.rs            # (1,153 lines)  Hồ sơ mạng xã hội & đọc Nhật ký từ SQLite cục bộ
├── reactions.rs       # (1,097 lines)  Quản lý trạng thái thả cảm xúc (reaction) tin nhắn
├── zproto_host.rs     # (1,022 lines)  Wasmtime host chạy module libzproto_wasm giải mã Sync v2 di động
├── updater.rs         # (917 lines)    Tự động kiểm tra, tải và xác thực chữ ký/SHA-256 bản cập nhật GitHub
├── api_mcp.rs         # (911 lines)    Máy chủ HTTP REST API cục bộ & giao thức MCP (JSON-RPC 2.0)
├── audio.rs           # (692 lines)    Thu/phát âm thanh thời gian thực (cpal + libopus)
├── thread_script.rs   # (629 lines)    Engine kịch bản tự động hóa hội thoại (Rhai scripting)
├── unread.rs          # (627 lines)    Theo dõi bộ đếm tin nhắn chưa đọc và trạng thái tắt thông báo (mute)
├── voip_log.rs        # (625 lines)    Ghi nhận chẩn đoán luồng gói tin RTP/RTCP (voip.log)
├── socket.rs          # (624 lines)    Kết nối WebSocket thời gian thực (zpw_ws)
├── scheduler.rs       # (539 lines)    Bộ lập lịch gửi tin nhắn hẹn giờ & nhắc hẹn cục bộ
├── media_resources.rs # (447 lines)    Quản lý bộ nhớ đệm tài nguyên đa phương tiện & ảnh
├── doc_preview.rs     # (Xem trước trực tiếp tài liệu PDF, Word DOC/DOCX, Excel XLS/XLSX/XLSB/ODS, PowerPoint PPT/PPTX, CSV/TSV/RTF)
├── group_stats.rs     # (442 lines)    Thống kê hoạt động và tương tác trong nhóm chat
├── qr.rs              # (436 lines)    Luồng sinh mã QR, long-polling chờ quét và xác nhận đăng nhập
├── data_dir.rs        # (379 lines)    Phân giải thư mục dữ liệu đa nền tảng (--data-dir / --profile)
├── login.rs           # (367 lines)    Đăng nhập mật khẩu (PasswordCipher), getServerInfo, getLoginInfo
├── native_notifications.rs # (361 lines) Thông báo native desktop (Windows toast, macOS, Linux notify)
├── message_model.rs   # (321 lines)    Mô hình định danh và hợp nhất trạng thái tin nhắn
├── clipboard_dib.rs   # (292 lines)    Đọc ảnh bitmap trực tiếp từ Windows clipboard (CF_DIB)
├── logger.rs          # (254 lines)    Bộ thu thập log mạng và quét mã lỗi cho chế độ --dev
├── os_notify.rs       # (248 lines)    Điều phối thông báo hệ điều hành đa nền tảng
├── group_llm.rs       # (241 lines)    Tóm tắt và hỗ trợ phân tích nội dung nhóm
├── param_cipher.rs    # (222 lines)    Mã hóa tham số xác thực ParamCipher v2 (zcid, zcid_ext, encrypt_key)
├── message_navigation.rs # (142 lines) Điều hướng nhanh tới tin nhắn trích dẫn trong hội thoại
├── crypto.rs          # (132 lines)    AES-128/256-CBC, PKCS7, MD5 và hàm tạo chữ ký signkey
├── account_manager.rs # (131 lines)    Quản lý đa tài khoản, lưu và chuyển đổi profile tức thì
├── group_watch.rs     # (119 lines)    Theo dõi sự kiện và từ khóa trong nhóm
├── clock.rs           # (109 lines)    Đồng hồ hiển thị thời gian và trạng thái hệ thống
├── ui.rs              # (97 lines)     Thành phần UI chia sẻ giữa các giao diện
├── endpoints.rs       # (47 lines)     Bảng định tuyến các domain máy chủ Zalo (Service Map)
├── bin/               # (1,851 lines across 8 diagnostic/CLI probe binaries)
└── gui/               # Giao diện đồ họa native (eframe/egui — 32,148 lines)
    ├── modals.rs      # (9,899 lines)  Trang Danh bạ, Nhật ký, Hẹn giờ, Cài đặt, Quản lý tài khoản & Cuộc gọi
    ├── workspace.rs   # (9,399 lines)  Bố cục thanh điều hướng, cột chat, auto-scroll & khung chat chính
    ├── worker.rs      # (4,758 lines)  Luồng nền Tokio xử lý lệnh mạng, đồng bộ và prefetch ảnh/sticker
    ├── messages.rs    # (4,755 lines)  Render bong bóng tin nhắn, Markdown/RTF, reaction, quote, ảnh clipboard
    ├── stickers.rs    # (1,779 lines)  Sticker picker, auto-suggest & bộ lọc nhãn dán
    ├── theme.rs       # (1,330 lines)  Bảng màu Dark/Light, vector icon Lucide, nạp font hệ thống
    └── reactions_dialog.rs # (228 lines) Hộp thoại hiển thị chi tiết danh sách người thả cảm xúc

Tải bản cài đặt dựng sẵn

Toàn bộ gói cài đặt cho từng hệ điều hành và bản phân phối Linux nằm tại GitHub Releases. Trang này luôn hiển thị bản mới nhất, không cần sửa link khi phát hành phiên bản tiếp theo.

Hướng dẫn cài đặt chi tiết (Linux, Windows, macOS Apple Silicon arm64 / Intel x86_64 / Universal .dmg, kiểm tra SHA-256 và gỡ cài đặt): docs/CAI_DAT.md.

[!IMPORTANT] Phiên bản iOS — Dùng 1 tài khoản Zalo song song trên 2 máy (Sắp ra mắt): Bản iOS của ctdozlite hoạt động dưới dạng phiên phụ (zpw_type=30), cho phép đăng nhập và sử dụng chung 1 tài khoản Zalo song song trên 2 máy điện thoại mà không làm văng thiết bị chính. Hiện tại tài khoản Apple Developer của mình vừa bị Apple thu hồi chứng chỉ và phần giao diện cảm ứng chưa hoàn thiện trọn vẹn, nên gói .ipa sẽ sớm được bổ sung trong bản cập nhật tới.


Tự biên dịch từ mã nguồn (Windows / Linux / macOS)

1. Yêu cầu chung

Nếu máy dùng CMake 4.0+ gặp lỗi kiểm tra phiên bản tối thiểu trong opus-sys, đặt biến môi trường CMAKE_POLICY_VERSION_MINIMUM=3.5 khi chạy cargo build.

2. Windows (MSVC)

Cài đặt Visual Studio Build Tools (chọn Desktop development with C++ và CMake tools for Windows):

winget install Gyan.FFmpeg
git clone https://github.com/ctdoteam1110/ctdozlite.git
cd ctdozlite
$env:CMAKE_POLICY_VERSION_MINIMUM = "3.5"
cargo build --release

Binary đầu ra: target\release\ctdozlite.exe

3. Linux (Debian / Ubuntu / Fedora / Arch)

Cài đặt các gói thư viện hệ thống cho âm thanh (ALSA) và cửa sổ (X11 / Wayland / GTK3):

Biên dịch:

git clone https://github.com/ctdoteam1110/ctdozlite.git
cd ctdozlite
CMAKE_POLICY_VERSION_MINIMUM=3.5 cargo build --release

Binary đầu ra: target/release/ctdozlite

4. macOS (Apple Silicon ARM64 & Intel x86_64)

xcode-select --install
brew install cmake ffmpeg
git clone https://github.com/ctdoteam1110/ctdozlite.git
cd ctdozlite
cargo build --release

Binary đầu ra: target/release/ctdozlite (Tự động liên kết tĩnh libopus.a qua .cargo/config.toml + packaging/macos/toolchain-*.cmake, không cần cài opus rời qua Homebrew).


Sử dụng

Chạy giao diện đồ họa (GUI - mặc định)

./target/release/ctdozlite --gui

Chạy giao diện dòng lệnh (TUI)

./target/release/ctdozlite --tui --qr

Chế độ chẩn đoán giao thức (Dev Inspector)

./target/release/ctdozlite --gui --dev

Đăng xuất và xóa phiên

./target/release/ctdozlite --logout

Đóng gói đa nền tảng (CI/CD)

Workflow GitHub Actions tại .github/workflows/ci-release.yml tự động chạy cargo test, đóng gói và phát hành lên GitHub Releases khi đẩy tag v*:


Phiên bản & Phát hành

Cargo.toml là nguồn phiên bản duy nhất (version = "x.y.z"). Workflow đọc giá trị này và dùng nó cho mọi tên gói cài, metadata .deb/.rpm, bộ cài Windows, Info.plist và release. Không sửa số phiên bản ở nơi khác.

Quy trình phát hành:

  1. Cập nhật version trong Cargo.toml, chạy cargo check để làm mới Cargo.lock.
  2. Merge thay đổi vào main.
  3. Tạo tag v<version> trỏ tới một commit trên main rồi push tag. CI sẽ build, test và publish release; phần mô tả release được GitHub tự sinh từ các PR đã merge.

CI từ chối phát hành nếu tag không khớp Cargo.toml hoặc commit của tag không nằm trên main.

Lịch sử phát hành và ghi chú thay đổi: GitHub Releases.


Tài liệu chi tiết


Lưu ý bảo mật


🏆 Key Contributors

Dự án ghi nhận các thành viên có đóng góp mã nguồn tiêu biểu trực tiếp vào repository:

Contributor GitHub Đóng góp chính Khối lượng
TIPC1110 @TIPC1110 Kiến trúc lõi, VoIP call engine, egui framework, Danh bạ & Nhật ký Social, đa nền tảng & phát hành v0.0.6 – v0.1.2 > 75,600+ lines
Đỗ Trung Thành (thanhdo1110) @thanhdo1110 Kiến trúc GUI modular, Atom One Dark, MCP/REST API, Hẹn giờ tin nhắn, Auto-Update GitHub API, xử lý 20+ Issues & đồng phát hành v0.0.5 – v0.1.2 > 35,100+ lines 🏆
Thuong Tin @thuongtin Loạt 10 PRs: Múi giờ OS, tùy biến data-dir, helpers macOS, session atomic, media cache, updater, message state, định danh tin nhắn (#61), điều hướng trích dẫn (#60), quyền thông báo macOS (#59) > 11,500+ lines 🏆
ngxccc @ngxccc Loạt 5 PRs: Tiêu chuẩn kỹ thuật, bảo toàn session an toàn, phân giải domain mạng > 3,400+ lines
GrootTheDeveloper @GrootTheDeveloper Loạt 8 PRs: Tối ưu khởi động SQLite, đồng bộ lịch sử nhóm/Cloud (#45), poll timer worker (#46), virtualization chat, lazy load Font CJK ~950+ lines
Tuyến Trần (gr219) @gr219 PR #85 (chờ sự kiện file_done), PR #99 (sửa lỗi spawn helper ETXTBSY), PR #125 (hiển thị biệt danh bạn bè), PR #127 (đính kèm nhiều tệp & album ảnh dạng lưới), PR #145 (nạp trực tiếp Sync V2 WASM từ Zalo PC app.asar, khắc phục #147) > 1,400+ lines 🏆
Leoaxo098 @Leoaxo098 PR #97: Khóa ô nhập liệu khi thành viên bị hạn chế quyền chat trong nhóm ~180+ lines
hoanglong149 @hoanglong149 PR #78, #121, #136, #137, #143, #144: Giải mã Sync v2 WASM, chống thu hồi (#79, #141), thông báo OS, tối ưu CPU/RAM (#135), Console TUI + LLM Agent + cầu nối Telegram ↔ Zalo > 3,500+ lines 🏆
Đỗ Mạnh Cường (cuongdm75) @cuongdm75 PR #105 & PR #134: Chọn thư mục tải về native, tùy chỉnh UI trực tiếp, trả lời trích dẫn (quote-reply), chuyển tiếp tin nhắn & bảo toàn URL thẻ liên kết (#88, #89) > 8,500+ lines 🏆
Trần Đức Thịnh (Fin12n) @Fin12n PR #132 & PR #148: Thiết kế lại thẻ tập tin (file cards), sửa phát video trực tiếp, tinh chỉnh UI/UX toàn diện & giải mã Sync V2 protobuf > 6,500+ lines 🏆
Nguyễn Văn Trãi (TraiNguyenVan) @TraiNguyenVan PR #93: Khôi phục sự kiện bộ gõ tiếng Việt IME composition trên Linux (X11/Wayland) (#86, #101, #112) > 2,600+ lines
ducseul @ducseul PR #142: Menu chuyển đổi đa tài khoản (Multi-Account Switcher), thông báo nền tài khoản phụ, tách biệt media cache theo UIN, bật SQLite WAL & bảo toàn mốc đã đọc > 1,500+ lines

Ghi chú: Toàn bộ danh sách vinh danh mọi cá nhân đóng góp (báo lỗi, đề xuất tính năng, pull request) được cập nhật công khai tại trang Người đóng góp.

👉 Nhấn vào đây để xem toàn bộ danh sách 117 người đóng góp (Community & GitHub)
# Người đóng góp Hạng mục Đóng góp chi tiết
0 @gr219 GitHub PR PR #85: fix(chat): chờ sự kiện file_done trước khi gửi đính kèm tập tin bất đồng bộ (asyncfile/msg), khắc phục triệt để lỗi HTTP 405 trên nút 📎.
1 Le Nhat Lỗi crash Báo cáo lỗi văng app nghiêm trọng khi thực hiện tìm kiếm tên liên hệ hoặc hội thoại trên Windows 11.
2 Ken Đoàn Đồng bộ Báo lỗi bấm nút đồng bộ nhưng mãi không đồng bộ được tin nhắn cũ từ máy chủ Zalo.
3 Nguyễn Vang Độ ổn định Thử nghiệm bản phát hành đầu tiên và phản hồi về độ ổn định trong quá trình duy trì kết nối chat.
4 Không Là Gì Cả Tính năng Đề xuất chức năng backup tin nhắn và ảnh qua Telegram, vì Zalo tự xóa ảnh sau 1 năm làm mất ảnh kỷ niệm. Tác giả đã đồng ý ('oce bác').
5 Tuấn Anh Pham Quyền riêng tư Đề xuất chặn trạng thái 'Đã xem' (Seen) và ẩn đang gõ (Typing); sau đó bổ sung đề nghị thêm tuỳ chỉnh theme. Tác giả xác nhận đã có tính năng nhưng chưa có thời gian kiểm chứng.
6 Khoai Possible macOS Thử nghiệm bản dựng cho hệ điều hành macOS (Apple Silicon ARM64, Intel x86_64 & Universal DMG) và phản hồi trải nghiệm.
7 So Dep Thanh Nam iOS Đề xuất phát triển phiên bản iOS và lưu ý ưu tiên khả năng tương thích với các máy iOS đời thấp.
8 Xanh Chín iOS Bày tỏ nhu cầu trải nghiệm client Zalo gọn nhẹ trên hệ sinh thái Apple iOS.
9 Huy Nguyen iOS Đề xuất mở rộng ctdozlite sang nền tảng iOS và thảo luận về tính bảo mật mã nguồn mở trên di động.
10 Nguyễn Đức Huy Android Đề xuất phát triển phiên bản client mã nguồn mở gọn nhẹ cho các thiết bị Android.
11 Trương Công Huy Phản hồi Đánh giá cao chất lượng và tính đột phá của ứng dụng ctdozlite.
12 Dân Bách Phong Phản hồi Động viên và tương tác tích cực với dự án ngay từ những giờ đầu phát hành v0.0.1.
13 Vũ Minh Khang Kết nối Giới thiệu bạn bè và cộng đồng kỹ thuật tham gia kiểm thử phần mềm.
14 Nam Khánh Thử nghiệm Tham gia đánh giá chất lượng trải nghiệm của client Rust so với bản web.
15 Bùi Phương Tìm hiểu Thảo luận về cơ chế hoạt động và cách thức cài đặt ứng dụng.
16 Trương Ngọc Khánh Tương tác Tương tác, theo dõi và đóng góp phản hồi trong bài viết công bố sản phẩm.
17 Nhat Nguyen Lỗi crash Bản cài Win 11 gặp 5 vấn đề: phải End Task trong Task Manager mới thoát được app; bấm đồng bộ nhưng không thấy tin nhắn; luôn hiển thị online ở mọi user; gọi đi không được; không bật được camera khi video call. Sẵn sàng test tiếp cho tác giả.
18 Nguyễn Vĩnh Huy Kiến trúc Trao đổi về cách một tài khoản đăng nhập song song 2 thiết bị: nhiều khả năng client trên máy thứ hai dùng slot của bản Zalo Web.
19 Giao Chung Phản hồi Khen chất lượng sản phẩm dù bản thân đã ngừng sử dụng Zalo.
20 Nguyen Hoa Theo dõi Theo dõi và chờ đợi các bản cập nhật tiếp theo của ctdozlite.
21 Nguyễn Thành Công Android Hưởng ứng đề xuất phát triển bản Android và tham gia thảo luận về nhu cầu đa nền tảng.
22 Ngô Hoàng Trọng Tín Tính năng Xin khôi phục lại bộ icon con mèo trong giao diện. Bình luận nhận được 20 lượt thả tim, nhiều người dùng quan tâm.
23 Sơn Minh Định hướng Đề nghị cân nhắc phát triển lâu dài để tính năng chạy tốt và mượt mà; nếu có thời gian thì thử viết lại toàn bộ backend theo hướng thay thế Zalo, và cam kết sẽ đóng góp nếu làm.
24 Nguyễn Lợi Tính năng Đề xuất làm thêm bản Telegram vì bản chạy nền hiện đã ăn tới 1GB RAM.
25 Tiến Bộ Thử nghiệm Dự định thử nghiệm trên macOS; nhận xét bản chuẩn thì nặng, bản basic dùng ctdozlite, khi cần tác vụ nặng thì quay lại bản chuẩn.
26 Giang Tran Vu Kinh nghiệm Cho AI reverse-engineer để viết lại bằng Rust kèm Liquid Glass, treo máy liên tục khoảng 7 giờ thì hoàn thành.
27 Hoàng Sanh Động viên Dành lời khen và động viên tác giả sau khi dùng thử sản phẩm.
28 Trần Văn Quốc iOS Bày tỏ mong đợi bản phát hành dành cho iOS.
29 Cốn Cái Lò Kiến trúc Tham gia trao đổi về cách một tài khoản đăng nhập song song trên hai thiết bị.
30 Mai Anh Tuan Cảnh báo Nhận xét sản phẩm chưa ổn và lưu ý tác giả cẩn thận về vấn đề luật sở hữu trí tuệ.
31 Jason Wu Tương tác Tham gia bình luận, trao đổi cùng cộng đồng dưới bài phát hành.
32 Phúc Lỗi macOS Hỏi phiên bản macOS tối thiểu; dùng Sonoma trên máy Intel thì không mở được ứng dụng. Tác giả đã trả lời: cần chip Apple Silicon (chip M).
33 Dương Phản hồi Bình luận tương tác dưới bài phát hành, nhận 8 lượt thả tim.
34 Nguyen Quang Huy iOS Bày tỏ mong đợi bản phát hành cho iOS.
35 Phan Quoc Trieu Đa nền tảng Đề nghị nghiên cứu thêm chức năng cho iPhone và các dòng máy Android khác để dùng được đa thiết bị.
36 Minh Phung iOS Mong bản iOS có và hỗ trợ được cả các dòng iPhone đời cũ.
37 Le Quang Huy Kiến trúc Nhận xét cơ chế này giống việc một bên dùng app còn một bên dùng nền web.
38 Trung Minh Tính năng Đề xuất làm luôn tính năng chat từ Telegram tới bạn bè bên Zalo, để không phải mở ứng dụng Zalo nữa.
39 Thanh Dev Kỹ thuật Hỏi lại cách dùng AI để reverse-engineer, mở ra một chuỗi trao đổi kỹ thuật có giá trị trong phần bình luận.
40 Ngoc Do Kỹ thuật Xin prompt để dùng AI reverse-engineer; được tác giả khác chia sẻ lại quy trình chi tiết gồm đọc file cài, so sánh với bản gốc và thảo luận chéo giữa các model.
41 Hoa Thiên Lý Động viên Cho biết sẽ tải ứng dụng về dùng chỉ vì bộ icon con mèo được nhắc trong bình luận.
42 Nguyễn Duy Khánh Ủng hộ Hưởng ứng đề xuất khôi phục bộ icon con mèo của Ngô Hoàng Trọng Tín.
43 Cao Nhật Minh Bình luận Đưa ra góc nhìn so sánh giữa Zalo và dự án mã nguồn mở trong phần bình luận.
44 Subaru Wrx Bảo mật Đặt câu hỏi về rủi ro bảo mật: lưu lịch sử chat vào SQLite cục bộ thì có dễ bị thu thập dữ liệu hay không.
45 Phạm Hoàn Định hướng Bình luận mới nhất trong bài: cho rằng sản phẩm hay và cần được phát triển thêm tính năng.
46 Long Nguyễn Góp ý Trao đổi với Ngô Hoàng Trọng Tín về việc có 3 gói và một số gói bị gỡ tính năng.
47 Ông An Bà Ngân (@OngAnBaNgan) GitHub Issue Issue #34: Rủi ro pháp lý về thương hiệu & bản quyền từ VNG và đề xuất hướng khắc phục
48 @maiminhdung GitHub Issue Issue #33: Lỗi phông chữ ở mục đăng nhập Zalo, không hiển thị trên tên/logo app ở chuyển tab
49 Ngoc Tran (@ngxccc) GitHub PR Issue #32: fix(ui): trạng thái online đang đặt cứng — mọi hội thoại 1-1 đều hiện chấm xanh / Issue #27: task(net): try multiple host candidates per endpoint instead of one verified constant / Issue #23: fix(ui): "Đồng bộ tin nhắn" only refreshes previews — rename, show real progr
50 Trung Nguyễn (@trungnt1000vn) GitHub Issue Issue #31: Issue trên MacOS version đầu
51 @DEWE-ex GitHub Issue Issue #24: Lỗi (windows) và đề xuất tính năng
52 Hà Trung Triển (@T1st-isme) GitHub Issue Issue #10: Đồng bộ tin nhắn
53 khoasoma (@Khoasoma) GitHub Issue Issue #9: Cập nhật thứ tự nhắn tin sai , không hiện nhóm , tin nhắn được ghim lên đầu nên thêm tự import tin nhắn từ folder có sẵn ( migrate )
54 @slothteabar GitHub Issue Issue #8: Không có tên nhóm, không đồng bộ được đoạn chat cũ + Lỗi UI cài đặt. Win11
55 Ruiseki (@Shigure-Ruiseki) GitHub Issue Issue #7: [Feature Request] Thêm API hỗ trợ Dev Plugin và Theme
56 @Nghia323223 GitHub Issue Issue #6: Không thể hiển thị được chữ
57 @heroes1412 GitHub Issue Issue #5: k hiển thị dc chữ tàu, k hiển thị dc ảnh, group nhiều thành viên bị chớp chớp???
58 Nguyen Huu Tung (@tinzisreal) GitHub Issue Issue #4: Hiện không đúng giờ
59 Đỗ Quang Minh (@shinishiho) GitHub Issue Issue #3: session.json, TUI và đồng bộ tin nhắn / Issue #2: CI release version
60 Võ Duy Ân (@duyan0) GitHub Issue Issue #1: Bug UI
61 @vuhuymicrosoft-bot GitHub PR PR #28: Add macOS x86_64 build to CI workflow
62 @quangnguyenn98 GitHub PR PR #26: ci(macos): build native Intel (x86_64) .dmg alongside Apple Silicon
63 Ông An Bà Ngân (@OngAnBaNgan) GitHub Issue Issue #34: Rủi ro pháp lý về thương hiệu & bản quyền từ VNG và đề xuất hướng khắc phục (Disclaimer, không đóng gói tài nguyên bản quyền, cam kết phi thương mại).
64 @maiminhdung GitHub Issue Issue #33: Báo lỗi phông chữ ở mục đăng nhập và không hiển thị tên/logo ứng dụng khi chuyển tab trên Nobara Linux 44 (GNOME Wayland).
65 Thuong Tin (@thuongtin) GitHub 10 PRs (> 11,500 LoC) Tác giả của 10 Pull Requests quan trọng: PR #40 (múi giờ OS), PR #41 (--data-dir), PR #51 (macOS native helpers), PR #52 (session atomic save), PR #53 (media cache & admission), PR #54 (transactional updater), PR #55 (message state & reactions), PR #59 (macOS notification permissions), PR #60 (quote message navigation), PR #61 (exact message identity deduplication). Đóng góp hơn 11,500 dòng code.
66 Dang Phuc An Khang (@GrootTheDeveloper) GitHub 8 PRs (#43–#50, ~950 LoC) Đóng góp loạt 8 Pull Requests tối ưu hóa & đồng bộ: Sửa query tin nhắn mới nhất (#43), Tăng tốc mở app với SQLite lớn (#44), Đồng bộ lịch sử nhóm & Cloud (#45), Chuyển poll timer sang worker (#46), Virtualize danh sách chat (#47), Lazy load Font CJK (#48), Sửa icon Windows GNU (#49), Thu nhỏ dung lượng binary release (#50).
67 Đỗ Trung Thành (@thanhdo1110 / DO TRUNG THANH) Core Maintainer (> 35,100 LoC) Tái cấu trúc GUI modular, thiết kế Atom One Dark, xây dựng MCP Server & HTTP REST API, hệ thống hẹn giờ gửi tin nhắn, tự động cập nhật qua GitHub Releases API, sửa lỗi trùng tên hội thoại (#63), giải quyết triệt để hơn 20 GitHub Issues và phát hành bản v0.0.5.
68 @congnvp GitHub Issue Issue #35: Đề xuất bổ sung máy chủ HTTP REST API cục bộ và giao thức MCP (Model Context Protocol).
69 @vuduc810 GitHub Issue Issue #38: Đề xuất tính năng hẹn giờ gửi tin nhắn (Schedule message) tự động.
70 @thedtvn GitHub Issue Issue #58: Báo cáo chi tiết lỗi Windows Defender nhận diện nhầm bộ cài setup.exe v0.0.3 là Trojan (False Positive), giúp team khắc phục triệt để trong v0.0.4.
71 @buildertv GitHub Issue Issue #63: Báo cáo lỗi gộp nhầm tin nhắn và nhảy sai hội thoại khi hai tài khoản Zalo có tên hiển thị trùng nhau.
72 Trần Đức Thịnh (@Fin12n) GitHub PRs (#132, #148) Đóng góp PR #132 & PR #148 (> 6,500 LoC): Thiết kế lại thẻ tập tin đính kèm, sửa phát video trực tiếp, tinh chỉnh toàn diện UI/UX và nâng cấp bộ giải mã Sync V2 protobuf.
73 Đỗ Mạnh Cường (@cuongdm75) GitHub PRs (#105, #134) Đóng góp PR #105 & PR #134 (> 8,500 LoC): Hộp thoại chọn thư mục tải về native, tùy chỉnh giao diện trực tiếp, trả lời trích dẫn (quote-reply), chuyển tiếp tin nhắn/thẻ liên kết (rich link forward fallback) và đề xuất đổi font chữ giao diện (#88), sửa @mention (#89).
74 Nguyễn Văn Trãi (@TraiNguyenVan) GitHub PR (#93) PR #93 (> 2,600 LoC): Khôi phục sự kiện bộ gõ tiếng Việt IME composition trên Linux (X11/Wayland), giải quyết triệt để lỗi mất dấu tiếng Việt (#86, #101, #112).
75 @ducseul GitHub PR (#142) PR #142 (> 1,500 LoC): Xây dựng menu chuyển đổi đa tài khoản (Multi-Account Switcher), thông báo nền cho tài khoản phụ, tách biệt media cache theo từng UIN, bật SQLite WAL và bảo toàn mốc đã đọc.
76 @hoanglong149 GitHub PRs (#78, #121, #136) Đóng góp chuỗi PR #78, #121, #136 và xử lý loạt vấn đề trọng tâm: Chống thu hồi tin nhắn (#79, #141), giải mã Sync v2 di động qua WASM, thông báo OS banner, tin nhắn tự hủy (vanish), tin nhắn thoại và tối ưu hóa CPU/RAM khi chờ (#135).
77 @Leoaxo098 GitHub PR (#97) PR #97: Khóa thanh soạn thảo khi thành viên bị giới hạn quyền nhắn tin trong nhóm cộng đồng.
78 Nguyen Truong (@nguyenhoclaptrinh) GitHub Issue Issue #147: Báo cáo chi tiết kèm log chẩn đoán lỗi đồng bộ tin nhắn từ điện thoại (Sync V2) và đồng bộ Cloud/Nhóm trên bản v0.1.1.
79 Tom (@vudubai-2026) GitHub Issue Issue #146: Báo cáo lỗi thông báo tin nhắn đã đọc bị hiển thị lặp lại khi khởi động lại ứng dụng trên Arch Linux.
80 Lucian Duong (@Lean-Duong) GitHub Issues Issue #130, #131, #141, #147: Đề xuất xác nhận trước khi đăng xuất & đăng nhập nhanh tài khoản đã lưu (#130), sửa lỗi phóng to/cắt xén avatar mặc định (#131), kiểm thử và cung cấp kịch bản chi tiết giúp khôi phục tính năng chống thu hồi tin nhắn Anti-Recall (#141) và đồng bộ điện thoại (#147).
81 @waynenguyen2212 GitHub Issue Issue #135: Báo cáo lỗi ngốn 100% CPU trên MacBook Air 2020 (Core i3), giúp team phát hiện và tối ưu hóa chu kỳ relayout/filter ở PR #136.
82 @Dragon-pixel-archive GitHub Issue Issue #128: Báo cáo lỗi hiển thị và trùng lặp trạng thái khi đồng bộ tin nhắn.
83 @Trinity030-dev GitHub Issues Issue #109, #117, #118, #119, #122: Chuỗi báo cáo lỗi hiển thị ảnh trong tin nhắn gửi (#118), giữ nguyên trạng thái đã đọc khi mở lại app (#119) và chặn gửi lại thông báo cũ khi khởi động (#122).
84 Nguyen Van Huy (@nguyenvanhuy0612) GitHub Issue Issue #116: Phát hiện nguyên nhân lỗi đồng bộ tin nhắn điện thoại do đường dẫn WASM bị cố định trong sync_v2_helper.js.
85 lk (@lttkiet) GitHub Issues Issue #95 & #115: Báo cáo lỗi tải nội dung tin nhắn sau đồng bộ trên openSUSE (GUI) và đồng bộ danh sách hội thoại trong chế độ TUI trên Ubuntu Server 22.04 LTS.
86 TìmAI (@timaivn) GitHub Issue Issue #112: Báo cáo lỗi gõ tiếng Việt trên Debian 13 KDE Wayland.
87 @fouze555 GitHub Issue Issue #111: Báo cáo lỗi liên kết (URL) không hiển thị trong nội dung tin nhắn.
88 @clockertron GitHub Issue Issue #108: Báo cáo lỗi đồng bộ tin nhắn trên phiên bản mới.
89 SRKK (@SanRocKk2005) GitHub Issue Issue #107: Báo cáo lỗi không mở/xem được liên kết trực tiếp trên Windows 10.
90 @LeCmnGend GitHub Issue Issue #106: Báo cáo lỗi không đổi được thư mục lưu dữ liệu trong phần Cài đặt.
91 Bùi Việt Sơn (@vietsonbui) GitHub Issue Issue #103: Báo cáo lỗi quản lý và chuyển đổi đa tài khoản.
92 @UhhhhOkayyyy GitHub Issues Issue #94 & #102: Báo cáo lỗi xem video trực tiếp trong tin nhắn, tạo nhắc hẹn (reminder), âm thanh thông báo và thả cảm xúc.
93 @baodinhgia2011github GitHub Issue Issue #101: Báo cáo lỗi bộ gõ tiếng Việt trên Linux.
94 Lê Bá Dũng (@lebad280324) GitHub Issue & PRs Issue #100 & PR #104, #113: Báo cáo lỗi đồng bộ tin nhắn trên macOS Apple Silicon và đóng góp thử nghiệm bản dựng macOS ARM64.
95 @phamducit2005-bot GitHub Issues Issue #80 & #98: Đề xuất tính năng lưu nhanh nhiều tài khoản (#80) và hoàn thiện trả lời tin nhắn trích dẫn, thả cảm xúc, âm thanh thông báo (#98).
96 @Lexus101987 GitHub Issue Issue #91: Báo cáo lỗi đổi ngôn ngữ, đường dẫn thư mục tải về và đồng bộ tin nhắn.
97 Truong Thanh Hieu (@ubuntu2310fake) GitHub Issue Issue #87: Báo cáo lỗi đồng bộ trạng thái ghim tin nhắn trên Zalo.
98 @toilinh237 GitHub Issue Issue #86: Báo cáo lỗi thiếu icon dưới thanh dock Ubuntu 26.04 và tương thích bộ gõ tiếng Việt.
99 @Saphira8585 GitHub Issue Issue #81: Báo cáo lỗi trạng thái gửi tin nhắn ban đầu.
100 Anbui (@amm119) GitHub Issue Issue #74: Báo cáo lỗi tập tin tải về bị đổi tên mất tên gốc.
101 Zuqikee (@Zqw1k) GitHub Issue Issue #68: Đề xuất tính năng đồng bộ tin nhắn trực tiếp từ điện thoại về máy tính.
102 @Harry-Huy GitHub Issue Issue #67: Báo cáo lỗi trạng thái tắt thông báo (mute/unmute) chưa đồng bộ với Zalo PC chính thức.
103 @lhbkhanh801-a11y GitHub Issue Issue #64: Đề xuất bổ sung cấu hình Proxy để sử dụng nhiều tài khoản Zalo trên PC.
104 @Kesitinh13524 & @luuquangduy-tech GitHub Issue Issue #147: Tham gia phản hồi, cung cấp ảnh chụp màn hình và kiểm chứng lỗi đồng bộ tin nhắn từ điện thoại & Cloud.
105 @ziq3 GitHub PR (#154) PR #154: Khắc phục tình trạng phát lại thông báo reaction cũ mỗi lần mở lại ứng dụng.
106 @bqqhuy GitHub PR (#92) PR #92: Kiểm tra định dạng Windows clipboard DIB layouts khi dán ảnh từ clipboard.
107 @zt-hky GitHub PR (#90) PR #90: Hỗ trợ dán ảnh clipboard vào khung soạn tin trên macOS.
108 @esvm4 GitHub PR (#65) PR #65: Thêm tùy chọn thu nhỏ xuống khay hệ thống (close-to-tray) trên Linux.
109 @cypherdo37 GitHub PRs (#37, #39) PR #37, #39: Đề xuất tích hợp bot kiểm tra chất lượng PR tự động trong CI.
110 @quangthoai1985 GitHub PRs (#69, #70) PR #69, #70: Đóng góp nghiên cứu tính năng media & phát hành v0.1.2.
111 @dinhhanh37k14-code GitHub Issue (#138) Issue #138: Báo cáo tổng hợp lỗi tag tên, ghim tin, thu hồi và chia sẻ tệp.
112 @ngthzuan GitHub Issue (#123) Issue #123: Báo cáo lỗi vỡ layout khung chat trên màn hình nhỏ (responsive).
113 @LKW1989-kw GitHub Issue (#110) Issue #110: Đề xuất thêm mã khóa bảo vệ riêng tư cho ứng dụng Zalo.
114 @Subgeneric GitHub Issue (#83) Issue #83: Đề xuất hỗ trợ nhập (import) lịch sử chat trực tiếp từ Zalo PC chính thức.
115 @nguyenphuong10102003 GitHub Issue (#73) Issue #73: Báo cáo lỗi tự động đồng bộ tin nhắn từ điện thoại khi đăng nhập.
116 @bao2222-hub, @NahXD, @dangvusns GitHub Issues (#66, #82, #120) Tham gia mở issue báo cáo lỗi và kiểm thử các phiên bản sớm trên GitHub.

🙏 Lời cảm ơn & Ghi công (Acknowledgements)

ctdozlite xin bày tỏ lòng biết ơn sâu sắc tới VNG Corporation và đội ngũ phát triển Zalo — những người đã xây dựng nên một nền tảng nhắn tin tuyệt vời, phục vụ hàng chục triệu người dùng Việt Nam.

Về mục đích dự án

Về phân tích tĩnh & tài nguyên bên thứ ba

Về quyền riêng tư dữ liệu

Về khả năng gỡ bỏ

Nếu VNG Corporation hoặc đại diện hợp pháp của Zalo có bất kỳ yêu cầu nào liên quan đến dự án này (bao gồm nhưng không giới hạn: yêu cầu gỡ bỏ, đổi tên, hoặc điều chỉnh nội dung), vui lòng liên hệ trực tiếp qua GitHub Issues hoặc email của maintainer. Chúng tôi cam kết phản hồi trong vòng 72 giờ và tuân thủ mọi yêu cầu chính đáng.

Tóm lại: Chúng tôi vô cùng biết ơn VNG và đội ngũ Zalo đã tạo ra một sản phẩm tuyệt vời. Dự án này chỉ là nỗ lực học tập của một nhóm nhỏ các lập trình viên yêu thích Rust và muốn hiểu sâu hơn về hệ thống nhắn tin hiện đại. Nếu có bất kỳ điều gì chưa đúng, chúng tôi sẵn sàng lắng nghe và sửa đổi.

Giấy phép

Phân phối dưới giấy phép kép MIT OR Apache-2.0. Dự án phục vụ mục đích học tập và nghiên cứu kỹ thuật hệ thống với Rust.

ctdozlite (ctdoteam1110/ctdozlite)

Ищем в базе…

Что это такое?ctdozlite — это легковесный нативный настольный клиент для Zalo (вьетнамского мессенджера), написанный на Rust с использованием eframe/egui и ratatui. Он напрямую работает с API и WebSocket Zalo Web/PC, а не использует Electron или Chromium.
Это официальное приложение Zalo или неофициальный клон?Это независимая реализация с открытым исходным кодом, созданная путём реверс-инжиниринга протокола Zalo Web/PC исключительно в образовательных целях и для исследования совместимости. Она не связана с VNG Corporation или Zalo.
Как установить и запустить?Скачайте готовый пакет для вашей ОС со страницы GitHub Releases (.deb/.rpm/.AppImage/.tar.gz для Linux, установщик .exe или портативная версия для Windows, .dmg для macOS ARM64/Intel/Universal) или соберите его сами с помощью Cargo, если у вас установлен Rust.
Работают ли все функции Zalo?Не гарантируется. В README есть отдельная страница «Features & Limitations», где отслеживается, что работает полностью, что работает частично и что пока числится в открытых задачах. Сборка для iOS ещё не выпущена из-за отозванного сертификата Apple Developer.
Работает ли на Mac с Apple Silicon и Intel, а также в разных дистрибутивах Linux?Да. Сборки есть для Apple Silicon (ARM64), Intel (x86-64) и универсальный DMG для macOS, а также установщики для Windows и пять форматов пакетов для Linux (стандартный и legacy .deb, .rpm, .AppImage, .tar.gz), которые подходят для Debian, Ubuntu, Fedora, RHEL, Arch и других дистрибутивов.
Куда попадают мои переписки и история чатов?История сообщений и данные сессии хранятся только локально (база SQLite zalohistory.db, а также файлы threadscache.json и session.json). Приложение не отправляет данные ни на какие сторонние серверы, кроме собственных систем Zalo.
Насколько он легче официального приложения Zalo для ПК?В Windows 11 ctdozlite в простое занимает около 149,5 МБ оперативной памяти в одном процессе, тогда как официальное приложение Zalo для ПК на базе Electron занимает 1 800–1 975 МБ в 7 процессах. Запускается он примерно за 0,18 с вместо 2,5–4 с.
Можно ли совершать голосовые и видеозвонки?Да. Сигнализация звонков и рукопожатие ZRTP-ретрансляции Zalo реализованы заново на Rust без зависимости от ZaloCall.exe; для аудио используются cpal и opus, для видео H.264 — ffmpeg.
Можно ли пользоваться им по SSH без графического интерфейса?Да. Помимо графического интерфейса на egui, есть терминальный интерфейс (TUI) на базе ratatui. В нём можно перемещаться стрелками или клавишами j/k, отправлять сообщения клавишей Enter и выходить клавишей q.
Предлагает ли он вьетнамские стикеры, как настоящее приложение Zalo?Да. Пока вы печатаете, он параллельно обращается к эндпоинтам подсказок и поиска стикеров Zalo и находит совпадения во вьетнамском тексте как с диакритическими знаками, так и без них, а также распространённые сокращения вроде 'tks', 'hpbd' и 'g9'.
Какие есть похожие проекты?exodium, course2md, zapfast, lap, zulu, ImageGlass, SpartanPort, dbdelve
Автор
ctdoteam1110
Размер
11.7 MB
Звёзды
356
Возраст
28 д
Коммиты · 90 дней