Skip to content
프로젝트

ctdoteam1110/ctdozlite has 357 GitHub stars and 153 forks. GitHot measured +2 stars in 24 hours. Last checked 2026-11-18 02:04 UTC. Last push 2026-11-15.

이 수치를 측정하는 방법

측정된 스타 증가

in 24h
+2
in 7 days
업데이트 지연
in 15 days
업데이트 지연
in 1 month
업데이트 지연

서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.

소개

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.

개발 도구

docs/i18n/README_KO.md

Original

ctdozlite

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

Electron이나 Chromium 없이 Rust(eframe/egui + ratatui)로 제작되어 Zalo Web/PC API 및 WebSocket과 직접 통신하는 순수 Rust 기반 Zalo 데스크톱 클라이언트입니다.


⚡ 주요 특징

  • 초고속 Rust 성능: 0.18초 초고속 콜드 스타트 (<200ms), 대기 상태 RAM 약 149.5 MB (공식 Electron 앱 1.81.9 GB 대비 92% 이상 절감), 1개 단일 네이티브 프로세스, 유휴 CPU 0%에 근접.
  • 완벽한 크로스 플랫폼 지원: Windows 10/11 (MSVC & GNU), macOS (Apple Silicon arm64 & Intel x86_64 Universal), Linux (Debian, Ubuntu, Fedora Wayland/X11).
  • 듀얼 모드 지원: 풀 피처 GUI (Atom One Dark 테마) 및 터미널 기반 TUI (ratatui).
  • VoIP 음성 및 영상 통화: 순수 Rust로 구현된 VoIP 엔진 (Annex-B H.264 디코딩, RTP/RTCP 프로토콜, Opus 오디오 리샘플링 지원).
  • 보안 및 프라이버시: 로컬 SQLite 데이터베이스 (zalo_history.db) 저장, --data-dir를 통한 데이터 경로 지정 가능, 외부 원격 분석(Telemetry) 0%.

📥 다운로드 및 설치

GitHub Releases에서 사전 빌드된 바이너리를 다운로드할 수 있습니다:

운영체제 패키지 형태 설치 방법
Windows .exe 설치 프로그램 / 포터블 .zip 설치 파일 실행 또는 압축 해제 후 ctdozlite.exe 실행
macOS Universal .dmg (Apple Silicon & Intel) .dmg 마운트 후 ctdozlite.app을 /Applications로 드래그
Linux .deb / .rpm / .AppImage / .tar.gz 패키지 매니저로 설치하거나 chmod +x 실행 권한 부여 후 직접 실행

CLI 명령어 옵션

옵션 설명 실행 예시
--data-dir <PATH> 세션, 데이터베이스, 캐시, 로그 저장 경로 직접 지정 ctdozlite --data-dir ./my-data --gui
--print-data-dir 사용 중인 데이터 디렉터리 경로 출력 후 즉시 종료 ctdozlite --print-data-dir
--gui 그래픽 사용자 인터페이스(GUI) 모드로 실행 (기본값) ctdozlite --gui
--tui 터미널 콘솔(TUI) 모드로 실행 ctdozlite --tui
--qr TUI 모드 시작 즉시 로그인 QR 코드 생성 요청 ctdozlite --tui --qr
--logout 저장된 세션 로그아웃 및 삭제 후 종료 ctdozlite --logout
--version / -V 버전 정보 출력 후 즉시 종료 (데이터 폴더 미생성) ctdozlite --version

🛠️ 소스 코드 빌드 방법

사전 요구사항

  • Rust 툴체인: Stable Rust (1.80+ 권장, rustup으로 설치).
  • 시스템 종속성:
    • Linux: libasound2-dev, libfontconfig1-dev, libx11-dev, libxcursor-dev, libxi-dev, libgl1-mesa-dev, ffmpeg.
    • Windows / macOS: 표준 C 툴체인 및 ffmpeg (영상/음성 통화용).
# 리포지토리 클론
git clone https://github.com/ctdoteam1110/ctdozlite.git
cd ctdozlite

# 릴리스 바이너리 빌드
cargo build --release

# GUI 실행
./target/release/ctdozlite --gui

🏆 주요 기여자 (Key Contributors)

리포지토리에 핵심 코드를 기여한 대표 개발자 명단:

기여자 GitHub 주요 역할 기여 규모
TIPC1110 @TIPC1110 핵심 아키텍처, VoIP 통화 엔진, egui 프레임워크, 연락처 및 소셜 피드, 크로스 플랫폼 및 v0.1.0 릴리스 > 75,600+ 줄
Đỗ Trung Thành (thanhdo1110) @thanhdo1110 모듈형 GUI 리팩터링, Atom One Dark, MCP/REST API, 예약 메시지, GitHub API 자동 업데이트, 25+ 이슈 해결 및 v0.1.0 릴리스 > 35,600+ 줄 🏆
Thuong Tin @thuongtin 10개 PR: OS 타임존, 데이터 디렉터리, macOS 헬퍼, 세션 원자적 저장, 미디어 캐시, 업데이터, 메시지 모델, 메시지 고유 식별자 중복 방지 (#61), 인용 메시지 이동 (#60), macOS 알림 권한 (#59) > 11,500+ 줄 🏆
ngxccc @ngxccc 5개 PR: 엔지니어링 표준 수립, 세션 안전성 확보, 네트워크 도메인 확인 > 3,400+ 줄
GrootTheDeveloper @GrootTheDeveloper 8개 PR: SQLite 빠른 시작 최적화, 그룹/클라우드 기록 동기화(#45), 워커 폴 타이머(#46), 채팅 가상화, CJK 폰트 지연 로딩 ~950+ 줄

참고: 버그 제보, 기능 제안, PR을 포함한 모든 기여자의 전체 명단은 기여자 명예의 전당에서 확인하실 수 있습니다.



🙏 감사의 말

ctdozlite는 베트남 수천만 사용자에게 서비스를 제공하는 뛰어난 메신저 플랫폼을 만든 VNG Corporation과 Zalo 개발팀에게 깊은 감사를 표합니다.

프로젝트 목적

  • 본 프로젝트는 단 하나의 목적을 위해 존재합니다: 학습 및 시스템 엔지니어링 연구, 즉 현대 메신저 애플리케이션이 네트워크 프로토콜, 암호화, 네이티브 데스크톱 아키텍처 계층에서 어떻게 동작하는지 이해하는 것입니다.
  • 모든 소스 코드는 Rust로 처음부터 작성되었습니다. 패킷 프레이밍, 요청 서명, 파라미터 인코딩 방식을 이해하기 위해 관리자는 공개 배포된 Zalo 설치 패키지와 함께 제공되는 네이티브 라이브러리에 대한 정적 분석(열람 및 디컴파일)을 수행했습니다. 그 결과는 독립적 재구현을 위한 참고 자료로만 사용되었으며, Zalo의 기계어 코드, JS/WASM 소스, .so, .dex, APK 파일은 본 저장소에 복사·삽입·재배포되지 않습니다. 분석용으로 풀어둔 디렉터리(xapk_extracted/, test_lab/)는 저장소 밖에 있으며 커밋되지 않습니다.
  • 제3자 저작물 고지: src/assets/ami_fat_cat/ 에 포함된 스티커 세트는 제3자(원작자)의 저작물입니다. VNG/Zalo의 자산이 아니며 당사는 이에 대한 어떠한 권리도 주장하지 않습니다. UI 테스트 목적으로만 포함되었고, 권리자의 요청이 있으면 즉시 삭제합니다.
  • 당사는 Zalo 상표, 로고 또는 VNG의 지식재산권을 소유하지 않으며 소유권을 주장하지 않습니다. Zalo라는 이름은 본 소프트웨어가 어떤 서비스의 프로토콜과 호환되는지를 설명하기 위한 서술적 용도로만 사용됩니다.
  • 본 프로젝트는 완전히 비상업적입니다: 100% 오픈 소스, 요금 없음, 광고 없음, 데이터 판매 없음.

데이터 프라이버시

  • 모든 메시지와 사용자 데이터는 사용자 컴퓨터에 로컬로 저장됩니다 (zalo_history.db, session.json, threads_cache.json).
  • 애플리케이션은 관리자 서버나 제3자에게 어떤 데이터도 전송하지 않습니다. 유일한 네트워크 연결은 브라우저로 chat.zalo.me에 접속할 때와 동일하게 공식 Zalo 시스템으로 향합니다.

삭제 요청 정책

VNG Corporation 또는 Zalo의 권한 있는 대리인이 본 프로젝트와 관련하여 어떠한 요청(삭제, 이름 변경, 내용 조정 등)을 하시려면 GitHub Issues 또는 관리자 이메일로 연락해 주시기 바랍니다. 당사는 72시간 이내에 답변하고 모든 정당한 요청을 준수할 것을 약속합니다.

요약: VNG와 Zalo 팀이 훌륭한 제품을 만들어 주신 것에 깊이 감사드립니다. 본 프로젝트는 Rust를 사랑하고 현대 메신저 시스템을 더 깊이 이해하고자 하는 소규모 개발자 그룹의 학습 노력일 뿐입니다.

📜 라이선스

이 프로젝트는 MIT OR Apache-2.0 듀얼 라이선스 하에 배포됩니다. 본 프로젝트는 순수 학술 및 시스템 프로그래밍 연구 목적으로 개발되었습니다.