# TgWitness · 한국어

> Documentation edition: 한국어. Project version: `0.9.1`. Source branch: `main`.

This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Untranslated sections retain the English original; a language edition is not a claim that every section has been translated.

- [Project context, installation, measured scale and verification limits](https://phishdestroy.github.io/TgWitness/docs/reference/overview/index.md)

- [English project summary](https://phishdestroy.github.io/TgWitness/llms.txt)

- [Complete handbook · 한국어](https://phishdestroy.github.io/TgWitness/ko/llms-full.txt)

- [Complete handbook as Markdown · 한국어](https://phishdestroy.github.io/TgWitness/ko/llms-full.md)

- [Source code and release history](https://github.com/phishdestroy/TgWitness)

- [Collection modes and evidence levels](https://phishdestroy.github.io/TgWitness/ko/guides/modes.md)

- [Published checks and measurements](https://phishdestroy.github.io/TgWitness/docs/validation/index.md)


## Complete documentation map

### Guides

- [아카이브 활용하기](https://phishdestroy.github.io/TgWitness/ko/docs/archive/index.md): 이력을 불러오고, 저장된 기록을 검색하며, AI 출처를 검토하고, 사용 중인 도구와 연동하세요.
- [GitHub Actions 캡처](https://phishdestroy.github.io/TgWitness/ko/docs/capture/index.md): 임시 GitHub 실행기에서 Takeout，일반 API 내보내기 또는 채팅 기록을 선택하세요．
- [전용 계정](https://phishdestroy.github.io/TgWitness/ko/docs/dedicated-account/index.md): 데이터 수집을 위해 별도의 텔레그램 계정을 준비하십시오.
- [몇 분 만에 시작하세요](https://phishdestroy.github.io/TgWitness/ko/docs/start/index.md): 명령어 하나로 설치하고 Telegram 계정을 연결한 뒤 Windows, Linux 또는 macOS에서 검증 가능한 아카이브를 내보내세요.
- [계정 연결](https://phishdestroy.github.io/TgWitness/ko/docs/accounts/index.md): QR 코드, 전화번호 또는 세션 가져오기를 통해 텔레그램을 연결하세요. 소스를 선택하고 새 메시지가 저널에 정상적으로 수신되는지 확인하세요.
- [프록시 선택](https://phishdestroy.github.io/TgWitness/ko/docs/proxies/index.md): 자동 MTProxy 경로를 유지하거나 사용자 지정 프록시를 사용하세요. IP 모드, 대체 규칙 및 외부 요청에 대한 경로를 선택하세요.
- [내보내기 및 검증](https://phishdestroy.github.io/TgWitness/ko/docs/exports/index.md): 캡처된 텔레그램 기록을 내보내고, 서명을 검증하며, 저널을 독립적인 증인이 보관하고 있는 체크포인트와 비교할 수 있습니다.
- [증거가 어떻게 활용되는지 확인하기](https://phishdestroy.github.io/TgWitness/ko/docs/concepts/index.md): 메시지가 캡처된 시점부터 체크포인트에 도달할 때까지의 경로를 추적해 보세요. 샘플 기록을 변경하고, 해당 기록의 SHA-256 체인을 재계산한 후, 보존된 체크포인트가 이를 어떻게 감지하는지 확인해 보세요.
- [모든 채팅을 대상으로 조사하기](https://phishdestroy.github.io/TgWitness/ko/docs/cases/index.md): 채널, 그룹, 비공개 채팅 및 봇 전반에 걸쳐 텔레그램 종단 간 조사를 수행하세요: 전체 계정 캡처, 기록, 참여자, 링크, 파일, 타임라인 및 검증된 증거.
- [케이스 보드 구축하기](https://phishdestroy.github.io/TgWitness/ko/docs/case-board/index.md): 비공개 보드에 저장된 관찰 내용, 정확한 하이라이트 및 작업 단편을 수집하고, 팀과 논의한 후 수집 결과를 제시하십시오.
- [보고서 설계](https://phishdestroy.github.io/TgWitness/ko/docs/reports/index.md): 보고서 데이터, 8가지 디자인 중 하나 및 내용을 선택한 후, 미리 보기를 확인하고 HTML, 서명된 PDF 또는 완전한 증거 패키지로 내보내십시오.
- [공유용 사본을 준비하십시오](https://phishdestroy.github.io/TgWitness/ko/docs/handover/index.md): 수신자가 수신할 수 있는 기록과 필드를 선택하고, 완성된 사본을 검토한 후 서명된 매니페스트와 소스 저널 경계를 확인하십시오.
- [계정 그룹 관리](https://phishdestroy.github.io/TgWitness/ko/docs/groups/index.md): 그룹 작업 공간을 비교하고, 출처를 찾으며, 관찰 기간을 검토하고, 계정별 예외 사항을 적용하여 공유 설정을 적용하십시오.
- [보안을 유지하세요](https://phishdestroy.github.io/TgWitness/ko/docs/security/index.md): 세션, 키 및 증거가 어디에 저장되는지, 시스템 외부로 전송되는 정보는 무엇인지, 보안 조치가 어떤 범위를 포함하는지, 그리고 설치 환경을 어떻게 강화할 수 있는지 확인하십시오.
- [사례 공유하기](https://phishdestroy.github.io/TgWitness/ko/docs/access/index.md): 검토자와 분석가에게 별도의 권한, 세션 제한 및 취소 가능한 토큰을 통해 선별된 계정 및 채팅에 대한 접근 권한을 부여합니다.
- [Witness 봇 설정하기](https://phishdestroy.github.io/TgWitness/ko/docs/witness/index.md): 별도의 증인(witness), 고유한 키, 읽기 전용 수집기(collector) 액세스 권한을 통해 서명된 기록부 체크포인트를 텔레그램 채널에 게시하세요.
- [계속 운영해 주세요](https://phishdestroy.github.io/TgWitness/ko/docs/server/index.md): TgWitness는 영구 저장소, 전용 패널 액세스, 백업 기능 및 재시작 후 점검 기능이 갖춰진 서버에서 실행하십시오.
- [문제가 발생한 원인을 파악하세요](https://phishdestroy.github.io/TgWitness/ko/docs/troubleshooting/index.md): 각 문제에 맞는 신호를 사용하여 패널 액세스, 텔레그램 연결, 누락된 메시지, FloodWait 및 위트니스 상태를 확인하십시오.

### Reference

- [비밀 채팅: 구현 및 데모](https://phishdestroy.github.io/TgWitness/ko/docs/reference/secret-chats/index.md): 별도의 비밀 채팅(Secret Chat) 구현 방식을 이해하고, 가상의 인터페이스를 체험해 보며, 미해결 결함 사항을 검토하십시오.
- [TgWitness: 시작, 규모 및 증거](https://phishdestroy.github.io/TgWitness/ko/docs/reference/overview/index.md): 단일 명령어로 설치하거나 GitHub Actions에서 캡처하십시오. 조사 옵션, 공개된 규모, 아카이브가 검증하는 내용을 이해하십시오.
- [소스 기록 불러오기](https://phishdestroy.github.io/TgWitness/ko/docs/reference/history/index.md): 활성화된 소스의 과거 메시지를 불러오고, 일시 중지 및 재시작하며, 서명된 진행 보고서를 검증할 수 있습니다.
- [아카이브 분석](https://phishdestroy.github.io/TgWitness/ko/docs/reference/analysis/index.md): 저장된 메시지를 검색하고, AI 입력 내용을 검토하며, 출처 참조 정보가 포함된 분석 보고서를 보관할 수 있습니다.
- [명령줄](https://phishdestroy.github.io/TgWitness/ko/docs/reference/cli/index.md): 스크립트 및 에이전트를 통해 메시지를 검색하고, 문맥을 확인하며, 활동 횟수를 집계하고, 저장된 메시지를 내보낼 수 있으며, --json 출력, 안정적인 종료 코드 및 범위 지정된 읽기 전용 토큰을 지원합니다.
- [전체 텍스트 검색](https://phishdestroy.github.io/TgWitness/ko/docs/reference/search/index.md): 저장된 메시지를 단어 형태, 정확한 구문, 도메인 및 @사용자명으로 검색하며, 서명된 저널에 인덱스가 연동되어 가장 일치도가 높은 결과부터 우선적으로 표시됩니다.
- [읽기 전용 MCP](https://phishdestroy.github.io/TgWitness/ko/docs/reference/mcp/index.md): 만료 및 취소 가능한 액세스 권한을 통해 MCP 클라이언트를 선택한 작업 공간 및 채팅에 연결합니다.
- [로컬 OCR 및 텍스트 변환](https://phishdestroy.github.io/TgWitness/ko/docs/reference/media-analysis/index.md): 로컬 워커를 통해 캡처된 이미지와 오디오를 인식하고, 추출된 텍스트를 원본 파일과 연결된 상태로 유지합니다.
- [발신 웹훅](https://phishdestroy.github.io/TgWitness/ko/docs/reference/webhooks/index.md): HMAC 서명, 재시도 및 전달 상태를 포함하여 지정된 범위의 이벤트를 HTTPS 수신자에게 전송합니다.
- [운영자 호환성 불일치 공지](https://phishdestroy.github.io/TgWitness/ko/docs/reference/notice/index.md): Taylor Wessing에 대한 당사의 운영자 공지 및 그 출처 기록.
- [라이선스 안내 및 아키텍처 비호환성 공지](https://phishdestroy.github.io/TgWitness/ko/docs/reference/license/index.md): TgWitness는 모든 사용자에게 MIT 라이선스가 적용되며, 이것이 Taylor Wessing 워크플로우와 아키텍처적으로 호환되지 않는 이유입니다.
- [빠른 시작](https://phishdestroy.github.io/TgWitness/ko/docs/reference/quickstart/index.md): TgWitness를 설치하고 실행하는 모든 방법: Windows 패키지, Python, Docker 및 종합 데모와 초기 점검 절차.
- [계정 및 세션 형식](https://phishdestroy.github.io/TgWitness/ko/docs/reference/accounts/index.md): 전화번호, QR 코드 또는 인증 키로 로그인하고, Telethon, Pyrogram 또는 Telegram Desktop 세션을 가져와 여러 계정을 동시에 운영할 수 있습니다.
- [접근 및 권한](https://phishdestroy.github.io/TgWitness/ko/docs/reference/access/index.md): 계정 및 채팅에 대한 접근 권한을 제한하고, 권한을 선택하며, 세션 및 IP 주소를 제한하고, 접근 권한을 철회할 수 있습니다.
- [연결, 프록시 및 데이터 보호](https://phishdestroy.github.io/TgWitness/ko/docs/reference/connection/index.md): 인증, 자동 프록시 풀, IP 모드, 대체 정책, 외부 요청 및 비밀 정보 저장.
- [배포](https://phishdestroy.github.io/TgWitness/ko/docs/reference/deployment/index.md): TgWitness를 Windows, Linux, macOS 또는 Docker 환경에서 HTTPS를 통해 서비스 형태로 실행할 수 있으며, 백업 및 업데이트 기능이 제공됩니다.
- [데이터 수집 방식](https://phishdestroy.github.io/TgWitness/ko/docs/reference/collection/index.md): 관찰 범위, 실시간 업데이트, 재확인, 첨부 파일, 사용자 작업 및 ‘갭(gap)’의 의미 등을 기록 단위로 상세히 설명합니다.
- [워크플로우 및 운영](https://phishdestroy.github.io/TgWitness/ko/docs/reference/operations/index.md): 패널의 일상적인 운영: 모드, 모니터링 범주, 매개변수, 알림, 내보내기, 백업 및 용량.
- [조사 모드](https://phishdestroy.github.io/TgWitness/ko/docs/reference/investigation/index.md): 채널, 그룹, 비공개 채팅 및 봇에 걸친 전체 계정 조사: 조사 범위 설정부터 검증된 사건 자료 패키지 구성까지.
- [Case Board 참조](https://phishdestroy.github.io/TgWitness/ko/docs/reference/case-board/index.md): 북마크, 정확한 하이라이트, 액션 슬라이스, 토론, 범위 지정 액세스 및 Case Board에서 사용하는 서명된 주석 내역.
- [보고서 구성 및 검증](https://phishdestroy.github.io/TgWitness/ko/docs/reference/case-reports/index.md): 보고서 필터, 8가지 디자인, 콘텐츠 사전 설정, 저장된 변경 내역 및 서명된 내보내기 파일에 포함된 평가 결과가 제공됩니다.
- [기능 및 제한 사항](https://phishdestroy.github.io/TgWitness/ko/docs/reference/features/index.md): TgWitness의 현재 수집 모델, 다중 계정 워크플로우, 내보내기 기능 및 운영 범위.
- [증거 기록의 작동 방식](https://phishdestroy.github.io/TgWitness/ko/docs/reference/how-it-works/index.md): 해시 체인, 서명, 체크포인트 및 위트니스에 대해 검증자가 사용하는 정확한 수식을 바탕으로 설명합니다.
- [증거 형식](https://phishdestroy.github.io/TgWitness/ko/docs/reference/evidence/index.md): 서명된 ZIP 파일의 내용, 기록 유형, 처리 내역, 사용자 프로필, 외부 백업본 및 오프라인 검증.
- [독립적인 증인](https://phishdestroy.github.io/TgWitness/ko/docs/reference/witness/index.md): 자체 키와 봇을 사용하여 위트니스를 실행하고, 서명된 체크포인트를 채널에 게시한 후, 내보낸 데이터를 이를 기준으로 대조하여 확인하십시오.
- [타임스탬프](https://phishdestroy.github.io/TgWitness/ko/docs/reference/timestamp/index.md): 서명된 체크포인트에 대한 RFC 3161 타임스탬프: 인증 기관에 전송되는 내용과 응답을 검증하는 방법.
- [보안 및 데이터 처리](https://phishdestroy.github.io/TgWitness/ko/docs/reference/security/index.md): 위협 모델, 접근 모델, 저장된 기밀 정보, 네트워크 노출, 세션 가져오기 및 취약점 보고 방법.
- [아키텍처](https://phishdestroy.github.io/TgWitness/ko/docs/reference/architecture/index.md): 컬렉터, 패널, 저널, 워커 및 위트니스의 구성 요소와 이들 간에 데이터가 어떻게 이동하는지 설명합니다.
- [테스트된 내용](https://phishdestroy.github.io/TgWitness/ko/docs/reference/verification/index.md): 실시간 텔레그램 테스트, 자동화된 점검, 브라우저 점검 및 아직 검증되지 않은 사항.
- [변경 내역](https://phishdestroy.github.io/TgWitness/ko/docs/reference/changelog/index.md): 아직 공개되지 않은 변경 사항을 포함하여 버전별 모든 변경 내역.
- [패널 가이드](https://phishdestroy.github.io/TgWitness/ko/docs/reference/panel/index.md): 패널의 모든 화면: 채팅, 일지, 소스, 내보내기, 추가 기능, 보호 모드 및 코드 확인.
- [초기 설정 및 구성](https://phishdestroy.github.io/TgWitness/ko/docs/reference/settings/index.md): 설정 마법사, 목표, 인터페이스 수준, 연결 경로 및 계정 그룹에서 공유되는 설정.
- [설치, 확인 및 업데이트](https://phishdestroy.github.io/TgWitness/ko/docs/reference/installation/index.md): 단 한 줄의 명령어로 설치하고, 서명과 해시를 확인하며, 업데이트 및 제거할 수 있습니다.
- [저장 및 복구](https://phishdestroy.github.io/TgWitness/ko/docs/reference/storage/index.md): 백업, 오래된 파일을 클라우드로 이동, Object Lock 하의 복사본, 새 기기에서 복구.
- [계정 내보내기](https://phishdestroy.github.io/TgWitness/ko/docs/reference/account-export/index.md): 계정이 현재 읽을 수 있는 내용을 내보내기: 범위, 재개 가능한 작업, 서명된 아카이브 및 최소화된 공유 사본.
- [공개 쇼케이스](https://phishdestroy.github.io/TgWitness/ko/docs/reference/showcase/index.md): 선택한 공개 채널의 저장된 메시지와 서명된 스냅샷을 유효 기간이 정해져 있고 취소 가능한 링크를 통해 게시합니다.
- [고신뢰도 배포](https://phishdestroy.github.io/TgWitness/ko/docs/reference/high-assurance/index.md): Hetzner 또는 Phala Cloud에 구축된 24시간 연중무휴 보안 서버, 게이트웨이 DNS, 그리고 제3자가 재현할 수 있는 검증 절차.