# Telegram · 소스 기록 불러오기

Canonical page: https://phishdestroy.io/tgwitness/ko/docs/reference/history/

활성화된 소스의 과거 메시지를 불러오고, 일시 중지 및 재시작하며, 서명된 진행 보고서를 검증할 수 있습니다.

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

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

활성화된 소스의 과거 메시지를 불러오고, 일시 중지 및 재시작하며, 서명된 진행 보고서를 검증할 수 있습니다.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [문서](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [컬렉션](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

![모음](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69)

**‘추가 도구’ → ‘소스’ → ‘적용 대상 채팅’에서** 활성화된 채팅을 확인하고, ‘표준 API’ 또는 ‘Takeout 내보내기’를 선택한 다음 **‘전체 기록 불러오기’를** 선택하세요. 이 작업을 실행하면 해당 소스 목록이 수정되고, 사용 가능한 과거 메시지가 ‘채팅’ 및 서명된 관찰 일지에 읽어집니다. 미디어는 기존 첨부 파일 설정과 영구 다운로드 대기열을 사용합니다. 이는 채팅별 서명된 JSON/HTML 내보내기 기능과는 별개입니다.

계정 전체를 수집하려면 **‘전체 계정** ’을 선택하고 범위를 저장하세요. 기록 기능은 소스 목록에 서명하기 전에 보관된 채팅을 포함하여 접근 가능한 모든 대화창을 새로 고칩니다. 이 검색 과정에서는 선택한 채팅 선택기의 목록 제한이 적용되지 않습니다. 나중에 발견된 채팅은 관찰 대상이 되며, 구성된 초기 스냅샷을 받게 됩니다. 전체 실행을 한 번 더 수행하면 이전 기록을 불러올 수 있습니다. **기록 불러오기 중 및 이후에도 관찰 유지** 옵션을 활성화하면 기록이 불러오는 동안 새로운 메시지, 수정 내용 및 삭제 알림을 기록할 수 있습니다. 기록 실행 또는 내보내기 한 번에 수집 슬롯이 사용되며, 실시간 관찰은 이와 병행하여 실행됩니다.

동시 채팅 1~3개, 첨부 파일 처리 담당자 1~5명을 선택하고, 사용 가능한 ‘최근 작업’을 유지할지 여부와 이전에 저장된 버전을 비교할지 여부를 선택하세요. ‘테이크아웃’ 기능은 텔레그램에서 승인이 필요하거나 서버에서 지정한 대기 시간이 필요할 수 있습니다. 이러한 옵션은 작업을 재개할 때도 그대로 유지됩니다. 자세한 내용은 [백필 거동 및 증거 계약](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md) 전송, 재시도 및 신뢰에 관한 세부 정보.

## 일시 중지, 재개 및 부분 결과

- **'기록 일시 중지'를 선택하면** 읽기가 중단됩니다. **'기록 계속'을 선택하면** 각 소스의 마지막으로 커밋된 메시지부터 다시 읽기가 재개됩니다. 앱을 다시 시작해도 재개될 때까지 실행이 일시 중지된 상태로 유지됩니다. 재개하려면 동일한 비활성 텔레그램 계정이 필요합니다.
- 메시지 관찰, 첨부 파일 처리 및 커서 커밋이 하나의 트랜잭션으로 수행됩니다. 실행이 재개되더라도 이미 커밋된 관찰 내용은 반복되지 않습니다. 실시간 캡처 또는 별도로 명시적으로 시작된 실행에서는 동일한 메시지를 독립적으로 관찰할 수 있습니다.
- 각 소스(Takeout 내의 각 텔레그램 분할 범위)는 첫 번째 읽기 시 상한 메시지 ID를 고정합니다. 더 최근의 메시지는 실시간 관찰에 속하며, 해당 소스의 나머지 기록 페이지에는 속하지 않습니다.
- 접근할 수 없는 소스나 수집 과정에서 비활성화된 소스는 '실패' 또는 '건너뜀'으로 표시됩니다. 다른 소스는 계속 수집되며, 전체 결과는 불완전합니다.
- 텔레그램은 채팅의 관리자 로그를 해당 채팅의 관리자에게만 표시합니다. 일반 회원의 경우, 관리자 로그 조회 기록은 `history.admin_log.unavailable`으로 기록되며, 그 `reason: not_admin`로 표시됩니다. 또한 이 경우 기록이 불완전해지지 않지만, 관리자의 경우 관리자 로그 조회 시 실패하면 기록이 불완전해집니다.
- FloodWait 지연 시간은 저장된 계정 백오프 설정을 따릅니다. 일시적인 오류의 경우 최대 5회까지 재시도하며, 리소스 소진 및 디스크 공간 부족 시 커서는 그대로 유지된 채로 일시 중지됩니다.
- **'이 기록 실행 종료'는** 저장된 관측 결과를 보존합니다. 이를 제거하거나 표준 API 첨부 작업은 취소하지 않습니다. 'Takeout 종료'를 선택하면 남아 있는 Takeout 파일이 건너뛴 것으로 표시되며, '일시 중지'를 선택하면 나중에 다시 재개할 수 있습니다. 새로운 실행을 시작하면 활성화된 소스를 다시 읽습니다.

이력 완료는 이력 읽기 작업에 대해서만 설명합니다. 첨부 파일은 대기 상태로 남아 있거나, 실패하거나, 구성된 정책에 따라 제외될 수 있습니다. 저널과 첨부 파일 대기열에서 미디어 수신 확인을 확인하십시오. 바이트가 보존된 완료된 수신 확인만 저장된 첨부 파일로 간주됩니다. 이력 작업은 명시적인 스냅샷 요청이며, 향후 실시간 이벤트의 범주를 선택하는 스위치와는 별개입니다.

## 전송 및 검증

**서명된 진행**보고서를 저장한 후, **‘증거 내보내기’** 기능을 사용하여 저널과 저장된 첨부 파일을 다운로드하십시오. 나중에 증거를 내보낼 경우 추가 기록이 포함될 수 있습니다. 이 보고서는 생성 시점의 저널 접두사에 카운터를 연동합니다. 이 버전의 신뢰할 수 있는 체크아웃에서 검증기를 실행하십시오:

```
python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT
```

예상되는 서명 키 지문은 별도로 유지하십시오. 검증기는 보고서 서명, 증거 아카이브, 보고서 체크포인트, 소스 플랜, 계정 및 저장된/사용 불가능한 메시지 수를 확인합니다. 새로운 실행에서는 소스 진행 상황과 옵션도 서명된 커서 이벤트에 바인딩됩니다. `--evidence` 옵션이 없으면, 서명된 보고서와 그 내부 일관성만 확인합니다. 기존 진행 상황 필드와 첨부 파일 요약은 서명된 수집기 진술로 유지됩니다. 증거 검증기는 아카이브된 미디어 바이트를 확인합니다.

검증된 기록과 함께 수집 간격, 적용 범위 및 사용 가능한 최근 작업을 확인하십시오. 이 워크플로는 현재 접근 가능한 기록을 읽으며, [실시간 모니터링은](https://phishdestroy.io/tgwitness/ko/docs/reference/collection/#message-history-and-attribution) 버전을 보존하고 알림이 도착하는 즉시 이를 기록하는 반면, [비밀 채팅은](https://phishdestroy.io/tgwitness/ko/docs/reference/secret-chats/) 활성화된 엔드포인트 통합을 사용합니다. 검증을 위해서는 [검증 모드에](https://phishdestroy.io/tgwitness/ko/docs/reference/evidence/#verification-scope) 설명된 보존된 체크포인트, 증인 기록 및 해당 수집 증명서를 사용하십시오.

획득 커서는 로컬 작업 공간의 상태를 나타냅니다. 증거 ZIP 파일만 복원한다고 해서 진행 중인 획득 작업이나 텔레그램 세션이 복원되는 것은 아닙니다. 원래 작업을 계속 진행해야 하는 경우 작업 공간 백업을 보관해 두십시오.
