# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.github.io/TgWitness/docs/reference/overview/

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

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

[Documentation index](https://phishdestroy.github.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.github.io/TgWitness/ko/docs/reference/installation/) 에서는 로컬 액세스, 서버, 업데이트 및 다운로드한 빌드 확인 방법에 대해 설명합니다.

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

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

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

범위, 권한 및 공유 대상 최소화를 통해 운영자는 수집 및 공개할 내용을 선택할 수 있습니다. 관할권 지침 및 보고서 설정은 이러한 결정을 뒷받침합니다. 프로필을 선택한다고 해서 그 자체로 법적 준수나 증거 채택 가능성이 보장되는 것은 아닙니다. [계정 내보내기](https://phishdestroy.github.io/TgWitness/ko/docs/reference/account-export/), [액세스](https://phishdestroy.github.io/TgWitness/ko/docs/reference/access/) 및 [보고서 구성을](https://phishdestroy.github.io/TgWitness/ko/docs/reference/case-reports/) 참조하십시오.

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

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

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

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

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

이러한 검사는 무결성 및 출처 확인을 지원합니다. 그러나 이는 메시지 내용을 참인 진술로 바꾸거나, 삭제되어 볼 수 없게 된 메시지를 복원하지는 않습니다. 독립적으로 확보한 키 지문과 [신뢰 가이드](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) 및 [증거 형식에](https://phishdestroy.github.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.github.io/TgWitness/ko/docs/reference/verification/) 기록에는 서버 목록, 실시간 수집 점검 및 검색 측정 결과가 포함됩니다. [성능 내보내기에는](https://phishdestroy.github.io/TgWitness/docs/validation/) 두 번의 실제 실행 결과, 하드웨어, 소요 시간, 아카이브 해시 및 서명된 측정 파일이 포함됩니다. 이는 기록된 버전 및 조건에 대한 결과를 나타낼 뿐, 보편적인 속도나 용량 상한선을 의미하지는 않습니다.

### 테스트 이력 및 기간

관리자는 2026년 11월 6일 기준으로 6개월 이상의 테스트를 수행했다고 보고합니다. 6 11월 2026. 이는 프로젝트의 테스트 이력을 설명합니다. 위에 제시된 날짜가 명시된 공개 측정 결과는 개별 실행을 기록한 것이며, 독립적으로 검증된 6개월간의 중단 없는 수집 실행을 입증하지는 않습니다. 또한 내보낸 메시지의 생성 시점은 수집기가 가동된 기간과 다릅니다.

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

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

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

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

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

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