텔레그램 채널 백업 및 복원에 대해 알아야 할 모든 것. 초보자를 위해 구체적인 단계와 일반적인 함정과 함께 작성되었습니다.
이 도구가 무엇인지, 왜 존재하는지, 누구를 위한 것인지에 대한 간략한 개요.
MIT 라이선스로 출시되었습니다. 전체 소스 코드는 GitHub에 있습니다 — 검토하고, 수정하거나, 직접 빌드해보세요.
텔레그램 채널 백업 도구는 텔레그램 채널의 완벽한 백업 및 복원을 위한 무료 데스크톱 애플리케이션입니다. 콘텐츠를 보호하고, 계정 간에 마이그레이션하거나, 귀중한 미디어를 보관하려는 모든 사람에게 완벽합니다.
텔레메트리, 제3자 서버, 라이선스 키가 없습니다. 앱은 공식 텔레그램 클라이언트와 동일하게 공식 텔레그램 API와만 통신합니다.
앱은 휴대용입니다 — 설치 프로그램도, 레지스트리 변경도 없습니다. 다운로드하고 실행하기만 하면 됩니다.
chmod +x로 실행 가능하게 설정)파일을 원하는 폴더에 저장하고 더블 클릭하여 실행하세요. 설치가 필요하지 않습니다.
실행 파일은 코드 서명 인증서로 서명되지 않았습니다(연간 수백 달러가 들며 무료 오픈 소스 프로젝트에는 실용적이지 않음). Windows에서 경고가 표시될 수 있습니다 — 추가 정보를 클릭한 다음 실행을 클릭하세요. 소스에서 직접 빌드할 수도 있습니다.
모든 텔레그램 클라이언트에는 텔레그램에서 발급한 공식 자격 증명인 api_id와 api_hash가 필요합니다. 무료이며 3분이면 됩니다.
텔레그램용 "개발자 로그인"과 같습니다. 모든 타사 앱은 고유한 쌍을 사용합니다. 직접 만들어야 하며 계정에만 연결되므로 안전합니다.
브라우저에서 https://my.telegram.org로 이동하세요.
국가 코드와 함께 +로 시작하는 국제 형식으로 전화번호를 입력하세요. 예: +821012345678. 텔레그램이 앱이나 SMS로 확인 코드를 보냅니다.
로그인 후 대시보드 상단의 API development tools를 클릭하세요.
양식을 작성하세요 — 실제 데이터는 중요하지 않으며 텔레그램이 기록용으로만 저장합니다. 플랫폼: Desktop 선택. Create application을 클릭하세요.
페이지에 두 가지 값이 표시됩니다 — 둘 다 복사하세요:
1234567과 같은 숫자abcdef1234567890abcdef1234567890과 같은 긴 문자열API ID, API Hash 및 전화번호를 가진 사람은 잠재적으로 귀하의 텔레그램 계정에 접근할 수 있습니다. 채팅, 스크린샷 또는 공개 포럼에서 절대 공유하지 마세요.
두 가지 로그인 방법 — 더 쉬운 것을 선택하세요.
로그인 탭을 열고 입력하세요:
+가 포함된 국제 형식backup_session)텔레그램이 앱으로 코드를 보냅니다. 나타나는 팝업에 코드를 입력하세요. 2단계 인증이 활성화된 경우 다음에 클라우드 비밀번호를 묻습니다.
QR 로그인에는 전화번호가 필요하지 않습니다 — API ID와 API Hash만 입력하면 됩니다.
QR 창이 열립니다. 휴대폰에서:
성공적으로 스캔하면 창이 자동으로 닫힙니다.
상태 카드에 계정 이름이 나타납니다. 이제 채널을 내보내거나 가져올 준비가 되었습니다.
세션 파일은 ~/.tg_backup_tool/sessions/에 저장됩니다 — Windows에서는 C:\Users\YourName\.tg_backup_tool\sessions\입니다. 해당 폴더를 삭제하면 완전히 로그아웃됩니다.
전체 백업 생성: 채널 정보, 아바타, 메시지 및 미디어 파일.
목록 새로 고침을 클릭하여 채널을 로드합니다. 대화 수에 따라 5~30초가 걸립니다.
드롭다운에서 채널을 선택하세요. 방송 채널과 슈퍼그룹 모두 목록에 나타납니다.
모든 메시지를 내보내려면 0을 입력하거나, 마지막 N개만 내보내려면 숫자(예: 500)를 입력하세요. 전체 백업 전에 테스트하는 데 유용합니다.
저장할 위치를 선택하려면 폴더 선택을 클릭하세요. 그런 다음 내보내기 시작을 클릭하세요. 진행률 표시줄을 보세요 — 중지로 언제든지 취소할 수 있습니다.
타임스탬프 이름의 폴더에 다음이 포함됩니다:
channel_data.json — 모든 메시지, 채널 정보 및 메타데이터media/ — 다운로드된 사진, 비디오, 문서백업된 채널을 새 채널로 복원합니다.
폴더 선택을 클릭하고 내보내기 중에 생성된 백업 폴더(channel_data.json이 포함된 폴더)를 선택하세요.
새 채널의 이름을 입력하거나 기본값을 유지하세요. 텔레그램에 표시될 제목입니다.
권장: 1~3초. 낮은 값은 더 빠르지만 위험한 가져오기를 초래합니다. 앱은 플러드 대기를 자동으로 처리합니다 — 텔레그램이 기다리라고 하면 일시 중지하고 재개합니다.
가져오기 시작을 클릭하세요. 앱이 새 채널을 만들고 모든 것을 순서대로(가장 오래된 것부터) 업로드합니다. 진행률 표시줄에 현재 위치가 표시됩니다.
텔레그램은 짧은 기간 내에 보낼 수 있는 메시지 수를 제한합니다. 큰 채널(10,000개 이상의 메시지)은 몇 시간 또는 며칠이 걸릴 수 있습니다. 앱이 이를 처리합니다 — 그냥 실행하도록 두세요.
아니요 — 텔레그램은 기존 채널에 대량 메시지 삭제 또는 재업로드를 허용하지 않습니다. 가져오기는 백업에서 새 채널을 만듭니다.
인터페이스는 9개 언어로 번역되었습니다. 설정 → 언어에서 전환하세요(재시작 필요).
en
ru
es
pt
de
fr
tr
fa
ko
GitHub에서 기여를 환영합니다. app/locales/에 새 xx.json을 추가하기만 하면 설정에 자동으로 나타납니다.
가장 일반적인 문제에 대한 빠른 답변.
SmartScreen 대화 상자에서 추가 정보를 클릭한 다음 실행을 클릭하세요. 실행 파일이 코드 서명되지 않았기 때문에 발생합니다. 신뢰할 수 없다면 소스에서 빌드하세요: 종속성 설치 후 python build.py.
텔레그램 앱이 최신 상태이고 휴대폰에 인터넷이 있는지 확인하세요. 2FA가 활성화된 경우 QR 스캔 후 비밀번호 창이 자동으로 나타나야 합니다. 전혀 나타나지 않으면 이벤트 로그 탭에서 로그를 보내 GitHub 이슈에 제출하세요.
계정이 일부 채널이나 그룹의 멤버인지 확인하세요. 채널의 경우 목록에 표시되려면 게시 권한이 있는 관리자여야 합니다. 슈퍼그룹의 경우 회원이면 충분합니다.
텔레그램이 계정 속도를 제한하고 있습니다. 메시지 간 지연(가져오기 설정 탭)을 늘리고 몇 시간 기다리세요. 내보내기의 경우 앱이 FloodWait을 자동으로 처리합니다 — 계속 실행하도록 두면 됩니다.
너무 많은 기기에서 로그인하거나 텔레그램에서 세션을 수동으로 재설정한 경우 텔레그램이 세션을 취소할 수 있습니다. 다시 QR로 로그인을 클릭하세요. 설정 및 내보낸 파일은 보존됩니다.
GitHub 이슈에 이슈를 열거나 텔레그램으로 직접 메시지를 보내세요: @igor_shelloff. 수행한 작업, 발생한 일 및 (가능한 경우) 로그 발췌를 포함하세요.
이 프로젝트는 무료이며 항상 그럴 것입니다. 시간을 절약해 주었다면 도울 수 있는 방법은 다음과 같습니다.
별표는 다른 사람들이 프로젝트를 발견하는 데 도움이 됩니다.
저장소 열기버그를 발견했거나 기능 아이디어가 있나요?
이슈 열기도구의 추가 개발을 지원하세요.
기부하기질문이나 피드백이 있으신가요? 직접 메시지를 보내세요.
@igor_shelloff프로젝트는 GitHub에 있습니다. 포크하고, 풀 리퀘스트를 제출하고, 새 언어를 추가하거나 이슈 섹션에서 기능을 제안하세요.