# 追踪消息。理解证据。

Canonical page: https://phishdestroy.github.io/TgWitness/zh/docs/

立即进行首次捕获，了解证据的运作原理，然后构建您所需的配置。

[交互式现场指南**带来改变。看看证据能捕捉到什么。** 回放消息历史记录、修改记录并追踪其哈希值。 浏览视觉指南](https://phishdestroy.github.io/TgWitness/zh/docs/concepts/) [## 模式、场景和证据级别 采集范围、事件边界、八种验证机制以及六个虚构的调查场景。](https://phishdestroy.github.io/TgWitness/zh/guides/modes.html)

## 您捕获的第一条消息

[### 几分钟内即可开始使用 请使用示例数据试用 TgWitness，随后在 Windows、Linux 或 macOS 上启动您自己的 Telegram 监控工作区。](https://phishdestroy.github.io/TgWitness/zh/docs/start/)[### 专用账号 请准备一个单独的 Telegram 账号用于数据采集。](https://phishdestroy.github.io/TgWitness/zh/docs/dedicated-account/)[### 连接账户 可通过二维码、电话号码或会话导入连接 Telegram。选择消息来源，并确认新消息已成功记录到您的日志中。](https://phishdestroy.github.io/TgWitness/zh/docs/accounts/)[### 选择代理 维护自动 MTProxy 路由，或使用您自己的代理。选择 IP 模式、备用规则以及外部请求的路由。](https://phishdestroy.github.io/TgWitness/zh/docs/proxies/)[### 导出与验证 导出捕获的 Telegram 聊天记录，验证签名，并将日志与独立见证人保留的检查点进行比对。](https://phishdestroy.github.io/TgWitness/zh/docs/exports/)[### GitHub Actions 捕获 在临时 GitHub Runner 上导出一个 Telegram 聊天记录。](https://phishdestroy.github.io/TgWitness/zh/docs/capture/)

## 边试用边学习

[### 了解证据如何运作 追踪一条消息从捕获到检查点的全过程。修改一条示例记录，重新计算其 SHA-256 链，并查看保留的检查点会检测到什么。](https://phishdestroy.github.io/TgWitness/zh/docs/concepts/)[### 跨所有聊天记录进行调查 在频道、群组、私聊和机器人中开展端到端的 Telegram 调查：包括整个账户的捕获、历史记录、联系人、链接、文件、时间线以及经过验证的证据。](https://phishdestroy.github.io/TgWitness/zh/docs/cases/)[### 确保安全 了解会话、密钥和证据的存储位置，哪些数据会离开您的设备，保护措施涵盖哪些内容，以及如何加强系统安全性。](https://phishdestroy.github.io/TgWitness/zh/docs/security/)

## 仅添加必要内容

[### 浏览存档 加载历史记录、搜索已保存记录、审查 AI 来源并连接您的工具。](https://phishdestroy.github.io/TgWitness/zh/docs/archive/)[### 分享案例 为审查员和分析师提供对选定账户和聊天的访问权限，并设置独立的权限、会话限制和可撤销的令牌。](https://phishdestroy.github.io/TgWitness/zh/docs/access/)[### 设置 Witness 机器人 通过独立的见证节点（配备专属密钥及只读收集器访问权限），将签名的日志检查点发布至您的 Telegram 频道。](https://phishdestroy.github.io/TgWitness/zh/docs/witness/)[### 保持其运行 请在配备持久化存储、私有控制面板访问权限、备份功能以及重启后自动检查机制的服务器上运行 TgWitness。](https://phishdestroy.github.io/TgWitness/zh/docs/server/)[### 查找问题所在 请使用针对各问题的正确信号，检查控制面板访问权限、Telegram 连接状态、消息缺失情况、FloodWait 状态以及见证状态。](https://phishdestroy.github.io/TgWitness/zh/docs/troubleshooting/)

## 完整参考资料

本项目所有文档均在此呈现，并附有相应图表。指南提供了快速入门路径；而这些页面则包含所有细节。

设置

[快速入门](https://phishdestroy.github.io/TgWitness/zh/docs/reference/quickstart/)[账户与会话格式](https://phishdestroy.github.io/TgWitness/zh/docs/reference/accounts/)[访问与权限](https://phishdestroy.github.io/TgWitness/zh/docs/reference/access/)[连接、代理和数据保护](https://phishdestroy.github.io/TgWitness/zh/docs/reference/connection/)[部署](https://phishdestroy.github.io/TgWitness/zh/docs/reference/deployment/)

收集

[数据采集原理](https://phishdestroy.github.io/TgWitness/zh/docs/reference/collection/)[加载源代码历史记录](https://phishdestroy.github.io/TgWitness/zh/docs/reference/history/)[工作流程与操作](https://phishdestroy.github.io/TgWitness/zh/docs/reference/operations/)[调查模式](https://phishdestroy.github.io/TgWitness/zh/docs/reference/investigation/)[功能与限制](https://phishdestroy.github.io/TgWitness/zh/docs/reference/features/)

存档与集成

[存档分析](https://phishdestroy.github.io/TgWitness/zh/docs/reference/analysis/)[只读 MCP](https://phishdestroy.github.io/TgWitness/zh/docs/reference/mcp/)[本地 OCR 和转录](https://phishdestroy.github.io/TgWitness/zh/docs/reference/media-analysis/)[外发 webhook](https://phishdestroy.github.io/TgWitness/zh/docs/reference/webhooks/)

证据

[证据的运作原理](https://phishdestroy.github.io/TgWitness/zh/docs/reference/how-it-works/)[证据格式](https://phishdestroy.github.io/TgWitness/zh/docs/reference/evidence/)[独立见证者](https://phishdestroy.github.io/TgWitness/zh/docs/reference/witness/)[时间戳](https://phishdestroy.github.io/TgWitness/zh/docs/reference/timestamp/)

安全与项目

[安全与数据处理](https://phishdestroy.github.io/TgWitness/zh/docs/reference/security/)[架构](https://phishdestroy.github.io/TgWitness/zh/docs/reference/architecture/)[已测试的内容](https://phishdestroy.github.io/TgWitness/zh/docs/reference/verification/)[许可协议与架构不兼容声明](https://phishdestroy.github.io/TgWitness/zh/docs/reference/license/)[运营商兼容性通知](https://phishdestroy.github.io/TgWitness/zh/docs/reference/notice/)[更新日志](https://phishdestroy.github.io/TgWitness/zh/docs/reference/changelog/)