Skip to content
KitploitKITPLOIT
도구블로그
제출
도구블로그
제출

해킹, 침투 테스트 및 사이버 보안 도구를 당신의 보안 무기고에!

Kitploit은 해킹, 사이버 보안 및 침투 테스트 도구 디렉토리입니다. 최신 프로젝트 업데이트를 발견하여 취약점을 찾고, 시스템을 분석하고, 테스트를 자동화하고, 보안을 강화하세요.

··피드·문의·개인정보·© 2026 Kitploit

도구 디렉토리

카테고리

모든 카테고리 보기
Loading categories
telegram-history-dump — 증분 지원, 다양한 출력 형식(JSON, HTML, 일반 텍스트) 및 telegram-cli 원격 제어를 통한 미디어 다운로드를 제공하는 Telegram 채팅 로그 백업 | Kitploit
도구/GitHubGitHub/tvdstaaij/telegram-history-dump
OSINT (Open Source Intelligence)Data ExfiltrationInformation GatheringUtilities & Frameworks
GitHubtvdstaaij/telegram-history-dump

telegram-history-dump

증분 지원, 다양한 출력 형식(JSON, HTML, 일반 텍스트) 및 telegram-cli 원격 제어를 통한 미디어 다운로드를 제공하는 Telegram 채팅 로그 백업

저장소 보기
678837년 전Kitploit 검토 완료

인기

모두 보기 →

커뮤니티에서 가장 많이 사용되는 도구를 찾아보세요.

모든 도구 탐색

도구 컬렉션을 둘러보세요

모든 도구 보기 →
공유

telegram-history-dump

이 유틸리티는 telegram-json-backup의 후속 버전으로, Ruby로 처음부터 작성되었습니다. telegram-cli의 원격 제어 기능을 사용하여 Telegram 사용자 및 (슈퍼)그룹 대화의 백업을 생성할 수 있습니다.

이전 프로젝트와 비교하여 telegram-history-dump는:

  • 미디어 다운로드 지원이 개선됨
  • JSON 외의 출력 형식을 지원하며 사용자 정의 형식으로 확장 가능
  • 증분 백업 지원 (새 메시지만 다운로드)
  • telegram-cli 내의 불안정한 Python/Lua 바인딩에 의존하지 않음
  • 별도의 YAML 형식 구성 파일 사용

기본 구성은 모든 대화를 JSON 형식으로 output 디렉토리에 백업하며, 미디어를 다운로드하지 않습니다.

사용법

최초 설정

  1. telegram-cli를 컴파일하고, 한 번 실행하여 Telegram 계정을 연결합니다.
  2. 시스템에 Ruby 2+가 설치되어 있는지 확인하십시오: ruby --version
  3. 선택적으로 config.yaml을 편집하여 백업 루틴을 구성합니다.

백업 수행

  1. telegram-cli를 최소한 다음 옵션과 함께 시작하십시오: telegram-cli --json -P 9009
  2. telegram-cli가 실행 중인 동안 스크립트를 실행하십시오: ruby telegram-history-dump.rb

포맷터

기록은 항상 JSON Lines 호환 파일로 저장됩니다. 그러나 구성 파일에서 몇 줄의 주석을 해제하면 추가 출력 형식을 생성할 수 있습니다.

다음 포맷터 모듈 중 하나 이상을 활성화할 수 있습니다:

html은 웹 브라우저에서 볼 수 있는 스타일이 지정된 페이지별 채팅 로그를 생성합니다.

plaintext는 사람이 읽을 수 있는 텍스트 파일을 생성하며, 하루에 하나의 파일로 구성됩니다.

bare는 컨텍스트 없이 실제 메시지 텍스트만 출력합니다. 언어학적/통계적 분석을 위한 것입니다.

pisg는 PISG 채팅 통계 생성기의 입력으로 EnergyMech IRC 로깅 형식과 호환되는 일일 로그를 생성합니다. 또한 telegram-pisg를 참조하십시오.

사용자 정의 포맷터를 구현할 수도 있습니다. 자세한 내용은 formatters/lib/formatter_base.rb를 참조하십시오.

명령줄 옵션

대부분의 백업 구성은 구성 파일을 통해 이루어지지만, 몇 가지 특정 옵션은 CLI 옵션으로 사용할 수 있습니다. 이들 중 필수 옵션은 없습니다.

root@kitploit:~
Usage: telegram-history-dump.rb [options]
    -c, --config=cfg.yaml            Path to YAML configuration file
    -k, --kill-tg                    Kill telegram-cli after backup
    -h, --help                       Show help
    -d, --dir=DIR                    Subdirectory for output files
                                     (relative to backup_dir in YAML config)
    -l, --limit=LIMIT                Maximum number of messages to backup
                                     for each target (overrides YAML config)

참고 사항

사용 참고 사항:

  • 다른 머신에서 telegram-cli를 실행할 수 있습니다. 예를 들어 서버에서 데몬으로 실행할 수 있습니다. 이 경우 telegram-cli에 --accept-any-tcp를 전달하고 원치 않는 노출을 방지하기 위해 포트를 적절히 방화벽으로 보호해야 합니다. 미디어 파일에 관한 일부 옵션은 원격 설정에서 작동하지 않을 수 있습니다.
  • chunk_delay를 줄이거나 chunk_size를 늘릴 때 주의하십시오. Telegram이 기록 요청에 속도 제한을 가하는 것 같습니다. 너무 빠르게 진행하면 작업이 시간 초과되어 스크립트가 덤프의 일부를 건너뛰게 될 수 있습니다.

telegram-history-dump에 영향을 미치는 것으로 알려진 Telegram-cli 문제:

  • vysheng/tg#947는 100개 이상의 메시지가 있는 채널을 덤프할 때 충돌을 일으킬 수 있습니다.
  • vysheng/tg#904는 대화에 특정 미디어 파일이 포함된 경우 충돌을 일으킬 수 있습니다. 이 문제가 발생하면 제안된 해결 방법으로 telegram-cli를 다시 컴파일하십시오.
도구 다운로드