Telegram 백업: CLI 도구

CLI 도구로 텔레그램 대화 백업하기

synchromessotron 도구를 사용하면 텔레그램 채널, 그룹, 개인 대화의 메시지, 미디어 파일 및 메타데이터를 로컬 저장소로 내보낼 수 있습니다. 사용자 대신 공식 텔레그램 API 라이브러리를 통해 요청을 처리하므로, 접근 가능한 내용만 보장됩니다. 인간 읽기에 적합한 마크다운과 파싱에 용이한 JSON 형식을 지원하며, 미디어는 원본 형식 그대로 저장됩니다.

설치 및 설정

GitHub에서 릴리스를 다운로드하세요: github.com/vsirotin/synchromessotron/releases.

• 선호하는 언어로 문서를 다운로드하세요 (러시아어도 제공됨).
• 운영체제에 맞는 실행 파일을 선택하세요: Windows용 telegram-cli.exe, Linux/macOS용 해당 바이너리.
• 모든 파일을 동일한 디렉터리에 배치하세요.
• 백업 프로세스를 시작하려면 다음 명령을 입력하세요:

telegram-cli backup

명령줄 인터페이스입니다. GUI 버전은 레포지토리에서 최신 업데이트 확인 가능합니다.

보안 및 제한 사항

• 데이터 저장: API ID, 해시, 세션 정보는 exe 파일과 함께 로컬에 있는 설정 파일에 저장됩니다. 물리적 기기 접근 시에만 열람 가능합니다. 파일을 삭제하면 초기화됩니다.
• 데이터 전송: 모든 데이터는 TDLib 유사 호출을 통해 텔레그램 서버로만 전송되며, 제3자 엔드포인트는 전혀 사용되지 않습니다.
• 플로우 제한: 텔레그램의 속도 제한을 준수하며, 실제 사용자 행동을 모방하므로 계정 정지 위험은 극히 낮습니다.
• 포맷: 텍스트는 마크다운으로, JSON은 전체 구조(엔티티, 반응, 답글 포함)로 출력되며, 미디어는 변환 없이 그대로 유지됩니다.

공식 데스크톱 클라이언트 내보내기와 달리, 증분 동기화, 날짜/ID 필터링, 스크립트 기반 자동화를 지원합니다.

내보내기 설정

backup 명령은 기본적으로 모든 이용 가능한 콘텐츠를 수집합니다. 추가 옵션은 다음과 같습니다:

• --chat-id <ID>: 특정 채팅 또는 채널 지정.
• --from-date <YYYY-MM-DD>: 지정된 날짜부터 시작.
• --limit <N>: 최대 메시지 수 제한.
• --media-only: 미디어 파일만 내보내기.

선택적 내보내기 예시:

telegram-cli backup --chat-id @mychannel --from-date 2024-01-01 --limit 5000

JSON 출력에는 message_id, date, from_id, reply_to, media (사진/비디오/문서), 그리고 엔티티(강조, 링크, 코드)가 포함된 텍스트가 포함됩니다.

대안과 비교

| 기능 | synchromessotron | 공식 내보내기 | tg-archive |

|--------|------------------|-----------------|------------|

| GUI | 없음 (CLI 전용) | 있음 | 없음 |

| 증분 동기화 | 있음 | 없음 | 부분 지원 |

| JSON + 마크다운 | 있음 | HTML/JSON | JSON |

| 속도 제한 준수 | 강제 적용 | 제한적 | 위반 가능성 있음 |

| 미디어 내보내기 | 완전 | 있음 | 있음 |

로컬 분석, 데이터 마이그레이션, 오프라인 아카이빙에 이상적입니다. MIT 라이선스 하에 오픈소스입니다.

핵심 포인트

• 로컬 세션 저장으로 정보 유출 위험 감소.
• API 속도 제한 준수로 계정 정지 방지.
• 마크다운과 JSON의 이중 포맷으로 인간과 머신 모두 읽기 쉬움.
• 스크립트 기반 자동화로 주기적 백업 가능.
• 별도 권한 없이 개인 그룹 및 채널에서도 작동.

— Editorial Team