# TgWitness · 한국어 > Documentation edition: 한국어. Project version: `0.9.3`. 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. Sections without a translation appear in English. - [Project context, installation, measured scale and verification](https://phishdestroy.io/tgwitness/docs/reference/overview/index.md) - [English project summary](https://phishdestroy.io/tgwitness/llms.txt) - [Complete handbook · 한국어](https://phishdestroy.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.io/tgwitness/ko/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [아카이브 활용하기](https://phishdestroy.io/tgwitness/ko/docs/archive/index.md): 이력을 불러오고, 저장된 기록을 검색하며, AI 출처를 검토하고, 사용 중인 도구와 연동하세요. - [GitHub Actions 캡처](https://phishdestroy.io/tgwitness/ko/docs/capture/index.md): 임시 GitHub 실행기에서 Takeout, 일반 API 내보내기 또는 채팅 기록을 선택하세요. - [전용 계정](https://phishdestroy.io/tgwitness/ko/docs/dedicated-account/index.md): 데이터 수집을 위해 별도의 텔레그램 계정을 준비하십시오. - [몇 분 만에 시작하세요](https://phishdestroy.io/tgwitness/ko/docs/start/index.md): 명령어 하나로 설치하고 Telegram 계정을 연결한 뒤 Windows, Linux 또는 macOS에서 검증 가능한 아카이브를 내보내세요. - [계정 연결](https://phishdestroy.io/tgwitness/ko/docs/accounts/index.md): QR 코드, 전화번호 또는 세션 가져오기를 통해 텔레그램을 연결하세요. 소스를 선택하고 새 메시지가 저널에 정상적으로 수신되는지 확인하세요. - [프록시 선택](https://phishdestroy.io/tgwitness/ko/docs/proxies/index.md): 자동 MTProxy 경로를 유지하거나 사용자 지정 프록시를 사용하세요. IP 모드, 대체 규칙 및 외부 요청에 대한 경로를 선택하세요. - [내보내기 및 검증](https://phishdestroy.io/tgwitness/ko/docs/exports/index.md): 캡처된 텔레그램 기록을 내보내고, 서명을 검증하며, 저널을 독립적인 증인이 보관하고 있는 체크포인트와 비교할 수 있습니다. - [증거가 어떻게 활용되는지 확인하기](https://phishdestroy.io/tgwitness/ko/docs/concepts/index.md): 메시지가 캡처된 시점부터 체크포인트에 도달할 때까지의 경로를 추적해 보세요. 샘플 기록을 변경하고, 해당 기록의 SHA-256 체인을 재계산한 후, 보존된 체크포인트가 이를 어떻게 감지하는지 확인해 보세요. - [모든 채팅을 대상으로 조사하기](https://phishdestroy.io/tgwitness/ko/docs/cases/index.md): 채널, 그룹, 비공개 채팅 및 봇 전반에 걸쳐 텔레그램 종단 간 조사를 수행하세요: 전체 계정 캡처, 기록, 참여자, 링크, 파일, 타임라인 및 검증된 증거. - [케이스 보드 구축하기](https://phishdestroy.io/tgwitness/ko/docs/case-board/index.md): 비공개 보드에 저장된 관찰 내용, 정확한 하이라이트 및 작업 단편을 수집하고, 팀과 논의한 후 수집 결과를 제시하십시오. - [보고서 설계](https://phishdestroy.io/tgwitness/ko/docs/reports/index.md): 보고서 데이터, 8가지 디자인 중 하나 및 내용을 선택한 후, 미리 보기를 확인하고 HTML, 서명된 PDF 또는 완전한 증거 패키지로 내보내십시오. - [공유용 사본을 준비하십시오](https://phishdestroy.io/tgwitness/ko/docs/handover/index.md): 수신자가 수신할 수 있는 기록과 필드를 선택하고, 완성된 사본을 검토한 후 서명된 매니페스트와 소스 저널 경계를 확인하십시오. - [계정 그룹 관리](https://phishdestroy.io/tgwitness/ko/docs/groups/index.md): 그룹 작업 공간을 비교하고, 출처를 찾으며, 관찰 기간을 검토하고, 계정별 예외 사항을 적용하여 공유 설정을 적용하십시오. - [보안을 유지하세요](https://phishdestroy.io/tgwitness/ko/docs/security/index.md): 세션, 키 및 증거가 어디에 저장되는지, 시스템 외부로 전송되는 정보는 무엇인지, 보안 조치가 어떤 범위를 포함하는지, 그리고 설치 환경을 어떻게 강화할 수 있는지 확인하십시오. - [사례 공유하기](https://phishdestroy.io/tgwitness/ko/docs/access/index.md): 검토자와 분석가에게 별도의 권한, 세션 제한 및 취소 가능한 토큰을 통해 선별된 계정 및 채팅에 대한 접근 권한을 부여합니다. - [Witness 봇 설정하기](https://phishdestroy.io/tgwitness/ko/docs/witness/index.md): 별도의 증인(witness), 고유한 키, 읽기 전용 수집기(collector) 액세스 권한을 통해 서명된 기록부 체크포인트를 텔레그램 채널에 게시하세요. - [제로 트러스트를 선택해야 하는 이유: 테일러 웨싱, 츠르하이데 박사, 셸린스키 박사](https://phishdestroy.io/tgwitness/ko/docs/signed-export/index.md): 제로 트러스트 사례 연구: 테일러 웨싱(Taylor Wessing)의 패트릭 주르하이데(Patrick Zurheide) 박사와 토비아스 셸린스키(Tobias Schelinski) 박사가 서명한 GDPR 대응 방안으로, 해당 문서 자체를 대조하여 검증되었으며, 기만이나 의심의 여지를 전혀 남기지 않았을 검증 가능한 모델을 바탕으로 작성되었다. - [계속 운영해 주세요](https://phishdestroy.io/tgwitness/ko/docs/server/index.md): TgWitness는 영구 저장소, 전용 패널 액세스, 백업 기능 및 재시작 후 점검 기능이 갖춰진 서버에서 실행하십시오. - [문제가 발생한 원인을 파악하세요](https://phishdestroy.io/tgwitness/ko/docs/troubleshooting/index.md): 각 문제에 맞는 신호를 사용하여 패널 액세스, 텔레그램 연결, 누락된 메시지, FloodWait 및 위트니스 상태를 확인하십시오. ### Reference - [비밀 채팅: 설정 및 기록](https://phishdestroy.io/tgwitness/ko/docs/reference/secret-chats/index.md): 비밀 채팅 프로토콜 추가 구성 요소를 설치하고 계정별로 활성화한 뒤, TgWitness가 생성하거나 수락한 채팅을 기록하세요. - [TgWitness: 시작, 규모 및 증거](https://phishdestroy.io/tgwitness/ko/docs/reference/overview/index.md): 단일 명령어로 설치하거나 GitHub Actions에서 캡처하십시오. 조사 옵션, 공개된 규모, 아카이브가 검증하는 내용을 이해하십시오. - [소스 기록 불러오기](https://phishdestroy.io/tgwitness/ko/docs/reference/history/index.md): 활성화된 소스의 과거 메시지를 불러오고, 일시 중지 및 재시작하며, 서명된 진행 보고서를 검증할 수 있습니다. - [아카이브 분석](https://phishdestroy.io/tgwitness/ko/docs/reference/analysis/index.md): 저장된 메시지를 검색하고, AI 입력 내용을 검토하며, 출처 참조 정보가 포함된 분석 보고서를 보관할 수 있습니다. - [명령줄](https://phishdestroy.io/tgwitness/ko/docs/reference/cli/index.md): 스크립트 및 에이전트를 통해 메시지를 검색하고, 문맥을 확인하며, 활동 횟수를 집계하고, 저장된 메시지를 내보낼 수 있으며, --json 출력, 안정적인 종료 코드 및 범위 지정된 읽기 전용 토큰을 지원합니다. - [전체 텍스트 검색](https://phishdestroy.io/tgwitness/ko/docs/reference/search/index.md): 저장된 메시지를 단어 형태, 정확한 구문, 도메인 및 @사용자명으로 검색하며, 서명된 저널에 인덱스가 연동되어 가장 일치도가 높은 결과부터 우선적으로 표시됩니다. - [읽기 전용 MCP](https://phishdestroy.io/tgwitness/ko/docs/reference/mcp/index.md): 만료 및 취소 가능한 액세스 권한을 통해 MCP 클라이언트를 선택한 작업 공간 및 채팅에 연결합니다. - [로컬 OCR 및 텍스트 변환](https://phishdestroy.io/tgwitness/ko/docs/reference/media-analysis/index.md): 로컬 워커를 통해 캡처된 이미지와 오디오를 인식하고, 추출된 텍스트를 원본 파일과 연결된 상태로 유지합니다. - [발신 웹훅](https://phishdestroy.io/tgwitness/ko/docs/reference/webhooks/index.md): HMAC 서명, 재시도 및 전달 상태를 포함하여 지정된 범위의 이벤트를 HTTPS 수신자에게 전송합니다. - [운영자 호환성 불일치 공지](https://phishdestroy.io/tgwitness/ko/docs/reference/notice/index.md): Taylor Wessing에 대한 당사의 운영자 공지 및 그 출처 기록. - [라이선스 안내 및 아키텍처 비호환성 공지](https://phishdestroy.io/tgwitness/ko/docs/reference/license/index.md): TgWitness는 모든 사용자에게 MIT 라이선스가 적용되며, 이것이 Taylor Wessing 워크플로우와 아키텍처적으로 호환되지 않는 이유입니다. - [빠른 시작](https://phishdestroy.io/tgwitness/ko/docs/reference/quickstart/index.md): TgWitness를 설치하고 실행하는 모든 방법: Windows 패키지, Python, Docker 및 종합 데모와 초기 점검 절차. - [계정 및 세션 형식](https://phishdestroy.io/tgwitness/ko/docs/reference/accounts/index.md): 전화번호, QR 코드 또는 인증 키로 로그인하고, Telethon, Pyrogram 또는 Telegram Desktop 세션을 가져와 여러 계정을 동시에 운영할 수 있습니다. - [접근 및 권한](https://phishdestroy.io/tgwitness/ko/docs/reference/access/index.md): 계정 및 채팅에 대한 접근 권한을 제한하고, 권한을 선택하며, 세션 및 IP 주소를 제한하고, 접근 권한을 철회할 수 있습니다. - [연결, 프록시 및 데이터 보호](https://phishdestroy.io/tgwitness/ko/docs/reference/connection/index.md): 인증, 자동 프록시 풀, IP 모드, 대체 정책, 외부 요청 및 비밀 정보 저장. - [배포](https://phishdestroy.io/tgwitness/ko/docs/reference/deployment/index.md): TgWitness를 Windows, Linux, macOS 또는 Docker 환경에서 HTTPS를 통해 서비스 형태로 실행할 수 있으며, 백업 및 업데이트 기능이 제공됩니다. - [데이터 수집 방식](https://phishdestroy.io/tgwitness/ko/docs/reference/collection/index.md): 관찰 범위, 실시간 업데이트, 재확인, 첨부 파일, 사용자 작업 및 ‘갭(gap)’의 의미 등을 기록 단위로 상세히 설명합니다. - [워크플로우 및 운영](https://phishdestroy.io/tgwitness/ko/docs/reference/operations/index.md): 패널의 일상적인 운영: 모드, 모니터링 범주, 매개변수, 알림, 내보내기, 백업 및 용량. - [조사 모드](https://phishdestroy.io/tgwitness/ko/docs/reference/investigation/index.md): 채널, 그룹, 비공개 채팅 및 봇에 걸친 전체 계정 조사: 조사 범위 설정부터 검증된 사건 자료 패키지 구성까지. - [Case Board 참조](https://phishdestroy.io/tgwitness/ko/docs/reference/case-board/index.md): 북마크, 정확한 하이라이트, 액션 슬라이스, 토론, 범위 지정 액세스 및 Case Board에서 사용하는 서명된 주석 내역. - [보고서 구성 및 검증](https://phishdestroy.io/tgwitness/ko/docs/reference/case-reports/index.md): 보고서 필터, 8가지 디자인, 콘텐츠 사전 설정, 저장된 변경 내역 및 서명된 내보내기 파일에 포함된 평가 결과가 제공됩니다. - [기능 및 범위](https://phishdestroy.io/tgwitness/ko/docs/reference/features/index.md): TgWitness의 현재 수집 모델, 다중 계정 워크플로우, 내보내기 기능 및 운영 범위. - [증거 기록의 작동 방식](https://phishdestroy.io/tgwitness/ko/docs/reference/how-it-works/index.md): 해시 체인, 서명, 체크포인트 및 위트니스에 대해 검증자가 사용하는 정확한 수식을 바탕으로 설명합니다. - [증거 형식](https://phishdestroy.io/tgwitness/ko/docs/reference/evidence/index.md): 서명된 ZIP 파일의 내용, 기록 유형, 처리 내역, 사용자 프로필, 외부 백업본 및 오프라인 검증. - [독립적인 증인](https://phishdestroy.io/tgwitness/ko/docs/reference/witness/index.md): 자체 키와 봇을 사용하여 위트니스를 실행하고, 서명된 체크포인트를 채널에 게시한 후, 내보낸 데이터를 이를 기준으로 대조하여 확인하십시오. - [타임스탬프](https://phishdestroy.io/tgwitness/ko/docs/reference/timestamp/index.md): 서명된 체크포인트에 대한 RFC 3161 타임스탬프: 인증 기관에 전송되는 내용과 응답을 검증하는 방법. - [법원 제출용 보고서 번역](https://phishdestroy.io/tgwitness/ko/docs/reference/translation/index.md): 어떤 파일이 원본인지, 인증 번역과 함께 무엇을 제출하는지, 번역가가 유지하는 용어. - [보안 및 데이터 처리](https://phishdestroy.io/tgwitness/ko/docs/reference/security/index.md): 위협 모델, 접근 모델, 저장된 기밀 정보, 네트워크 노출, 세션 가져오기 및 취약점 보고 방법. - [아키텍처](https://phishdestroy.io/tgwitness/ko/docs/reference/architecture/index.md): 컬렉터, 패널, 저널, 워커 및 위트니스의 구성 요소와 이들 간에 데이터가 어떻게 이동하는지 설명합니다. - [테스트된 내용](https://phishdestroy.io/tgwitness/ko/docs/reference/verification/index.md): 실시간 텔레그램 테스트, 자동화된 점검, 브라우저 점검 및 다음 검증 실행. - [변경 내역](https://phishdestroy.io/tgwitness/ko/docs/reference/changelog/index.md): 아직 공개되지 않은 변경 사항을 포함하여 버전별 모든 변경 내역. - [패널 가이드](https://phishdestroy.io/tgwitness/ko/docs/reference/panel/index.md): 패널의 모든 화면: 채팅, 일지, 소스, 내보내기, 추가 기능, 보호 모드 및 코드 확인. - [초기 설정 및 구성](https://phishdestroy.io/tgwitness/ko/docs/reference/settings/index.md): 설정 마법사, 목표, 인터페이스 수준, 연결 경로 및 계정 그룹에서 공유되는 설정. - [설치, 확인 및 업데이트](https://phishdestroy.io/tgwitness/ko/docs/reference/installation/index.md): 단 한 줄의 명령어로 설치하고, 서명과 해시를 확인하며, 업데이트 및 제거할 수 있습니다. - [저장 및 복구](https://phishdestroy.io/tgwitness/ko/docs/reference/storage/index.md): 백업, 오래된 파일을 클라우드로 이동, Object Lock 하의 복사본, 새 기기에서 복구. - [계정 내보내기](https://phishdestroy.io/tgwitness/ko/docs/reference/account-export/index.md): 계정이 현재 읽을 수 있는 내용을 내보내기: 범위, 재개 가능한 작업, 서명된 아카이브 및 최소화된 공유 사본. - [공개 쇼케이스](https://phishdestroy.io/tgwitness/ko/docs/reference/showcase/index.md): 선택한 공개 채널의 저장된 메시지와 서명된 스냅샷을 유효 기간이 정해져 있고 취소 가능한 링크를 통해 게시합니다. - [고신뢰도 배포](https://phishdestroy.io/tgwitness/ko/docs/reference/high-assurance/index.md): Hetzner 또는 Phala Cloud에 구축된 24시간 연중무휴 보안 서버, 게이트웨이 DNS, 그리고 제3자가 재현할 수 있는 검증 절차.