# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions.

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/llms.txt)

단일 명령어로 설치하거나 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"
```

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

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

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

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

범위, 권한 및 최소화된 공유 사본을 통해 운영자는 수집 및 공개할 내용을 선택할 수 있습니다. 관할권 지침 및 보고서 설정에는 선택된 절차와 준비 단계가 기록됩니다. [계정 내보내기](https://phishdestroy.io/tgwitness/ko/docs/reference/account-export/), [액세스](https://phishdestroy.io/tgwitness/ko/docs/reference/access/) 및 [보고서 구성을](https://phishdestroy.io/tgwitness/ko/docs/reference/case-reports/) 참조하십시오.

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

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

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

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

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

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

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

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

| 날짜 | 작업량 | 게시된 결과 | 측정된 항목 |
| --- | --- | --- | --- |
| 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 메시지 | 측정된 전체 내보내기 비율; 두 아카이브 모두 고정된 키를 기준으로 검증됨 |

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

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

### 테스트 이력 및 기간

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

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

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

[현재의 기능](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [특징 및 제한 사항](https://phishdestroy.io/tgwitness/ko/docs/reference/features/), [검증](https://phishdestroy.io/tgwitness/ko/docs/reference/verification/) 결과, [변경 내역을](https://phishdestroy.io/tgwitness/ko/docs/reference/changelog/) 종합적으로 다루십시오. 결과를 인용할 때는 테스트된 리비전을 기록하십시오. 11월 6일 측정 스냅샷에는 실패한 테스트와 건너뛴 테스트도 포함되어 있으며, 이들은 통과로 간주되지 않습니다.

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

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

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