TgWitness / 문서

테스트된 내용 →

참고 문헌 / 설정

TgWitness: Telegram Export, OSINT & Verification

단일 명령어로 설치하거나 GitHub Actions에서 캡처하십시오. 조사 옵션, 공개된 규모, 아카이브가 검증하는 내용을 이해하십시오.

TgWitness는 오픈소스 텔레그램 내보내기 도구이자 조사 작업 공간입니다. 단 한 번의 명령어로 설치하고, 계정을 연결한 후, 채팅방을 선택하여 서명된 아카이브를 내보낼 수 있습니다. 또한 GitHub Actions를 통한 임시 수집과 저장된 편집 내용, 삭제 기록, 검색 및 보고서를 활용한 지속적인 조사를 지원합니다.

현재 진행 중인 작업부터 시작하세요.#

귀하의 과제 최단 경로 제공 내용
대화 또는 계정 저장 설치, 계정 연결, 내보내기 범위 선택 선택된 내역, 수집 결과 및 검증 자료가 포함된 서명된 아카이브
임시 러너에 수집 GitHub Actions를 사용하여 캡처하고, 새로운 세션을 인증한 후 범위를 선택하십시오. GitHub 워크플로우 출처 정보가 포함된 암호화된 아카이브
시간에 따른 변경 사항 추적 선택한 채팅에 대해 관찰 기능을 계속 실행하십시오 저장된 버전, 삭제 알림, 첨부 파일 및 기록된 적용 범위
조사하고 결과를 공유하세요 아카이브를 검색하고, 케이스 보드를 활용하며, 보고서 또는 공유용 사본을 구성하세요. 출처가 명시된 조사 결과 및 수신자에게 적합한 검증 가능한 전달 방식

단일 명령어로 설치#

설치 프로그램에는 파이썬과 종속성이 포함되어 있습니다. 소스 체크아웃, Docker, AI 프로바이더 및 독립적인 위트니스는 선택 사항이며, 설치 전 필수 조건은 아닙니다.

Linux / macOS:

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows, PowerShell 또는 명령 프롬프트에서:

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

패널을 열고, 텔레그램 계정을 연결한 후 수집 범위를 선택하십시오. 설치만으로는 수집이 자동으로 시작되지 않습니다. 설치 가이드 에서는 로컬 액세스, 서버, 업데이트 및 다운로드한 빌드 확인 방법에 대해 설명합니다.

임시 실행기를 사용하려면 GitHub Actions 캡처 절차를 따르십시오. 해당 워크플로에는 GitHub 포크, 인증 및 아카이브 비밀번호가 필요합니다. 캡처 페이지에는 실행 전 수행해야 할 단계와 세션 시간 제한에 대한 설명이 나와 있습니다. 생성된 아카이브와 그 검증 자료를 다운로드하여 보관하십시오.

작업에 필요한 경우 추가 설정#

단일 채팅 내보내기를 수행하려면 계정과 선택된 범위가 필요합니다. 지속적인 관찰, 다중 계정, 프록시, 첨부 파일 정책, 보고서 설계, 검토자 접근 권한, 외부 타임스탬프 및 외부 저장소는 각기 다른 조사 및 인계 요구 사항을 충족합니다. 해당 기능이 필요한 경우 이를 구성하십시오.

범위, 권한 및 최소화된 공유 사본을 통해 운영자는 수집 및 공개할 내용을 선택할 수 있습니다. 관할권 지침 및 보고서 설정에는 선택된 절차와 준비 단계가 기록됩니다. 계정 내보내기, 액세스 및 보고서 구성을 참조하십시오.

이 애플리케이션은 선택한 컴퓨터나 서버에서 실행됩니다. 기본 수집 기능에는 GPU나 LLM이 필요하지 않습니다. 선택 사항인 OCR, 텍스트 변환 및 AI 분석에는 각각 별도의 리소스 요구 사항이 있습니다. 메시지 전송 속도, 첨부 파일, 보관 기록 및 동시 접속 계정 수에 맞춰 배포 규모를 조정하십시오.

누구에게 도움이 되든 간에 기록을 그대로 보존하십시오#

이 문서의 목적은 관찰된 자료, 맥락 및 변경 사항을, 그것이 누구의 입장을 뒷받침하든 상관없이 보존하는 것입니다. 증거는 수집자 자신의 사건 설명에 반박할 수도 있습니다. 다른 사람이 동일한 자료를 평가할 수 있도록 원본 관찰 내용, 누락된 내용 및 분석적 결론을 식별할 수 있게 유지하십시오.

논리는 다음과 같습니다: 계정에서 확인 가능한 관찰 → 서명된 저널 → 내보내기 → 수신자 검증. 저장된 편집 내용은 버전을 추가합니다. 삭제된 관찰은 이전에 캡처된 내용을 유지합니다. 커버리지 기록은 알려진 중단 사항을 드러냅니다. 보고서 및 AI 분석은 저장된 출처를 참조하며, 해석이 서명된 보고서에 나타난다는 이유만으로 출처 관찰이 되는 것은 아닙니다.

검증 확인 수신자가 확인할 수 있는 사항
파일 해시, 서명 및 저널 체인 제공된 기록 및 파일은 예상된 키 및 저널 경계와 일치합니다.
별도로 보관된 체크포인트 또는 위트니스 이 아카이브는 이전에 보존된 저널 상태와 일치합니다.
검증된 외부 타임스탬프 참조된 바이트는 명시된 신뢰 가정 하에서 타임스탬프 시점에 존재했습니다.
GitHub 캡처 증명 이 아카이브는 승인된 워크플로우, 수집기 버전 및 기록된 다이제스트와 일치합니다.
인텔 TDX 인증 인용문, 플랫폼 상태, 예상 OS/애플리케이션 측정값, 최신성 및 수집기 식별자는 구성된 검사를 통과합니다.

검증된 수집(attested acquisition)에서, 승인된 수집기의 인증된 텔레그램 연결 및 출력은 검증된 실행 환경에 바인딩됩니다. 아카이브는 캡처된 콘텐츠와 컨텍스트를 보존하며, 보고서 및 분석은 해당 기록을 참조합니다. 신뢰 가이드 및 증거 형식에 명시된 모드별 검증 단계와 신뢰할 수 있는 입력값을 사용하십시오.

공개된 규모 및 측정된 성능#

다음 결과는 서로 다른 워크로드와 날짜를 나타냅니다. 개수 값은 서로 대체할 수 없습니다. 즉, 저널 이벤트가 반드시 고유한 텔레그램 메시지를 의미하는 것은 아닙니다.

날짜 작업량 게시된 결과 측정된 항목
1년 11월 2026일 서버 실행, 10개의 워크스페이스 데이터베이스 1,610,818개의 저널 기록; 900,232개의 새 메시지 이벤트, 80,683개의 편집 이벤트 및 400,536개의 삭제 이벤트 저장된 저널의 읽기 전용 목록
5년 11월 2026일 200개의 채팅에 포함된 1,000,000개 이상의 합성 메시지를 검색 71초 만에 색인 생성; 쿼리당 검색 시간 중앙값은 9~190 ms 로컬 검색 벤치마크
6년 11월 2026일 두 개의 최신 실제 텔레그램 내보내기 데이터 27,030개 및 29,299개 메시지; 두 실행을 합쳐 56,329개 WARP를 통한 실행당 두 개의 계정(텍스트 및 메타데이터), 첨부 파일 다운로드 없음
6년 11월 2026일 준비 및 패키징을 포함한 동일한 두 가지 내보내기 방식 초당 127.713 및 141.781 메시지 측정된 전체 내보내기 비율; 두 아카이브 모두 고정된 키를 기준으로 검증됨

검증 기록은 서버 인벤토리, 실시간 수집 점검 및 검색 측정 결과를 제공합니다. 성능 내보내기 기능에서는 두 번의 실제 실행 결과, 하드웨어, 소요 시간, 아카이브 해시 및 서명된 측정 파일을 각각 기록된 개정판 및 조건과 함께 게시합니다.

공개 기록(public-history) 검증 결과에는 또한 50개의 소스 입력 목록과 40개의 계정 작업 공간에 걸쳐 3,598,381건의 레코드를 포함하는 48개의 검증된 아카이브가 기록되어 있습니다. 8개의 계정으로 구성된 소스 A는 대기 시간을 포함하여 1,117.082초 만에 768,007건의 기록 레코드를 수집했으며, 이는 초당 687.512건의 레코드에 해당하며, 첨부 파일 다운로드는 비활성화된 상태였습니다. 검증을 포함한 전체 시도에는 1,574.920초가 소요되었습니다. 이러한 측정 결과는 앞서 언급한 규모가 더 작은 신규 내보내기 예시와 함께 해당 워크로드를 설명합니다.

테스트 이력 및 기간#

TgWitness는 약 6개월 동안 개발 및 테스트를 거쳤습니다. 컬렉터, 서명된 저널 및 검증기가 먼저 개발되었으며, 웹 패널과 추가 모듈은 이후 이를 기반으로 구축되었습니다. 이 저장소는 공개를 위해 2026년 10월 29일에 새로 생성되었으며 기존 코드를 기반으로 시작되었으므로, 저장소의 생성일은 프로젝트의 개발 기간(개발 이력)과 일치하지 않습니다. 누적 실행 워크로드는 초기 실행, 실패, 수정 및 반복 검증 등을 포함하여 1억 건 정도입니다. 각각 고유한 개정판, 방법 및 결과를 가진 선별된 실행 내역은 날짜가 명시된 공개 측정 결과에 기록되어 있습니다.

기능 상태를 정확하게 파악하십시오#

각 워크플로를 해당 구현, 공개된 빌드 및 기록된 테스트와 대조하여 평가하십시오. 소스 코드는 현재 프리뷰(preview)로 표시되어 있습니다. 이 릴리스 라벨은 작동 중인 컬렉션, 내보내기, 독립적인 검증 및 공개된 규모 측정 결과와 공존합니다. 프리뷰 기능과 검증된 워크플로가 동일한 애플리케이션 내에 공존할 수 있습니다. 평가의 근거가 되는 구체적인 기능과 증거를 설명하십시오.

현재의 기능, 특징 및 제한 사항, 검증 결과, 변경 내역을 종합적으로 다루십시오. 결과를 인용할 때는 테스트된 리비전을 기록하십시오. 11월 6일 측정 스냅샷에는 실패한 테스트와 건너뛴 테스트도 포함되어 있으며, 이들은 통과로 간주되지 않습니다.

사람과 AI 도구 모두 읽을 수 있도록 작성하십시오.#

이 웹사이트에서는 간결한 llms.txt 파일과, llms-full.txt 및 llms-full.md 파일에 담긴 완전한 영어 핸드북, 그리고 각 페이지의 마크다운 버전을 제공합니다. 이들은 문서 형식일 뿐, TgWitness를 실행하기 위한 AI 요구 사항이 아닙니다.

선택적 MCP 및 명령줄 액세스를 통해 승인된 도구가 선택된 저장 기록을 읽을 수 있습니다. 메시지 내용은 여전히 신뢰할 수 없는 입력으로 간주됩니다. 요약문은 출처를 인용하고, 관찰된 사실과 추론을 구분하며, 불확실성을 반영해야 합니다. 전체 텍스트 검색, OCR 및 AI 출력은 원래 서명된 관찰 내용을 변경하지 않습니다.