# 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/zh/llms-full.txt) - [Complete handbook as Markdown · 简体中文](https://phishdestroy.github.io/TgWitness/zh/llms-full.md) - [Source code and release history](https://github.com/phishdestroy/TgWitness) - [Collection modes and evidence levels](https://phishdestroy.io/tgwitness/zh/guides/modes.md) - [Published checks and measurements](https://phishdestroy.io/tgwitness/docs/validation/index.md) ## Complete documentation map ### Guides - [浏览存档](https://phishdestroy.io/tgwitness/zh/docs/archive/index.md): 加载历史记录、搜索已保存记录、审查 AI 来源并连接您的工具。 - [GitHub Actions 捕获](https://phishdestroy.io/tgwitness/zh/docs/capture/index.md): 在临时 GitHub runner 上选择 Takeout、常规 API 导出或聊天日志. - [专用账号](https://phishdestroy.io/tgwitness/zh/docs/dedicated-account/index.md): 请准备一个单独的 Telegram 账号用于数据采集。 - [几分钟内即可开始使用](https://phishdestroy.io/tgwitness/zh/docs/start/index.md): 通过一条命令安装,连接 Telegram 账号,即可在 Windows、Linux 或 macOS 上导出可验证的存档。 - [连接账户](https://phishdestroy.io/tgwitness/zh/docs/accounts/index.md): 可通过二维码、电话号码或会话导入连接 Telegram。选择消息来源,并确认新消息已成功记录到您的日志中。 - [选择代理](https://phishdestroy.io/tgwitness/zh/docs/proxies/index.md): 维护自动 MTProxy 路由,或使用您自己的代理。选择 IP 模式、备用规则以及外部请求的路由。 - [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/exports/index.md): 导出捕获的 Telegram 聊天记录,验证签名,并将日志与独立见证人保留的检查点进行比对。 - [了解证据如何运作](https://phishdestroy.io/tgwitness/zh/docs/concepts/index.md): 追踪一条消息从捕获到检查点的全过程。修改一条示例记录,重新计算其 SHA-256 链,并查看保留的检查点会检测到什么。 - [跨所有聊天记录进行调查](https://phishdestroy.io/tgwitness/zh/docs/cases/index.md): 在频道、群组、私聊和机器人中开展端到端的 Telegram 调查:包括整个账户的捕获、历史记录、联系人、链接、文件、时间线以及经过验证的证据。 - [创建案件看板](https://phishdestroy.io/tgwitness/zh/docs/case-board/index.md): 在私人看板上收集已保存的观察结果、精确标注和操作片段,与团队讨论并提交证据集合。 - [设计报告](https://phishdestroy.io/tgwitness/zh/docs/reports/index.md): 选择报告数据、八种设计模板之一及内容,然后预览并导出 HTML、带签名的 PDF 或完整的证据包。 - [准备一份共享副本](https://phishdestroy.io/tgwitness/zh/docs/handover/index.md): 选择收件人可接收的记录和字段,检查最终副本,并验证其已签名的清单及源日志边界。 - [管理一组账户](https://phishdestroy.io/tgwitness/zh/docs/groups/index.md): 比较群组工作区、查找来源、审查观察时段,并应用共享设置(可针对每个账户设置例外)。 - [确保安全](https://phishdestroy.io/tgwitness/zh/docs/security/index.md): 了解会话、密钥和证据的存储位置,哪些数据会离开您的设备,保护措施涵盖哪些内容,以及如何加强系统安全性。 - [分享案例](https://phishdestroy.io/tgwitness/zh/docs/access/index.md): 为审查员和分析师提供对选定账户和聊天的访问权限,并设置独立的权限、会话限制和可撤销的令牌。 - [设置 Witness 机器人](https://phishdestroy.io/tgwitness/zh/docs/witness/index.md): 通过独立的见证节点(配备专属密钥及只读收集器访问权限),将签名的日志检查点发布至您的 Telegram 频道。 - [为何选择零信任:泰勒·韦辛律师事务所、祖尔海德博士、舍林斯基博士](https://phishdestroy.io/tgwitness/zh/docs/signed-export/index.md): 一项零信任案例研究:由泰勒·韦辛律师事务所的帕特里克·祖尔海德博士和托比亚斯·谢林斯基博士签署的《通用数据保护条例》(GDPR)答复,该答复已与其自身文件进行核对,并采用了可核查的模型,该模型确保了毫无欺骗或疑虑的余地。 - [保持其运行](https://phishdestroy.io/tgwitness/zh/docs/server/index.md): 请在配备持久化存储、私有控制面板访问权限、备份功能以及重启后自动检查机制的服务器上运行 TgWitness。 - [查找问题所在](https://phishdestroy.io/tgwitness/zh/docs/troubleshooting/index.md): 请使用针对各问题的正确信号,检查控制面板访问权限、Telegram 连接状态、消息缺失情况、FloodWait 状态以及见证状态。 ### Reference - [秘密聊天:设置与记录](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/index.md): 安装秘密聊天协议扩展,按账户启用,并记录 TgWitness 创建或接受的聊天。 - [TgWitness:开始、规模与证据](https://phishdestroy.io/tgwitness/zh/docs/reference/overview/index.md): 通过一条命令安装,或在 GitHub Actions 上进行捕获。了解调查选项、已发布的规模以及存档所验证的内容。 - [加载源代码历史记录](https://phishdestroy.io/tgwitness/zh/docs/reference/history/index.md): 从已启用的来源加载历史消息,暂停和恢复操作,并验证带签名的进度报告。 - [存档分析](https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/index.md): 搜索已保存的消息、审查 AI 输入内容,并保存附有来源参考信息的分析报告。 - [命令行](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/index.md): 支持通过脚本和代理进行搜索、阅读上下文、统计活动以及导出已保存的消息,提供 --json 输出格式、稳定的退出代码以及作用域限定的只读令牌。 - [全文搜索](https://phishdestroy.io/tgwitness/zh/docs/reference/search/index.md): 根据词形、精确短语、域名和 @用户名 查找已保存的消息,按最匹配结果优先排序,索引与签名日志绑定。 - [只读 MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/index.md): 将 MCP 客户端连接到选定的工作区和聊天群组,并授予具有时效性且可撤销的访问权限。 - [本地 OCR 和转录](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/index.md): 通过本地工作进程识别捕获的图像和音频;将生成的文本与源文件保持关联。 - [外发 webhook](https://phishdestroy.io/tgwitness/zh/docs/reference/webhooks/index.md): 将带 HMAC 签名的指定范围事件发送至 HTTPS 接收端,支持重试并提供投递状态。 - [运营商兼容性通知](https://phishdestroy.io/tgwitness/zh/docs/reference/notice/index.md): 关于 Taylor Wessing 及其来源记录的操作员通告。 - [许可协议与架构不兼容声明](https://phishdestroy.io/tgwitness/zh/docs/reference/license/index.md): TgWitness 采用 MIT 许可证向所有人开放,并解释了其架构为何与 Taylor Wessing 的工作流程不兼容。 - [快速入门](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/index.md): 安装和启动 TgWitness 的所有方法:Windows 安装包、Python、Docker 以及综合演示,并附带初步测试。 - [账户与会话格式](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/index.md): 支持通过手机、二维码或授权密钥登录,可导入 Telethon、Pyrogram 或 Telegram Desktop 的会话数据,并同时管理多个账户。 - [访问与权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/index.md): 设置账户和聊天室的访问权限范围,选择权限类型,限制会话和 IP 地址,并撤销访问权限。 - [连接、代理和数据保护](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/index.md): 身份验证、自动代理池、IP 模式、备用策略、外部请求及密钥存储。 - [部署](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/index.md): 可在 Windows、Linux、macOS 或 Docker 环境中将 TgWitness 作为服务运行,通过 HTTPS 访问,并支持备份和更新。 - [数据采集原理](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/index.md): 观察范围、实时更新、复核、附件、用户操作以及“缺口”的含义,逐条记录。 - [工作流程与操作](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/index.md): 控制面板的日常操作:模式、监控类别、参数、通知、导出、备份及容量。 - [调查模式](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/index.md): 涵盖频道、群组、私聊和机器人的全账户调查,从调查范围到经过验证的案件资料包。 - [“案件看板”参考](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/index.md): 书签、精确高亮、操作片段、讨论、范围访问以及“案件看板”所使用的签名注释历史记录。 - [报告配置与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/index.md): 报告过滤器、八种设计模板、内容预设、已保存的变更历史记录以及评估结果均包含在已签名的导出文件中。 - [功能与范围](https://phishdestroy.io/tgwitness/zh/docs/reference/features/index.md): TgWitness 的当前采集模型、多账户工作流、导出功能及操作边界。 - [证据的运作原理](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/index.md): 通过验证者实际使用的精确公式,详细解释了哈希链、签名、检查点和见证人等概念。 - [证据格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/index.md): 签名 ZIP 文件的内容、记录类型、操作收据、用户资料、异地副本及离线验证。 - [独立见证者](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/index.md): 运行一个带有独立密钥和机器人的 Witness 实例,将签名后的检查点发布到频道中,并据此验证导出数据。 - [时间戳](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/index.md): 签名检查点采用 RFC 3161 时间戳:向认证机构发送的内容以及如何验证响应。 - [为法院翻译报告](https://phishdestroy.io/tgwitness/zh/docs/reference/translation/index.md): 哪个文件是原件、应与认证译文一同提交什么,以及译者应保留的术语。 - [安全与数据处理](https://phishdestroy.io/tgwitness/zh/docs/reference/security/index.md): 威胁模型、访问模型、静态机密、网络暴露、会话导入以及如何报告漏洞。 - [架构](https://phishdestroy.io/tgwitness/zh/docs/reference/architecture/index.md): 收集器、控制面板、日志、工作进程和见证程序的组成部分,以及数据在它们之间如何流动。 - [已测试的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/index.md): Telegram 实时测试、自动化检查、浏览器检查以及后续的验证运行。 - [更新日志](https://phishdestroy.io/tgwitness/zh/docs/reference/changelog/index.md): 按版本列出的所有变更,包括尚未发布的变更。 - [面板指南](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/index.md): 面板的每个界面:聊天、日志、来源、导出、扩展功能、保护模式和代码检查。 - [初始设置与配置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/index.md): 设置向导、目标、界面层级、连接路径以及账户组共享的设置。 - [安装、验证和更新](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/index.md): 只需一条命令即可完成安装、验证签名和哈希值,以及更新和卸载该工具。 - [存储与恢复](https://phishdestroy.io/tgwitness/zh/docs/reference/storage/index.md): 备份、将旧文件移至云端、Object Lock 下的副本以及在新设备上的恢复。 - [账户导出](https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/index.md): 导出该账户当前可读取的内容:范围、可恢复的任务、经签名的存档以及已缩减的共享副本。 - [公开展示](https://phishdestroy.io/tgwitness/zh/docs/reference/showcase/index.md): 通过有效期有限且可撤销的链接,发布所选公共频道的已保存消息和已签名的快照。 - [高可信度部署](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/index.md): 部署在 Hetzner 或 Phala Cloud 上的全天候密封服务器、网关 DNS 以及第三方可复现的验证机制。 --- # Telegram · 几分钟内即可开始使用 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/start/ 通过一条命令安装,连接 Telegram 账号,即可在 Windows、Linux 或 macOS 上导出可验证的存档。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 只需一条命令即可完成安装,连接 Telegram 账号并选择需要保存的内容。 ## 在您的计算机上安装 安装程序包含 Python 及其依赖项。请从聊天记录导出开始;在需要时添加观察和调查工具。 ### Linux / macOS ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` ### Windows · PowerShell / CMD ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` Ubuntu 服务器:以 root 身份运行。桌面版:以普通用户身份运行。 打开安装程序显示的面板地址,并使用其访问密钥。然后连接您的 Telegram 账户。面板密钥与您的 Telegram 授权是分开的。 [安装、签名和更新](https://phishdestroy.io/tgwitness/docs/reference/installation/) 说明了下载的构建版本、本地访问和服务器选项。[源代码和 Docker 说明](https://phishdestroy.io/tgwitness/docs/reference/quickstart/) 仍可使用。 ## 选择您的第一个任务 1. [通过手机号码、二维码或支持的会话导入方式连接账户](https://phishdestroy.io/tgwitness/zh/docs/accounts/)。 2. 选择聊天、文件夹或账户范围。 3. [导出所选历史记录](https://phishdestroy.io/tgwitness/docs/reference/account-export/),或开始观察以记录未来的变更。 4. [使用单独的可信密钥指纹对存档文件](https://phishdestroy.io/tgwitness/zh/docs/exports/)进行验证。 ## 使用临时 GitHub Runner [《GitHub Actions 捕获指南》](https://phishdestroy.io/tgwitness/docs/capture/)将引导您完成分支、授权、作用域和存档密码的设置。运行完成后,请下载加密结果及其工作流溯源信息。此工作流无需永久收集服务器。 ## 无需注册即可浏览 [打开浏览器演示版](https://phishdestroy.github.io/TgWitness/demo/?lang=zh),在安装任何软件之前,先浏览虚构的消息、比较编辑内容并检查导出文件。 ![TgWitness 对话视图及示例消息](https://phishdestroy.io/tgwitness/assets/chats-dark.png?v=684f81f890cc) 一个示例工作区。您的日志将单独创建。 ## 继续调查 对于正在进行的工作,请根据您的案例需求添加所需的来源、文件政策、搜索、报告和共享权限。[启动、扩展与证据;](https://phishdestroy.io/tgwitness/docs/reference/overview/) 解释了相关选项及已发布的测量数据。 如需进行服务器安装,请参阅《[保持运行》](https://phishdestroy.io/tgwitness/zh/docs/server/)。 --- # 请使用独立账户,切勿使用您的主账户。 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/dedicated-account/ 请准备一个单独的 Telegram 账号用于数据采集。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 连接账户前请先阅读 我们建议您不要使用主账号,这绝非玩笑,而是现实。 主账户 - 使用您自己的应用哈希,99% 的账户都会被注销 - 仅因“信任度低”而导致账号被封的情况屡见不鲜 - 使用你的主账号是一个非常愚蠢的主意 基于公共 API ID/API 哈希对的额外账户 - 已有超过一百万个账户通过这些 API ID/API 哈希对注册 - 这些 API ID/API 哈希对已持续有效超过 5 年 - 任何人都无法通过这些 API 对查看您的任何数据 01 ## 为什么绝对不能使用您的主账号 这是准确的信息。我们清楚地知道这些问题存在哪些隐患。 1. ### 使用您自己的应用哈希,99% 的账户都会被注销 如果使用一个你无权访问的账户登录 my.telegram.org 以获取应用哈希,随后通过该应用哈希发送任何请求,则该账户被注销的概率高达 99%。你可以亲自验证一下。 2. ### 仅因“信任度低”而导致账号被封的情况屡见不鲜 账号被封禁仅仅是因为 Telegram 不信任它们,此类封禁情况十分常见。你也可以自行核实这一点。使用自己的账号确实是个极其愚蠢的主意。 3. ### 已复制的会话密钥可以被撤销 在 Telegram Desktop 和 TgWitness 中同时运行导入的 TData/会话密钥可能会触发 `AUTH_KEY_DUPLICATED` 错误。Telegram 会使该授权失效,因此两个副本都需要重新登录。使用专用账户也无法避免此情况。 请完全退出原始客户端,并在使用其导入的会话期间保持该客户端关闭状态。如需并行使用,请通过手机或二维码登录 TgWitness 以建立独立的授权;其他已单独授权的客户端可保持登录状态。 [请阅读会话导入警告](https://phishdestroy.github.io/TgWitness/demo/guide.html?lang=zh#session-warning) Telegram 文档 - [注销错误:AUTH_KEY_UNREGISTERED、SESSION_REVOKED](https://core.telegram.org/api/errors) - [创建您自己的应用哈希:获取 api_id](https://core.telegram.org/api/obtaining_api_id) 02 ## 为什么 TgWitness 通过公开的应用哈希和应用 ID 对来工作 正因如此,我们基于公开的应用哈希/应用 ID 对构建了 TgWitness。按照我们的逻辑,使用这些对被封禁的可能性较低:已有超过一百万个 Telegram 账户通过这些对注册,且许多不同的程序都通过它们运行。 依我们的逻辑,这比直接使用个人应用哈希更稳妥:这些哈希-ID 对肯定已经存在了 5 年以上。 ### 您自己的新 API ID/API 哈希对 由该账户在 my.telegram.org 上创建。 - 其中约 99% 的账户会被自动注销 - 一个新应用,一个账户 ### 来自池中的公共 API ID/API 哈希对 这与许多程序所使用的 API ID/API hash 对相同。 - 注册账户已超过一百万个 - 多种不同的程序 - 这些 API 对已稳定运行 5 年以上 ### 为什么没有人能通过这些 API 对查看您的任何数据 - #### 该 API 配对是一个名称,而非键 当程序连接或请求登录码时,Telegram 会要求提供 API ID 和 API 哈希。这些信息用于识别应用程序,但不会授予任何账户的访问权限;Telethon 的文档指出,一组 API ID 和 API 哈希可适用于任何手机号码。 - #### 您的会话密钥绝不会离开您的服务器 登录时,您的 TgWitness 与 Telegram 之间会通过迪菲-赫尔曼(Diffie–Hellman)密钥交换生成一个授权密钥;该密钥本身绝不会被发送出去。根据 Telegram 的文档说明:授权后,该密钥将与用户绑定,使用此密钥的每次调用均以该用户身份执行。其他拥有相同密钥对的程序各有自己的密钥,无法使用您的密钥。 - #### 数据传输使用您的密钥进行加密 每个请求和响应均使用会话授权密钥进行加密,而非 API 哈希值。仅知晓 API 哈希值无法解密任何内容。 - #### API ID/API hash 对的所有者无法看到任何内容 Telegram 没有通过 API ID 列出账户、会话或消息的方法。账户所有者只能在 my.telegram.org 上查看其应用设置。 - #### 只有您的账户能看到这是哪个应用 在“设置”→“您自己的账户设备”中,会列出每个会话的应用名称、API ID、设备、IP 地址和日期。除您本人外,任何人都无法查看此列表。 Telegram 文档 - [用户授权:密钥将与用户绑定](https://core.telegram.org/api/auth) - [auth.sendCode: api_id, api_hash](https://core.telegram.org/method/auth.sendCode) - [initConnection](https://core.telegram.org/method/initConnection) - [创建 MTProto 授权密钥](https://core.telegram.org/mtproto/auth_key) - [MTProto 加密](https://core.telegram.org/mtproto/description) - [account.getAuthorizations](https://core.telegram.org/method/account.getAuthorizations) - [Telegram授权(会话)条目包含的内容](https://core.telegram.org/constructor/authorization) - [获取 api_id](https://core.telegram.org/api/obtaining_api_id) - [Telegram 应用的开源代码](https://telegram.org/apps#source-code) 库和讨论帖 - [Telethon:登录 Telegram](https://docs.telethon.dev/en/stable/basic/signing-in.html) - [opentele:官方应用的 API 凭据](https://opentele.readthedocs.io/en/latest/documentation/authorization/api/) - [opentele: TelegramClient](https://opentele.readthedocs.io/en/latest/documentation/telethon/telegramclient/) - [Stack Overflow:是否应将 api_hash 保密?](https://stackoverflow.com/questions/49490818/should-telegram-api-hash-be-kept-secret) ### 其他程序中相同的 API ID/API 哈希对 7 官方 Telegram 应用的 API ID/API 哈希对是公开的,并已集成到许多独立程序和库中: - [opentelePython · src/api.py](https://github.com/anmv/opentele/blob/4df17bd8c443d6452afc5a2d29ec7922fad1a5c3/src/api.py#L575) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [opentele2Rust · opentele2-core/src/api.rs](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/api.rs#L641) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [GrampoPython · Grampo/ut/api.py](https://github.com/abbas-bachari/Grampo/blob/00aa662d853c4ac2180432371c5e0d9444bbfe9e/Grampo/ut/api.py#L526) - Desktop 2040 - Android 6 - Telegram X 21724 - iOS 10840 - macOS 2834 - Web 2496 - [tgmanagePython · api/schemas/api_app.py](https://github.com/xdsnich/tgmanage/blob/f67c46be0ab234bd04526a8663d3936bd98a8597/api/schemas/api_app.py#L47) - Android 6 - iOS 8 - Desktop 2040 - macOS 2834 - Telegram X 21724 - Web K 2496 - [LyChatBotTDLib · helpers/tdlib/index.js](https://github.com/LyoSU/LyChatBot/blob/fac0ae5d5f2cddb8a26312014f51c0f6f40ec191/helpers/tdlib/index.js#L11) - macOS 2834 - [hsadasdPython · config.py](https://github.com/herobrinovaleksandr-png/hsadasd/blob/6842c74895038c16e219324fcd07dbe8153f37f0/config.py#L68) - Desktop 2040 - Desktop 17349 - Telegram X 21724 - macOS 2834 - iOS 10840 - Web 2496 - +4 - [blb.teamblb.team/threads/…294](https://blb.team/threads/app-hash-app-id-ofitsial-nykh-kliyentov.294/) - Android 4 · 5 · 6 - iOS 8 - Desktop 2040 - Desktop 17349 - macOS 2834 - Telegram X 21724 一篇列出了官方 Telegram 应用的 API ID/API hash 对的论坛帖子,发布目的是用于注册账户 03 ## 创建额外账户的方法 Telegram 账号需要一个用于接收登录验证码的手机号码。请根据该账号的预期使用时长进行选择。 - 最佳选择 ### 预付费 SIM 卡或 eSIM ******** 有效期有多长 只要您保持余额充足 请注意 最可靠的方法:Telegram 最能接受真实的手机号码。运营商收回的号码会被分配给其他人。 - ### 一款提供虚拟电话号码的应用程序 ******** 有效期有多长 只要该应用保留该手机号码 请注意 Telegram 可能会拒绝虚拟号码、不发送验证码,或立即限制新账户的使用;某些应用会收回未使用的号码。 - ### 租用电话号码 ******** 有效期有多长 关于租赁期限 请注意 当该号码用完后,将分配给下一位客户。 - ### 一次性激活 ******** 有效期有多长 仅需一个登录码 请注意 该号码会立即返回号码池,通常附带之前所有者的使用记录。请务必在进行其他操作之前先设置云端密码。 日后持有该号码的人可以请求登录码。云密码(两步验证)可阻止其登录;若未输入该密码,该账户将归属于该号码的下一任持有者。 Telegram 文档 - [垃圾信息常见问题解答:虚拟号码及其前任所有者](https://telegram.org/faq_spam) - [两步验证](https://core.telegram.org/api/srp) ### 租赁的 +888 号码(Fragment) 部分市场和平台提供通过 Fragment 临时租用 Telegram 官方 +888 号码的服务。 预计价格:每天 20 美元。 - 您可以在 Telegram Web 或 Telegram Desktop 中直接注册账户。 - 您可以删除该号码下的账户并创建新账户。 - 此类账号通常面临较少的反欺诈审查,但并不因此享有豁免权或特殊特权。 该账号不属于您。租赁期满后,所有者可将其收回。请立即设置云密码,且不要将该账号视为长期使用。 自行持有 +888 号码或使用您控制的预付费 SIM 卡仍然更为可靠。 ### 来自交易平台的现成账户 部分交易平台(例如 G2G 或 Z2U)出售现成的 Telegram 账号——包括新账号、老账号或附带会话文件的账号。 - [G2G:Telegram 账号列表](https://www.g2g.com/uk/categories/telegram-accounts) - [Z2U:Telegram 账号列表](https://www.z2u.com/telegram/accounts-5-15140) 切勿使用您的主账号!通过此方式创建的专用账号,仍比将您的主要 Telegram 账号绑定到 TgWitness 更为安全。 #### 购买前的警告 - 这违反了 Telegram 的《服务条款》。 - 许多账号属于批量注册(自动注册)或历史信息不明。 - 部分卖家可能仍持有恢复权限。 - 来自此类市场的账号往往会在后期遭到封禁或限制。 - 请避免使用公开销售账号窃取工具、钓鱼工具或明显为盗取账号的市场平台。 - 从公开销售钓鱼工具、窃取工具、被盗会话或账户的平台上购买账户——即使是标榜为“自动注册”的账户——不仅违反了 Telegram 的《服务条款》,也违反了大多数国家的法律。这可能会导致您的证据日后失效。请谨慎选择。 #### 如果您使用此选项 1. 将该账号视为一次性账号。 2. 请立即结束所有其他会话,设置云密码并更改恢复方式。 3. 请使用来自不同服务商或您自行注册的 2–3 个账户。 **Premium、删除及七天延迟** 如果该账号开通了 Premium 服务,即使有人获得了该手机号码的访问权限,也无法立即删除该账号。您会收到通知,并在账号被删除前有七天的处理时间。 这一点至关重要,因为您的调查工作依赖于该账号:您还有时间准备一个替代账号。 **新账户和 API 凭据** 如果您通过短信服务获取的号码注册了新账户,并从中获取和使用自己的 api_id/api_hash,则该账户将在首次 API 请求或会话授权时被强制注销。在规划调查时请务必牢记这一点。 04 ## 创建账户 从获取手机号码到记录第一条聊天记录。 1. ### 获取电话号码 若账户需长期使用,建议选用预付费 SIM 卡或 eSIM;若仅用于短期任务,则可选择租赁或一次性激活。相关服务如下所示。 2. ### 请使用与主账户不同的账户注册 请在官方 Telegram 应用中,通过另一台设备、模拟器或手机配置文件进行注册,切勿与您的主账户在同一设备上操作。 3. ### 使用云密码保护该账号 请立即设置一个仅用于此处的云密码和恢复邮箱。 4. ### 限制该账号的隐私设置 电话号码:**无人**,通过号码查找我;**我的联系人**、最后上线时间、个人头像和简介:**无人**或**我的联系人**;关闭联系人同步。 5. ### 防止账号自动销毁 请将账户自动销毁时限设置为最长,这样即使 TgWitness 停止运行,您的账户也不会因此丢失。 6. ### 为该账号设置中性的个人资料 不包含您其他账户的姓名、照片、用户名或个人简介,也不包含个人联系人信息。 7. ### 让新账号进行预热 起初,每天只加入几个聊天群。新账号若操之过急,往往会率先受到限制。 8. ### 不与机器人共享任何信息 切勿点击机器人上的“分享电话号码”或“分享位置”按钮。请通过该设备上的 VPN 或代理打开链接和迷你应用。 9. ### 将该账户连接到 TgWitness 在您自己的工作区中,通过**“账户”→“二维码**”进行连接,然后点击**“来源”→“调查模式”**。该应用是您操作的场所,TgWitness 则是记录工具。 Telegram 文档 - [两步验证](https://core.telegram.org/api/srp) - [隐私设置](https://core.telegram.org/api/privacy) - [账户长期闲置时的自动销毁机制](https://core.telegram.org/method/account.setAccountTTL) 05 ## 电话号码服务 以下是可供参考的起始选项。国家/地区、价格以及 Telegram 是否接受特定号码等信息经常变化,因此请在付款前确认。 ### 预付费 SIM 卡和 eSIM 11 - [SMARTYsmarty.co.uk](https://smarty.co.uk) - UK - SIM - [VOXIvoxi.co.uk](https://www.voxi.co.uk) - UK - SIM - [iD Mobileidmobile.co.uk](https://www.idmobile.co.uk) - UK - SIM - [Threethree.co.uk](https://www.three.co.uk) - UK - SIM - [Asda Mobilemobile.asda.com](https://mobile.asda.com) - UK - SIM - [Ultra Mobileultramobile.com](https://www.ultramobile.com) - US - 预付费 PayGo 套餐,价格非常便宜 - [US Mobileusmobile.com](https://www.usmobile.com) - US - 预付费 - [Mint Mobilemintmobile.com](https://www.mintmobile.com) - US - 预付费 - [Tracfonetracfone.com](https://www.tracfone.com) - US - 预付费 - [eSIM Plusesimplus.me](https://esimplus.me) - eSIM - [Numero eSIMnumeroesim.com](https://numeroesim.com) - eSIM ### 提供虚拟电话号码的应用程序 20 - [Google Voicevoice.google.com](https://voice.google.com) - US 仅限美国;注册需提供美国电话号码 - [TextNowtextnow.com](https://www.textnow.com) - US - CA 若未使用该编号,系统将收回该编号 - [TextFreetextfree.us](https://www.textfree.us) - US - [2ndLine2ndline.co](https://www.2ndline.co) - US - CA - [Talkatonetalkatone.com](https://www.talkatone.com) - US - [TextMego-text.me](https://go-text.me) - US - CA - 其他国家 - [textPlustextplus.com](https://textplus.com) [Google Play](https://play.google.com/store/apps/details?id=com.gogii.textplus) - [FreeToneGoogle Play](https://play.google.com/store/apps/details?id=com.textmeinc.freetone) - US [TextMe Up · textmeup.com](https://www.textmeup.com) - [Nextplusnextplus.me](https://nextplus.me) - US - [Dingtonedingtone.me](https://www.dingtone.me) - US - CA - [Burnerburnerapp.com](https://www.burnerapp.com) - US - CA - 付费服务 附带试用期 - [Hushedhushed.com](https://hushed.com) - 许多国家 - 付费服务 低价 - [Sidelinesideline.com](https://www.sideline.com) - US - [MySudomysudo.com](https://mysudo.com) - US - CA - UK - [2NumberGoogle Play](https://play.google.com/store/apps/details?id=com.bpmobile.second.phone) [App Store](https://apps.apple.com/app/id1216135390) - [SLYNUMBERslynumber.com](https://slynumber.com) [Google Play](https://play.google.com/store/apps/details?id=com.dev.slynumber) - [Phonerphonerapp.com](https://phonerapp.com) - [Onoffonoff.app](https://www.onoff.app) - EU 应用程序中的欧洲手机号码 - [Sonetelsonetel.com](https://sonetel.com) - 许多国家 - 免费号码 - [Zadarmazadarma.com](https://zadarma.com) - 许多国家 虚拟电话号码 ### 电话号码租赁和一次性激活 12 租用电话号码可让您在数周或数月内持续使用该号码。一次性激活会生成一个登录验证码:请在注册后立即设置云端密码。 - [OnlineSimonlinesim.io](https://onlinesim.io) - 号码租赁 - 一次性激活 - [SMSPVAsmspva.com](https://smspva.com) - 号码租赁 - 一次性激活 - [5SIM5sim.net](https://5sim.net) - 号码租赁 - 一次性激活 - [SMSPoolsmspool.net](https://www.smspool.net) - 号码租赁 - 一次性激活 - [VAK-SMSvak-sms.com](https://vak-sms.com) - 号码租赁 - 一次性激活 - [TextVerifiedtextverified.com](https://www.textverified.com) - 号码租赁 - 一次性激活 - [JuicySMSjuicysms.com](https://juicysms.com) - 号码租赁 - 一次性激活 - [365SMS365sms.org](https://365sms.org) - 号码租赁 - 一次性激活 - [SIMSMSsimsms.org](https://simsms.org) - 号码租赁 - 一次性激活 - [GrizzlySMSgrizzlysms.com](https://grizzlysms.com) - 一次性激活 - [SMS-MANsms-man.com](https://sms-man.com) - 一次性激活 - [Tiger SMStiger-sms.com](https://tiger-sms.com) - 一次性激活 --- # Telegram · 连接账户 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/accounts/ 可通过二维码、电话号码或会话导入连接 Telegram。选择消息来源,并确认新消息已成功记录到您的日志中。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 一个工作区 = 一个账户、它的日志和它的密钥。 ## 选择登录方式 **账户** → 添加工作区 → 连接设置。请为此使用单独的账户。 - **二维码:**在 Telegram 的“设备”页面扫描并确认。 - **电话号码:**号码、验证码,如有两步验证再输入密码。 - **会话导入:**您自己的会话文件或 Telegram Desktop 数据。 使用内置 API 配置或您自己的 API ID 和 hash。它只用于标识应用,不会让您登录,也不会隐藏任何东西。 **需要先设置代理吗?** 您可以在登录前[选择并测试连接路径](https://phishdestroy.io/tgwitness/zh/docs/proxies/)。每个账户都有其专属的连接路径。 ## 选择监控内容 1. 选择您需要的聊天、群组或频道。 2. 检查采集设置,包括媒体。 3. 启动后检查连接和最近活动。 账户必须有访问权限。管理员和成员看到的内容不同,日志显示的是这个账户收到的内容。 整个账户?**来源 → 观察范围 → 调查模式**,检查后点击**保存范围**。完整步骤:[调查整个账户](https://phishdestroy.io/tgwitness/zh/docs/cases/)。 ## 检查完整路径 在测试群组中,用另一个账户发送一条消息,编辑它,再删除它。这三个事件都应出现在日志中。然后[导出并验证](https://phishdestroy.io/tgwitness/zh/docs/exports/)。 “已连接”表示连接正常。捕获到测试消息才说明事件确实送达。 ## 添加另一个账户 在**账户**中新建工作区,步骤相同。请记下每个账户的密钥指纹,以便日后区分导出。 --- # Telegram · 选择代理 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/proxies/ 维护自动 MTProxy 路由,或使用您自己的代理。选择 IP 模式、备用规则以及外部请求的路由。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 保持账户在线,并由您自己决定它是否可以暴露服务器的 IP。 ## 请先选择 IP 模式 01**隐藏地址** 仅使用代理。如果都不可用,就等待。 02**直接操作作为最后手段** 延迟后直连,一旦有代理可用就切回代理。 03**服务器需位于隧道或 VPN 之后** 可以直连。它不会替您设置或检查 VPN。 路由决定连接方式。IP 模式决定是否允许直接连接。 ## 让池来维护路由 1. **账户 → 设置 → 连接设置**。 2. 选择 IP 模式和**自动 MTProxy**,或固定路由。 3. 保存,然后**测试 Telegram 连接**(登录前也可用)。 4. 开始采集,并给自己发送一条测试消息。 新工作区默认使用自动 MTProxy 并开启**隐藏地址**。代理池拉取四个公共列表,检查服务器,保留好用的,替换失效的。 ## 请使用您自己的代理服务器 SOCKS5、HTTP CONNECT、Telegram 代理链接或运营方目录。切换前请暂停观察。Fake TLS 密钥(`ee`…)不可用。 **轮换、共享和重试设置** **参数 → 自动 MTProxy**:失败阈值、冷却时间、轮换、每个代理的账户数。上限为 1 表示账户宁可等待也不共享。不同的代理仍可能共用同一个出口 IP。 ## 将 Telegram 与外部请求区分开来 MTProxy 只承载 Telegram 流量。时间戳、通知、副本和代码检查走单独的 SOCKS5/HTTP 代理、账户的 SOCKS5/HTTP 路由,或在模式允许时直连。也可以关闭它们。 `TGWITNESS_PROXY_FEED_PROXY` 设置下载列表所用的路由。[见证人](https://phishdestroy.io/tgwitness/zh/docs/witness/)有自己的设置。这些都不会影响您的浏览器或系统网络。 更多:[模式和默认值](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/#ip-modes),[谁可以更改路由](https://phishdestroy.io/tgwitness/zh/docs/access/)。 --- # Telegram · 导出与验证 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/exports/ 导出捕获的 Telegram 聊天记录,验证签名,并将日志与独立见证人保留的检查点进行比对。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 交给对方可以自行对照您的工作区核查的文件。 保留引用导出带签名的 ZIP 文件收件人验证 不熟悉签名和检查点?[修改一条示例记录](https://phishdestroy.io/tgwitness/zh/docs/concepts/#chain),看看哪项检查能发现它。 想将副本存放在收集者之外的地方?请前往 [S3 设置](https://phishdestroy.io/tgwitness/zh/docs/exports/#s3)、[对象锁定](https://phishdestroy.io/tgwitness/zh/docs/exports/#s3-retention)或[经过验证的恢复功能](https://phishdestroy.io/tgwitness/zh/docs/exports/#s3-restore)。 ## 保留一份值得信赖的参考资料 请将工作区密钥指纹记录在采集器以外的其他位置。在采集过程中,请开启取证模式,以便检查点获得符合 RFC 3161 和 OpenTimestamps 标准的时间戳,或者运行一个向公共频道发布消息的[见证](https://phishdestroy.io/tgwitness/zh/docs/witness/)节点。请将签名后的检查点也保存在其他位置:接收方会根据这些检查点验证密钥、时间以及之前的日志状态。 ## 下载带签名的 ZIP 文件 **导出** → 签名证据 ZIP。其中包含完整日志和签名文件清单。可在 [Report studio](https://phishdestroy.io/tgwitness/zh/docs/reports/) 中制作易读的报告,或仅将选定数据作为[移交摘要](https://phishdestroy.io/tgwitness/zh/docs/handover/)发送。 HTML、PDF 和 JSON 报告带有各自的封印。CSV 只是工作副本;如需完整性,请使用已验证 ZIP 中的 CSV。 ## 请使用可信的 TgWitness 副本进行验证 在项目环境中,使用您自己的指纹和路径: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` 通过验证时,会显示`key_pinned: true`和`checkpoint_checked: true`。`--require evidence`还需提供最后一条记录的第三方时间戳,例如已验证的时间戳:检查点是用您自己的密钥签名的,因此仅凭检查点本身是不够的。请将该输出结果与存档文件放在一起。检查点必须位于导出文件的末尾或之前。 ## 使用验证结果 - **文件:**清单绑定它们的哈希,签名绑定日志。任何改动都会暴露。 - **身份:**您保存的指纹证明这就是您预期的密钥。 - **早期状态:**检查点将导出与移交前保存的日志前缀进行比较。 - **覆盖范围:**空缺、获取结果以及“发送 → 编辑 → 删除”测试表明这套配置实际捕获了什么。 详情:[验证能证明什么](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)。 ## 设置 S3 异地备份 在工作区中打开**导出 → 异地副本**。支持 AWS S3 以及任何兼容 S3 的存储。它会复制日志分段、已保存文件、带时间戳的检查点和已完成的聊天导出,每一项在离开采集器之前都用 `AES-256-GCM` 加密。 在线演示中这些控件可见,但上传已关闭。请只在您自己的安装中输入真实凭据。 [![完整的异地备份配置面板:端点、区域、存储桶、访问密钥、计划任务、对象锁定及恢复密钥控制](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4)](https://phishdestroy.io/tgwitness/assets/off-site-copy.png?v=f9ad551ec1f4) 展开后显示包含高级选项的完整面板。未显示任何存储凭据。 | 字段 | 输入内容 | | --- | --- | | 端点 | 存储 URL,不含存储桶路径或凭据。示例:`https://s3.example.invalid`。 | | 地区 | 按服务商要求填写。默认 `us-east-1`。 | | 存储桶 | 一个您有写入权限的现有存储桶。示例:`example-case-backup`。 | | 存储桶中的文件夹 | 前缀,默认 `tgwitness`。其上还会追加每个工作区的前缀。 | | 访问密钥 ID / 秘密访问密钥 | 两者一起填写,保存在保险库中。之后两者都留空即可保留原值。 | | 路径风格的地址 | 开启:`endpoint/bucket`。关闭:`bucket.endpoint`。取决于服务商。 | | 复制间隔 | 1 至 1,440 分钟,默认 5。仅在应用运行时生效。 | | Object Lock 数据保留 | 天数和模式,前提是存储桶支持 Object Lock。填 0 则保留存储桶默认值。 | 1. 创建存储桶,在不勾选**保留异地副本**的情况下填写目标和凭据,点击**保存异地副本**。 2. **测试连接**会上传一个加密的测试对象。 3. **下载加密密钥**,并保存在远离采集器的地方。没有密钥就无法恢复。 4. 勾选**保留异地副本**,保存,然后**立即复制**,或让计划任务运行。 ## 查看数据保留及复制进度 在**更多选项**中选择保留天数以及 `GOVERNANCE` 或 `COMPLIANCE`。TgWitness 会从已上传的对象中读回保留设置并告诉您:已确认、缺失或检查失败。 面板显示上一轮、对象数量、字节数、已复制的日志边界和错误。缺失的本地文件会被报告并在下一轮重试,其余内容继续复制。 上传可走直连、SOCKS5 或 HTTP。如果路由只有 MTProxy,副本会带着错误等待。 ## 请将恢复密钥单独保存 密钥 JSON 包含解密密钥、目标、前缀和密钥指纹。恢复时需要它以及具有读取权限的存储凭据。 更改了端点、存储桶或前缀?请重新下载密钥。新的副本会从新目标开始;旧的聊天导出留在原处。 ## 在另一台机器上恢复并验证 您需要一个可信的 TgWitness 安装、密钥 JSON、只读存储凭据和一个空文件夹: ### Windows PowerShell ``` $env:TGWITNESS_S3_ACCESS_KEY = 'YOUR_READ_ACCESS_KEY' $env:TGWITNESS_S3_SECRET_KEY = 'YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` ### Linux / macOS ``` export TGWITNESS_S3_ACCESS_KEY='YOUR_READ_ACCESS_KEY' export TGWITNESS_S3_SECRET_KEY='YOUR_READ_SECRET_KEY' python -m tgwitness.replica restore --key-file tgwitness-replica-key.json --out restored-evidence ``` 所有内容会先在私有临时文件夹中检查:完整日志、检查点、文件哈希和大小。不安全的路径、相互冲突的分段,或比其检查点更短的日志都会导致失败,此时不会写出任何内容。 成功后您会得到 `events.jsonl`、`media/`、`checkpoints/` 和 `exports/`。请将命令的 JSON 输出与它们放在一起,并与您自己保存的检查点或见证记录进行比较。 --- # Telegram · GitHub Actions 捕获 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/capture/ 在临时 GitHub runner 上选择 Takeout、常规 API 导出或聊天日志. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 在临时 GitHub runner 上选择 Takeout、常规 API 导出或聊天日志. 请启用 JavaScript 以生成密钥并解密您的存档文件。 **完整引用** [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/OPTIONAL-CAPTURE.md) ![独立捕获](https://phishdestroy.io/tgwitness/assets/chapter-capture.svg?v=c979502bc92b) **可从 `main` 预览。**一个分支会从 `phishdestroy/TgWitness`。该工作流通过新创建的 Telegram 会话导出账户、选定的聊天记录或某条 聊天的事件日志,对证据 ZIP 文件或多部分清单进行认证,并仅上传 收件人加密的交接数据。常规管理面板不会对外公开。 选择 `client=official_web` 以运行带受保护的Telegram Web控件和视频功能的[官方客户端见证](https://github.com/phishdestroy/TgWitness/blob/main/docs/OFFICIAL-WITNESS.md)程序。这需要您自己的上游代理,并仅监视一个已渲染的聊天窗口。默认情况下 `client=api` 保留了下文所述的完整账户导出模式。 验证器会根据 GitHub 证明、已批准的 工作流和收集器提交记录,以及已签名的日志和附件哈希值,对归档文件进行核对。 收集过程使用固定的上游代码和新的存储空间。审核员 可以检查该代码,并根据记录的运行情况对交付的归档文件进行验证。 **本页内容** - [用户流程](https://phishdestroy.io/tgwitness/zh/docs/capture/#user-flow) - [会议时间安排](https://phishdestroy.io/tgwitness/zh/docs/capture/#session-time-budget) - [选择此模式或持久化工作区](https://phishdestroy.io/tgwitness/zh/docs/capture/#choose-this-mode-or-a-persistent-workspace) - [什么是公开的,什么必须保密](https://phishdestroy.io/tgwitness/zh/docs/capture/#what-is-public-and-what-must-stay-private) - [故障排除](https://phishdestroy.io/tgwitness/zh/docs/capture/#troubleshooting) - [本地解密与验证](https://phishdestroy.io/tgwitness/zh/docs/capture/#local-decryption-and-verification) - [分叉如何被保留在捕获过程之外](https://phishdestroy.io/tgwitness/zh/docs/capture/#how-the-fork-is-kept-outside-the-capture-process) - [加密交接](https://phishdestroy.io/tgwitness/zh/docs/capture/#cryptographic-handoff) - [范围与验证](https://phishdestroy.io/tgwitness/zh/docs/capture/#scope-and-validation) - [维护者发布流程](https://phishdestroy.io/tgwitness/zh/docs/capture/#maintainer-release-sequence) ## 用户 该辅助工具会讲解这五个阶段,并让您在示例数据上尝试消息或收集器 替换。**点击开始捕获**即可打开向导。 1. 在项目主页、 工作区登录界面或**导出→打开捕获助手**中选择**GitHub Actions 捕获(预览版)**。您还可以 在现代浏览器中,从可信的代码检出中打开[官方助手](https://phishdestroy.github.io/TgWitness/sealed.html?lang=en) 或 `tgwitness/static/capture.html`。 该辅助程序在处理密钥或 文件时不会发起任何网络请求。该辅助程序支持本网站的界面语言; 临时收集面板支持英语和俄语,当浏览器语言为上述两种之一时, 面板将以该语言显示。 2. 生成密钥并保存 **sealed-key.json** 文件。这是唯一的 私有解密密钥。复制单独的**收件人**公钥值。一旦丢失 私有密钥,将无法访问连接和归档文件。 请确认已保存该密钥,以便解锁下一步。如果您已有 交付文件,请加载已保存的密钥,并选择**我已有归档文件**。 3. 分叉 TgWitness,在分叉中启用“操作”功能,并运行**密封聊天捕获**。 粘贴公开收件人,并选择 30、60 或 120 分钟。切勿在 工作流输入、提交、问题或日志中填写 电话号码、登录码、Telegram 密码、私钥或会话信息。 4. 运行期间,请从“构建产物”中下载 **sealed-connection** 并解压。 在 `connection.tgwsealed` ,并使用已保存的私钥。 生成的链接在其 URL 片段中包含一个随机的访问密钥。 请妥善保管此链接。控制面板会移除该片段,并将密钥 保存在此标签页的会话存储中;该密钥不会被记录在 HTTP 访问日志中。 5. 打开连接链接。使用二维码登录,或使用您的手机号码和 登录码登录。如果 Telegram 要求输入,请输入您的两步验证密码。默认情况下, 系统会使用内置的 API 凭据池,这与普通工作区一样。您 可以展开可选的自定义凭据部分,并输入以下两项 `api_id` 和 `api_hash` 来自 [my.telegram.org/apps](https://my.telegram.org/apps) 的信息。若要使用内置凭据池,请将这两个 字段均留空;不完整或格式错误的凭据对将被拒绝。 不允许导入会话。请选择导出模式和范围。连接 链接中包含访问密钥:请务必保密。 6. 选择**Telegram Takeout**、**常规 Telegram API**或**聊天事件日志**。 若要导出账户数据,请选择所有可访问的聊天记录,或加载并选择一个或多个 聊天记录,然后设置日期、聊天类型、账户类别和附件规则。 检查设置和大小,可选择将设置 JSON 保存供独立 审核人员查看,然后点击**开始捕获**。开始后设置即无法更改。 “恢复”功能仅在该运行器存在时有效;提前结束将保留已获取的 数据并记录缺失部分。开始后截止时间到期将生成一个明确的 部分存档;开始前到期或取消操作则不会生成任何存档。 7. 等待**密封结果**,下载并解压,然后在 `delivery.tgwsealed` 。您将收到 `delivery.zip`,其中包含 `evidence.zip`, `attestation.jsonl`以及操作说明。浏览器解密 上限为256 MiB;更大的包请使用下方的本地流式解密命令。 大型结果还包含 `delivery-NNNNNN.tgwsealed` 多个部分;主 `delivery.tgwsealed` 文件中包含 `evidence.parts.json` 和证明。 请下载所有部分,并按照下文所述在本地进行组装。 8. 如果撤销操作 未被确认,或者运行进程被终止,请在 Telegram 的“设置”→“设备”中结束临时会话。正常结束时会提示注销,且 运行记录会保存撤销操作是否已被确认。 该仓库必须包含已发布的“固定源代码”和“可重用工作流” 提交。仅有一个本地分支是无法被另一个 GitHub 仓库调用的。 ## 会议时间 在收取之前, **计算时间和大小** 根据消息数量和有限样本,估算所选历史数据和文件的 处理时间。显示内容包括已耗费的登录时间、 预估的收集时间以及打包所需的预留时间。对于文件,初始估算 采用 1 MiB/s 的速率和两倍的时间余量;进度条会用实际测得的 速率取代该假设。使用 **仅限消息** 或者,当预估时间超过剩余时间时,请选择较少的聊天记录。 Telegram 报告的“Takeout”等待时间已计入预算。当剩余时间需用于打包时,收集器会停止采集, 保留已采集的数据,并标记为部分 结果。因此,一个 120 分钟的会话会利用其剩余的采集窗口,而非 等到截止时间才开始准备归档。界面会标出那些 无法采样其完整大小的选项。 ## 选择此模式或持久化工作区 | 拍摄模式 | 可配置的范围 | 区别 | | --- | --- | --- | | Telegram Takeout,默认选项 | 所有可访问的云端聊天记录或选定的聊天记录、日期、账户类别、媒体策略以及 JSON/HTML 视图 | 使用 Telegram 的官方导出机制;可能需要批准或等待。在 Telegram 允许的情况下,Takeout 可以列出剩余的频道/群组,并请求获取额外的个人数据。 | | 常规 Telegram API | 账户范围和输出选项与常规 API 提供的相同,具体取决于常规 API 支持的方法 | 无法初始化 Takeout;无法枚举左通道/超级群组,也无法获取仅限 Takeout 的个人数据。联系人范围仅限于 Telegram 用户,而非完整的已保存手机通讯录。速率限制仍然适用。 | | 聊天活动日志 | 一条选定的聊天记录、附件政策和可选头像 | 记录本次运行过程中观察到的历史数据和变化。账户类别、日期筛选器以及与桌面端兼容的视图均不适用。 | 这三种模式均采用相同的 GitHub 认证和加密传输机制。Takeout 会选择数据获取方式,且绝不会被常规 API 访问悄然取代。 TgWitness 会根据捕获的记录生成 JSON/HTML 视图,并在导出时保留 所选的数据获取方式。请参阅 [官方 Takeout API](https://core.telegram.org/api/takeout)。 默认情况下,系统会导出“Takeout”中的内容,包括所有可访问的聊天类型(含存档聊天)、所有 日期、账户资料和联系人、兼容的 JSON 和 HTML 文件,以及文件下载。 初始媒体配额为 4 GiB,各文件类型均有可见的限制;对于较大文件 或下载配额已用尽的情况,系统将在可用时使用服务器哈希值。请在开始收集前查看这些 限制。哈希值无法还原文件。可选的照片、 故事、会话元数据和额外个人数据仍需单独选择。 在已建立的 Telegram 会话中,提取操作可能需要获得批准。Telegram 会设定 延迟时间;新的登录或运行程序无法绕过该延迟。最大捕获时限 为 120 分钟(包括登录和批准时间),因此大型账户或批准 等待时间过长的情况可能无法完成。持久的本地导出可以恢复同一会话,但 不会继承 GitHub 认证。 ### 确认并验证 **检查设置和大小**后,请使用**保存设置进行验证**。在 收集前与审核员确认 `sealed-export-settings.json` 与审阅者达成一致后再进行收集。 任何更改都会使已保存的评估失效。收集者对有效的 设置及其 SHA-256 值进行签名,而账户导出收据则绑定相同的选项。 验证者报告实际模式、选项及完整性,并拒绝 日志与嵌套账户导出之间存在不一致的情况。 ``` python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete ``` `--expected-selection` 拒绝其他传输方式、聊天范围、过滤器或 附件策略。 `--require-complete` 仅接受已标记为“已完成”的账户导出和聊天 日志。若未设置这些标志,验证过程仍会检查来源和 完整性,同时报告记录的设置及缺失项。在运行前确认预期的 选择范围,并将其与归档文件分开保存。范围和采集间隔用于确定运行期间捕获的 数据;在比较先前版本时,请使用保留的早期观测数据。 | 需求 | 模式 | | --- | --- | | 在有限的会话期间导出可访问的账户数据或选定的聊天记录,并向审核人员提供经外部认证的存档 | GitHub Actions 捕获(预览版) | | 持续关注多个聊天记录,管理账户,搜索并阅读不断扩充的存档 | 本地或 Docker 工作区 | 这将使用新的登录凭据启动一个独立的捕获任务。它不会上传您现有的 本地日志,也不会导出当前打开的工作区,也不会复用其 Telegram 会话。 未完成的云端捕获任务在运行器被销毁后无法继续;新的 工作流将启动一个新的捕获任务。 工作区中的**导出→打开捕获助手**会直接在面板内打开完整的向导。 独立页面使用相同的向导、控件和主题。 两者均将密钥和解密过程保存在您的浏览器中。GitHub 工作流启动和 临时 Telegram 面板会在单独的标签页中打开;向导会提示您何时 返回。锁定工作区会清除向导内存中的密钥。您保存的密钥 文件仍保留在您的设备上。 ## 什么是公开的,什么必须保密 收集过程在由 GitHub 托管的标准运行器上运行。GitHub(作为经批准的收集器) 及其依赖项、辅助页面、浏览器和 HTTPS 隧道都是该配置中 值得信赖的组件。临时主机负责处理 Telegram 会话和 明文消息;交付的构建产物会为接收方进行加密。 通过分叉将项目代码复制到你的代码库中。它会 **不** 导出您的 Telegram 账户。接收方的工作流输入是一个公钥。 保留 `sealed-key.json`,从提交记录、工作流输入和公共日志中提取 Telegram 凭据、登录码、双因素认证密码以及 已解密连接 URL。 该工作流会发布一天内的加密连接/结果工件。 请及时下载这两项内容;GitHub Actions 的可用性、账户限制和计费 规则均适用。公开分叉并不意味着可获得无限量的免费计算资源。无需在辅助程序中 输入任何付款信息或 GitHub 访问令牌。 私有解密密钥保存在您的浏览器/文件中。Telegram 会话内容 和明文记录必然存在于临时存储器中。 GitHub 和 HTTPS 隧道仍是可信的基础设施。认证可能会将 归档摘要和工作流标识公开;归档内容不会 包含在认证中。认证时间戳并非消息时间戳。 ## 故障排除 | 症状 | 下一步 | | --- | --- | | “不**运行”工作流**按钮 | 创建自己的分支,启用“操作”功能,并将其与上游同步 `main`。请勿修改已获批准的上游引脚以绕过失败。 | | 否 `sealed-connection` 文物 | 检查任务是否已启动并完成了启动/上传步骤。队列、运行器、镜像下载、隧道或仓库策略的故障都可能导致启动失败。 | | 无法建立连接 | 加载本次运行的已保存密钥,解压下载的构建产物,并选择 `connection.tgwsealed`。此时运行器必须仍处于活动状态。 | | 历史暂停了 | 检查面板的状态,并在会话仍处于活动状态时使用“继续”功能,或者利用已收集的数据完成操作。Telegram的限制和无法访问的内容可能会导致数据存在缺失。 | | 不 `sealed-result` | 如果在开始收集之前取消或到期,则不会生成存档;该运行将以**无存档**的提示结束。收集、认证或打包步骤出现失败也会导致无法交付;失败的步骤会注明主管给出的原因,且不包含任何私人数据。无需提交凭证即可进行检查。 | | 浏览器无法解密大型压缩包 | 对于大于 256 MiB 的包,请使用下面的流式处理 CLI。如果私钥错误或丢失,将无法解密结果。 | | 验证结果显示签名人被拒绝 | 请使用可信的最新 TgWitness 安装版本以及完全相同的调用者 `OWNER/REPOSITORY`。请勿接受存档中提供的替代策略。 | | Telegram 仍然显示该临时会话 | 请在“设置”→“设备”中结束该操作。注销可能会失败,且强制终止的工作流可能不会执行清理操作。 | 在依赖此预览版之前,请先进行一次由您控制的小规模测试:创建一条消息 和一个附件,将其收集起来,解密结果,运行验证程序,检查 覆盖范围/媒体结果,并确认 Telegram 会话已被撤销。自动化 检查使用的是合成 Telegram 客户端,并配合单独的真实 GitHub 证书 测试;目前尚未记录到在当前版本上使用真实账户进行的测试。 ## 本地解密与验证 请使用来自独立可信安装源的工具,而非 来自未知证据存档的可执行文件: ``` python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip # Unzip delivery.zip using your archive manager, then: python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` 对于分多部分交付的情况,请先解密主包,并将解压后的 清单文件放在每个加密部分旁边,然后运行: ``` python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness ``` 清单是经过验证的对象,它将所有部分与生成的 ZIP 文件绑定在一起。 使用 `--max-gib` 来为 大型归档文件设置适当的解压验证上限;默认值为 4 GiB。预期选择和完整范围检查 也适用于多部分传输。 Python 3.11 及以上版本、该项目的依赖项,以及支持 `--signer-digest` 和 `--deny-self-hosted-runners` 。此外还提供了一个 CLI 密钥生成器 : `python -m tgwitness.sealed_crypto keygen sealed-key.json`. 验证器使用 `tgwitness/sealed_policy.json` 来自受信任安装源的数据。 它会检查调用方仓库、上游签名者工作流、已批准签名者的 提交、托管运行器要求、完整的 ZIP 摘要、内部日志和 附件的完整性、最新的 account-key 来源,以及预期的收集器提交。 它会显示历史记录和媒体结果,而非默认所有数据均已保存。 若“已批准发布”列表为空,则验证失败。更新策略是一项明确的 信任决策;切勿自动接受归档文件自身提出的策略。 若需离线使用,请提前从可信环境获取可信根证书: ``` gh attestation trusted-root > trusted_root.jsonl python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl ``` 该证明的时间戳仅涉及存档方的承诺。它并不 对消息的时间戳或收集器的实际时间进行验证。请参阅 [GitHub 的验证选项](https://cli.github.com/manual/gh_attestation_verify)。 ## 如何将分叉保持在捕获过程之外 该调用包含对上游可重用工作流的作业级引用,引用基于 一个完整的提交 SHA。该工作流会显式检出 **上游仓库 在固定的收集器 SHA 处**. 默认值 `actions/checkout` 在可重用工作流中 会检出调用者,且该操作是故意不被使用的。 该工作流不会恢复调用者的缓存、消耗调用者的构建产物、执行 调用者的文件,也不会接受源/镜像 URL、shell 命令、预先准备好的 ZIP 文件, 或待签名的哈希值。它仅接受有限的公开接收者和会话时长。 操作、Python 基础镜像和 cloudflared 均通过不可变摘要进行固定; Python 依赖项使用现有的哈希锁定要求。该镜像 从可信来源构建,不使用缓存。 该收集器以非root用户身份运行,使用只读镜像,已移除Linux 能力,设置了资源限制,且不包含Docker套接字或GitHub令牌环境。 其仅挂载了新的配置目录、工作区和输出目录。 该受限的 FastAPI 应用程序提供了登录、对话、可配置的账户或聊天记录收集、 状态、恢复、结束和取消等功能。不存在明文下载路径、 通用管理路径、导入路径或签名端点。 在验证操作 读取最终修复版本之前,管理员会停止面向网络的容器 `evidence.zip` 或 `evidence.parts.json`。打包容器不具备网络连接。 上传步骤仅命名 `connection.tgwsealed` 和 `delivery*.tgwsealed`; 既不上传明文证据,也不上传 Telegram 凭据作为构建产物。 清理操作会移除私有目录和容器,GitHub 会在任务完成后销毁 托管的运行器虚拟机。构建产物保留期限为一天;请在过期前下载。 分支所有者可以替换调用者,或生成另一个签名的文件。 严格验证器必须拒绝由此产生的、**签名者不同的工作流/摘要**。 这种机制仍然依赖于已批准代码中不存在可被利用的漏洞, 以及 GitHub 运行器和签名基础设施的完整性。 ## 加密 每个接收方密钥均为 RSA-3072(也接受 RSA-4096 导入),指数为 65537。 每个信封都使用一个全新的随机 AES-256 密钥和 96 位随机数。 采用 SHA-256/MGF1-SHA256 的 RSA-OAEP 对 AES 密钥进行封装。采用 128 位标签的 AES-GCM 对 完整的前缀和有效载荷进行认证。收件人的公钥为 base64 编码的 DER SPKI 格式; 私钥文件包含 base64 编码的 DER PKCS8 格式。 封装字节包括 `TGWSEAL1\n`,包括一个大端序的 uint32 类型的 JSON 头部长度、 头部、密文以及一个 16 字节的 GCM 标记。头部长度恰好为 `algorithm`, `key`,以及 `nonce`;算法为 `RSA-OAEP-256+A256GCM`。从前缀 到头部之间的完整内容均为 GCM 附加认证数据。头部大小上限为 8192 字节。CLI 支持最多 8 GiB 的数据流,并在 安装请求的输出前进行认证;它拒绝覆盖现有目标。 这是一个围绕标准密码学原语构建的项目专用封装: RSA-OAEP 结合 SHA-256 和 AES-256-GCM,可在 OpenSSL 及所有主流 密码学库中使用。 在将证据和 认证信息放入加密的外层包**之前**,会对原始证据字节进行认证。这样可以避免 归档文件的哈希值与其自身包含的证书之间产生循环依赖。 对于公共仓库,认证元数据(仓库、工作流、提交、 工件名称和摘要)是公开的。切勿在公共元数据中包含聊天名称。 ## 范围与 此模式使用带签名的日志和账户导出引擎。秘密聊天、 收集前的已删除历史记录以及账户无法访问的数据均 被排除在外。若已选中,私有云聊天也符合条件。聊天选择器 上限为 20,000 个对话;账户导出功能会自动检测其库存。缺失的数据、失败的文件和未完成的 任务都会被记录下来。附件限制以及运行程序的磁盘/时间限制仍然适用。 大文件传输使用加密分段传输,而非固定的 4 GiB 传输上限。 “完成”指已冻结的选定任务已完成,并不意味着所有历史 Telegram 记录都存在于存档中。聊天日志也可观察实时 更新;这两种模式均非原子快照。生成的截图和屏幕 录像不属于此模式的范围。 测试内容涵盖合成新登录、作用域隔离、媒体、取消操作、 部分截止时间完成、注销失败、受限的 API 路径和字段、 预加载工作区拒绝、密钥错误和篡改拒绝、必需的验证器 标志,以及浏览器/Python 加密互操作性。浏览器验收 测试使用了一个明确标记的模拟证明;这不是真正的 Sigstore 测试。 真实的托管运行器、Docker、GitHub 证明以及实时 Telegram 验收 测试的结果必须与本地合成测试的结果分开报告。 [GitHub Actions 条款](https://docs.github.com/en/site-policy/github-terms/github-terms-for-additional-products-and-features#actions) 规定托管运行器的使用仅限于软件项目的生命周期内。分叉操作 不会解除这些限制;不得将此预览版宣传为无限制的 免费生产环境托管服务。[Cloudflare Quick Tunnels](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) 同样仅适用于测试和开发。helper/workflows 适合 用于评估此功能;生产环境的适用性仍是另一项 部署要求。 ## 维护者发布 1. 提交并审查收集器、监督器、容器定义和测试。 2. 将该收集器提交固定在 `sealed-collector.yml`,然后提交/审查该 可重用工作流。切勿默认从调用者的 SHA 值推导出检出版本。 3. 将可重用工作流的提交固定在 `sealed-witness.yml` ,并将它的 workflow/collector SHA 对添加到 `sealed_policy.json` 可信发布中。 4. 发布所有被引用的提交以及辅助程序,然后测试一个独立的分支 以及真正的 GitHub 证书。除非重新生成并再次发布这些引用,否则请勿将 这些引用的提交合并掉。 有关调用者存储库与上游签名者之间的区别,请参阅[可重用工作流和确认声明](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations/increase-security-rating) 。 --- # Telegram · 跨所有聊天记录进行调查 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/cases/ 在频道、群组、私聊和机器人中开展端到端的 Telegram 调查:包括整个账户的捕获、历史记录、联系人、链接、文件、时间线以及经过验证的证据。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 一个横跨频道、群组、私聊和机器人的完整案件:采集、串联线索、重建时间线、移交。 一个虚构事件,从头到尾。采集、搜索和人员档案找到记录,[Case Board](https://phishdestroy.io/tgwitness/zh/docs/case-board/) 整理它们,[Report studio](https://phishdestroy.io/tgwitness/zh/docs/reports/) 呈现它们。 已处理案例 / 支付目的地变更 ### 一起事件。四段对话。一条需要还原的线索。 一条频道帖子指向一个机器人。一个群组在讨论新的付款链接,机器人也显示了它。帖子被编辑,私聊中重复了该链接,一条群消息消失了。 每个版本是由谁发布的?该链接出现在哪里?哪个文件被保留下来了?有哪些变化,以及何时发生的? 历史加载、AI、MCP、OCR 和 webhook:[使用存档](https://phishdestroy.io/tgwitness/zh/docs/archive/)。 ## 1. 确保覆盖整个账户 整个账户范围仅用于专用账户。主账户只用选定的聊天或一个文件夹。 1. 在独立工作区中[连接账户](https://phishdestroy.io/tgwitness/zh/docs/accounts/)。记下案件编号、账户 ID、工作区和密钥指纹。 2. **来源 → 观察范围 → 调查模式**:**整个账户**、全部四种来源类型、**自身操作**。每个新聊天都会保存其资料和最近 **200 条可见消息**。点击**保存范围**并确认。 3. **加载聊天**并与账户的聊天列表比较。上限为 1,000 个对话(在**参数 → 从账户列表读取的聊天**中最多可设为 20,000);超出上限的聊天在变得活跃后才会出现。 4. **记录设置** → **所有可见活动**,检查附件限制和磁盘空间。启动后,用一条消息、一次编辑和一次删除进行测试。 频道群组私聊机器人 一个账户 / 一把签名密钥**所有选定的、账户可见的活动 → 整合为一本日志** 消息 · 编辑 · 删除通知 · 可见反应 · 成员活动 · 自身操作 “整个账户”指该账户能打开的每个聊天,减去排除项。私密聊天由 Secret Chats 模块记录。新聊天出现时即加入;旧历史按需加载。 ## 2. 获取历史记录并保存文件 创建一个 Case Board 集合,为重要内容添加书签。维护一份来源登记表:聊天 ID、标题、账户、角色、实时捕获开始时间、历史结果、媒体结果、空缺。 | 需求 | 面板中的操作 | 功能介绍 | | --- | --- | --- | | 已启用聊天记录的历史 | 来源 → 加载完整历史记录 | 可用的历史消息将进入工作区日志,支持暂停/恢复功能,并生成带签名的进度报告。[历史记录指南](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)。 | | 日志中的现有聊天记录 | 来源 → 记录设置 → 历史快照 | 最近的消息作为签名记录。默认 500 条,在**参数 → 最大历史快照**中最多可设为 10,000。 | | 某次聊天的当前可见完整历史记录 | 导出完整聊天记录 → 导出完整聊天记录,或 聊天 → 导出聊天记录 | 每个聊天一个独立的签名包,包含 `chat.json` 和 `chat.html`。 | | 新聊天出现时的上下文 | 监控范围 → 当出现新的聊天或机器人时 | 它的资料和最多 1,000 条最近消息(调查模式下为 200 条)。不适用于已有的聊天。 | | 附件字节数 | 下载可见附件 + 各类附件的限制 | 查找带 SHA-256 和大小的 `media.saved`。排队中、已跳过或失败都表示未保存。 | 聊天导出不会进入日志或人员档案。要在 TgWitness 内搜索旧历史,请使用**加载完整历史记录**或快照。 这里是:频道、群组、机器人聊天和私聊,以及发票文件及其哈希。捕获前已删除的内容已经没有了。 ## 3. 记录不断发展的对话以及您自身的行动 保持运行。将热点聊天加星标作为优先,在**记录设置 → 重新检查**中调整重新检查,并留意 `recheck.completed`、FloodWait 和媒体结果。 **聊天 → 个人资料 → 立即保存个人资料**会保存聊天的简介、机器人命令和其他元数据。 **作为案件调查的一部分,关注机器人或接受邀请** 1. **聊天 → 打开 Telegram 链接**,先保存预览。链接和预览会成为签名记录。 2. 如有需要,**加入 / 打开并观察**会加入聊天或用启动参数启动机器人。 3. 要记录某个操作,请在面板中回复或使用**按下按钮**。您会得到 `interaction.requested` 和 `interaction.result` 以及机器人的回答。 这些是真实操作。在其他应用中按下的按钮不可见,只能看到机器人的回复。不支持网页应用、付款或电话/位置。 ## 4. 追踪聊天记录中的人员、链接和文件 1. **日志**、**所有来源**,搜索短语、域名或用户名。打开结果并**添加到案板**。 2. **聊天 → 联系人 → 开启个人资料**,选择一个人:名称历史、回复、活动、**还出现在……**、链接、钱包、电话。打开被引用的记录。 3. 在其他聊天中追踪同一个数字用户 ID。相同的名称、钱包或头像是一条线索,需要与数字 ID 进行核对。 4. 比较文件哈希。SHA-256 相同 = 字节相同。 案例地图 / 追踪引用虚构案例 · 非实时图表 频道 / 公告**原文 → 编辑后的目标文本** 记录 #101、#188 消息 #84 · 未标注发件人 组 / 运营**用户 71001 发布了新链接** 记录 #146 · 消息 #309 已保存文件收据 #151 机器人 / 订单对话**一个按钮指向该目标页面** 记录 #173 · 消息 #12 “返回”按钮的元数据 私密 / 后续**用户 71001 重复了收件人信息** 记录 #205 · 消息 #922 已保存文件收据 #209 四个聊天记录提供了不同的观察结果。请追踪每条连接的源记录;该频道帖子未标注发件人。 本操作指南中的数字 ID 和记录引用均为虚构。此说明图展示了如何将搜索结果、个人资料和已检查记录相互关联;“案件看板”存储相应的卡片和来源引用。 | 连接 | 辅助观察 | 保留结论 | | --- | --- | --- | | 同一 Telegram 账号 | 用户 ID 71001 所在的群组 #146 和私聊 #205 | 两个聊天中的发送者 ID 相同。 | | 重复的目标 | `pay.example.invalid/new` 在 #146,按钮元数据 #173,编辑后的帖子 #188 和 #205 | 同一个链接出现在四个地方。 | | 相同文件字节数 | 已完成的媒体收据 #151 和 #209 中 SHA-256 值完全一致 | 两个文件逐字节相同。 | 档案只包含在*此工作区*中发过言的人,不是成员列表。每个事实的引用数:**参数 → 每个事实引用的记录**。 ## 5. 还原事件序列并标注缺失部分 先在**聊天**中查看版本,再到**日志**中选择**所有来源** + **编辑**、**删除**、**覆盖**。时间线中写上两个时间:Telegram 的日期和被观察到的时间。 1. 09:00 · #101**捕获的频道帖子** 保留了原始目标。 2. 09:12 · #146 / #151**群组提供了一个不同的链接** 用户 71001 发布了该内容;附件下载已完成。 3. 09:16 · #173**机器人显示相同的目标地址** 保存的键盘元数据中包含该链接。 4. 09:20 · #188**频道公告变更** 原始内容和编辑后的内容均予以保留。 5. 09:24 · #205 / #209**私下跟进时再次强调这一点** 保存的附件与 #151 具有相同的完整 SHA-256 值。 6. 09:28 · #231**群组删除通知已发送** 先前的观察结果依然成立:既未提供删除者信息,也未提供确切的删除时间。 示例性的观察时间及参考信息。其他日志记录发生在这些条目之间。 日志顺序是到达顺序,不一定是发生顺序。请将实时记录、快照、恢复的消息、删除和“重新检查时缺失”分开,并将每个空缺标记为未知。 ## 6. 将此案例扩展至其他收集账户 每个账户一个工作区,步骤相同。记下每个账户的角色和指纹。消息编号按账户计算,所以务必注明是哪个工作区和聊天。 [账户组](https://phishdestroy.io/tgwitness/zh/docs/groups/)显示状态、共享设置并一起导出所有账户,每个账户仍有自己的日志和密钥。跨账户时间线需要您在笔记中自己整理。 案件周期很长?请添加[独立见证人](https://phishdestroy.io/tgwitness/zh/docs/witness/),并测试每个账户实际能捕获什么。 ## 7. 提交可核查的案件资料包 每个工作区的签名 ZIP(始终是完整日志,筛选不影响),以及人员档案、聊天导出和文件。 ``` CASE-001/ # assembled by the analyst case-notes.md # question, findings, alternative explanations sources.csv # every chat, role, acquisition result and gap timeline.csv # account + chat + message + seq + both times workspace-A/ evidence.zip # complete signed observation journal retained-checkpoint.json profiles-operations.json # separately signed people profiles history-channel.zip # signed current-history export history-group.zip verification.txt workspace-B/ # separate journal and trusted fingerprint witness/ # retained checks, journal and signed posts SHA256SUMS # hashes of the delivered files ``` 请单独发送指纹。每份都对照它自己的工作区验证: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` 检查点使用收集器密钥进行签名,因此仅凭它本身并不满足证据的最低要求;`--require evidence`还需一个经过验证的时间戳或涵盖最后一条记录的见证帖。 将验证工具的输出、原件、覆盖范围和移交记录与您的发现放在一起。在 Report studio 中撰写报告。如果接收方需要的更少,请制作[精简移交](https://phishdestroy.io/tgwitness/zh/docs/handover/)。 --- # Telegram · 创建案件看板 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/case-board/ 在私人看板上收集已保存的观察结果、精确标注和操作片段,与团队讨论并提交证据集合。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 把保存的消息变成团队一起处理的案件。 书签、精确引文、切片和讨论,每一项都链接到来源。每次更改都是一个签名修订。 ## 从消息到案件卡片 1. **调查 → 案件看板**(标准或专家模式)。为案件创建一个集合。 2. 在**日志**或聊天中点击**添加到案板**(或按 **B**)。卡片会进入收件箱,给它起个标题再移动。 3. 在消息中选中文本,**突出显示 → 板**会保存精确引文和版本。写下它为什么重要。 4. 讨论、设置状态,需要时随时跳回来源。**演示**带团队逐项浏览。 ### 请点击一个已更改的支付链接 综合示例 · 本地化说明 1. **捕获。**打开已保存的观察记录 #142 及其消息版本。 2. **添加书签。**将引文、来源参考信息和您的问题保存到卡片中。 3. **审核。**添加团队评论并将卡片移至“审核”状态。 4. **演示。**逐步演示采集过程,并打开引用的源上下文。 #### 已保存的观察记录 #142 “请使用新的支付链接。” 操作聊天 · 第 38 条消息 · 观察时间 09:12 UTC #### 卡片:更改了目标位置 > 请使用新的支付链接。 问题:哪个目标在早期版本中出现过? #### 团队审核 分析师:请与观察记录 #101 进行对比。 状态:审核 · 保留修订版本 #### 源文上下文 卡片 → 已保存版本 → 早期观察记录 注释与 Telegram 观察记录仍可分别识别。 ## 一次性保存一个有用的范围 按住 Shift 点击两条消息进行**中间切片**,使用**按时间切片**,或保存当前日志筛选条件。**显示自书签添加以来的记录**会显示后来进入的内容。 时间切片使用观察时间;消息 ID 切片会跟随这些消息的变化。 ## 为每位同事分配相应的角色 **审核员**阅读,**分析师**添加卡片和评论,**操作员**还管理集合和决定。聊天权限同样适用于卡片。 ## 将工作成果整理成可交付成果 切片可导出为签名 JSON 或 CSV。报告可以包含书签、切片和评论,在 [Report studio](https://phishdestroy.io/tgwitness/zh/docs/reports/) 中设置。对于受限的接收方,请使用[移交](https://phishdestroy.io/tgwitness/zh/docs/handover/)。 详情:[Case Board 参考](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)。 --- # Telegram · 设计报告 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reports/ 选择报告数据、八种设计模板之一及内容,然后预览并导出 HTML、带签名的 PDF 或完整的证据包。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 让读者从案件问题直接到达保存的记录。 Report studio 汇总您挑选的数据、变更历史、图表和您的发现。八种设计,HTML 和原生 PDF。每份 HTML、PDF 和 JSON 报告都用您的密钥封印。 ## 三步生成报告 1. **导出 → 配置和预览 → 数据**:整个工作区,或选择聊天、作者、日期(UTC,即 TgWitness 看到记录的时间)和记录类型。 2. **设计与内容**:选择设计和要包含的内容:图表、参与者、聊天记录、变更、Case Board 条目、您的案件详情和笔记。 3. **预览**:检查数量、活动、样本和缺失的 ID 范围。保存,然后下载所需格式。 ### 为读者整理相同的保存材料 合成示例 · 示意图布局,并非生成的报告 1. **选择。**为该案件选择两个聊天记录及观察时间段。 2. **撰写内容。**选择布局,并选定能回答该问题的章节。 3. **预览。**请核对选定字数及保存的“修改前”与“修改后”文本。 4. **验证。**生成最终文件,并将其签名与可信工作区的指纹进行比对。 #### 选定要点 2 次聊天 · 1 天观察期 消息、编辑及删除通知 #### 报告结构 ##### 更改了付款目的地 案件问题 → 范围 → 调查结果 → 记录引用 **消息背景** 观察项 #142:“请使用新的支付链接。” **已保存的更改** 译前:old.example.invalid → 译后:new.example.invalid #### 审阅选定内容 18 条意见 · 2 次保存的编辑 发送、编辑和查看时间各有独立的标签。 #### 最终交付物 签名 PDF + 签名 JSON,或包含可读报告的签名 ZIP 文件 接收方需核对文件及可信指纹。 ## 选择阅读风格 **Classic, Editorial, Briefing, Analytics, Technical, Overview, Reading series, and Ledger & margin**:相同的记录,不同的外观。切换时保留您的选择和笔记。可用 25 种语言中的任意一种。 PDF 使用内置字体生成,无需浏览器。中文、日文和韩文需要服务器上有 Noto Sans CJK 之类的字体(系统级或位于 `TGWITNESS_FONT_DIR`),否则只能得到 HTML 和 JSON。 ## 结合上下文阅读变更内容 编辑显示前后对比,删除显示最后保存的版本。回复、转发、表情回应、按钮和附件都保留其引用。 设计预览使用前 50,000 条记录,数据预览精确统计全部内容。要查看最终页面布局,请生成 PDF。 ## 请审慎选择受众版本 筛选只影响报告,证据 ZIP 仍包含完整日志和文件。如果接收方应得到更少,请使用[精简移交](https://phishdestroy.io/tgwitness/zh/docs/handover/)。更多:[报告内容](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/),[验证导出](https://phishdestroy.io/tgwitness/zh/docs/exports/)。 --- # Telegram · 准备一份共享副本 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/handover/ 选择收件人可接收的记录和字段,检查最终副本,并验证其已签名的清单及源日志边界。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 只分享需要的内容,原件保持不变。 移交是一份独立的签名摘要:选择聊天和人员,隐藏身份或文本,选择文件和团队笔记。清单记录了保留、裁剪和排除的内容。 ## 准备收件人的数据提取文件 1. **导出 → 移交提取**:写明用途,选择聊天和时间段,如需具名人员则**加载所选聊天记录中的人员**。 2. 其他所有人:使用化名、排除,或按记录原样。文本和文件是分开的开关;电话和电子邮件可以遮蔽。 3. Case Board:不包含、书签和切片,或带评论的卡片。团队成员姓名可替换为别名。 4. **下载移交摘要**,打开、验证,并在发送前通读一遍。 ### 一份正本,一份经授权的共享副本 合成示例 · 仅用于说明身份 1. **选择。**包含案件聊天记录,并标明该摘录涉及的对象。 2. **最小化。**选择其他参与者在共享副本中的显示方式。 3. **检查。**在发送生成的存档文件之前,请先打开其报告和记录进行**检查**。 4. **分享。**提交经核对的译文,并单独提供其可信指纹。 #### 原始观察 Nora · 用户 71002 “我已收到修订后的链接。” 源日志会保留此保存的观察记录。 #### 收件人副本 按记录显示:Nora · 用户 71002 · “我已收到修订后的链接。” 化名:P01 · “我已收到修订后的链接。” 省略:此参与者的消息未包含在译文中。 #### 检查实际文件 请阅读 report.html 和 records.jsonl 文件。 请核对身份信息、文本、附件及可选的团队评论。 #### 已签名的摘录 选定内容 + 文件哈希值 + 签名清单 一个与源日志边界关联的独立包 ## 综合运用各项控件 | 控制 | 对文案的影响 | | --- | --- | | 人员 | 选定的人员保留姓名;其他人使用化名或被排除。 | | 文本 | 全部文本、仅选定人员和您账户的文本,或不包含。 | | 文件 | 选定人员和您账户的文件、全部显示的文件,或不包含。 | | 案件看板 | 不包含、书签和切片,或带讨论的卡片。 | 请也读一读文本和文件:化名不会删除写在消息或附件中的名字。如果选定的文件缺失,请恢复它或排除附件。 ## 确保译文内容可独立核查 ``` python -m tgwitness.verify handover.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` 原始存档和检查点请自己保留。接收方无需获得整个工作区就能验证其副本。设计:[Report studio](https://phishdestroy.io/tgwitness/zh/docs/reports/)。可信参照:[导出验证](https://phishdestroy.io/tgwitness/zh/docs/exports/)。 --- # Telegram · 管理一组账户 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/groups/ 比较群组工作区、查找来源、审查观察时段,并应用共享设置(可针对每个账户设置例外)。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 同时运行多个账户,每个账户仍有自己的记录和密钥。 账户组将连接状态、启动/暂停、共享设置和导出放在同一个界面上。多个账户处理同一案件时很方便。 ## 打开群组概览 在**账户**中打开账户组。每个账户显示其状态、路由、延迟和最后保存的消息。**需关注**列出出问题的账户,**修复**直接带您过去。 **全部开始** / **全部暂停**会先询问再执行。**组设置**是共享的,但账户自己的值会一直保留,直到您替换它们。 ### 审查群组内的路线变更 合成示例 · 说明性检查及结果 1. **选择。**选择群组并查看哪些账户将发生变更。 2. **准备工作。**当需要保持独立时,请保留账户自身的路径。 3. **检查。**测试建议的连接并检查测量结果。 4. **提交。**保存前请重新检查,并审查每个账户的处理结果。 #### 案件团队 频道采集器 · 群组采集器 · 参考账户 3 个独立的工作区 #### 已审核内容 2 个账户采用建议的流程。 参考账户保持其独立路径。 #### 准备工作检查 频道采集器:Telegram传输时延 84 毫秒 群组采集器:Telegram传输时长 91 毫秒 这些数字是示例中的虚构数据。 #### 应用结果 频道采集器:已保存,观察已恢复。 群组收集器:重新检查失败,已恢复先前设置。 参考账户:保留原有路径。 ## 在流程中增加一个审核步骤 1. **更改群组路由**,选择类型和设置。 2. **审查选择**:查看哪些账户会变更,哪些有自己的路由。 3. **准备并检查**会测试新的 Telegram 连接,并在可能时测试出口 IP。 4. **应用已检查的连接**,并查看每个结果。正在运行的账户继续运行,空闲的保持空闲。 延迟是建立 Telegram 连接的时间,出口 IP 是检查时路由显示的地址。结果可能因账户而异。 ## 使用重叠访问权限 **多个账户可见的聊天**列出共享来源及其覆盖范围。频道和超级群组可以通过**用 … 个账户导出**由多个账户同时导出。私聊和普通群组不行,它们的消息编号按账户计算。 ## 将群组导出为包 **导出组**会生成一个 ZIP,包含每个账户的签名导出及其签名列表。每份导出都保留自己的指纹用于验证。合并的时间线仍需您自己整理。 下一步:[报告](https://phishdestroy.io/tgwitness/zh/docs/reports/),[Case Board](https://phishdestroy.io/tgwitness/zh/docs/case-board/),[验证导出](https://phishdestroy.io/tgwitness/zh/docs/exports/)。 --- # Telegram · 了解证据如何运作 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/concepts/ 追踪一条消息从捕获到检查点的全过程。修改一条示例记录,重新计算其 SHA-256 链,并查看保留的检查点会检测到什么。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 消息会变。您对所见内容的记录不应改变,而且任何人都应能核查这一点。 下面是两个小实验。消息是虚构的,一切都在您的浏览器中运行,不会发送到 Telegram。 ## 从聊天记录导出到可验证的记录 [Telegram Desktop 导出](https://telegram.org/blog/export-and-more)将当前可见的历史保存为 HTML 或 JSON。TgWitness 增加了持续的变更日志、每条记录的签名,以及他人可以对照的检查点。 | 任务 | Telegram Desktop 导出 | TgWitness | | --- | --- | --- | | 阅读已保存的对话 | HTML 或 JSON 格式,含选定媒体文件 | 已保存的聊天记录、可搜索的日志和离线报告 | | 跟踪随时间的变化 | 导出时可用的历史记录 | 旧版本、后续编辑和删除,全部保留 | | 移交后检查文件 | 标准的 HTML/JSON 导出文件未签名 | 签名清单、签名记录和封印报告,用可信密钥核查 | | 与先前保留的状态进行比较 | 请保留一份单独的参考副本或哈希值 | 已签名的检查点、独立的见证文件以及可选的外部时间戳 | 本对比基于截至 2026 年 11 月 2 日的 [Telegram Desktop 导出代码](https://github.com/telegramdesktop/tdesktop/tree/768d47cda6c7f447c10a25d1f363279493a90ed7/Telegram/SourceFiles/export/output)。 ## 一条消息,三点观察 一条新消息、一次编辑和一次删除会变成三条独立的记录。编辑不会覆盖第一条,删除也不会抹掉它。 01 / 消息流转示例流程 Telegram delivers an update to the collector, which appends a journal record. · Telegram · 收集器 · 日志 · 更新 → · 追加 → 当前聊天视图 消息 #42 消息已删除 该消息已从聊天界面中消失。 观察日志 3 条记录 1. 01 `message.new` 10:00 见面 ✓ 2. 02 `message.edited` 11:00 见面 ✓ 3. 03 `message.deleted` 关于 #42 的删除通知 ✓ 所有三条已接收的记录均保留在日志中。 针对已选定来源的简化路径。操作记录也会同步到真实的日志中。捕获内容取决于该账户的可见范围以及 Telegram 实际发送的内容。 ## 修改一条记录。追踪哈希值。 每条记录都包含前一条记录的哈希。保存在别处的检查点固定了日志长度和最后一个哈希。 02 / HASH-CHAIN 沙箱真实的 SHA-256 · 记录示例 记录 01**消息已收到**`h₁ = SHA-256(e₁)`链接至 64 个零 记录 02**11:00 见面**`h₂ = SHA-256(e₂)`包含 h₁ 记录 03**观察到删除操作**`h₃ = SHA-256(e₃)`包含 h₂ 保留在其他地方**3 条记录 · 头部 `h₃`**请将此固定边界与提供的日志进行对比。 修改某条事件会改变其哈希值。重建链条会改变其头部。移除尾部会使其长度短于保留的检查点。 **查看记录 2 及完整哈希值** 这是本示例中经过哈希处理的精确 UTF-8 JSON 数据。数值均为虚构;其中的九个字段及序列化格式均与日志格式一致。 ``` ``` 已保存记录 2 的哈希值 `` 重新计算的记录 2 哈希值 `` 此沙盒仅计算哈希值,不生成签名。真正的验证器还会检查每个事件的 Ed25519 签名、序列号和链接。仅凭哈希值的重建无法在受信任密钥下生成有效的签名。 ## 实际规则,简要概述如下 哈希值 + 签名 h0 = 064 hi = hex(SHA-256(C(ei))) σi = Ed25519.Sign(sk, unhex(hi)) **C** 是以 UTF-8 JSON 表示的九个事件字段:键已排序,无多余空白,无 ASCII 转义,无 NaN/无穷大。`previous_hash` 是 hi−1,h0 是 64 个零,签名覆盖 32 字节的原始摘要。 字段:`seq`、`observed_at`、`source_at`、`kind`、`chat_id`、`message_id`、`actor_id`、`payload`、`previous_hash`。完整规范:[事件编码](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#event-canonicalization)。 保留检查点 Nexport ≥ Ncheckpoint hexport[Ncheckpoint] = Hcheckpoint 用固定的密钥检查检查点签名,然后将其与日志比较。之后的导出可以更长,但在检查点处必须一致。 ## 三个问题,三种不同的核查方式 [01 / 完整性**该记录是否发生了变化?** 用您信任的密钥核查哈希和签名。](https://phishdestroy.io/tgwitness/zh/docs/exports/)[02 / 连续性**之前保留了哪些内容?** 将导出与见证人保存的检查点比较。](https://phishdestroy.io/tgwitness/zh/docs/witness/)[03 / 交付**这些测试事件是否已到达?** 发送、编辑和删除测试消息,看看每个账户捕获了什么。](https://phishdestroy.io/tgwitness/zh/docs/cases/) 签名回答“是否被改过”,检查点回答“是否与之前的一致”,测试消息回答“我们是否捕获了全部”。[验证能证明什么。](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope) 下一步:从开始到案件包的[整个账户调查](https://phishdestroy.io/tgwitness/zh/docs/cases/)。 [导出诊所:观看受控桌面实验](https://phishdestroy.io/tgwitness/zh/docs/export-clinic/). 请比较这段两分钟的影片、原始录制文件以及七组测试导出文件。其中披露了局部修改内容。 --- # Telegram · 确保安全 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/security/ 了解会话、密钥和证据的存储位置,哪些数据会离开您的设备,保护措施涵盖哪些内容,以及如何加强系统安全性。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 什么会离开您的机器,每个密钥能打开什么,哪些由保护措施覆盖、哪些由您负责。 **127.0.0.1**默认面板地址 **256 位**随机面板令牌 **0**内容分发网络(CDN)、分析工具或远程字体 **Ed25519**每条记录均附有签名 ## 所有内容的归宿 采集器、面板和每条记录都留在您的机器上。默认只连接 Telegram;其他一切都是单独的开关。 06 / 机器留下的痕迹您的安装 您的计算机或服务器 **面板**127.0.0.1:8787 · 承载令牌 **收集器**每个工作区仅限一个 Telegram 客户端 数据目录 **日志**SQLite · 哈希链 · 签名 **媒体**文件名采用 SHA-256 哈希值命名 **Vault**Fernet · 会话、API 对、签名密钥、代理 - **Telegram**始终 · 通过您的路径 该账户的 MTProto 连接方式包括:直接连接、SOCKS5、HTTP 或 MTProxy。“隐藏 IP”模式会等待可用的代理。若要启用直接连接回退,则需使用明确允许此功能的模式。 - **站外文案**可选 · 默认关闭 日志、文件和检查点在上传至兼容 S3 的存储之前,会使用 AES-GCM 进行加密。密钥由您自行保管;附件的命名基于密钥哈希值,而非其内容哈希值。 - **通知**可选 · 默认关闭 显示问题及变更数量,并附带聊天标题。消息摘录仅在您开启该功能时才会显示。 - **时间戳权威性**可选 · 默认关闭 仅包含已签名的检查点的 SHA-256 哈希值和一个随机非ce值。不包含任何消息内容,也不包含聊天昵称。 - **见证人**可选 · 默认关闭 使用只读令牌提取带签名的检查点和捕获计数器。该工具无法读取对话内容或更改设置。 默认设置:仅 Telegram 连接会离开这台机器。 可选的存储位置需按工作区进行配置。 ## 每个秘密揭示的内容 | 秘密 | 存储位置 | 它能带来什么 | 若发生泄露 | | --- | --- | --- | --- | | **面板令牌** | 数据目录中的 `panel-token.txt`;浏览器按标签页保存 | 每个工作区中的一切 | 停止 TgWitness,删除 `panel-token.txt`,重新启动:会生成新的令牌 | | **Telegram 会话** | Vault,加密版(`credentials.enc`) | Telegram 账号本身 | 在 Telegram 中通过*“设置”→“设备*”结束当前会话 | | **签名密钥** | Vault,加密版(`signing.enc`) | 以您的指纹签署记录 | 保存在别处的检查点、见证人和时间戳仍能显示之前存在的内容 | | **保险库密钥** | 数据旁边的 `vault.key`,或外部主密钥 | 保险库 | 请假定会话和签名密钥也已泄露 | | **Witness 代币** | 关于 Witness 主机 | 只读:检查点和健康状态 | 在见证人页面删除它,再新建一个 | | **站外文案关键点** | Vault;只需下载一次即可进行数据恢复 | 异地副本 | 同时拿到存储桶的人可以解密它:请将副本视为已暴露 | ## 保护范围 ### 已收录 - 记录被修改、删除或重新排序:哈希链或签名会断裂。 - 在您将检查点保存到别处之后,日志被截短或重建:检查点不再匹配。 - 猜测令牌:256 位随机数,常量时间比较,每分钟失败 15 次即封锁该地址。 - 恶意聊天内容:文本始终是文本,绝不作为 HTML;附件以文件形式下载;面板不从其他网站加载任何内容。 - 数据目录被盗但保险库密钥在外部:会话和密钥仍是加密的。 ### 由您决定 - 主令牌可以做任何事。请给他人限定范围的访问权限,主令牌留给自己。 - 请将指纹和检查点保存在别处。 - 请加密磁盘,收紧权限。 - 在 localhost 之外使用普通 HTTP 会泄露令牌。请使用 HTTPS 或 SSH 隧道。 - 请检查覆盖范围中的空缺,并在您自己的账户和来源上测试送达。 [共享案件的访问权限](https://phishdestroy.io/tgwitness/zh/docs/access/),可设置权限、有效期和会话限制。 ## 强化安装安全性 已完成 0/8 1. **请使用专用的 Telegram 账号**,绝不要用主账号。 2. **请将控制面板保留在 127.0.0.1 上。**远程访问只通过 HTTPS(内置 Caddy)或 SSH 隧道。 3. **请加密存放数据目录的磁盘**。 4. **将数据目录限制**为仅服务账户可访问(Unix 上为 0700,Windows 上为文件夹权限)。 5. **在服务器上将保险库密钥保存在别处**:首次启动前设置 `TGWITNESS_VAULT_KEY_FILE`。 6. **将指纹和检查点保存在**另一个系统上,在另一台主机上运行见证人。 7. **切勿将** `data/`、会话密钥、`panel-token.txt` 或保险库密钥**上传**至 GitHub 或聊天群组。 8. **请勿**在反向代理服务器上**记录** `Authorization` 标头或请求正文。 **我可以更改面板令牌而不丢失数据吗?** 可以,它只能打开面板。停止 TgWitness,删除 `panel-token.txt`,重新启动。日志、会话和密钥都会保留。如果设置了 `TGWITNESS_TOKEN`,则以该值为准,而不是文件。 ## 报告漏洞 在 GitHub 上使用 **Security → Report a vulnerability**。提供版本、影响以及使用虚构数据的最小复现。切勿发送凭据、账户文件夹或真实证据。如果私密报告已关闭,请开一个 issue 申请私密渠道,不要写漏洞利用细节。 --- # Telegram · 设置 Witness 机器人 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/witness/ 通过独立的见证节点(配备专属密钥及只读收集器访问权限),将签名的日志检查点发布至您的 Telegram 频道。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 一个独立进程检查您的日志,并将签名检查点发布到频道。 ## 两台主机,两把签名密钥 托管 / 收集器**账户 + 日志** Telegram 会话收集器的签名密钥 只读检查点端点 ← 请求签名回答 → 主机 B / WITNESS**验证 + 保留** 固定收集器指纹 独立见证人签名密钥 自有日志 + 机器人令牌 Witness → Telegram 机器人 API →**您的频道 · 带签名的 TGW1 帖子** Witness 会自行执行校验。收集器的访问权限仅限只读。机器人发布功能使用 Witness 的连接和令牌;Witness 不会获得任何账户会话权限。 03 / 检查点决策示例答案 最后接受时间**120 条记录**`head 9c7d…` 下一个答案**128 条记录**`head a4f2…` 已通过:计数持续增加,签名已验证,密钥匹配。该见证者保留了这一新边界。 所有解答示例均假设存在有效签名和已固定的密钥。此处的哈希值仅为简略示例。要确认整个旧前缀未被更改,请将导出与保留的检查点进行比较。 ## 准备一个机器人和一个频道 用 BotFather 创建机器人,并允许它在您的频道中发帖。请在别处运行见证人:另一台主机,最好由其他人管理,远比在采集器旁边再跑一个进程更有价值。 ## “扩展功能”中的三个步骤 1. **只读访问权限。****扩展功能 → 独立见证人**,创建令牌并保存文件。它只读取检查点和健康状态,别无其他。 2. **频道和间隔。**Telegram 频道或 Discord webhook,以及见证人能访问到的采集器地址。保存设置文件。 3. **启动。**将 `witness.json`、`witness-token.txt` 和 `bot-token.txt` 一起放到见证人主机上并运行: ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json ``` 等待频道中出现第一条签名帖子,然后将见证人指纹保存在安全的地方。 想用 Discord?将 webhook URL 保存为 `discord-webhook.txt`。一个见证人只发布到一个地方;较长的检查结果在 Discord 上以文件形式送达。 ## 选择发布频率 每次检查都发帖可以形成稳定的外部记录:每五分钟一次,相当于每个工作区每天约 288 条帖子。高级设置可以只在有变化或出问题时发帖,使用代理或自定义 Bot API。 **该机器人实际上能证明什么?** 它向采集器请求签名检查点,用预期的密钥核查,并保存自己的签名日志,包括错过和被拒绝的应答。 它检查的是日志状态,本身并不监视 Telegram。为此,请进行受控的送达测试。 ## 稍后核查证据 请保留见证人日志、帖子和指纹。[如何核查它们](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/#verify)与采集器导出是否一致。 --- # 为何选择零信任:泰勒·韦辛律师事务所、祖尔海德博士、舍林斯基博士 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/signed-export/ 一项零信任案例研究:由泰勒·韦辛律师事务所的帕特里克·祖尔海德博士和托比亚斯·谢林斯基博士签署的《通用数据保护条例》(GDPR)答复,该答复已与其自身文件进行核对,并采用了可核查的模型,该模型确保了毫无欺骗或疑虑的余地。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) **实时案例研究**真实文件 · 真实签名 · 哈希值见下文 · 计数结果可在离线环境下复现 一个说明为何必须采用零信任模式的案例研究。某人根据《通用数据保护条例》(GDPR)第15条提出的一项个人数据请求,由一家领先的国际律师事务所的合作伙伴通过合格电子签名予以答复。答复中的每一项保证都必须被无条件信任:签名、头衔、“一个月的手动审查”、对第三方的保护,以及“任何法院都会认同”等说法。 经与所提供的文件核对,上述内容均不成立。本页展示了“信任”带来了什么后果,以及可验证的模型将如何杜绝欺骗和怀疑的余地。 2025年8月15日 · 信件[托比亚斯·谢林斯基博士](https://www.taylorwessing.com/en/people/germany/hamburg/dr-tobias-schelinski)泰勒·韦辛律师事务所合伙人 · 信息技术法专业律师 2025年10月1日 · 信函及附件1[帕特里克·祖尔海德博士,法学硕士](https://www.taylorwessing.com/de/people/germany/hamburg/patrick-vincent-zurheide)Salary Partner, 泰勒·韦辛律师事务所,自2025年起 · 信息技术、数据保护与科技诉讼 专业职务信息取自该公司的相关个人资料。本页面并未说明封禁该Steam账号是否合理。它仅展示了所提交文件的内容,以及相关签名信件对此的说明。所有数据均可通过文件进行核对。 **830页**在第二封信的附件中 **36秒**从该附件的创建到最后一次修改 在其黑色矩形下方可读的**905,672个字符** **2个签名**在这两封信中声明,每封信各有一处 **简而言之,**签名只能告诉你文件的发送者是谁,却无法告诉你文件是否完整、正确或真实。只有对字节的校验才能做到这一点,而且任何人都可以重复这些校验。 ## 零信任:验证文件,而非发件人 零信任意味着无需信任任何人:无论是公司、头衔、签名,还是我们自己。对访问请求的响应必须自我证明。它必须回答三个问题,而签名无法回答其中任何一个。 **内容写完了吗?**请求方是否已收到属于自己的所有物品?是否有任何遗漏,并已逐一统计和说明? **内容有变化吗?**每条记录是否都反映了最初的记录内容?如果后来有所更改,这些更改会显示出来吗? **是谁决定了什么被隐藏起来了?**扣缴决定是否由有权作出该决定的人作出的?事后是否有人可以对此进行核查? 欧盟的大多数法律纠纷都以不公开的方式了结:签署保密协议(NDA)达成的和解、密封的案卷、从未公布的裁决。我们对此并无异议。但本案有所不同,而且原因很可能并非在于其中发生的事情多么罕见。本案既没有保密协议,也没有法院裁决,因此可以从头到尾完整阅读:一部非常简单的法律——《通用数据保护条例》(GDPR);一份关于个人自身数据的请求;实际提供的内容;以及任何人都可以移除的黑色矩形。 其独特之处在于回应者是谁,以及他们是如何回应的。托比亚斯·谢林斯基博士和帕特里克·祖尔海德博士是泰勒·韦辛律师事务所的合伙人,该所[自称是“欧洲法律服务领域的巨头”。](https://www.businesswire.com/news/home/20251217415857/en/Taylor-Wessing-Diversifies-Its-International-Strategy) 两人均拥有博士学位;其中一人是经认证的IT法专业律师,另一人则拥有阿伯丁大学的法学硕士学位。他们耗时106天,却未能处理一项合法取证请求。在此过程中,他们向被举报的账户持有人提供了1800多名其他人的投诉文本和登录信息——其中部分人可能是未成年人——这些信息被黑色矩形遮盖,而任何人都可以移除这些遮盖。 **PhishDestroy 的观点。**登录名(即用户名)属于高度个人化的数据。它在不同服务中会被重复使用,而一个存在多年的账户,在大多数情况下都与某位真实人物相关联,且可通过该账户识别出该人。 仅从这五十个可见的片段来看,我们认为任何法院确实都可能被误导。若综合全貌来看,本页的时间线和数据计算都清楚地表明,该 GDPR 请求并未得到处理。无论是否有签名,也无论姓名拼写是否错误,这一事实都不会改变。 ## 信任带来了什么,以及该模型本会怎么做 答案中的每项保证均与提交的文件以及本页提出的可验证模型相对应。每行内容的依据见下文。 **签名** „Dieses Schreiben ist qualifiziert elektronisch signiert“ 上面写着是谁寄的信。在字样下方,905,672个字符在黑色矩形下依然清晰可辨。 [证据](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#signature) 该系统会对每个被屏蔽的字段生成一个带盐哈希值。验证的是内容,而非发送者。 **选拔** 由律师决定申请人可以阅读哪些内容。 有50条投诉仍可查阅,均是在封禁和请求之后提交的;其中43条是 “Suspected Hijacker”. 1,944 已覆盖。 [证据](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#convenient) 在制作副本时宣布并签署一项规定,统计每份被扣留的记录,并由主管部门对该选择进行审查。 **“一个月的人工审核”** „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ 一份830页的文件仅用36秒就生成。其第一行可读内容是一句针对同性恋的侮辱性言论,而文件中保留的可读投诉内容与该文件本身自相矛盾。 [证据](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#refuted) 别人关于努力的说法都不重要。文件本身就是最好的证明,任何人都能从中找出矛盾之处。 **第三方权利** „soweit keine Rechte Dritter entgegenstehen“ 另外1,800余人的登录信息和投诉内容,以黑色矩形框的形式呈现,任何人都可以移除这些矩形框。 [证据](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#under) 他人的数据绝不会进入请求方的副本。该数据在传输过程中始终处于加密状态,仅能通过相关机构的密钥解密。 **数据的副本** „Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ 付款记录、支持工单以及区块背后的相关记录均缺失。只有投诉记录看起来是完整的。 [证据](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#inventory) 已签名的装货单列出了所包含的物品,并清点了未包含的物品。任何遗漏都不会被忽视。 **“每个法院”** „Aus unserer Erfahrung wird jedes Gericht …“ 仅凭五十个片段可能会产生误导。整个文件显示这是一项未被处理的请求。 [证据](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#authority) 法院或监管机构会调取完整的原始文件,并将每个字段与该公司签署的内容逐一核对。 **每一行都采用相同的格式。**一项必须被相信的保证、一份与此相矛盾的文件,以及一项本可使该保证变得多余的核查。采用该模板后,既无欺骗之嫌,也无怀疑余地:请求方看到属于自己的内容,主管部门看到其余部分,且每个字段都与公司签署的内容严格对应。[查看模板](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#sealed) ## 证据,逐点列举 上文比较中的每一项均基于以下文件:两封签名信和附件1。页码引用采用PDF页码顺序,且所有图表均可离线重现。 ### 文字仍位于黑色矩形下方。 这就是来自该领域顶尖专家对一项简单信息公开请求的答复。黑色矩形遮盖了文件中的原始文本。这使得人们能够阅读并对比这两组内容:50条保留可见的描述和1,944条被遮盖的描述。 这封信已交付的文件 “无论投诉的具体内容如何” 据称,仅从这一数字来看,就表明多次违反了Steam协议。 谢林斯基博士 · 2025年8月15日 · 第2页 „Unabhängig von den Einzelheiten der Beschwerden …“ **50**保留可见的描述 **2025年8月至9月** **2021年2月至2025年7月**期间 共收录**1,944条描述** 50条可见描述中有43条被标注了 “Suspected Hijacker”. 在1,944条涵盖的描述中,有269条带有该标签。 附录 1,第 444–620 页。还有一条记录的描述为空:所提供的表格中共有 50 + 1,944 + 1 = 1,995 行。 ### 五十起投诉,便于律师处理 10月份的信中指出了封锁的理由:该账户被封锁是因为 „Used for Hijacking“ (祖尔海德博士,第8页)。在申请人获准查阅的50份投诉中,有43份内容完全一致: “Suspected Hijacker”. 这50份请求均是在该账户被永久封禁数月后、在提交访问请求之后,以及在同一文件记录的最后一次登录之后提交的。 附件1第1页给出: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)`. 该账号于2025年5月7日被封禁。2025年5月9日,Steam客服回复了第一份工单:封禁并非系统错误,且为永久封禁,随后该工单被关闭。6月17日,用户提交了账号解封申请。 根据信件中的陈述,当时该账户已由第三方持有:谢林斯基博士写道,该账户是在2025年5月3日之后从第三方处获得的(第2页);祖尔海德博士则表示,有第三方在5月3日之后通过该账户进行了付款,最后一次付款发生在2025年7月30日(第1–2页)。随后提供的投诉表记录如下: **53**2024年8月 **54**9月 **70**10月 **79**11月 **82**12月 **92**2025年1月 **32**2月 **35**3月 **20**4月 **12**五月*已封禁 5 月7日 最后登录时间 5月23日* **1**Jun **7**7月 **47**8月 **3**9月 黑色矩形下方的投诉内容保留了投诉内容的可读性 附件1中2024年8月至2025年9月的每月投诉数量,数据源自文件的文本层;完整记录请参见[自行核实](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#verify)部分。在5月7日被封禁及5月23日最后一次登录之后:6月有1起投诉,7月有7起,8月则有47起。 1. 2025年5月3日**自该日起,根据信函内容:第三方**该账户是“从第三方处获得的”:谢林斯基博士,第2页 · “由第三方支付的款项”:祖尔海德博士,第1页 2. 2025年5月7日**账户已被封禁**Steam 3. 2025年5月9日**不是错误,已永久解决;工单已关闭**Steam 客服,首张工单 4. 2025年5月23日**上次登录**附件1,第1页 5. 2025年6月17日**访问请求**祖尔海德博士,第1页 6. 2025年7月29日**截止日期从“如果真的有的话”开始计算**谢林斯基博士,第1页 7. 2025年7月30日**最后一次“第三方付款”;从这里开始,数据仅归因于请求者**祖尔海德博士,第2页 8. 2025年8月**47条投诉,均可阅读**附件1,第444–448页 9. 2025年8月15日**解雇:1,938起投诉,“无论具体情况如何”**谢林斯基博士,第2页 10. 2025年9月**3条投诉,内容可读**附件1,第444页 11. 2025年9月29日**“报告日期”**附件1,第1页 12. 2025年10月1日**答案:“整个月”,数据是“手动”清理的**祖尔海德博士,第1页 祖尔海德博士写道,必须使用完整的整整一个月的时间,并且需要手动清理数据: „musste leider die volle Monatsfrist ausgeschöpft werden … manuell die Daten bereinigt werden mussten“ (第1页)。三份可辨认的投诉书的日期均为2025年9月,而报告本身的日期则是9月29日。这些投诉是在提交答辩状前的最后几周内提出的,而据他所述,当时正在对数据进行清理。 > “This account just started acting shady overnight” > > Suspected Hijacker · 2025年8月 · 第446页 > “Suddenly messaging people weird links probably stolen” > > Suspected Hijacker · 2025年8月 · 第448页 > “Friend warned me to report this one” > > Suspected Hijacker · 2025年8月 · 第446页 > “Everyone in voice chat agrees it's a stolen account” > > Suspected Hijacker · 2025年8月 · 第446页 #### 同一份文件与他们的说法相矛盾 这五十人中,有部分人声称“Anlage 1”可以自行核对。该文件记录了该账户的登录情况及其安全历史记录。这两项内容均包含其中;安全历史记录位于一个黑色矩形下方。 左侧可读 · Suspected Hijacker · 2025年8月 · 第446页 > “My friend can't log in, says someone changed the password” 《安全史》·第830页·黑色矩形下方**最近一次密码更改:2024年7月** 如该文件所示,此操作并非由所有者执行。2025年没有密码更改记录。 左侧可读 · 2025年8月 · 第446、448页 > “This account just started acting shady overnight” > “Suddenly messaging people weird links probably stolen” 登录记录 · 第1–119页**最后一次登录:2025年5月23日** 登录记录截止于2025年5月。6月、7月、8月和9月均未记录任何登录记录。该账号自2025年5月7日起已被封禁;5月9日,Steam客服确认该封禁为永久性封禁。 左侧可读 · 2025年8月 · 第445、448页 > “Real person probably got locked out” > “My friend said they can't get into this account anymore” 安全史 · 第830页**2025年不会有安全方面的变化** 安全历史记录中记录的最后一次变更是在2024年7月进行的密码重置。 **PhishDestroy 的阅读记录。**第 444 页的那句诽谤性言论需要翻译。这些投诉是用英语写的,相关回复也在同一个文件中。经过一个月的人工审核,这些内容已变得可读,并将与之相矛盾的那句话标注在矩形框内。 #### 《五十人》的阅读方式 格式并不能证明投诉是由谁写的。这恰恰是法院在认定投诉有效性之前会考虑的因素。 | 检查 | 剩余可读 · 50 | 已覆盖 · 1,944 | | --- | --- | --- | | 时期 | 2025年8月至9月 | 2021年2月–2025年7月 | | “Suspected Hijacker” 类别 | **86%**43/50 | **13.**8%(1,944中的269) | | 描述中包含西里尔字母 | **4%**2 占 50 | **55.4% 1**,077(占 1,944) | | 记者登录:拉丁字母 + 3–5 位数字 | **62%**31/50 | **21.**6% 420/1,944 | 西里尔字母:至少包含一个该字母表的字符。登录模式:拉丁字母后跟3至5位数字,无其他内容。所有1,995条记者登录记录(包括50条可见文本旁边的那些)均已涵盖,且仍可提取。此处未列出任何记者的登录信息。有四条可读文本在九条记录中逐字重复; “Acting way off pretty sure someone else is using it” 出现三次(第446、447页)。 谢林斯基博士 · 2025年8月15日 · 第2页 > „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ “无论投诉的具体内容如何,光是数量就表明……” **该内容对法院来说真的无关紧要吗?** 祖尔海德博士 · 2025年10月1日 · 第9页 > „Aus unserer Erfahrung wird jedes Gericht die Sperrung … als rechtmäßig qualifizieren.“ “根据我们的经验,任何法院都会认定该封锁……是合法的。” **他的经验是否涵盖了所有法院?而且,如果数据都是这样处理的,所有法院都会认同吗?** 这两个问题出自PhishDestroy之手。我们并不对法院应如何裁定该区块发表意见。我们只是认为,法院应当能够读懂被要求统计的内容。 ### 黑色矩形遮挡了什么 这两封信以两种不同的方式处理了相同的投诉。谢林斯基博士将所有这些投诉都归咎于申请人, „1.938 Mal“,无论具体细节如何(2025年8月15日,第2页)。随后,祖尔海德博士将截止日期定为2025年7月30日:只有从该日起 „können wir … davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen“ (2025年10月1日,第2页)。黑色矩形沿该线分布:截至2025年7月23日(即该线之前的最后一条)的所有投诉内容均被遮盖;8月及之后的每条投诉内容均可阅读。 **PhishDestroy 的阅读。** 在2025年7月30日之前,投诉数量仅作为数字计入请求方名下,且作为不属于其的数据不予向其披露。10月份的信函本身从以下角度论证道: „zwischen 2019 und 2023“ (第7页)。 附件1 · 第444页 · 第一行可读内容 Offensive Avatar2025年9月`p***r` 一个针对同性恋的侮辱性词语,此处已进行遮蔽处理。这是经过一个月的人工审核后,请求者能够读到的第一条条目。 #### 矩形下方藏着什么 1,148起投诉(占表格总数的半数以上)是以以下方式提交的: “Offensive Profile”. 没有一个还能看清:1,147个的文字被遮盖,还有1个根本没有文字。从矩形下方读去,无需登录,那些被遮盖的描述反复出现着相同的主题: | 主题 | 已涵盖 | 可读的 | | --- | --- | --- | | 纳粹、纳粹主义 | **110** | 0 | | 仇恨、仇恨言论 | **108** | 0 | | 种族主义 | **99** | 0 | | 乌克兰、乌克兰人 | **90** | 0 | | 恐俄症 | **84** | 0 | | 侮辱国家或俄罗斯人 | **65** | 0 | | 宣传 | **64** | 0 | | 对乌克兰人的种族歧视性称呼 | **50** | 0 | | 政治 | **46** | 0 | 在1,944条被分析的描述中,有615条涉及了其中至少一个主题;而50条可读的描述中,没有一条涉及这些主题。长文本也存在重复:有18段长度为8个单词或以上的文本在48行中逐字重复出现。其中有两段,各重复了4次: > “I made this account to report this user because he has stolen my account” > > 已覆盖 · 4 行 > “I created this account in order to expose this user because he robbed my account.” > > 已覆盖 · 4 行 这五十篇可读文本(第448页)中,有一篇是粘贴过来的Steam个人资料页面,其中提到了其他用户的名字。此处不再转载该内容。这些矩形遮盖了每位记者的登录信息,但保留了该页面的可读性。 ### 相关陈述及所提供的记录 以下每条陈述均摘自已签名的信件。每份记录均收录在他们提交的文件中。 谢林斯基博士 · 第2页 ### 每年“数百” „In jedem Jahr, bis ins Jahr 2025 hinein, gab es demnach hunderte Beschwerden.“ **2021: 25 · 2022: 122** 所附投诉表中的年度统计数据。完整的月度统计数据请参见[自行核实](https://phishdestroy.io/tgwitness/zh/docs/signed-export/#verify)部分。 祖尔海德博士 · 第1页 ### 整月,手工清洗 „… die volle Monatsfrist ausgeschöpft … manuell die Daten bereinigt …“ **36秒** 附件1创建于19:58:05,最后修改于19:58:41,共830页。其中首个可读的投诉内容是一条针对同性恋的侮辱性言论。 谢林斯基博士 · 第3页 ### 第三方权利的保护 „soweit keine Rechte Dritter entgegenstehen“ **还剩 905,672 个字符** 在覆盖文本的1,044个黑色矩形下方,文字仍然可以被提取出来。这些矩形还遮盖了该账户自身的证券交易记录(第830页)。 祖尔海德博士 · 第7页 ### “2019年至2023年间” „Über einen Zeitraum von mehreren Jahren, zwischen 2019 und 2023 …“ **创建于2020年8月** 附件1第1页注明了该账户的创建时间:2020年8月。 祖尔海德博士 · 第9页 ### 任何法院都会认同这一点 „jedes Gericht … als rechtmäßig qualifizieren“ **一项预测** 该句称,任何法院都会认定封禁 Steam 账号是合法的。但该句既未指明具体法院,也未援引任何裁决。 ### 签名能告诉你什么,又不能告诉你什么 合格的电子签名是关于发件人的有力证据。它并非关于内容的证据。这两个问题必须分别核查。 ### 签名可以显示 - 谁签署了该文件 - 自签名以来,签名字节未发生变化 ### 无法显示签名 - 导出已完成 - 即删节去除了某些内容 - 其中所述内容属实 - 请大家在签字前先阅读一下 三份支票 · 文件编号 42603633 · 附件 1离线 01 · 发件人**合格电子签名**`„qualifiziert elektronisch signiert“`由该公司在第9页声明。 02 · 诚信**附件1的SHA-256哈希值**`2bb927e2…4ff7d6af`与记录的哈希值匹配。 03 · 内容**附件1的文本层**`pdftotext Anlage1.pdf -`1,044个矩形内可读取905,672个字符。 发件人:已声明。完整性:匹配。内容:损坏。该签名回答了第一个问题,但未回答其他任何问题。 检查 02 和 03 只需该文件和标准工具即可。检查 01 告诉你是谁发送的。只有 02 和 03 告诉你发送了什么。 文件编号 42603633 · 第 1 页一页,两种拼写方式 `Dr. Patrick Zurheide, LL.M. (Aberdeen)`签署方 `p.zurheode@*****wessing.com`信头 `p.zurheide@*****wessing.com`公开记录 标题拼写正确。信头中签署人的姓名拼写有误。第6页包含 „Die Antwortet lautet ja, in den dort genannten Grenzen.“ 在第1.5节和第1.6节的结尾处,一模一样地出现了两次。第3页通过以下方式发送数据: „Anbei übersenden wie Ihnen …“. ### 该导出操作旨在响应的请求 这些签名背后,是一项关于获取个人数据的要求。相关法律条文很简短。 (欧盟)第2016/679号条例 · 官方文本 第15条第1款 “数据主体有权要求数据控制者确认是否正在处理与其相关的个人数据;若正在处理,则有权访问该个人数据……” 第15条第3款 “数据控制者应当提供正在处理的个人数据的副本。” 第12条第3款 “……不得无故拖延,且无论如何应在收到请求后一个月内作出答复。如有必要,该期限可再延长两个月……” 来源:[EUR-Lex](https://eur-lex.europa.eu/eli/reg/2016/679/oj) 这些信件都了解这条法则。祖尔海德博士的信正是以此开头的: „nachfolgend erteilen wir Namens und in Vollmacht unserer Mandantin Auskunft gemäß Art. 15 Abs. 1, Abs. 3 DSGVO“ (第1页)。除了一处提及第三方权利(谢林斯基博士,第3页)外,两封信均未援引任何允许数据控制者限制访问的条款:既未援引第12条第5款,也未援引第23条,更未援引德国《联邦数据保护法》(BDSG)。而该请求收到的回复却是: 1. 2025年8月15日 · 谢林斯基博士 · 第1页**截止日期,“如果真有的话”** „Die Frist nach Art. 15 DSGVO hat, wenn überhaupt, erst … am 29. Juli 2025 begonnen“ 2. 2025年8月15日 · 谢林斯基博士 · 第2页**该账户已被注销** „Hiermit kündigen wir daher Namens und in Vollmacht der Valve Corporation … mit sofortiger Wirkung.“ 3. 2025年8月15日 · 谢林斯基博士 · 第2页**计数法证明:1,938起投诉,无论具体情况如何** „Unabhängig von den Einzelheiten der Beschwerden zeigt schon die bloße Anzahl …“ 4. 2025年10月1日 · 祖尔海德博士 · 第2页**数据范围限定为2025年7月30日** „… können wir erst ab diesem Zeitpunkt davon ausgehen, dass etwaige Daten … sich auf Ihren Mandanten beziehen.“ 5. 2025年10月1日 · 祖尔海德博士 · 第8页**其余部分,有一个条件** „Gerne beauskunften wir die restlichen (bzw. noch weitere) personenbezogene Daten, sobald Ihr Mandant uns nachvollziehbar darstellen kann …“ 6. 2025年10月1日 · 祖尔海德博士 · 第8页**“同谋”** „… dass Ihr Mandant bzw. dessen Komplizen seine Phishing-Angriffe … in verschleierter Form fortsetzen will“ 7. 2025年10月1日 · 祖尔海德博士 · 第9页**四项刑事法规** „… §§ 263, 263a, 202a, 303a StGB) einer strafrechtlichen Verfolgung zuzuführen.“ **第15条中并未规定任何此类条件。**访问权不会因合同终止、法院的预判或刑事法规而被取消。在提出请求106天后,该条款的内容仍与原文完全一致。 **PhishDestroy的解读。**医生们在第1页援引了该法律,随后却写得好像根本没有这条法律似的。 ### 这封信列出了Valve处理的内容。而该文件却省略了其中大部分内容。 在第2至6页中,这封10月份的信函引用了《Steam隐私政策》来描述Valve处理的个人数据。下文将逐一对比其中列出的各类别与《附件1》的内容。《附件1》共包含十二个部分:账户、个人资料、名称历史、登录记录、产品密钥、游戏时长、电话号码、投诉、聊天、Steam Guard设备、好友以及安全设置变更。 | 数据 | 信中提及的人名 | 见附件1 | | --- | --- | --- | | 交易与支付 | „Transaktions- und Zahlungsdaten“ · p. 2 „… Transaktionsdaten … für einen Zeitraum von bis zu zehn (10) Jahren aufbewahren muss“ · p. 6 | **缺席** | | 手工艺品与社区集市 | „… Konsistenz des Gameplays oder Steam-Community-Marktes …“ · p. 6 | **缺席** | | 成就、游戏进度、游戏内道具 | „Ihre erspielten Errungenschaften … Ihren Spielfortschritt … Ihre im Spiel erhaltenen Gegenstände“ · p. 4 | **缺席** | | 游戏所有权 | „… mindestens Ihr Eigentum am fraglichen Spiel“ · p. 4 | **缺席** · 仅限单日内的游戏时间及100次按键操作 | | 等级、徽章、收藏卡 | „Daten über die Nutzung des Steam-Clients und der Steam-Websites“ · p. 3 · items and market · pp. 4, 6 | **缺席** | | 帖子、评论、关注 | „… veröffentlichen, kommentieren oder denen Benutzer folgen“ · p. 3 „Message Boards, Foren und/oder Chatbereiche“ · p. 5 | **缺席** | | 聊天 | „Informationen, die Benutzer im Chat gesendet haben“ · p. 3 | 2条条目,已收录 | | 支持工单 | „… wenn Benutzer Informationen oder Support von Valve anfordern“ · p. 3 | **缺席** · 包括确认该区块的2025年5月票据 | | 已关联的第三方账户 | „… mit dem Konto eines Drittanbieters zu verknüpfen“ · p. 5 | **缺席** | | 区块背后的记录 | „Zum Entdecken von Verstößen erforderliche Informationen“ · p. 3 „… nach einer manuellen Prüfung durch einen Mitarbeiter der Valve Corporation“ · p. 7 | **缺失** · 无审核记录、无设备关联、无钓鱼报告 | **这封信描述了相关数据,但附件中并未包含这些数据。**付款情况是两位律师就所有权问题得出结论的基础,然而文件中却遗漏了付款类别这一项。 #### 该文件包含哪些内容,以及涵盖的期间 时间段取自文件中的日期,包括黑色矩形下方的日期。 | 章节 | 见附件1 | 文件中的句号 | | --- | --- | --- | | 基本账户信息 · 电子邮箱、国家/地区、用户名、Steam ID | 可读的 | 当前状态 | | 登录 | 日期和类型可读;时间、IP 地址、硬件 ID 被遮盖 | 2023年10月 – 2025年5月 · 该账户自2020年8月起存在 | | 游戏时间 | 游戏内容可读;最后使用日期和时间被遮盖 | 2020年12月 – 2025年5月 | | 聊天 | 2条条目,已收录 | 仅限2025年9月 | | 针对该账户的投诉 | 1,995 行 · 50 条可读描述 | 2021年2月 – 2025年9月 | | 朋友和街区 | 5,789 行 · 已涵盖 | 2021年2月 – 2025年9月 | | Steam Guard 设备 · 已注册的手机 · 安全设置变更 | 已涵盖 | 安全日志:2020年8月 – 2024年7月 · 4行 | | 产品密钥激活 | 涵盖的键 | 100 行,一个日期:2025年3月13日 | **似乎只有投诉记录是完整的。**其他内容几乎一无所有:登录记录始于2023年10月,好友记录始于2021年2月,产品密钥记录仅集中于某一天,而Valve商店中的整个分类都缺失。这封信所依据的决定所涉及的分类——即支付记录和封禁背后的记录——在文件中完全没有。 好友列表共有 5,789 条记录:4,410 条“被屏蔽用户”、1,182 条“好友”和 200 条“邀请者”,时间范围从 2021 年 2 月 24 日至 2025 年 9 月 28 日;其中 74 条记录的时间在最后一次登录之后。仅凭该文件无法确定这是当前的联系人列表,还是包含已删除联系人的完整历史记录。 关于第15条第(1)款的答复又引发了三个问题。数据接收方(c项)和数据来源(g项)仅以一般性政策条款的形式列出,并非针对本案。存储期限(d项)是政策条款的引用,未提供具体细节。而且,该函件将数据发送至 „als Anlage 1 und 2“ (第3页);本文仅对附件1进行探讨。 ### Valve 已经核实了该账户的所有者 该账户是为发布游戏而注册的 Steamworks 合作伙伴账户。该流程涉及 100 美元的 Steam Direct 费用、税务面谈、付款银行账户信息以及由 Valve 自行进行的身份验证。所有这些均属于 Valve 处理的个人数据。《通用数据保护条例》(GDPR)第 15 条涵盖了所有类别的个人数据,而不仅仅是隐私政策中列出的那些。其中没有任何一项出现在附件 1 中。 谢林斯基博士 · 第1页 ### “没有任何所有权证明” „… kein einziger Beleg für die Inhaberschaft (Verfügungsbefugnis) Ihres Mandanten für den Account …“ **身份已由Valve验证** 该信函所指的客户持有合作伙伴验证材料、相关文件以及100美元的付款。 谢林斯基博士 · 第3页 ### 要求申请人提供证明 „… gefälschten ‚Utility Bill‘ …“ · „… tatsächlich alleiniger Inhaber des Accounts …“ **未向申请人提供证据** 虽然要求申请人证明所有权,但Valve自己核实过的所有权记录却未包含在其可访问的副本中。 ## 模式:没有人能独自做决定,也没有什么可以交换 这并不是关于某一款软件的问题,而是关于由谁来做决定。在这个案例中,是两名律师决定哪50起投诉重要,其余的则不重要。既没有法院,也没有监管机构。 有些内容必须保密:记者的登录信息属于他人的数据。关键在于由谁来决定,以及事后是否有人能对这一决定进行核查。一个黑色矩形既无法解答这两个问题,任何人都可以将其移除。而两种标准工具则能同时解决这两个问题:在请求方的副本中使用带盐哈希,并将原始数据密封并由监管机构或法院的公钥保管。 坚定承诺 · 每个被保留的字段限选一项 c = SHA-256(salt ‖ value) 盐值由16个随机字节组成,每个字段都会生成新的盐值。请求方的副本中包含 `c` 代替该值,位于公司签名下方。该值及其盐值通过一个使用该权威机构的公钥加密的信封进行传输,加密方式可采用 OpenPGP 或 X25519 结合 AES-GCM。若没有该权威机构的私钥,任何人都无法打开该信封,且公司无法在不违反其已签署的承诺的情况下替换该值。 1. 步骤 1 · 申请方**把稿件和信封递过来** 附有承诺的签字副本及密封信封应提交给监管机构或法院。 2. 第 2 步 · 主管部门**打开信封并重新计算** 检查员使用监管机构的私钥进行解密,并针对每个字段重新计算 SHA-256(盐值 ‖ 数据值)。每个计算结果必须与该公司签署的承诺值相等。 3. 第3步 · 一个独立机构**决定究竟保护的是什么** 由主管部门(而非该公司)审阅所有被保留的内容——此处包括1,944份投诉文本和一份安全记录——并决定是否因第三方权益而需要保留这些内容。 附录 1 · 第 514 页 · 一行,两种隐藏方式实时 · 在您的浏览器中 原样呈现 · 黑色矩形仅视觉叠加 Aspose.PDF for .NET 20.8 · page 514文字图层 + 矩形 记者:[登录 · 本文未在此处转载] 日期: 2024-03-28 类型: Offensive Profile 正文: русофоб 在上面绘制了黑色矩形。下方的文本仍保留在文件中。 请求者副本 · 有条件的承诺由该公司签署 c = SHA-256(salt ‖ value)加盖公章 记者: [未公开 · 承诺] 日期: 2024-03-28 类型: Offensive Profile 正文: [withheld · commitment] 封套 · RSA-OAEP-256 + AES-256-GCM该证书颁发机构的公钥 副本中包含承诺。值和盐值位于信封中。 1. **1.** 申请人将复印件和信封交出 2. **2** 主管部门将其打开,并重新计算每一项承诺 3. **3** 主管部门决定哪些内容不予公开 这两个面板都隐藏了相同的两个字段。读取原始字节,然后运行授权方的校验。 左图:交付时的Anlage 1中的一行;第514页上的投诉文本位于一个黑色矩形下方,引用时未包含报告人的登录信息,该字段中填充了占位符。右图:同一行数据经过加盐承诺处理后,其值已使用权威机构的密钥进行封装。该密钥对是为本次演示在您的浏览器中生成的,而信封则是TgWitness用于密封传输的信封。步骤3中的决策是一个示例。 **没有人能独自做出决定**该公司仍会提出应隐去哪些内容。由一位对情况了如指掌且与争议无利害关系的人士进行审核。 **没有任何泄漏**请求者无法看到其他人的数据。盐值使得该承诺无法被用于猜测:如果没有盐值,只需对词表进行哈希运算,就能找到一个单词的投诉内容。 **没有任何东西可以交换**每个值都必须与公司签署的承诺相符。如果文本内容不同或缺失,则检查将失败。 **签名代表某种含义**对承诺书的合格签字,使公司对每一项隐含价值都承担约束力,而不仅仅是对封面信。 **头衔并不重要**支票的核对是算术问题。它需要支票副本、信封和授权方的密钥,而不是任何人的口头承诺。 所有这些都不需要新建基础设施。德国监管机构已经公开了OpenPGP密钥:联邦数据保护专员为[每个部门都列出了一个密钥](https://www.bfdi.bund.de/DE/Service/Kontakt/Schluessel/Schluessel-node.html),巴登-符腾堡州数据保护局(LfDI)也[提供了用于加密电子邮件的公钥](https://www.baden-wuerttemberg.datenschutz.de/kontaktdaten-des-verantwortlichen/)。德国法院已经通过EGVP接收诉讼文件,该系统的[端到端加密基于OSCI协议](https://egvp.justiz.de/behoerdenpostfach/Informationsmaterial_fuer_Behoerden_zu_BeBPo_und_eEB_V1_3_2.pdf)。 **PhishDestroy的立场。**谁赋予了律师决定何为重要、何为不重要的权利?律师不应做出这种决定。所有材料都应移交:不应以任何人都能删除的黑色矩形遮盖,而应加封,仅由法院或监管机构持钥匙开启,这样才不会给“错误”、“误解”或仅展示对自己有利的内容留下任何余地。 ## “诚实”模型:完整数据、明确规则、拥有权限的密钥 申请方将立即获得所有无争议的内容。任何被扣留的内容既不会通过图纸隐瞒,也不会默不作声地保留。这些内容将以完整且经签名的形式,使用有权对此作出决定的机构所设定的密钥进行加密后发送。 | 问题 | 发生了什么 | 诚实模型 | | --- | --- | --- | | 由谁决定扣留什么 | 争议当事方的代理律师 | 在制作副本时宣布并签署的一项规则;主管部门对其进行审核 | | 请求者将收到什么 | 选中了部分行;整个类别缺失;存在一个截断点,其后没有记录 | 所有无争议的记录,应立即 | | 第三方数据 | 上面画满了图,而且还在文件夹里 | 已从请求方的副本中删除;原始文件中保留该内容以供核对 | | 被扣留的部件 | 数量不详,内容不详 | 已计入签名清单;完整原始文件已使用该机构的密钥进行加密 | | 关于该副本如何被选中的证明 | 之所以存在,仅仅是因为删节工作失败了 | 包含:规则、计数、原始内容的哈希值 | | 有争议的领域 | 根据信中内容决定:“所有法院都会同意” | 由监管机构或法院决定,谁可以查阅这些文件 | | 时间 | 106天 | 出口加运输 | | 律师的作用 | 规定了适用范围、举证责任和判决 | 在法庭上就争议进行辩论;不修改申请人的数据 | 监管机构也不需要获得信任。根据《通用数据保护条例》(GDPR)第58条第1款(e)项的规定,监管机构本就拥有获取数据控制者处理的所有个人数据的权限。该模式仅以一种在接收时可验证的形式将数据移交出去。 **信中列举的理由——所有权存疑、第三方付款、投诉、疑似网络钓鱼——解释了为何未履行第15条的规定。这些理由均无法满足该条款的要求。**无论依据为何,结果都是一样的:请求人未收到其数据,在图纸下交付了他人数据,且该筛选结果仅能通过偶然情况进行核查。数据访问权是数据主体的一项权利,而非他人纠纷中的谈判筹码。 ## TgWitness 如何保存原始文件并确保副本可核查 TgWitness 将对话内容导出作为证据。其设计理念源于本案的经验教训:导出文件不应仅因提供者的身份就被视为可信。原始捕获的日志将被保留。共享副本会在其签名的清单中记录所选记录和字段、披露规则以及被排除记录的数量。零信任原则适用于所有人,包括我们自己。 保护 ### 保留原文 保留完整的捕获日志及其签名。独立保存一个检查点,以便日后可核查是否存在替换或截断的情况。 保护 ### 对传输内容进行加密 使用收件人密钥对压缩包进行加密,或使用密码保护邮件投递。解密时需要相应的密钥或密码。 披露 ### 指出遗漏之处 将目的和规则写入已签名的清单中。标注已简化的记录,统计被排除的记录,并保留指向源日志的链接。 TgWitness 已经针对接收方密钥对完整的原始数据进行了封装(使用上文演示中的“信封”),并标注了披露内容中被隐藏的部分。验证者会检查记录签名以及共享副本与源日志之间的关联;若要将隐藏内容与其原始哈希值进行比对,则需要保留完整的原始数据。本案例主张采取的措施,是针对授权方建立按字段加盐的承诺机制。 | 见附件1 | TgWitness 专题 | 记名支票 | | --- | --- | --- | | 黑色矩形下方的文字 | 已隐藏的字段已从共享副本中移除;原始副本另行保留 | 命名遗漏与原始记录哈希值 | | 显示 50 条描述;共 1,944 条 | 签名披露规则和排除记录的数量 | 选定的范围及其来源期刊的引用信息 | | PDF附件 | 对捕获的归档文件进行加密传输 | 经过身份验证的解密;归档文件签名和哈希值 | | 以下是该文件的 SHA-256 校验值 | 记录哈希值、签名和保留的检查点 | 与先前保存的日志进行比较 | ### 该软件旨在确保什么 **数据的完整性**每条记录都会被哈希处理并串联成链,并使用Ed25519进行签名。验证者会重新计算每条记录,因此任何更改都会显现出来。 **您可以查询的配送信息**归档文件在传输过程中会针对其接收方进行加密;大文件则被拆分为加密的各个部分,并附带一份经过签名的清单,由接收方在本地进行组装和验证。 **他人的数据仍处于封闭状态**共享副本会按规则进行屏蔽,并注明被屏蔽的内容。在面板中显示被屏蔽的值会受到审计。 **不容有失**这些检查都是算术性的:文件、可信密钥指纹以及保留的检查点。无需任何人出面担保。 **没有操纵的余地**编辑和删除操作会生成新的记录,缩短后的日志无法通过保留的检查点的验证,而披露内容若不完整,就永远不会被视为完整。 名称中的拼写错误不会改变软件签署的数据。逾期一个月也不会改变原始记录。任何更改都会中断校验链,验证器会指出这一点。请尝试以下两种情况。 SHA-256 · 在您的浏览器中编辑任意一行 已签名 · 带抬头纸`86582990a7b364adbd83071c9edb4774ed6e8ea50b80dca1ae426c3fa679a1d6` 公开记录`17fae25500c51998112b146c76b21b04bf3d4034407f2f958bced7d6d6e928ba` **1** 与众不同64个十六进制数字中有**60个**不同256位中有**128位**不同 仅差一个字符。两枚互不相关的指纹。 一个哈希值注意到了签名过程中被忽略的那个字母。签名不过是多出的几个字节:它会改变指纹,但绝不会改变事实。 签名日记 · 简体版示例记录 记录 1**17.06.2025 · access request**`adc396074b0f04…`= 已保存的哈希值 记录 2**01.10.2025 · letterhead p.zurheode**`0b8eda5c2f43ae…`= 已保存的哈希值 记录 3**01.10.2025 · Anlage 1 · 830 pages**`dbe2eef85bfb5a…`= 已保存的哈希值 每条记录都包含前一条记录的“指纹”。修改第2条记录会改变其哈希值,并切断与第3条记录的关联。 简而言之:每个指纹都会覆盖前一个指纹以及一行文本。TgWitness 对九个规范事件字段进行哈希计算(其中之一是前一个哈希值),并使用 Ed25519 对每个摘要进行签名。[查看包含检查点的完整链](https://phishdestroy.io/tgwitness/zh/docs/concepts/) [TgWitness 共享副本的工作原理](https://phishdestroy.io/tgwitness/zh/docs/handover/) · [密封的信封](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md#cryptographic-handoff) · [实施与验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) ## 请自己核实一下 任何持有相关文件的监管机构、法院或审计机构均可离线重复执行本页面上的所有核查。此处仅公布汇总结果:记者的登录信息、账户标识符及个人资料数据均不会在此处公布。 **所有月份:2021–2025** | 年 | 一月 | 2月 | 3月 | 4月 | 五月 | Jun | 7月 | 8月 | 9月 | 10月 | 11月 | 12月 | 总计 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 2021 | 0 | 2 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 1 | 20 | **25** | | 2022 | 10 | 7 | 43 | 9 | 2 | 7 | 2 | 11 | 7 | 6 | 5 | 13 | **122** | | 2023 | 111 | 48 | 156 | 59 | 52 | 53 | 66 | 52 | 73 | 44 | 53 | 58 | **825** | | 2024 | 69 | 58 | 111 | 36 | 33 | 46 | 83 | 53 | 54 | 70 | 79 | 82 | **774** | | 2025 | 92 | 32 | 35 | 20 | 12 | 1 | 7 | 47 | 3 | — | — | — | **249** | 0 表示该导出文件中该月无记录;— 表示已超过 2025 年 9 月的截止日期。总计:1**,995**。 **所提供表格中的所有报告类别** | 已记录的报告类型 | 所有记录 | 通俗易懂的描述 | 涵盖的描述 | | --- | --- | --- | --- | | Offensive Profile | 1,148 | 0 | 1,147 | | Suspected Hijacker | 312 | 43 | 269 | | 作弊 | 290 | 2 | 288 | | Offensive Persona Name | 87 | 1 | 86 | | Offensive Avatar | 57 | 3 | 54 | | 骚扰 | 46 | 1 | 45 | | 垃圾信息 | 37 | 0 | 37 | | 欺骗 | 16 | 0 | 16 | | 自动审核 | 1 | 0 | 1 | | 贸易诈骗 | 1 | 0 | 1 | 该 Offensive Profile 总数中包含一条空描述。总计:1,995条记录,50条可读描述,1,944条已涵盖描述,1条空描述。 **登录和安全记录** 附件1,第1页: `Last Client/Web Logon Time: 2025-05-23 20:48:31 (UTC)` 和 `Date of Report: 09-29-2025`. 第1至119页上的登录记录按时间倒序排列,最新条目为2025年5月,此后再无更新记录。 第830页的“安全历史记录”部分被黑色矩形遮盖。其最近一次密码更改时间为2024年7月;2025年未记录任何更改。这些行中的日期、地址和标识符均未显示。 ``` pdftotext -f 1 -l 1 Anlage1.pdf - # last logon, date of report pdftotext -f 830 -l 830 Anlage1.pdf - # security history ``` **PDF 元数据和签名声明** PDF 元数据:创建者 `Aspose.PDF for .NET 20.8`; 创建于 2025 年 10 月 1 日 19:58:05;修改于 19:58:41,均以 UTC+02:00 为基准。这两个时间戳是 **相差36秒**. 这两封信的最后一页均声明了合格的电子签名: „Dieses Schreiben ist qualifiziert elektronisch signiert“. 签名验证是与这里所示的内容和信息遮盖检查不同的另一项检查。 **重现计数结果并比较源哈希值** 计数脚本已固定在下方附件1的哈希值中。该脚本重建了第444至620页的表格行,并将跨越页边界的118个单元格进行合并。可见性由单词框与不透明黑色矩形的交集决定;唯一一个空的描述项被单独记录。 西里尔字母计数使用 U+0400–U+052F。登录格式比较使用完整字符串模式 `[A-Za-z]+[0-9]{3,5}`. 重复次数是在对提取的空白字符进行规范化处理后统计的。所涵盖描述中的词频统计结果在任何情况下都与词干相匹配。这些是描述性指标,并非对共同作者身份或学术不端行为的自动判定。 JSON 中可选的语言估计功能在本地使用 Lingua 2.2.0;短文本和含义模糊的文本仍未被分配语言。905,672 个字符的统计统计了每个边界框与黑色矩形发生一次交集的非空格字符;1,329 个黑色矩形中有 1,044 个与此类文本重叠。 [聚合计数 · JSON](https://phishdestroy.io/tgwitness/assets/signed-export-statistics.json?v=b84f21c8824d) · [本地计数脚本 · Python](https://phishdestroy.github.io/TgWitness/assets/signed-export-audit.py) ``` python signed-export-audit.py Anlage1.pdf --output counts.json sha256sum Anlage1.pdf pdfinfo Anlage1.pdf | grep -E "Producer|CreationDate|ModDate" pdftotext -layout Anlage1.pdf - | less ``` 该脚本需要 PyMuPDF 和 lingua-language-detector。它不会发起任何网络请求,且仅输出汇总数据,不会输出投诉文本或登录信息。 | 文件 | SHA-256 | | --- | --- | | 文件编号 42603633(祖尔海德博士) | `de0fdcf6bfaccedc98d1670438bc7ca3330479096875e716dbb9678922b43ab9` | | 文件编号 42282474(谢林斯基博士) | `b48e09c28ee40a46f1d404041751f718fb185d1eb774ddabb4373fdd53bbe2f1` | | 附件1 | `2bb927e2c42fdc2e3ad089ae302dd887c343f6798aba00fcfac279224ff7d6af` | **这是任何出口文件都应汲取的教训。**律师可以签署一份出口文件。签名仅表明了发件人,而非文件内容的真实性。所谓真相,是指经得起任何人反复核查的内容。 ## 我们的立场 **PhishDestroy的立场。**我们尊重法律和法院。法律并非真理的对立面。那些为了规避法律而曲解法律的人,绝非法院的盟友,而“博士”头衔也绝不能成为其权威的依据。 博士学位是一个历史事实:即在某个狭窄的理论领域内完成的一项研究,并进行过一次答辩。这并不能使任何人成为IT律师。 就我们所见,标题中没有任何内容能解释这些错误:无论是签名下方的论据,还是拼写错误的姓名,抑或是那些信件本身声称要保护的数据泄露,都无法解释这些错误。 双方签署方随后均根据第17条提交了搜索结果下架请求(参见[运营商通知](https://phishdestroy.io/tgwitness/zh/docs/reference/notice/))。“被遗忘权”不应抹去专业人士的职业过失。而且,究竟有没有人会核查那些经合格电子签名发出的文件?这些信件读起来更像是一封发给朋友的电子邮件,而非具有公共重要性的文件。 零信任,面向所有人。金钱是好的。但我们认为,为了金钱而出卖本国的法律,并非对金钱的最佳利用。不过,我们并非专家。 PhishDestroy 并非该争议的当事人,且未就封禁 Steam 账户是否合理发表意见。本页面未披露数据主体的身份;未转载账户标识符、登录名、IP 地址及个人数据。投诉文本的引用均未包含举报人的登录名,包括黑色矩形覆盖下的文本,这些内容仍保留在文件的文本层中。信函:文件编号 42282474, 2025年8月15日(3页);文件编号:42603633,2025年10月1日(9页)。附件:Anlage 1(830页)。页码引用采用PDF页码顺序。德语引文的英文译文由我们提供。[维德案卷宗](https://phishdestroy.io/steam_dossier/taylor_wessing) · [历时106天的《通用数据保护条例》(GDPR)案卷](https://github.com/phishdestroy/TgWitness/blob/main/docs/TAYLOR-WESSING-GDPR-FILE.md)。 --- # Telegram · 浏览存档 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/archive/ 加载历史记录、搜索已保存记录、审查 AI 来源并连接您的工具。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 查找消息。核查来源。构建案情。 01**引入历史记录** 将已启用来源的过往消息拉取到工作区。 02**追踪消息来源** 搜索,然后打开每条结果背后保存的消息。 03**确保交接清晰明了** 您的分析放在一个文件里,签名证据放在旁边。 捕获的记录、识别出的文本以及分析人员的结论均保持独立。 ## 加载历史消息 1. **来源 → 范围内的聊天**:检查已启用的聊天,开始观察。 2. **加载完整历史记录**。它按当前的来源列表执行。 3. 随时可以**暂停历史** / **继续历史记录**。重启后请手动继续。 4. 检查每个来源的结果和下载队列,将签名进度报告与导出一起保存。 这会填充工作区。单个聊天的 HTML/JSON 导出是另一回事。[详情](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)。 ## 先搜索,再决定是否使用 AI 1. **日志**在本地搜索,可按来源和时间筛选。 2. 搜索短语或域名,打开记录及其各个版本。 3. 使用 AI 时,由管理员在**集成**中设置服务商。然后**查询存档**:选择聊天和时间段,查看**发送到模型的数据**,取消勾选不应发出的内容。 4. 检查引用,将回答保存为报告,添加您的笔记。 搜索不需要 AI。报告保存自己的来源和修订版本,与签名日志分开。[服务商设置](https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/)。 ## 选择您需要的连接方式 | 任务 | 打开 | 设置 | | --- | --- | --- | | 让 AI 客户端读取选定的聊天 | **集成 → MCP** | [安装 MCP、创建限定范围的令牌并连接](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/) | | 识别保存媒体中的文本 | `media.saved`记录 → **识别附件** | [设置本地 Docker worker](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/) | | 将事件发送至 n8n 或 SIEM | **集成 → 外发 webhook** | [添加接收端、校验 HMAC、去重 ID](https://phishdestroy.io/tgwitness/zh/docs/reference/webhooks/) | **哪个访问令牌该填在哪里?** 面板访问是给人用的。MCP 有自己的只读令牌,webhook 有自己的 HMAC 密钥。它们都不需要 Telegram 会话。 [共享控制面板访问](https://phishdestroy.io/tgwitness/zh/docs/access/)权限或[配置 MCP 客户端](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/)。 ## 提供数据来源和结论 请将报告放在签名 ZIP 旁边。报告是您对来源的解读,ZIP 才是接收方要验证的内容。 [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/exports/) · [完整调查流程](https://phishdestroy.io/tgwitness/zh/docs/cases/) --- # Telegram · 分享案例 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/access/ 为审查员和分析师提供对选定账户和聊天的访问权限,并设置独立的权限、会话限制和可撤销的令牌。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 分享他人需要的案例。其余内容由您掌控。 01**选择证据** 整个工作区或单个聊天。 02**选择操作** 查看、导出,或仅限他们需要的操作。 03**设置限制** 个人令牌,可按需设置有效期、会话限制和 IP 规则。 采集范围决定了记录的内容。访问范围决定了用户可以查看和执行的操作。 ## 授予某人访问权限 1. 以管理员身份打开**访问**。 2. 命名,选择工作区和聊天。 3. 审核员只需要**查看**。如需下载请添加**导出**。 4. 设置权限限制,然后点击**“创建访问权限**”。 5. 复制令牌(只显示一次),连同面板地址私下发送。 6. 先在单独的浏览器会话中检查他们会看到什么。 ## 从他们需要完成的工作入手 | 人物 | 访问 | 结果 | | --- | --- | --- | | 审稿人 | 精选聊天记录;仅限查看 | 阅读聊天,不能更改任何内容。 | | 分析师 | 精选聊天记录;查看和导出 | 阅读并下载案件所需内容。 | | 操作员 | 精选的完整工作区;来源与收集 | 决定观察哪些内容,启动和停止采集器。 | 这些只是示例,不是固定角色。限于聊天的访问权限永远不会获得账户设置或完整日志导出。所有工作区的访问权限包括之后添加的账户。 ## 您可以随时改变主意 随时可编辑访问权限,从下一次请求起生效。可结束单个会话或全部撤销。已下载的文件无法收回。采集会继续运行。 **会话和 IP 限制** 限制并行会话和登录次数,设置截止日期,允许特定 IP 或子网,或锁定为首次登录的 IP。有效期按不活动时间计算,打开着的面板算作活动。在代理后面时,请检查应用看到的是哪个客户端 IP。 **主密钥和活动日志** 主令牌留在管理员手中。发放的访问权限不能管理他人的访问,也不能打开管理控制台。访问变更和会话会签名写入日志,不包含令牌。服务器管理员仍然可以看到一切。 全部七项权限和会话规则:[访问参考](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)。 --- # Telegram · 保持其运行 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/server/ 请在配备持久化存储、私有控制面板访问权限、备份功能以及重启后自动检查机制的服务器上运行 TgWitness。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 让采集器保持运行,数据在重启后依然安全。 ## 选择启动方式 原生:[启动器](https://phishdestroy.io/tgwitness/zh/docs/start/)加上 [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) 中的服务模板。Docker,在项目文件夹中执行: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` 面板监听 localhost:8787。在本地或通过 SSH 隧道打开,使用第二条命令输出的令牌。 ## 保留整个数据目录 原生:`data/live`。Docker:`tgwitness-data` 卷。日志、会话和密钥必须放在一起。签名导出是证据,不是备份。 1. 先停止采集。 2. 将整个数据目录复制到主机以外的安全位置。 3. 在信任它之前,先在单独的安装上试着恢复。 ## 重启后请检查 检查工作区和密钥、连接、来源,以及新消息是否进来。TgWitness 会补上 Telegram 仍保留的内容,而不是停机期间发生的一切。 容器“健康”表示 Web 服务器有响应。采集是否正常,要看测试消息和见证人。 ## 仅发布您有意发布的内容 HTTPS、卷、更新和恢复见部署参考。实际测试过的内容:[验证记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)。 --- # Telegram · 查找问题所在 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/troubleshooting/ 请使用针对各问题的正确信号,检查控制面板访问权限、Telegram 连接状态、消息缺失情况、FloodWait 状态以及见证状态。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 从症状入手,一次检查一项。 ## 面板要求输入令牌 它要的是启动器所打印文件中的面板令牌。Docker:`docker compose exec tgwitness cat /data/panel-token.txt`。不是 Telegram 验证码,不是机器人令牌,也不是见证人令牌。 ## Telegram 无法连接 运行连接检查。如果用的是公共代理,换一个并保存。检查代理类型和密钥格式。刷新列表本身不会切换路由。 ## 已连接,但无新消息 1. 观察是否在运行,且在正确的工作区中? 2. 来源是否已选中,且该账户可见? 3. 在测试群组中发送一条独特的消息,然后搜索它。 4. 在日志中查找中断或 Telegram 错误。 安静的聊天只是没有新内容。如果完整性很重要,请进行受控的送达测试。 ## 重启后出现 FloodWait 或间隔 FloodWait 是 Telegram 在说“慢一点”。请等它过去并减轻负载,重新连接没有用。重启后 TgWitness 会补上 Telegram 仍保留的内容;其余的是空缺,请记录下来。 ## 该机器人已配置完毕,但尚未发布任何内容 见证人是否在运行,机器人能否在频道中发帖,它能否访问采集器和 Bot API?在它的日志中查找发帖失败。采集器端出现轮询并不代表帖子已发出。 ## GitHub 令牌集成功能在哪里? **计划中。**“扩展功能”部分描述了拟议的分叉和构建验证工作流。目前尚无 GitHub 令牌表单,也无法自动验证运行中的安装是否与代码库匹配。请参阅[当前功能状态](https://phishdestroy.io/tgwitness/zh/docs/reference/features/)。 报告 bug?请提供版本、操作系统、步骤和去除隐私的错误信息。切勿在公开 issue 中放入会话、令牌、私信或数据目录。 --- # Export Clinic Canonical page: https://phishdestroy.io/tgwitness/zh/docs/export-clinic/ 观看一项受控的 Telegram Desktop 导出实验,对比七个测试对话,并查看原始录音和配对文件。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 聊天记录显示“FAIL”。导出的页面显示“PASS”。请留意这一变化,比较文件并查明原因。 该实验使用了测试账号和预设对话脚本。Telegram Desktop是从官方渠道下载的,其可执行文件未作任何修改。本地辅助程序故意修改了选定的导出文件。 请观察下载、登录和导出过程,然后将Telegram对话内容与经过修改的HTML和JSON文件进行对比。该实验展示了普通导出文件可能被篡改的环节,以及记录采集过程的重要性。 **1:59.7** 浓缩版影片**6:08.8** 完整原始录音**7段**测试对话 ## 观看实验视频 [下载影片](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) 1:59.7 · 设置和重复步骤以 2 倍至 15 倍速播放,并标有标签。登录、首次导出以及选定的比较操作均以原始速度运行。无音频。 [下载原始 MKV 文件 ↗](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) ## 比较测试导出结果 这些摘录来自已保留并修改过的 JSON 文件。请选择一种对话类型,比较相关消息,然后下载完整的配对导出文件,以便自行查看 HTML、JSON 以及其中的图片。 ### 导出指南 | PDF 检查 5 条消息 · 2 处修改 **本地变更之前**保留了原始字节 文档检查 / 合成测试 结果:未通过 黑色矩形下方仍可选中隐藏文本。 这是针对演示 PDF 的预设结果,并非对第三方文档的检测。 d58d19814e1e07d5… **本地变更后**被故意篡改的字节 文档检查 / 合成测试 结果:通过 所有敏感文本均已被永久删除。 这是故意替换的演示结果。 83a0a37eb7110d51… result.json · 消息 1216 剧本中的场景内容。该机器人的判定并非对真实第三方文件的审查。 已修改第 1 条消息(共 2 条) **请对比此导出文件中包含的一张图片** ![局部修改前的图像](https://phishdestroy.io/tgwitness/zh/docs/export-clinic/) 之前 · 保留的图像字节 ![经过刻意修改的图片](https://phishdestroy.io/tgwitness/zh/docs/export-clinic/) 之后 · 故意替换的图片 此次机器人导出未包含附件。该压缩包保留了这一限制。 JavaScript 已禁用。默认的机器人对比功能及所有下载选项仍可正常使用。请下载配套的压缩包,以查看其余六段对话。 ## 这一比较说明了什么 Telegram 的[常规导出功能](https://telegram.org/blog/export-and-more)会将聊天记录和选定的媒体文件保存为本地文件。在此情况下,一位拥有写入权限的协助者会修改这些文件,而官方客户端则继续显示原始对话内容。通过对比这两组文件,您可以查看每一处修改。 1. **官方客户端:**下载、登录并查看测试对话。 2. **原生导出:**客户端生成 HTML、JSON 以及选定的图片。 3. **已披露的干预行为:**一名本地协助者故意修改了选定的文件。 4. **对比:**对话内容和修改后的导出内容并排显示。 ### 在收集数据时立即记录下来 签名的时机至关重要。对已经过篡改的出口数据进行签名,将使该篡改后的版本得以保留。TgWitness 连接到 Telegram,记录发送到该账户的内容,并在收集过程中对日志条目进行签名并建立关联。收件人可以对照这些签名以及独立保留的检查点,核对已保存的记录和文件。 对于外部录制的数据收集流程,[GitHub Actions 会](https://phishdestroy.io/tgwitness/zh/docs/capture/)运行一个已固定的 TgWitness 收集器,并使用全新的 Telegram 会话。GitHub 会对生成的归档文件进行认证。验证过程会检查已批准的工作流和收集器版本、归档文件的摘要、日志以及附件。 [验证 TgWitness 归档文件](https://phishdestroy.io/tgwitness/zh/docs/exports/#verify) · [尝试修改一个已签名的记录](https://phishdestroy.io/tgwitness/zh/docs/concepts/#chain) · [运行 GitHub 抓取任务](https://phishdestroy.io/tgwitness/zh/docs/capture/) ## 取证工具究竟能提供哪些认证 “Export Clinic” 展示了一个具体案例。其中揭示的模式并非 Telegram 所独有。 在我们审查过的绝大多数诉讼程序中——包括法庭文件、案件讨论和已发表的分析——“数字证据”都遵循一种一致的格式:一份Telegram导出文件(HTML或JSON文件,有时是显示器的屏幕录屏,有时是iPhone在浏览个人资料页面时的视频),并附有专家签名。这通常就是整个证据链的全部内容。 Telegram 的导出功能为个人数据可携性提供了快照。TgWitness 会添加采集记录、保存的观察结果和变更、文件哈希值、采集者签名以及所选模式下可用的外部验证记录。这些信息综合起来,使接收方能够将保存的内容与其记录的上下文、时间及采集条件进行比对。 ### 工具本身是客观的。问题在于人们认为它们能证明什么。 我们曾直接与UFED Cellebrite合作过。这是一款非常出色的软件。当它从设备中提取数据、计算SHA-256哈希值并生成带签名的报告时,它准确地证明了一件事: *这些字节在提取时就存在于该设备上,传输过程中没有任何变化。* 这是真实的。这是有用的。这就是它所能证明的全部。 它并未说明执法部门接触该设备之前,设备中存储了什么内容。它也未说明这些数据是否反映了历史事实。该工具是准确的。但该工具并非证人。 我们可以选用专门用于处理Telegram聊天记录导出文件的工具——例如查看器、归档器、法庭展示封装工具——用预先准备好的导出文件对每款工具进行测试,并制作一份对比表。但我们不会这么做。关键不在于哪款工具能捕获什么内容。因为它们都做不到。它们只是处理导出文件中的内容。如果导出文件在传入这些工具之前就已经被构造好了,它们就会如实呈现这种构造。 加密签名仅对*签名时刻及之后*的数据完整性进行认证。它不对此前发生的情况作出任何声明。如果输入是在提取之前生成的,则该报告在加密意义上是完美的,但在事实层面却是错误的。该工具对这两种情况的报告结果完全相同。 ### 问责缺口 试想一个司法管辖区:在那里,取证设备是通过公开招标采购的——其型号、配置和采购时间表均可在公共记录中查阅;没有任何法律要求设备必须安装最新固件;专家证人因其作出的结论而在法庭上不承担个人刑事责任。 在美国和英国,法医鉴定人员对其处理证据的每一项行为都须承担个人法律责任。正是这种责任——而非软件本身——确保了证据链的正常运作。一旦这种责任不复存在,原本用于伸张正义的工具,就会沦为许可持有者为达到任何自认为方便的目的而滥用的工具。 **癫痫发作前装置状态的技术构建** 如果当事人提前得知即将发生的一次扣押——七天的时间绰绰有余——那么恐慌反应不仅适得其反,而且在某些司法管辖区还构成单独的刑事犯罪。而那些有备无患、具备技术条件和资源的当事人则会采取不同的行动:他们会构建一种设备状态。 **固件更新窗口。**三星旗舰机型Galaxy S Ultra、Z Fold——配备Knox安全防护,启动加载程序被锁定。安全补丁发布与特定地区设备实际收到补丁之间的时间间隔通常长达一个月。对于新发布的机型,发布后的头三到四个月内,这一时间间隔会显著更长。据我们所知,没有任何司法管辖区在法律上要求个人设备必须安装最新固件。 **服务级工具。**商用维护软件可在该时间窗口内提供低级设备访问权限,同时不会触发法医鉴定人员会重点检查的Knox篡改指示器。 **时间线构建。**通过将完整的设备备份部署到模拟器中,结合脚本驱动的时间操控和网络隔离,可以构建所需的事件时间线:通话、消息、应用活动、GPS坐标。 **无需接触蜂窝网络即可定位。**蜂窝基站的计费记录可独立核查——请勿触碰。取而代之的是,系统会记录用户与公共Wi-Fi接入点的连接记录。主要科技公司会系统性地收集并分发公共基础设施的MAC地址。通过公开数据,可以拼凑出覆盖任意所需时段的连续地理轨迹链。 **账户轮换。**三星账户的删除大约需要七天才能完全清除。创建新账户后,将恢复已准备好的备份。不会引发系统完整性冲突,引导加载程序保持原状,也不会触发篡改标记。 **具体来说是Telegram。**在某些设备系列上,应用程序的数据库和缓存——包括聊天记录、媒体文件、通知元数据以及活动模式——可以在操作系统功能层面上被替换,而无需传统的root权限。专家对完整的原始数据转储进行深入分析,或许能够检测到异常情况。这种分析成本高昂、速度缓慢,而且根据我们的经验,在标准诉讼程序中几乎从未被要求进行。 ### 垃圾进,垃圾出 该签名报告将提取的字节与该采集数据关联起来。较早的设备历史数据则通过该时段之前的记录进行评估。 随后的流程——专家证人解读工具生成的结果、撰写分析报告、签署结论——在每个单独的步骤中同样准确无误。该流程中的任何人都没有说谎。该流程中的任何人都没有在证明历史真相。每位参与者都准确地报告了他们从前一步收到的内容。 博士学位是过去已完成研究的证明。它并非当前能力的认证,也无法使一个在数学上无法验证的论断成为真理。我们提出一个不同的标准:**相信数学,而非头衔。** ### 基于证据的零信任 在信息安全领域,“零信任”意味着无论角色身份或资质如何,默认情况下都不信任任何主体——每一项声明都必须经过独立验证。我们建议将这一原则应用于数字证据。信任本身就是一种漏洞。如果一项声明无法通过独立且数学化的方式进行验证,那么它就是一种基于信任的声明——而信任可能会被误置、被收买或被胁迫。 就Telegram证据导出而言:不要相信我们,不要相信Telegram,不要相信分析师,也不要相信专家证人。请自行核对计算结果。 实际应用中,TgWitness 证明引用了 SLSA v1 3 级模型——由 GitHub Actions 基础设施签名的构建溯源信息,与特定的提交哈希和工作流运行绑定。该证明可独立验证,无需信任参与收集过程的任何个人。它并未消除所有信任假设——而是精确记录了哪些假设仍然存在,以及这些假设的具体内容。 **关于专家证人与经济激励** 一名律师既代表争议一方,又在同一诉讼程序中以中立第三方专家的身份出现,且其报酬与委托人的诉讼结果挂钩:这是一种结构性矛盾。我们并非在指责任何个人。我们想问的是,为什么这种结构会被视为可以接受的,以及为什么它极少受到审视。 对此的标准反驳是:*撒谎会让他们付出多大代价?*在承认“被删除权”和“被遗忘权”的司法管辖区,追究专家作伪证的实际成本往往微乎其微。那些对错误的专家结论提出质疑的人,往往会收到法律函件,要求其停止质疑。这一过程对提出质疑的人来说成本高昂,但对专家而言却并不昂贵。 我们并不是说所有的专家证人都不可信。我们想说的是,“撒谎对他们来说代价太高”并不是一种证明标准,而是一种信任标准。而信任本身就是一种脆弱之处。 任何希望对 TgWitness 认证提出质疑的主体,都需要破解加密签名,说服 GitHub 的签名基础设施对它从未执行过的操作进行追溯性认证,并且要在见证人在场的情况下,针对不可变的提交历史记录完成这一切。如果这些能力确实存在,只是被操作 PDF 软件的困难所掩盖,我们诚挚地欢迎相关演示。 我们并非声称自己的工具更优——我们没有商业产品,对此也毫无兴趣。我们注意到一个问题:人们普遍认为取证软件的输出结果等同于历史真相,而专家的签名等同于证据。在最关键的诉讼程序中,这种假设在技术层面上极少受到质疑。这项实验只是一个受控的数据点。数学对头衔不持任何立场。 ## 下载资料 视频和 ZIP 文件托管在 [phishdestroy.io](https://phishdestroy.io/) 上。请选择您要检查的文件。这两个 ZIP 文件均包含精选的测试数据和文档。修改工具、源代码、配置、凭据和会话均未包含在内。 ### 导出前/导出后 七段测试对话:HTML、JSON、嵌入的图片以及标准查看器资源。包含文件清单和选定的变更日志。 [测试导出 · ZIP · 3.0 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-paired-files.zip) 没有视频。没有修改工具。 ### 视频 + 测试导出 完整的原始录音、两分钟的视频、成对的导出文件、说明、元数据审查、编辑地图和校验和。 [视频 + 测试导出文件 · ZIP · 46.9 MB ↓](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-review-package.zip) 包含较小的ZIP文件。不包含修改工具。 **这个46.9 MB的ZIP文件里到底有什么?** - `video/ExportClinic_2026-11-03_12-50-40.mkv` — 未经剪辑的完整录音,时长 6:08.8。 - `video/export-clinic-2min.mp4` — 精简版影片,1分59.7秒。 - `data/export-clinic-paired-files.zip` — 解压此嵌套 ZIP 文件以查看其中的 `before/` 和 `modified/` 文件夹。 - `description/article-en.md` — 说明与限制。 - `verification/` — 四个 JSON/Markdown 文件,涵盖地图编辑、元数据检查和包审查。 - `README.md` 以及 `SHA256SUMS.txt` — 阅读说明和文件校验和。 外部ZIP文件中共有十个文件。单独的完整MP4文件未包含在内,因为原始MKV文件中已包含完整的录制内容。标准 `js/script.js` 每个导出的聊天记录中包含的,是Telegram未作修改的HTML查看器资源。 ### 单个视频文件 - [原始 MKV · 6:08.8 · 29.6 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/ExportClinic_2026-11-03_12-50-40.mkv) — 与源录音字节级完全一致。 - [打开完整 MP4 文件 · 6:08.8 · 29.9 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-full.mp4) — 经过适配浏览器的容器格式转换,未对视频进行重新编码。 - [打开压缩版 MP4 · 1:59.7 · 14.3 MB](https://phishdestroy.io/research/telegram-export/2026-11-03/export-clinic-2min.mp4) — 播放速度的变化处均有标注。 [下载校验和](https://phishdestroy.io/tgwitness/assets/export-clinic/SHA256SUMS.txt)[视频编辑地图](https://phishdestroy.io/tgwitness/assets/export-clinic/recording-manifest.json?v=42fbcde007f1)[配对文件清单](https://phishdestroy.io/tgwitness/assets/export-clinic/review-file-manifest.json?v=c725b2ecbe50)[元数据审查](https://phishdestroy.io/tgwitness/assets/export-clinic/original-metadata-notes.md)[最新说明与验证指南](https://phishdestroy.io/tgwitness/assets/export-clinic/article-en.md) 可下载的评测 ZIP 文件保留了原始的 README 文件和文章。当前的说明包含 TgWitness 的收集与验证指南。 **“变更前”状态的构建过程:**这是根据变更前状态重建的文件夹树。已更改的文件是从保留的备份中按字节逐一恢复的,并与其记录的哈希值进行了比对。未更改的查看器资源则从捕获的导出文件中复制而来。文件清单记录了所提供的版本信息。 在七次对话中共有45条消息记录;其中17条记录和32个文件存在差异。每个版本包含340个文件。在记录的导出文件中未选中PDF附件,因此这些存档中没有这些文件。 ## 实验详情 **变化发生在哪里?** 一位本地协助者修改了Telegram Desktop生成的文件。官方客户端的可执行文件以及Telegram中显示的聊天记录均未被修改。对比结果显示了原始消息与被篡改的导出文件并列。 **这些是完整的账户导出数据吗?** 不。这些材料涵盖了七段自有测试对话:一段私人聊天、一段与聊天机器人的对话、一个私人群组、私人和公共超级群组,以及私人和公共频道。其中包含45条消息记录。未包含任何无关的聊天记录、联系人或全账户存档。 **PDF附件包含在内吗?** 不。记录的导出设置中排除了文件附件。测试消息和图片中提到的PDF文件,但这些压缩包中并不包含该PDF文件。文件和描述中都保留了这一区别。 **该套装中包含改装工具吗?** 不包含任何可执行文件、辅助源代码、转换配置、会话数据、凭据或完整的运行日志。配对导出文件中的小型 JavaScript 文件是 Telegram 未作修改的标准 HTML 查看器资源,经核查,这两个版本中的文件内容完全一致。 **如何检查已下载的文件?** 计算每个文件的 SHA-256 值,并将其与已发布的校验和进行比对。若数值一致,则表明您拥有的正是已发布的文件。文件清单中列出了两个导出版本;视频编辑图则记录了精简版影片。录制时间基于主机时钟。 **TgWitness 是如何确保记录可核查的?** 收集器在从 Telegram 接收数据时会对条目进行签名。存档包含日志、文件哈希值和验证数据。请将密钥指纹和检查点分别保存,然后将收件人的副本与它们进行比对。GitHub 捕获功能还增加了对已批准收集工作流及其输出结果的验证。[请按照验证步骤操作 ↗](https://phishdestroy.io/tgwitness/zh/docs/exports/) 为本次实验准备了七段对话。录音、配对导出文件和变更日志记录了上述本地文件的变更情况。 受控本地文件实验 · 2026年11月3日 已复制完整的 SHA-256 值 --- # 56 329消息。 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/validation/ 在两次有记录的测试中导出了 56,329 条 Telegram 消息。比较消息数量、收集速度、导出时间以及签名存档。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) TGWITNESS / 真实出口 已捕获。已导出。 两份最新的Telegram导出数据,记录了从数据采集到最终存档的完整时间线。浏览工作区,查看相关数据,并下载样本。 [体验演示](https://phishdestroy.github.io/TgWitness/demo/?lang=en)[下载导出示例](https://phishdestroy.github.io/TgWitness/demo/downloads/tgwitness-demo.zip) 交互式演示和示例中使用的是虚构的消息。下面的测量数据来自真实的导出运行。 TGW / 001 录制的快照 · 非实时监控 核对于 2026-11-06 18:37:38 UTC 已测试的修订版 [92e539af](https://github.com/phishdestroy/TgWitness/commit/92e539af40d8368d198ff5e040f1d876f2c1310e) 文本 + 元数据 · 已签名的档案 **56 329**已导出的消息 **160.531**每秒消息数 · 最佳连胜纪录 **2**签名版出口批次 **3**已检查的服务器 服务器 AWARP · 2 账户 **27 030**已导出的消息 **142.983**每秒消息数 仅限自提 189.043 s 完全导出 211.647 s 服务器 BWARP · 2 账户 **29 299**已导出的消息 **160.531**每秒消息数 仅限自提 182.513 s 完全导出 206.650 s 01 / ## 以实际出口额为基准。 每个服务器一次新的导出,每个服务器使用两个账户。文本和元数据通过WARP传输;附件除外。 每秒消息数 服务器 A**142.983 每秒消息数** 服务器 B**160.531 每秒消息数** 服务器 C 未测量 — 信息 ÷ 收集时间。准备、筛选和包装不包含在此时间段内。 消息数 ÷ 总测量出口时间(包括准备和包装时间)。 服务器 C 没有收款基准收据。 两次运行中均未出现记录重复使用或ID重复的情况。服务器A在后台还运行着一个受保护源的读取操作。FloodWait暂停规则得到了遵守:A · 4,B · 3。 **精确测量值与存档哈希值** | 服务器 | 消息 | 仅限自提 | 完全导出 | | --- | --- | --- | --- | | 服务器 A | 27 030 | 189.043 s **142.983 每秒消息数** | 211.647 s **127.713 每秒消息数** | | 2026-11-06T18:26:51.500Z → 2026-11-06T18:30:23.228Z SHA-256 `20e507fc68446680ed002fd486d0968a944ec0c71e02f937331ae2b19ab4cd66` | | | | | 服务器 B | 29 299 | 182.513 s **160.531 每秒消息数** | 206.650 s **141.781 每秒消息数** | | 2026-11-06T18:25:40.419Z → 2026-11-06T18:29:07.173Z SHA-256 `824601b502762efaabb8ff9afdb1e8d7fff189862ef2cbc4d8d26d0d68c83e4c` | | | | 这两个存档均通过了固定收集器密钥的验证。 02 / ## 这三项,范围均已明确说明。 对每台服务器都检查了日志完整性、文件权限、存储、网络路由和正在运行的进程。 A 已检查 ### 服务器 A 收集与导出 8 vCPU · 16 GiB · Ubuntu 24.04 已查阅的期刊 21 期刊活动 4 517 检查点 147 新数据集基准测试、归档验证和备份完整性检查。 B 已检查 ### 服务器 B 收集与导出 8 vCPU · 16 GiB · Ubuntu 24.04 已查阅的期刊 21 期刊活动 1 993 检查点 147 新数据集基准测试、归档验证和备份完整性检查。 C 已检查 ### 服务器 C 面板与嵌套虚拟机 8 vCPU · 32 GiB · Ubuntu 24.04 已查阅的期刊 14 期刊活动 7 185 检查点 973 已对面板身份验证、回环绑定和嵌套虚拟机进行了检查。该服务器上未进行收集基准测试。 **测试结果、范围及技术说明** 03 / ## 传球与空当,并行不悖。 按 pytest 测试用例划分的最新结果,包括重跑结果。下文将独立浏览器测试套件和证据测试套件分别统计;它们不会计入 pytest 的总数。 **1 585**通过 **3**失败 **37**已跳过 有三项浏览器捕获测试需要 Chromium 沙箱,而这些容器并未提供该功能;因此沙箱保持启用状态。这 37 次平台跳过与通过次数分开统计。 - 浏览器套件**102 通过了** - 接口套件**66 通过了** - 证据套件**15 通过了** - 网站套件**9 通过了** - 其他套房**13 通过了** 04 / ## 本快照的范围。 1. 01 ### 浏览器沙箱 有三项浏览器检测功能正在等待配备 Chromium 沙箱的环境。 2. 02 ### 备份时间 42 个备份日志和 51,285 个文件通过了完整性检查。在快照生成时,最新备份比实时采集落后了 3,507 个事件。 3. 03 ### 网络覆盖范围 40条路由中有24条符合条件。其余16个账户保持断开状态,而非回退到直接连接。 4. 04 ### 独立时间 保留的证人日志通过了完整性检查。其最后一条记录发生在11月6日07:27(UTC)。 5. 05 ### 安全控制措施 安全模型中描述了密钥保护、账户保护、持久化存储和访问控制;本次审计发现的问题已在经签署的报告中列出。 6. 06 ### 已检查的服务器 本页的范围是这三台已检查的服务器。 7. 07 ### 测得的工作量 两个公开数据源,两次独立运行,仅包含文本和元数据,不包含附件下载。服务器 C 的运行未进行采集速率测量。各图表数据均对应其记录的工作负载。 05 / ## 一份带有日期的记录,其中包含可追溯至这些数字的线索。 由维护人员进行的测量数据,并使用审计密钥签名。该 JSON 文件仅包含汇总数据。源身份、账户身份、消息内容、凭据和私有存档均未公开。 1. 将源代码版本固定,并验证已安装的发布版本。 2. 收集到一个新的工作区中,不保留任何重复使用的记录。 3. 分别测量采集间隔和完整导出间隔。 4. 使用其固定密钥对归档文件进行验证;保留其 SHA-256 摘要。 经过测试的版本 `92e539af40d8-83e41104669e` [下载数据 ↓](https://phishdestroy.io/tgwitness/validation/snapshot.json?v=4fcf5cecaf21) SIGNED AUDIT / ENGLISH ### Check the numbers. The English report includes the measured results, open findings and a reproducible signature check. [Read the report ↗](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)[Signed statement ↓](https://phishdestroy.io/tgwitness/validation/audit/PROOF.json?v=5b89c774b601)[Measurements CSV ↓](https://phishdestroy.github.io/TgWitness/validation/audit/MEASUREMENTS.csv)[Python verifier ↓](https://phishdestroy.github.io/TgWitness/validation/audit/VERIFY.py)[File checksums ↓](https://phishdestroy.io/tgwitness/validation/audit/SHA256SUMS.txt) The signature binds the report and its measurements to the audit key; a change to any signed file fails VERIFY.py. The report records the completed audit at 19:08 UTC; the infrastructure snapshot above was taken earlier. **源收据摘要** 这些哈希值用于标识已保留的、经过签名的测量结果收据;私有原始文件由维护人员保存。 - benchmark-1.json`66cdf2db25901ee1f780a0e2d14b9b84888dbe525bff73bae19819b217f95d0c` - benchmark-2.json`ad2978fe2a7563476da43293eaaf5f498ee12522f0ea3e401bc43205c64874d1` - test-totals.json`922cf87d9320b149f2fc6791fc05f98335ec0952f9258e6eaeff179aeef33bb1` - infra-summary.json`325d390ef752b15f44203f97348863e24f0f631fe88998d5e1f398a5311a9339` 每个图都标明了其修订版本、工作量和环境。未测量的数据显示为“缺失”。 --- # TgWitness: Telegram Export, OSINT & Verification Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/ Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions. [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/llms.txt) 通过一条命令安装,或在 GitHub Actions 上进行捕获。了解调查选项、已发布的规模以及存档所验证的内容。 TgWitness 是一款开源的 Telegram 数据导出工具及调查工作区。只需 一条命令即可安装,连接账户,选择聊天记录并导出经过签名的 归档文件。它还支持在 GitHub Actions 上进行临时数据收集,并可通过 保存的编辑记录、删除观察记录、搜索和报告功能继续开展调查。 ## 从您手头的任务开始 | 您的任务 | 最短路径 | 您将收到 | | --- | --- | --- | | 保存对话或账户 | 安装、连接账户、选择导出范围 | 一个包含所选历史记录、收集结果和验证材料的签名存档 | | 在临时运行器上收集 | 使用 GitHub Actions 进行数据捕获、授权新会话并选择作用域 | 一个包含 GitHub 工作流溯源信息的加密存档 | | 跟踪随时间推移的变化 | 保持对选定聊天室的观察功能持续运行 | 已保存版本、删除通知、附件及记录的覆盖范围 | | 调查并分享调查结果 | 搜索存档、使用案例板,并配置报告或共享副本 | 附有来源链接的发现结果,以及适合接收方的可验证交接流程 | ### 一键安装 安装程序包含 Python 及其依赖项。源代码检出、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" ``` 打开控制面板,连接您的 Telegram 账户并选择数据采集范围。 安装过程不会自动启动数据采集。[安装指南中](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/) 详细说明了本地访问、服务器配置、更新以及如何验证已下载的构建版本。 若需临时运行程序,请按照 [GitHub Actions 捕获指南](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)操作。该 工作流需要 GitHub 分支、授权以及归档密码。捕获 页面详细说明了这些步骤以及运行前的会话时间限制。请下载 并保留生成的归档文件及其验证材料。 ## 当任务需要时,提供更多设置选项 单个聊天记录的导出需要一个账户和选定的范围。持续观察、 多个账户、代理服务器、附件策略、报告设计、审核员访问权限、 外部时间戳和异地存储可满足不同的调查和 移交需求。在相关情况下配置这些功能。 范围、权限和最小化共享副本有助于操作员选择要 收集和披露的内容。管辖权指南和报告设置记录了 所选的流程和准备步骤。参见[账户导出](https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/)、[访问](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)和 [报告配置](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)。 该应用程序在选定的计算机或服务器上运行。基本采集功能不 需要 GPU 或大型语言模型 (LLM)。可选的 OCR、转录和 AI 分析功能各有 其资源需求。请根据消息速率、附件、 历史数据保留时长和并发账户数量来确定部署规模。 ## 无论对谁有所帮助,都要保留记录 其目的是保留所观察到的材料、背景及变更,无论 这些内容支持何方立场。证据可能会对收集者自身对事件的 叙述提出质疑。请确保原始观察结果、遗漏内容及分析结论 均可被识别,以便他人能够对同一材料进行评估。 其逻辑流程为:账户可见的观察结果 → 签名日志 → 导出 → 收件人 验证。保存的编辑操作会生成新版本。已删除的观察结果仍保留先前 捕获的内容。覆盖记录会揭示已知的中断情况。报告和 AI 分析会回溯至已保存的来源;一种解释不会仅仅因为出现在签名报告中 就成为来源观察结果。 | 验证检查 | 接收方可确认的内容 | | --- | --- | | 文件哈希值、签名和日志链 | 提供的记录和文件与预期的密钥和日志边界一致 | | 单独保留的检查点或见证 | 该存档与先前保留的日志状态一致 | | 一个经过验证的外部时间戳 | 在所述信任假设下,所引用的字节在时间戳时点上确实存在 | | GitHub 捕获证明 | 该归档文件符合已批准的工作流程、采集器版本及记录的摘要 | | 英特尔 TDX 证明 | 引文、平台状态、预期的操作系统/应用程序测量值、时效性以及收集器的身份均通过了其配置的检查 | 在经认证的获取过程中,经批准的收集器的经过身份验证的 Telegram 连接 及其输出与经过检查的执行环境绑定。归档保留了 捕获的内容和上下文;报告和分析会回溯至这些记录。 请使用 [《信任指南》](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)和[《证据格式》](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/)中针对特定模式的验证步骤和可信输入。 ## 已公布的规模及实测性能 以下结果描述了不同的工作负载和日期。计数不可 互换:日志事件不一定是唯一的 Telegram 消息。 | 日期 | 工作量 | 发布结果 | 测量内容 | | --- | --- | --- | --- | | 1 11月 2026 | 运行中的服务器,十个工作区数据库 | 1,610,818条日志记录;900,232条新消息事件、80,683条编辑事件和400,536条删除事件 | 已存储日志的只读清单 | | 5年11月2026日 | 在200个聊天群组中搜索超过1,000,000条合成消息 | 索引构建耗时 71 秒;每次查询的中位数搜索时间为 9–190 毫秒 | 本地搜索基准测试 | | 6年11月2026日 | 两份最新的真实 Telegram 导出数据 | 27,030和29,299条消息;两次运行共计56,329条 | 每次通过 WARP 运行时处理两个账户,包括文本和元数据,不下载附件 | | 6年11月2026日 | 相同的两个导出操作,包括准备和打包 | 127.713 和 141.781 条消息/秒 | 测得的完整导出率;两个存档均已通过固定密钥验证 | [验证记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/) 提供了服务器清单、实时 采集检查和搜索度量数据。[性能导出](https://phishdestroy.io/tgwitness/docs/validation/) 报告包含两次实际运行、硬件配置、持续时间、归档哈希值以及签名的 度量文件,每项均附有记录的修订版本和运行条件。 [公开历史数据采集验证](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md)还记录了使用 50 个来源的输入列表和 40 个账号工作区得到的**48 个经验证的归档,共包含 3,598,381 条记录**。来源 A 使用八个账号,在包含等待时间的 **1,117.082 秒内获取了 768,007 条历史记录**,速度为**每秒 687.512 条记录**,且未下载附件。包括验证在内的整个尝试用时 1,574.920 秒。这些测量结果描述的是该次工作负载,与上文规模较小的全新导出示例并列展示。 ### 测试历史与持续时间 TgWitness 已经开发和测试了大约六个月。 收集器、签名日志和验证器最先开发完成;随后基于这些组件构建了 Web 控制面板和附加模块。本代码库于 2026 年 10 月 29 日为发布目的新建,并以现有代码为基础,因此其创建时间不代表项目的实际开发时间([开发历史](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history))。 累计运行工作量约为 1 亿次,其中包括早期的运行、失败、修复和重复验证。选定的运行(每次运行都有其独立的修订版本、方法和结果)已记录在[带日期的公开测量](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements)报告中。 ## 准确解读功能状态 针对每个工作流,结合其实现、已发布的构建版本和记录的 测试结果进行评估。源代码当前标记为预览版。该发布标签与 可运行的数据集、导出功能、独立验证以及已发布的规模 测量结果并存。同一 应用程序中可能同时存在预览功能和经过验证的工作流;请描述评估所依据的具体功能及证据。 请综合参考[当前功能](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)、[特性与限制](https://phishdestroy.io/tgwitness/zh/docs/reference/features/)、 [验证](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)信息及[变更日志](https://phishdestroy.io/tgwitness/zh/docs/reference/changelog/)。 引用测试结果时,请记录所测试的版本号。11月6日的测量 快照中还保留了失败和跳过的测试;这些不属于通过项。 ## 既可供人类阅读,也可供人工智能工具解析 该网站提供了一份简明扼要的`llms.txt`文件、一份完整的英文手册( `llms-full.txt`和`llms-full.md`),以及各页面的 Markdown 版本。这些是 文档格式,并非运行 TgWitness 所需的 AI 要求。 可选的 [MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/) [和命令行访问功能](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/)允许授权工具读取 选定的已保存记录。消息内容仍被视为不可信输入。摘要应 注明来源,区分观察到的事实与推论,并保留不确定性。 全文搜索、OCR 和 AI 输出不会更改原始的已签名观察结果。 --- # Telegram · 快速入门 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/ 安装和启动 TgWitness 的所有方法:Windows 安装包、Python、Docker 以及综合演示,并附带初步测试。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 安装和启动 TgWitness 的所有方法:Windows 安装包、Python、Docker 以及综合演示,并附带初步测试。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) **英语** · [俄语](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [乌克兰语](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [西班牙语](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [葡萄牙语(巴西)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [土耳其语](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/QUICKSTART.md) · [阿拉伯语](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/QUICKSTART.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/QUICKSTART.md) · [乌尔都语](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [हिन्दी](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [印尼语](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [越南语](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [简体中文](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md) TgWitness 是一款用于监控您账户可访问的 Telegram 群组和频道的独立应用程序, 它在本地运行并拥有独立的数据目录。 **初次访问?**[请先体验演示](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/#explore-the-interface),然后再连接账户。 [选择代理、见证人、导出或服务器设置的相关指南](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)。 [GitHub Actions 捕获](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)(预览)功能可在您自己的 GitHub 分支中运行捕获任务,而无需本地安装。 ## 安装并启动 引导式安装程序自带 Python 环境,并在安装前会检查包哈希值和发布 签名。再次运行该程序将更新现有安装。 **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" ``` 在 Ubuntu 服务器上,请以 root 身份运行以安装后台服务;在桌面系统上,请 以普通用户身份运行。在 Ubuntu 上,安装程序会显示控制面板地址和访问密钥; 在 macOS 和 Windows 上,本地控制面板会在您的浏览器中自动打开。请继续执行下方的**连接 Telegram** 步骤。[安装、验证和更新部分](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/)涵盖了服务器访问选项、 运行脚本前的检查、更新及卸载操作。 ### 其他方法 GitHub 发布版本、源代码和 Docker 镜像均可作为安装程序的替代方案。便携式 下载包将在发布构建版本发布后提供: | 主机 | 无需安装 | 来源:Python 3.11+ | Docker:Engine/Desktop 搭配 Compose 2.20+ | | --- | --- | --- | --- | | Windows | 从 GitHub Releases 中提取 `TgWitness--windows-amd64-portable.zip`,双击 `TgWitness.cmd` | 双击 `Start.cmd` | 双击 `scripts\Docker.cmd` | | Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` | 对于源码方式,请[下载并解压当前的 `main` 分支](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip), 或克隆仓库: ``` git clone https://github.com/phishdestroy/TgWitness.git cd TgWitness ``` 如果未找到合适的 Python,`Start.cmd` 会提议为您的 Windows 用户安装 Python 3.12(通过 winget 或带签名的 python.org 安装程序)。如果缺少 Python,`start.sh` 会打印 适用于您的 Linux 发行版或 macOS 的确切安装命令。 首次从源码启动会自动创建 `.venv` 并安装依赖项。 Docker 负责构建应用程序并在后台启动它;无需在主机上安装 Python。当 容器运行正常时,`scripts\Docker.cmd` 和 `scripts/docker-start.sh` 会输出控制面板地址和令牌。在所有受支持的主机上,相应的 Docker 命令如下: ``` docker compose up -d --build --wait docker compose exec tgwitness cat /data/panel-token.txt ``` 打开 **http://127.0.0.1:8787**。使用 Docker 辅助程序或第二个 Docker 命令生成的令牌,或者在便携式或源代码安装中读取 **data/live/panel-token.txt 文件**。继续执行下方的 **“连接 Telegram**”步骤。 原生安装和 Docker 安装使用独立的存储空间; 启动 Docker 不会导入现有的原生日志。 对于服务器,[部署](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/)涵盖自动 HTTPS、重启、 发布图片、更新和备份。 ## 探索界面 1. 在便携包中运行 **TgWitness-Demo.cmd** ,在 Windows 源 文件夹中运行 **scripts\Demo.cmd** ,或在 Linux/macOS 上运行 `sh start.sh --demo` 。首次从源代码启动会先创建 `.venv` 并安装依赖项。 2. 访问 **http://127.0.0.1:8787**。 3. 本地演示会自动打开示例日志。无需复制令牌即可直接进行本地访问。 演示消息均为虚构。演示模式无法连接真实的 Telegram 账户。 ## 连接 Telegram > [!警告] **请使用专用账户。**Telegram 可能会因请求 量过大而限制或永久封禁账户,无论请求来自何种客户端。请连接专门用于 观察的账户,而非个人或重要账户,并在 专用账户上创建 API ID / 哈希值。 1. 如果原生演示程序正在运行,请将其停止,并运行 **Start.cmd** 或 `sh start.sh`。 否则,请继续运行上文启动的实时安装程序。 2. 使用面板令牌登录。新工作区将打开[初始设置界面](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。 选择**仅下载**、**关注聊天**或**案件证据**。 3. 请检查连接状态。如有需要,请配置您自己的代理;连接 设置在配置完成后仍可使用。 4. 在 **Connect Telegram** 中,选择一个电话号码、一个二维码、账户文件(TData、 `.session`、StringSession、账户 JSON)或完整的授权密钥。系统提示时,请完成 Telegram 确认、验证码及双重验证密码的输入。 5. 请核对显示的账户,选择聊天群组并检查您的设置。在 最后一个屏幕上点击完成。对于**仅下载**选项**,开始导出**将启动一次性的 导出操作并打开导出页面以显示进度;此操作不会启用持续观察功能。 配置完成后**,聊天→选择**可更改所选聊天。 **设置**控制 数据收集和文件;**更多工具→来源**提供详细来源列表 (标准或专家级别)。[面板指南](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/)描述了六个主要 部分及其上下文控制项。 **API ID + Hash** 为可选项:工作区使用其已保存或导入的配对, 或来自内置池中的有效配对。若要使用您自己的应用,请将一组 `API ID:API Hash`配对粘贴到 API ID 字段中。对于 **Auth key**,请粘贴全部 512 个十六进制 字符,并选择提供的 DC ID。用户 ID 为可选项,若输入则会进行验证。 API 凭据用于识别您的应用程序;它们本身并不能 授权任何账户。私人群组无需公开用户名,但您的账户必须具备访问权限。 对于现有账户,请参阅[账户和会话格式](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/):该 面板支持 Telethon StringSession、Telethon/Pyrogram SQLite、单账户 TData ZIP 以及受支持的账户 JSON 格式。请同时选择一个会话及其对应的 JSON 文件, 点击**检查文件**,然后**点击连接账户**。QR 登录功能也 可用,且具有相同的可选 API 设置。 TDLib、机器人会话以及 CSV/JSON 账户清单均不支持。 对于多个账户,请使用**账户 → 导入账户**并选择其受支持的 会话文件。配套的 JSON 文件按基本名称(basename)配对;每个导入的账户 都会获得各自的工作区。请参阅[批量导入与账户组](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#bulk-import-and-account-groups)。 要添加另一个账户,请点击账户选择器旁边的**+**号,或使用 **账户 → 添加账户**。工作区拥有独立的会话、 日志、密钥、数据源和队列。切换视图时,其他收集器将继续运行。 在此安装环境中,同一个 Telegram 账户不能分配给两个工作区。 工作区的数量没有限制;它们共享一个进程,因此容量取决于机器性能。 实时面板令牌用于保护您对 Telegram 授权及已保存 材料的访问权限;它与 Telegram API 凭据相互独立。只有明确启动的、 直接访问的本地演示版本才会自动获得访问权限。远程/代理演示版本仍使用 `data/demo/panel-token.txt`。 ## 查看与导出 - **日志:**可按来源和事件类型搜索和筛选记录。 - 选择一项事件,查看其原始记录、来源信息及保存的版本。 - 编辑详情显示可用的编辑前/编辑后内容。删除详情显示 最后捕获的内容(如有);未知行为者仍为未知。 - **导出格式:**带签名的 ZIP、JSONL、CSV 以及离线 HTML。 - **完整聊天导出**(**聊天 → 导出聊天**,**或导出 → 捕获或导出一个 聊天**):将一个聊天的全部可见 历史记录下载为包含 `chat.json`(Telegram 导出风格)和可读 `chat.html` 的签名包。私聊功能仅在账户为成员时有效。这是当前的 快照,并非已删除或先前编辑过的消息的重建。使用 `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256` 验证 副本。 - **保存检查点:**将签名日志的边界保持在收集器之外。 - **下载签名运行收据:**保留收集器的程序/版本记录。 - **准备时间戳请求:**向时间戳授权机构发起离线请求; 按照 [TIMESTAMP.md](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/) 中的说明获取并验证响应。 - **验证日志:**检查事件签名和链节。ZIP 导出功能还会检查媒体文件。 支持的浏览器可将大型导出文件直接保存到指定文件中。其他浏览器 最多缓存 128 MiB。在服务器运行期间,流式 CLI 支持 更大规模的下载,而无需缓存整个响应: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` 若需使用其他工作区,请通过**导出 → 工作区 ID**添加`--profile ID`。 若需连接远程服务器,请添加`--url https://your-server`。默认传输限制为 5 GiB;可通过`--max-mib`调整该限制。 签名 ZIP 内容默认具有单独的 4 GiB 未压缩 验证限制(通过**更多工具 → 参数**可提高该限制;使用 `verify.py --max-gib N` 验证此类归档文件)。请使用可信的验证器副本、 独立保留的密钥指纹以及(作为证据的最低要求)时间戳 权威机构的根证书(`--tsa-ca`)来验证归档文件。 ## 查看安装指南 ``` python start.py --setup-only python start.py --check python start.py --check --json ``` `--check`用于检测本地依赖项、签名支持、存储、密钥配置以及 监听地址。该工具不会安装任何内容,也不会连接到Telegram。若端口 已被占用,可能意味着已有另一个实例正在运行。请使用另一个`--port`实例,或先停止当前实例。 启动程序将安装到`.venv`目录下。辅助的`python -m tgwitness...`命令必须 在Windows系统上使用`.venv\Scripts\python.exe`,或在Linux/macOS系统上使用`.venv/bin/python`, 除非该环境已激活。 ## 会话、保护与操作 一个封闭且一致的 Telethon SQLite `.session` 文件可通过以下命令在本地转换: `python -m tgwitness.sessions account.session --out account.tgwitness-session`,随后 可在**更多工具→账户→文件中**加载。还支持直接文件导入和二维码登录。有关登录格式、SOCKS5、 HTTP CONNECT、MTProxy 及外部主密钥的信息,请参阅 [CONNECTION-SECURITY.md。](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/) **暂停观察**将停止数据采集。**锁定**仅关闭浏览器访问权限。 关闭标签页不会终止采集进程。停止该进程才会中断 数据采集;历史快照无法还原所有遗漏的编辑或删除操作。 了解[数据采集在事件策略、附件队列、 账户隔离及重启行为方面的运作原理](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/)。 会话和密钥均经过加密。消息内容、媒体文件和导出数据需要使用 加密磁盘或卷。使用可信密钥验证日志签名,并单独保存检查点。 审查所选采集模式下的 捕获记录、外部时间凭证和环境证明。 请阅读 [OPERATIONS.md](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/) 了解备份/恢复操作,阅读 [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) 了解托管方案,并访问 [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) 查看服务示例。已安装的 控制面板还包含一份离线设置指南,地址为 `/guide.html`。 实际验证情况及现有局限性 记录在 [VERIFICATION.md](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/) 和 [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) 中。 --- # 安装、验证和更新 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/installation/ 只需一条命令即可完成安装、验证签名和哈希值,以及更新和卸载该工具。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 只需一条命令即可完成安装、验证签名和哈希值,以及更新和卸载该工具。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [入门指南](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) ![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [项目](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [快速入门](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) · [部署](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) **本页内容** - [仅需一条命令即可安装](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#install-with-one-command) - [万物运行之处](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#where-everything-runs) - [全文搜索设置](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#full-text-search-settings) - [命令行访问](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#command-line-access) - [运行前请先验证](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#verify-before-running) - [更新现有安装](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#update-an-existing-installation) - [Ubuntu 上的常用命令](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#everyday-commands-on-ubuntu) - [删除 TgWitness](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#remove-tgwitness) ## 只需一条命令即可安装 该项目的官方下载服务 `get.destroy.tools` 提供带向导的 安装程序及其签名的发布文件。该服务包含一个私有 Python 运行时环境, 并在安装前会检查包哈希值和发布签名。每次发布 都会同步更新入口脚本、哈希值、签名和构建信息; 每次构建还拥有一个不可变的发布 URL。 选择引导式安装程序可快速完成设置,或使用 [GitHub 发布版本、源代码或 Docker](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) 。这些是该开源项目支持的 安装路径。对于需要在执行前对 特定构建版本进行审批的部署,请使用[运行前验证功能](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#verify-before-running) ,该功能需配合独立保存的发布密钥指纹和构建版本的不可变 URL。更新下载服务不会自动更新已安装的面板。 **Linux / macOS (Bash):** ``` curl -fsSL https://get.destroy.tools/install.sh | bash ``` 在 Ubuntu 服务器上,请以 root 身份运行以安装后台服务。在桌面电脑上, 请以普通用户身份运行。 **Windows(PowerShell 或命令提示符):** ``` powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex" ``` 在 Windows 系统上无需管理员权限。子 PowerShell 进程会将您的 终端保持打开状态并显示结果。Python 及其依赖项均保留在安装目录中。 在 Ubuntu 上,请选择**“本机”**、**“临时 HTTPS 链接**”或**“自有域名**”。 安装程序会显示控制面板地址和访问密钥。若需临时链接,请在浏览器中打开 该 HTTPS 地址并输入密钥。若需通过远程 服务器进行本地访问,请从您的计算机(`ssh -L 8787:127.0.0.1:8787 user@server`) 并打开 `http://127.0.0.1:8787`。在 macOS 和 Windows 上,本地面板会在您的 浏览器中打开;请保持其终端运行。 在面板中登录 Telegram,并选择要收集的内容。仅安装 并不会自动开始收集 Telegram 数据。 ## 一切运行于此 `get.destroy.tools` 是一个**用于提供静态文件下载服务的 Cloudflare Worker**。它不包含 TgWitness 面板、Telegram 会话或用户证据数据库。它不会被路由到 项目 VPS 上。该应用程序在您执行命令的机器上运行。 | 安装 | 程序 | 数据 | | --- | --- | --- | | 以 root 身份使用 Ubuntu | `/opt/tgwitness` | 系统服务: `/var/lib/tgwitness-`;请使用 `tgwitness paths` 以获取确切路径。 | | Linux / macOS 用户 | `~/.local/share/tgwitness` | `data/live` 在该安装环境下。 | | Windows 用户 | `%LOCALAPPDATA%\TgWitness` | `data\live` 在该安装环境下。 | 设置 `TGWITNESS_INSTALL_DIR` 以选择另一个文件夹。已安装的版本和数据 是分离的。安装程序不会将您的账户、消息或密钥上传至 下载站点。选择 Cloudflare 隧道会将面板流量通过 Cloudflare 传输;使用您自己的域名则会指向您自己的服务器。 当设置 `TGWITNESS_TRUSTED_PROXIES` 时,控制面板接受来自可信代理的单个 `X-Forwarded-Proto: https` 请求,以设置安全下载 Cookie。 每次安装都包含 **START-HERE.html** 和 **START-HERE.txt** 文件,其中包含本地 路径、命令以及代码库的链接。运行 `tgwitness guide` 以打开指南。 在 Windows 上,请使用 `& "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide` 在 PowerShell 中运行。 ## 全文搜索设置 [全文搜索](https://phishdestroy.io/tgwitness/zh/docs/reference/search/)(预览版)无需任何配置。其索引会在更新后在 后台自动构建。 | 变量或命令 | 效果 | | --- | --- | | `TGWITNESS_FULLTEXT=disk` | 默认:索引保存在 `search/fulltext.sqlite3` 每个工作区的 | | `TGWITNESS_FULLTEXT=memory` | 无索引文件;每次启动时都会重建索引 | | `TGWITNESS_FULLTEXT=off` | 不建立索引;仅支持精确文本搜索 | | `tgwitness index status` | 索引每个工作区的状态 | | `tgwitness stop`, `tgwitness index rebuild`, `tgwitness start` | 从签名日志中重建所有索引 | 管理员在**“日志”→“过滤器”→“搜索索引**”中的选择将覆盖 该工作区的变量。命令会查找运行它们的安装 的数据目录;在其他地方,请添加 `--data-dir` 并使用来自 `tgwitness paths`。 如需完整的乌克兰语词典(GPL-3.0 数据),请在 `pymorphy3-dicts-uk` 在 该安装的 Python 环境中。 ## 命令行访问 该[命令行](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/)(预览版)用于读取存档文件中的脚本和代理程序。 | 变量 | 效果 | | --- | --- | | `TGWITNESS_URL` | 面板地址为 `tgwitness search`, `context`, `messages`, `stats` 和 `export`;默认 `http://127.0.0.1:8787` 当设置令牌时 | | `TGWITNESS_MCP_TOKEN` | 从**更多工具→集成→MCP**获取存档连接令牌,该令牌与 MCP 客户端共享;`--token-file` 则从文件中读取该令牌 | | `TGWITNESS_DATA` | 当未提供 `--data-dir`、URL 或令牌时,将直接读取数据目录 | ## 运行前请先验证 安装程序会嵌入项目的发布公钥,并在安装应用程序包和依赖项锁定文件之前,检查其 SHA-256 和 RSA 签名。 当必备检查失败时,Bash 和 PowerShell 都会停止执行。初始脚本通过 HTTPS 传输,并带有独立的脱离式签名;下方的命令还 允许您在执行该脚本之前对其进行验证。 公钥为 [release-signing.pub](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/release-signing.pub)。 其 SHA-256 为: ``` 039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d ``` 请保留来自您信任的代码库版本的此指纹。来自 同一下载服务器的校验和可检测到不匹配;独立受信任的公钥 则是验证发布签名所依据的。 请为下文中的验证下载内容准备一个新的、空的目录。 **Linux / macOS — 在一个新的、空的下载目录中运行**(需要 curl 和 OpenSSL): ``` curl -fSLO https://get.destroy.tools/install.sh && curl -fSLO https://get.destroy.tools/install.sh.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh && bash install.sh ``` 如果 `&&` 如果下载、密钥指纹或签名 验证失败,链条将在执行前停止。如果脚本下载与签名验证之间 发生了发布更新,则需重新下载两者。旧版安装程序会保留其不可变的包 URL。 **Windows — 运行前请检查SHA-256:** ``` Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing Get-FileHash .\install.ps1 -Algorithm SHA256 Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt ``` 将哈希值与 `install.ps1` 行进行比较。若要进行独立的签名验证, 请使用 OpenSSL(例如在 Git Bash 中)并采用上述相同的公钥指纹: ``` curl -fSLO https://get.destroy.tools/install.ps1 && curl -fSLO https://get.destroy.tools/install.ps1.sig && curl -fSLO https://get.destroy.tools/release-signing.pub && test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \ '039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' && openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 && powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1 ``` Windows 安装程序会通过 .NET 自行验证软件包签名,无需 OpenSSL。这些是独立的 RSA-3072 / SHA-256 签名,而非 Authenticode 签名。 [清单](https://get.destroy.tools/manifest.json)文件记录了软件版本、 精确的 Git 提交、不可变的发布 ID 以及每个构建产物的 SHA-256。该页面提供了 指向相应源代码的链接。清单文件和校验和列表也带有独立的 签名(`manifest.json.sig` 和 `SHA256SUMS.txt.sig`). ## 更新现有安装 **新版本发布后,下载站点会相应更新;当您 再次运行安装程序时,已安装的程序将自动更新。**该工具不提供无人值守更新程序,也不会自动重启 正在运行的集合。当前安装程序通道处于**预览阶段**;它遵循 来自 `main`发布的、经过验证的构建版本,其提交时间可能晚于 GitHub 上最近的编号版本。该页面的版本号来源于 `pyproject.toml`;其提交 和构建 ID 可区分同一预览版本内的更新。 当该特定提交通过应用程序和 安全检查,且签名包在 Ubuntu 和 Windows 系统上完成身份验证、安装和验证后,系统将自动发布。修改安装程序的拉取请求也会针对站点的本地副本分别运行两次 `install.sh` 和 `install.ps1`。在检查运行期间, 或检查失败时,这些命令将继续安装之前已通过验证的构建版本。 构建清单显示当前可用的提交;在预览版更新之间, 版本号本身可能保持不变。 请使用与之前相同的安装文件夹和操作系统用户。在停止数据收集后,备份完整的数据 目录; `tgwitness paths` 用于标识该数据。已签名的导出文件 并非完整的安装备份。 **Ubuntu 根目录安装位于 `/opt/tgwitness`:** ``` curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start ``` 安装成功后: ``` /opt/tgwitness/bin/tgwitness restart /opt/tgwitness/bin/tgwitness status /opt/tgwitness/bin/tgwitness open ``` 对于 Linux/macOS 用户,请使用其原始 `TGWITNESS_INSTALL_DIR` 或 默认配置,并再次运行第一个安装命令。更新前请关闭前台 面板,更新后重新启动该面板。对于已配置的 Linux 用户 服务,请运行其 `tgwitness restart` 命令。 **Windows:**关闭正在运行的面板,重新运行 Windows 安装命令, 然后在 `bin\tgwitness.cmd` 同一安装环境。安装程序会保留数据、 会话、访问设置和签名密钥。只有当 新环境通过检查后,它才会切换启动器;安装失败时, 原启动器将保留不变。请保留升级前的备份,以应对存储格式的变更。 ## Ubuntu 上的常用命令 | 命令 | 结果 | | --- | --- | | `tgwitness open` | 当前面板 URL 和访问密钥。 | | `tgwitness paths` | 精确的程序、数据和指南路径。 | | `tgwitness guide --print` | 离线操作指南。 | | `tgwitness status` / `tgwitness logs` | 可用性/服务日志。 | | `tgwitness stop` / `tgwitness start` | 停止/恢复服务;保留数据。 | | `tgwitness token rotate` | 替换管理员密钥并结束浏览器会话。 | | `tgwitness tunnel off` | 禁用公共快速隧道;保留本地面板。 | | `tgwitness tunnel on` / `tgwitness tunnel restart` | 创建快速隧道链接 / 替换其地址。 | 请参阅[“访问权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/) ”了解同事令牌、会话和 IP 限制,以及 [“安装程序发布](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) ”了解从 GitHub 到 Cloudflare 的发布工作流。 ## 删除 TgWitness 本工具不提供卸载程序:只需停止面板并删除其文件夹即可。删除 data 文件夹将永久销毁日志、签名密钥、Telegram 会话以及已保存的文件。 在此之前: 1. 导出所需内容(**导出 → 下载已签名的 ZIP**),并将签名密钥 的指纹和检查点保存在本机之外。若要保留工作区本身,请在停止数据收集后复制 整个数据文件夹。 2. 请从**您的服务器**中删除在**更多工具→扩展功能→“24/7 服务器**”下创建的服务器,或使用 `python -m tgwitness.cloud destroy` 命令删除;服务商将持续对这些服务器进行计费,直至其被删除。 3. 请在 Telegram 的**“设置”→“设备**”中结束每个账户的会话。删除 文件并不会在 Telegram 端注销该会话。 **Ubuntu 根目录安装。**请注意数据文件夹,停止服务,然后删除 该服务、相关文件夹及快捷方式: ``` /opt/tgwitness/bin/tgwitness paths /opt/tgwitness/bin/tgwitness stop systemctl list-unit-files 'tgwitness-*' systemctl disable tgwitness- rm /etc/systemd/system/tgwitness-.service systemctl daemon-reload rm -rf /opt/tgwitness /var/lib/tgwitness- /usr/local/bin/tgwitness ``` **Linux 或 macOS 用户安装。**关闭面板。已配置的 Linux 用户服务 可通过 `systemctl --user disable --now tgwitness-`;其单位为 `~/.config/systemd/user/`。随后删除 `~/.local/share/tgwitness` (或您的 `TGWITNESS_INSTALL_DIR`) 以及 `~/.local/bin/tgwitness` 快捷方式。 **Windows。**关闭面板并删除 `%LOCALAPPDATA%\TgWitness` (或您的 `TGWITNESS_INSTALL_DIR`)。安装程序不会添加任何服务、计划任务或快捷方式。 --- # Telegram · 初始设置与配置 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/settings/ 设置向导、目标、界面层级、连接路径以及账户组共享的设置。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 设置向导、目标、界面层级、连接路径以及账户组共享的设置。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [入门指南](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) ![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [账户](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/) · [连接](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/) · [访问](https://phishdestroy.io/tgwitness/zh/docs/reference/access/) 将打开一个新的工作区 `/first-run`。第一个屏幕会询问您想做什么:**“仅下载**”、**“关注聊天**”或**“案件取证**”。选择将确定目标和界面级别:“仅下载”为“简易”模式,其余两项为“标准”模式。级别决定了每个表单显示的字段数量;所有页面均保留在菜单中。 同一屏幕上的**更多选项**可明确设置级别、主题和时区;语言列表位于向导标题栏中。后续屏幕涵盖连接、Telegram 和聊天内容。在自动检查运行期间,连接路径保持折叠状态,检查失败时则展开。 五阶段进度条会返回已完成的阶段。每个选项一经更改即刻保存至服务器,因此刷新页面后将从同一步骤继续。最后一个屏幕列出了所有选项,并允许您返回其中的任意一个。 语言、IANA 时区、主题和级别均按操作员和工作区分别存储。 默认设置为浏览器语言、设备时区、系统主题以及 “简约”界面。更改语言后,面板会话设置将保持不变。已签名 日志中的时间永远不会改变。 `/settings` 编辑的记录与向导相同。搜索涵盖主要字段、参数和扩展表单;无需更改级别即可打开隐藏字段。级别只改变显示内容:权限由服务器自行检查。如果某个分区的设置全部高于所选级别,它仍会显示这些设置。采集设置和首次连接由工作区管理员负责。 设置页面是一个列表。顶部的账户卡片打开**Telegram 账号**。下面每一行列出一个分区及其当前值:**账户**下有**哪些聊天?**和**连接**;**记录**下有**目标**、**记录和文件**、**记录保护**和**通知和异地副本**;**面板**下有**语言、时间和外观**;专家页面在**更多工具**下。列表旁的卡片显示推荐值是否已启用,并给出主要值和**撤销上一次更改**,**最近的更改**列出最近的编辑。 该部分会在列表上方的新窗口中打开,并拥有独立的地址,例如 `/settings/connection`。点击后退箭头、关闭按钮、按 Esc 键、点击窗口外部 或点击浏览器的“后退”按钮均可返回列表。**选择哪些聊天?**后,系统会通过 **保存聊天选择**功能保留该设置;若关闭窗口时有未保存的更改,系统会先进行确认。 保存操作会保留**更多工具 → 来源 → 范围**中的来源 类型、被排除的聊天、自定义操作以及新建聊天设置;在此处选中的聊天将从被排除的聊天中移除,并被记录为手动选择的 来源。 每次更改后 **,撤销选项**会在 20 秒内显示,且**最近更改**中的每项记录都可在稍后撤销。 撤销操作仅恢复该条目所更改的设置,包括自定义文件限制。 当后续更改涉及相同的设置时,系统将拒绝撤销请求,且不会 发生任何变化。每次撤销操作都会在日志中生成一条新的`settings.changed`记录。 | 级别 | 字段 | 侧边栏 | | --- | --- | --- | | 简单 | 仅保留必需功能 | 首页、聊天、日志、导出、账户和设置 | | 标准 | 常用设置及说明 | 在更多工具下新增案例板、来源、访问和文档 | | 专家 | 所有字段、限制及技术细节 | 此外,在更多工具下新增了系统地图、网络拓扑、扩展功能、查询存档、参数、账户、系统日志和集成等选项。 | 各层级的章节名称保持一致。在 侧边栏底部打开外观以更改层级。[面板指南](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/)对每个章节进行了说明。 ## 目标 | 目标 | 收藏集 | 文件 | 外部服务 | 服务器地址 | | --- | --- | --- | --- | --- | | 仅下载 | 一次性导出从最终设置界面开始;持续收集功能保持关闭状态 | 照片大小上限为 20 MB | 时间戳 | 自动 | | 关注聊天室 | 持续 | 照片和视频最长 60 秒 / 20 MB | 时间戳和问题通知 | 自动 | | 案件的证据 | 持续 | 所有文件大小均不超过 1 GB | 时间戳、drand、通知 | 不,隐藏它 | 建议使用异地备份、Witness 机器人和代码检查作为证据。 存储和通知地址需要先指定目标。与外部服务交互的功能 会要求允许向 Telegram 外部发送请求;若关闭该功能, 系统将同时建议关闭时间戳、通知以及异地备份功能。 修改目标会首先显示差异,且手动修改内容可以保留。与目标 不一致的字段会标记为**“由您修改**”,并可恢复。 设置修订功能可防止已审核的差异覆盖在另一个标签页中 所做的修改。 ## 连接 在此处选择路径之前,新工作区将使用 **自动 MTProxy · 公开列表** 与 **隐藏地址** ([连接安全性](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/)). 该 **自动** 以下选项是一个单独的设置步骤。 **Automatic** 会先尝试使用 WARP,然后是公共 MTProxy 服务器,最后是直接连接, 仅当服务器地址可能被显示时才会采用直接连接。Automatic 和 WARP 可以安装 经过哈希校验的组件,并将服务器注册到 Cloudflare;若未获得该同意, Automatic 将跳过 WARP。WARP 使用现有的 wgcf/wireproxy 管理器和本地 SOCKS5 端口;系统路由表不会被更改。 **批量导入**会在任何会话到达 Telegram 之前询问路由:WARP(默认)、 公共 MTProxy 或直接连接。会话检查使用相同类型的路由,且每个 导入的账户在首次登录前都会获得专属的 WARP 隧道。 您自己的代理服务器支持 `tg://proxy`, `socks5://`, `http://` 和 `https://`。在向 HTTPS 代理发送凭据之前,会先验证其证书。 连接检查结果有效期为五分钟,并与路由、策略以及 向导回答绑定;若其中任何一项发生变更,则需重新进行检查。系统支持**“不检查就继续”** 选项,但该选项不能替代 Telegram 登录验证。所选路由 将在后台重新检查,且在连接中断后,“自动”模式会再次运行其链。当公共代理无响应时,计数器将变为红色,并触发 WARP 和重新检查 操作。 ## 账户组 同一组中的账户会共享设置。请打开**“账户”→“组和共享 设置”→“共享设置**”,或在账户的“设置”页面中**选择“组设置**”。 该组共享目标、已保存文件、时间戳、drand、问题通知、 站外副本、Telegram 外部请求、IP 模式、记录内容、复核 时间表、通知规则、报告设置、参数以及连接路径。 通知目的地、代理凭据和登录信息均按账户单独保存, 数据采集的启动和暂停操作也是如此。 - 每位成员都会关注该群组。在“设置”中,标记一个值 🔗 **来自该组** 或 ✏️ **自有值**;**恢复为组设置值** 可将其还原。 - 每次更改都会列出受影响的账户(**适用于 3 个账户中的 2 个**),并在替换原始值之前逐个 询问每个账户。未勾选的账户将保留其原始值。 - 团队未共享的参数将保持为 **不共享:每个账户保留其独立的数据**,直到您点击 **分享此值** 为止。 - **从一个账户复制设置时,**会将所选账户的值作为该组的设置。 - 当账户被移入组时,系统会询问**“采用该组的设置吗?”,**否则该账户将保留 其原有设置,并标注为 ✏️。后续添加的账户将默认采用该组的设置。 - 观察账户将保持其 IP 模式,直到被暂停为止。 每次更改都会记录在主工作区以及所有 相关成员的已签名日志中。删除一个组时,该组中的账户及其当前值将得以保留。 群组页面 `/groups/` 会显示成员列表、待处理事项以及 多个账户共同关注的聊天记录。参见[“账户组”](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#bulk-import-and-account-groups)。 ## 现有工作区 包含会话或先前已完成设置的工作区不会显示向导。 页面加载时,其值不会被目标替换。隐藏字段不会 禁用该功能,也不会删除其值。在“设置”中**打开首次设置**会再次显示 相同的界面;完成这些设置不会启动新的导出或观察,并会明确提示这一点, 且更改后的聊天选项仅在**点击保存聊天选项**后才会生效。 大小和时间估算基于最多三个选定的聊天,以及每个聊天中最多 20 条消息。 这仅为估算值:它无法预测 Telegram 的限制、特定 服务器的速度,也无法预测每个聊天中的文件内容。 --- # Telegram · 账户与会话格式 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/ 支持通过手机、二维码或授权密钥登录,可导入 Telethon、Pyrogram 或 Telegram Desktop 的会话数据,并同时管理多个账户。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 支持通过手机、二维码或授权密钥登录,可导入 Telethon、Pyrogram 或 Telegram Desktop 的会话数据,并同时管理多个账户。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [入门指南](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) ![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) TgWitness 通过 MTProto 协议以 **Telegram 用户账户**(而非机器人)身份登录,使用 Telethon 实现。每个账户都位于独立的工作区中(在 API 和命令行工具中称为“*工作区*”),并拥有独立的会话、消息源、日志和签名密钥。 会话文件、会话字符串和认证密钥均属于**账户授权凭证**:任何 持有者均可代表该账户进行操作。这些凭证不包含消息历史记录。 > [!警告] **请使用专用账户。**Telegram 会限制并可能永久封禁其认为请求量过大的账户, 无论客户端或用途如何,且仅部分公开了 这些限制。请连接专门用于观察的账户,而非 个人账户或其他重要账户,并在专用 账户上创建 API ID / API 哈希。 - [一览](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#at-a-glance) - [开始之前:API ID 和 API 哈希值](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#before-you-start-api-id-and-api-hash) - [电话号码](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#phone-number) · [二维码](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#qr-code) · [认证密钥 + DC ID](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#auth-key--dc-id) - [账户文件](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#pyrogram-session) · [会话 + JSON 对](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#telethon-stringsession) · [授权密钥和 DC 合为一行](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#auth-key-and-dc-in-one-line) · [账户 JSON](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#account-json) - [识别您拥有的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#identify-what-you-have) · [不受支持的格式](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#unsupported-formats) - [多个账户](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#multiple-accounts) · [确保账户文件的安全](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#keeping-account-files-safe) · [故障排除](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#troubleshooting) ## 一览 | 您拥有 | **“添加账户**”选项卡 | 您还需要 | | --- | --- | --- | | 电话号码及其登录码的获取方式 | **电话** | 若已启用双因素认证(2FA),请输入密码 | | Telegram 在另一台设备上已打开 | **二维码** | 若已启用双因素认证(2FA),请输入密码 | | `.session`文件(Telethon 或 Pyrogram) | **文件** | 可选的配套 JSON 文件,用于应用程序设置 | | `.session` + `.json`(同名) | **文件**(请同时选中) | 通常没有其他内容 | | Telegram Desktop 中的 `tdata` 文件夹 | **文件**(ZIP 压缩包) | 若已设置,则为桌面端本地密码 | | Telethon StringSession(文本、`.txt`、`.tgwitness-session`) | **文件** | 无需单独的 API 对 | | 认证密钥和 DC 合并为一行,格式为 `<512 hex>:<1–5>` | **文件**(粘贴内容或文本文件) | 无需单独的 API 对 | | 包含会话或认证密钥的 `.json` | **文件** | 无需单独的 API 对 | | 一个授权密钥(512个十六进制字符)及其DC编号 | **认证密钥** | 可选用户 ID | TgWitness 根据文件**内容**而非文件名来识别文件。重命名文件 绝不会导致其被转换。 ## 开始之前:API ID 和 API 哈希值 您无需创建 Telegram API 应用程序即可登录。当未输入、 未导入或工作区中尚未保存任何密钥对时,TgWitness 会从其内置的 50 对公共 API 密钥对池中随机选取一对(`tgwitness/api_pool.py`),在首次登录时优先选用 Telegram Desktop 的密钥对, 并优先保留已保存的密钥对;其余候选密钥对将随机排序。若 Telegram 拒绝某组密钥对 (`API_ID_INVALID`, `API_ID_PUBLISHED_FLOOD`, `UPDATE_APP_TO_LOGIN`),则尝试下一组, 每次登录最多尝试八组;被拒绝的密钥对将被跳过,直至重启。用于登录的密钥对将 与该账户一同保存,并供该账户重复使用。 内置的配对是公开的:它们发布在 Telegram 客户端和库的开源代码中。**API ID** 和 **API**哈希用于向 Telegram 标识应用程序, 但不会授予访问账户数据的权限。登录使用账户自身的授权方式:登录 码和双因素认证密码,或者该账户已授权的会话。每个 `observation.started` 记录中都会注明所使用的密钥对,因此内置密钥对在 法庭上的记录方式与您自己的密钥对相同。您也可以通过 my.telegram.org 输入您自己的密钥对。 根据本项目的经验,使用新的个人密钥对会导致大多数账户被注销,因此请仅在 案件需要您使用自己的应用程序时才使用:请使用专用账户创建该密钥对,并在 数据采集开始前输入(具体步骤如下)。 缺失的连接字段使用捆绑的 [opentele2 2.0.0 目录中的](https://github.com/DedInc/opentele2/tree/7e973bc71cd7a714ad13ac703c0895a90d36a735)确定性设备/操作系统组合: 桌面版 `2040`、Android `6`、Android X `21724`、iOS `10840`、macOS `2834` 以及 Web `2496`。 Android 的源代码构建 ID `4` 同样使用 Android 目录,该 ID 在 [Telegram Android 的 BuildVars](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/messenger/BuildVars.java) 中有明确标识。 Web 默认使用 A;若导入 `K` 应用版本后缀或 `macos` 语言包,则选择 K,而版本 `0.7.0` 则选择 Webogram。未知应用 ID 保持 Telethon 的主机 默认值。导入的字段始终优先,包括较旧的应用版本和空的 语言包。目录绝不会更改 API ID/哈希值。其版本快照会 经过明确审核,而非在登录时获取。保存的配置文件在更新后保持稳定。 `account.getAuthorizations` 报告 Telegram 保存的授权元数据;它 并非每次新调用 `initConnection` 的回显。请将其与实际发送的配置文件进行对比。 连接现有授权不会验证其对应的 API 哈希: `initConnection` 发送的是 API ID,而哈希则用于登录请求。 在新手机或二维码授权后,TgWitness会请求配置、最近的数据中心、 在线状态、语言(当语言包不为空时)、应用更新以及 服务条款更新,各请求间隔为0.3–1.5秒。 更新状态 会短暂地将账户标记为在线。该序列仅在登录完成时运行一次, 不会在数据导入、重新连接或重启时执行。授权信息会首先保存;若请求失败, 该序列将终止,既不重试也不丢弃登录信息。结果将 记录为`account.initialized`,其中包含错误名称而非响应正文。 Telegram自身的政策决定账户限制。 对于 `tdesktop` ,若未指定 `tz_offset` ,则使用服务器的本地 UTC 偏移量,并使用 [opentele2 算法](https://github.com/DedInc/opentele2/blob/7e973bc71cd7a714ad13ac703c0895a90d36a735/crates/opentele2-core/src/fingerprint.rs) 将其四舍五入至 900 秒 (MIT 许可;许可协议详见 `tgwitness/client_profiles.LICENSE` )。该值在每次 连接时都会刷新,以反映夏令时变更。在所有平台上,导入的 `tz_offset` 均具有优先级,并将被精确保留,包括零值。其他 `initConnection.params` 条目将予以保留。 HTTP 登录表单接受文件导入返回的数值时区; 布尔值、分数以及超出支持范围的偏移量将被拒绝。 直接、SOCKS5 和 HTTP CONNECT 路由使用 Telethon 的 `ConnectionTcpObfuscated` (经过混淆的简化版 MTProto)。HTTPS CONNECT 保持与代理之间的 TLS 连接,并在隧道内部使用 相同的混淆传输协议。MTProxy 保留其必需的 随机化中间传输和密钥处理机制。路由切换采用 相同的选择。 混淆处理会改变数据包的帧结构;它不会向 Telegram 隐藏账户 或其客户端元数据,也不意味着能够规避相关限制。 在连接授权客户端后,TgWitness 会检查配置、最近的数据中心、 当前授权状态、已审核的层级基线、语言、应用更新 以及服务条款更新。 这些诊断操作针对每个客户端实例仅执行一次, 且在数据收集之前进行,结果将连同执行时间一并显示在连接详情中。 `account.connection_checked` 会记录结果,但不包含会话哈希、IP 地址、 令牌或 API 哈希。这些操作绝不会接受条款或安装更新。若请求 失败或触发 FloodWait,后续请求将停止;若缺少结果,则该结果将保持未知状态。 本地检查仍可报告结果,而网络检查则会被跳过。 当启用[严格选择聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#strict-chosen-chats)功能时,系统不会请求当前 授权信息,该检查将显示为已跳过。 登录后以及每次建立新连接时,TgWitness 会读取该账户的敏感 内容设置。 当该设置处于关闭状态且 Telegram 允许更改时,TgWitness 会将其开启, 以便保存 Telegram 标记为敏感(18+)的内容,并记录 `account.content_settings`。该设置属于该账户,并在所有 Telegram 应用中生效。若启用了“严格选择聊天”功能,则该设置保持不变;请在登录前开启该功能。 对同一工作区连接的并行恢复请求将共享其客户端,并 等待该连接的建立完成。如果某次尝试失败或被取消,系统将释放 该资源,以便下一个请求重试。如果在连接建立过程中,已保存的凭据、客户端或授权状态 发生变化,则较早的尝试将停止,而非报告连接已就绪。 FloodWait 诊断信息会保留失败的 TL 方法、任何 Takeout/range 包装器、 服务器请求的等待时间以及 `telegram.backoff` 中的有效截止时间。 在请求暂停期间,连接详细信息会显示方法和截止时间。 该诊断信息包含自该客户端创建以来 按方法统计的客户端调用计数器;这些计数器会单独统计嵌套的对等方解析,但不计入数据包 或 Telethon 的内部重试尝试。当前计数器也可通过状态 API 中的 `collector.rpc_activity` 获取。 不包含任何请求参数、用户名、访问 哈希值或异常文本。最后一条诊断信息和完整的截止时间 在重启后仍会保留。早期没有方法记录的等待无法 追溯归因。请参阅源代码审查的[导出限制](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-LIMITS.md)以及 发现与历史数据获取之间的区别。 `official_app=True`或`False`是 Telegram 的当前授权标志。这两个 值均无法确定该账户是受限、受信任还是处于观察状态。 现有的证据模式 `account.devices` 快照仍保留所有 已登录设备的历史记录;连接诊断仅保留当前设备的描述。 连接前,建议性检查会将 API 平台、语言包、 设备/操作系统和应用版本格式、移动系统区域设置,以及 Telethon 的实际 模式层与已审核的目录基线进行比对。警告会显示在服务器 日志和账户状态元数据中;它们绝不会替换导入的值或更改 模式层。模式层不一致是需要审查兼容性的信号;账户的 自身连接状态会显示是否正常工作。 无论使用何种客户端配置文件,Telegram 都会在其 端决定限制条件。断开连接的账户状态 将使用已保存的配置文件,而非生成另一份设备描述。 若要改用您自己的应用程序: 1. 打开 [my.telegram.org](https://my.telegram.org),并使用您拥有的任意手机号码 登录。验证码将发送到 Telegram 应用中,而非通过短信。 2. 选择 **API 开发工具**。 3. 创建应用程序:任意标题和简称(5–32 个字母),平台为**桌面版**。 URL 和描述可留空。 4. 复制 **App api_id**(一个数字)和 **App api_hash**(32 个十六进制字符)。 在登录表单下方的面板中,有“**API ID + 哈希**”字段。您可以在 **API ID** 字段中粘贴一组 `api_id:api_hash`,两个字段将自动填充。一组 即可用于您所有的账户。成功登录后,该信息将以加密形式保存在 该工作区中,且绝不会发回浏览器。 涉及三种不同的凭证: | 秘密 | 打开 | 托管位置 | | --- | --- | --- | | 面板令牌 | TgWitness 网页控制面板 | 数据目录中的 `panel-token.txt`,或 `TGWITNESS_TOKEN` | | API ID + 哈希值 | 本身不包含任何内容;仅用于标识该应用程序 | 可通过 my.telegram.org 进行内置配对、导入设置或使用您自己的应用程序 | | 账户授权 | Telegram 账号 | 可通过手机/二维码登录创建,或作为会话导入 | 如果必须通过代理访问 Telegram,请先在 **更多工具→账户→设置→连接设置→更改连接路径**中进行设置。 ## 电话号码 1. 打开**更多工具→账户**,切换至**电话**选项卡,并以国际格式输入号码, 例如`+44 7700 900123`。空格和连字符将自动去除。 2. 点击**“继续”**。API ID 和哈希值可留空。 3. 输入 Telegram 发送的代码,通常发送至 Telegram 应用;由 Telegram 决定是否发送短信。 4. 如果该账户启用了双重验证,请输入该密码。这并非控制面板 令牌,也不是设备密码。 5. 登录后查看显示的账户 ID,然后选择消息来源。 登录凭据和双因素认证(2FA)密码绝不会写入磁盘。 ## 二维码 当该账户已在手机或另一台计算机上登录时,请使用此功能。 1. 点击**“QR 码**”→ **显示 QR 码**。API ID 和哈希值可留空。 2. 在已登录的设备上:**设置 → 设备 → 关联桌面设备**,扫描二维码 并确认。 3. 若 Telegram 要求输入双因素认证(2FA)密码,请在 TgWitness 中输入该密码。 该二维码是在本地生成的。二维码会过期;请点击**“生成另一个二维码** ”重新尝试。锁定面板、切换工作区或开始另一轮登录操作将取消 待处理的二维码。 ## 认证密钥 + DC ID 授权密钥(Auth Key)是每个 Telegram 会话背后的 256 字节原始授权数据,以 **512 个十六进制字符**的形式表示,并附带数据中心编号 **DC 1–5**。 1. **“Auth key**”选项卡。请粘贴完整的密钥;包含“`…`”的缩短版密钥无法使用。 2. 请选择随密钥提供的 DC ID。 3. 可选输入**用户 ID**。若 Telegram 报告的 账户信息不一致,TgWitness 将拒绝连接。 4. Press **Connect 账号**。 授权密钥(512 个字符)并非 API 哈希(32 个字符)。同一密钥也可 以 JSON 格式导入,详见[“账户 JSON](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#account-json)”。 ## 账户文件 打开**添加账户→文件**,选择最多**四个属于同一账户的文件**(总计 **8 MiB**),点击**检查文件**,然后点击**连接账户**。选择文件或 粘贴会话文本不会发送任何内容;**点击检查文件**会将文件发送至您的TgWitness服务器, 该服务器无需登录即可读取这些文件,并显示其找到的会话。 **文件**、**授权密钥**和批量导入表单会在连接前显示并行会话警告。 默认情况下,导入的授权将被重复使用。当其密钥在此处使用时,请保持原始 客户端处于关闭状态。**文件**和**授权密钥**还提供 **创建独立授权选项**,具体说明见下文。批量导入仍使用 直接模式。手机和交互式二维码登录会创建独立的授权。 导入表单中会持续显示该警告标题;当提供文件或密钥/会话字符串时,其完整说明会 自动展开。阅读后可将其折叠, 以便在手机上继续使用文件选择器和连接控件。 [已验证的部署](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/)(Phala Cloud、Intel TDX)不会对 导入的密钥进行收集。在此情况下,**文件**和**认证密钥**仅在选中**创建独立 授权**时才能连接;批量导入将被拒绝。手机和二维码登录照常工作。 - 文件在您的 TgWitness 服务器**内存中**进行转换。上传内容不会被存储, ZIP 文件不会解压到磁盘,也不会连接任何外部服务。 - 生成的会话记录随后将与 Telegram 进行核对。如果文件中包含用户 ID, 则该 ID 必须与 Telegram 报告的账户信息一致。 - 描述不同账户或不同 API 凭据的文件将被拒绝 而非仅选择其中一个。 - **密码或会话文本**字段用于存储 TData 本地密码字段,该框用于粘贴 StringSession 以及**无需登录即可读取文件**(在无需 联系 Telegram 的情况下填写表单)。 粘贴 StringSession 会清空已选文件,而选择 文件会清空已粘贴的文本,因此验证和连接操作均采用最新选择。 更改密码后,请再次点击**检查文件**。 ### 创建独立授权 请选择“在连接前**创建独立授权**”并导入文件,或 选择授权密钥。TgWitness会短暂连接导入的捐赠者设备,利用其批准 新客户端的二维码登录令牌,并在批准后立即断开与捐赠者的连接。 新客户端拥有独立的授权密钥和单独选择的桌面 配置文件。由捐赠者提供的 API 凭据和设备配置文件仅用于 与捐赠者的连接。现有授权不会被注销或撤销。 **在此步骤中,请保持捐赠者的原始客户端完全关闭。**初始 连接仍使用其复制的密钥,因此此模式无法消除该初始 并行使用风险。一旦建立新的授权连接,所有者即可重新打开 原始客户端,并同时使用这两个客户端。 交互式**二维码**登录允许 原始客户端在此处无需复制或连接其密钥即可批准登录。 **请勿注销或结束捐赠者的会话。**当批准 QR 登录的会话结束时,Telegram 也会终止其所批准的会话;在实际测试中,新 授权会在捐赠者注销后一秒内停止。导入操作会记录 捐赠者的会话信息(`session_origin.approved_by`:设备、API ID 和创建时间)。 会话列表会将其标记为已结束**,结束会话**会拒绝该会话,而**结束所有其他会话** 和**将此设为唯一会话**则会让捐赠者保持登录状态。 如果 Telegram 要求进行双因素认证,此模式会 `twoFA` 选定 JSON 文件中的内容(若存在), 否则将要求输入密码。若导入的密码被拒绝,系统将返回密码输入表单。 密码不会被保存。候选密钥将以加密形式保存在 `independent_login.enc`,包括数据中心迁移期间的变更。发生 中断后,请选择相同的捐赠者并选中此选项以恢复已保存的候选密钥。 在批准前会通过 `help.getAppConfig` 进行验证;若源账户处于冻结状态, 则在此处终止。若 Telegram 在批准登录前拒绝了源账户,未获批准的 候选密钥将被丢弃,并可重新开始导入。只有当 Telegram 报告该候选账户未登录时, 另一个源账户才会替换已保存的候选账户;已登录或正在等待双因素认证密码的 候选账户将予以保留。 该工作区仍为该账户保留;导入失败不会删除 新工作区。请保留其数据目录和保险库密钥。最终的凭据和 `account.authorized` 日志记录中包含导入方法、输入格式和 捐赠者 API ID,但不包含捐赠者密钥或密码。 2026年11月5日,一个专用账户通过了Telethon、Pyrogram 和TData捐赠者的实时验证:2FA验证完成、生成独特的新授权密钥、捐赠者与新客户端的并发访问 ,以及公共频道的阅读操作。 在 Telethon 案例中, 系统还在密码输入步骤中断后恢复了已保存的候选会话。每次新的 授权都完成了登录后的六个初始化请求,且其签名的 日志已通过验证。原始会话在提供的四种格式中均保持可用。 Telegram 的 [RPC 错误数据库](https://core.telegram.org/api/errors.json)将 `FRESH_CHANGE_ADMINS_FORBIDDEN` 与更改管理员相关联,`FRESH_CHANGE_PHONE_FORBIDDEN` 与更改电话号码相关联,而 `FRESH_RESET_AUTHORISATION_FORBIDDEN` 则与 撤销其他会话、更改其有效期或注册通行密钥相关联。 `SESSION_TOO_FRESH_*`和`PASSWORD_TOO_FRESH_*`涉及所有权转移以及 收入或礼品的提取。这些并非数据收集操作;新登录并不 意味着全面禁止在24小时内读取数据。导出操作可能会单独返回 `TAKEOUT_INIT_DELAY_*`。TgWitness会保留服务器请求的暂停状态,且不会自动重试 令牌接受或撤销会话以规避限制。 **更多工具 → 账户 → 账户安全 → 该账户的会话 → 结束所有其他会话**:应 操作员请求调用 `auth.resetAuthorizations`,并将会话 数量(结束前和结束后的)记录到 `account.all_other_sessions_terminated` 中。Telegram 仅接受来自已登录满 24 小时的会话发出的此请求。 当此工作区通过导入的会话使用二维码登录时,批准该登录的会话 将保持登录状态:TgWitness 使用 `account.resetAuthorization` 逐一终止其他会话,并 记录 `kept_approving_session`。**将该会话设为唯一会话**后,系统将以此为由停止操作 且不更改密码。 **将此设为唯一会话**:对于通过此工作区登录生成的密钥,执行相同操作,若账户未启用两步验证,则为其启用。面板会显示该密码一次;TgWitness 仅在显示前将其保存在工作区保险库中。日志记录 `session.exclusive_from`。如果 Telegram 随后列出另一个会话,日志将记录 `session.exclusive_ended` ,面板将触发警报。验证器会打印这两项信息。 **当 Telegram 允许将此设为唯一会话时,这**相当于定时执行同一操作。该 选项会出现在此工作区中创建的密钥的**该账户的会话**下,并被 记录为 `session.exclusive_automatic`。在观察期间,收集器每五 分钟检查一次,自该密钥的 `account.authorized` 记录以来是否已过去 24 小时—— 在此之前,Telegram 会返回 `FRESH_RESET_AUTHORISATION_FORBIDDEN` 响应——然后执行同一 操作一次。成功执行将记录为 `session.exclusive_from`,与手动按钮的效果相同。 若操作被拒绝,则会以`session.exclusive_postponed`的形式记录一次(附带Telegram给出的原因), 收集器将以递增的延迟(最长可达六小时)进行重试。此处只读模式无效: 结束会话属于账户安全操作,而非聊天操作。 自动运行生成的两步验证密码会在 Telegram 设置该密码之前,使用工作区密钥加密并保存到工作区保险库中。控制面板会从 `POST /api/account/sessions/only/password`,该操作会将其删除,并在您打开**该账户的“会话**”时,将其显示在与手动流程相同的对话框中。连接页面会提示有密码待取。该密码绝不会进入日志,且在显示之前即使重启也能保留。 在观察过程中,新会话也会被报告:当 Telegram 的会话列表新增一条记录时, `account.sessions`记录会在`added`下为其命名,控制面板会触发警报,并显示 该快照中的设备、应用程序和国家/地区信息。 ### 见证探针 **更多工具 → 账户 → 账户安全 → 见证人探针**用于检查其他客户端是否接收该账户的 更新。添加一个使用不同 Telegram 账户登录且拥有独立 会话密钥的第二个工作区,创建一个包含这两个账户的私人群组,然后将该群组设为**探针 聊天**,将第二个工作区设为**见证人工作区**,并开启探针功能。两个账户 均需关闭**只读模式**,且见证人工作区必须处于观察状态。 在观察过程中,该工作区每60–120秒向群组发送一次`probe::` 并记录`probe.sent`。见证者响应`ack::`并记录`probe.seen`和 `probe.ack_sent`。若确认应答在20秒内作为实时更新到达该会话,则 记录为`probe.acked`。否则,工作区将读取群组的近期历史记录。 若在历史记录中 发现某条确认但未以实时更新形式送达,则将其记录为 `coverage.gap`,原因 为 `probe_ack_missed_live`:控制面板将触发警报,并标记事件接收为失败,直至 后续确认以实时更新形式送达(`connection.restored`,原因 `probe_ack_live`)。未记录任何确认为 `probe.unanswered`;等待期间的连接中断或无法读取的历史记录则记录为 `probe.inconclusive`。只读状态、Telegram 限制及 FloodWait 暂停均仅记录一次 ,标记为 `probe.skipped`。 ### Telethon `.session` | | | | --- | --- | | 产品简介 | 基于 Telethon 的工具生成的 SQLite 数据库,例如 `my_account.session` | | 获得以下机构认可: | 表格 `sessions`(连同 `dc_id`、`server_address`、`port`、`auth_key`)和 `version` = 7 或 8 | | 要求 | 仅有一行授权会话记录;一个封闭且完整的数据库 | 请先关闭创建该文件的程序。如果其旁边存在 `my_account.session-journal` 或 `my_account.session-wal`,则表示数据库尚未最终确定:请正常打开并 关闭原始客户端。删除这些辅助文件可能会导致副本损坏。 ### Pyrogram `.session` | | | | --- | --- | | 产品简介 | 基于 Pyrogram 的工具生成的 SQLite 数据库 | | 获得以下机构认可: | 表 `sessions` 包含 `dc_id`、`auth_key`、`test_mode`、`user_id`、`is_bot`;`version` = 2 或 3 | | 要求 | 生产网络上仅允许一个授权**用户**会话。机器人和测试数据中心(test-DC)会话将被拒绝 | 登录时,系统会将存储的用户 ID 与 Telegram 进行比对。 ### 会话 + JSON 对 账户通常以两个同名文件的形式分发,例如 `447700900123.session` 和 `447700900123.json`。请同时选中**这两个文件**。 - 根据 JSON 信息,TgWitness 使用 `app_id`/`api_id` 和 `app_hash`/`api_hash`,因此您 通常无需手动输入 API 凭据。 - 连接配置文件使用 `device_model`(别名 `device`)、`system_version` (别名 `sdk`)、`app_version`、`lang_code`、`system_lang_code`(别名 `system_lang_pack`)、 `lang_pack` 以及可选的 `tz_offset`(以秒为单位,相对于 UTC 的偏移量,范围为 -43200 至 50400)。 用户提供的字段优先于生成的默认值和面板/浏览器的 语言设置。冲突的别名将被拒绝。解析后的配置文件将保存在 加密的工作区凭据中,并在重启后被重复使用,其中包括其应用版本。 - `phone`、代理设置和设备令牌将被**忽略**。`twoFA`仅在 选择**创建独立授权**时为只读;直接导入时将忽略该字段。 - 不包含受支持授权字段的 JSON 仅为元数据。请添加其会话 文件,或继续使用手机或二维码登录。包含受支持会话或 授权密钥的 JSON 可独立完成授权;详见[账户 JSON](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#account-json)。 ### Telegram 桌面版 (TData) TData 是 Telegram Desktop 应用程序(来自 desktop.telegram.org 的跨平台 应用程序)中的 `tdata` 文件夹。 | 系统 | 默认位置:`tdata` | | --- | --- | | Windows | `%APPDATA%\Telegram Desktop\tdata`(便携版 Telegram:位于 `Telegram.exe` 旁边) | | Linux | `~/.local/share/TelegramDesktop/tdata` | | macOS | `~/Library/Application Support/Telegram Desktop/tdata` | 导入方法: > **并行会话警告。**直接导入 TData 会复用 Telegram Desktop 的授权 密钥。请勿在 Desktop 和 TgWitness 中同时使用该密钥。Telegram 可能会通过 `AUTH_KEY_DUPLICATED` 使授权失效,导致两个实例均无法使用,直至重新登录。 > > > > 请完全退出 Desktop(包括其系统托盘进程),并在 TgWitness 使用导入的会话期间保持该副本关闭。**请退出程序,切勿注销或撤销会话:** 撤销操作也会使导入的副本失效。如果您需要同时运行两个客户端, 请选择**创建独立授权**,并在 新登录成功之前保持 Desktop 关闭,或者通过手机或二维码登录 TgWitness。建议使用 专用账户,但这并不能确保克隆密钥在并行使用时是安全的。 > > > > 这同样适用于导入的 `.session` 文件、StringSession文本及认证密钥十六进制值。 其他拥有独立创建的授权的客户端可以保持登录状态。 请参阅[Telegram的AUTH_KEY_DUPLICATED文档](https://core.telegram.org/api/errors#406-not-acceptable)。 1. 完全退出 Telegram Desktop。 2. 从 `tdata` 中提取仅包含以下两项内容的 ZIP 压缩包: - `key_datas` - 其旁以 `s` 结尾的 16 个字符的文件,通常为 `D877F783D5D3EF8Cs` 将整个文件夹及其媒体缓存打包为 ZIP 文件通常会超出限制 (512 条记录,解压后 32 MiB)。 3. 在**“文件**”中选择该 ZIP 文件。如果 Telegram Desktop 设置了**本地密码**,请先在 **“密码”或“会话文本”栏**中输入该密码。这并非双因素认证(2FA)密码。 支持功能:每个存档仅限一个账户,采用现代`key_datas`/`key_data0`/`key_data1`存储技术, 本地密码保护。不支持功能:包含多个已登录账户的文件夹、旧版桌面 布局、受密码保护的ZIP文件,以及独立的原生macOS应用“Telegram for macOS”。 ### Telethon StringSession 一行文本,通常以 `1` 开头,长度约为 350 个字符。请将其 作为 `.txt` 或 `.tgwitness-session` 文件(最大 4 KiB)加载,或将其粘贴到 **“通行码”或“会话文本**”下方。仅接受 Telethon 字符串;Pyrogram 和 TDLib 字符串采用不同的格式。 ### 授权密钥和 DC 合为一行 账户列表通常以 `<512 hexadecimal characters>:` 的形式携带原始授权信息, 例如 `a1b2…ef:5`。请将该行粘贴在**通行码或会话文本**下方,将其作为 文本文件加载,或将其放入[账户 JSON](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#account-json) 的 `session` 字段中。TgWitness 将 DC 1–5 映射到与 `auth_key` + `dc_id` JSON 导入相同的正式地址,并 **以授权密钥 HEX 和 DC**的格式进行报告。任何其他 DC 编号或密钥长度均会被拒绝。 ### 账户 JSON 一个 JSON 对象,大小不超过 **64 KiB**,存储在以 **`.json`** 结尾的文件中。 | 字段(别名) | 含义 | | --- | --- | | `api_id` (`app_id`) | 应用程序 ID,一个正数 | | `api_hash` (`app_hash`) | 应用程序哈希值,32个十六进制字符 | | `string_session`(`session_string`、`session_str`;旧版 `session`) | Telethon StringSession 文本,或 `<512 hexadecimal characters>:`,而非文件名 | | `auth_key` (`auth_key_hex`) + `dc_id` | 完整的 512 个字符的认证密钥和 DC 1–5 | | `user_id` (`id`) | 可选;在保存授权之前,需与 Telegram 进行比对验证 | | `device_model` (`device`) | 连接设备说明 | | `system_version` (`sdk`) | 连接操作系统版本 | | `app_version` | 发送至 Telegram 的应用程序版本 | | `lang_code`, `system_lang_code` (`system_lang_pack`), `lang_pack` | 客户端语言、系统语言和客户端语言包;允许使用空的`lang_pack` | | `tz_offset` | 可选的 UTC 偏移量(以秒为单位),通过 `initConnection.params` 发送;整数或十进制整数字符串 | 如果别名和主名称同时存在,它们必须一致。显式的 Telethon 会话字段优先于其他格式的通用 `session` 数据块。如果 两者都包含可识别的 Telethon 会话,则它们必须描述相同的授权。 如果没有显式字段,`session` 必须是有效的 Telethon StringSession,或者是以 `<512 hexadecimal characters>:` 形式表示的授权密钥 和 DC。示例: ``` { "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" } ``` ``` { "api_id": 1234567, "api_hash": "0123456789abcdef0123456789abcdef", "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS", "dc_id": 2, "user_id": 123456789 } ``` 第一个示例仅需填写 API 凭据;您可通过手机或二维码登录,或添加会话 文件。不支持批量列表(即账户的 JSON 数组)。 ## 识别您拥有的内容 | 您会看到 | 它是一个 | 用法 | | --- | --- | --- | | `*.session`;在文本编辑器中打开后,顶部显示为 `SQLite format 3` | Telethon 或 Pyrogram SQLite | **文件**(自动检测) | | 一个名为 `tdata` 的文件夹,其中包含 `key_datas` | Telegram 桌面版 TData | 将两个文件打包为 ZIP 文件,然后**进入“文件”** | | 以 `1` 开头的一行文本,约 350 个字符 | Telethon StringSession | **文件** | | 一行文本 `512 characters 0-9a-f`,随后是 `:` 和一个数字 1–5 | 授权密钥和 DC | **文件**、箱**密码或会话文本** | | `*.json` 搭配 `app_id`/`app_hash` | 配套元数据 | **文件**及其会话 | | `*.json` 搭配 `auth_key` 或 `string_session` | 账户 JSON | **文件** | | 512 个字符 `0-9a-f` | 授权密钥 | **认证密钥** | | 32 个字符 `0-9a-f` | API 哈希值 | **API ID + 哈希值** | | 来自 TDLib 应用的 `td.binlog` 或 `db.sqlite` | TDLib 存储 | 不支持 | | `123456789:AA…` | 机器人令牌 | 不支持 | ## 不受支持的格式 | 格式 | 备选方案 | | --- | --- | | TDLib 存储(`td.binlog`)和 TDLib 导出功能 | 通过手机或二维码登录 | | Pyrogram 会话**字符串** | 请使用 Pyrogram `.session` 文件,或通过手机/二维码扫描 | | TData 包含多个已登录账户 | 请在 Telegram Desktop 中注销其他账户,或使用各账户各自的会话文件 | | 机器人令牌 | 不支持:TgWitness 以用户账户身份进行监控 | | 包含大量账户的 CSV/JSON 列表 | 通过**账户 → 导入账户**导入受支持的会话文件,或在独立的工作区中通过手机号/二维码登录 | | 测试数据中心(Test-DC)或机器人会话 | 请使用正式版用户账户 | ## 多个账户 点击账户选择器旁边的**+号**,或打开 **更多工具 → 账户 → 设置 → 连接设置 → 工作区**,输入标签并 登录。 - 支持任意数量的工作区,包括主工作区。每个工作区都有独立的会话、代理 路由、消息源、捕获策略、日志、签名密钥、检查点和导出功能。 - 切换显示的工作区不会暂停其他工作区。 - 日志始终与创建它的账户绑定。使用其他 账户登录需要另一个工作区,且一个账户不能分配给两个 工作区。 - 主面板令牌可控制所有工作区。[授予的访问权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)可将其他用户的访问范围限制在选定的账户和聊天群组内,并可设置独立的权限和会话限制。 - **账户会**重命名一个工作区,并删除一个已添加的工作区,连同其会话、日志、 来源和签名密钥一并删除。主工作区无法从面板中删除。 ### 批量导入和账户分组 使用**“账户”→“导入账户**”可添加多个账户,按文件基名配对文件 并查看每个登录结果。每个账户都有独立的工作区。 “组”可将相关账户集中管理,同时不会合并其会话、密钥或 证据。在**“账户**”页面中**点击“开放组**”可跳转至其页面: `/groups/`: - **账户:**每位成员的连接路径、观察记录和最后一条消息,并提供 **“全部**启动”和**“全部暂停”功能**。 - **需要关注:**已注销、不可用或存在 连接、接收、来源或媒体问题的账户;每个名称均链接至其卡片。 - **多个账户可见的聊天记录包括:** 共享来源、正在查看这些记录的账户以及 可用工作区观察期间(最长七天)内的中断情况。**使用 N 个账户进行导出时,** 会将频道或超级群组的导出内容分配给这些账户,并为一个存档文件签名。 - **导出组:**包含一个 ZIP,其中包含每个账户的已签名导出文件,位于 `accounts/` ,并 `manifest.json` 列出其SHA-256和密钥指纹,由主 工作区在 `manifest.signature.json`。请使用 `python -m tgwitness.verify` 并使用该账户的可信指纹进行验证。 成员共享群组的设置;单个账户可保留其自身的设置值。 请参阅[共享设置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/#account-groups)、 [导入与群组指南](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings) 以及 [MTProxy 数据池仪表盘](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources)。 ## 退出登录 **更多工具 → 账户 → 退出 Telegram**(暂停观察)会要求 Telegram 终止该 会话,因此该会话也会从账户的**设置 → 设备**中消失,并从 工作区保险库中移除该会话。日志、数据源、设置和签名密钥将保留,且 日志会记录此次退出操作。 该工作区仍归属于其账户:只有该 账户才能再次连接到它。如果 Telegram 没有响应,该会话仍会在此处被移除 ,且面板会显示相应提示;请在 Telegram 的**设置→设备**中结束该会话。 ## 当 Telegram 结束会话时 如果 Telegram 禁用、冻结或注销该账户,或者从另一台设备终止会话, 日志会记录原因、Telegram 错误、路由和数据中心。该账户的 健康状况显示**下载账户丢失报告**:这是一个经过签名的 JSON 文件,其中包含丢失前 24 小时的日志记录,即连接、路由、会话、账户通知和覆盖 缺口,每项都带有相应的日志哈希值和签名。请使用 `python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP`;证据导出 中包含完整的哈希链。当被冻结的账户尝试连接时,系统会在监控期间检测到该情况,并 禁用其发送和加入操作。 ## 确保账户文件的安全 - 请将每个 `.session`、TData ZIP、StringSession、Auth Key 和账户 JSON 视为 密码。TgWitness 会将导入的授权信息保存在其加密保险库中;您可以在 之后删除原始文件。 - 请勿在两个程序中同时运行同一授权。Telegram 可能会撤销该授权 (`AUTH_KEY_DUPLICATED`),导致两个程序均无法运行。 - 已过期或被撤销的会话无法通过转换恢复。请重新登录。 ## 故障排除 | 消息或症状 | 操作指南 | | --- | --- | | *无法读取此会话。请关闭其原始客户端……* | SQLite 文件处于打开状态或未完成状态(`-journal`/`-wal` 旁路文件)。请正确关闭原始程序,然后重新复制该文件。 | | *支持的 Telethon SQLite 模式:7 和 8* / *Pyrogram … 2 和 3* | 该文件由一个非常旧或未知版本的库生成。请改用手机/二维码登录。 | | *仅支持授权的生产环境用户会话* | 该 Pyrogram 文件属于某个机器人或测试网络。 | | *TData 存档已超过 512 条记录或 32 MiB* | 仅包含 ZIP 文件 `key_datas` 和 `D877F783D5D3EF8Cs`,不包含整个文件夹。 | | *无法解密 TData。请检查桌面本地密码* | 在**“密码”或“会话文本**”栏中输入 Telegram 桌面版的本地密码。 | | *每次仅导入一个 TData 账户* | Telegram Desktop 包含多个账户;请参阅[“不受支持的格式”](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#unsupported-formats)。 | | *选定的文件描述了不同的账户或 API 凭据* | 仅选择一个账户的文件。 | | *JSON 中未包含任何受支持的 API 凭据或授权信息* | 请检查 [Account JSON](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#account-json) 中的字段名称。 | | *仅限 API 元数据* | 该 JSON 文件中未包含会话信息。请添加 `.session` 文件,或使用手机/二维码。 | | *Auth Key HEX 必须包含全部 512 个十六进制字符* | 密钥被截断或包含`…`。 | | 账户 ID 与导入的账户不匹配 | 该文件的用户 ID 与 Telegram 报告的不一致;该文件属于另一个账户。 | | 该账户已属于另一个工作区 | 请打开该工作区,而非重复添加该账户。 | | 已连接,但在**更多工具→来源**的聊天列表中缺少一个私人群组 | 检查成员资格。选择器会检查前1,000个对话;可在**更多工具→参数**中提高该限制。 | | 代理连接失败 | 检查路由和 IP 模式。自动模式MTProxy会尝试其他可用的入口。隐藏地址模式会等待;直接模式作为最后手段,可在配置的延迟后直接连接。参见[路由模式](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/#ip-modes)。 | 另请参阅:代理和加密的[连接与安全](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/)设置, 以及登录后数据采集的具体[工作原理](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/)。 --- # Telegram · 访问与权限 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/access/ 设置账户和聊天室的访问权限范围,选择权限类型,限制会话和 IP 地址,并撤销访问权限。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 设置账户和聊天室的访问权限范围,选择权限类型,限制会话和 IP 地址,并撤销访问权限。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [入门指南](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) ![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) 可授予审阅者访问某个聊天记录的权限,授予分析师导出案件的权限,或授予 操作员对选定账户的控制权。每个人都会获得专属令牌。主 控制面板的令牌由管理员持有。 [账户设置](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/) · [连接路径](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/) · [安全模型](https://phishdestroy.io/tgwitness/zh/docs/reference/security/) ## 两个应用场景,两种不同的任务 **采集范围**决定了账户的记录内容:选定的聊天、Telegram 文件夹或整个账户。**访问范围则**决定了其他用户可以查看和使用哪些已记录的 账户和聊天。授予访问权限并不意味着加入 Telegram 聊天、开始采集或授予 Telegram 账户权限。 访问权限可打开选定的工作区、其中选定的聊天、所有 工作区,或某个 [账户组](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#bulk-import-and-account-groups)中的所有账户。**所有工作区, 包括后续添加的工作区**,也涵盖未来的账户。组访问权限同样 涵盖后续添加到该组的账户。若需将某个 案例的访问范围限定在特定工作区内,请明确选择相应的工作区。 ## 授予某人访问权限 1. 以主管理员身份登录,并打开**更多工具→访问**。 2. 在“**授予某人访问权限**”下,请输入一个您在日志中能认出的名字。 3. 选择工作区,并在必要时选择具体的聊天室。 4. 选择此人可能采取的行动。**操作视图**始终包含在内。 5. 根据需要设置有效期、登录/会话限制以及允许的地址。 6. 点击**“创建访问权限**”。请立即复制该令牌:该令牌仅显示一次。 7. 请私下发送控制面板地址和令牌。收件人只需在常规登录页面输入该令牌 即可;他们无需您的主控制面板令牌,也无需 Telegram 会话。 请在单独的浏览器会话中打开包含已生成令牌的面板,并在移交前检查 可见的聊天记录及允许的操作。 访问名称保存在加密的本地存储中,并由管理员面板进行解析。 新创建的访问和工作区审计记录中省略名称;现有的签名记录保留其原始字段。 ## 选择权限 如需进行纯文本的公开演示,请使用**“公开展示**”而非普通 审阅者访问权限。它会显示明确选定的公开频道、保留的编辑和 删除记录,以及经过签名的统计数据,其中作者字段将被遮盖,文件将在 API 边界处关闭。[创建并验证展示内容](https://phishdestroy.io/tgwitness/zh/docs/reference/showcase/)。 | 许可 | 功能介绍 | | --- | --- | | `view` | 可查阅获准访问的聊天记录、捕获的消息、个人资料、文件以及经过筛选的日志记录。这些内容始终包含在内。 | | `export` | 允许导出聊天记录和档案。导出整个工作区的证据需要具备对整个工作区的访问权限。 | | `sources` | 管理消息源、快照和个人资料捕获。受聊天限制的访问权限仅限于允许的聊天;全账户范围的消息源发现和范围设置保持关闭状态。 | | `collect` | 启动或停止采集器。由于采集操作会影响该账户,因此需要整个工作区的访问权限。 | | `interact` | 在访问权限范围内执行受支持的 Telegram 交互操作。受限于聊天范围的访问权限无法使用全账户范围的链接预览功能。 | | `settings` | 可更改采集设置、时间戳、通知、异地副本及各项参数。需具备整个工作区的访问权限。 | | `account` | 登录或退出 Telegram 并管理连接路径。需要整个工作区的访问权限。 | | `board.read` | 仅在允许的工作区和聊天记录内阅读“案件板”笔记。 | | `board.write` | 可添加书签、高亮标记、片段、评论以及“已打开”/“已审查”状态。此外还需使用 ``board.read`` 功能。 | | `board.manage` | 管理数据集、团队最终状态以及其他参与者的卡片。此外还需要对白板的读写权限。 | 只有主管理员才能下载异地副本恢复密钥。 被授权的`settings`或`account`访问权限不会授予该密钥。 权限和范围将一并核查。勾选某项权限不会 打开其他聊天记录,也不会为仅限特定聊天记录的访问权限解锁工作区范围的操作。 若要进行并行导出,访问权限必须涵盖所有选定 账户中的被导出聊天。已授予的访问权限无法创建新访问权限、管理他人的 会话或打开管理员控制台。 ### 三种实用的配置方案 | 人物 | 范围 | 权限 | | --- | --- | --- | | 审稿人 | 某案例的记录聊天内容 | `view` | | 分析师正在准备工作交接 | 待调查和导出的聊天记录 | `view`、`export`;仅当需要通过 Telegram 进行操作时才添加 `interact` | | 采集操作员 | 精选完整工作区 | `view`、`sources`、`collect`;仅在需要时添加 `settings` 或 `account` | “访问”表单的初始预设还包括“案件看板”:审核员可读取、分析师可读取 和写入,操作员可进行管理。预设仍可编辑,且现有权限不会 自动扩展。有关继承的聊天范围和导出隐私设置,请参阅[“案件看板”](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)。 ## 限制与会话 | 设置 | 工作原理 | | --- | --- | | 并行会议 | 将同时在线会话数限制在 1–100 之间。达到上限时,拒绝下一次登录请求或终止最旧的会话。 | | 允许登录 | 限制使用该令牌成功启动会话的次数。即使最后一次允许的登录已被使用,现有会话也不会因此终止。 | | 有效期至 | 访问权限设有绝对有效期。过期的访问权限无法登录或继续发起请求。 | | 无活动记录 | 会话闲置超时,范围从 5 分钟到 30 天。成功请求会延长该时限;打开的面板可通过轮询保持活动状态。 | | 允许的地址 | 接受特定的 IP 地址或 CIDR 子网。若未填写,则允许任何地址,除非已启用首次登录绑定功能。 | | 绑定至首次登录 | 首次成功登录后,系统将锁定该访问的授权地址。 | IP 地址是应用程序所识别的客户端地址。若位于反向代理或 隧道之后,请在依赖 IP 规则之前,先检查**“打开的会话**”中显示的地址: 否则,可能会出现多名用户看似共享同一代理地址的情况。 ## 更改或撤销访问权限 在**“已授予的访问权限**”下编辑某条目,以更改其作用域、权限或限制。 后续请求(包括 来自已打开会话的请求)将验证作用域和权限的变更。撤销访问权限将终止其会话 并使已签发的令牌失效。通过**“打开的会话**”,管理员还可以 在不撤销整个访问权限的情况下终止单个会话。 已保存的导出副本保留其创建者、工作区、聊天范围及所需权限。 已授予访问权限的用户仅在相关权限仍有效期间,才能列出或下载其自身的副本; 包含案例看板的副本还需具备`board.read`权限。管理员可检索所有副本。 不包含此元数据且无组打包的旧副本仅限管理员访问。下载凭证 和预备文件响应会在文件准备就绪后、发送字节之前重新验证访问权限。 每个访问者(包括管理员)在每个工作区中最多可持有十个待处理下载凭证; 工作区范围内的上限为1,000个。凭证在120秒后过期,且仅限一次性使用。 撤销操作无法召回用户已下载的文件。注销、 锁定面板或结束会话均不会停止正在运行的收集器。 ## 管理员可见的内容 审核员和分析师收到的数据采集进度信息中不包含代理端点、 池诊断信息、服务器路径或原始连接错误。连接诊断 需要对整个工作区拥有`account`权限。读取通知、 异地副本和参数设置需要`settings`权限。 访问会话中不会保留完整的浏览器User-Agent字符串。升级后, 这些字符串也会从可变会话缓存中移除。控制面板进程日志会屏蔽 IP字面量、URL凭据和标记机密。本地服务日志和 先前已签名的日志记录不会被重写。访问规则和已签名的 登录记录仍使用客户端地址。 ### 替换主密钥 请使用**更多工具→访问→我的限制→重新签发管理员密钥**,或在控制面板运行期间,从受管安装环境中运行 `tgwitness token rotate`。 所有现有浏览器会话都将终止,包括使用同事 令牌打开的会话。请求的浏览器将获得一个新会话;请在隐藏新管理员 密钥之前将其保存下来。已签发的同事令牌在被单独撤销前始终有效。 使用`TGWITNESS_TOKEN`的安装环境必须修改该环境变量并重启。 ### 请求与代理边界 该 API 允许每个客户端和凭据类别(包括: 面板、存档/MCP 或见证)每分钟最多发起 600 次请求。这些类别的身份验证冷却时间是分开计算的。 一分钟内十次身份验证被拒绝将触发指数级冷却时间,从一秒 起,最长可达五分钟。冷却时间结束后若尝试失败,冷却时间将延长;若十分钟 内未发生失败尝试,则重置递增机制。拒绝请求将返回 HTTP 429 状态码, `Retry-After`。配额存储在内存中,由同一面板进程内的各个工作区共享; 重启后配额将被清零。实时流每个承载令牌限开四个, 每个面板进程限开32个。打开流也会消耗API请求配额。 请求正文的接收时限为60秒,登录、演示访问、 归档API和witness-head路径的时限缩短至10秒, MCP传输的时限为8秒。每个应用程序允许 每个客户端地址拥有四个未完成的请求正文,预留 路由配额的总体限制分别为32和64 MiB。 无正文的请求不占用这些配额。正文超大将返回 413,超时将返回408,超过客户端容量将返回429并附带`Retry-After: 1`。 当整体正文容量耗尽时,将返回状态码503,并包含`Retry-After`字段。 除非实际的 TCP 对等方属于 `TGWITNESS_TRUSTED_PROXIES`(以逗号分隔的 IP 地址或 CIDR 范围),否则将忽略转发 IP 报头。将 `TGWITNESS_PROXY_HEADER` 设置为 `x-forwarded-for` 或 `cf-connecting-ip`。XFF 将 从最近的代理向第一个不受信任的对等方进行遍历。 格式错误或重复的 受信任地址元数据将被拒绝,因此无法继承白名单中的代理 地址。受管理的快速隧道 信任本地 Cloudflare 连接器;自有域配置则信任本地 Caddy。 直接部署默认不信任任何代理。如果您自行启动 Uvicorn, 请禁用其代理标头处理功能,以便该边界能接收实际的对等节点。 `TGWITNESS_PANEL_ALLOWED_IPS` 将所有控制面板访问权限(包括管理员权限) 限制为列出的 IP 地址或 CIDR 范围。安装程序的路由标识探针保持公开状态, 且不返回任何账户数据。在 启用白名单之前,请包含所需的本地管理路由。受管安装的 **START-HERE** 指南包含 服务配置和恢复说明。 API 中的 `ws` 查询选择器必须在请求路径中标识工作区; 未知、不匹配或重复的选择器将被拒绝并返回 404 状态码。 面板脚本和样式包含 SHA-384 完整性元数据。导入映射还 涵盖了在支持 import-map 完整性的浏览器中本地导入的 JS 模块。 动态生成的语言响应是独立的。这些检查可检测 相对于交付页面的资源替换;页面本身及其哈希值 来自面板服务器,因此请保护该服务器及其交付路径。 **自启动以来生成的日志**将进程日志与每个 工作区的日志活动相结合:登录、拒绝、路由变更和操作员操作。这是一个 针对当前进程的内存控制台,而非每条消息的永久副本。 高频消息事件会保留在日志中,而非填满控制台。 授予、更改和撤销访问权限,以及启动或结束会话,也会生成 经过签名的`access.*`日志记录。这些记录中不包含令牌。 已发放的令牌和会话凭据将作为哈希值保存在加密保险库中。 待处理的 QR 登录属于发起该登录的面板会话。 终止或 撤销该会话,或轮换主面板令牌,将取消服务器上的待处理 QR 客户端。当浏览器无法发送其自身的 取消请求时,此规则同样适用。令牌轮换还会取消直接 使用主面板令牌启动的 QR 登录。正在等待另一项操作的 QR 请求会在开始前 再次检查访问权限。已完成的 Telegram 授权以及由另一个面板会话 启动的待处理登录将予以保留。 ****主要管理员与信任边界**** 主面板令牌不受限制。使用该令牌进行浏览器登录会创建会话, 这些会话受管理员配置的会话限制约束。直接发送 主令牌的脚本仍保留完全访问权限,且不计入浏览器会话。 这是单个安装环境中的应用层访问控制。所有工作区共享 服务器进程;这并不意味着与主机管理员隔离。请确保主 令牌、Telegram 会话、签名密钥和数据目录的私密性。见证令牌 是一个独立的检查点/健康凭证,而非面板访问令牌。 --- # Telegram · 连接、代理和数据保护 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/connection/ 身份验证、自动代理池、IP 模式、备用策略、外部请求及密钥存储。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 身份验证、自动代理池、IP 模式、备用策略、外部请求及密钥存储。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [部署与恢复](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) ![部署与恢复](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) 本文档描述了 TgWitness 0.9.3 的行为及其限制。身份验证、 源访问、网络连接和捕获完整性是独立的状态。 有关登录步骤、文件格式和多账户信息,请先参阅 [账户和会话格式](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)。有关事件策略和重启 行为,请[参阅采集原理](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/)。 ## 连接设置指南 在**更多工具→账户→连接路径**中,管理员可选择**此账户**、**账户 组**或**所有账户**,然后选择一条路径。**查看选择**会列出 受影响的账户。**准备并检查**功能可在不更改 已保存路径的情况下测试建议的路径。**应用已检查的连接**会验证预览结果,在 必要时暂停监控,保存路径并恢复已运行的监控。 系统绝不会在先前处于空闲状态的账户中启动数据采集。历史数据下载将保持 暂停状态,并可单独恢复。切换前请暂停正在进行的导出操作。 群组更改默认会为每个账户保留其独立路径。仅当预览列表中显示了您期望的更改时, 才应清除该选项。 应用程序会报告每个 账户的结果;这并非跨数据库的“全有或全无”式操作。若 切换失败,该账户将恢复之前的设置。恢复失败的情况会 明确显示。预览有效期为十分钟,且连接 设置或群组成员资格的更改需要重新检查。 当“Apply”的路线、 模式和策略保持不变时,它会将成功的预检结果重复使用,有效时长最长为90秒。受管隧道仍必须保持相同的运行 进程。较早的检查结果、已更改的隧道进程以及自动MTProxy池路线 将重新进行检查。签名的应用程序记录会保留原始检查时间, 并记录重复使用情况及其有效期。每次预检都会关闭其临时未认证的 客户端;收集器则使用其自身的授权会话进行连接。 | 路径 | TgWitness 管理的内容 | | --- | --- | | 直接 | 来自主机的连接;未检测到外部主机 VPN,也未强制执行。 | | VPN | 每个账户仅有一个全隧道 WireGuard 配置文件,由本地用户空间中的 SOCKS5 进程承载。不安装任何主机接口或驱动程序。 | | 我的代理 | SOCKS5、HTTP CONNECT 或 MTProxy 凭据。SOCKS5/HTTP 字段可填写 URL。选择多个账户时,将共享此处输入的代理。 | | 公开版 MTProto | 现有池分配Telegram路由。在高级设置中配置单独的合适代理之前,外部请求将被禁用。 | | WARP | 为每个选定的账户建立独立的本地隧道,并将 WARP 注册信息和 WireGuard 配置文件保存在该账户的保险库中。 | 当前路由检查使用的是一个全新的、未经身份验证的 Telegram 传输通道,而非 该账户的会话。它通过该路由向 该账户的数据中心建立传输连接,并进行一次未经身份验证的 MTProto 往返通信 (`req_pq_multi`);该过程不会生成授权密钥,也不使用任何账户。 报告的延迟值等于连接时间加上往返时间,且该检查 会分别记录这两部分。对于支持 HTTP 的路由,它还会请求 通过该路由对 Cloudflare 的 HTTPS 追踪进行请求,并显示其报告的出口 IP、 国家/地区、WARP 状态和检查时间。除非追踪 报告 WARP 处于活动状态,否则 WARP 准备将失败。这些预检会报告路由连通性及 观察到的出口。请通过存档的采集和 验证结果审查捕获的记录。仅凭本地进程正在运行并不代表出口检查成功。 该面板会计算最近五次检查的移动平均值。当 该平均值超过5秒,或者连续三次检查超过该值时,该路由即被视为**速度较慢**; 若连续两次检查失败,则该路由被视为**不可用**; `network.slow_route` 并 `network.route_recovered` 记录这些变化。对于速度较慢的WARP路由**,“重新掷骰WARP**” 会重启该账户与其他Cloudflare WARP端点之间的隧道连接,保留 最快的连接,并记录 `network.warp_rerolled` 并记录其前后时间; **“新 WARP 身份**”会注册一个新的 WARP 设备,并仅在该设备 速度更快时保留它。本地代理地址、Telegram 账户及其会话保持 不变;Telegram 连接将通过重启后的隧道重新建立。速度较慢的 WARP 路由最多每 30 分钟自动重启一次;若此举 无效,后续重启将等待操作员处理。 ### 便携版 WARP 和 WireGuard 这是一个 **非官方的 WARP 集成**,使用 [wgcf 2.3.1](https://github.com/ViRb3/wgcf/releases/tag/v2.3.1) 和 [wireproxy 1.1.3](https://github.com/windtf/wireproxy/releases/tag/v1.1.3)。 管理员需在首次下载或 WARP 注册之前明确接受该设置。 这些设置连接会直接连接到 GitHub 和 Cloudflare,并 泄露设备的 IP 地址。普通账户的流量在应用该设置前 仍保持原有路由。Cloudflare 会选择出口地址和国家;不同的隧道 可以共享同一个出口地址。该功能不提供国家选择、周期性 IP 轮换以及全主机范围的 VPN 杀开关功能。 支持下载的辅助程序:Linux 和 macOS x86-64/ARM64,以及 Windows x86-64。 会根据已审核源代码中捆绑的 SHA-256 哈希值对构建产物进行校验, 并在启动前再次对缓存的可执行文件进行校验。 任何辅助程序均不会被添加到 PATH 环境变量中,也不会作为系统服务安装,或配置为公开监听器。所有文件均位于 工作区下的 `portable-routes/` 目录中,并存储在加密的保险库条目内。 环回监听器 SOCKS5 需要独立生成的凭据。 私有配置文件和 WARP 账户凭据使用现有的 工作区保险库进行加密。运行期间,辅助程序需要一份仅所有者可见的明文配置文件; 正常停止时该文件会被删除。主机崩溃可能会导致该文件残留在 仅所有者可见的数据文件夹中。这不会对磁盘进行加密,也无法防止 管理员访问。 如果面板的父管道 消失,监督程序将关闭隧道。失败的隧道绝不会启用直接回退。面板重启 将恢复选定的隧道;启动失败时,将在限定延迟后重试。**停止 隧道** 也会暂停监视并保持已停止状态。**启动隧道** 启动隧道;准备就绪后需单独恢复监视。 上传的 WireGuard 配置文件必须包含一个接口和一个对等节点、完整的 IPv4 和 IPv6 路由,且不得包含钩子、包含语句、环境变量替换或额外的 监听器。公共端点地址将在启动前解析并固定。 请使用外部 VPN 或 SOCKS5 网关来连接 OpenVPN/IPsec 及私有端点。 ## 认证方法 **API ID 和 API 哈希用于标识应用程序;它们不能替代账户登录。** 在 TgWitness 中,它们是可选的。优先级顺序为:表单中输入的一组,然后是来自 导入的账户 JSON 文件中的一组,接着是保存在工作区中的一组,最后是内置的 50 个 对,当Telegram拒绝某组时,系统将按随机顺序尝试并自动轮换。只有 Telegram Desktop密钥对(2040)会随匹配的Telegram Desktop客户端描述一同发送。 您可在[my.telegram.](https://my.telegram.org) org的API开发工具中生成的自有密钥对可用于所有账户;每个账户仍拥有独立的授权。 | 方法 | 要求 | TgWitness 支持 | | --- | --- | --- | | 手机号、代码、可选的双因素认证 | 账户访问;API 对(可选) | 面板登录 | | 认证密钥 HEX + DC ID | 完整的 512 个字符密钥和 DC 1–5 | “直接**授权密钥**”选项卡;在保存授权前,可选的“用户 ID”字段需先进行验证 | | Telethon StringSession | 一个有效的会话字符串 | 面板登录 | | Telethon SQLite `.session` | 封闭式、连贯的文案 | 支持直接导入 7/8 版本的模式;可选离线命令行界面 (CLI) | | Pyrogram SQLite `.session` | 已关闭的生产环境用户会话 | 直接通过面板导入模式 2/3 | | Telegram 桌面版 TData ZIP | 一个现代账户;若设有保护,则需输入本地密码 | 带校验和/解密校验的内存内转换 | | 账户 JSON | 支持的 API/会话/密钥字段 | 仅凭元数据即可自动填充 API 凭据;但仍需通过会话/密钥或手机/二维码登录 | | 二维码登录 | 来自授权 Telegram 应用的确认 | 本地 QR 码生成、过期/重试功能,可选双因素认证 | | TDLib / Pyrogram StringSession | 其他特定于库的格式 | 不支持 | | 机器人令牌 | 一个拥有独立访问/更新模型的机器人 | 此收集器未使用该工具 | Telegram 负责选择代码交付方式,包括是否发送短信。API 哈希无法修复 已被撤销的会话,也无法替换遗忘的 2FA 密码。TgWitness 不会将 登录码或 Telegram 2FA 密码持久化到磁盘上。 对于私有源,该账户必须已具备访问权限。无需提供群组用户名。 代理或会话导入既不授予成员资格,也不授予管理员 权限。成员能否查看加入群组之前的聊天记录,由聊天设置决定。 ## 导入 Telethon 会话文件 Telethon SQLite、Pyrogram SQLite 和 Telegram Desktop TData 采用不同的格式。 该面板会检测并转换受支持的结构;重命名文件并不属于 转换操作。在**文件**下选择一个会话及其对应的 JSON 文件,点击**检查文件**,然后**点击连接账户**。最多接受四个匹配的文件, 总大小不超过 8 MiB。 有关 TData/JSON 的详细信息,请参阅[格式限制](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)。 不提供密码恢复功能。通过手机/双因素认证或二维码登录将创建独立的授权。 仅限 Telethon 的可选命令行路径仍然可用: 1. 停止客户端使用原始会话,并制作一份一致的副本。该 转换器会拒绝包含未完成 WAL/日志的文件。请正确关闭原始 客户端,而非通过删除这些文件来绕过检查。 2. 在 TgWitness 环境中,运行: ``` python -m tgwitness.sessions account.session --out account.tgwitness-session ``` 1. 在**“添加账户”→“文件**”下,加载结果或 粘贴其字符串,然后继续。 2. 请核对显示的数字账户 ID,选择数据源并开始监控。 **转换后的文件是一个未加密的账户访问密钥。** 请将其保存在受保护的 存储位置,切勿将其提交或发送给第三方转换服务。TgWitness 会将其授权会话保存在加密保险库中。复制会话不会 创建单独的授权:请勿使用克隆的授权密钥运行多个客户端, 并假设它们能独立接收更新。 转换操作仅传递授权,而非原始消息、实体缓存或 持久化更新游标。它无法解决进程重启后的更新恢复问题。 ## MTProto、Telethon 和代理服务器 MTProto 是 Telegram 的协议。Telethon 是 TgWitness 使用的 Python 客户端库。 MTProxy 是一个 Telegram 传输代理;SOCKS5 和 HTTP CONNECT 提供通用 隧道。这些均无法替代账户身份验证。 请在 **更多工具 → 账户 → 设置 → 连接设置 → 更改连接路径** 在 登录之前。新工作区默认设置为 **自动 MTProxy · 公共列表** with **隐藏地址**. 已显式使用直接模式的现有工作区将保留允许该模式的设置。 文件的读取是通过与读取消息不同的独立连接进行的,这与官方 应用的做法一致。在该账户所属的数据中心内,系统会复用该账户的授权密钥并 建立新的 MTProto 会话;对于其他数据中心,则在 账户连接期间生成并授权一个密钥,且该密钥仅保存在内存中。每个文件连接都使用与该账户相同的 路由。每个数据中心中的文件连接数量受**“参数 → 性能 → “每个 Telegram 数据中心的文件连接数”所限制**;若设置为 0,则仅通过账户的主 连接读取文件。同一安装环境下的所有账户 最多可同时建立五个 Telegram 连接。 ## IP 模式 路由决定连接方式。面板中“账户” 部分的 IP 模式和 **IP 保护**功能,决定了服务器地址何时可能被暴露。这些控制功能不会 安装 VPN,也不会将设备的所有流量都通过该路由传输。 | 模式 | Telegram | 外部请求 | | --- | --- | --- | | 隐藏地址(`hide`) | 请使用代理;若均无法连接,请稍候。无直接备用方案。 | 要求使用 SOCKS5/HTTP;拒绝未通过适用代理的请求。 | | 直接操作仅作为最后手段(`fallback`) | 自动 MTProxy 可能会在配置的延迟时间过后使用 Direct,随后恢复使用正常工作的代理。 | 建议使用已配置的外部代理或该账户的 SOCKS5/HTTP 路由;否则允许使用“Direct”模式。 | | 服务器位于隧道或 VPN 之后(`tunnel`) | 允许使用直连路径,并支持即时自动切换至备用池。 | 若未配置相应的代理服务器,则允许直接连接。 | 隧道或 VPN 模式假设您单独管理该网络。如果没有可用的 隧道,目标端将能看到服务器本身的地址。请根据 您的实际网络环境选择模式,而非仅依据选项名称。 ### 选择路径 | 路径 | 设置 | 边界 | | --- | --- | --- | | 自动 MTProxy | 内置列表或运算符目录 | 维护一条可用的 Telegram 路由;直接备用方案取决于 IP 模式 | | 直接 | 隧道或 VPN 模式 | Telethon 使用主机的网络路由 | | SOCKS5 | 主机、端口、可选的用户名/密码 | python-socks,已启用远程目标 DNS 功能 | | HTTP CONNECT | 主机、端口、可选的用户名/密码 | 仅支持纯 HTTP CONNECT;尚未实现与代理服务器本身的 TLS 连接 | | MTProxy | 主机、端口、密钥 | 实验性 Telethon 传输协议;32 位十六进制数字或 `dd` + 32 位十六进制数字 | 虚假 TLS `ee` 密钥将被拒绝。Telethon 1.45 的规范化处理可去除前缀 和域名,但这并不实现虚假 TLS 功能。请粘贴 `tg://proxy?server=…&port=…&secret=…` 或 `https://t.me/proxy?server=…&port=…&secret=…`,并选择**“从链接填充字段**”。 这将在不建立连接或保存的情况下验证并填充字段;请单独审查并保存 路由。手动字段仍可使用。参见 [Telegram 代理链接](https://core.telegram.org/api/links#proxy-links)。 ### 由您的安装环境提供的公共代理 该内置列表整合了七个来源: [SoliSpirit/mtproto](https://github.com/SoliSpirit/mtproto)、 [zakky8/mtproto-proxy-pro](https://github.com/zakky8/mtproto-proxy-pro)、 [kort0881/telegram-proxy-collector](https://github.com/kort0881/telegram-proxy-collector)、 [3yed-61/MTP-Collector](https://github.com/3yed-61/MTP-Collector)、 [Therealwh/MTPproxyLIST](https://github.com/Therealwh/MTPproxyLIST)、 [KhodeJav/telegram-proxy-collector](https://github.com/KhodeJav/telegram-proxy-collector) 以及 [tgmtproxy/telegram-mtproto-proxy-list](https://github.com/tgmtproxy/telegram-mtproto-proxy-list)。 该打包快照包含端点信息、来源归属及下载日期。 列表仅作为输入;下文的连通性检查将决定使用哪些代理。 **自动 MTProxy** 会检查 Telegram 传输连接状态,维持一个可用的代理, 并在代理失败时切换至另一个。当有足够多的 可用条目时,工作区会优先选择不同的代理;代理可以共享出口地址。失败的代理 会在再次尝试前进入休眠状态。如果所有代理均不可用,IP 模式将决定收集操作 是必须等待还是可以使用直接连接。 更换代理不会更改账户 也不会清除其日志。路由选择和变更都会记录在签名日志中。 当自动路由处于活动状态时,列表每小时刷新一次,传输检查默认 每十分钟运行一次。这些间隔时间均可配置。**更新公共列表** 会触发刷新;仅查看列表不会更改已保存的手动路由。 **Telegram 流量和 HTTPS 请求使用不同的路由。**列表下载使用 独立的 HTTPS 连接以及提供的外部请求路由。 `TGWITNESS_PROXY_FEED_PROXY` 会通过 HTTP/SOCKS5 代理显式覆盖该路由; 两种 Compose 收集器变体均会转发该路由。后台池遵循主工作区。 不会向数据源提供商发送任何 Telegram 会话、API 凭据、控制面板令牌或机器人令牌。 提供商名称、快照日期和下载路径会显示在**“列表来源”部分**。 MTProxy仅承载Telegram流量。工作区的HTTP操作(如时间戳、 通知、站外副本和源代码验证)在 已配置时会使用独立的SOCKS5/HTTP代理,否则则使用该账户的SOCKS5/HTTP路由。若两者均未配置,"隐藏地址"功能将拒绝 该请求;其他模式则允许"直接"连接。外部请求可被禁用。显式 配置的订阅源下载代理仍由操作员单独覆盖。 独立的见证服务保持其自身的路由。 对于由操作员管理的私有服务,现有的服务器环境设置 `TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1` 允许私有目标,并保持 代理端的主机名解析。该设置无法通过控制面板启用。仅限公共 模式会在查询公共解析器之前拒绝 `.onion` 目标;Tor 洋葱 服务需要明确的私有目标设置以及合适的代理。 此 DNS 行为适用于外部 HTTP 操作,不适用于 Telegram 的传输协议。 Cloudflare 提供了关于 [JSON DNS 端点的](https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/)文档。 ****自动池参数**** 在**更多工具→参数→自动 MTProxy**下,配置故障阈值、冷却时间、 计划轮换、代理共享和允许的备用延迟。 | 控制 | 默认 | | --- | --- | | 替换前断开连接 | 3 项,耗时 10 分钟 | | 每次连接尝试中尝试的代理数量 | 3 | | 首次 / 故障后最大恢复时间 | 10分钟 / 6小时 | | 计划轮换 | 已禁用;失败时启用 | | 每个代理的账户数量 | 0:优先单独条目,必要时合并。设置为 1 以等待独占条目。 | | 允许直接回退前的延迟时间 | 10分钟;隐藏地址仍被直接拒绝 | | 数据源刷新/传输检查 | 60 / 10 分钟;主工作区值适用于共享池 | 不同的代理可以共享一个出口地址。Telegram 的限制适用于每条路由。 若要用您自己的运营商目录替换公共列表,请配置以下覆盖设置。 这将完全禁用外部订阅,包括当其 `proxies` 数组为空时。 [将空目录](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proxies.config.example) 复制到 `proxy-config/proxies.json` ,并添加您已部署的公共端点: ``` {"format": "tgwitness-proxy-catalog-v1", "proxies": [ {"id": "project-eu", "label": "Project EU", "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"} ]} ``` 必须替换示例值。最多接受 32 个不同的条目。 经过身份验证的列表会返回标签/主机/端口,无需共享密钥;选择其中一个 会将其凭据保存到工作区保险库中。在进行 明确的传输测试之前,可用性尚未经过测试。如果目录格式不正确,则可进行手动配置。 本地运行:将 `TGWITNESS_PROXY_CATALOG` 设置为本地 JSON 路径。Docker: ``` docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build ``` 该覆盖层以只读方式挂载 `proxy-config`;文件必须可被容器 UID 10001 读取。 该目录被排除在 Git、Docker 构建上下文和源代码归档之外。此 目录用于配置收集账户;[Witness 机器人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)使用其自身的 HTTP/SOCKS5 路由,而非 MTProxy。 直接备用方案由上文所述的 IP 模式决定。在 更改路由前请暂停监控。保存操作将断开旧客户端的连接并取消未完成的登录;新 客户端将使用已保存的路由。该账户的日志/会话绑定关系保持不变。 设置将覆盖之前的路由:编辑时请重新输入代理凭据。 凭据采用`network.enc`加密。API不会返回用户名、 密码或密钥。签名记录包含路由类型以及凭据 是否存在,但不包含端点和密钥。操作员可在控制面板中查看端点。 密钥字段在保存、锁定或切换工作区后将被清空。 **测试 Telegram 连接**(登录前也可使用),通过该路径建立并关闭一个临时 未经授权的 Telegram 连接。该操作不会联系任何 IP 检测 网站。测试成功仅表示传输连接已建立,并不代表群组访问权限、消息 完整送达或匿名性。 该代理适用于 Telegram 客户端的连接,包括 Telegram 数据中心(DC)的媒体 下载。浏览器、pip、SSH 以及手动调用的 TSA 工具则采用独立路径。 代理主机名可在本地解析。`rdns` 影响目标主机名; Telegram 通常提供数据中心(DC)的数值 IP 地址。 SOCKS5 和普通 HTTP CONNECT 本身不会对代理凭据或 客户端到代理的隧道进行加密。MTProto 会单独保护 Telegram 流量。在不可信网络上,请使用 适当的安全通道连接到代理。私人群组 是传输过程中受 MTProto 保护的云聊天;端到端秘密聊天是一种独立的聊天 类型,由[秘密聊天模块](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)进行记录。 ## 加密与签名 | 层级 | 已实现 | 操作员责任 | | --- | --- | --- | | Telegram 流量 | Telethon MTProto | 平台可信度、传输路径及可用性 | | Web 控制面板 | 持有人令牌、默认回环设置、请求限制 | 通过 HTTPS 或 SSH 隧道进行远程访问 | | 秘密 | Fernet 用于管理 API 凭据、会话、代理凭据及签名私钥 | 保护解密密钥和运行主机 | | 保险库密钥 | 新安装时使用本地密钥或外部主密钥 | 独立的受保护存储空间和密钥备份 | | 消息和附件 | 明文应用程序存储 | 加密磁盘/卷 | | ZIP/JSONL/CSV/HTML | 完整性校验,不进行内容加密 | 保护导出的副本和传输内容 | | 来源与时间 | 签名日志、流程收据、RFC 3161 工具 | 可信密钥、独立检查点/TSA 及保管流程 | “账户”中的**存储保护功能**会显示这些状态。面板令牌是一种 访问密钥,而非加密密码。它授予管理员访问权限; [已签发的令牌](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)可限定在特定账户和聊天群组范围内。工作区共享 主机进程,并非独立的租户。 BitLocker、LUKS、FileVault 或受管加密卷可在 各自的威胁模型下保护存储数据。 已解锁且正在运行的机器的管理员 仍然可以读取数据。在存储规划中应将 SQLite WAL/SHM、媒体文件、临时导出文件、交换文件、备份 以及浏览器下载内容纳入考虑范围。Docker 卷仅因其 是卷这一事实,并不意味着它已被加密。 ## 外部主密钥 对于新安装,请将主密钥放置在数据目录之外。 此操作不会自动迁移现有的本地密钥库。请准备一个 仅服务身份可访问的密钥目录,然后运行: ``` python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key python -m tgwitness --data-dir /private/observations/new-case ``` PowerShell,使用已安装的项目环境: ``` python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key $env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key' python -m tgwitness --data-dir E:\PrivateData\new-case ``` 在 Docker 中,将文件以只读方式挂载到 `/data` 之外(例如 `/run/secrets/tgwitness-master.key`),并将环境变量设置为该路径。 该服务的 UID 必须具备读取权限。请通过 环境/配置文件传递路径,而非密钥字节。 每个工作区都会获得一个随机的公共盐值,以及通过 HKDF-SHA256 派生出的专属 Fernet 密钥。`vault.external.json` 仅存储派生元数据,而非主密钥。 若密钥缺失或错误,系统将无法启动,且不会在后台自动替换密钥。请同时保留 盐值元数据和主密钥以备恢复之用。 所有工作区均源自同一主密钥;若主密钥遭泄露,将影响整个 安装环境。运行中的进程可解密机密信息。本工具并非硬件安全模块(HSM)或 密码密钥派生函数(KDF)。不接受使用任意人工设置的密码代替随机密钥。 在有计划的迁移 实施并验证之前,请保留现有安装中的现有密钥。删除 `vault.key` 或替换主密钥可能会导致 无法访问会话/签名密钥。请将加密备份与密钥分开存放,并 在隔离的环境中测试恢复功能。 --- # Telegram · 部署 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/ 可在 Windows、Linux、macOS 或 Docker 环境中将 TgWitness 作为服务运行,通过 HTTPS 访问,并支持备份和更新。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 可在 Windows、Linux、macOS 或 Docker 环境中将 TgWitness 作为服务运行,通过 HTTPS 访问,并支持备份和更新。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![部署与恢复](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **英语** · [俄语](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [乌克兰语](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [西班牙语](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [葡萄牙语(巴西)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [土耳其语](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [阿拉伯语](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [乌尔都语](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [हिन्दी](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [印尼语](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [越南语](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [简体中文](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md) ## 选择安装方式 若使用便携包,请从 GitHub Releases 解压 `TgWitness--windows-amd64-portable.zip`。若采用其他方法,请下载并解压源代码 ZIP 文件或克隆 代码库,然后在项目目录下运行以下命令: | 安装 | 开始 | 在后台运行吗? | | --- | --- | --- | | Windows 便携版 | `TgWitness.cmd` | 不;请保持窗口打开。 | | 原生 Windows 版 | `Start.cmd` | 不;请使用可选的登录任务以实现后台运行。 | | 原生支持 Linux/macOS | `sh start.sh` | 不;请使用 systemd/launchd 进行后台运行。 | | 在任何受支持的主机上运行 Docker | `docker compose up -d --build --wait` | 是的,只要 Docker 守护进程正在运行。 | | Windows 版 Docker 辅助工具 | `scripts\Docker.cmd` | 是的;该辅助程序会等待 Web 服务器的运行状态。 | | Linux/macOS 上的 Docker 辅助工具 | `sh scripts/docker-start.sh` | 是的;该辅助程序会等待 Web 服务器的运行状态。 | 关于第三方应能进行核查的云服务器——该服务器通过 服务商的 API 创建,不使用 SSH,仅可通过 Cloudflare Tunnel 访问——请参阅 [“高可信度部署”](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/)。 原生启动程序会生成一个私有`.venv`,并安装已固定的依赖项。 Docker会在镜像内部构建这些依赖项,无需主机端的Python。首次 设置需要互联网连接。 若未检测到 Python 3.11 及以上版本,`Start.cmd` 会在 为当前 Windows 用户安装 Python 3.12 之前征得用户同意(使用 winget,否则在验证 Python 软件基金会签名后使用 python.org 安装程序);该过程绝不会请求 管理员权限。Docker 和操作系统服务仍是必备条件。 原生和便携式安装会在其文件夹内使用 `data/live`。Docker 则使用名为 `tgwitness-data` 的卷 位于 `/data`。在您刻意迁移 完整数据目录之前,这些属于独立的安装实例。请勿期望新的 Docker 容器能自动发现原生 账户。 ## 安装要求 原生安装需要 Python 3.11 或更高版本,并包含 `venv` 和 `ensurepip`;首次安装依赖项时需要 互联网连接;以及一个可供 `.venv` 写入的项目目录。捆绑的控制面板无需 Node.js 或前端构建。请从 您的常规操作系统账户运行启动器;TgWitness 不需要管理员/root 权限。 - **Windows:**`Start.cmd` 会先检查 `py -3`,然后是 `python`,接着是默认的用户级和 Program Files 安装文件夹,并要求系统版本为 3.11 或更高。如果以上路径均无效,它 将提供上述所述的自动用户级安装选项。`py -3 start.py` 同样有效。 便携版完全不需要 Python。 - **Linux:**`start.sh` 会依次尝试 `python3.13`、`python3.12`、`python3.11`、`python3` 和 `python`,若均不匹配,则会输出适用于 apt、dnf、pacman、zypper、apk 或 Homebrew 的安装命令。 Debian/Ubuntu 系统可能需要安装与所选解释器匹配的 `python3-venv` 软件包。 发行版中较旧的 默认 Python 必须被 Python 3.11 及以上版本替换或补充。 - **macOS:**请安装最新的 Python 3.11+ 发行版;请勿假设操作系统自带的 解释器符合要求。请使用项目目录中的 `python3 start.py`。 - **Docker:**请使用搭载 Compose v2.20 或更高版本的 Docker Engine/Desktop。在 Windows 系统上,Docker Desktop 必须使用 Linux 容器。该容器会自行安装 所需的 Python 依赖项;主机无需单独安装 Python。 ## 本地计算机 在 Windows 系统上使用 `Start.cmd`,在 Linux/macOS 系统上使用 `sh start.sh`。`scripts\Setup.cmd` 或 `sh start.sh --setup-only` 可用于 准备运行环境。启动程序在首次使用时会安装依赖项;后续启动 将复用该环境。设置和 Telegram 消息采集需要互联网连接, 但浏览现有记录和生成导出文件可在离线状态下进行。 设置完成后运行 `python start.py --check`,可在不启动收集器的情况下检查本地依赖项、Ed25519、 存储、密钥配置及监听地址。 使用 `--json` 获取结构化输出。传入预期的 `--data-dir`、`--host` 和 `--port`。此检查不会安装软件包、创建日志或连接 Telegram; 它并非完整性或覆盖范围的资格认证。启动时会单独验证 现有日志。`python start.py --help` 同样无需安装。 运行 start.py 后,请在 Windows 系统上使用 `.venv\Scripts\python.exe`,在 Linux/macOS 系统上使用 `.venv/bin/python` 执行辅助命令,或者先激活该环境。 下文中的 `python -m ...` 示例假设该环境已处于活动状态。 ``` python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787 ``` 环境变量:TGWITNESS_DATA、TGWITNESS_HOST、TGWITNESS_PORT、TGWITNESS_TOKEN。 TGWITNESS_VAULT_KEY_FILE 用于在新安装中选择外部密钥模式;请参阅[外部主密钥](https://phishdestroy.io/tgwitness/zh/docs/reference/security/#external-master-key)。 若提供 TGWITNESS_TOKEN,其长度必须至少为 24 个字符;请使用加密 生成的随机值。若未提供,应用程序将在 panel-token.txt 中生成一个 256 位的随机令牌。 环境变量覆盖不会重写该文件。请重启以轮换凭据。 数据目录仅允许一个进程拥有。跨平台操作系统文件锁机制可防止 意外的并发写入。请使用一个 Uvicorn 工作进程。控制面板可管理任意数量的 工作区,额外的工作区目录位于 profiles// 下。 对于独立的服务实例,请使用独立的目录和端口。SQLite WAL 文件应存储在本地持久化 存储中,而非网络文件系统中。请勿在副本之间共享同一卷。 ## Windows 便携版 每个 GitHub 发布版本都包含 `TgWitness--windows-amd64-portable.zip` 及其 `.sha256`。其中包含来自 python.org 的官方可嵌入式 Python 3.12 运行时 (校验和固定在 `tools/build_portable.py` 中)、TgWitness 及其固定依赖项, 以及三个启动器: | 文件 | 目的 | | --- | --- | | `TgWitness.cmd` | 启动面板;额外选项将被直接传递,例如 `TgWitness.cmd --port 8790` | | `TgWitness-Demo.cmd` | 在 `data\demo` 启动合成演示 | | `TgWitness-Check.cmd` | 在不启动的情况下运行就绪性检查 | 已将固定的俄语形态学词典和 PDF 颜色配置文件打包,以便 离线使用。打包仅允许在依赖项 `data` 目录内包含其已知的文件路径;若这些目录中出现意外文件,将导致构建失败。 将整个压缩包解压到可写入的文件夹中,例如 `Documents\TgWitness`;请勿 在 ZIP 文件内部或 Program Files 文件夹中运行该程序。运行时使用隔离的模块路径, 因此其他 Python 安装以及 `PYTHONPATH` 均不会对其产生影响。 数据保存在 该软件包的`data`文件夹中。若需更新,请停止 TgWitness,将新版本解压到一个新的 文件夹中,然后将`data`文件夹复制过去。 在 64 位 Windows 系统上使用 Python 3.12 自行构建: ``` python tools/build_portable.py ``` ## 容器 ``` docker compose up -d --build --wait ``` 这将为 /data 创建一个命名持久卷。 Web 端口映射至 127.0.0.1:8787。该进程以 UID 10001 身份运行,且已移除 权限,根文件系统为只读,而 /data 和 /tmp 目录可写。 `--wait` 会在返回前检查 Web 服务器的运行状态;Telegram 授权和 消息投递情况将显示在控制面板中。提供的辅助程序在构建完成后采用 180 秒的就绪超时 设置。初始依赖项的下载可能需要更长时间。 两个基础 Compose 文件均使用项目名称 `tgwitness`,因此将新版本 解压到另一个目录时,系统不会自动选择新的数据卷。请确保该项目仅有一个 部署处于活动状态。对于独立安装,请使用唯一的 `docker compose -p NAME ...` 以及不同的主机端口,并在更新时保留这两个配置。 对于使用不同项目名称的旧部署,请继续使用其原始 名称并添加 `-p`;`docker compose ls` 会列出现有项目。 将 `deploy/env.example` 复制到 `.env`,并将 `TGWITNESS_PORT` 修改为使用不同的回环 端口。例如,`TGWITNESS_PORT=8788` 将控制面板暴露在 `http://127.0.0.1:8788`;容器仍监听 8787 端口。`.env` 被 Git 忽略。 获取初始令牌: ``` docker compose exec tgwitness cat /data/panel-token.txt ``` 常用命令: ``` docker compose ps docker compose logs --tail 100 -f docker compose stop docker compose up -d --wait ``` `restart: unless-stopped` 会在收集器崩溃或 Docker 守护进程 重启后自动重启收集器。在 Linux 服务器上,请使用您所用发行版的 服务管理器(通常为 `sudo systemctl enable --now docker`)启用 Docker 自动启动。在 Windows/macOS 上,请启用 Docker Desktop 的“登录时启动”设置。桌面注销、休眠或 Docker Docker 守护进程都可能中断数据采集。明确停止的容器将保持 停止状态,直到您再次启动它。 在示例配置中,/tmp 分区的上限为 512 MiB。导出构建 改在持久化分区 /data 上使用每个工作区的 `temporary-exports/` 目录。请在此处预留空间 以满足同时进行的导出操作、日志/WAL 增长、媒体文件及备份的需求。 启动器使用 deploy/constraints.txt 来锁定符合条件的运行时依赖项版本。 Docker 和高保障服务器根据 deploy/requirements.lock 和 deploy/build.lock 文件,使用 pip --require-hashes 进行安装:每个包文件必须与提交记录中的 SHA-256 值相匹配,因此若 PyPI 或镜像站点上的文件被替换,则会被拒绝。 仅提供源代码的 包(如 jieba、pyaes)由启动器、Windows 可移植构建器及 Dockerfile 使用 deploy/build.lock 中锁定的 setuptools(`--no-build-isolation`)进行构建, 因此 pip 不会解析一个单独的、未锁定的构建环境。 Python 基础 镜像和操作系统软件包仍需通过独立的发布资格认证。 除非您打算销毁日志和密钥,否则请勿使用 `docker compose down -v` 命令。 容器健康状况报告反映的是 Web 服务器的可用性,而非 Telegram 捕获是否成功。 请检查控制面板中的采集器状态、心跳、错误及覆盖事件。 ### 独立见证者简介 可选的`witness`服务在其自身的 容器中运行一个[独立见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/),该见证人在`witness-data`卷中拥有自己的密钥和日志,并仅向收集器提供一个只读 的见证令牌。在控制面板的**更多工具→扩展功能→独立见证人**下创建该令牌,将其 与机器人令牌和频道一起添加到`.env`中,然后启动配置文件: ``` docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag docker compose logs witness # witness key fingerprint ``` 该服务通过 Compose 网络内的收集器访问,地址为 `http://tgwitness:8787` (`TGWITNESS_WITNESS_COLLECTOR` 会覆盖该地址,例如 `/profiles/` 用于 另一个工作区)。若要使用由他人运行的独立服务器上的见证文件,请在该服务器上使用 `deploy/compose/compose.witness.yaml` ,并将 `TGWITNESS_WITNESS_COLLECTOR` 设置为收集器的 HTTPS 地址;该文件仅包含见证文件。 ## 安装已发布的镜像 将 `deploy/env.example` 复制到 `.env`。将 `TGWITNESS_IMAGE` 设置为发布版本,使用 **小写形式的**仓库路径,例如: ``` TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3 TGWITNESS_PORT=8787 ``` 请单独运行此文件,而非运行 `compose.yaml`: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt ``` 主机上无需源代码构建、Python 或编译器。发布工作流 针对 Linux AMD64 和 ARM64 容器,包括 Docker Desktop 的 Linux 虚拟机。 请使用版本标签或工作流摘要中的 `ghcr.io/owner/repository@sha256:...`。 未配置`latest`标签的动态更新或无人值守的应用程序升级。当 项目名称相同时,镜像和源代码变体将使用相同的数据卷。 ## 服务器上的自动 HTTPS 配置 请使用搭载 Docker 的服务器、您自行管理的域名以及持久的本地存储空间。 将域名的 A/AAAA 记录指向该服务器;仅当 IPv6 可访问该服务器时才发布 AAAA 记录。 允许入站 TCP 80 和 443 端口,以及用于证书签发的出站 DNS/HTTPS 流量。 其他服务不得已占用这些端口。 将 `deploy/env.example` 复制到 `.env`,并设置主机名(不包含协议或路径): ``` TGWITNESS_DOMAIN=watch.your-domain.org ``` 使用 HTTPS 覆盖层开始源代码构建: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt ``` ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait ``` 对于已发布的图像,请改用 `deploy/compose/compose.image.yaml` 作为第一个文件。保留 两个 `-f` 参数,以便后续使用状态、日志、更新和停止命令。 Caddy 负责获取和续期证书,将 HTTP 重定向至 HTTPS,并将 请求转发至私有 Compose 网络上的收集器。证书状态 拥有独立的持久化卷。收集器的直接主机端口仅限回环访问。 提供的 Caddy 配置未启用访问日志记录。 打开 `https://watch.your-domain.org` 并输入面板令牌。准备就绪性 涵盖容器;证书签发和外部可达性取决于 DNS 和防火墙。如果 HTTPS 尚未就绪,请检查 DNS、防火墙规则以及: ``` docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy ``` 提供的 Caddy 镜像遵循其 `2-alpine` 标签。拉取操作会刷新该镜像; 若需固定基础设施版本,请在部署中固定一个经过测试的摘要。 ## 更新与备份 在更新过程中保留 Compose 项目名称和数据量。首先停止 收集器并进行完整备份。对于默认的基于源代码的部署: ``` docker compose stop docker compose cp tgwitness:/data ../tgwitness-backup-before-update ``` 每次请使用存储库之外的新备份目标,并将其作为 账户访问材料加以保护。示例路径仅供参考;请使用您自己的私有备份 位置。复制整个目录,包括隐藏文件、所有工作区、密钥、 日志和媒体文件。如果已配置外部保险库主密钥,请将其单独备份。 证据 ZIP 文件并非可恢复的应用程序备份。对于 HTTPS,若需保留其证书/账户状态,还应保留 Caddy 卷。 若要进行源代码部署,请获取最新发布文件并运行: ``` docker compose up -d --build --wait ``` 若需部署镜像,请将 `TGWITNESS_IMAGE` 替换为所需版本,然后运行: ``` docker compose --project-directory . -f deploy/compose/compose.image.yaml pull docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait ``` 请也使用您安装环境中的 Compose 文件来执行上述停止/复制命令。 请保留 `.env`、自定义配置以及相同的项目名称。`down` 会保留命名 卷;**`down -v` 会将其删除**。请勿在不同操作系统 或 Python 版本之间复制 `.venv`。若需进行原生更新,请先停止 TgWitness,备份其完整数据 目录,替换源文件,并在启动前运行 `python start.py --setup-only`。 在更新后检查面板访问权限、账户身份、观察状态及覆盖范围。 重启后,TgWitness将恢复保存的Telegram更新位置,并 请求更新过程中遗漏的更新内容。如果未来版本更改了存储格式, 回滚可能需要使用更新前的备份。 ## 远程服务器 请将服务限制在回环接口内并使用 SSH 隧道,或在 反向代理处终止 HTTPS 连接。基础 Compose 文件仅限本地使用;可选的 `deploy/compose/compose.https.yaml` 覆盖层提供 Caddy 以支持配置好的域名。 请勿在 URL 和代理日志中暴露承载令牌。反向代理应限制 请求大小和连接速率。请勿将明文 HTTP 暴露到互联网上。 [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) 目录中提供了 systemd、Windows 登录任务、macOS 用户代理以及 Caddy 的示例。 安装前请审查并调整其路径。 这些仅为模板,并非本地执行的平台配置。常规启动程序不会 注册任何后台服务或任务。 在 Windows 系统上,以无窗口模式启动 `pythonw.exe` 时,启动/服务器诊断信息将存储在 数据目录下的 `logs/server.log` 中(每文件 5 MiB,包含两个轮换备份)。 控制台模式启动时会保留控制台日志。两种模式下 均禁用 HTTP 访问日志记录。请将日志与数据目录一同保护,并在共享前进行审查。 ## 重启与数据缺失 系统会保留上次请求的监控状态。如果监控处于活动状态, 启动时将尝试重新连接并恢复所选消息源。手动暂停会清除 该意图。重启失败的情况会被记录并显示在面板中。 TgWitness 将该账户及每个频道的 Telegram 更新位置 (pts、qts、seq 和 date)存储在工作区保险库中,并在下次启动时恢复。 随后,客户端会请求进程停止期间错过的更新,而 定期重新检查会恢复错过的消息,并记录 Telegram 已不再 返回的已保存消息。对话框会在启动时重新加载。 每次启动都会记录上一次的 日志头、离线边界以及恢复时的更新位置。 监控程序每10秒检查一次连接状态,并每分钟发送一次心跳 (**更多工具 → 参数 → 每隔一次记录活跃状态**)。 断开连接和静默期将作为覆盖缺口记录,并附带原因说明。 历史快照作为独立的当前历史观测结果,与实时记录并存。 媒体队列存储在每个工作区的 SQLite 数据库中。消息及其任务 将原子提交。中断的运行中任务将在启动时恢复并重试。 每次下载有120秒的基础超时,外加按256 KiB/s 速率计算的文件大小所需时间,以及 每种附件类型有 1–2,000 MiB 的限制;超时、速度和重试设置位于**更多工具 → 参数中**。收集器 会跳过大小未知的文件。暂停操作会保留队列中的任务。重试使用原始的 已观察到的文件描述符,绝不会使用后续编辑消息的最新版本。 临时故障有重试次数限制;媒体 FloodWait 暂停状态在重启后仍会保留。 媒体恢复与 Telegram 更新恢复是分开的,无法重建已消失的文件。 ## 备份、恢复与容量 `tgwitness backup FOLDER` 会在控制面板持续运行的同时复制数据目录: 先复制检查点,然后通过在线备份 API 复制 SQLite 文件,接着复制键、媒体和 配置文件,因此任何被复制的检查点都不会比被复制的日志更新。`backup-manifest.json` 列出了每个文件的 SHA-256 值以及日志头。 要恢复,请停止 TgWitness 并用该文件夹替换 整个数据目录。下次启动时会记录日志是从较旧的副本中恢复的 。该记录会将日志与存储在 `TGWITNESS_STATE_DIR` 中的日志头进行比较,该目录位于数据目录之外:即 Compose 中的 `tgwitness-state` 卷、systemd 单元中的 `/var/lib/tgwitness-state` ,以及其他情况下的用户本地状态文件夹 。如果没有可写状态文件夹,则无法检测到恢复操作,日志会记录一次相关提示。 如果不执行该命令,请在复制**整个数据目录**(包括 vault.key、 signing.enc、credentials.enc、SQLite 数据库/WAL 文件、media、token、checkpoints 以及所有 profiles/ 子目录)之前停止该进程。 在目标服务停止运行时 还原完整的副本。若保险库密钥缺失或 签名密钥不匹配,将导致启动失败;请勿通过重新生成密钥来强制访问。 请将秘密备份加密并设置访问控制。证据 ZIP 文件便于携带, 用于审查证据文件,而非应用程序备份或 Telegram 会话备份。 本工具不支持自动保留和删除功能。请预留足够的磁盘空间,以存储所有消息、原始 元数据、媒体文件、临时导出文件及备份。 启动时进行验证,并导出流记录而非加载整个日志。 导出操作会锁定读取快照,同时新的 WAL 写入仍可继续;长时间运行的导出 会保留 WAL 页面,因此磁盘容量依然重要。 ZIP 文件大小上限为 4 GiB (未压缩),以匹配独立验证器的默认设置;**通过更多工具 → 参数 → 最大签名 ZIP** 可提高上限,此类归档文件可通过 `verify.py --max-gib N` 进行验证。其他格式没有事件计数上限。 受支持的浏览器会将响应块流式传输到用户选定的文件中。其他浏览器 最多缓冲 128 MiB,并将更大的传输重定向到经过身份验证的 CLI: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` 若要使用其他工作区,请从**“导出”→“工作区 ID**”中选用 `--profile ID`; 若要连接远程服务器,请选用 `--format zip|jsonl|csv|html` 或 `--url https://your-server`; 若要更改 5 GiB 的传输限制,请选用 `--max-mib`。仅允许在 回环连接中使用纯文本 HTTP。令牌通过请求头传输,拒绝重定向,现有文件 不会被覆盖,且未完成的下载不会作为已完成文件发布。 如果 TGWITNESS_TOKEN 覆盖了生成的令牌,请使用一个单独受保护的文件 来存储该有效值:panel-token.txt 不会被覆盖操作重写。 该命令的 SHA-256 仅作为传输校验和;请独立验证已签名的 ZIP 文件。 该面板显示队列中/失败的媒体文件、最旧的待处理媒体文件、可用磁盘空间、Telegram 请求暂停情况,以及访问状态未确认的来源。这些诊断信息并非 完整的端到端交付监控。工作区共享一个进程;一个活动频繁的账户仍可能 影响其他工作区。 独立的工作进程、数据保留/轮换、持久化更新 恢复以及完整的部署认证功能依然存在。控制面板的范围访问权限已在 [“访问与权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)”部分中记录;独立检查点相关内容详见《 [见证指南](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)》。 详细操作流程:[连接/安全](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/)设置及 [运行模式](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/)。 --- # Phala / Intel TDX · 高可信度部署 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/ 部署在 Hetzner 或 Phala Cloud 上的全天候密封服务器、网关 DNS 以及第三方可复现的验证机制。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 部署在 Hetzner 或 Phala Cloud 上的全天候密封服务器、网关 DNS 以及第三方可复现的验证机制。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [部署与恢复](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) ![部署与恢复](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) 高可信度部署在 归档验证基础上增加了对采集环境的独立检查。审核人员会查询云服务提供商和 Cloudflare 持有的部署及访问记录,而 Intel TDX 部署还会对采集器的环境进行 硬件认证。 常规的本地和 Docker 使用方式保持不变。除非您使用 `python -m tgwitness.cloud`进行部署,且收集器仅在部署设置为 `TGWITNESS_ASSURANCE`. 流程图 · 操作员 → 服务器,防火墙未配置入站规则 (提供商 API); 操作员 → 隧道与 DNS (Cloudflare API); 服务器,防火墙未配置入站规则 → 隧道与 DNS (仅限外发); 服务器,防火墙未配置入站规则 → 在服务器上生成的签名密钥; Verifier,只读令牌 → 提供商日志和防火墙; Verifier,只读令牌 → 隧道连接器地址和入口; Verifier,只读令牌 → 已签名的 /api/assurance 声明; Verifier,只读令牌 → 证据 ZIP · 操作员 · Verifier,只读令牌 · 服务器,防火墙未配置入站规则 · 提供商日志和防火墙 · 隧道连接器地址和入口 · 已签名的 /api/assurance声明 · 证据 ZIP · 隧道与 DNS · 在服务器上生成的签名密钥 · 提供商 API · Cloudflare API · 仅限外发 **图表转为文本** 1. 操作员 → 服务器,防火墙未配置入站规则 (提供商 API) 2. 操作员 → 隧道与 DNS (Cloudflare API) 3. 服务器,防火墙未配置入站规则 → 隧道与 DNS (仅限外发) 4. 服务器,防火墙未配置入站规则 → 在服务器上生成的签名密钥 5. Verifier,只读令牌 → 提供商日志和防火墙 6. Verifier,只读令牌 → 隧道连接器地址和入口 7. Verifier,只读令牌 → 已签名的 /api/assurance 声明 8. Verifier,只读令牌 → 证据 ZIP **本页内容** - [验证者可以检查的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#what-a-verifier-can-check) - [提供商](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#providers) - [Phala Cloud 上的机密虚拟机(Intel TDX)](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) - [开始之前](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#before-you-start) - [来自面板](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#from-the-panel) - [无需域名的快速隧道](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#quick-tunnel-without-a-domain) - [部署](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#deploy) - [调试部署与锁定](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#debug-deployment-and-lock) - [移除部署](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#remove-a-deployment) - [任意服务器(自我认证)](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#any-server-self-attested) - [验证](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#verify) - [证据移交报告](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#report-for-evidence-handover) - [Cloudflare 作为外部见证方](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#cloudflare-as-an-outside-witness) - [阅读部署结果](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#reading-the-deployment-result) ## 验证者可以检查的内容 | 声明 | 如何进行验证 | 维护者: | | --- | --- | --- | | 该服务器是在已知时间点通过服务商 API 创建的 | 服务器对象及其在提供商自有日志中的创建过程 | 提供商 | | 没有人使用该提供商的访问路径 | 控制台请求、救援、密码重置、重建、ISO、镜像和备份的日志 | 提供商 | | 无法连接到它 | 提供商防火墙没有入站规则;SSH 服务在首次启动时即被屏蔽 | 提供商(防火墙)、主机(SSH) | | 该面板仅可通过隧道访问 | 隧道入口仅将流量转发至控制面板;连接器从服务器地址运行 | Cloudflare | | 该软件的运行情况如下: | 收集器的签名源代码树哈希值与已部署提交的检出结果相等 | Collector,已与 Git 进行过校验 | | 该签名密钥是在该服务器上生成的 | 该密钥会签署一份声明,其中包含服务提供商的服务器 ID 以及收到的 cloud-init 的哈希值 | Collector,已与提供商进行过核对 | | 该日志属于该密钥和服务器 | 证据ZIP中的每个进程启动时,都会携带该服务器的宿主测量数据 | 证据 ZIP | | Telegram密钥是在经过验证的运行中生成的 | `account.authorized`记录`key_origin: "created"` | 证据 ZIP | 收集器将 SSH 状态、会话、登录历史记录和启动信息记录在经过签名的 process-start 和 `host.state` 记录中。在普通虚拟机上,这些是本地库存 记录,审核人员会将其与提供商的独立记录进行比对。下文所述的 英特尔 TDX 部署还会额外验证基于硬件的测量结果。 经过认证的部署不会基于导入的会话密钥进行数据收集。可通过手机或 二维码登录,或使用会话文件进行独立登录:无论采用哪种方式,Telegram 授权密钥均在经过认证的运行环境中生成,日志会记录 `key_origin: "created"`,且 `python -m tgwitness.cloud verify` 命令会通过 `account_key` 验证。使用导入密钥的日志将无法通过该验证。 ## 提供商 | `--provider` | 凭据 | 验证员的只读访问权限 | 验证器的提供者日志 | 保留用于 | | --- | --- | --- | --- | --- | | `hetzner` | `HCLOUD_TOKEN` | 同一项目的读取令牌 | 服务器和防火墙操作 | 只要这些资源存在 | | `digitalocean` | `DIGITALOCEAN_TOKEN` | 只读个人访问令牌 | Droplet 操作 | 只要 Droplet 存在 | | `linode` | `LINODE_TOKEN` | `linodes`, `firewall`, `events` 只读范围 | 账户事件、防火墙规则版本 | 90 天 | | `vultr` | `VULTR_API_KEY` | 具有读取权限且拥有 `activity_logs` 权限 | 账户活动日志(方法、路径、操作者) | 30 天,订阅审计日志可延长保存期限 | | `aws` | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | `ec2:DescribeInstances`, `ec2:DescribeSecurityGroups`, `cloudtrail:LookupEvents` | CloudTrail 事件历史记录 | 90 天 | | `phala` | `PHALA_CLOUD_API_KEY` | 同一工作区的 API 密钥 | 应用程序修订与 CVM 操作:Docker Compose 配置和环境变更、重启、操作系统升级 | 虽然该应用程序已存在 | | `generic` | 无 | 无 | 无:**自我认证** | – | 请为每个案例使用专用的项目、团队、账户或子账户:这样,验证者的 只读访问权限将仅显示此部署。凭据从 `--provider-token-file` 或上述变量中读取,绝不从命令行获取。对于 AWS,该文件 包含 `ACCESS_KEY_ID SECRET_ACCESS_KEY [SESSION_TOKEN]`;区域为 `--location`. 每份报告均说明了各服务商记录的范围。 简而言之:Hetzner 会记录控制台请求;DigitalOcean 的恢复控制台、Linode 的 Lish/Glish 以及 Vultr 的 Web 控制台不会被直接记录,因此 root 账户在首次启动时会被锁定,若要登录控制台 则需要重置密码或更改启动方式,而这些操作会被记录。Vultr 会向任何能够读取该实例的密钥返回控制台 地址;但记录和报告中均不会存储该地址。 ## Phala Cloud 上的机密虚拟机(Intel TDX) 该 `--provider phala` 收集器运行在 [Phala Cloud](https://phala.com/) 上的英特尔 TDX 机密虚拟机中, 由 dstack 管理。主机和 Phala 工作人员无法读取其 内存,且处理器会对机器的启动过程生成一份认证声明并进行签名。验证器不会 仅凭 Phala 的声明就予以采信: `tgwitness.tdx` 会自行核查每份证明——直至固定的英特尔 SGX 根证书颁发机构(Root CA)——并将其与英特尔的撤销列表及英特尔签名的平台数据进行比对,同时拒绝 任何可被调试或迁移的机器。 | 报告条目 | 功能展示 | | --- | --- | | `tdx_binding` | 该证明涵盖了收集者的签名声明以及本次请求的随机值。 | | `tdx_quote` | 英特尔对该认证负责;只有当英特尔将该平台评定为“最新”时,该认证才算通过。 | | `tdx_compose_hash` | RTMR3 通过重放 dstack 事件日志,对收集器报告的 app-compose 进行测量 | | `tdx_compose` | 该代码与已部署提交生成的代码字节对字节完全一致:源文件通过哈希值固定,两张图片均通过摘要固定,不存在其他代码 | | `tdx_identity` | 该证明来自已部署的应用程序和实例,使用 Phala 的 KMS 提供的密钥以及加密磁盘。 | | `tdx_os` | MRTD 和 RTMR0-2 的值等于验证器根据 Dstack-TEE 发布的 dstack 操作系统镜像计算得出的值,该值通过 CVM 报告的操作系统镜像哈希以及 QEMU 根据虚拟机配置生成的 ACPI 表确定:固件、内核、initrd、包含根文件系统哈希的命令行、内存、vCPU 和设备。开发镜像将导致验证失败 | 操作系统镜像(约 180 MB,其中保留 21 MB)从 [Dstack-TEE/meta-dstack](https://github.com/Dstack-TEE/meta-dstack/releases) 下载一次至 记录旁边的 `dstack-images` ;`--tdx-image FOLDER` 用于指定另一个文件夹或解压后的镜像, `--tdx-image none` 则跳过比较。 测量遵循 Dstack-TEE/dstack 中的 `dstack-mr` 和 `qemu-acpi` 模块。私有测量回归测试会比较 QEMU 自身的 ACPI 输出与保留的 Phala Cloud 引用;现场认证还需使用已发布的镜像。 `--tdx-measurements` 仍会比较 MRTD 和 RTMR0-2 ,但这些数据以 JSON 格式提供。 日志中记录的每次收集器启动都附有此类证明,因此 `verify --evidence` 会检查每次启动及其引导的操作系统镜像。Phala 的应用程序修订版本 和 CVM 的操作充当提供商日志:部署后 Docker Compose 配置的任何更改 都会导致报告失败,且重启记录将被列出以供审查。 在面板中,选择**更多工具→扩展功能→“24/7 服务器** ”下的**“机密虚拟机 · Phala Cloud** ”,并粘贴 Phala Cloud API 密钥;快速隧道的工作方式与 Hetzner 上相同。在命令行中: ``` python -m tgwitness.cloud deploy --provider phala --name case-1 --server-type tdx.small \ --ref v0.8.0 --repository https://github.com/phishdestroy/TgWitness --quick-tunnel \ --provider-token-file phala-key.txt python -m tgwitness.cloud verify --record deployments/case-1/deployment.json \ --provider-token-file phala-key.txt --cloud-init deployments/case-1/docker-compose.yaml \ --source CHECKOUT_OF_COMMIT --fingerprint COLLECTOR_FINGERPRINT --report certificate.md python -m tgwitness.cloud check-report --report certificate.pdf --verifier-fingerprint VERIFIER_KEY ``` `--tdx-collateral` 从文件中读取英特尔的证书和撤销列表,而不是 从英特尔下载。此处无法使用网关 DNS:Phala 没有用于 出站流量的提供商防火墙。 `verify --source` builds the reference installer from your checkout, which runs that checkout's code on this computer. For a deployment made from a repository other than the official one, `verify` refuses unless you also pass `--trust-source`; do so only for a checkout you have read. ### 使用 verify.py 进行离线验证 没有 Phala 账户的接收者可通过独立验证器离线验证报价: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_FINGERPRINT python verify.py phala-tdx-attestation.json ``` 对于证据存档中每条 `process.started` 记录的引用,以及 签名收集器声明的引用(也包含在部署记录或已发布的证明记录中), `verify.py` 会使用其证明密钥验证引用的 ECDSA P-256 签名,并使用 PCK 证书验证引用 安全区报告的签名,以确保该报告指明了证明密钥 (即密钥与 QE 认证数据的 SHA-256 值),确认该报告源自处于生产模式的英特尔 TDX 引述 安全域,并验证证书链 PCK 证书 → 英特尔 SGX PCK 平台或处理器 CA → 英特尔 SGX 根 CA,其 SHA-256 值已在 `verify.py` 中固定。该脚本拒绝可调试或 可迁移的 TD,验证 REPORTDATA 是否为起始记录(日志密钥、运行、源 树、主机)或已签名语句的 SHA-512 值,并输出 MRTD、RTMR0-3 及 REPORTDATA。 当英特尔服务响应时,收集器还会随每次报价存储英特尔的担保信息(TCB 信息、QE 身份、撤销列表及其 签发者链)。借助这些信息,`verify.py`会验证英特尔的 签名和撤销列表,并计算截至记录时间或 担保信息签发日期(以较晚者为准)的 TCB 状态。 若缺少这些信息,结果将显示为“TCB 状态未 经过验证(归档中无担保信息)”。虚拟机运行的代码(由 compose RTMR3 度量,以及 MRTD 和 RTMR0-2 背后的操作系统映像)、提供商日志和英特尔的当前评级仍由 `python -m tgwitness.cloud verify` 进行验证;因此,离线验证将该经认证的收集运行 标记为“部分完成”,且其本身无法达到 `sealed` 级别或 `attested` 配置文件。 ### 认证证书 对于 Phala 部署,`verify --report certificate.md` 还会写入证书:一个 自包含的 `certificate.html` 文件和一份 A4 规格的 `certificate.pdf` 文件,其中包含验证结果、从英特尔根证书到收集器密钥的信任链、 与普通服务器及高保障服务器的对比分析、 与基于已发布镜像计算出的数值并列的测量结果、各部分的担保方、 英特尔证书链、每项检查、提供商日志,以及如何重复进行 验证。 JSON 报告仍是权威记录;这些页面仅用于呈现其内容。 该报告已通过签名和时间戳进行数字封存,封存文件为 `certificate.seal.json` 及其旁边的 `.tsq`/`.tsr` 文件: | Seal | 新增功能 | | --- | --- | | 合格电子时间戳,`http://tsa.belgium.be/connect` | RFC 3161 时间戳基于比利时联邦政府合格信任服务提供商(FPS 政策与支持局,BOSA)提供的 `certificate.json` 的精确字节数据。 该机构被列入比利时欧盟可信列表,状态为“已授予”,属于合格时间戳服务;截至 2026 年 10 月 20 日发布的列表,其根证书(比利时根 CA6)及列表条目均被固定在 `tgwitness/tsa_roots.py` 中。 根据《欧盟法规》第 910/2014 号第 41 条,此类时间戳在所有欧盟成员国中,其日期、时间以及数据完整性均被推定为准确。 | | RFC 3161 时间戳,FreeTSA | 第二个独立的时间戳 | | 验证器签名 | Ed25519 基于一条声明对报告的 SHA-256 值和每个时间戳进行签名,使用验证者自身的密钥(`--sign-with FOLDER`,默认 `~/.tgwitness/verifier`);PDF 文件带有由同一密钥生成的签名 | `--timestamp URL`(可重复)选择其他认证机构,`--timestamp none` 不选择任何机构,`--sign-with none` 不对印章进行签名。`check-report` 会验证报告的哈希值、验证者签名、 每个时间戳与受信任根证书的关联及其合格状态,以及 PDF 文件的签名。 在欧盟以外地区, 合格时间戳以及报告整体的法律效力,由接收它的法院 或主管部门决定;该印章表明报告的生成时间以及其内容未被篡改。 该证明依赖于英特尔的 TDX 模块和微代码,以及 内存总线的物理完整性。无论谁控制 Phala 账户中的应用程序,均可部署另一个compose; 它将作为具有新compose哈希值的新修订版本出现。主机控制着机器的 时间源和网络。 部署并通过 `--evidence`、重启、操作系统镜像比对、密封证书及销毁等操作均已在 Phala Cloud 平台本身上运行;参见 [2026 年 11 月 4 日的运行记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/#live-phala-cloud-deployment--4-november-2026)。11 月 9 日,一次部署从一个活跃的 Telegram 账户中收集了数据;其中一次运行使用了在虚拟机内部生成的会话密钥。参见[活跃账户的运行记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/#phala-cloud-with-live-telegram-account--9-november-2026)以及[在虚拟机中生成的密钥](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/#session-key-created-inside-the-tdx-vm--9-november-2026)。 ## 开始之前 1. 一个 Cloudflare 区域、其账户 ID 以及一个具有 **Cloudflare Tunnel 编辑**、 **区域读取**和 **DNS 编辑权限的** API 令牌,由 `--cloudflare-token-file` 或 `CLOUDFLARE_API_TOKEN`。对于验证者:**Cloudflare Tunnel 读取**、**DNS 读取**,以及针对 审计日志的**账户设置读取**。若无域名, [快速隧道](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#quick-tunnel-without-a-domain)则无需上述任何信息。 2. 具有专用项目写入权限的提供商凭据; `lock` 同样使用: - Hetzner:具有读写权限的 API 令牌; - DigitalOcean:具有写入权限的个人访问令牌; - Linode:个人访问令牌,包含 `linodes`, `firewall` 和 `events` 读写权限; - Vultr:专用账户或子账户的 API 密钥; - AWS:允许使用 IAM 凭据 `ec2:DescribeVpcs`, `ec2:DescribeImages`, `ec2:CreateSecurityGroup`, `ec2:AuthorizeSecurityGroupIngress`, `ec2:RunInstances`, `ec2:CreateTags`, `ec2:DescribeInstances`, `ec2:DescribeSecurityGroupRules` 且 `ec2:RevokeSecurityGroupIngress`. 3. 待执行的提交。发布标签会通过以下方式解析为对应的提交: `git ls-remote`; 服务器仅接收该 40 个字符的提交信息。 ## 来自面板 在您的计算机上,**通过更多工具→扩展功能→“24/7服务器** ”可分三个 步骤为 Hetzner 运行相同的 `deploy` 操作:选择欧洲或美国,粘贴 Hetzner 令牌(读写权限),然后核对 控制面板根据该令牌检索到的服务器类型、月费、地址及版本。在您确认之前, 不会创建任何内容。 控制面板会显示`deploy` 报告的每个步骤,随后显示 IP地址、控制面板令牌以及签名密钥指纹。若未绑定域名,服务器将获得一个 [临时隧道](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#quick-tunnel-without-a-domain) ;**在您的服务器→查找当前地址中** ,重启后可再次查询该地址。若需在自有域名下使用固定IP地址,请打开 **“可选功能 · 自有域名** ”,并添加一个Cloudflare令牌(预设链接会自动选择区域 读取、DNS编辑和Cloudflare隧道编辑)。 这些令牌随每次请求从浏览器标签页传输至同一台计算机上的 TgWitness, 且不会被写入任何位置;部署记录、经过处理的 cloud-init、面板令牌以及 用于快速隧道的地址密钥均保存在 `deployments/NAME` 数据目录内。 面板仅通过直接回环连接向主管理员提供此功能 (`127.0.0.1`,不允许代理或隧道头部);通过网络访问的面板则会显示相关命令 。版本默认采用运行中面板的发布标签,该标签通过 GitHub API解析获得。位置、服务器类型和价格来自Hetzner的API: `cpx22` 在提供该服务的地方 使用该服务,否则使用内存至少为 2 GB 的最便宜 x86 类型。 ## 无需域名的快速隧道 `--quick-tunnel` 替换 `--zone`, `--cloudflare-account` 并 `--panel-host`;无需使用 Cloudflare 账户或令牌: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --quick-tunnel --provider-token-file hetzner.token ``` 在服务器端,cloudflared 会打开一条 [快速隧道](https://developers.cloudflare.com/tunnel/get-started/quick-tunnels/) 连接到控制面板:一个随机的 `https://….trycloudflare.com` 地址,该地址会在 cloudflared 或服务器重启时发生变化。服务器上一个小型服务会将每个地址发布到一个随机的 ntfy.sh 主题中,并使用仅部署目录中保存的密钥进行签名(HMAC-SHA256) (`address-key.txt`),并每三小时重复一次,因为 ntfy.sh 会保留帖子 12. `deploy` 和**“查找当前地址”**功能仅接受签名帖子,因此伪造的帖子无法 将您和您的面板令牌重定向到他人的地址。该主题记录在 已发布的 cloud-init 中:任何拥有这些信息的人都能读取当前地址,而该地址仍会要求提供 面板令牌。无论哪种方式,服务器均不保留任何入站端口。 验证器没有地址密钥,任何读取该主题的人都可以向其发布消息。因此,收集器 还会发布该地址本身,并使用其自身的 Ed25519 密钥进行签名;`verify` 会取部署记录中 由收集器密钥签名的最新发布消息;发布消息的排序依据是 ntfy.sh 接收它们的时间,而非它们声称的时间。 在此变更之前的收集器不会对任何内容进行签名,而 `verify` 随后会取最新的一条发布内容,并在 `statement` 检查中声明这一点;伪造的发布内容 只能导致该检查失败,因为该地址仍必须使用收集器的密钥进行响应。 成本:没有 Cloudflare 账户会记录快速隧道的日志,因此 `verify` 会报告 隧道、连接器和 DNS 检查不可用,结果至多为 `incomplete`(在 Phala Cloud上,检查则通过:连接器在被测的Compose环境中运行); 提供商记录、防火墙、签名声明、主机测量和安装程序比较均 按常规进行检查。与参考安装程序的字节比较需要一个已部署的提交 版本,该版本已包含`--quick-tunnel`;从0.7.0版本检出后,可构建域名安装程序并报告 差异。 Cloudflare 提供试用版快速隧道,允许200个 请求在传输中,且不传输服务器发送事件(Server-Sent Events),因此控制面板的实时更新(0.7.0 之后的版本) 可能无法通过快速隧道到达,需要重新加载页面;该部分尚未经过测试。对于 必须保持稳定的场景,请使用您自己的域名。 ## 部署 请先查看所有即将发送的内容。 `plan` 不会向任何服务提供商或 Cloudflare 发起请求: ``` python -m tgwitness.cloud plan --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org ``` 然后使用相同的选项和凭据进行部署: ``` python -m tgwitness.cloud deploy --provider hetzner --name case-2026-11 --server-type cpx22 \ --ref 0123456789abcdef0123456789abcdef01234567 --zone example.org \ --cloudflare-account CLOUDFLARE_ACCOUNT_ID --panel-host case.example.org \ --witness-host case-witness.example.org \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` 初始服务器类型: `cpx22` (Hetzner), `s-1vcpu-2gb` (DigitalOcean), `g6-standard-1` (Linode), `vc2-1c-2gb` (Vultr), `t3.small` (AWS)。 `--location` 以及 `--image` 默认使用各 服务商位于欧洲区域的 Ubuntu 24.04 系统。 `--repository` 从另一个 https Git 仓库获取提交,且 URL 中不包含凭据 (默认 `https://github.com/phishdestroy/TgWitness.git`). `deploy` 也接受 `--out` 指定其他部署目录(默认 `deployments/NAME`;若目录中已存在 部署则会被拒绝)以及 `--wait`,即等待收集器签署声明所需的分钟数: 1 到 240,默认值为 20,或 60 用于 `generic`. 命令: 1. 创建一个 Cloudflare 隧道,其入站流量将面板主机名转发至面板, 若已指定,则将见证主机名转发至 `/api/witness/head` 并 `/api/assurance` 且仅限该主机名; 2. 为这些主机名创建代理 CNAME 记录,并拒绝已存在的名称; 3. 创建一个不包含入站规则的提供商防火墙,并在其后部署一台服务器,该服务器不使用 SSH 密钥、 不进行备份、不使用控制台代理,且 cloud-init 会屏蔽 SSH、锁定 root 权限,并安装 `cloudflared`、精确获取该提交、验证并以 强化版 systemd 服务的形式启动 TgWitness; 4. 等待收集器发送的签名声明,并验证该声明是否指明了此服务器以及 此 cloud-init 的哈希值。 `deployments/case-2026-11/` 其中包含: | 文件 | 目录 | 分享? | | --- | --- | --- | | `deployment.json` | ID、哈希值、发出的 API 调用(方法、路径、状态)以及第一条已签名的声明 | 是的,通过验证器 | | `cloud-init.redacted.yaml` | 将云初始化脚本(cloud-init)中的两个密钥替换为 `REDACTED` | 是 | | `panel-token.txt` | 面板令牌 | 无 | 提供商的根密码、隧道令牌和面板令牌绝不会写入 `deployment.json`。请通过您无法单独控制的频道(例如见证频道或发送给收件人的消息)发布文末显示的收集器指纹。 请使用面板令牌登录 Telegram, `https://case.example.org` 使用面板令牌登录 Telegram,具体操作参见 [账户指南](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)。面板操作会被记录在已签名的日志中;这些操作并非 SSH 会话。[见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)可以轮询 `https://case-witness.example.org`. 不支持 SSH:如果初始化失败,收集器将永远不会响应。请删除服务器并 重新部署,或使用调试部署来查找原因。 ### 用户数据中的秘密 cloud-init 包含两个密钥:控制面板令牌和 Cloudflare 隧道令牌。 签名密钥不在此列;它是在服务器上生成的。Hetzner、DigitalOcean 和 Linode 不会通过其 API 返回用户数据。Vultr 会将其返回给任何能够读取 实例的密钥,而 EC2 则通过 `DescribeInstanceAttribute`。对于 AWS,仅向验证者提供表格中的三项 操作,切勿 `ec2:Describe*`。对于 Vultr,假设验证者的密钥可以读取这两个 令牌。隧道令牌允许某人运行第二个连接器: `verify` 这会报告任何 不在服务器上的连接器,且收集器的声明无法通过这种方式伪造,因为每一条 都会对新的挑战进行签名。使用 `--quick-tunnel` 第二个密钥则是地址密钥: 任何读取它的人都可以发布一个虚假地址,而控制面板会接受该地址。 该收集器的公开声明中未提及服务器地址和登录来源; 这两项信息均保存在已签名的日志中。 ## 调试部署与锁定 `--debug-ssh-key KEY --debug-ssh-from 198.51.100.4` 仅支持来自单一地址 或小型网络(IPv4 最多 /24,IPv6 最多 /48)的单个密钥的 SSH 连接。 `KEY` 已向 服务商注册:Hetzner 项目中 SSH 密钥的名称或 ID、DigitalOcean 团队中 SSH 密钥的 ID 或指纹、其个人资料中的 SSH 密钥已添加到 root 用户的 Linode 用户名、 Vultr 账户中 SSH 密钥的 ID,或该区域内 EC2 密钥对的名称。这些 选项不适用于 `generic`。此类部署将被记录为 `debug` ,且**绝不会**被报告为 高可信度。操作完成后,请运行 `sudo tgwitness-lock` 作为最后一次 SSH 会话的最后一条命令,然后: ``` python -m tgwitness.cloud lock --record deployments/case-2026-11/deployment.json --provider-token-file hetzner.token ``` 防火墙会丢失所有入站规则。随后生成的报告会显示何时允许了 SSH 连接以及何时 将其关闭;该窗口将保持可见状态。 ## 删除部署 `destroy` 删除服务器及其防火墙(通过部署标签定位),以便 中途失败的部署也会被移除,随后删除指向其 隧道的 DNS 记录以及隧道本身。服务器的日志和签名密钥将一并删除:请先导出 证据。记录将保留,并标记为 `removed`,并附有删除操作的API调用记录。 ``` python -m tgwitness.cloud destroy --record deployments/case-2026-11/deployment.json --confirm case-2026-11 \ --provider-token-file hetzner.token --cloudflare-token-file cloudflare.token ``` 针对 Hetzner,已通过 API 实现了内容删除功能。对于其他服务商 `destroy` 在删除任何内容之前 需先停止服务,并在服务商控制台中指定要删除的标签。手动安装的 服务器(`generic`)仅会丢失其隧道和 DNS 记录。快速隧道部署无需 Cloudflare 令牌:其隧道仅连接至服务器,且相关帖子将在 ntfy.sh 上于 12 小时内过期。 ## 任意服务器(自我认证) `--provider generic` 适用于购买或手动安装的服务器。 `deploy` 用于创建隧道 和 DNS,并写入 `install.sh` (私有)和 `install.redacted.sh` (用于发布),然后进入等待状态。 将 `install.sh` 到新安装的 Ubuntu 24.04 服务器上,并在该服务器上运行: ``` sudo bash install.sh ``` 它会记录主机当时的原始状态(登录信息、账户、 `authorized_keys`、监听套接字、 服务、定时任务、软件包)的原始状态,安装该提交,启用主机防火墙,删除 自身,屏蔽 SSH 并结束会话。此类服务器的报告充其量只能 **算是“自我证明”**:无论谁运行了安装程序,在运行之前都已拥有 root 权限,且验证者无法获取 任何提供商记录。但这仍优于来源不明的服务器:资产清单、 安装程序哈希值以及此后每次登录都经过了签名。 ## 验证 验证者需要 `deployment.json`已发布的安装程序、只读凭据,以及 最好是该提交的代码检出和证据 ZIP: ``` git clone -c core.autocrlf=false https://github.com/phishdestroy/TgWitness.git checkout git -C checkout checkout 0123456789abcdef0123456789abcdef01234567 python -m tgwitness.cloud verify --record deployment.json \ --provider-token-file read-only.token --cloudflare-token-file cloudflare-read.token \ --fingerprint COLLECTOR_FINGERPRINT --cloud-init cloud-init.redacted.yaml \ --source checkout --evidence tgwitness-evidence.zip --report report.md ``` 验证器会在该时刻请求每个提供商和 Cloudflare 的值;记录 仅提供需要查询的 ID。退出代码 0 表示通过**(PASS)**,1 表示**失败(FAIL)**,2 表示 **待审核(REVIEW)**、**不完整(INCOMPLETE)**或**自我认证(SELF-ATTESTED)**。 `--fingerprint` 应来自一个独立的 频道;若无此信息,则仅将密钥与运营商的记录进行比对。 `python verify.py` 仍会像“[证据](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/)”部分所述那样,自行验证证据ZIP。 提供商操作分为以下几类:创建操作以及在创建后 30 分钟内启动的操作均通过审核; 控制台、救援、密码重置、重建、ISO、镜像、快照、备份、系统管理器、 EC2 实例连接和防火墙开放操作若失败;电源操作以及任何意外操作 均会被标记为待审查。未知操作绝不会悄无声息地通过审核。 ## 证据移交报告 `--report report.md` 生成 Markdown 报告,并 `report.json` 其旁边: 1. 结果、收集器密钥指纹、部署、提供商、提交、服务器、防火墙、隧道; 2. 每次检查及其状态和来源(提供商 API、Cloudflare API、收集器声明、 证据日志); 3. 提供者日志,其中包含每项操作的评估结果,以及(若提供者进行了记录)操作执行者; 4. Cloudflare 端点,用于存储隧道的连接信息、配置和审计日志; 5. 经签名的收集者声明; 6. 报告涵盖的内容及其范围之外的内容; 7. 用于重现该功能的命令,以及每个输入文件的SHA-256。 提交报告、 `report.json`, `deployment.json`、已发布的安装程序以及 证据 ZIP。请尽早生成报告:服务商的日志保存期限有限。 ## Cloudflare 作为外部见证方 此处所有内容均为可选。即使没有 Cloudflare 账户,服务器仍可运行,且其中两项 功能目前已可正常使用: | 内容 | 功能展示 | 在 TgWitness | | --- | --- | --- | | 快速隧道或您域名的隧道 | 该面板仅可通过隧道访问 | 服务器向导,参见上文 | | drand 中继 `drand.cloudflare.com` | drand 轮之后生成的记录比它更新:日志是边进行边撰写的 | 证据模式、**更多见证者**、无账户([格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)) | | 隧道状态通知 | 当隧道中断时,通过电子邮件或来自 Cloudflare 的 Webhook 通知 | 在 Cloudflare 控制台中进行设置 | | 网关 DNS(`--gateway-dns`,或在向导中称为 **Cloudflare Gateway DNS**) | 服务器查询的每个名称,均由 Cloudflare 通过 TLS 响应;Hetzner 防火墙不允许 DNS 访问其他任何内容;网关策略是否可以重写响应 | Hetzner,免费“零信任”套餐,不提供域名; `verify` 检查防火墙、位置、日志记录、策略、服务器查询及审计日志;证据模式会将日志复制到日志簿中 | | 与 Cloudflare 的网关:服务器上运行一个客户端,并配置出站防火墙,仅允许连接 Cloudflare | 服务器建立的每次连接,而不仅仅是 DNS 连接 | 尚未开发 | | 面板前方的访问入口 | 谁在何时登录了该面板 | 尚未实现:需要您自己的域名 | | SSH 命令日志记录 | 调试会话中的每个命令 | 尚未开发 | Logpush(该功能会将 Cloudflare 的副本保存在 R2 中)是一项企业级功能:在免费 套餐中,Cloudflare 会 `logpush is not enabled for this account`。其网关日志在该处保留 24 小时,因此“证据模式”会将其复制到已签名的日志中(即 **Cloudflare Gateway 记录的 该服务器的 DNS 查询日志**,这是一个具有“账户分析读取”权限的只读令牌)。 `--gateway-location ID`(配合 `--gateway-dns` 使用)会使用由其 32 个字符的 ID 指定的现有网关 DNS 位置,而不是创建一个新的;`destroy` 则保留该位置不变。 如果没有“零信任”方案,一个账户只有一个 DNS 位置。当 Cloudflare 拒绝另一个位置时, 服务器会共享现有的位置,并通过其地址来区分查询;该过滤器 也需要“零信任”PII 读取权限,并且 `destroy` 这会留下一个共享位置。一次日志查询的跨度 最多为三小时,因此复制和 `verify` 读取操作需在三小时的时段内完成。 Gateway DNS 负责系统解析器。通过 443 端口以 DNS over HTTPS 方式连接至其他解析器,以及 连接至未被任何地方查询的地址(例如 Telegram 的数据中心)的连接,均不会 记录在日志中。 Cloudflare 无法查看 Telegram 的加密内容、该 Telegram 账户下的其他设备 (“证据模式”的设备列表是从 Telegram 端记录的)或服务提供商的虚拟机管理程序。 ## 阅读部署结果 对于普通虚拟机,提供商控制主机基础设施,并会同时核对本地库存 与提供商记录。对于 Intel TDX,验证者还会额外检查 硬件配置、收集器绑定、Compose 以及操作系统测量数据。请阅读各项 结果,以查看哪些检查通过或不可用。 历史防火墙详情取决于服务提供商;Linode 会保留规则版本。 [验证记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)列出了已测试的部署和剩余的在线 检查,而[验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)将这些环境 检查与存档获取及完整性联系起来。 --- # Telegram · 面板指南 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/panel/ 面板的每个界面:聊天、日志、来源、导出、扩展功能、保护模式和代码检查。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 面板的每个界面:聊天、日志、来源、导出、扩展功能、保护模式和代码检查。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [入门指南](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) ![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2) [初始设置与配置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/) · [账户](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/) · [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) · [案例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/) 每个界面的功能、其向签名日志写入的内容以及详细 指南的位置。面板每次仅显示一个工作区:一个拥有独立 消息源、日志和签名密钥的 Telegram 账户。顶部栏中的账户选择器用于切换 工作区。地址中包含工作区信息(`?ws=…`);当地址、 选择器与已加载的账户不一致时,操作将保持被阻止状态。 使用[比较收集方法](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)在实时 观察、完整历史记录、新账户/聊天记录导出以及已保存记录移交之间进行选择。 导出页面在下载控件上方包含与上述相同的比较功能。 **本页内容** - [导航指南](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#find-your-way) - [从这里开始](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#start-here) - [聊天记录](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#chats) - [日志](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#journal) - [来源](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#sources) - [导出功能](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#exports) - [设置、账户和连接](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#settings-accounts-and-connection) - [附加内容](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#extras) - [保护模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes) - [更多工具](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#more-tools) ## 快速入门 侧边栏将六个日常板块整合在一起:**首页**、**聊天**、**日志**、 **导出**、**账户**和**设置**。您无权访问的板块 将被省略。**更多工具**包含调查和管理工具。 打开侧边栏底部的**外观**以更改语言、主题、 时区或界面级别: | 级别 | 侧边栏中的部分 | | --- | --- | | 简单 | 每日章节 | | 标准 | 此外,在更多工具下还包括案例板、来源、访问和文档。 | | 专家 | 此外,在更多工具下还包括系统地图、网络拓扑、扩展功能、查询存档、参数、账户、系统日志和集成。 | 各层级的章节名称保持不变。层级仅用于隐藏章节。隐藏功能仍会正常运行,且服务器会自行检查 每一项权限。层级、语言、主题和时区会按 操作员和工作区分别保存;请参阅[设置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。 使用侧边栏顶部的**转到功能**(Ctrl+K,Mac 上为 ⌘K)通过 `#number` 查找 聊天记录、参数或日志记录。方向键用于移动,Enter 键打开, Esc 键关闭。 顶部栏包含: - **通知**:根据日志生成的故障和聊天变更信息。 **“全选已读**”会清零计数器,“**通知规则**”可打开规则设置。 在 [“扩展功能” → “通知”](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#notifications) 中可设置将通知发送至 Telegram、Discord 或电子邮件。 - 一个包含开始/暂停控制、连接设置以及 Telegram 健康诊断、事件接收、数据源和附件队列的收集状态菜单。 在窄屏上,可通过活动图标打开该菜单。 - **锁定**:关闭当前浏览器中的面板。Collection 仍会在服务器上继续运行。 版本和保护模式位于**“外观**”下;请参阅[保护模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)。 安装程序会在登录后打开**主页**;显式链接会打开其请求的 屏幕。聊天范围内的审阅者会打开**聊天**。地址 `/home`, `/case-board`, `/pseudo-secret` 和 `/network-topology` 也会打开相应的屏幕。 未知页面地址将返回 HTTP 404 状态码,并提供附近的页面建议。 演示工作区包含虚构的消息,且绝不会连接到 Telegram。 任何可能更改真实工作区的操作都会被拒绝。 [系统地图](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md)显示了该部署的账户路径、代理状态、 套接字端点、加密保险库、证据服务以及被观察到的网络请求。 选择一个账户以查看其路径。可用但已禁用的服务仍会显示。 ## 从这里开始 当您切换账户 或重新登录时,概览页面会清除该账户对应的图表和摘要。加载状态、读取失败以及没有保存记录的时段 各有不同的状态。**重试会**重复执行失败的读取操作;如果服务器要求等待, 则会显示下一次尝试的时间。刷新失败时,系统会保留同一工作区中 上次成功获取的数据,并标注其最后更新时间。 每个已连接的账户都会分别显示**“收集器心跳** ”和**“收到的最后一个事件** ”。前者表示收集器的活动状态;后者表示收到的最新 Telegram 更新。如果数据源处于静默状态,后者显示的时间将保持不变,而 收集器仍会继续运行。打开“收集状态”菜单,可查看连接、数据摄入、 数据源和附件的诊断信息。 选择一项任务。**导出我的账户**会下载该账户当前可读取的内容。 **跟踪调查**会记录您所选聊天中的新消息、观察到的编辑操作以及删除通知。 当观察处于暂停状态时,“聊天”、“日志”和“来源” 会显示设置卡片:连接账户、选择来源、开始观察。 当目标为**案件证据**,或处于“见证”、“案件准备”、 “GitHub 验证”或“最高[保护”模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)时,开始监视 会首先读取 Telegram 的会话列表(但当**严格:仅读取选定聊天**模式开启时除外)。 如果还有其他会话已登录,面板会显示 其数量,并提供**仍要开始**或**打开该账户的会话**选项。其他 目标和模式则无需此提示即可开始。 目标提示将一直显示在此页面,直到您 回答或跳过它。否则,将打开一个新工作区并进入[首次设置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。 ## 聊天 已保存的对话,默认仅限查看。 聊天行显示收集状态、待处理和失败的文件下载、初始历史记录 加载情况,以及Telegram对话元数据中返回的限制信息。丢失或未确认的 访问状态并不意味着内容被禁。打开**过滤器**以选择这些状态 或按文件队列排序;页面重新加载时,选定内容将保留在URL中。 **重试**筛选器可查找因错误而处于等待状态的初始聊天加载任务。其图标会显示 错误类型,并在收集过程中显示下次尝试时间。“首页”汇总了需要 再次尝试的加载任务数量。暂停的收集任务将保留相关任务,直至恢复。 In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here. 保留关联的日志条目会显示已观察到的类型、名称和字节大小。 新的下载结果在 Telegram 提供时,也会保留媒体类型和时长。 较早的已签名记录保持不变;缺失的元数据不会被重建。 - 按名称或ID搜索列表。多个词语按任意顺序匹配,包括 名称与ID的一部分组合。点击**+**按钮可打开**添加聊天或频道**(添加或移除 关注的聊天)、**打开Telegram链接**和**伪秘密 · 开始聊天**。 **打开 Telegram 链接**功能支持输入 用户名或邀请链接,并将预览保存至日志;若搜索 @用户名 或 t.me 链接未 找到匹配结果,也会显示相同操作。**选择加入/打开并观察**将加入该聊天并将其添加到您的来源中; 打开机器人时,系统会向其发送 `/start` 指令。 - 伪秘密聊天会显示在同一列表中,图标为绿色并带有锁形标记,且会在“伪秘密”模式下打开。 当观察功能关闭时,列表中会显示**“观察**已关闭”以及**开始观察**选项。 - 快速过滤器以单行标签页的形式呈现:**全部**、**伪秘密**、**优先级**、**更改**(已保存的编辑 或删除通知)以及**需要关注**(访问丢失或未确认、重新检查时未找到消息、 媒体文件失败、历史记录重试或 Telegram 限制)。 没有内容的标签页会被隐藏。计数会遵循 搜索和类型过滤器;快速过滤器将取代状态过滤器。这些选项 会保留在 URL 中,以便重新加载以及“后退/前进”导航。 **需要关注**不会将消息标记为已删除。当**筛选器**折叠时,类型、状态和自定义 排序仍作为可移除的卡片显示。 - 大型列表每次显示 80 条匹配结果;**点击显示更多**可加载下一批 80 条。当匹配结果出现时,已打开的 聊天窗口和当前选中的行仍会保持可见,即使该结果不在当前批次中也是如此。 计数器显示的是所有匹配结果中已显示的聊天数量。搜索范围覆盖整个 列表,包括尚未显示的聊天。 - 来自搜索, **↓** 跳转到第一个搜索结果, **↑** 到最后显示的结果, 并且 **输入** 打开第一场比赛。在列表中, **↑/↓** 和 **首页/结束** 移动焦点; **输入** 打开当前选中的聊天窗口。 **逃脱** 返回搜索界面,在该界面中 再次按下该按钮可清除搜索查询。 **清除筛选条件** 重置列表,同时 不更改集合或已打开的对话。 - 聊天标题会统计**已删除、保留文本**、**保存前已删除**和**重新检查时未找到**的消息。每个计数都是一个按钮,只显示这些消息;再按一次即显示全部。消息上的**已删除**和**重新检查后未找到**会打开一条注释,包含时间和观察到的内容。聊天列表和通知使用相同的定义。已删除的消息显示为红色并保留已保存的文本;已编辑的消息保留所有已保存的版本。 - **搜索已保存的消息**会检索完整的保留聊天记录,包括早期的 文本版本。已删除、已编辑、媒体和作者过滤器同样涵盖完整的 保留聊天记录。**重新检查时未找到**的结果与收到的删除通知无关。 搜索不会向 Telegram 请求消息;请使用**加载历史记录**来获取更多内容。 若在早期版本中找到匹配项,将打开保存的版本及其日志链接。 **显示版本**标识了用于该消息的记录及其书签; 历史记录的延迟响应无法替代屏幕上更新的实时编辑内容。 - 在消息之间,聊天会显示两种缺口标记。**未观察到的消息编号**列出日志中没有记录的编号,仅限频道和超级群组:其他聊天共用整个账号的一套编号,因此那里的跳号无法说明该聊天的任何情况。**覆盖缺口**标出一次已记录的中断与下一次已记录的恢复之间的时段,如日志中有原因则一并显示。显示全部消息时会出现这些标记,启用消息筛选时则隐藏。 - 在消息上方**点击生成报告**按钮,将打开报告工作室,并选中该聊天记录。 在发帖者的个人卡片中点击同一按钮,则会选中该聊天记录及该发帖者。 这两种操作均仅修改草稿;导出前请先保存。 - 点击作者姓名会在消息旁边打开一张人物卡片:保存的个人资料、 简介、头像、礼物、链接、消息数量以及包含 日志记录的活动时间线,此外还有**刷新个人资料**和**生成报告**选项。**点击关闭**、按 Esc 键或 进入其他聊天窗口可关闭该卡片;聊天窗口的位置保持不变。 卡片中的**节奏** 统计该作者在此聊天中已保存的消息(以UTC时间为准):活跃天数(在 沉默6小时后开始计算)、24小时内回复他人的中位时间、 最长连续消息串、00:00至06:00之间发送的消息比例,以及 工作日×小时的热力图。 - 消息上方的**选择**会开启消息选择:点按消息即可标记,按住 Shift 点按可标记一个范围,或使用**选择显示内容**,然后点**生成报告**。报告工作室打开时已填好**已选消息**。报告涵盖通过其他筛选器的这些消息的记录(观察、编辑、删除通知);作者筛选会排除不带发送者的删除通知。最多可选择 1,000 条消息;工作室中的标签可移除单条消息,也可在旁边添加整个聊天。缺失的消息编号仅针对整体选中的聊天报告。 - **加载历史记录**功能会将最近的 100、250 或 500 条消息加载到此视图和 日志中。您可以在**聊天操作**中找到该功能,其旁边还有录音设置、只读和 秘密消息隐藏控制选项。按 Esc 键或点击菜单外区域即可关闭该菜单。 加载较早的消息时,当前阅读位置将保持不变。如果在 Telegram 响应期间查询或页面 发生变化,加载完成后会更新已保存的日志,而不会 替换较新的视图。自动加载失败时,系统会提供**重试选项**。 要加载所有已启用的消息源,请使用[消息源→完整历史记录](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#sources)。 - **“导出聊天”**功能将整个可见聊天记录下载为一个已签名的 `chat.json` 且 `chat.html`文件。多个关联账户可协同完成此任务:每个账户下载其对应的 消息编号范围并对其部分进行签名,而发起 导出的账户则对整个存档进行签名。参见[“导出单个聊天](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)”。 - **“人员”**列表显示了该聊天中所有保存了消息的用户。人员个人资料默认处于 关闭状态,因为它们涉及第三方个人数据。当某次聊天中 启用该功能时,个人资料会显示姓名和用户名历史、Telegram标记、头像哈希值、活动记录、 谁回复了谁、其他被观察的聊天,以及被提及的钱包、手机号、用户名 和链接。 每项信息都指向其对应的记录。**导出个人资料**会保存一个签名文件, 可选地设置密码ZIP;关闭个人资料会删除该文件。参见 [“人员个人资料](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#people-profiles)”。 - **“将所有作者汇集** 到同一标签页”功能会向Telegram请求获取聊天中所有已保存消息的用户的个人资料、简介、 头像、礼物和简介链接。在频道 或超级群中,其他已连接的账户可以共同参与此操作。每个选中的账户都会 被预留用于该集合,完整收录该用户信息,并通过该作者 其中一条已保存的消息联系到该作者。 正在处理其他任务的账号不会被干扰, 待其空闲后即加入。若无法联系到某位作者,则返回聊天室的自有账号。 进度条显示百分比、剩余时间及各账号的贡献份额;**点击暂停** 可释放账号。每条已保存的记录都会标注阅读该记录的账号,且 日志会记录每个账号的加入和退出时间。 - **“保存个人资料”功能现可**记录聊天或机器人个人资料的快照:描述、 成员、邀请链接、机器人命令。 ### 只读、发送和密钥 消息上方有两个开关,用于保护账户和读者: - 打开聊天时**,“只读”模式**处于开启状态。 若要发送消息或点击机器人 按钮,请将其关闭。每次操作时都会提示**“以 @account 身份发送?**”或**“以 @account 身份点击此机器人按钮?**”,这表明聊天成员会看到该操作,且该操作将进入已签名的 日志。**选择“在此聊天中 10 分钟内不再提示**”可暂时跳过该提示。在**“案件证据**”目标中,无论是面板还是 API,发送功能均处于关闭状态。 - **“隐藏机密”功能可**隐藏看似密码、登录码、API 密钥或 哈希值、机器人令牌、会话字符串、私钥、JWT 或支付卡号 (卡号会通过 Luhn 和校验)的内容。**点击“显示”**将揭示一个值;该揭示操作 会被记录在日志中。为该浏览器关闭隐藏功能的操作也会被记录下来。 仅显示内容发生变化:原始记录和所有导出文件均保留完整文本。 ### 将选中的消息保存为图片 在云端聊天中,选择**“选择**”,勾选消息,然后选择**“另存为图片**”。 要截取整个聊天记录,请在聊天工具菜单中选择**“将聊天保存为图片**”;该功能 会加载最近保存的最多 2,000 条消息,并提示哪些较早的消息未被包含。 预览界面提供**“浅色**”、**“深色**”和“**经典**”三种样式;对于较长的聊天记录,请使用“上一页”和“下一页” 进行截取。**下载带签名的 ZIP 文件**,该文件将每页保存为 PNG 格式,并附带 `pages.sig.json` 以及 `README.txt` ([已签名的聊天图片](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#signed-chat-images))。 最多可选择 50 条消息,且所有消息必须仍位于已加载的聊天 窗口中。操作面板会提示您缩减过大选择范围,而非默认 省略消息。 每页末尾都包含一个真实性块:其中显示的日志记录编号、 聊天记录、渲染时间、工作区密钥指纹、该 `verify.py` 该页面的 命令,以及一个包含聊天记录、密钥和渲染时间的二维码。签名需要导出 权限,并会在日志中添加一条 `export.image_attested` 日志条目。 该图像包含已保存的文本、作者、消息编号、UTC时间、回复编号、 附件标签以及已保存的编辑/删除状态。它显示的是最新保存的文本 及其保留的版本数量;附件内容、内联按钮、 点赞和早期文本版本均未显示。 长消息将延续至 下一页,并显示其消息编号和分段数量。每页均标明 其内容源自已保存的消息。该 PNG 文件仅为视觉摘要;在移交签名记录及附件时, 请使用存档文件及其验证码。 渲染过程在浏览器中完成,无需向Telegram发送请求;在签名时, 仅将每页的SHA-256哈希值和记录编号发送至控制面板。现有的密文遮罩功能可保护文本、作者姓名和 附件标签。预览窗口会保留快照直至关闭,并在控制面板 锁定或切换工作区/聊天时清空。已签名的日志和报告选择保持 不变。有关完整报告导出的信息,请参阅[病例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)。 ### 转发消息 关闭该聊天的**只读**状态,然后在某条消息下方选择**转发**,或者 **选择**并标记最多 100 条消息,然后选择**转发**。按 名称选择目的地:列表中包含已保存的聊天以及该账号可在其中发布消息的 Telegram 聊天(包括群组、私聊、机器人及其管理的频道)。 面板会要求 确认,随后通过 Telegram 原生功能进行转发,并遵循该账号的 消息发送频率。请求及其结果均为带签名的日志记录,其中注明了源聊天、 消息编号和目标。只有当目标 聊天被监听时,副本才会保存在目标端。如果聊天禁止转发,则会返回拒绝响应,且不会发送任何内容。 ### 将聊天内容转发到频道或群组 The main administrator can open a saved cloud chat and choose **Forward chat** from its tools menu. Choose **New channel**, **New group**, or **Existing channel or group**. New destinations are private. For an existing destination, **Choose a chat** lists the account's groups and the channels it administers; search by name. The destination must allow this account to post. Forum destinations are not supported. 在预览之前,请暂停观察或其他正在运行的账户任务,并启用 Telegram 操作。 只读账户以及**案件证据**目标会阻止转账操作。 **预览功能**会读取可访问的 Telegram 聊天记录范围并验证目标地址。 该功能不会创建目标地址或发送消息。**开始**将启动转账; 预览将在十分钟后失效。每个工作区仅可进行一次转账操作。 该传输功能会按从最旧到最新的顺序读取 Telegram 聊天记录,直至预览中显示的最后一条消息。 它并不局限于已保存在 TgWitness 中的消息。 超出该范围的消息将被排除在外。原生转发功能可保留 Telegram中可用的发件人信息和媒体内容,无需下载和上传 副本。范围内的相册将保持完整。通知为静默模式。回复、 主题结构、点赞、编辑以及已删除或无法访问的消息均不会 被重建。秘密聊天不属于此工作流范围。Telegram的内容保护 和发布限制仍然有效。 该面板显示已确认的发送、跳过操作、状态以及下一次允许尝试的时间。 服务消息和单独受保护的消息会被跳过,并记录 跳过原因。账户消息间隔和每小时限制适用于每条消息;专辑 将等待其预留时段到期。FloodWait 和慢速模式暂停会更新 账户的共享 RPC 退避时间。账户现有的限速默认设置保持不变。 **暂停**会中断当前请求;**取消**会停止剩余操作,但不会移除 已发送的消息或删除已创建的目标。正在处理中的请求可能会 在上述任一操作生效前完成。关闭对话框不会取消任务。 进程重启后,未完成的工作需要显式**继续**操作。若发送响应丢失或 不完整,工作将暂停以便审查:在 继续之前请检查目标。重试会保留存储的 Telegram 随机 ID 和已确认计数; 但这不能保证 Telegram 会无限期地进行去重。未知创建 结果无法自动继续:请检查 Telegram,并在 向已创建的目标(如有)开始新传输之前,取消旧的工作。 如果保存作业或其日志条目失败,工作者将恢复上次保存的 状态并释放该账户。可能已到达 Telegram 的发送或创建操作仍会被标记为待审核。当存储空间再次可用时,重试失败的启动或恢复操作; 已确认的进度仅随其日志条目一起推进。 已签署 `interaction.forward.*` 日志条目记录了边界、目标位置、 已确认的源/目标消息ID以及跳过项。它们记录了传输过程; 但不能替代原始的已签名观测数据和导出数据。 ## 日志 工作区已签名的所有记录,按时间倒序排列(最新在最前)。 - **“概览”**统计了已观察到的消息、记录的编辑、删除通知以及 选定的来源。 - **事件时间轴**可按事件类型(全部、编辑、删除、点赞、 成员资格、报道范围)、文本内容及来源进行筛选。可回**载较早的事件**页面。 - 打开一条记录可查看其详细信息、哈希值和有效载荷。**该记录的链接**是一个 可直接打开同一记录的地址。此预览中可能包含的机密信息已被屏蔽; 导出文件则保留原始内容。 - 日志为仅追加模式:面板中没有任何操作可以编辑或删除记录。请通过 **“导出”→“验证日志**”或 `python -m tgwitness.verify`;参见 [“导出与验证”部分](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/)。 ## 来源 该工作区会记录哪些对话,以及从中保留哪些内容。更改 仅适用于未来的活动;已保存的记录保持不变。 **“刷新聊天列表”**功能会读取该账户的聊天记录和文件夹,但不会下载消息内容。 ### 范围 - **该账户记录的内容** :**选定的聊天** (仅您添加的聊天), **Telegram 文件夹** (该账户的一个文件夹,包括后续添加到其中的 聊天)或 **完整账户** (所有聊天,以及每个新出现的聊天、群组、私聊或 机器人)。**调查模式** 适用于专用账户:它记录 该账户所见的一切内容、其自身发送的消息和按键操作,并立即保存每个新 聊天的配置文件及先前可见的消息。 [专用账户指南](https://phishdestroy.io/tgwitness/docs/dedicated-account/) 解释了为何绝不能使用你的主账号。 - **严格模式:仅读取选定的聊天**(仅限选定聊天,默认关闭)将停止读取 Telegram 的服务通知、会话列表以及已启用该模式的聊天中的早期消息, 同时保持敏感内容设置不变,并跳过电话通话 更新。参见[严格选定聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#strict-chosen-chats)。 - **源类型**将文件夹模式和整个账户模式限制为频道、群组、私聊 和机器人。**自有操作**会添加该账户自身的消息、编辑操作以及 回复时的键盘按键记录。 - **当出现新的聊天或机器人时**:保存其资料,并保存最多(根据所选数量) 其最新的可见消息。 - **已选聊天**被标记为推荐。**点击丢弃更改**将表单恢复到 已保存的范围,直到您点击**保存范围**。 [伪秘密聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)是内置的秘密聊天界面,安装其协议模块后, 只需点击一个按钮即可为每个账户启用。云端监控 和聊天记录使用各自的设置。 当 TgWitness 未 运行时,系统不会记录任何内容;重启后,它仅会补录 Telegram 仍能返回的数据,而 报告中会显示数据缺口。超出聊天列表限制(除非在 “参数”中更改,否则为 1,000 个对话)的聊天记录,将在其下次变为活跃状态时被添加进来。在 其他应用中点击的内嵌机器人按钮不会被记录;但机器人的回复会被记录下来。 ### 涵盖的聊天 可按状态(**已启用**、**已暂停**、**优先级**、**已排除**、**未确认 访问**、**已忽略**)和类型进行筛选,然后对选定项执行操作:启用、暂停、标记或移除 优先级、从范围中排除或删除。状态图标仅显示当前状态;操作 位于每行菜单中,并附有功能说明。 暂停和排除操作需要 确认,批量操作时同样如此。删除来源时需输入其名称,并会删除其人员 个人资料;其保存的记录仍保留在日志中。 若某来源未显示在该账户的聊天列表中,则表示该来源正在**接收更新,但未出现在聊天 列表中**,同时记录仍在持续到达;否则,**访问状态未确认**。**“可用 聊天**”会添加通过**“添加所选**”或**“添加所有匹配项**”操作选中的聊天。 ### 完整历史 将每个已启用来源的可用历史记录加载到“聊天”和日志中。 进度在重启后仍会保留;附件遵循您的媒体设置。参见 [来源历史记录](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)。 ### 记录 - **选择要保留的变更**:新消息、编辑、删除通知、 可见的点赞、加入和退出。预设会更改表单; **“保存记录设置**”会应用该预设。重新启用某类别不会恢复 已错过的事件。 - **在可能的情况下保留媒体文件**:下载单个文件大小不超过指定限值的附件,设置 每种类型的限值范围为 1 至 2,000 MiB,并限制视频时长(以秒为单位,0 表示无限制)。 每次下载尝试都会记录结果。 - **重新检查**:每隔几分钟检查一次优先级聊天,其他聊天则很少检查,因此该账户 不会触发 Telegram 的 FloodWait 限制。设置为 0 可关闭该组。在列表中用星号标记优先级聊天; 每次检查的聊天数量以及聊天之间的暂停时间可在 “参数”中设置。参见[集合](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/)。 - “保存”栏会显示这些设置是否与推荐设置一致。**点击返回 推荐设置**将填入推荐值;**点击保存录制设置**将应用这些设置 ;**点击放弃更改**则恢复已保存的设置。 ## 导出功能 **“下载**”用于准备文件;**“构建报告**”用于选择报告的显示样式。 | 内容 | 用途: | 指南 | | --- | --- | --- | | 账户导出 | 该账户当前可读取内容的最新快照 | [账户导出](https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/) | | 共享副本 | 一个已完成的账户导出功能的精简版 | [披露声明](https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) | | 已签名 ZIP | 日志、报告、附件和验证工具,均位于固定的日志边界内 | [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) | | HTML、PDF、JSON 报告 | 一份密封的可读报告 | [案例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/) | | JSONL、CSV | 带有签名的原始记录;一个支持公式的电子表格 | [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) | | 交接摘要 | 仅包含收件人所需的聊天记录、时间段和联系人 | [证据](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#investigation-handoff) | | 聊天记录导出 | 一个已签名的聊天记录 `chat.json` 以及 `chat.html` | [导出一个聊天记录](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) | - **使用密码对上述下载文件进行加密**(12 个字符或以上)会保存一个 AES-256 ZIP,该文件可由 7-Zip 或 WinRAR 打开。其中的已签名文件保持不变。 密码不会被存储。 - 导入此工作区的会话密钥时,账户导出和聊天 导出对话框中会有一行提示:该密钥的副本可能存在于 Telegram 的 会话列表之外。同一行还提供了**创建独立授权**选项, 点击后将打开登录页面并默认选中该选项。参见 [账户部分](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#create-an-independent-authorization)。 - 失败或被取消的聊天导出将保留其已保存的范围。**捕获或导出 单个聊天**后,系统将提供**继续导出**和**重新开始选项**;请参阅 [导出单个聊天](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)。 - 虽然聊天记录导出功能显示为**下载迄今已读的消息**,但实际上保存的是一个 ZIP 文件,其中各页面 在写入时即被签名;其下方的行显示了已签名消息的数量。 - **预先准备的导出包**会保留最多 20 个文件(每个文件大小不超过 2 GiB),外加最新的一个文件,以便 重复下载;每个文件都附有相应的 SHA-256 校验值,供接收方进行比对。每张卡片都会注明文件的内容: **已签名存档**(完整的日志及其记录数量)、**报告**、**日志记录**或**交接 摘要**,案件标题和ID,以及生成该文件时选定的报告内容(聊天记录、选定消息、日期)。当列表包含多种类型时, **点击显示**可将列表筛选为单一类型。 - 当浏览器拒绝显示保存对话框时,该面板将回退为普通下载。 - **您的签名身份**会显示密钥指纹。**“保存检查点**”和 “下载**已签名的运行收据**”功能可为您提供存储在收集器之外的记录。 “准备**时间戳请求**”会在不联系任何服务的情况下构建一个 RFC 3161 请求。 ## 设置、账户和连接 - **设置**:目标、连接、记录内容及界面。请参阅 [首次设置和配置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。 - **账户**:每个工作区及其状态、消息源、事件和附件队列。 可通过 **需要关注**、**收集**、**离线或已暂停** 或 **未连接** 进行筛选,暂停或恢复选定操作,批量导入账户文件并管理 群组。参见 [账户](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)。 - **账户**:登录及该账户的连接路径。直接连接、WireGuard 配置文件、您自己的代理、公共 MTProto 池或 WARP;准备并检查路径, 然后将其应用于该账户、一个组或所有账户。 参见 [连接和代理及](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/)[代理](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md)。 **账户安全→此账户的会话**列出了 Telegram 的会话,可结束其中 一个或所有会话,并且——对于在此工作区中创建的密钥——**当 Telegram 允许时,提供将其设为 唯一会话选项**,该操作将在24小时后 后自动重复该操作,并显示其设置的一次性双步验证密码。参见 [账户安全](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#create-an-independent-authorization)。 **账户安全→见证探测**会使用第二个工作区来验证该 会话是否能实时接收更新;参见[见证探测](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#witness-probe)。 批量暂停和恢复操作会将已确认的选择保留在最初 打开该操作的会话中。在等待确认或执行期间,控件将保持禁用状态; 切换工作区或锁定面板将取消剩余的命令。 执行完成后,面板会刷新账户状态。失败的请求将 被报告为请求失败,因为服务器可能已经应用了该命令。 命令不会自动重试。 ## 附加功能 可选:只需一个账户和来源即可开始收集。只有您 选择的选项才会打开其设置,系统不会自动连接任何内容。顶部的“ **保护级别**”卡片显示当前的[保护模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)。 | 卡片 | 新增功能 | 指南 | | --- | --- | --- | | 存储与磁盘空间 | 备份、将旧文件移至您的云端、一份无法被删除的证据副本 | [存储](https://phishdestroy.io/tgwitness/zh/docs/reference/storage/) | | 目标与保护级别 | 针对您的目标及两个量表的建议设置 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#goal-and-protection-level) | | 通知 | 问题、已修改的消息和每日摘要;您专属的控制机器人 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#notifications) | | 证据与备份 | 时间戳、更多见证人以及加密的异地副本 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#evidence-and-backups) | | 服务器全天候运行 | 一个不支持 SSH 的云服务器,可通过控制面板进行创建和删除 | [高可信度](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#from-the-panel) | | 独立见证者 | 已签名的检查结果将发布到您的 Telegram 频道或 Discord 上 | [见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/) | | 代码检查 | 将正在运行的程序与 GitHub 上的公开提交进行比较 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#code-check) | ### 目标与保护级别 四个问题: 1. **用途是什么?**个人记录、调查,或是案件证据。 2. **您打算监控多少内容?**少量聊天(最多约 50 个)、大量聊天(最多约 500 个)还是整个账户?这将把聊天列表的上限设置为 1,000、3,000 或 20,000。 3. **照片和文件?**仅限文本、照片和短媒体(照片 20 MB,视频 100 MB),或全部(视频和文档各不超过 1 GB)。选择“全部”并包含完整 账户时,还会保留 4 GiB 的可用磁盘空间。 4. **它将在何处运行?**这台电脑,或者一台始终处于运行状态的服务器。 建议列表中列出了独立时间戳、drand 以及 Telegram 的设备列表,每项 均附有一行说明其作用。时间戳可设置为每 60、30 或 10 分钟生成一次,适用于个人 记录、调查或证据;drand 和设备列表需要时间戳。仅需 **应用**以下更改:这些内容、附件策略以及上述两个参数。每次 更改都是一条日志记录,此外 `setup.applied`。通知、站外副本、 服务器、网关DNS、代码校验和见证人作为后续步骤提供,并配有 各自的表单。 两个指标是根据当前设置计算得出的,而非基于目标: | 规模 | 要点 | | --- | --- | | 可信度 | 签名日志 1、时间戳 3、drand 1、设备列表 1、代码校验匹配 1、见证人轮询 1、经过认证的服务器 2、网关 DNS 日志 1 | | 可靠性 | 常驻服务器 3 个,异地副本 3 个,对象锁定 1 个,问题通知 1 个 | **最高**阅读量为 80% 或以上,50% **为高**,25% **为中等**,低于此为**基本**。 可靠性目前根据问题 4 的答案中“始终在线”的服务器进行计算, 在检查任何服务器之前。 ### 通知 通知通过 Apprise 发送至 Telegram、Discord、Slack、ntfy、电子邮件、Matrix 以及 100 多种其他服务。选择一项服务,填写一两个字段并发送测试消息,或者 直接粘贴 Apprise 地址。 - **问题**:磁盘空间几乎已满、账户已注销、收集、复制或时间戳 错误、使用该设备、应用程序和 Telegram 国家列表的新会话登录到该账户、Telegram 在 观察期间报告的登录码或新登录,以及在**将此设为唯一会话**之后出现的另一个会话。在密封的 服务器上,打开的 SSH 端口或登录操作也会构成问题。 - **变更**:在被监视的聊天中,已删除、已编辑和缺失的消息将按 每次检查一条通知进行汇总(除非在“参数”中更改,否则每分钟检查一次)。 - **已完成的功能**:历史记录、导出和存储副本。 - **监控列表匹配项**:来自已设置为发送警报的监控列表中的匹配项。 - **每日摘要**将于服务器时间设定的指定时间发送。 通知中包含聊天名称和消息数量。消息摘要默认处于关闭状态;若 开启该功能,消息正文将从本机发送出去。 **您的操作员机器人**是您通过 @BotFather 创建的专属机器人,用于回答 `/status` 并 `/stats`,并可选地 `/pause`, `/resume` 和 `/copy`。仅列出的聊天和 Telegram 用户 ID 可以使用它;对话内容保存在工作区中。如果另一个应用程序已经接收其命令,请使用一个单独的 机器人。请参阅 [通知](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md)和[操作员机器人](https://phishdestroy.io/tgwitness/zh/docs/reference/storage/#operator-bot-and-completion-notices)。 ### 证据与备份 - **独立时间戳**仅将每个签名检查点的 SHA-256 值发送至 RFC 3161 权威机构和 OpenTimestamps 日历,间隔为每 5 至 1,440 分钟。接收方需要 此类第三方时间戳作为证据的最低要求。**Anchor 目前** 正在运行一个通过。参见[时间戳](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/)。 - **更多见证记录**(在被选中前均处于关闭状态):最新一轮的 drand 轮次、Telegram 的 已登录设备列表(不含 IP 地址),以及 Cloudflare Gateway 记录的服务器 DNS 查询日志。参见[可选记录](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)。 - **加密备份**会将日志、文件、检查点和聊天记录导出到 S3兼容存储(Wasabi、Amazon S3、Backblaze B2、Cloudflare R2、MinIO)。 所有内容都会先在此机器上进行加密。**请下载加密密钥**并将其 单独保存:没有该密钥,备份副本将无法被读取。在“治理”或“合规”模式下启用“对象锁定”功能, 可确保对象在设定的天数内不会被删除。参[见异地备份](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md)。 ### 代码检查 检查已安装的程序是否与已发布的版本匹配。 1. 输入一个 GitHub 仓库(官方仓库已预填)以及一个标签、分支或提交。 2. **“Check now**” 通过该工作区的外部请求路由,向 GitHub API 查询 该提交的文件列表。它将每个被测程序文件的 git blob ID 与该提交进行比对。即使在 Windows 环境中检出时换行符已被转换,仍能匹配成功。 3. 结果列表会显示已更改、新增和缺失的文件(每类最多 50 个),并保存为 一份 `source.checked` 日志记录。 结果仅在运行中的程序文件未发生变更时才视为有效: 更新后请重新检查。无需令牌,且仅支持公共仓库; 聊天记录和凭据不会被上传。匹配操作用于识别磁盘上的代码。这并非 硬件认证;有关硬件认证,请参阅 [Phala Cloud](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx)。 ## 保护模式 版本号旁边的切换器显示所选模式以及 18 层 保护层中有多少层处于激活状态,例如 `🟠 Witnessed 9/18`。在 **“扩展功能”→“保护级别”**中**切换模式**可打开选项。每种模式描述一个目标,并列出 尚缺的内容;记录、签名和保存的设置在所有模式下均保持一致。 | 模式 | 用于 | 新增功能 | | --- | --- | --- | | 🟢 简单 | 监视聊天并保留副本 | “聊天”功能用于导出日志和聊天记录;签名操作在后台运行 | | 🟡 已签名 | 向平台、主机或滥用处理部门提交报告 | 签名存档、日志检查、检查点、交接摘要 | | 🟠 已见证 | 可能有人声称记录被篡改的情况 | 一个独立见证人发布经签名的日志头 | | 🔴 符合法庭要求 | 供律师、警方或法院使用的证据 | 时间戳、加密的异地副本、报告中的案件详情 | | 🟣 GitHub 认证 | 任何人都能验证其软件的记录 | 代码检查与 GitHub Actions 捕获 | | ⚫ 最大值 | 针对资金雄厚的对手展开的高风险案件 | 一个全天候运行的密封服务器、一个隐藏的 IP 地址,以及全部 18 层防护 | 各层结构:每条记录均经过签名并链式连接;带签名的运行收据;通过 SHA-256保存的附件;带签名的检查点;重新检查;问题警报;只读见证访问; 按计划进行的见证检查;RFC 3161 时间戳;OpenTimestamps 证明;经过验证的 最新时间戳;加密的异地副本;报告中的案例详情;匹配代码 检查; Telegram 永远不会看到这台机器的 IP;外部请求通过代理进行;副本上的 对象锁定;一个封存的、包含提供商记录的服务器。处于关闭状态的层设有 **“设置”选项**,点击后会打开其表单。选择较低模式时会要求确认,且 不会删除任何内容。 ## 更多工具 **附加功能 → 独立捕获**:连接一个 独立的浏览器或AyuGram记录器,固定其签名密钥,选择捕获选项, 开始/暂停,拍摄快照并下载经过验证的签名存档。每个记录器都有 独立的手动登录、路由、日志和密钥。这两条连接初始状态均为禁用。 请参阅英文版《[独立捕获指南](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)》。 - **查询存档**:搜索已保存的观察记录,审查来源,然后决定 是否将其发送给 AI 模型。参见[存档分析和](https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/) [本地 OCR 及转录功能](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/)。 - **参数**:数据收集的限制与频率、复核、下载、配置文件、 通知和导出。支持按名称搜索,显示 **仅显示已更改的** 中的值,并使用 **恢复默认值…** 将 默认值保存为草稿。**保存参数** 会从下次使用时起应用这些值, 每次更改都会生成一条日志记录。 - **访问权限**:审阅员、分析师和操作员拥有各自独立的令牌,访问范围仅限于选定的 工作区、聊天群组及权限。详见[“访问权限”部分](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)。 - **系统日志** :该进程自启动以来执行的操作(连接、代理变更、 登录、登录失败、设置变更),其中 IP 地址已被隐藏。**“跟随新行** ”功能可将最新一行始终保持在视图中。消息仅保存在日志中。 - **集成**:AI 服务提供商、[只读 MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/) 连接以及 [已签名的 webhook](https://phishdestroy.io/tgwitness/zh/docs/reference/webhooks/)。 - **Case Board**:位于证据旁边的团队私有笔记、书签和片段。参见 [Case Board](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)。 - **文档**:[调查模式](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md)抽屉。当 正在记录的会话处于记录状态时,它会移至主侧边栏。 - “导出”中的 **GitHub Actions capture**:从您的分支中捕获的一段聊天记录。参见 [密封捕获](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)。 --- # Telegram · 数据采集原理 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/collection/ 观察范围、实时更新、复核、附件、用户操作以及“缺口”的含义,逐条记录。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 观察范围、实时更新、复核、附件、用户操作以及“缺口”的含义,逐条记录。 [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) TgWitness记录已连接Telegram账户所观察到的内容。实时监控 会保留消息、捕获的编辑内容、删除通知及附件,并附带 其观察时间及来源上下文。历史读取、重新检查以及可用的 管理日志记录会将单独标识的观察结果添加到该记录中。 **本页内容** - [从登录到日志](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#from-login-to-a-journal) - [观察范围:选定的聊天、某个文件夹或整个账户](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account) - [范围与事件选择](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#scope-and-event-selection) - [自主操作](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#own-actions) - [调查模式:加入团队并与机器人对话](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots) - [重新检查分级](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#recheck-tiers) - [消息历史记录与来源说明](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#message-history-and-attribution) - [历史快照](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#history-snapshots) - [附件处理](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#attachment-handling) - [暂停、锁定、断开连接和重启](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#pause-lock-disconnect-and-restart) - [账户隔离与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#account-isolation-and-verification) ## 从登录到日志 关于自毁照片和文件,请参阅[自毁媒体](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md)。 本文阐述了优先级处理程序、已保存和不可用结果,以及 API 收集器中阅读回执屏蔽功能的限制。 流程图 · 授权用户账户 → 选择可访问的群组和频道; 选择可访问的群组和频道 → 保存事件和附件设置; 保存事件和附件设置 → 开始监控; 开始监控 → 接收来自活跃客户端的更新; 接收来自活跃客户端的更新 → 应用来源与事件政策; 应用来源与事件政策 → 追加一份经过签名的观察记录; 追加一份经过签名的观察记录 → 查看或导出日志; 追加一份经过签名的观察记录 → 处理队列中的任何附件; 处理队列中的任何附件 → 附上下载结果 · 授权用户账户 · 选择可访问的群组和频道 · 保存事件和附件设置 · 开始监控 · 接收来自活跃客户端的更新 · 应用来源与事件政策 · 追加一份经过签名的观察记录 · 查看或导出日志 · 处理队列中的任何附件 · 附上下载结果 **图表转为文本** 1. 授权用户账户 → 选择可访问的群组和频道 2. 选择可访问的群组和频道 → 保存事件和附件设置 3. 保存事件和附件设置 → 开始监控 4. 开始监控 → 接收来自活跃客户端的更新 5. 接收来自活跃客户端的更新 → 应用来源与事件政策 6. 应用来源与事件政策 → 追加一份经过签名的观察记录 7. 追加一份经过签名的观察记录 → 查看或导出日志 8. 追加一份经过签名的观察记录 → 处理队列中的任何附件 9. 处理队列中的任何附件 → 附上下载结果 授权、对源数据的访问、运行中的收集器以及完整交付是 不同的问题。成功登录并不意味着可以访问所有组。 交付情况会单独追踪:覆盖记录、更新缺口恢复和重新检查 可显示已接收的内容。 ## 监控范围:选定的聊天群组、某个文件夹或整个账户 **更多工具 → 源 → 范围**决定工作区记录哪些聊天记录。 新设置从**选择聊天**开始。已保存的选项将被保留。在设置向导中选择 **所有聊天**时,如果加载的列表中包含 超过50个聊天,系统会要求确认;而聊天数量的估算仍是一项基于样本的独立操作。 | 模式 | 记录 | 新聊天记录 | | --- | --- | --- | | 选定聊天(默认) | 仅限您手动添加的聊天记录 | 绝不自动添加 | | Telegram 文件夹 | 该账户某文件夹中的聊天记录:包含按名称列出的聊天记录,加上该文件夹的分类(联系人、非联系人、群组、频道、机器人),减去被排除的聊天记录,以及(如果文件夹有此说明)已归档的聊天记录 | 匹配的聊天记录一经激活即被添加;您在 Telegram 中添加到文件夹的聊天记录将在一小时内被捕获 | | 完整账户 | 该账户所见的所有聊天记录 | 每当出现首次更新时,新的聊天、群组、私聊或机器人都会被立即添加进来 | - **来源类型**(频道、群组、私聊、机器人)仅适用于文件夹模式和 整个账户模式。所选聊天可为任意类型,包括私聊和机器人; 来源类型绝不会阻止您手动添加的聊天。 一旦关闭某种类别、设置了排除条件或 切换为“选定聊天”模式,自动添加的来源将在保存后立即停止,无论 来源列表是否已重新计算,甚至在无法连接 Telegram 时也是如此:其新 消息、历史记录、新聊天历史、对等设置和个人资料观察记录。 - **手动添加的聊天记录**在“文件夹”和“整个账户”模式下都会被保留,即使它们 位于文件夹之外;只有*排除*、*移除*或暂停操作才会停止记录。通过范围 (*自动*)添加的聊天记录会跟随文件夹:当某条记录离开文件夹时,会在下次重新计算时被暂停记录。 - **被排除的聊天记录**在任何模式下都不会被记录。在“文件夹”和“整个账户”模式下, 对源聊天记录执行*排除*或*移除*操作会将其加入此列表,因此该范围不会再次将其添加进来。 手动再次选择该聊天(在“来源”中、从“聊天”中或通过“设置”→**哪些聊天?**) 会将其从列表中移除。该列表最多可容纳 5,000 个聊天;超过此限时*,移除操作*将被拒绝, 此时可选择暂停该聊天。 - **自身操作**(默认开启):该账户发送的消息、其编辑操作以及 回复键盘的按键操作。关闭后,将跳过外发消息和编辑操作。 - 切换到某个文件夹或整个账户时会要求确认:这些模式会记录 私人聊天和第三方消息,仅应用于专用账户。 确认操作及每次作用域变更都会生成带有签名的`scope.changed`记录。在 已设置为主账户的账户上,作用域表单和调查功能会拒绝选择文件夹或整个 账户(与start功能相同);仅可进行一次不记录内容的操作。 - 由范围添加的聊天会以标记为*自动*的来源形式显示,并记录为 `scope.applied` (在开始时及每小时一次)或 `source.discovered`(观察期间发现的新聊天)。切换回 选定的聊天会立即暂停所有自动添加的来源,而无需再次读取 该账户的聊天列表。 被排除的聊天在范围 保存后立即停止记录,即使 Telegram 未返回聊天列表,其源也会被暂停。在 监视过程中,保存范围会再次应用该范围,即使数值未发生变化也是如此。 这些模式的范围: - **秘密聊天**功能使用内置的[伪秘密集成](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/), 该集成包含从控制面板安装的协议模块以及按账户启用的开关。云端历史记录 和“数据导出”功能则采用独立的数据获取路径。 - **离线时段。**重启后,TgWitness将恢复保存的更新位置,向 Telegram查询缺失的更新并重新检查聊天记录。Telegram会保留有限的积压数据,因此 在长时间中断后,报告和`verify.py`会将剩余时间段列为缺口(参见[覆盖率](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids))。 - 初始仅列出前1,000个对话(限制可在**更多工具→参数**中查看);较早的 聊天将在下次激活时被添加。已添加聊天的早期历史记录不会被获取——如有需要,请创建历史 快照或导出完整聊天记录。 - 不会应用那些随时变化的文件夹条件(如静音、已读):此类聊天 仍会受到监控。 - 在另一款应用中点击的**内联(回调)机器人按钮**对第二个 会话不可见;机器人的回复或编辑会被记录下来。回复键盘按键操作会作为外发 消息发送,并标记为 `button_press`。 - 聊天量越大,请求就越多。Telegram 会因消息量被其视为 过高而限制账号,这也是使用专用账号的又一个理由。 ### 严格筛选的聊天记录 **Strict: read only the chosen chats** appears under **Chosen chats** and is off by default. It is meant for a permission that covers the chosen chats only. While it is on: - Telegram 的服务通知(777000)未被读取:无论是在观测开始或结束时,还是在观测期间的每 一分钟,均未读取。未写入任何 `session.security_baseline` 或 `account.security_event` 记录。 - The account's session list is not read: not when observation starts or stops (the panel's question about other sessions for **Evidence for a case** and the evidence protection modes is skipped too), not every two minutes while observing, not when a connection opens, and not by the connection check, whose *Current authorization* entry is shown as skipped. The two-step verification status used by the takeover check is not read either. So `account.sessions`, `session.concurrent_at_start` and `session.takeover_risk` are not written, and a session ended from another device is not reported as `session_revoked_externally`. - 虽然这是该账户的唯一会话(**将其设为唯一会话**或其自动版本),但在监视期间以及建立连接时, 系统仍会每两分钟读取一次会话列表,以便在出现另一个会话时 记录 `session.exclusive_ended`。 在此期间,777000 保持未读取状态,尽管 `session.exclusive_from` 记录显示 Telegram 的登录通知仍在持续被记录。 - 只有当过去10分钟内曾运行过会话检查时(且该会话是 唯一的,或者在打开**该账户的会话**后),才会将删除通知与会话检查结果进行比对。 否则,除非上次权限检查显示 该账号无法删除该消息(在私聊和普通群组中绝不会出现这种情况),否则提示信息为:*无法 确定删除者:该账号本身、来自另一个会话或设备,都可能已将其删除。* - 对于已导入的会话密钥,在读取 会话列表(例如在**该账户的会话**中)之前,日志中不会显示该会话的登录时间。在此之前,聊天导出和**自动** 账户导出将使用常规会话而非“Takeout”,原因显示为`session_age_unknown`。 - 启用聊天功能不会读取该聊天的早期消息。如果未启用该开关,每次启用聊天(在“来源”中,通过 “聊天”中,通过面板加入或在设置向导中加入)都会在下次观察运行时,获取其最新消息的一个`baseline`快照, 数量上限为**更多工具 → 参数 → 最大历史快照**(默认值为500)。 当该开关开启时,若待处理的快照在运行期间到期,则会被丢弃。 从面板加入的聊天也不会 将其最新消息作为新聊天进行读取(“**当出现新聊天或机器人**时”的计数,默认值为 100), 而在“聊天”中打开一个没有保存消息的选定聊天时,系统也不会自动加载其最近的 100 条消息。 您自行启动的**加载历史记录**和“快照”功能仍会读取历史记录。 - 该账户的敏感内容设置既不会被读取,也不会被修改。如果没有该开关,当该设置处于关闭状态时,登录和每次新的 连接都会将其开启,且 Telegram 允许进行此更改(`account.content_settings`);该设置 属于该账户,并在所有 Telegram 应用中生效。Telegram 标记为敏感的内容可能会保持隐藏状态。 - 电话通话更新不会记录为`account.phone_call`。 - 停止监视时,仅写入会话密钥指纹;不会读取会话列表或 777000。 It does not narrow what Telegram sends: updates of every chat still reach this session, and only the chosen chats are recorded. The account's chat list (up to **Chats read from the account's list**) and its folders are still read at start, and again when the scope is saved while observing, to find the chosen chats. Deletion notices without a chat (`deletion.unscoped`) are still recorded: they carry message IDs only and may belong to a chosen private chat or ordinary group. The frozen-account check (`help.getAppConfig`), the other connection checks, and features you turn on yourself (ending other sessions automatically, the witness probe, pseudo-secret chats, **Sessions of this account**, and Telegram's list of signed-in devices under **More witnesses**, which reads the session list at each timestamp pass and which setup ticks for the **Follow chats** and **Evidence for a case** goals) keep working. 请在登录前将其开启;否则,登录过程本身会检查当前授权状态并启用敏感 内容。每次更改都会生成一条带签名的 `scope.changed` 记录,而 `observation.started` 会将该值作为 `scope.strict` 携带。切换到文件夹或整个账户时,该功能将被关闭。 ## 范围与事件选择 每个工作区都有其独立的来源。TgWitness不会加入群组、接受 邀请,也不会自动枚举所有成员。来源必须已 可被该账户访问。启动时,收集器会根据账户可见的对话列表 核对所选来源;除非 **更多工具 → 参数 → 从账户列表读取的聊天**中另有说明,否则将检查前1,000个对话。 缺失的来源会被标记为**访问未确认**,不会被视为已将您移除。 | 设置 | 收集 | 禁用时的效果 | | --- | --- | --- | | 新消息 | 普通已发送消息 | 后续的编辑/删除操作可能无法与先前捕获的文本进行比对。 | | 编辑 | 已交付编辑后的消息版本 | 中间的更改不会在后续过程中被重建。 | | 删除操作 | 范围限定删除通知与非范围限定账户级通知 | 删除通知不会被添加到日志中。 | | 反应 | 已交付的反应快照 | 不添加单独的反应更新。 | | 会员 | 已发送会员服务消息和参与者更新 | 这些会员观察内容未被纳入。 | 设置适用于工作区中所有选定的消息源。保存表单以应用 更改;更改将通过带签名的“更改前”和“更改后”值进行记录。禁用某类别 不会删除之前的记录。重新启用该类别也不会补录遗漏的更新。 操作记录及其他群组服务事件与这些 开关设置相互独立。当会员服务功能启用时,会员服务消息仍会生成消息记录, 即使普通的新消息捕获功能已被禁用。捕获的 Telegram 对象保留嵌入的元数据;开关设置并非信息遮蔽规则。 **私聊和普通群组中的删除操作会**以不带聊天上下文的消息 ID 形式出现。 这些聊天共享一个全账户范围的消息 ID 序列,因此当带有该 ID 的消息 此前已被保存时,其所属聊天即可确定:删除操作将记录在该聊天中,并附有 `chat_resolution` 说明具体方式。从未被保存的 ID 将保持为**无作用域的删除**操作,且 明确标记为未解析的聊天。这些是 Telegram 删除通知,即使 其聊天尚无法关联,这些通知也会被保留。 通知的架构包含 ID; 日志会添加接收时间以及任何已保存的消息上下文,包括 `deleted_message_was_outgoing`。可用的管理员日志条目提供了关于 操作、执行者及源时间的独立信息来源。 ## 自主操作 被监控账户发送的消息标记为 `outgoing`。关于外发 消息的编辑说明指出:在私聊和群聊中,仅消息作者可进行编辑;而频道 帖子则可由其他管理员编辑。 当一条发送的消息重复了该聊天中 最新保存的回复键盘上的按钮文本时,该消息会带有`button_press`标记,并附有指向 该键盘记录的链接。 “排除自身操作”的原则同样适用于后台重新检查和自动生成的新聊天记录。 被跳过的发送消息会向前推移重新检查的位置,从而避免阻塞后续收到的 消息。明确的面板操作以及手动请求的历史快照仍会被记录下来。 ## 调查模式:加入团队并与机器人对话 **更多工具 → 来源 → 范围 → 调查模式**为专用 账户准备范围,该账户可加入团队聊天、启动机器人并向其发送消息:包括整个账户、所有 来源类型、自身操作,以及每个出现的聊天或机器人及其个人资料和最近 200条可见消息。检查表单并点击**保存范围**;切换至整个 账户时会要求进行常规确认。 - **按钮。**消息下方的按钮将与该消息一同保留,并在**“聊天”**界面中显示:链接、网页 应用、登录链接、待复制的文本、回调数据、内联查询、请求电话 号码或位置的信息。 链接以文本形式显示,且绝不会由面板自动打开。当机器人 仅更改按钮内容(例如生成新的支付链接)时,这即被视为消息的新版本,无论 是实时更新还是重新检查的结果。 - **新聊天和机器人。**在“文件夹”和“整个账户”模式下,**当新的聊天或机器人 出现时**,系统会在其出现后立即进行保存: - 其作为`source.profile`记录的概况:机器人描述和命令、用户、群组或频道的“关于”文本 、成员、关联聊天以及Telegram返回邀请链接时的 邀请链接; - 将其最新的可见消息(最多 1,000 条)作为标记为 `new_chat` 的历史快照: 刚加入的团队聊天中的早期消息,或观察者注意到该聊天之前 机器人所说的话。已实时保存的消息不会重复记录。 当作用域被应用时,新选中的聊天将使用这些设置,包括 该账户对话列表中已存在的聊天。初始个人资料和历史记录加载 最多可同时处理三个聊天;针对同一聊天的操作将按顺序进行。 每个历史记录/个人资料处理阶段均采用配置的操作超时设置,因此陷入停滞的请求 会释放其工作线程。历史记录会在可选的个人资料读取之前保存;个人资料 读取失败不会阻止历史记录的捕获。 失败的阶段将在 5 秒后重试, 重试时间将翻倍至最多 5 分钟,且在延迟期间不会占用工作线程。 待处理 ID、重试截止时间和已完成的阶段将保存在本地。重启时仅恢复 未完成的阶段;配置文件重试不会重复已完成的聊天记录读取。 在轮到处理前被禁用的来源将被跳过。概览界面会将活跃、待处理 和重试中的聊天加载与附件下载分开显示。 FloodWait 会暂停此项工作,并在之后恢复;失败情况会被记录,而 聊天内容的实时记录则会继续。这包括在解析新聊天 身份期间的等待:待处理的个人资料/历史记录任务将保留以供重试,而现有的 更长时间的账户级等待则不会缩短。工作者共享此等待;并发 不会绕过 Telegram 的请求限制。 - **按需获取个人资料。** **聊天 → 个人资料 → 保存个人资料现**可保存任何来源的 当前个人资料;最新资料将显示在消息上方。 - **聊天状态快照(预览版)。**消息流之外的状态会在没有 消息发送的情况下发生变化:取消固定所有消息不会留下消息级别的痕迹,管理员会 失去权限,礼物会被隐藏、转换、升级或退款。在观察期间,每个已启用的 来源都会被定期读取,并保存为带签名的 `chat.state` 记录保存:标题、用户名、 描述、成员和管理员数量、关联聊天、慢速模式、置顶消息 ID (最多 100 条)、管理员及其权限和头衔,以及频道和 用户个人资料中显示的礼物(最多 100 条)。 每条记录都会列出与上一快照的差异: 已更改字段(含更改前后的值)、新增或移除的置顶消息,以及新增、 更改或不再列出的管理员和 礼物。 - Telegram 拒绝提供的一部分信息(例如,对于非管理员的成员, 该频道的管理员列表)在 `errors`;其先前值会被保留并列于 `carried_forward`中,绝不会被报告为已删除。 - 仅涉及计数变化的记录,以及未检测到变化的检查结果,均指代 最后一次完整状态,并以 `state_seq` 和累积 `state_overrides`。完整状态至少每七天写入一次, 且每当计数以外的任何内容发生变化时也会写入。 - `parts_complete` 标记上限列表。添加操作需要完整的早期列表, 移除操作需要完整的当前列表,而显式的空值则表示清空记录。 - **更多工具 → 参数 → 聊天状态** 可设置间隔(默认12小时,0表示 关闭快照功能)、数据源之间的暂停时间、读取哪些部分,以及是否记录未 发现变化的检查结果。 `FLOOD_WAIT` 并 `FLOOD_PREMIUM_WAIT` 停止剩余的 快照请求,保留任何更长的全账户有效期,并使 被中断的聊天在等待结束后仍可再次尝试。 - **不可见。**在其他 Telegram 应用中点击的内联(回调)按钮、机器人对此类点击作出的弹出窗口或 链接,以及在其他应用中使用的邀请链接均不会到达 TgWitness。但机器人随后发送或编辑的内容会被记录。 ### 面板操作指南 **“聊天”功能**现已包含一个迷你客户端,该客户端使用所选工作区的 Telegram 账户: - 编写一条纯文本消息,或在已保存的消息下方选择**“回复”**。即使范围不包括外发更新,系统生成的外发 消息仍会被记录下来。 - 点击当前回调或文本按钮下方的**“Press”按钮**。服务器将再次获取 该消息,若键盘输入内容与保存版本不符,则拒绝该操作。 回调收据保留 Telegram 的弹出文本、提醒标记和 URL;回复内容也会显示 在对话下方。URL 仍为可选中文本,不会自动打开。 - 点击 **+** → **打开 Telegram 链接**,输入 `@username`、一个公共链接 `https://t.me/name`、 `https://t.me/+invite` / `joinchat/invite`,或包含 `?start=parameter` 的机器人链接,然后点击 **保存预览**。在加入之前,原始链接和 Telegram 的预览都会经过签名。 **加入/打开并观察**后,系统会加入群组/频道或打开用户/机器人,将该 聊天添加为已启用的来源,并向机器人发送`/start`指令(包含其启动参数)。 等待管理员批准的加入请求将记录为“待处理”,而非“成员身份”。 开启**开始观察**以实时捕获传入的回复。当 观察处于暂停状态时,面板操作仍可正常进行;面板会保存其直接响应,而实时 观察则捕获对话的其余部分。 当观察正在运行时,新添加的来源将使用已配置的配置文件/历史记录导入。 当来源处于暂停状态时,请在**更多工具→来源中**启用该来源,然后再发送消息或点击其按钮。 `interaction.preview`、`interaction.requested` 和 `interaction.result` 是证据导出中包含的普通签名 日志事件。请求会标识账户、消息/按钮 或预览记录,以及观察程序是否正在运行。收据可区分成功、 拒绝、待批准和未知结果。中断的请求可能已到达 Telegram:在执行新操作前请检查聊天记录。 重用请求 ID 可检索其 已保存的收据,而无需重复操作,包括重启后。当当前页面会话中同一操作收到模棱两可的响应时,面板会保留该 ID。 当操作成功后刷新视图失败时,面板也会保留该 ID:收据 仍保持可见,再次点击即可检索。 回调和加入 RPC 仅允许一次 尝试;可重试的读取操作将保留其配置的重试策略。立即切换聊天 会立即清除草稿和回复目标,并禁用发送功能,直到新对话加载完毕。 该迷你客户端支持文本和回调按钮。迷你应用按钮会触发**打开迷你应用**功能, 该功能会在隔离的浏览器中加载该应用([迷你应用](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md))。登录、 电话和位置请求、支付、内联查询以及附件功能仍需使用 Telegram 客户端;其已保存的按钮元数据仍可查看。新控件使用英文文本。 ## 重新核对分级 重新检查会再次向 Telegram 查询遗漏的消息、编辑内容以及它不再返回的消息。 标有星号的来源是**优先**来源,默认每15分钟重新检查一次; 所有其他来源每6小时重新检查一次。选定的聊天群组初始为优先来源,通过 文件夹或整个账户添加的聊天群组则为常规来源。 每次循环最多重新检查 30 个来源, 其余的则等待下一分钟;重新连接后,优先级来源将优先处理。这两个 时间间隔均在**更多工具 → 来源 → 记录 → 重新检查**(设置为 0 可关闭该层级)下设置,并 记录为 `recheck.changed`。 遗漏的消息将从上次扫描停止的位置向上补取,最多补取“ **更多工具 → 参数 → 每次聊天和扫描中恢复的遗漏消息**”中设定的数量(默认值为 1,000)。因此,在长时间中断后, 重新检查会填补整个缺口,即使比该缺口更新的实时消息已被优先保存 也是如此。仍在补取中的聊天将在下一分钟再次被重新检查,而不是 等待其层级间隔结束;`recheck.completed`将显示`continues_after`,直到操作完成。 比较内容包括消息文本、实体、键盘输入(包括删除操作)以及附件 内容/标识。 仅更改文件访问哈希值或文件引用并不构成 编辑,Telegram 自动生成的内容也不构成编辑:链接预览加载、故事浏览量、该账户解锁的付费 媒体、发票收据等。聊天记录中保存的每个版本都链接到其完整的日志记录,包括媒体元数据。 ## 消息历史记录与来源归属 假设采集器先观察到“10:00 开会”,随后看到“11:00 开会”, 接着收到一条删除通知。它会将这三条不同的观察结果追加到日志中: 原始文本保留,编辑后的内容作为独立版本保存,而通知则记录了 已观察到删除操作。 如果数据采集是在首个版本消失后才开始的,则该文本将无法获取。 如果在离线期间发生了多次编辑,则仅能保存后续观察到的 版本。删除通知无法恢复从未被捕获的内容。 该记录整合了多个来源: | 来源 | 保留的信息 | | --- | --- | | 实时消息或编辑更新 | 消息 ID、发送者元数据、捕获版本、接收时间以及提供的 Telegram 消息/编辑日期。 | | 实时删除通知 | 报告中的消息 ID、接收时间、原始通知以及先前保存内容的链接。 | | 可用的管理员日志 | 操作、执行者、来源日期及提供的消息内容,由具备相应权限的账户读取。 | | 面板交互 | 在所选账户下请求的操作及其记录的结果。 | | 重新检查 | Telegram 当前的响应与先前保存的消息的对比。 | `observed_at` 是该记录在收集器时钟上写入的时间,且 会随着 `seq`而增加。在处理实时更新时写入的记录还包含 `received_at`,即更新到达收集器的时间,以及 `processing_delay_ms`,即从接收至写入所耗时间;在 观测开始时被暂存的更新,将按到达顺序优先于后续更新进行处理。 `source_at` 若事件提供了源日期,则会保留该日期。电报时钟偏移观测、 时钟不连续性记录和[外部时间检查](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/)提供了 相关的计时上下文。普通消息通知的字段描述了 该通知;管理日志和交互记录则保留其自身的归属信息。 ## 历史快照 快照会从已启用的消息源中请求最新的可见消息,每次请求最多 500条。结果被标记为历史观测记录。手动快照 与常规观测同时运行。重复的观测记录 将作为独立记录保存。启用消息源时,系统还会对其生成一个`baseline`快照,除非 [严格选择聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#strict-chosen-chats)功能已启用。 如果在读取过程中源被禁用,快照将停止。回复必须属于 所请求的聊天,且包含严格递减的、小于所请求 边界的正消息 ID。无效的回复会在该消息被保存之前中断快照; 已保存的消息将连同中断记录一起保留在已签名的日志中。 快照遵循附件政策,但与实时事件切换机制相互独立。 它们不会还原已删除的消息或遗漏的中间版本。您可以在 暂停状态下请求生成快照;其中排队的任何附件将等待观察开始 且下载进程运行后才进行处理。 **历史记录**是单独的独占任务:依次读取所选来源并下载其队列中的附件,不启动监控。暂停会释放账号,恢复则继续已保存的任务。有关多个空闲账号上的日期、语言和回复筛选,请参阅[分布式聊天导出](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md)。 ## 附件处理 附件下载默认开启,当可用磁盘空间低于 1 GiB 时会暂停。收集器会将 消息监控和下载任务一并提交。该任务保留原始媒体 描述符和大小策略,因此后续编辑过的附件不会被悄然替换。 下载操作在消息捕获后执行。下载完成后会生成一个包含 SHA-256 值和字节数的 `media.saved` 记录。被跳过、失败、重试和中断的 操作各有不同的处理结果;当文件存在 `media.saved` 记录时,即视为已保存。 已保存的文件还必须与原始观察到的附件 描述符中的字节数相匹配。过短或意外过长的响应不会被记录为已保存的媒体。 在写入 ``media.saved`` 之前,该文件及其文件夹条目会被刷新到磁盘上。当前一个收集器 进程未正常终止时,下次启动时会读取该运行期间记录为已保存的每个文件。 对于 缺失的文件,或其字节与记录的 SHA-256 值不一致的文件,系统会生成一条 `media.missing_after_restart` 记录,将其 下载任务重新加入队列,并将字节不一致的文件移至 `media-damaged/` 目录。已移至异地存储的文件 不会被读取。 在同一个工作区中,针对同一附件表示形式的并发队列任务 会等待当前活动的传输,然后在重复使用前重新检查其已保存的字节。每个任务都保留 自己的带符号结果以及对先前保存文件记录的引用。取消一个 等待中的任务不会取消当前活动的传输;如果该传输失败或被取消, 下一个任务可以重试。不同的附件可以并发下载。 具有相同账户、表示方式、预期大小和捕获操作的任务会在 一个匹配的任务正在运行时保持排队状态。它们不会占用下载槽位,因此 即使队列开头有大量同一慢文件的副本,其他文件仍可开始下载。 完成一次尝试会唤醒队列。优先级通道、保存的重试延迟和 历史归属规则仍然适用;每次观察都会获得其独立的结果。 聊天导出功能还支持在 同一导出目录内对重复文件表示进行活动传输。每条消息都保留其附件引用,而重复使用 则需要重新计算文件大小并进行 SHA-256 校验。不同文件可并行进行校验, 无需持有共同的传输锁。临时下载和复制路径对每次操作而言都是唯一的; 取消操作会在清理之前等待任何正在活动的本地文件读取器完成。 导出文件索引仅对元数据访问进行序列化,而不对文件哈希或下载操作进行序列化。 针对不同附件的服务器哈希读取操作也会并发执行,并与字节下载共享客户端的 三个文件请求槽。对同一表示形式的重复读取 仅会复用完整的缓存结果。文件读取不会占用普通请求队列; 当请求获得一个槽位时,系统会再次检查已保存的 FloodWait 截止时间。 **各类别均**设有存储限制:照片、视频、GIF 和动画、圆形视频消息、 语音消息、音乐和音频、贴图以及文件。 每种类型均可单独关闭,并设有 1 至 2,000 MiB 的独立大小限制;新工作区初始设置为:照片 20 MiB, 视频 100 MiB,文件、音频和圆形视频 50 MiB,语音和 GIF 20 MiB, 5 MiB用于贴纸。新工作区默认关闭GIF和贴纸功能,需手动开启。在按类型设置限制之前已保存策略的工作区,将保持所有类型启用,并保留其针对每种类型的单一 限制。*最大文件大小*设置将一次性调整所有类型。 关闭某类文件会生成 一个`media.skipped`记录;未知大小或超大文件将不会被下载。大文件将根据 其大小和256 KiB/s的基准速度获得额外的下载时间。任务在 重启后仍会保留,但过期的引用、访问权限丢失或文件被删除仍可能导致无法恢复。 待处理任务会保留与其关联的限制值,因此提高的限制仅适用于新文件。 禁用某类型或降低其限制值也会跳过该类型所排除的待处理文件,每个文件都会生成 一条`media.skipped`记录;禁用下载功能会暂停队列,直到该功能被重新启用。 ## 暂停、锁定、断开连接和重启 | 动作或状态 | 效果 | | --- | --- | | 切换工作区 | 更改面板视图;其他收集器的状态保持不变。 | | 锁定面板或关闭标签页 | 保持服务器和监控功能持续运行。 | | 暂停观察 | 停止该收集器并保留队列中的附件处理工作。 | | 禁用一个消息源 | 停止未来的范围捕获;在此期间,与其相关的队列中的媒体任务将处于等待状态。 | | 移除来源 | 系统会将其作为消息源忽略并删除相关用户资料;已保存的记录仍保留在仅追加的日志中。待处理的附件将被记录为失败(`source_removed`)。在文件夹模式和整个账户模式下,这些内容同样会被排除在外。 | | 更改连接路径 | 需要暂停,关闭旧客户端,并取消未完成的登录。 | | 停止 Python 进程 | 停止所有工作区;离线期间不会进行任何监控。 | | 主动观察后重启 | 尝试使用已保存的会话恢复已保存的范围。手动暂停将清除该意图。 | 收集器记录检测到的断开连接、重试、错误、启动/停止以及 心跳。周期性的连通性检查可能会遗漏短暂的中断。 重启后,系统会从保存的更新位置请求遗漏的更新,并 周期性地重新检查已观测的聊天记录;参见[证据格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#durable-collection-and-process-receipts-02)。快照将当前状态 作为上下文添加,且缺口仍会被记录下来。 ## 账户隔离与验证 每个工作区都有独立的日志、授权、签名密钥、策略和队列。 只有其活跃客户端才能提交实时观察记录。被拒绝、待处理、 被取代以及连接测试状态的客户端均无法将实时更新写入其日志。 不同账户可以观察同一个群组,但各自的日志仍保持独立。 每个事件都包含前一个哈希值和一个 Ed25519 签名。导出内容涵盖 整个工作区日志,并通过固定序列号进行标识。面板过滤器不会过滤 导出内容;在导出准备期间,数据收集可能仍会超出其边界继续进行。 **“验证日志”**功能会通过显示的 边界检查事件链和签名。当工作区发生变化时,其结果将被清空,面板会标识 检查后新增的记录。ZIP导出功能还会对收集的媒体文件进行验证。 请分别保留指纹和检查点。有关各模式下的采集检查,请参阅 [验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)部分, 有关常规采集,请参阅[日常操作](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/)部分。 --- # Telegram · 秘密聊天:设置与记录 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/ 安装秘密聊天协议扩展,按账户启用,并记录 TgWitness 创建或接受的聊天。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 安装秘密聊天协议扩展,按账户启用,并记录 TgWitness 创建或接受的聊天。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) 已发布的应用程序包含“秘密聊天”后端、收集器集成、 API 路由以及 **Pseudo-secret** 接口。协议库是一个独立的模块: 打开 **Pseudo-secret**,点击**安装并开启**。自动接受来信 功能默认处于关闭状态,需手动开启。 ## 协议模块 | | | | --- | --- | | 模块 | `kiaro-telethon-secret-chat` 0.2.0 | | 作者 | KiaroSama | | 许可协议 | GPL-3.0-or-later;其 `LICENSE` 且 `NOTICE` 保留在保存的归档文件中 | | 来源 | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) 在提交时 `d87bf037b90060383c7b704d8a06ebb98c621c6f` | | 检查 | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` 对软件包文件列表及其各自的 SHA-256 值进行校验 | **安装并启用功能**仅对主管理员开放。TgWitness 会通过工作区用于处理 Telegram 外部请求的通道,从 GitHub 下载该提交的 源代码归档包,将包中的每个文件与 TgWitness 发布版本中固定的值进行比对,将归档包保存至 `modules/telethon-secret-chat-.zip` 数据目录中, 并从内存中加载代码。无需重启。每次启动时都会 重新运行检查;若归档文件存在差异,则不会被加载,页面上会显示相应提示。 若包文件发生更改、缺失或被添加,检查将失败。 该模块是一个独立作品,拥有自己的许可协议。TgWitness 并不随软件分发该模块:每次 安装时,系统都会从作者的代码库中下载该模块。页面上的**详细信息**会显示 已加载的模块、其作者、许可协议、提交信息和 SHA-256 值。 如果主机无法访问 GitHub,则可以将相同的提交安装到 Python 环境中;随后,控制面板将使用该副本: ``` python -m pip install ".[secret-chats]" ``` TgWitness 成为其创建或接受的聊天窗口的端点。它将 消息、可用附件、计时器变更及删除通知记录在已签名的 日志中。先前保存的内容在后续收到删除通知后仍可访问。 ## 软件包可用性 2026 年11月8 日,已发布的安装包在源代码 [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) 处经过验证, 发布版本`b35f8e18f3d1-1ff85ec98bb2` ,版本0.9.1 预览版。 [不可变的](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) Wheel及其依赖项锁已通过SHA-256 和RSA发布签名验证。 打包后的后端和接口与该源代码修订版本字节对字节完全一致。 该包还包含API注册和收集器挂钩。 该软件包中不包含协议库,且该库也不在依赖项 锁定文件中。pyproject.toml 文件中 `secret-chats` [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) 文件中的 extra 项锁定了与 面板按钮相同的提交。 此软件包检查确定了哪些文件和依赖项声明被包含在内。 [验证记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)标识了各自独立的运行时检查。 此前 11 月 6 日的指南描述了一个开发快照;它不再 描述上述软件包。 ## 使用该接口 打开 **Pseudo-secret,**如果页面提供该模块,请安装它,然后为该账户启用并连接。 除非启用了自动接受功能,否则传入的请求将等待接受。 启动、接受、发送和关闭操作均使用该账户的交互权限 和只读保护。 | 操作 | 保留的结果 | | --- | --- | | 通过用户名或用户 ID 发起聊天 | 出站请求;对等方在其设备上接受该请求。 | | 接受请求 | TgWitness将成为接收端点。 | | 发送或接收消息 | `secret_chat.message`,包括其方向、内容及提供的计时器。 | | 接收文件 | 由 SHA-256 和 `secret_chat.file` 收据保护的解密字节;包含在证据导出中。 | | 接收计时器或删除通知 | 除保留的消息和文件外,还包含一份独立的操作记录。 | | 审查聊天记录 | 对话、文件收据、通知和密钥可视化。 | 在另一台设备上现有的秘密聊天将保留其设备专属密钥。 导入的云会话不会传输这些密钥。秘密聊天的密钥素材和 计数器使用工作区保险库;已保存的消息和解密后的文件则采用 常规的工作区存储保护机制。 ## 查找已保存的消息 在已打开的聊天窗口中使用**搜索消息**功能查找精确短语,且不区分 大小写。在搜索框中点击**上一条**和**下一条**,或按下“Enter”和“Shift+Enter”, 可在匹配的消息之间切换。计数器显示消息数量;每条消息中第一个匹配的 短语会被高亮显示。按“Esc”键可清除搜索内容。 “搜索”功能会将周围的对话、已保存的文件和删除提示 保持在可见状态。它会搜索面板中已加载的记录。如果还有 更早的记录,面板会予以提示;**加载更早的记录**会扩展历史记录并 更新搜索结果,同时保持当前消息的位置不变。 在同一工作区内切换时,每个聊天窗口都会保留其搜索记录。锁定 面板或切换工作区会清除这些搜索记录。搜索词保存在 页面的内存中,不会存储在浏览器存储中,也不会作为 API 查询发送出去。 搜索操作不会发送 Telegram 消息,也不会触发输入/已读通知。现有的 可见性设置仍将控制打开聊天窗口及其他操作。 **生成报告时**将保留所选聊天的报告范围;显示搜索 不会在后台限制导出的记录。请在下载报告前 预览报告的选定范围。 ## 持久化与交互控制 该集成实现采用持久日志查询进行重复检测, 在下载失败后将附件任务保持为待处理状态,并将关闭操作通过 与其他远程操作相同的交互守护程序进行路由。这些机制取代了 历史上的 11 月 6 日开发快照审计中报告的三条路径。 解密后但日志写入失败的消息将保存在保险库中以供重试。 系统会根据附件大小和可用磁盘空间进行检查,在保留相关任务的同时推迟下载。 该模块会复用该账户的现有连接。阅读和输入通知仅在 [对方可见内容](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees)中选定的情况下发送;截图 通知绝不会发送。参见 [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py)、 [API 路由](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py)和 [访问策略](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py)。 [历史审计](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)保留其原始 快照结果。当前的可用性和实现情况应参考 上方的软件包修订版本及[当前功能](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)说明。 ## 界面演示 网站场景使用虚构的请求、消息和文件来演示 面板的工作流程。这是一个界面示例;协议和采集检查 在验证记录中各有其带日期的结果。 --- # Telegram · 加载源代码历史记录 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/history/ 从已启用的来源加载历史消息,暂停和恢复操作,并验证带签名的进度报告。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/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 导出是分开的。 若要进行全账户范围的收集,请选择**“整个账户** ”并保存该范围。历史记录 会在签署其源 列表之前刷新所有可访问的对话框,包括已归档的聊天记录。此发现过程不受“已选聊天”选择器列表限制的约束。随后发现的 聊天记录将被监视,并获取其配置的初始快照;再次执行完整运行可 加载其早期历史记录。请**保持在历史记录加载期间及之后保持监视选项** 启用,以便在历史记录加载时记录新消息、编辑和删除通知。 每次历史记录运行或导出都会占用一个采集槽;实时监视则与其并行运行。 选择一到三个并发聊天、一到五个附件处理器,并决定是否保留可用的“最近操作” 以及是否比较先前保存的版本。在 Telegram 中,数据导出可能需要获得批准,并需 等待服务器指定的时间。这些选项在恢复时保持不变。有关传输、重试和信任的详细信息,请参阅[补全行为和 证据合约](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md)。 ## 暂停、重启和部分结果 - **暂停历史记录**将停止读取。**继续历史记录**将从每个来源中最后一条已提交的 消息开始恢复;重新启动应用也会使运行状态保持暂停,直至恢复。 恢复时需要使用同一闲置的 Telegram 账户。 - 消息观察、附件处理和光标提交在一笔事务中完成。 恢复运行时不会重复已提交的观察结果。实时捕获或 单独、显式启动的运行可独立观察同一条消息。 - 每个数据源(Takeout 中的每个 Telegram 拆分范围)在首次读取时会固定一个最高消息 ID。较新的消息属于 实时观察,而不属于该数据源剩余的历史页面。 - 无法访问的来源以及在采集过程中被禁用的来源仍会显示为 “失败”或“跳过”。其他来源将继续采集;最终结果将不完整。 - Telegram 仅向群组管理员显示聊天记录的管理员日志。对于普通成员, 读取管理员日志的操作会被记录为 ``history.admin_log.unavailable``,`reason: not_admin`, 且不会导致历史记录不完整;而管理员读取管理员日志失败时,则会导致历史记录不完整。 - FloodWait 的延迟会遵循已保存的账户退避策略。对于瞬时故障,最多重试 五次;资源耗尽或磁盘空间不足时,操作将暂停,光标位置保持不变。 - **结束本次历史运行**会保留已保存的观察结果。该操作不会删除这些观察结果,也不会 取消标准 API 附件任务。结束Takeout会将其剩余的Takeout 文件标记为已跳过;暂停则会保留其可恢复状态。新运行会重新读取已启用的来源。 历史记录补全仅指历史记录的读取操作。附件可能仍处于待处理状态、 处理失败,或被配置的策略排除。请在日志 和附件队列中检查媒体回执;只有字节数据完整且已保存的回执才构成 已保存的附件。历史记录操作是一项显式的快照请求,与 用于选择未来实时事件类别的开关独立。 ## 传输与验证 保存**已签名的进度报告**,然后使用**“导出证据**”功能下载 日志和已保存的附件。后续的证据导出可能包含额外记录; 该报告将其计数器与创建时的日志前缀绑定。 请从此版本的可信代码检出中运行验证器: ``` python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT ``` 请将预期的签名密钥指纹单独保留。验证器会检查 报告签名、证据存档、报告检查点、源计划、账户 以及已保存/不可用消息的计数。新运行还会将源进度和 选项绑定到已签名的光标事件中。若未指定`--evidence`,则仅检查 已签名的报告及其内部一致性。旧版进度字段和附件 摘要仍为已签名的收集器声明。证据验证器会检查存档的媒体字节。 读取经过验证的历史记录及其采集间隔、覆盖范围和 可用的“最近操作”。此工作流读取当前可访问的历史记录; [实时监控](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#message-history-and-attribution)会在版本 生成时保留版本及通知,而[秘密聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)则使用 已启用的端点集成。进行验证时,请使用保留的检查点、 见证记录以及 [验证模式中](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)所述的适用采集证明。 采集光标代表本地工作区的状态。仅恢复证据 ZIP 文件并 不会恢复待处理的采集任务或 Telegram 会话。若需继续执行原始任务, 请保留工作区备份。 --- # Telegram · 工作流程与操作 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/operations/ 控制面板的日常操作:模式、监控类别、参数、通知、导出、备份及容量。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 控制面板的日常操作:模式、监控类别、参数、通知、导出、备份及容量。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [部署与恢复](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) ![部署与恢复](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) 首次连接时,请[使用账户和会话格式](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)。 有关保存版本、事件策略和数据缺失的说明,请参阅 [“数据采集原理](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/)”。本指南涵盖日常操作和数据恢复。 受管安装包除启动器外,还包含 **、START-HERE.html、**、**、START-HERE.txt 以及**, 其中包含针对其安装路径定制的仓库链接和命令。通过 SSH 运行 `tgwitness guide --print`,或运行 `tgwitness paths` 以定位 实际数据目录。root 级 systemd 安装将私有状态存储在 `/var/lib/tgwitness-…` 中;`/opt/tgwitness` 存放程序本体。 对于托管式临时 Cloudflare 隧道,`tgwitness tunnel off` 将关闭公共 访问,同时本地控制面板和数据收集功能仍继续运行。`tgwitness tunnel on` 将其启用;`tgwitness tunnel restart` 创建新的隧道连接。使用 `tgwitness open` 查看其当前地址。显式关闭设置在 服务重启后仍会保留。`tgwitness stop` 将同时停止控制面板和数据收集功能。 **本页内容** - [操作员工作流程](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#operator-workflow) - [在不共享主密钥的情况下共享工作成果](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#share-work-without-sharing-the-main-key) - [运行模式](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#runtime-modes) - [监控类别](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#monitoring-categories) - [通知](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#notifications) - [面板布局](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#panel-layout) - [部署环境](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#deployment-environments) - [启动检查与导出](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#startup-checks-and-exports) - [备份、恢复和中断](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#backup-restore-and-interruptions) - [容量与保留期限](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/#capacity-and-retention) ## 操作员工作流程 流程图 · 选择存储方式和密钥保护方案 → 使用其令牌打开面板; 使用其令牌打开面板 → 选择工作区; 选择工作区 → 配置直连或代理路径; 配置直连或代理路径 → 输入手机号码或选择文件 / QR码; 输入手机号码或选择文件 / QR码 → 验证账户身份并选择可加入的群组; 验证账户身份并选择可加入的群组 → 保存事件和附件策略,然后开始监控; 保存事件和附件策略,然后开始监控 → 监控错误、访问、队列和磁盘; 监控错误、访问、队列和磁盘 → 保留独立检查点; 保留独立检查点 → 导出和验证材料 · 选择存储方式和密钥保护方案 · 使用其令牌打开面板 · 选择工作区 · 配置直连或代理路径 · 输入手机号码或选择文件/ QR码 · 验证账户身份并选择可加入的群组 · 保存事件和附件策略,然后开始监控 · 监控错误、访问、队列和磁盘 · 保留独立检查点 · 导出和验证材料 **图表转为文本** 1. 选择存储方式和密钥保护方案 → 使用其令牌打开面板 2. 使用其令牌打开面板 → 选择工作区 3. 选择工作区 → 配置直连或代理路径 4. 配置直连或代理路径 → 输入手机号码或选择文件 / QR码 5. 输入手机号码或选择文件 / QR码 → 验证账户身份并选择可加入的群组 6. 验证账户身份并选择可加入的群组 → 保存事件和附件策略,然后开始监控 7. 保存事件和附件策略,然后开始监控 → 监控错误、访问、队列和磁盘 8. 监控错误、访问、队列和磁盘 → 保留独立检查点 9. 保留独立检查点 → 导出和验证材料 授权、传输连接、群组访问权限以及 消息送达完整性是不同的属性。绿色连接状态并不意味着所有 事件均已被捕获。 ## 在不共享主密钥的情况下共享工作成果 打开**更多工具→访问权限**,为审核员或分析师分配专属令牌。选择他们 可以打开的账户和聊天群,然后授予查看、导出或操作权限。 启动/停止收集的操作员需要整个工作区的访问权限;审核员 的权限可限制为单个聊天群。会话限制、过期规则和 IP 规则与 Telegram 账户授权相互独立。参见[访问与权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)。 使用**“打开的会话”**功能可终止单个连接,或撤销访问权限以终止所有 会话。管理员控制台整合了跨 工作区的当前进程活动。关闭会话后,数据采集仍将继续运行。 ## 运行模式 | 模式 | 操作 | 行为 | | --- | --- | --- | | 演示 | scripts\Demo.cmd 或 `--demo` | 合成数据;已禁用真实账户关联功能 | | 观察 | 开始监控 | 记录所选来源的已发布更新 | | 历史快照 | 聊天 → 聊天操作 → 加载历史记录 | 最多可记录 500 条当前消息;不重建所有历史变更 | | 暂停 | 暂停观察 | 在保留数据和队列任务的同时停止采集 | | 审核/交接 | 导出功能 | ZIP、JSONL/CSV/HTML、检查点、处理回执和时间戳请求 | | 多个账户 | 工作区或顶部的 **+** 按钮 | 在一个进程中可创建任意数量的独立工作区 | 本地演示访问将自动开启,无需手动输入令牌。该功能采用 进程生命周期权限,仅适用于直接回环访问一个隔离的 合成演示环境;主控制面板的令牌不会被披露。真实工作区以及远程 或通过代理访问演示环境仍需进行令牌身份验证。进入演示环境并不授予任何 Telegram 授权。 ## 监控类别 ![支持按账户设置监控参数,并提供合成源数据](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c) 在**更多工具→源→记录→选择要保留的更改**中,可分别选择新消息、编辑、 删除通知、反应更新和成员事件。默认设置 保留所有类别。**消息、编辑和删除**选项保留原始上下文, 同时禁用单独的反应/成员更新。**所有可见活动**选项则恢复 全部五类。预设会更改表单;点击**保存记录设置**以应用。 保存的策略适用于该工作区中所有选定的消息源。其他 工作区将保留各自的设置。每次实际变更都会记录带签名的变更前/变更后 值;当前策略也会包含在处理收据和观察 开始记录中。禁用某类别不会删除之前的观察记录。重新启用 该类别也不会恢复已遗漏的变更。 此版本中不支持按组覆盖类别设置。 当先前内容重要时,请保持“记录新消息”功能启用:删除通知无法 恢复从未被捕获过的文本。操作/覆盖记录及其他群组 服务事件将始终被保留。 明确的历史快照与 实时分类选择相互独立,且可能包含服务消息。这些开关不会 对嵌入在已捕获 Telegram 对象中的反应/成员元数据进行屏蔽。 历史快照在暂停期间可能会将附件加入队列。开始监控以处理 这些附件。“已加入队列”并不意味着已下载。若原始文件不可用,系统不会用 较新的编辑版本进行替换;处理结果将分别记录。 **点击“锁定”**按钮将清除浏览器访问权限和密钥字段,但数据采集仍将继续运行。 关闭标签页后,进程仍将继续运行。停止 Python 进程或服务 将终止数据采集,无论浏览器状态如何。 只有在包含该工作区的日志及其“案例板”笔记的已签名 ZIP 或 ASiC-E 容器被完全下载后,才能删除该额外工作区。仅准备好归档文件还 不够:如果存在设置事件之外的记录,或者在下载后添加了笔记,则**删除** 选项将不可用。 当面板接收到文件本身时,它会在接收完每个 字节后才将该导出计入统计,然后将文件大小上报至 `POST /api/exports/{id}/received`;中途中断的 下载不会被计入。如果使用浏览器保存选择器(文件系统访问),则面板会在 文件写入并关闭后进行上报。 如果没有文件保存对话框,面板会将接收到的文件传递给浏览器的 下载管理器,且无法得知浏览器是否保留了该文件(例如当保存对话框被 取消时);此时面板仅报告下载已开始,而非文件已保存。 由 浏览器自行下载的文件(即超过面板浏览器缓冲区大小的导出文件)以及 由其他 HTTP 客户端进行的下载,在服务器发送完整响应后才被计入。由于 操作系统和反向代理会缓存数兆字节的响应数据,因此对于此类 下载,服务器无法检测到接近末尾时的中断。 除非面板显示文件已保存, 否则在删除前请检查已下载的文件。群组导出在 准备完成后立即下载时,会计入其账户统计;而从**已准备的导出**中再次下载则不计入。 Before deleting, the panel shows the format, size, preparation time and SHA-256 of the last downloaded signed archive and asks to confirm that this archive is saved outside the workspace. The server refuses `DELETE /api/profiles/{id}` without `kept_copy` set to that SHA-256 (or to `confirmed` for an archive downloaded before the fingerprint was recorded). 删除额外的工作区将停止其收集器并清除其本地数据。如果 因文件被锁定或文件系统错误导致删除中断,控制面板将报告失败,并 将该工作区标记为不可用(`DeletionPending`)。请关闭正在使用其 文件的程序,然后重试**“删除”操作**。 重启 TgWitness 不会恢复该工作区的运行状态,也不会 重建其部分已删除的日志或密钥。只有在目录被移除后, 才会记录成功的删除操作;单独导出或备份的副本仍 受其自身的保留策略约束。 ## 通知 打开**设置→通知和异地备份→通知目的地**,或 **更多工具→扩展功能→通知→配置**。TgWitness使用 Apprise向Matrix、Telegram、Discord、Slack、ntfy、电子邮件及其他 受支持的服务发送警报。您可以在一个工作区中添加多个通知目的地。 1. 每行输入一个 Apprise 目标 URL。请根据您使用的服务 [,参考服务目录和 URL 格式](https://appriseit.com/services/)进行设置。 2. 开启“**发送通知**”功能,然后选择问题警报、受监控 聊天中的变化以及每日摘要。摘要显示的时间以服务器时间为准。 3. 若希望在警报中包含已删除和已编辑 消息中的保存文本,请开启**“包含简短摘录**”选项。 4. 点击**“保存通知**”,然后点击**“发送测试**”以检查送达情况。 若要使用您自己的接收端,请使用 Apprise 的 [JSON Webhook](https://appriseit.com/services/json/)。 例如, `jsons://notify.example.org/tgwitness` 通过 HTTPS 将 JSON 发送至该 端点。这是一个虚构的示例;请将其替换为您的实际目标地址。 目标和设置属于所选工作区。变更通知 涵盖其监视的来源,包括新添加的聊天。顶部栏中的铃铛图标 还会列出最近的问题和聊天变更。 在演示中,通知控件可见但发送功能已禁用。请在真实的工作区中配置 发送设置。通知使用该工作区的 Direct、SOCKS5 或 HTTP 路由;MTProxy 无法传输通知。SMTP 等非 HTTP 目标需要 直接路由。 ## 面板布局 ![使用合成数据连接工作区](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29) **日志**显示观察结果、搜索和筛选结果。编辑操作会显示已捕获的版本; 删除操作会显示先前内容(如有)。来源不明的信息将明确标注。 统计数据可在**“概览**”中查看;采集详情保存在本地指南中。 打开已编辑的消息,使用**文本内差异**或**并排比较**来对比其不同版本; **原始数据**会显示已保存的字段。隐藏链接和机器人按钮的更改会 单独显示。打开附件预览以检查已保存的图像、音频或视频; 下载按钮可让您随时获取保存的原始文件。 当新记录到达时,**Live** 会实时更新日志和聊天。在审阅时可以将其暂停, 或者在准备好后使用新事件按钮;后台收集会继续运行。按 **Ctrl/Cmd+K** 可查找面板操作并搜索日志。 **更多工具 → 来源**包含观察范围(选定的聊天、Telegram 文件夹或整个 账户)、各类可访问的聊天、带有优先级星标的精选来源、附件 和重新检查设置以及历史快照。私有来源通过对话/ID 选择,不提供公开链接。访问状态描述的是最近一次检查结果,而非永久权限。 筛选来源并勾选其复选框,即可批量启用、暂停或将其标记为优先。 在可用聊天列表中,**添加所选项**会使用您当前勾选的项; **添加所有匹配项**会使用当前的搜索和类型筛选条件。 **“聊天”→“联系人”**列出了所有已保存消息的联系人;若该聊天已启用联系人资料功能, 点击即可打开该联系人的资料页面,其中包含指向日志记录的链接。 **更多工具 → 扩展功能 → 独立见证人**会生成只读的见证令牌,显示每个见证人上次检查的时间,并 提供运行[独立](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)见证人的命令和选项。 **更多工具 → 参数**包含工作区中未在其他页面列出的所有限制和节奏: 读取的对话数量、聊天列表的重新读取频率、心跳和检查点 间隔、启动缓冲区、重新检查如何分发请求(首次延迟、每次 ,聊天间隔、已恢复和重新请求的消息),磁盘预留空间,下载的超时和 重试,用户资料的搜索条件(包括您自定义的正则表达式), 通知的大小和频率,快照、ZIP 及浏览器下载限制,以及 Telegram 客户端的超时和重试。每个字段都会显示其范围和默认值;已修改的字段会 被标记,并可逐个或全部恢复。 每次更改都会作为 `parameters.changed`记录下来,并附带更改前后的数值;观察开始记录会标注 当前生效的数值。数值从下次使用时起生效;客户端超时和重试则从 下次连接时起生效。重新检查间隔、附件类型和大小、证据以及站外副本 间隔仍保留在各自的页面上,其数值可在范围内的任意值,而不仅限于预设值。 顶部栏中的铃铛图标列出了被监控聊天群组中的近期问题和变化;未读项 会持续计数,直至被标记为已读。变化按聊天群组和小时分组显示(“12条已删除, 1条已编辑,0条未找到”),而诸如注销或磁盘空间已满等问题将始终保留在列表中, 无论聊天群组活动多么频繁。 **更多工具 → 账户** 注册从手机号码字段开始。**“继续** ”将直接跳转至 代码输入界面,仅在缺少 API 凭据时才会要求输入。二维码和文件导入是 替代选项卡。已保存的 API 凭据仅在所属工作区内重复使用。 登录界面没有侧边栏、统计数据或设置说明。点击“**设置** ”图标可打开 API、代理、存储以及其他账户的控制选项。新建工作区会 [首先 进入 初始设置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/) ;登录后,包含已保存数据源和记录的工作区将打开**聊天界面** 。 更改路径需要暂停监控,并会取消未完成的登录操作。现有 日志无法在用户不知情的情况下重新绑定到其他 Telegram 账户。 **导出功能会**检查日志完整性并生成可移植文件。其工作区 ID 可传递给下载命令行工具。每次导出都会固定一个完整的日志前缀;后续 事件将纳入下一次导出。搜索过滤器不会改变包作用域。 详细的签名和覆盖范围信息请参见**验证与证据**部分。 在“收集器状态”面板中,会显示收集器状态、排队/失败的媒体文件、最旧的待处理媒体文件、可用 磁盘空间、请求暂停情况,以及访问状态未确认的来源。**这些**详细信息初始状态为折叠状态,并在“账户”页面中被隐藏。一个设置 卡片会显示下一步操作:连接账户、选择来源或开始监控。 账户列表为加载时的快照; 所选工作区会定期刷新。这并非多进程 SLA 监控工具。 界面使用本地资源,并以文本方式呈现源内容。已测试 Chromium 中的桌面布局和窄屏布局。 ## 部署环境 | 环境 | 安装 | 验证状态 | | --- | --- | --- | | Windows 个人电脑/服务器 | Python 3.11+、scripts\Setup.cmd/Start.cmd、私有数据目录 | 已在 Windows/Python 3.12 环境下本地测试 | | Linux 服务器/VPS | Python venv、专用服务用户、HTTPS/SSH | 提供了代码、持续集成(CI)及 systemd 示例;未在此主机上运行 | | macOS | Python venv、前台进程或用户代理 | 提供了 launchd 示例;需单独进行安装验证 | | Docker/Compose | 持久卷,一个工作节点 | 提供定义和 CI 运行时检查;本地无法使用 Docker | | 手机浏览器 | 连接到正在运行的服务器上的受保护控制面板 | 已测试窄屏 Chromium 布局;数据采集器不支持 iOS/Android 系统 | 可移植性意味着无需强制使用云服务或构建前端。每个目标系统仍 需要兼容的 Python/加密依赖项、本地磁盘及网络访问权限。请参阅 [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) 文件及[服务模板](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md)。 工作区共享 CPU、内存和事件循环。为实现进程隔离,请使用不同的 实例、端口、数据目录和账户授权。不同实例之间不存在统一的 控制面板。切勿让多个工作进程指向同一个数据库。 ## 启动检查与导出 在启动预配置环境前,请运行 `python start.py --check`。若需进行机器可读的检查,请添加 `--json` 参数,或传入预设的 `--data-dir`、`--host` 和 `--port` 参数。 该命令会在无需登录 Telegram 或创建日志的情况下检查先决条件。 日志验证在应用程序启动时运行,捕获就绪状态将显示 在面板中。端口已被占用可能仅仅是因为已有实例存在。 支持文件系统访问 API(File System Access API)的浏览器会通过可写 流保存导出数据。其他浏览器最多缓冲 128 MiB。若需导出更大容量的 数据,或使用不支持文件流的浏览器,请使用流式 CLI: ``` python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip ``` 从“Exports”中添加 `--profile ID` 以创建子工作区。使用 `--url https://server` 进行远程访问。仅允许将普通 HTTP 用于回环目标。令牌 从文件中读取并作为标头发送,不会被打印或放入 URL 中。不接受 重定向。现有目标不会被覆盖。 传输失败时将删除其 临时部分文件。报告的 SHA-256 值是传输校验和;请使用可信的指纹/检查点单独验证该签名 ZIP 文件。 ## 备份、恢复与中断 1. 暂停监控并干净利落地终止该进程。 2. 复制整个数据目录:数据库、WAL/SHM(如有)、媒体文件、 `credentials.enc`、`signing.enc`、`network.enc`、保险库密钥/元数据、令牌、 检查点以及所有`profiles/`目录。 3. 对于外部密钥模式,请将主密钥单独保存,并保留每个 `vault.external.json`。生成新密钥无法恢复旧的密钥。 4. 在目标端停止运行时进行恢复;配置原始密钥、限制 访问权限,并在恢复运行前验证完整性。 5. 记录停机时间及验证结果。停机时间始终作为记录中的间隔存在; 历史快照则会添加其后的状态。 Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/#updates-and-backups). Four things are protected differently: | 内容 | 保护 | | --- | --- | | 未设密码的导出文件(默认) | 已签名,因此可检测到任何更改;设置密码即可加密导出文件 | | 设有密码的导出文件 | 如果您设置了密码,生成的导出文件将原样封装为 WinZip AES-256 压缩包,该压缩包可由 7-Zip 和 WinRAR 打开;密码不会被存储([符合证据处理规范](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/)) | | 日志数据库及存储在磁盘上的附件 | 加密磁盘或卷以及文件夹权限 | | Telegram 会话与签名密钥 | 数据目录中已加密(`credentials.enc`、`signing.enc`、`network.enc`) | 全量备份是指上述所述的已暂停数据目录,而非导出文件。 两者均应使用受保护的存储空间和经过精心设计的传输机制。临时服务器导出文件存储在每个工作区的 `temporary-exports/` 中;已完成的响应会被清理,而中断的导出 文件将在下次启动时被移除,此时该工作区的实例锁处于持有状态。 在连接恢复事件发生后,收集器会从 已保存的更新位置请求缺失的更新。持久化媒体任务和 Telegram 更新位置在重启后仍会保留;参见 [证据格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#durable-collection-and-process-receipts-02)。 ## 容量与保留期限 默认限制(均可在**更多工具→参数中**修改):前 1,000 个对话,每张快照 500 条消息 ,4 GiB 未压缩的签名 ZIP 内容(更大的归档文件需要 `verify.py --max-gib N` 并使用 128 MiB 浏览器备用方案。附件每种类型占用 1–2,000 MiB ,设置**路径为更多工具→源→录制→附件**。下载 CLI 的默认传输量为 5 GiB。可用磁盘空间可能 是下限。 请为日志、媒体、WAL、临时导出和备份预留空间。 导出操作使用数据卷,而非 Compose 的 512 MiB `/tmp` 目录。 应测量每秒事件数、队列年龄、媒体字节数和磁盘延迟,而非仅统计 组数。实时交付情况在运行中的收集器上进行测量。 系统不支持自动保留删除。删除日志尾部将使其 与已保留检查点之间的关联失效。 优先复查已经可用:带星标的来源默认每 15 分钟复查一次,其他来源每 6 小时复查一次(参见[复查层级](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#recheck-tiers))。受密码保护的导出按上文所述工作。限定范围的访问记录在[访问与权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)中。参见 [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md)、[LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) 和 [VERIFICATION.md](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)。 --- # Telegram · 调查模式 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/ 涵盖频道、群组、私聊和机器人的全账户调查,从调查范围到经过验证的案件资料包。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 涵盖频道、群组、私聊和机器人的全账户调查,从调查范围到经过验证的案件资料包。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![调查](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) 可跨频道、群组、私聊和机器人追踪案件全过程,从最初的 数据采集到带引用时间线及可验证的交接记录。交互式网站 版本位于 `/docs/cases/`;[预览说明](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)。 **本页内容** - [已验证案例:四个对话中目标地址发生变化](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#worked-case-a-destination-changes-across-four-conversations) - [1. 界定案例并收集完整记录](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#1-define-the-case-and-collect-the-whole-account) - [2. 盘点所有来源并获取历史背景](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#2-inventory-every-source-and-acquire-historical-context) - [3. 保留不断演变的案例和有意的交互](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#3-preserve-the-evolving-case-and-deliberate-interactions) - [4. 关联不同聊天中的观察结果](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#4-connect-observations-across-chats) - [5. 构建跨聊天室时间线](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#5-build-the-cross-chat-timeline) - [6. 添加账户视角,同时保留其来源](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#6-add-account-perspectives-without-losing-their-origin) - [7. 整理并验证案件移交](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#7-assemble-and-verify-the-case-handoff) - [调整调查内容](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/#adapt-the-investigation) ## 案例分析:四个对话中目的地发生变化 一条公告指向了一个机器人。一个行动小组正在讨论一个新的付款 目的地,该机器人的键盘上显示了该信息。公告被编辑后, 一条私信跟进再次提到了该目的地,随后一条群组消息消失了。 需要弄清楚的问题包括:变更前后观察到了什么,哪些 Telegram 账户发布了每条内容,目标出现在何处,哪些附件字节 被保留下来,以及哪些时间间隔仍无法确定? 本示例中的所有姓名、ID、时间及日志引用均为虚构。该 工作流使用当前功能;案例图仅为示意图,并非由应用程序自动 生成的图表。 流程图 · 频道 → 工作区日志; 群组 → 工作区日志; 私聊 → 工作区日志; 机器人 → 工作区日志; 工作区日志 → 搜索所有来源; 工作区日志 → 附有记录参考信息的人物档案; 工作区日志 → 已保存版本和附件收据; 搜索所有来源 → 分析师时间线和来源登记册; 附有记录参考信息的人物档案 → 分析师时间线和来源登记册; 已保存版本和附件收据 → 分析师时间线和来源登记册; 工作区日志 → 带签名的证据 ZIP 文件; 分析师时间线和来源登记册 → 附带经单独验证的证据材料的案件移交; 带签名的证据 ZIP 文件 → 附带经单独验证的证据材料的案件移交 · 频道 · 群组 · 私聊 · 机器人 · 工作区日志 · 搜索所有来源 · 附有记录参考信息的人物档案 · 已保存版本和附件收据 · 带签名的证据 ZIP 文件 · 分析师时间线和来源登记册 · 附带经单独验证的证据材料的案件移交 **图表转为文本** 1. 频道 → 工作区日志 2. 群组 → 工作区日志 3. 私聊 → 工作区日志 4. 机器人 → 工作区日志 5. 工作区日志 → 搜索所有来源 6. 工作区日志 → 附有记录参考信息的人物档案 7. 工作区日志 → 已保存版本和附件收据 8. 搜索所有来源 → 分析师时间线和来源登记册 9. 附有记录参考信息的人物档案 → 分析师时间线和来源登记册 10. 已保存版本和附件收据 → 分析师时间线和来源登记册 11. 工作区日志 → 带签名的证据 ZIP 文件 12. 分析师时间线和来源登记册 → 附带经单独验证的证据材料的案件移交 13. 带签名的证据 ZIP 文件 → 附带经单独验证的证据材料的案件移交 ## 1. 界定案件并收集完整案情 1. 在独立的工作区中连接采集账户。在[“案件看板](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/) ”或您的案件登记簿中,记录案件编号、账户 ID、工作区及 观察开始时间。请独立保留受信任的签名密钥指纹。 2. 对于专用收集账户,请打开**更多工具→来源→范围→调查模式**。预设选项包括 **整个账户**、频道/群组/私聊/机器人、自身操作、来源 配置文件以及新发现来源的最新200条可见消息。 请核对设置,点击**保存范围**,并完成范围确认。 主账户可使用选定的聊天或文件夹;整个账户的收集功能 仅对标记为调查状态的账户开放。 3. **加载聊天记录**,并将来源与该账户的对话列表进行比对。检查 排除项。**更多工具 → 参数 → 从账户列表中读取的聊天记录**默认值为 1,000,最大支持 20,000。超出列表限制的来源将在 其变为活跃状态时被添加。记录实际枚举到的内容。 4. 在**更多工具→源→记录**中,选择**所有可见活动**并保存 监控设置。检查附件类型/限制及可用磁盘空间。 5. 开始观察。验证一条受控的新消息、编辑操作和删除操作,然后 保留测试参考信息及任何失败情况。 全账户范围记录了在已保存设置范围内,该账户在 已加入的聊天中可见的活动。秘密聊天由[秘密聊天模块](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)记录, 现有对话则通过[历史记录](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)进行补录。参见[收集范围](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)。 ## 2. 盘点所有信息来源并获取历史背景 维护一个来源登记表,每行记录一次聊天: | 字段 | 记录 | | --- | --- | | 品牌定位 | 工作区、账户 ID、数字聊天 ID、标题和类型 | | 可见性 | 成员身份/角色、访问权限(已确认或未确认)、排除项 | | 实时捕获 | 开始时间、选定的事件类型及后续政策变更 | | 日志历史 | 快照请求/完成情况、限制、时间及记录引用 | | 完整历史 | 按聊天分组的导出文件名、边界及完成/失败状态均附有数字签名 | | 附件 | 已完成的媒体接收记录、哈希值、大小以及跳过/失败的结果 | | 覆盖范围 | 服务中断、数据采集不完整、FloodWait、消息不可用及其他缺失情况 | 针对每个消息源,请选用合适的采集方式: - 在**更多工具→来源→范围内的聊天中****加载完整历史记录**,将已启用来源中可用的过往 消息加载到工作区日志中。该功能支持暂停/恢复 以及带签名的进度报告。参见[历史记录获取](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)。 - **历史快照**将最近可见的消息保存到观察日志中。 其默认上限为500;**通过更多工具→参数→最大历史快照**可将其 提高至10,000。这些是当前的历史观察记录,而非重建的编辑记录。 - **通过导出→捕获或导出单个聊天→导出完整聊天**,或**聊天→导出聊天**,将 当前可见的单个聊天历史记录提取到一个单独的、经过签名的 `chat.json` / `chat.html` 包中。对该案例的所有来源重复此操作,并保留每个结果。 - **当出现新的聊天或机器人时**,可保存其资料以及多达 1,000 条最近的 消息;调查模式下则保存 200 条。启用该模式后,现有聊天记录不会 追溯性地被纳入。 - **下载可见附件时**,将根据配置的策略保留相应字节数。 必须提供包含 SHA-256 校验值和字节数的完整 `media.saved` 收据。队列中的 任务、缩略图或文件名均不视为已保留的附件。 完整聊天记录导出不会将所有 消息填入日志或联系人资料中。如需在 TgWitness 中分析特定历史记录,请使用**“加载完整历史记录**”或“限定范围的日志快照”功能。在开始 历史记录运行前,请检查已启用的来源列表。无论采用哪种方式,均无法恢复 Telegram 已不再返回的内容。 ## 3. 保留不断演变的案件及有预谋的互动 将活跃案件聊天室标记为优先来源。审查复核间隔、持续 补录及媒体结果。在使用该账户期间,请保持采集器处于监控状态。 使用**“聊天”→“个人资料”→“立即保存个人资料”**以保留来源元数据,例如 描述和机器人命令。这与从已保存消息中生成的 联系人个人资料是分开的。 当案件涉及追踪消息来源或与机器人交互时: 1. **“打开 Telegram 链接 → 保存预览”**功能会在执行操作前记录所提供的链接及返回的 预览内容。 2. **“加入/打开并观察”**操作将执行加入/打开操作,并在提供时发送机器人的 start 参数。待批准的加入请求将被记录为“待处理”。 3. 面板生成的文本回复和支持的按钮点击操作将保留 `interaction.requested` 和 `interaction.result`。回调收据可保留 返回的弹出文本、警报状态和 URL。 这些是真实的账户操作。在另一款 Telegram 应用中点击回调按钮的行为 对采集器不可见,尽管由此产生的消息或编辑操作可能被记录。该 微型客户端不处理网页应用、支付、电话或位置相关的工作流。 有关确切的行为,请参阅[面板交互说明](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#act-from-the-panel)。 ## 4. 关联不同聊天记录中的观察结果 在**“日志**”中,选择**“所有来源**”并搜索已记录的内容。打开匹配的 记录,并保留工作区、聊天、消息 ID、序列号和记录哈希值。 在相关聊天中,打开**“联系人”→“启用个人资料**”,然后查看某人: - 随时间推移观察到的名称/用户名以及 Telegram 数字 ID。 - 回复内容需包含源记录的引用信息。 - **此外……**该 ID 曾在此工作区日志中的其他聊天记录中发过言。 - 活动记录、编辑/删除操作,以及被提及的钱包、手机、用户名和链接。 - 已保存的头像元数据及类似的缓存头像,并标注了各自的来源。 在发现中使用派生配置文件之前,请先打开引用的记录。配置文件涵盖 保存了消息的人员,而非群组中的每位成员。**更多工具 → 参数 → 每项事实引用的记录**仅限制参考列表,而非底层活动数量。 提及和头像相似度是线索;所有权和身份基于数字 ID 和已归属的发送者。 该签名文件将编码器提示与转发和重复使用的文件分别归类到 `clients.forwarded`和`clients.reused`中。此类文件不会计入 `clients.observed`或`media_timing.pre_existing`列表。 所谓“重复使用的文件”,是指 在该日志的早期阶段,于读者获准访问的聊天中, 曾观察到同一 Telegram 文档 ID 出现在另一条消息中。系统会引用其首次被观察到的记录; 同一消息的后续观察或编辑不被视为重复使用。 该文件夹的`paid_reactions`部分会保留每条列出消息的最新可用“点赞” 排行榜,其中包含来源记录和匿名标记。 这些是快照计数,并非额外支付金额的总和,也不是 所有点赞用户的完整列表。若快照中未包含排行榜,则不会提供替代 列表。当显示限制达到时,该部分会报告被省略的消息。 监控列表和指标导出功能会检查按钮标签、URL、复制文本、内联 查询以及解码后为有效 UTF-8 的回调字节。无效或超大 的回调编码将被文本提取功能跳过;原始字节仍将 保留在保存的记录中。 现有观察列表需要重新扫描,才能对包含这些新增字段的旧记录 进行检查。检查过程不会点击按钮。 在示例中: | 链接 | 记录 | 支持的观察内容 | | --- | --- | --- | | 同一发件人账号 | 群组 #146 及后续私信 #205 | 两者均提供 Telegram 发件人 ID 71001 | | 同一目标 | #146,机器人键盘 #173,频道编辑 #188,私信 #205 | 所有内容均包含`pay.example.invalid/new`;重复出现的目标地址将相关材料链接起来 | | 相同的保存文件 | 已完成媒体收据 #151 和 #209 | 所保存字节的完整 SHA-256 值完全一致 | | 频道来源说明 | #101 和 #188 | 若未注明发件人,请勿将频道帖子归因于用户 71001 | 比较附件哈希值及其关联的消息引用,并按这些记录中提供的 Telegram ID 将账户 时间线分组。 请将团队的工作笔记保存在[“案件看板](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)”上:对您依赖的记录 (如 #146、#188 和 #205)添加书签,突出显示确切的目标字符串,并 保存两个记录之间或某个时间范围内所有记录操作的片段。 笔记 和状态会将团队的审查记录保留在其各自的已签名历史记录中,可与 源观察记录区分开来。 ## 5. 构建跨聊天室时间线 使用**“聊天**”中的已保存版本及其**日志记录 #…** 链接。在 **日志中**,将**所有来源**与**编辑**、**删除**及**覆盖内容**合并。 如已提供,请同时保留 `source_at` 和 `observed_at`。 | 示例观察时间 | 参考资料 | 观察 | | --- | --- | --- | | 09:00 | 频道 #101 | 原始目标已捕获 | | 09:12 | 群组 #146;媒体 #151 | 已发布新目标;文件下载完成 | | 09:16 | 机器人 #173 | 键盘指向新目的地 | | 09:20 | 频道 #188 | 公告已编辑;两个保存版本均保留 | | 09:24 | 私有 #205; 媒体 #209 | 同一发件人 ID 的收件人地址重复;文件字节内容保持不变 | | 09:28 | 群组 #231 | 已收到删除通知;删除者及确切删除时间不详 | 其他记录发生在这些示例引用之间。序列号用于排序 观察结果;历史快照可能包含更早的源日期,且到达时间 晚于实时事件。请区分快照、恢复的消息、删除通知以及 重新检查时缺失的结果。 将覆盖缺口标记为未知时间段。后续 历史数据的获取并不意味着可以追溯性地确立不间断的观测记录。 ## 6. 添加账户视角,同时保留其来源信息 为每个独立账户使用单独的工作区,并重复执行其清点操作。 每次比对时,请保留账户 ID、角色、签名密钥指纹及来源参考信息。 消息编号并非跨聊天/账户的全局标识符。 “案件看板”在每个工作区内保存与来源关联的笔记和集合。 群组界面可集中查看账户状态,并能将不同工作区的 导出数据打包。您可在案件笔记或分析工具中关联这些来源;每个日志 均保留其原始来源和签名密钥。系统不会生成全局搜索结果或合并的跨工作区 时间线。 单个频道/超级群组的多账户导出 将使用符合条件的账户获取该聊天记录的历史。 对于较长的操作,需通过[独立见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)保持边界。 使用受控投递检查来验证 每个账户的捕获路径和可见性。 ## 媒体的重复出现与转发来源 证据报告分别对比了Telegram文档ID和保存文件 记录中的SHA-256哈希值。这些报告展示了不同的消息、聊天记录以及首次和最后 一次保留的出现记录,并附有可展开的HTML格式观察时间线。 同一条 消息的重复快照或编辑操作不会增加该 键的出现次数。编辑后消息中的不同文件将保留其自身的出现次数。 “首次观察到”遵循报告选定范围内期刊的排序顺序。这并不 意味着这是Telegram上最早的发布记录。文档ID用于标识Telegram文档; SHA-256 算法用于比对保存的字节数据。不同保存图像中匹配的 64 位 dHash 值将作为视觉线索显示;此比较采用哈希值完全相等的方式,而非 最近邻搜索。 在进行 dHash 分析之前,图像字节必须与其保存的 SHA-256 值匹配;大于 64 MiB 的文件和超过 4000 万像素的图像将被跳过。 前向源摘要会统计不同的目标消息。报头中的对等方 ID、 隐藏名称、帖子作者签名以及“已保存消息”的上下文均保持独立。 用户个人资料的 JSON 包含每位发件人的消息源;频道帖子也会出现在 聊天级别的汇总中。没有对等 ID 的命名消息源属于文本分组,而非 已识别的个人。导入的聊天头部仍会标记为“已导入”。 非紧凑证据 ZIP 文件包括 `media-repeats.json`、`forward-sources.json` 和 `observed-sources.gexf`,这些文件由归档清单保护。GEXF 1.3 图包含 带类型的 `forwarded_from` 和 `recommended` 边。箭头从被观察的聊天 指向被引用的对等方。 推荐权重统计保留的推荐 观测数据;转发权重统计独立消息的数量。隐藏名称和导入的 标头不会生成身份边。没有任何图操作会解析个人资料或 调用 Telegram。边元数据包括源序列和哈希值。 摘要内容遵循报告中的选取范围;证据压缩包中仍包含 完整的已签名日志。仅包含消息事件的选取范围会比较 文档 ID;而保存字节和图像比较则需要在 所选流中包含保存文件事件。当前的云消息选取范围不包含 `media.saved`。 限制条件明确:每次分析保留 200,000 个密钥/消息 实例,100,000 个媒体密钥,20 个报告组,每组 100 个时间线 引用,以及 1,000 个导出的图边。 当比较上限 达到时,结果将显示被省略的实例,且计数变为下限值。 时间线和图的显示限制将分别报告。紧凑型 ZIP 文件省略 这些衍生摘要。带签名的源记录保持不变。 ## 7. 整理并核实案件移交 请将以下内容整理到由分析师编制的案件目录中: | 资料 | 目的 | | --- | --- | | 案件笔记与来源登记册 | 问题、数据收集政策、访问权限/角色、调查结果、替代解释及数据缺口 | | 时间线 | 每条记录均包含时间信息以及工作区/聊天/消息/序列的引用信息 | | Case Board(若使用)导出和片段 | 与源文件关联的书签、引文、团队笔记、收藏集、修订历史以及选定记录均需与证据 ZIP 文件进行核对 | | 每个工作区对应的签名证据 ZIP 文件 | 完整的记录日志、清单及包含的保存媒体;面板过滤器不会缩小日志导出范围 | | 单独签名的用户资料文件 | 已根据对应的工作区证据核查了引用的来源 | | 带签名的完整聊天记录导出 | 当前可见历史记录的采集,与观察日志分开处理 | | 可信指纹、TSA 根证书和早期检查点 | 密钥标识、最后一条记录的外部时间以及保留的日志边界 | | 若已配置,则生成Witness证据文件 | 独立日志、签名条目和见证指纹 | | 验证结果和已交付文件的哈希值 | 检查了什么内容、传输了哪些字节以及传输给了谁 | 来自可信安装环境,包含文件名及每个工作区的实际指纹: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 ``` `--require evidence`将以代码2退出,除非指纹匹配且第三方提供的外部时间 覆盖了最后一条记录;检查点是辅助性检查。 保留实际的验证结果和原始证据。将“案件看板”中的工作区 笔记与引用的源材料一同导出。将跨工作区的 调查结果汇总到顶级案件目录中;每个 TgWitness 证据都有其专属的 签名和验证流程。 ## 调整调查 | 案例 | 追踪 | 交付 | | --- | --- | --- | | 由机器人驱动的订单/支付纠纷 | 条目公告 → 已保存链接预览 → 机器人启动参数 → 消息和键盘版本 → 面板回调收据 → 私信/群组跟进 | 已观察到的要约/响应时间线及经过验证的来源;支付确认来自支付记录 | | 事件发生后被删除的消息 | 所有受影响的聊天记录 → 保存的原始内容/编辑记录 → 删除或复查时缺失的结果 → 保留的媒体文件 → 覆盖范围及其他账户视角 | 保留版本及明确标注的未知时间段;不假设任何虚构的删除行为者 | | 某参与者在不同聊天群中使用了不同的名字 | 数值发件人 ID → 姓名/用户名历史记录 → 回复 → 其他被观察到的聊天 → 引用的目的地/文件 | Telegram 账号的活动时间线,附有其源记录的链接 | [收藏参考](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/) · [个人资料验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#people-profiles) · [证据移交](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#investigation-handoff) · [验证已完成](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/) --- # Telegram · 功能与范围 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/features/ TgWitness 的当前采集模型、多账户工作流、导出功能及操作边界。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) TgWitness 的当前采集模型、多账户工作流、导出功能及操作边界。 [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/README.md) ![项目参考](https://phishdestroy.io/tgwitness/assets/chapter-project.svg?v=f8e31208f561) TgWitness 可保存已连接账户可访问的 Telegram 对话, 记录观察到的变更,并生成可验证的导出文件。本参考文档描述了 采集模型、当前工作流程及其边界。 **本页内容** - [独立应用程序](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#standalone-application) - [共享调查](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#shared-investigations) - [归档工具](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#archive-tools) - [可选内容](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#optional-extras) - [协议与私有源代码](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#protocol-and-private-sources) - [多个账户](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#multiple-accounts) - [捕获与来源标注](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#capture-and-attribution) - [容量与 Telegram 限制](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#capacity-and-telegram-limits) - [可靠性与恢复](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#reliability-and-recovery) - [证据模型](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#evidence-model) - [导出、部署与移交](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#export-deployment-and-handoff) - [稳定版发布标准](https://phishdestroy.io/tgwitness/zh/docs/reference/features/#stable-release-criteria) ## 独立应用程序 TgWitness 拥有独立的安装流程、数据目录和发布生命周期。随附的 Web 界面负责配置和审查;导出的记录可独立使用。 操作员连接其账户,选择彼此可见的消息源,并获取 一份保存的观察日志。控制面板展示内容、保存的更改、观察 来源以及已知的缺失信息。其他调查人员可以对导出的材料进行验证。 该面板区分了账户授权、对来源的访问权限、采集器 活动以及记录范围。在评估 消息较少或存在连接问题的时段时,请综合审查这些状态。 ## 共享调查 管理员可签发作用域限定于工作区和 单个聊天的[访问令牌](https://phishdestroy.io/tgwitness/zh/docs/reference/access/),并可设置按操作授权、IP 限制、有效期、登录次数限制 及会话控制。只读审核员无需获得 Telegram 授权或主面板密钥,即可审查案件。 仅限聊天的访问权限与 全账户设置及完整日志导出功能相互独立。 自动 MTProxy 会从四个公共来源或 运营商目录中维护可用的 Telegram 路由。[IP 模式](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/#ip-modes)决定 在连接失败时是必须等待另一个代理,还是可以使用明确允许的直连路由。 外部 HTTP 请求拥有独立的路由和关闭开关。 ## 归档工具 自0.7.1版本起,已包含[历史数据采集](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)、[归档搜索与分析](https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/)、 [只读MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/)、[本地OCR/转录](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/)以及 [外发Webhook功能](https://phishdestroy.io/tgwitness/zh/docs/reference/webhooks/)。分析报告和识别出的文本与 捕获的事件保持分离。 [“案件看板](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)”可在工作区内添加与来源关联的书签、引文、笔记和 收藏集。[报告生成器](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)用于选择 材料、章节以及八种设计模板之一,以支持 HTML/PDF 导出。 ## 可选附加功能 日常配置流程为:账户 → 数据源 → 观察结果。**更多工具 → 扩展功能**是一个独立的 配置区域,用于独立捕获、存储、目标与保护级别、通知、 证据和备份,包含一台始终在线的服务器、一个 Telegram 见证机器人以及代码检查功能。每个 功能在显示设置前都会说明其可用性和要求。选择卡片会打开 操作指南;此操作不会注册或启动任何服务。 机器人设置包括三个步骤:创建只读访问权限、选择发布设置,以及 在见证主机上启动。网络和发布选项、现有连接以及 验证命令将按需显示。 下载的配置与 正在运行的见证人相互独立。切换附加组件时会保留草稿;账户变更和锁定 操作将清除临时令牌和表单。内置指南包含启动说明。从导出中打开的 [GitHub Actions 捕获功能](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md),将从您的 分叉中启动一个已固定的收集器,捕获一次聊天,并生成包含工作流溯源信息的加密交接数据。 ## 协议及私有来源 **MTProto 是 Telegram 的协议;Telethon 是 TgWitness 用于 与 MTProto 通信的 Python 库。**它们并非替代性的连接方式。“收集”功能使用 MTProto; 可选的“见证”功能则通过 Bot API 发布经过签名的校验记录。 每个工作区都有其专属的授权客户端和账户更新流。TgWitness 从配置好的来源中筛选观察数据,并针对历史快照和媒体下载等功能 分别发出明确的请求。 私有消息源无需公开用户名。Telegram 的对等节点类型和数字 ID 是 其标识符;标题和用户名可能会发生变化。访问权限取决于现有的 成员身份和权限设置。TgWitness 不会自动加入消息源,也不会绕过 加入审批。来自其他账户的访问哈希值并非通用访问令牌。 数据采集模型必须考虑加入群组前的隐藏历史、参与者/管理员 角色、会话撤销、权限移除或变更、群组向超级群组 的迁移、主题/论坛、关联讨论、频道身份以及不可用的 附件。并非所有组合都已在实际环境中经过验证。 在收集器启动时会检查来源可见性。若在限定范围内的 对话结果中缺少某个来源,则表示**访问状态未确认**,而非已证实被删除。一个来源不可用 并不妨碍对其他可访问来源的观察。切勿在公开的测试数据中放置 邀请链接或真实会话。 ## 多个账户 该面板支持任意数量**的工作区**,每个工作区均拥有: - 授权机制、加密存储库及连接路径。 - SQLite日志和Ed25519签名身份。 - 精选来源、媒体队列和捕获设置。 - 监控状态、错误、检查点和导出功能。 切换显示的工作区不会停止另一个采集器的运行。跨工作区的重复账户 授权将被拒绝。已绑定到某个 Telegram 账户的日志无法重新分配给另一个账户;但允许重新连接同一账户。 这可确保账户身份及相关消息 ID 范围的完整性。 该应用程序未设定固定的工作区数量。每个工作区都在 一个共享的 Python 进程和事件循环中运行其自身的采集器 任务,用于连接监控、媒体下载、复核以及新聊天记录的采集。吞吐量取决于工作负载。为 实现进程隔离,请使用独立的安装、端口和数据目录。 为每个账户分配其可访问的来源。不同的账户可能观察同一个 群组,但它们的观察记录保持独立,并保留其来源。同一台由操作员控制的机器上的两个账户 并非两个独立的见证者。**导出群组时,** 会将单独签名的作品空间 ZIP 文件打包,并附带一份签名的文件列表,其中包含其 作品空间 ID、哈希值和签名密钥指纹。 每个日志都保留其自身的 边界。在案件笔记或分析工具中构建跨工作区的综合时间线, 同时保留这些来源引用。 ## 捕获与归因 “来源”功能提供按账户设置的新消息、编辑、删除、点赞 及成员资格开关。预设选项可保留所有类别,或仅保留消息/编辑/删除记录。 该策略适用于工作区中选定的群组,重启后仍保持有效,并附有 变更前后的签名。默认设置为保留所有类别。 关闭某类别 不会删除旧记录;重新开启该类别也不会重建已遗漏的事件。 操作记录、其他群组服务事件以及显式历史快照是 独立的。捕获的 Telegram 对象可能会保留嵌入的元数据,无论 “单独更新”开关的设置如何。目前尚不支持按群组覆盖类别设置。 | 资料 | 立即捕获 | 边界 | | --- | --- | --- | | 消息 | 文本、同行/消息 ID、发件人元数据、回复及原始更新信封 | 作为由采集器签署的、账户可见的观察记录予以保存 | | 编辑 | 新观察到的版本、先前捕获的版本、接收时间及提供的编辑日期 | 消息更新和可用的管理日志条目将保留各自的归属字段 | | 删除 | Telegram 通知、接收时间及先前捕获的内容 | 当由单独的管理日志记录提供时,将保留操作主体和源操作时间。 | | 账户级删除通知 | 原始通知;已解决的记录包含保存的聊天记录及关联方法 | 要求范围内必须且仅有一个先前保存的私聊或普通群组匹配项;其他 ID 保持为 `deletion.unscoped`。频道和超级群组 ID 不包含在此关联范围内 | | 反应 | 已交付的计数器及可见的近期身份信息 | 获取完整的可用反应器列表需要单独查询;频道可能会隐藏身份 | | 会员 | 服务消息及已送达的参与者更新 | 可见性取决于角色和聊天类型;成员身份由已送达的事件报告 | | 管理员操作 | 频道/超级群聊天导出中包含的相关已交付更新及管理员日志快照 | 导出功能会在导出管理员账户可访问日志时读取日志 | | 附件 | 原始版本描述符、下载字节数/SHA-256 及尝试结果 | 原始版本保持不变;较新的版本绝不会替换它 | | 历史 | 当前可见消息的明确快照 | 实时记录会保留早期版本和删除通知 | | 采集进程 | 启动/停止、心跳、错误、设置、作用域和签名运行收据 | 本地库存;GitHub 和 TDX 增加了[独立的环境检查](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope) | 界面会标注源事件中提供的账户名称,并保留观察到的 名称和用户名。当事件未指明行为者时,报告将该字段留空。 ## 容量与 Telegram 限制 容量按每次部署进行配置。其大小取决于每秒峰值事件数、附件数量及大小、额外的 RPC 调用、活跃账户数、磁盘延迟/可用空间、网络状况、Telegram 限制、 可接受的延迟以及队列深度。 Telegram 将被动投递与主动短轮询区分开来。其更新 文档描述了针对开放 频道/超级群组的额外 `updates.getChannelDifference` 调用,并建议**同时进行短轮询的 源**最多为十个。此规定适用于短轮询;所选群组的数量则另行设置。 | 模式 | 目的 | 状态 | | --- | --- | --- | | 标准说明 | 记录来自选定来源的已发布更新 | 已实现 | | 优先级复核 | 已标记的来源使用其自身可配置的间隔,并在每次限定范围内的重新检查过程中具有优先级 | 已实现历史记录和消息查询功能 | 优先级星号用于控制这些复查操作。额外的 ``updates.getChannelDifference` ` 短轮询功能不会作为独立的用户模式对外提供。 任意高频轮询、忽略 FloodWait 或假设额外账户具有线性容量 均非有效的容量规划模型。默认限制为: 前 1,000 个列出的对话,每个历史快照最多 500 条消息, 按类型每收集 1–2,000 MiB 的文件,以及 4 GiB 的未压缩签名 ZIP 内容;各项 限制会根据工作区而变化,文件大小**可在更多工具→源→录制中**设置,其余项则在 **更多工具→参数中**设置。 导出操作没有固定的事件计数上限。 浏览器回退模式默认限制为 128 MiB;流式传输 CLI 具有可配置的 传输限制,默认值为 5 GiB。 ## 可靠性和数据恢复 已实现的功能包括 SQLite WAL/同步事务;原子性消息 和媒体任务写入;持久化任务和重试延迟;原始版本描述符; 有限重试;持久化媒体 FloodWait;在文本事件的 网络等待之外下载媒体;在后续写入继续进行时保持前缀稳定的导出;原子设置和 审计记录;登录替换失败后保留有效授权; 受损附加工作区的隔离;显式重连尝试;明确的 授权丢失报告;以及使用单调时钟进行实际时间变化检测。 账户和频道的 pts/qts/seq 会在重启后保存并恢复,且被监视的聊天记录 会定期重新核查;详见[证据格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#durable-collection-and-process-receipts-02)。定期保存位置 并不构成对日志接受情况的原子性、无损确认。 每次进程启动时,都会记录上一次的头部和离线边界。当前历史记录 不被视为缺口修复。Telegram 的差异保留是有限的; `differenceTooLong` 无法重建所有已消失的内容。不可恢复的缺口必须 保持明确标注,即使后续的历史快照成功生成也是如此。 ## 证据模型 每条事件记录包含事件序列、本地 UTC 观测时间、来源时间(如有提供)、 事件类型、来源、操作者(如有提供)、原始有效载荷、前一次哈希值及签名。 消息观测记录还会保留采集器账户/运行上下文。 该签名处理收据包含一个随机运行 ID;TgWitness/Python/OS 的 依赖项版本;源文件的 SHA-256 值及聚合指纹;初始账户、 范围和设置;UTC/单调读数;以及前一个日志头。 设置变更、启动/停止及错误信息均记录在同一日志中。检查点在 启动时、监控期间每五分钟(可调整)以及有序停止时被保留。 保留的本地检查点可检测是否回滚至较早的日志前缀。 | 工作原理 | 其功能说明 | | --- | --- | | 文件 SHA-256 | 字节与已知摘要匹配 | | 事件哈希链 | 记录相对于已知边界的排序/关联 | | Ed25519 | 使用特定密钥生成的签名 | | 独立保留的检查点 | 后续内容与保留的边界一致 | | 程序文件大小 | 收集器关于已测量文件的自我报告 | | 有效的独立 TSA 响应 | 在明确的信任假设下,特定字节在 TSA 时间点上的存在性 | RFC 3161 请求的准备和响应的验证无需 OpenSSL。证据模式还会把检查点哈希发送到已配置的时间戳服务。请保留并验证机构的响应,以建立独立的时间锚点。参见 [TIMESTAMP.md](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/)。 独立保留检查点,控制对签名密钥的访问权限,保存传输 记录,并使用可信软件验证导出文件。[验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope) 部分说明了这些检查如何相互补充,以及适用哪些信任假设。 ## 导出、部署与移交 一个带签名的 ZIP 文件包含原始的 JSONL、CSV、HTML 文件、保留的附件、哈希值、一个 带签名的清单以及一个便捷验证工具。该文件涵盖一个工作区和一个固定的完整 日志前缀。面板搜索过滤器不会在用户不知情的情况下删除记录。 密钥、 令牌和 Telegram 会话被排除在外;原始记录仍可能包含 个人信息和 Telegram 元数据。 请将 ZIP 摘要、可信指纹、检查点、处理收据和交接 记录分别保存。应使用来自可信安装环境的验证工具,而非仅因可执行代码 出现在被检查的 ZIP 文件中就对其予以信任。 浏览器界面本地部署时无需 Node.js、CDN 或外部字体。一个 操作员令牌即可控制整个安装过程。远程访问需要 HTTPS 或 SSH 隧道。 提供了原生 Python 代码和容器配置文件,部署示例位于 [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) 目录下;已执行的平台检查项另行列出。 默认工作区使用数据根目录;额外的工作区使用`profiles//`。 备份需要停止进程并具备完整的数据/密钥集。证据 ZIP 文件 并非应用程序备份。密钥可使用外部主密钥来访问新的数据 目录;日志/媒体加密由操作员的磁盘/卷提供。 参见 [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/) 和 [OPERATIONS.md](https://phishdestroy.io/tgwitness/zh/docs/reference/operations/)。 ## 稳定版发布标准 在正式发布之前,需说明: 1. 真实的私人群组、超级群组、论坛和频道,包含成员/管理员角色以及 隐藏/可见的历史记录,包括登录/双因素认证、权限撤销和访问权限丢失。 2. 针对已知操作,对编辑、删除、点赞、成员身份及媒体内容进行受控处理。 3. 进程/主机崩溃、磁盘故障/磁盘空间已满、文件引用过期、FloodWait、 网络中断、文件损坏以及数据库回滚。 4. 支持持续的多账户使用,可控制延迟、队列、内存和磁盘资源,包括 同时处理静默和活跃的消息源。 5. MTProto状态推进与日志接受之间存在中断。 6. 在目标操作系统/容器组合上进行干净安装,并验证备份与恢复功能。 7. 对安全性、签名以及归属/证据主张的独立审查。 关于面板访问范围的说明详见[访问与权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)部分。自0.6版本起,TgWitness支持 [ACCOUNTS.md](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)中所述的受限单账户TData以及账户文件导入功能。 发布前请查阅Telegram API条款。研究参考文献和平台 发现详见[RESEARCH.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/RESEARCH.md)。 --- # Telegram · “案件看板”参考 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/ 书签、精确高亮、操作片段、讨论、范围访问以及“案件看板”所使用的签名注释历史记录。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 书签、精确高亮、操作片段、讨论、范围访问以及“案件看板”所使用的签名注释历史记录。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [调查](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/) ![调查](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) “案件看板”为调查团队提供了一个共享的已保存材料工作视图。您可以对 观察结果添加书签、突出显示具体段落、保存一系列操作,并与同事进行讨论。 卡片会保留其来源引用和已签名的修订历史。团队注释保留在 工作区中,可与原始 Telegram 观察结果区分开来。 [证据模型](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) · [访问](https://phishdestroy.io/tgwitness/zh/docs/reference/access/) · [报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/) ![综合调查信息流](https://phishdestroy.io/tgwitness/assets/case-board.png?v=da27ef9c5b51) **本页内容** - [处理案例](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/#work-with-a-case) - [权限](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/#permissions) - [已存储的合约](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/#stored-contracts) - [API 和导出功能](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/#api-and-exports) - [运行限制](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/#operating-limits) ## 处理案件 **在更多工具中打开案例板**(标准模式或专家模式)。语言设置随面板而定。 在日志记录或已保存的聊天消息旁点击**添加到案例板**,或选中该项并按 **B** 键。 单击即可将书签添加到收件箱。编辑其标题、标签和备注,或将其移动到 收藏集。修改后的卡片会附加一个带签名的修订版本;删除时会保留历史记录。 对于首个案例,请选择一个采集集,并添加能回答某个问题的记录。使用“评论” 功能审查解读结果,然后使用**“演示**”功能逐一浏览卡片及来源上下文。 在[“报告工作室](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)”中准备 交付成果时,请单独选择“案件看板”中的材料。保存切片不会自动配置报告的数据过滤器。 在已保存的聊天消息中选中文字,即可显示**“突出显示 → 板”**。选择颜色并 添加注释。服务器会核对精确的引文及已保存版本,包括表情符号、从右到左(RTL)文本和 组合符号。界面不会通过被遮盖或转换的文本映射选定内容。 在同一聊天中按住 Shift 键点击两条记录以**进行“切片**”,使用**“按时间切片**”,或保存 日志中当前的聊天、时间段和事件类型过滤条件。已保存的切片具有其自身的权威性 谓词:在日志中打开它时,也会应用多个聊天、消息数量限制和参与者 过滤条件。 **“显示自书签添加以来的记录**”可筛选出后续添加的记录。更改日志 过滤器将退出该切片。在“人员”中**,“按此人操作切片**”功能使用记录的参与者 ID; 该功能不会假设消息作者曾编辑、删除或对消息做出过反应。 “切片”对话框会在允许创建前预览计数。“`all`”包含所有记录类型, 包括快照、编辑、删除、反应、成员资格/服务更新、自身操作、 按钮、媒体结果、恢复的消息以及未来事件类型。该选项描述了 已保存的观察结果。 “未知聊天”删除通知属于独立上下文, 仅对拥有整个工作区访问权限的用户可见,且绝不会被归因于所选的任何聊天。 收藏集具有声明的聊天范围。空范围表示整个工作区。一个收藏集 不能包含其范围之外的卡片;受聊天范围限制的参与者无法阅读范围更广的 收藏集。收件箱是用于未分配卡片的虚拟收藏集。 搜索和筛选仅涵盖可见 卡片;讨论串和提及继承父卡片的访问权限。已删除的评论在讨论中会显示 “墓碑”标记。不会记录查看历史。 **“演示”模式**会打开所选集合中的所有卡片,提供“卡片”、“来源上下文”和“团队 评论”视图,以及键盘上的“上一张/下一张”控制键。该模式不提供任何编辑控件。普通 信息流采用分页显示;“演示”模式按页加载列表,并每次仅检索一张卡片的详细信息。 ## 权限 所有操作均需`view`、工作区/聊天范围及`board.read`权限。`board.write`权限用于添加卡片、 评论、移动操作以及开启/审核状态。`board.manage`权限用于管理采集集、 确认/驳回状态,以及修订/删除他人卡片。状态是团队 的决策,而非加密验证结果。 访问表单预设:审核员 = 只读;分析师 = 读写;操作员 = 读写/管理, 此外还包含其现有权限。现有授权不会自动获取新权限。 主管理员拥有所有权限,并以**“主管理员**”身份发布内容。请使用命名授权 进行归属标注。提及列表仅显示当前能够阅读完整父卡片内容的访问者。 针对聊天 A 的授权无法获取 A+B 的卡片或片段,即使通过猜测其 ID 或提供 虚假的 `target.chat_id` 也不行。目标元数据由服务器根据已签名的事件哈希解析得出。 在响应之前,会过滤收集项、讨论次数、相关卡片和实时通知。 导出操作需要同时具备`export`和`board.read`权限;现有导出者若无板访问权限,将 获得不含团队笔记的普通证据存档。SSE会在每次批量处理前重新核查当前授权。 ## 已存储的合同 与观察记录类似,注释也是以事务方式写入工作区中一个仅追加的 SQLite 表中。 `annotations.jsonl` 是从与 `events.jsonl` 相同的读取快照中导出的精确规范格式文件。 不存在第二个相互冲突的注释存储,也没有 `board.activity` 日志事件。 每行内容应精确包含: ``` { "seq": 1, "at": "2026-11-02T14:00:00.000+00:00", "access_id": "admin", "access_label": "Main administrator", "kind": "board.bookmark", "payload": {"id": "32 lowercase hex digits", "target": {"event_hash": "64 lowercase hex digits"}}, "previous_hash": "64 zeroes for the first record", "hash": "SHA-256 described below", "signature": "base64 Ed25519 signature" } ``` 上文的简短示例展示了封装结构;实际有效载荷包含其模型 默认值和由服务器解析的目标字段。API 请求架构位于 [`tgwitness/schemas`](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/schemas/board-bookmark.json) 目录下,由 `python tools/build_board_schemas.py` 通过运行时 Pydantic 模型生成。额外的请求字段将被拒绝。若未提供 ID,则由 服务器端自动生成。 调用方无法提供 作者、时间、快照和签名信息。命名授权 ID 遵循 Access 现有的 16 位十六进制格式;卡片 ID 为 32 位十六进制。 规范 JSON 采用 UTF-8 编码,对象键按顺序排序,标记之间无空格,Unicode 未转义, 且不包含 NaN 或无穷大值。注释哈希值是包含 `format: "tgwitness-annotations-v1"` 以及所有七个信封字段(直至 `previous_hash`)的规范对象的 SHA-256 哈希值。 此格式标签将其哈希域与观察结果区分开来。 签名采用 Ed25519 算法,基于 32 个原始哈希字节生成。序列从 1 开始。修订版本保留卡片 ID,并在 ``supersedes`` 字段中注明前一个 注释哈希;修订版本不能更改聊天范围。移动、状态和删除操作均为 独立记录。SQLite 表不支持 UPDATE 和 DELETE 操作。 `case-board.json` 包含 `{statement, signature}`。规范陈述由 工作区密钥签名,并包含 `format: "tgwitness-case-board-v1"`、`public_key`、`created_at`、 `journal_head`、`meaning` 以及 `state`。状态为确定性重放:`annotations_head`、一个 有序的 `items` 数组(包括集合、卡片、评论及已删除项)以及 `status_history`。 各项在不同修订版本中均保留其最后一次注释哈希值、序列号、作者和时间,以及原始 创建者和创建时间。重放过程会检查修订版本、 父项、集合引用以及重复的操作 ID。`manifest.json` 和新的检查点 也会绑定 `annotations_head`。独立保留一个检查点,以检测数据截断或使用 复制的签名密钥进行的改写。 ### 文本版本 `range.start` 是基于零的 Unicode 码点偏移量,`length` 是正的码点计数, 且 `quote` 必须与目标事件中 `payload.text` 或 `payload.caption` 的精确子字符串完全一致。 不应用 NFC/NFKC、大小写转换或字符规范化。 Python 字符串切片和 JavaScript 的 ``Array.from(text)`` 实现了相同的索引机制。标记与 ZWJ 表情符号的组合可能 占用多个码点。``range.version`` 是目标事件的哈希值,而非当前消息 版本或 Telegram 的 UTF-16 实体偏移量。后续编辑绝不会自动重新定位高亮标记。 ### 切片标识与时间 `query` 函数仅接受一个 `chat_id` 或非空的 `chat_ids` 列表,可选的包含起始点 `from` 和结束点 `to`, 包含消息 ID 范围(仅限一个聊天),kinds: "all" 或精确/前缀通配符类型的 `kinds: "all"`, 显式 `actors`,`search`,`hide_system` 以及 `include_unscoped`。日志类型组将展开为 其精确的谓词。 搜索使用日志的 NFC/不区分大小写的有效载荷搜索,且不更改 已签名的源文本。日期需要指定时区,并规范化为 UTC。 日期用于过滤 **observed_at**。Telegram 的 `source_at` 将单独显示。若删除操作没有 源时间戳,则不会生成虚构的删除时间。在时间区间外观察到的延迟记录 不会被纳入该区间;对于特定消息 ID,消息 ID 切片可能包含针对这些消息 ID 的后续删除操作。 快照(`snapshot`)固定了创建时间、日志序列/哈希边界、匹配计数、首/末 序列以及 `result_hash`。后者是按字典序排序的匹配 事件哈希的 UTF-8 规范 JSON 数组的 SHA-256 哈希值,其中空切片用 `[]` 表示。 它还包含确切的 类型计数以及一个 24 格的观测时间微型图。一个切片存储的是查询,而非重复的源 记录。导出时,`board/slices/.json` 会列出当前哈希值以及新增/移除的序列。 验证器会在创建边界处重建原始结果,然后重建当前结果。 新增的记录将作为变更事实进行报告。删除原始事件会破坏不可变的 证据链;系统不会将其作为从切片中进行的普通删除而默认接受。 “反应”快照中的近期参与者列表不完整。资源管理器会比较同一聊天/消息的相邻快照 (包括切片范围外的先前快照),并报告**各观察结果之间的** 聚合计数差异。对于缺失的近期参与者,系统不会认定其已删除某条“反应”。 第一个快照没有推断出的早期状态。参与者的观察结果仍归因于 其被提供的快照,而非某个虚构的操作时间。 ## API 和导出功能 `GET /api/board`接受collection/chat/author/label/state/from/to/q/kind/comments、offset/limit 以及newest/oldest排序参数。`GET /api/board/card/{id}`返回卡片、源文件预览、对话线程、 状态历史记录及相关卡片。参与者子路由返回符合条件的提及选项。 `POST /api/board/{bookmark|highlight|slice|collection|comment|status|move|remove}`用于追加一条记录。 `POST /api/board/slice-preview`用于计算查询。切片记录通过 `GET /api/board/slice/{id}/records`进行分页;重新计算时始终使用当前稳定的读取快照。 实时 `/api/stream` 发布不含有效载荷的 `board` 通知,与日志游标独立。 `GET /api/board/export` 返回一份经过签名的文档。受聊天限制的访问权限将收到一份标注清晰的 签名**披露文件**,绝不会包含其他聊天的注释或完整对话链。完整的证据 ZIP 文件 包含 `annotations.jsonl`、经过签名的 `case-board.json` 以及切片 JSON 附录。 HTML/PDF/JSON 报告 设置可选择“无案例板”、“不含讨论的书签/片段”或“带评论的卡片”。该 部分明确区分了团队意见与观察结果。报告数据过滤器也会限制 可读笔记的内容;证据 ZIP 包中的完整签名源文件则保持完整。 `GET /api/board/slice/{id}/export` 将生成一个带签名的 `tgwitness-board-selection-v1` JSON 片段; `?format=csv` 将生成一个便于使用的表格,但不包含独立签名。保留 JSON 和 ZIP 格式: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_KEY_SHA256 --board python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 python -m tgwitness.verify case-board.json --evidence evidence.zip --fingerprint TRUSTED_KEY_SHA256 ``` 选择性检查用于验证签名声明、精确的源记录及其查询在指定边界处的完整性。 证据 ZIP 文件可能更新,但必须包含该前缀。若目标悬空,系统将明确报告。若原始切片快照不同、注释被修改、 重放状态不匹配或源文件被更改,则验证失败。 未带注释的旧存档 仍保留其现有的验证行为。 移交默认设置为**不包含**。显式包含操作会通过已 简化的记录展示项目卡片,省略不可访问/被省略的目标,隐藏源文本 已被简化的高亮内容,按照相同的提及/联系规则清理团队文本,并可选地将 元数据和笔记中已知的调查员标签替换为 R01、R02…… 不披露原始的 `annotations.jsonl`文件。已签名的`tgwitness-case-board-handover-v1`侧车文件和报告 包含相同的最小化内容。切片计数仅描述已披露的记录,原始 快照/查询参与者的详细信息被隐藏。最小化工具未识别的自由文本名称仍需 进行审查,这与常规移交情况相同。衍生文件带有自己的签名; 原始注释在完整存档中保留其签名。 ## 操作限制 参数包括 10,000 张卡片和 50,000 条评论的软限制、最多 5,000 条记录的切片页面,以及媒体预览控制。达到软限制时仅会发出警告,不会删除历史记录。 信息流页面 最多显示 200 张卡片。独立 JSON 切片摘录上限为 64 MiB;若需处理更大规模的数据,请缩小查询范围或使用 带签名的 ZIP 文件。独立验证器将注释回放上限设为 256 MiB。 Case Board 未启用也未实现任何外部评论通知功能。 该功能的自动化验收使用虚构数据和模拟的 Telegram 传输通道来 检查存储、访问、渲染和导出情况。有关证据检查范围的详细信息,请参阅[“验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope) ”。 --- # Telegram · 存档分析 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/ 搜索已保存的消息、审查 AI 输入内容,并保存附有来源参考信息的分析报告。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 搜索已保存的消息、审查 AI 输入内容,并保存附有来源参考信息的分析报告。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [调查](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/) ![调查](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [工作流指南](https://phishdestroy.io/tgwitness/docs/archive/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) 使用**日志**进行不依赖 AI 的本地搜索;[全文搜索](https://phishdestroy.io/tgwitness/zh/docs/reference/search/)(预览版) 可匹配词形、短语、域名和 @用户名。如需使用**更多工具→查询存档**,请先在 **更多工具→集成**中启用并配置提供商。工作区选择器用于选择 账户;表单用于选择聊天和观察时段。 检索在 本地运行。精确短语或域名可缩小检索范围;消息 ID 可请求已保存的 版本。查看摘要并打开其日志记录或上下文。 不包含向量数据库,也不支持自动 Telegram 操作。 ## 服务提供商与同意条款 AI 功能在每个工作区中默认处于禁用状态。仅主管理员可配置 模型、端点、加密 API 密钥、上下文/输出限制、超时及每日 请求配额。密钥绝不会返回至浏览器。若要保留当前密钥,请将密钥字段 留空;如需移除,请明确将其删除。 Ollama 使用其文档中记载的 [`/api/chat` 端点](https://docs.ollama.com/api/chat), 该端点输出非流式 JSON 数据。其默认地址为 TgWitness 服务器上的 `http://127.0.0.1:11434`。操作员可通过 `TGWITNESS_AI_LOCAL_ENDPOINT` 更改该地址;此地址不受模型控制。请自行安装 所选模型。TgWitness 不会自动下载该模型。 兼容的服务提供商应具备以 `/v1` 结尾的基础 URL,并支持 [聊天内容补全协议](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create): `messages`、JSON 响应模式、`max_completion_tokens` 以及 `choices[0].message.content`。缺少这些字段的服务不予支持。 连接测试会发送合成文本,并计入请求配额。 每次请求均使用工作区配置的外部路由。被封锁的路由或 仅限Telegram的MTProxy将导致错误;系统不会直接重试。若刻意 配置了本地Ollama地址,则允许访问私有目的地。 环回 AI 端点需要工作区配置的“Direct”外部路由;代理路由将在 传输前被拒绝。对于其他私有服务,适用现有的服务器级私有 目标选择加入机制。预览中会显示端点和外部路由, 包括适用的代理主机。更改该路由需要生成新的预览。 生成前,**发送至模型的数据**包含请求信息:问题、 已核查的摘录、事件类型、观察时间及覆盖标记。Telegram 会话、原始字段、提供商密钥、附件字节及完整日志 不属于该上下文范围。取消勾选不需要的来源,然后明确批准 处理。外部提供商可根据其自身 政策保留提交的内容。本地执行指端点位于本地;单独配置的 服务则遵循其自身的配置。 全球范围内最多同时存在两个服务提供商请求,每个 工作区限一个。预览有效期为十分钟,且仅可生成一个响应。 页面会显示提供商报告的令牌数量;只有 在输入和输出费率均已配置的情况下,才会显示成本估算。失败的尝试也会 消耗每日请求配额。自动重试不会消耗额外配额。 ## 来源与局限性 检索功能在[全文索引](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#ask-the-archive-and-mcp) 构建完成后启用:根据选定聊天记录中包含词形变体的最佳匹配结果进行检索。关于 近期更改或单条消息版本的查询,以及在索引 构建期间的搜索,均采用针对最新记录的有限词汇检索。预览功能会标注 所采用的方法。检索结果最多返回 24 个来源;长文本会在匹配位置处截断。 截断的摘录和不完整的结果集均会标注。该 时间段指**观察时间**,并不意味着 Telegram 历史记录 是完整的。工作区范围内的事件不会在聊天范围的访问中显示。 缺失的数据将被描述为“在可用存档中未找到”。 该模型不接收任何工具。其来源 ID 需与所选 记录进行比对验证,哈希值需重新核查,且引用的字符串必须出现在这些记录中。 未知 ID、被修改的引用内容以及未被引用的主张将导致答案被拒绝。应用程序 会创建链接;模型生成的 URL 不得用作引用来源。这些检查 旨在确认来源的存在性及引用的准确性。 在依赖推论结果之前,请先对照记录进行核查。 ## 报告 将经过审核的回答保存为一份独立的分析报告。该报告包含模型 摘要、观察到的时间线、提取的链接和标识符、编辑/删除记录、 覆盖范围限制以及源事件哈希值。同时附有提供商、模型、端点、时间以及 提示词模板版本信息。不会自动合并任何身份信息。 分析师的修订和注释与模型摘要分开存储。报告 保存在加密的衍生文件中,索引位于签名事件流之外; 原始事件和媒体内容不会发生改变。只有所有者或管理员才能 打开报告,且会再次验证源访问权限。 下载同样需要导出 权限。第 1 版不会对报告进行签名,也不暗示模型结论是 经过验证的证据。限制:每个工作区 100 份报告,每份报告 100 次分析师修订 。 有关手动 OCR 和文字转录,请参阅[“媒体处理”](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/)。 有关客户端访问,请参阅 [MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/)。 --- # Telegram · 全文搜索 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/search/ 根据词形、精确短语、域名和 @用户名 查找已保存的消息,按最匹配结果优先排序,索引与签名日志绑定。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 根据词形、精确短语、域名和 @用户名 查找已保存的消息,按最匹配结果优先排序,索引与签名日志绑定。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [调查](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/) ![调查](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [存档分析](https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/) · [本地 OCR 和转录](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **预览。**在**“日志**”中,选择搜索框旁边的**“最佳匹配 · 词形变体**” 选项。结果按 BM25 算法排序,并匹配同一单词的其他形式: *搜索“перевод*”会找到*“переводом*”和*“переводы*”,*搜索“transfer*”会找到*“transfers*”,中文 短语在搜索时不保留空格。**选择“最新优先 · 精确文本**”可保留之前 对整个记录进行的子字符串搜索。 索引是衍生数据。它由签名日志重建而成,本身从未被签名, 也从未被导出。原始记录不会发生任何变化。 **本页内容** - [搜索语法](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#search-syntax) - [语言](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#languages) - [索引的位置](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#where-the-index-lives) - [结果和已签名的日志](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#results-and-the-signed-journal) - [识别出的文本](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#recognized-text) - [访问](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#access) - [咨询存档和 MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#ask-the-archive-and-mcp) - [依赖项](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#dependencies) - [基准测试](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#benchmark) ## 搜索语法 | 撰写 | 查找 | | --- | --- | | `перевод карта` | 同时包含这两个词的记录(形式不限) | | `"переводом на карту"` | 请按此顺序保留确切的短语 | | `бонус OR подарок` | 任一词 | | `перевод -казино` | 不含被排除词的记录 | | `example.com` | 该域名及其子域名,包括隐藏链接和按钮 URL 中的域名 | | `@username`, `t.me/username` | 该账号的提及和链接,以及其发送的消息 | | `#tag` | 话题标签 | | `+79991234567`,一个钱包地址,一个电子邮件地址 | 文本或链接中的相同值 | | `from:@username`, `from:123456` | 来自该发件人的消息 | | `chat:-1001234567890` | 一个聊天窗口;它只能限制您自己的访问权限 | | `id:42` | 消息 42 的已保存版本 | | `since:2026-01-01 until:2026-01-31` | 观察时段;仅含日期而不含时间的日期表示全天 | | `kind:edited` | 仅编辑(`new`, `snapshot`, `edited`, `recovered`) | | `source:ocr`, `source:transcription`, `source:all` | 识别出的文本,可替代消息或与消息并存 | 当存在其他单词时,介词和其他功能词将被忽略。 混入单词中的易混淆字母(例如西里尔字母单词中的拉丁字母 *a*)、全角 及装饰性 Unicode 字母以及不可见字符均将被规范化处理。 ## 语言 系统会根据每条记录中的脚本和字母来检测语言: | 脚本 | 匹配 | | --- | --- | | 西里尔字母 | 使用 [pymorphy3](https://github.com/no-plagiarism/pymorphy3) 处理俄语和乌克兰语词干。若未启用可选的乌克兰语词典,则使用轻量级乌克兰语词干提取器 | | 拉丁文 | 英语 Snowball 词干提取器;忽略音标符号 | | 中文、日语、韩语、泰语、老挝语、高棉语、缅甸语 | 重叠字符对:查找不包含空格的任何短语。中文查询将使用 jieba 拆分为单词 | | 其他脚本 | 精确词句 | 乌克兰语词典(`pymorphy3-dicts-uk`)依据 GPL-3.0 协议发布,因此 默认情况下不会安装。请使用以下命令进行安装 `pip install "tgwitness[uk-dictionary]"`; 索引会自动识别新的分析器并重新构建自身。 ## 索引的位置 | 模式 | 存储 | 用法 | | --- | --- | --- | | 磁盘存储(默认) | `search/fulltext.sqlite3` 在工作区目录中 | 支持大型存档;重启后数据仍可保留 | | 仅限内存中 | 磁盘上不留任何数据;每次启动时都会重新构建 | 磁盘上不保留消息文本的任何衍生副本 | | 关闭 | 不设索引;**按最新内容优先排序 ·** 保留**原文精确表述** | 最低配置 | 主管理员可在**“日志”→“过滤器”→“搜索索引**”中 为每个工作区选择模式。 `TGWITNESS_FULLTEXT=disk|memory|off` 为 未自行选择的 Workspace 设置默认值。切换至“内存”或“关闭”将删除该文件。 索引文件与日志具有相同的保护措施:它位于私有数据 目录中。备份和异地副本不包含该文件。 新记录会在后台数秒内完成索引;搜索时也会优先索引 短暂的积压记录,因此刚保存的记录也能被检索到。现有日志会在 更新后完成索引,且不会阻塞面板;在此之前,搜索结果涵盖 已索引的记录,日志会显示进度。**重建索引时**将从 第一条记录开始重新进行。 ``` python -m tgwitness index status --data-dir data/live python -m tgwitness index rebuild --data-dir data/live --json ``` `rebuild` 需要停止该面板(否则退出代码为 3)。使用 `--json`, 标准输出仅显示结果;进度信息将输出到标准错误。 ## 结果及签名日志 索引存储其所涵盖的最后一条日志记录的序列号和哈希值, 并在打开日志时将其与日志进行比对。若日志被替换、恢复或编辑, 则会触发索引重建。每次响应都会报告该位置,每次查询结果均 通过序列号从签名日志中读取:索引仅决定显示哪些 记录以及显示顺序,绝不涉及记录内容。聊天权限仅适用于 日志自身的聊天字段,而不适用于索引内容。 ## 识别出的文本 OCR 结果和转录文本保留在其加密的原始文件中。其索引仅存在于 内存中,并在识别任务完成时重建。匹配结果将显示在其 `media.saved` 记录中显示,标注为“机器识别”,并附带引擎、模型及 摘录内容;该内容绝不会以 Telegram 中发送的文本形式呈现。同一索引还用于 **“搜索已识别文本**”功能,该功能仍可匹配纯文本子字符串。 ## 访问 “聊天范围”访问仅查找来自其聊天的记录,包括 其附件中被识别的文本。 `chat:` 以及其他过滤条件仅能进一步缩小该数据集范围。向范围限定访问显示的索引状态 不包含日志总数。仅主管理员可以更改 模式或重建索引。 ## 向存档和 MCP 咨询 **更多工具 → “查询存档** ”会在索引构建完成后从该索引中检索来源: 在选定的聊天记录中查找最佳匹配结果,且已保存的文本仅计数一次。最多发送24 个来源;长文本会在匹配位置处截断,并标记为截断。 关于近期更改、某条消息的已保存版本以及在 索引仍在构建期间进行的搜索,均使用之前的按时间顺序检索方式。预览 会显示所使用的方法。 MCP 客户端可调用 `search_messages` 使用 `ranked=true` ,并使用 `next_offset`。范围限定连接仅接收其所属的聊天内容。 排序分页最多显示前1,000条结果,无论页面大小如何。请缩小查询范围、聊天范围或时间范围以查看更多匹配结果。按最新优先搜索会在选择每页之前,对消息、OCR 结果和转录结果进行排序。 ## 依赖项 | 软件包 | 许可协议 | 为什么 | | --- | --- | --- | | pymorphy3、pymorphy3-dicts-ru、DAWG2-Python | MIT | 俄语和乌克兰语词干;词典在本地加载 | | snowballstemmer | BSD-3-Clause | 英文词干,纯 Python 代码 | | jieba | MIT | 中文查询分词,纯 Python 实现(仅提供源代码分发) | | pymorphy3-dicts-uk(可选) | GPL-3.0 | 完整的乌克兰语词典 | SQLite FTS5 需要 `unicode61` 分词器;该分词器是当前 Python 构建版本中 SQLite 的一部分。若缺少该分词器,最佳匹配搜索将报告其不可用。 ## 基准测试 `python tools/bench_fulltext.py --messages 1000000 --work `生成一个确定性的签名日志,其中包含来自 200 个聊天群组中混合使用俄语、乌克兰语、英语、 中文和日语的消息,以及其中的链接和标识符;构建索引 并测量典型搜索的耗时(50 条结果,7 次运行的中位数)。 测试环境:Windows 11、Intel Core i9-13900K、128 GB 内存、Python 3.12.10、SQLite 3.49.1,数据存储于 exFAT 分区,分析器 `fulltext-v1+pymorphy3-ru+light-uk+snowball-en`: | 度量 | 结果 | | --- | --- | | 签名日志 | 1,000,000 条消息,1.50 GiB,19 分钟内写入 | | 基于日志构建索引 | 71 秒,约每秒 14,141 条消息 | | 索引文件 | 58 MiB,占日志总量的 3.8% | | 在新记录生成后立即进行搜索 | 中位数 8 毫秒,P95 值 9 毫秒 | | 之前的子字符串搜索,同一日志 | `перевод` 3.2 秒, `银行转账` 2.6 秒, `verify-account.example` 2.6 秒 | | 搜索 | 匹配记录 | 最佳匹配,中位数 | p95 | 最新优先,中位数排序 | | --- | --- | --- | --- | --- | | 常用词及词形: `перевод` | 134,403 | 82 毫秒 | 85 毫秒 | 7 毫秒 | | 两个词: `оплата карта` | 28,996 | 43 毫秒 | 43 毫秒 | 14 毫秒 | | 生僻词: `розыгрыш подарок` | 28,881 | 42 毫秒 | 47 毫秒 | 13 毫秒 | | 精确短语: `"переказ коштів на картку"` | 不计入 | 35 毫秒 | 36 毫秒 | 6 毫秒 | | 域名及子域名: `verify-account.example` | 12,435 | 17 毫秒 | 17 毫秒 | 3 毫秒 | | @用户名: `@support_desk_bot` | 10,331 | 15 毫秒 | 16 毫秒 | 3 毫秒 | | 中文无空格: `银行转账` | 17,691 | 23 毫秒 | 24 毫秒 | 3 毫秒 | | 日语: `リンク` | 16,603 | 23 毫秒 | 25 毫秒 | 3 毫秒 | | 英文词干: `withdrawal` | 27,775 | 26 毫秒 | 26 毫秒 | 2 毫秒 | | 或与排除: `бонус OR подарок -казино` | 268,034 | 190 毫秒 | 193 毫秒 | 19 毫秒 | | 聊天过滤器: `chat:-1000000000007 перевод` | 652 | 9 毫秒 | 9 毫秒 | 6 毫秒 | | 时间范围筛选器: `since:2026-01-01 until:2026-01-31 выплата` | 115,732 | 155 毫秒 | 156 毫秒 | 81 毫秒 | 系统会按排名顺序逐一检查候选结果中是否存在完全匹配的短语,直到页面 填满为止,因此该项的总数不计入统计。耗时随匹配记录数量的增加而增长; 缩小聊天范围或时间范围可加快广泛搜索的速度。合成语料库中 词汇量有限,因此常见词匹配到的记录数量远多于真实聊天记录。 --- # Telegram · 只读 MCP Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/ 将 MCP 客户端连接到选定的工作区和聊天群组,并授予具有时效性且可撤销的访问权限。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 将 MCP 客户端连接到选定的工作区和聊天群组,并授予具有时效性且可撤销的访问权限。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [存档集成](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/) ![存档集成](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) 将分析客户端连接到选定的工作区和聊天群组。TgWitness **在面板进程的 `/mcp` 端点**提供 **可流式传输的 HTTP** 服务。每个连接都有其专属的 令牌、有效期和允许使用的工具。MCP 无法发送 Telegram 消息、更改 设置或修改签名日志。这些连接同样适用于 [命令行](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/)。 [工作流指南](https://phishdestroy.io/tgwitness/docs/archive/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **本页内容** - [安装与检查](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/#install-and-check) - [建立连接](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/#issue-a-connection) - [连接您的客户端](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/#connect-your-client) - [Cloudflare Tunnel](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/#cloudflare-tunnel) - [工具与边界](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/#tools-and-boundaries) ## 安装与检查 使用运行面板的 Python 环境。从源码检出目录执行: ``` # Windows PowerShell & .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' & .\.venv\Scripts\python.exe start.py --check ``` ``` # Linux / macOS .venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]' .venv/bin/python start.py --check ``` 安装完成后,请使用其常规数据目录和启动参数重新启动控制面板。就绪状态应包含`[PASS] mcp: streamable-http available`。 **在更多工具→集成→MCP中,**可查看运行时状态以及使用 该服务器实际 Python 可执行文件的安装命令。**点击重新检查**可刷新此状态而无需 重新加载页面;此操作不会安装软件包或重启服务器。 该 MCP 扩展程序使用官方的[MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)。`deploy/constraints-mcp.txt` 锁定了经过测试的 SDK 及其依赖项。 ## 签发连接 1. 输入标签并选择客户端可读取的工作区和聊天。 2. 逐个选择工具或使用预设。仅提供已实现的工具。 3. 选择 1、7、30 或 90 天,或在 1 分钟至 90 天之间自定义过期时间。 4. 点击 **Create connection**。令牌会在客户端配置旁显示一次。 5. 复制令牌和配置,然后运行 **Check connection**。它会初始化 MCP 并列出允许使用的工具;**不会读取任何消息**。结果将显示协议版本、工具名称、数量和耗时。 6. 保存凭据后点击 **Done**。轮询会保留表单和单次显示的卡片。锁定面板会清除已显示的机密信息。 列表会显示最近使用情况、上次使用的工具、地址以及过去一分钟内的请求数。**Revoke** 会终止访问权限。**Rotate token** 会吊销旧凭据,并签发具有相同范围、工具和过期时间的替代令牌;请单次复制该替代令牌。面板登录令牌和 Telegram 凭据不能用作 MCP 令牌。 ## 连接您的客户端 在面板中选择客户端并复制生成的配置。配置使用机密引用或显式占位符;令牌需单独复制。 | 客户端 | 配置 | 连接 | | --- | --- | --- | | Claude 代码 | `.mcp.json` | HTTP,`type: "http"`,Bearer 请求头 | | Claude Desktop | `claude_desktop_config.json` | 本地 stdio 桥接 | | Cursor | `.cursor/mcp.json` | 带环境变量请求头的 HTTP | | VS Code 本地版 | `.vscode/mcp.json` | 带密码 `promptString` 输入的 HTTP | | Windsurf | `mcp_config.json` | 带 Bearer 请求头占位符的 HTTP | | 其他客户端 | URL 和 Authorization 请求头 | 可流式传输的 HTTP | TgWitness 使用 Bearer 令牌,不支持 OAuth 发现。对于远程连接器需要 OAuth 的客户端,请使用本地 stdio 桥接。对于 VS Code,输入变量适用于 **Local** 环境,不会转发到 Copilot 会话。配置参考:[Claude Code](https://code.claude.com/docs/en/mcp)、[Cursor](https://prod.cursor.com/docs/mcp)、[VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)。 本地桥接的标准入口点为: ``` python -m tgwitness.mcp_server --url https://your-panel.example/mcp ``` 使用客户端本地已安装 MCP 扩展的 Python。在其受保护的环境中设置 `TGWITNESS_MCP_TOKEN`。切勿将凭据放入命令参数和 URL 中。`tgwitness-mcp` 是相同的入口点。旧的 `tgwitness.mcp_bridge` 模块和 `TGWITNESS_ARCHIVE_TOKEN` 名称仍作为兼容路径保留,但会发出警告;新配置请使用 `mcp_server` 和 `TGWITNESS_MCP_TOKEN`。 ## Cloudflare Tunnel 转发面板的 `/mcp` 路由并保留 Bearer 请求头。以管理员身份打开 MCP 设置会为本次运行注册面板的当前源(Origin)。若要获得重启后立即可用的稳定地址,请在启动面板前使用面板的 HTTPS 源配置 `TGWITNESS_PUBLIC_URL`。任意 Host 和转发请求头不会注册受信任的地址。Host 和 Origin 检查会拒绝无关的浏览器源。响应使用 `Cache-Control: no-store`;授权值绝不会被记录到日志中。 `*.trycloudflare.com` 地址是临时的。当隧道重启更改主机名时,请更新已配置的公共 URL 以及每个客户端的 MCP URL。对于已保存的客户端配置,请使用稳定的主机名。 ## 工具与边界 | 工具 | 读取内容 | | --- | --- | | `list_workspaces` | 已授权的工作区 | | `list_chats` | 已授权的聊天 | | `search_messages` | 所选时间段内保存的消息正文; `ranked=true` 支持[全文搜索](https://phishdestroy.io/tgwitness/zh/docs/reference/search/)(包含词形变体,优先显示最匹配结果, `next_offset` 分页) | | `get_message_versions` | 已捕获的版本和删除观测记录 | | `get_message_context` | 附近已捕获的消息 ID | | `get_journal_event` | 单条经过脱敏处理的记录及其来源引用 | | `get_capture_status` | 采集状态、允许记录的覆盖范围以及 `gap_summary`:按频道或超级群以及全账户序列统计的未观察到的消息编号([详情](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#missing-message-numbers-gap_summary));选择一个聊天室即可查看其列出的缺失记录 | | `get_activity_stats` | 按 UTC 小时和星期几分类的消息、高峰日、编辑与删除比例、发件人、域名以及 `@handles`,并包含覆盖范围([详情](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/#activity-statistics)) | | `get_messages_by_date` | 在指定的 IANA 时区中保存一个日历日的消息(`Europe/Kyiv`, `UTC`),以Telegram报告的时间为准; `from_utc` 并 `until_utc` 注明计算出的日期(包含夏令时) | | `get_pinned_messages` | 最新聊天状态快照中被置顶的消息及其保存版本,以及实时观察到的置顶和取消置顶通知 | | `get_chat_stats` | 提供单个聊天或范围内所有聊天的已保存记录数量、首次和最后一次观察记录,以及 `gap_summary`;请在进行大规模读取前使用该功能 | | `get_topics` | 来自“已保存主题”服务消息的论坛主题:标题历史、已关闭或已隐藏、已保存消息数量 | | `get_media` | 作为缩放后的 JPEG 预览图(最大 36 KB)保存的图像,将作为图像与 SHA-256 值及 `media.saved` 记录;该文件会首先与其记录的哈希值进行比对,其他文件仅返回元数据 | | `export_messages` | 仅限命令行,默认未选中:流将记录的观察结果保存为 JSON Lines 格式([详情](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/#export));不通过 MCP 提供 | 每个工具均为只读模式(`readOnlyHint`)并声明了一个输出模式;超出声明范围的字段将按原样返回。 `tools/list` 仅返回授予该连接权限的工具。对其他 工具的调用将被拒绝。本版本不提供组上下文、事件、术语和回复链工具; 因其独立的上下文包后端未包含在内。 每次读取都会检查令牌、工具以及工作区/聊天范围,包括在数据库操作完成之后。限制为每分钟 60 次请求、每页 50 条记录、每个结果 64 KiB 以及 8 秒的归档截止时间。超时的 MCP 调用会返回工具错误,要求缩小时间段或降低限制。 消息结果包含`untrusted_content: true`、工作区/聊天/消息 ID、 事件序列、已保存的哈希值以及面板链接。原始 Telegram 对象、访问哈希值、 会话和密钥均被省略。文本截断处已做标记。编辑、删除通知 以及`missing_on_recheck`均属于独立的观察结果。覆盖范围显示了 该结果所涵盖的时间段。 将捕获消息中的指令视为证据,切勿视为客户端 指令。只读访问可防止归档内容被修改;客户端仍可 保留其被允许阅读的内容。哈希值用于标识已保存的记录并 支持完整性检查。审查结果时,请使用随附的源参考资料和覆盖记录。 --- # Telegram · 命令行 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/cli/ 支持通过脚本和代理进行搜索、阅读上下文、统计活动以及导出已保存的消息,提供 --json 输出格式、稳定的退出代码以及作用域限定的只读令牌。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 支持通过脚本和代理进行搜索、阅读上下文、统计活动以及导出已保存的消息,提供 --json 输出格式、稳定的退出代码以及作用域限定的只读令牌。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![存档集成](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [只读 MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/) · [全文搜索](https://phishdestroy.io/tgwitness/zh/docs/reference/search/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) **Preview.** `tgwitness search`, `context`, `messages`, `stats` and `export` read saved observations for scripts and AI agents. They cannot send anything to Telegram, change settings or modify the signed journal. `tgwitness index` and `tgwitness backup` ([below](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/#index-and-backup)) work on a local data directory and need no token. 其中 `--json`,标准输出(stdout)将输出且仅输出一个 JSON 文档(`export` 写入 JSON Lines)。 进度、提示和错误信息输出到 stderr。退出代码保持稳定: | 代码 | 含义 | | --- | --- | | `0` | 成功,包括空结果 | | `1` | 失败:无法访问面板、数据无法读取、导出中断 | | `2` | 使用错误或请求无效:日期格式错误、未知选项、搜索索引不匹配 | | `3` | 当前不可用:工作区已在运行中的面板中打开,或者面板提示稍后重试(速率限制、超时) | | `4` | 访问被拒绝:令牌缺失、过期或已被撤销;聊天超出其范围;或该工具不允许此操作 | ## 两种阅读方式 **通过面板(`--url`)。**该命令使用与 MCP 相同的范围限定存档 API。**在更多工具→集成→MCP中**建立连接:选择工作区和聊天群、 工具及有效期,然后复制一次令牌。该连接为只读模式,仅限于 所选聊天群,每分钟请求限额为 60 次,且可随时撤销或 轮换。Panel 登录令牌和 Telegram 凭据在此处无效。 ``` export TGWITNESS_URL=https://panel.example.org # default http://127.0.0.1:8787 export TGWITNESS_MCP_TOKEN=tgw_mcp_... # or --token-file path tgwitness search 'перевод карта' --json ``` 远程面板需要 HTTPS;仅在以下情况下才接受明文 HTTP: `127.0.0.1`, `localhost` 和 `::1`。代理环境变量将被忽略,且不接受重定向, 因此令牌仅会发送到您指定的地址。 **直接从已停止的工作区(`--data-dir`)**读取**。**以 完全本地访问权限读取数据目录,无需令牌。请在数据目录的副本上使用,或在 数据收集已停止时使用。签名记录绝不会被更改;与控制面板类似,打开 工作区可能会使其派生索引更新至最新状态。当控制面板已打开该工作区时,该命令将以 代码 `3`;请改通过面板进行读取。若未指定 `--data-dir`, `TGWITNESS_DATA`, `./data/live` 或未指定,则使用运行该命令的安装环境的数据目录。 `--workspace ID` 选择工作区(默认 `default`). `tgwitness messages --workspaces` 列出您可以阅读的工作区。 ## 命令 | 命令 | 结果 | | --- | --- | | `tgwitness search QUERY [--chat ID] [--since] [--until] [--any] [--limit N] [--offset N]` | 按最匹配结果优先排序,包括词形变体、加引号的精确短语、域名以及 `@username` ([语法](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#search-syntax)) | | `tgwitness search QUERY --exact [--before SEQ]` | 精确文本,按时间倒序排列(最新内容在前),不包含索引 | | `tgwitness context CHAT_ID MESSAGE_ID [--limit N] [--before SEQ]` | 前后各十条消息 ID 范围内的已保存消息 | | `tgwitness messages [--limit N] [--offset N]` | 可阅读的聊天记录 | | `tgwitness messages CHAT_ID [--since] [--until] [--limit N] [--before SEQ]` | 聊天记录中的已保存消息,按时间倒序排列(最新消息在前) | | `tgwitness messages CHAT_ID --message ID` | 每条消息的每个保存版本及删除记录 | | `tgwitness stats [--chat ID] [--sender ID] [--since] [--until] [--top N]` | 活动统计数据如下: | | `tgwitness export [--chat ID] [--since] [--until] [--output FILE]` | 将观察记录按日志顺序以 JSON Lines 格式保存 | 日期格式为 `2026-10-01` (UTC 午夜)或带时区的 ISO 时间, `2026-10-01T09:00+03:00`。关于 `search`, `messages` 和 `export` ,它们表示 观察时间。每页最多显示50条记录:请遵循 `next_offset` (`--offset`)进行 排序搜索, `next_before` (`--before`) 其他内容。 Ranked search stops at 1,000 results. The final page may be shorter than `--limit`. When more observations match, the last page says so (`truncated: true` with `--json`); narrow the query, chat or period. 每条消息结果都包含`untrusted_content: true` 、工作区、聊天和 消息 ID、日志序列号、已保存记录的哈希值以及面板链接。编辑、 删除通知和`missing_on_recheck` 是单独的记录。`stats` 中的覆盖范围显示了搜索结果所涵盖的时间段。 ### 活动统计 `stats` 统计特定聊天、特定发送者或范围内所有聊天的已保存观察记录数量: - 按 UTC 小时和星期几(以周一为首)分类的消息;最繁忙的小时和日期; - 已编辑、已删除和 `missing_on_recheck` 分享; - 发件人及其消息数量,以及第一条和最后一条消息的时间; - 出现频率最高的域名以及 `@handles`,在所有 已保存版本中,每条消息仅计数一次; - 涵盖范围: `coverage.gap` 记录内容以及(若需访问整个工作区) 未检测到收集器心跳的时段(`collector_liveness`). 该时间段选择 **Telegram 报告的消息时间**。 小时和星期几的计数 有助于估算发件人的时区。这些数据是根据 日志的请求计算得出的,不会被存储。当您的访问范围跨越整个工作区时,每个结果都会标明其 所涵盖的日志头。通过 控制面板读取五秒后,或在本地达到 `--timeout` 秒(默认 30)时,读取将停止;此时 `complete` 为 false, `partial` 则标明第一个未读取的记录。在这种情况下,仅统计 最近的记录。 ### 导出 `export` 每条保存的观察记录(新消息、快照、 编辑、恢复的消息、删除通知、 `missing_on_recheck` 及已保存的媒体 记录)生成一个 JSON 对象,并按日志顺序排列。每行与其他结果具有相同的字段,包含 完整文本。若启用 `--output`,文件将以 `.partial` 名称下写入, 仅在面板完成记录后才重命名;若导出过程中断,则不生成 文件,并以代码 `1`. `--output` 绝不会覆盖现有文件。使用 `--output` 和 `--json`,标准输出将显示摘要:记录数、最后的日志 序列号,以及(对于整个工作区访问)日志头。 通过控制面板进行导出需要一条允许**“导出消息 ”的连接 (仅限命令行)** ;该选项默认未勾选。此文件为工作副本;如需可验证的 交接,请使用**导出** 中的签名导出文件,可通过`python -m tgwitness.verify` 进行验证。 该面板在输出每条记录(包括完成 记录)之前都会重新检查访问权限。被撤销或过期的访问权限会导致导出不完整。延迟页面读取 与其他查询共享归档工作线程的限制,且具有有限的等待时间。 ### Index and backup These two commands read the data directory directly and take no token or `--url`. | 命令 | 结果 | | --- | --- | | `tgwitness index status [--workspace ID] [--data-dir DIR] [--json]` | Search index state of one workspace or, by default, every workspace: mode, `ready`, `building` or `not built`, indexed and journal head sequence. Works while the panel runs | | `tgwitness index rebuild [--workspace ID] [--data-dir DIR] [--json]` | Rebuilds the index from the first journal record. Rewrites only the derived index, never the signed journal. Exits with code `3` while the panel has the workspace open. Nothing is built when the workspace keeps its index in memory or has search off | | `tgwitness backup FOLDER [--data-dir DIR] [--json]` | Copies the whole data directory into a new or empty folder outside it while the panel keeps running, and writes `backup-manifest.json` with every file's SHA-256 and the journal heads | `index` accepts `--workspace default` or a workspace ID; the default is `all`. The backup skips temporary exports, SQLite sidecar files and lock files. The folder holds the Telegram session and signing keys, so keep it as private as the data directory. [Backup, restore, and capacity](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/#backup-restore-and-capacity) describes restoring and what the next start records. ## 代理技能 [`.agents/skills/tgwitness-cli/SKILL.md`](https://github.com/phishdestroy/TgWitness/blob/main/.agents/skills/tgwitness-cli/SKILL.md) 向特工说明如何使用这些命令、如何引用记录以及如何处理 捕获的文本。从 `.agents/skills` 需从代码库检出 该文件。对于 Claude Code,请复制 `tgwitness-cli` 文件夹复制到 `.claude/skills/` 项目中的 或 `~/.claude/skills/`. ## MCP 和命令行 两者均使用相同的连接、范围检查和限制。MCP 的结果限制为 一个 64 KiB 的页面,因此 MCP 不提供批量导出功能;命令行会以流式传输的方式输出数据。 `get_activity_stats` 两项功能均可使用。 --- # Telegram · 本地 OCR 和转录 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/ 通过本地工作进程识别捕获的图像和音频;将生成的文本与源文件保持关联。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 通过本地工作进程识别捕获的图像和音频;将生成的文本与源文件保持关联。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [调查](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/) ![调查](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) [工作流指南](https://phishdestroy.io/tgwitness/docs/archive/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) 打开`media.saved` 日志记录,选择**“识别附件** ”,然后在**更多工具→“询问存档** ”下选择 OCR或转录(当存档AI关闭时,该功能名为**“机器识别** ”)。处理过程为手动且在本地进行。 不支持云媒体模式或自动上传。原始附件字节和 `media_sha256` 保持不变;识别出的文本会被明确标记为机器 识别结果,并单独存储,同时包含源哈希值、引擎/模型版本、 语言、参数及完成时间。转录文本保留返回的时间戳。 可通过**“搜索已识别文本**”功能及“OCR/转录” 过滤器搜索这些结果,或选择已识别文本作为**日志**最佳匹配搜索的来源。 这两种方式均通过[内存索引](https://phishdestroy.io/tgwitness/zh/docs/reference/search/#recognized-text)匹配词形。这 是一种独立的衍生数据搜索;它不会在后台将机器识别结果 转换为原始 Telegram 文本,也不会将其添加到已签名的事件中。 ## 配置可选的工作进程 第 1 版需要配备本地 Docker 守护进程的 Linux 主机。Windows 系统 可在配备独立本地守护进程的 Linux 虚拟机/WSL 环境中运行 TgWitness。 该面板绝不会自行解码任何不可信的附件。 ``` docker build -f deploy/media-worker/Dockerfile -t tgwitness-media:local . export TGWITNESS_MEDIA_IMAGE=tgwitness-media:local ``` 在 TgWitness 服务环境中设置这些变量并重启服务。 守护进程套接字默认值为 `/var/run/docker.sock`;无 root 权限的部署可设置为 `TGWITNESS_DOCKER_SOCKET`。工作进程会明确使用该 Unix 套接字, 而非远程 Docker 上下文。请勿向控制面板用户暴露 Docker API,也请勿将 其套接字挂载到识别容器内。 若需进行转录,请单独安装一个与 CTranslate2 兼容的 Whisper 模型, 然后将 `TGWITNESS_WHISPER_MODEL_DIR` 设置为其目录。工作节点将通过 `local_files_only=True` 加载该模型;所选模型和输入数据将以只读方式挂载。 请参阅引擎的[模型加载文档](https://github.com/SYSTRAN/faster-whisper)。 随附的 OCR 镜像包含英语和俄语的训练数据。如有需要,可将其他 语言构建到您的镜像中;语言代码遵循 [Tesseract 的 CLI 规范](https://tesseract-ocr.github.io/tessdoc/Command-Line-Usage.html)。 处理过程中不会加载任何模型。构建/下载安装程序可能会使用网络; 每个实际的识别容器均已禁用网络功能。请在启用网络功能前安装镜像; 运行时使用 `--pull=never`。 ## 限制与恢复 该容器以无特权用户身份运行,具有只读根目录、已撤销 权限、`no-new-privileges` 配置、1 个 CPU、2 GiB 内存、PID 限制以及受限的 临时文件系统。仅挂载所选文件的经过验证的副本以及可选的 模型目录。 收集器的数据库、存储库和会话均 未挂载。[Docker 运行时](https://docs.docker.com/reference/cli/docker/container/run/) 标志强制执行这些限制;这仍属于容器边界,而非硬件安全区。 文件大小上限为 50 MiB,图像分辨率上限为 2000 万像素,音频时长上限为 30 分钟( 且时长已知),处理时长上限为 5 分钟。每次仅有一个工作进程运行, 每个工作区最多可有 20 个排队/正在运行的任务,并保留 100 个任务。 “取消”将停止容器;“重试”将创建一个与先前尝试相关联的新任务。 中断的任务在重启后会被标记。当模型 无法适应配置的限制时,处理可能会失败;若未进行隔离,系统不会静默运行。 --- # Telegram · 外发 webhook Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/webhooks/ 将带 HMAC 签名的指定范围事件发送至 HTTPS 接收端,支持重试并提供投递状态。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 将带 HMAC 签名的指定范围事件发送至 HTTPS 接收端,支持重试并提供投递状态。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [存档集成](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/) ![存档集成](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074) [工作流指南](https://phishdestroy.io/tgwitness/docs/archive/) · [维基](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md) 在所选工作区中打开**更多工具→集成→外发 webhook**。添加一个 HTTPS 接收器,选择收集器/媒体/导出事件,并可选地为 新观察结果和变更选择聊天。消息正文默认处于关闭状态。启用摘要 功能后,消息变更事件最多增加 1,000 个字符;Telegram 的原始字段和 凭据绝不会被发送。 将 HMAC 密钥复制一次到接收器的受保护配置中。该密钥 存储在 TgWitness 的保险库中并经过加密,无法通过控制面板检索。删除 并重新创建目标以实现密钥轮换。**向合成**测试队列**发送**一条 不含聊天内容的测试消息;刷新投递状态以查看结果。 该功能在 Apprise 的基础上扩展了现有的通知循环。它利用 工作区的外部路由和现有的私有目标限制。 后续不会进行直接的备用处理或重定向。URL 不得包含凭据、 查询字符串或片段;私有地址需要服务器级别的网络 授权,而非面板用户可绕过的设置。 ## 有效载荷与签名 模式:[`tgwitness.webhook/1`](https://github.com/phishdestroy/TgWitness/blob/main/integrations/webhook.schema.json)。每个有效载荷 包含 `event_id`、`timestamp`、`workspace`、`type`、`synthetic` 以及计数器。 基于日志的事件包含其序列号和哈希值。完整导出完成和 合成测试属于交付事件,不包含虚构的签名日志引用。 Telegram 删除通知和 `missing_on_recheck` 仍为独立类型。 `X-TgWitness-Signature` 标头应为 `t=UNIX_SECONDS,v1=HEX_HMAC_SHA256`。 使用显示的密钥(作为 UTF-8 字节)对精确字节序列 `timestamp + "." + raw_request_body` 计算 HMAC, 并在解析或处理正文之前以常数时间比较签名。若时间戳与 本地时间相差超过五分钟,则予以拒绝。每次投递尝试时,时间戳都会刷新。 在持久化存储中使用 `event_id` 作为幂等键,并在产生副作用之前设置原子性唯一 约束。仅凭有效的签名并不能防止 最近的请求被重放。请至少在整个 重试窗口内保留已处理的 ID;如果接收方可以重新处理存储的事件,则应更长时间地保留这些 ID。 ## 重试 交付任务会在 HTTP 请求之前被持久化地放入队列。它们采用至少一次 语义:确认消息丢失或重启可能会导致带有 相同 ID 的事件被再次交付。系统会进行八次尝试,采用指数退避策略,起始时间为 15 秒,上限为一小时。成功需返回 2xx 状态码。用尽 重试次数的任务将连同其错误信息一起保持可见状态,以便审查。 队列可容纳 1,000 次发送任务。当队列已满时,日志事件的扫描将暂停, 并在有可用空间后恢复。 无法排入队列的完整导出任务 会触发可见的队列错误。每次通知处理 最多尝试发送五次,并保留最近 100 条尝试记录。删除一个目标 也会一并删除其待发送的任务。 ## n8n 示例 导入[示例工作流](https://github.com/phishdestroy/TgWitness/blob/main/integrations/n8n-tgwitness.json)。该工作流处于非活动状态, 且不包含任何机密信息或下游操作。 在 n8n 工作进程环境中设置 `TGWITNESS_WEBHOOK_SECRET`, 允许该环境访问,并为 Code 节点启用 `crypto` 内置函数。该示例使用 Webhook 节点的 raw-body 选项, 检查签名/新鲜度,并确认已验证的事件。这与 该节点的[文档中所述的实现](https://github.com/n8n-io/n8n/blob/master/packages/nodes-base/nodes/Webhook/Webhook.node.ts)方式一致。 在添加 SIEM 写入或通知之前,请先添加以 `event_id` 为键值的持久化幂等存储。 根据您选择发送的数据,限制 n8n 工作流的编辑及执行日志的保留时长。 TgWitness 不添加任何入站命令。 --- # Telegram · 公开展示 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/showcase/ 通过有效期有限且可撤销的链接,发布所选公共频道的已保存消息和已签名的快照。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 通过有效期有限且可撤销的链接,发布所选公共频道的已保存消息和已签名的快照。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [部署与恢复](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/) ![部署与恢复](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f) **更多工具 → 访问 → 公共展示**利用现有的 访问令牌系统创建一个独立的只读页面。它读取安装实例中保存的观察结果。它不会 为访客启动收集器、登录 Telegram 或获取频道。 ## 发布页面 1. 为每个您希望展示的公共频道保存一个源配置文件。该频道必须 在其最新保存的配置文件中拥有一个公共用户名;群组和私聊 不符合条件。 2. 以管理员身份打开**更多工具→访问→公共展示**(或`/showcase-manage.html`)。 3. 从最多 16 个工作区中选择频道,输入公共页面标题,并 选择链接有效期为 1 天、7 天或 30 天。工作区内部标签不会 对外发布。最多可包含 64 个频道。 4. 审核选定频道的文本以供发布,然后点击**“预览选定 记录”**。预览使用与访客页面相同的服务器端投影。 5. 点击“**创建展示链接**”。在链接可见时将其复制。在 另一个浏览器中打开该链接,在分发前预览收件人的页面。 该链接的 URL 片段中包含一个访问令牌。页面在发起 API 请求前会移除该 片段,并将其替换为浏览器会话。 任何持有该链接的人均可打开所选内容,直至链接过期或被撤销。 新链接允许 100 个并发会话,每个会话最长持续一小时。现有的 访问控制还可以通过 授权 API 实施地址限制和登录次数限制。普通审阅者访问属于另一种模式,仍包含 最初允许的消息和文件。 ## 访客所见内容 | 可见 | 保持私密 | | --- | --- | | 精选的公共频道名称、用户名及个人资料观察日期 | 账户身份、内部工作区标签和未选中的来源 | | 捕获的文本及每次保存的编辑内容 | 结构化的发件人 ID、姓名、用户名、电话号码和个人资料信息 | | 删除记录(如有)及先前保存的文本 | 附件、头像、缩略图、文件名和原始有效载荷 | | 标记用于指示作者/个人资料或附件已被记录 | 转发和回复元数据、网络路由、IP 地址及凭据 | | 选定频道的事件计数、当前采集开关、心跳和检查点间隔 | 数据收集控制功能和常规证据导出 API | | 签名指纹、日志检查点和一致性证明 | 签名密钥和 Telegram 会话 | **公开消息的文本不会自动匿名化。**消息中包含的姓名、提及、电话 号码或链接仍将保留在文本中。 `Redacted`适用于结构化的作者/个人资料字段。发布前请检查实际选中的内容, 包括保留的编辑和删除内容。 “符合条件”反映的是**最新保存的源配置文件**,而非实时查询 Telegram 的结果。 如果后续的配置文件中不再包含该公共频道的用户名,新的请求 将排除该频道。当公共可见性发生变化时,请刷新源配置文件。 读者可能已经保存了之前收到的内容。 原始的签名记录保持不变。显示的投影会单独签名, 并携带引用其原始记录的哈希值。投影 签名用于验证显示的陈述,而被引用的原始记录 则保留各自的签名。 ## 检查签名和连续性 展开**“指纹与已签名检查点**”,并下载快照。页面 刷新后,下载内容将包含之前的浏览器快照以及其日志边界之间的 默克尔一致性证明。当页面可见且显示其第一页观察结果时,系统会每 一分钟自动刷新一次。 安装 TgWitness 后,请在离线状态下验证下载的文件: ``` python -m tgwitness.showcase_verify showcase.json --fingerprint TRUSTED_COLLECTOR_SHA256 ``` 指纹必须来自一个单独的可信参考源。若要与 您自己保留的快照进行比对,请使用 `--previous earlier.json`;这将覆盖 下载文件中携带的先前快照。当前证明必须从 该保留的边界开始。经过身份验证的客户端可使用 `GET /api/showcase/{workspace_id}?challenge=<32-hex-random>&from_count=`。 较短的日志会返回 HTTP 409 状态码,而非静默重置边界。 已签名的检查点会提交至**整个收集器**日志,包括其 记录计数和不透明的头部哈希值。显示的消息计数仅适用于 选定的公共频道。该页面绝不会列出其他日志的内容。 这些是事件计数,而非唯一消息计数。设置描述的是 当前配置,而非每个早期的记录间隔。 签名和一致性验证可检测相对于保留 边界所发生的变更。从相应的归档中重新统计已报告的事件,并综合审查 数据采集间隔和保留的见证检查点。 使用[证据验证器](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)、 [独立见证](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)人和[经过测试规模的记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)。 合成安装环境会明确标注为合成。 ## 撤销或托管该页面 在展示管理器或现有的**“访问**”部分中使用**“撤销”功能**,可关闭 链接并终止其所有会话。当请求检测到访问已结束时, 访客将清除显示的记录。每次 请求都会检查有效期和权限。展示权限无法直接转换为普通面板访问权限; 请创建新的权限以切换模式。 通过安装环境现有的 HTTPS 地址提供页面服务。发布 链接不会打开新端口、创建隧道或更改 DNS。HTML 和 API 仍保留在用户的安装环境中。展示页面的访问者无法通过此访问权限使用常规的 消息、个人资料、媒体、导出或管理 API。 --- # Telegram · 证据的运作原理 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/ 通过验证者实际使用的精确公式,详细解释了哈希链、签名、检查点和见证人等概念。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 通过验证者实际使用的精确公式,详细解释了哈希链、签名、检查点和见证人等概念。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [证据与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) ![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness 保留收集账户所观察到的内容,将这些观察结果 链接到一个经过签名的日志中,并允许其他人根据可信 密钥、来自第三方的外部时间以及先前保留的检查点来验证导出内容。 [本地文档网站](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)新增了 位于 `/docs/concepts/` 的交互式示例、位于 `/docs/witness/` 的检查点决策探索器,以及关于[“案件看板](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)”、 [报告设计](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)和[移交摘录](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#handover-extract)的操作指南。 所有示例消息、 计数和延迟均为虚构。链式沙盒中的哈希值是在浏览器中使用 SHA-256 算法计算得出的。没有任何数据会被发送至 Telegram。 **本页内容** - [消息会发生变化;观察结果会不断积累](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#a-message-changes-observations-accumulate) - [哈希值的覆盖范围](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#what-a-hash-covers) - [早期检查点新增的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds) - [见证的归属](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#where-a-witness-belongs) - [针对已知操作进行测试](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#test-delivery-against-known-actions) - [选择工作流](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#pick-a-workflow) ## 消息在变;观察在积累 序列图 · Telegram → 收集器: 新消息:10:00 见面; 收集器 → 签名日志: 追加消息.new; Telegram → 收集器: 编辑:11:00 见面; 收集器 → 签名日志: 追加消息.edited; Telegram → 收集器: 删除通知; 收集器 → 签名日志: 追加消息.已删除; 关于签名日志的说明: 原始内容、编辑内容及删除记录均予以保留 · Telegram · 收集器 · 签名日志 · 新消息:10:00 见面 · 追加消息.new · 编辑:11:00 见面 · 追加消息.edited · 删除通知 · 追加消息.已删除 · 原始内容、编辑内容及删除记录均予以保留 **图表转为文本** 1. Telegram → 收集器: 新消息:10:00 见面 2. 收集器 → 签名日志: 追加消息.new 3. Telegram → 收集器: 编辑:11:00 见面 4. 收集器 → 签名日志: 追加消息.edited 5. Telegram → 收集器: 删除通知 6. 收集器 → 签名日志: 追加消息.已删除 7. 关于签名日志的说明: 原始内容、编辑内容及删除记录均予以保留 此简化流程假设 Telegram 已成功发送每条更新,且所选 账户能够查看该更新。操作事件也会被记录在日志中。删除通知 不会提供删除者信息或确切的删除时间。重复发送的 消息被视为独立的记录;日志中不会进行全局重复项过滤。 ## 哈希值涵盖的内容 ![观察、编码、哈希和签名:每个新事件都包含前一个事件的哈希值。](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c) 从内到外解读该公式:**C** 将九个字段转换为精确的字节; **SHA-256** 生成其摘要;**hex** 表示该摘要的存储格式。前一个 哈希值已包含在事件中。**unhex** 将存储的哈希值还原为 32 字节,供 Ed25519 进行签名。 [静态链图](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg) 设 C(ei) 为九个事件字段的标准 UTF-8 JSON 格式。第一个 `previous_hash` 由 64 个零字符组成。后续的每条记录都包含前一条 记录的十六进制哈希值: hi = hex(SHA256(C(ei))) σi = Ed25519.Sign(sk,unhex(hi)) 该签名覆盖了 32 个原始摘要字节。哈希输入包含 `seq`、`observed_at`、`source_at`、`kind`、`chat_id`、`message_id`、`actor_id`、 `payload` 和 `previous_hash` 这 8 个值。对象键按顺序排列;省略空格和 ASCII 转义符;NaN 和无穷大值被排除。请参阅 [确切的编码](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#event-canonicalization)规则。 流程图 · 64个零字符 → 记录 1 / 哈希值 h1; 记录 1 / 哈希值 h1 → 记录 2 包含 h1 / 哈希 h2; 记录 2 包含 h1 / 哈希 h2 → 记录 3 包含 h2 / 哈希 h3; 记录 3 包含 h2 / 哈希 h3 → 签名检查点:计数 3,标题 h3 (保留在其他地方) · 64个零字符 · 记录 1 / 哈希值 h1 · 记录 2 包含 h1 / 哈希h2 · 记录 3 包含 h2 / 哈希h3 · 签名检查点:计数3,标题 h3 · 保留在其他地方 **图表转为文本** 1. 64个零字符 → 记录 1 / 哈希值 h1 2. 记录 1 / 哈希值 h1 → 记录 2 包含 h1 / 哈希 h2 3. 记录 2 包含 h1 / 哈希 h2 → 记录 3 包含 h2 / 哈希 h3 4. 记录 3 包含 h2 / 哈希 h3 → 签名检查点:计数 3,标题 h3 (保留在其他地方) | 更改为提供的日志 | 检测依据 | | --- | --- | | 修改记录 2,同时保留其已保存的哈希值 | 重新计算的事件哈希值不同;其签名不再涵盖已更改的事件 | | 重建被篡改的记录及其后的每个哈希值 | 原始签名验证失败;受影响边界处保留的检查点也显示不一致 | | 删除尾部内容,但保留前缀部分不变 | 在给定前缀之后的某个较早保留检查点显示,导出内容过短 | | 使用另一把密钥对替换后的日志进行重新签名 | 一个独立的可信密钥指纹会拒绝该替换身份 | ![修改已保存的字段会改变其摘要;重新生成哈希值无法恢复原始签名。](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5) **请在记录 2 上尝试以下逻辑:**将已保存事件中的 `Meet at 11:00` 更改为 `Meet at 12:00`。 其重新计算的哈希值将不再匹配。重新计算后续链 可以修复其链接,但无法使原始签名覆盖新的摘要。 相比之下,被观察到的 Telegram 编辑操作将生成一条新的日志记录。 [静态变更图](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg) 仅凭哈希链接无法阻止他人重新计算替代链。 信任来源于使用独立可信密钥验证签名,外部 时间来源于将日志头固定的第三方,以及保留在 收集器外部的引用。 ## 早期检查点新增的内容 ![保留计数 3 和 h3 标题;在位置 3 处会检查后续导出的 4 条记录。](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9) **随着日志的增长,引用位置保持不变。**如果检查点显示 “3 条记录,头部 h3”,则包含四条记录的导出文件可以通过匹配第 3 位处的 h3 来通过验证。 其最新头部为 h4,预计会有所不同。仅包含两条记录的导出文件将无法通过验证。 [静态检查点图](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg) 在验证检查点签名后,需执行以下操作: Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint 导出内容可能超出检查点的范围,但必须在保留的边界处保持一致。 收集器密钥对检查点进行签名,因此收集器可以对另一个检查点进行签名。 只有当接收方在归档之前通过 其他渠道获取该检查点时,它才会将记录绑定在一起;证据的最低要求还需第三方提供的外部时间戳。 真正的验证者还会检查每个事件的序列、前一个链接、哈希值和 签名。如果仅比较最终存储的头部,可能会遗漏被篡改的内部 记录——因为其保存的哈希值并未更新。 ## 证人的归属之地 流程图 · 采集器 / 账户会话 / 密钥 A → 只读检查点端点; Witness / 固定收集器密钥 / 自有密钥 B → 独立的签名证人日志; Witness / 固定收集器密钥 / 自有密钥 B → 只读检查点端点 (申请审核); 只读检查点端点 → Witness / 固定收集器密钥 / 自有密钥 B (已签名的回答); Witness / 固定收集器密钥 / 自有密钥 B → 包含带签名的 TGW1 帖子的频道 (机器人 API / 专属令牌) · 主机 A · 主机 B · 采集器 / 账户会话 / 密钥 A · 只读检查点端点 · Witness / 固定收集器密钥 /自有密钥 B · 独立的签名证人日志 · 包含带签名的 TGW1帖子的频道 · 申请审核 · 已签名的回答 · 机器人 API / 专属令牌 **图表转为文本** 1. 采集器 / 账户会话 / 密钥 A → 只读检查点端点 2. Witness / 固定收集器密钥 / 自有密钥 B → 独立的签名证人日志 3. Witness / 固定收集器密钥 / 自有密钥 B → 只读检查点端点 (申请审核) 4. 只读检查点端点 → Witness / 固定收集器密钥 / 自有密钥 B (已签名的回答) 5. Witness / 固定收集器密钥 / 自有密钥 B → 包含带签名的 TGW1 帖子的频道 (机器人 API / 专属令牌) 见证者会记录回滚、同一计数下的不同头部、更换的密钥、无效回答和缺失的响应。要确认之前的每条记录都未改变,请将导出与保留的检查点进行比较。位于另一台主机上的见证者不会与采集器主机同时宕机;独立的运营方可提供额外的独立性。验证器会检查见证者密钥与采集器密钥不同;保管方的密钥控制记录表明该密钥由谁持有。Telegram 会为公开频道中的每条帖子标注日期,`verify.py --channel https://t.me/s/…` 会将这些日期读取为外部时间。 见证人会验证采集器报告的日志状态。使用受控 投递测试来检测哪些 Telegram 操作已到达采集账户。 请参阅[见证人设置](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)。 ## 针对已知操作的测试交付 请使用受控组、独立的采集账户以及新的标记。有目的地发送、 编辑和删除消息,并在各阶段之间检查捕获情况。在检查结果之前,请明确定义 预期操作及截止条件。 R = |observed∩expected| / |expected| Δ t = treceipt - taction 仅计入与预期操作匹配的情况;重复的收据不会增加 分子。分母必须不为零。缺失的收据不计入 延迟测量。需记录时间不确定性;请使用您自己控制的删除操作时间, 因为 Telegram 无法提供确切的删除时间。 诸如 5/6 (83.3%) 之类的结果描述的是测试操作,而非所有 Telegram 流量的完整性。 ## 选择工作流程 [完整的调查流程演示](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/)将围绕一起 涉及频道、群组、机器人和私聊的事件展开: 1. 在专用采集账户中,启用“整个账户”调查模式并 清点可访问的聊天记录。可选择特定聊天记录或文件夹作为主账户。 2. 获取日志快照、按聊天分列的完整历史记录以及已保存的附件。 3. 保留实时更改以及任何有意的面板交互及其操作记录。 4. 通过引用的记录和用户资料,追踪数字发件人 ID、回复关系、重复收件人和文件 哈希值。 5. 在“案件看板”中添加与来源关联的注释和集合。重建跨聊天 时间线,其中应包含时间戳和明确的间隔。 6. 在保持各账户的来源和密钥相互独立的同时,比较其他账户的工作区。 7. 汇总并验证带签名的日志、用户资料及历史数据导出文件,并附上案件备注。 网站上的 `/docs/cases/` 指南包含交互式案件地图,并针对 机器人纠纷、已删除消息以及参与者更改名称等情况提供了多种处理方案。Case Board 将笔记和收集内容保存在工作区内。批量导出功能可收集独立的 工作区包;跨工作区关联分析及合并时间线仍由 分析师负责。 [已完成验证及剩余工作](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/) · [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#investigation-handoff) · [从一个账户开始](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) --- # Telegram · 报告配置与验证 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/ 报告过滤器、八种设计模板、内容预设、已保存的变更历史记录以及评估结果均包含在已签名的导出文件中。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 报告过滤器、八种设计模板、内容预设、已保存的变更历史记录以及评估结果均包含在已签名的导出文件中。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [调查](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/) ![调查](https://phishdestroy.io/tgwitness/assets/chapter-investigate.svg?v=48c1be9d2a52) 将选定的观察结果转化为一份通俗易懂的案件报告:包括案件问题、 范围、已保存的更改、图表、调查结果及来源参考。每份报告都为 接收方提供了核查所交付材料并检查其采集 覆盖范围的途径。 “**信任基础**”部分出现在日志、移交、聊天、账户和共享报告中。日志和移交 PDF 采用与其已签名的 `report.json` 相同的评估结果。ZIP 清单在已签名的清单中包含 `case_assessment`。该评估结果随导出材料一同传输。原始观察结果保留其现有签名。 ## 文档格式与阅读顺序 ### 报告工作室 打开**“导出”→“配置”并预览**。依次操作**“数据”→“设计与内容”→“预览”**: 1. 可使用整个工作区,或选择聊天记录、作者、包含 UTC 观察 日期及事件类型的记录。加载目录以搜索聊天记录和作者,或输入 其 Telegram ID。作者过滤器匹配记录的发件人 ID;若删除 通知中未包含发件人,则不会与作者过滤器匹配。 2. 选择页面设计,然后选择图表、参与者标签、对话记录以及 您的书面调查结果。更改设计时,这些选项将保持不变。 3. 生成预览。预览中显示实际计数、活动情况、参与者、样本 记录、已保存的更改以及缺失的消息编号范围。更改选项 会导致预览过时。请在下载 HTML、签名 PDF、 签名 JSON 或证据 ZIP 文件之前保存。 数据预览统计的是完整的稳定日志前缀,而非初始样本。 仅显示的样本行和长列表有边界限制;其省略的计数会 显示出来。后续导出将生成新的稳定快照,因此持续采集可能会 增加这些数字。范围、计数和来源标识包含在 已签名的报告中。打开或预览表单不会将其保存。 **管辖权指南。** 在文档详情下,打开**“管辖权指南 · 可选** ”以选择管辖权及民事/商业或刑事程序。附录包含 法律依据、来源链接、准备说明及研究进展。 本地语言 的摘要和数据收集保障措施说明为可选内容。默认情况下未 选择任何管辖权。这些选项属于工作区,不包含在 已保存的布局配置和隐式共享-复制默认设置中。请参阅 [默认设置、支持的报告及研究限制](https://github.com/phishdestroy/TgWitness/blob/main/docs/JURISDICTION_GUIDANCE.md) 。 **选择收件人的副本。** 图表和记录文本均基于所选记录生成。 完整性、保管和覆盖范围描述了完整的源日志。证据 ZIP 文件 包含原始记录及其附件。当收件人仅需接收选定且获准的数据时,请采用[精简移交方式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#handover-extract) 。 ### 读取编辑、删除及缺失的 ID 编辑操作会显示保存前的**“之前**”文本和“**之后**”文本,并突出显示已更改的 词语。删除操作会显示通知出现前保存的最后一个版本。如果未捕获更早的 内容,报告会明确说明。当您仅选择编辑或删除操作时, 先前版本仍作为明确标注的上下文保留在 筛选器之外。 无关的消息不会被添加到这些历史记录中。 **未观测到的消息 ID** 是选定聊天中已知编号与 基于日期推导的 ID 范围之间的缺口。在将某个 编号标记为未观测之前,会检查所有已知的源记录:过滤掉另一位作者、一种事件类型或某个日期不能 导致虚假缺口。相邻的已保存消息被标记为上下文。缺失的 编号标记着未观测的位置;删除通知和重新检查失败 将作为独立的事件类型进行报告。 ### 选择一种设计 日志和单个聊天的 HTML 报告以及签名 PDF 报告共有九种页面设计。它们使用相同的记录和计算,只在封面、字体排版、章节标题、表格和间距上有所不同。 | 设计 | 行文风格 | | --- | --- | | 经典版 | 采用深色封面、各章节编号的传统档案夹。 | | 编辑说明 | 采用带边框的衬线体标题页,宽边距和窄章节栏。 | | 简报 | 采用简洁的封面设计,书脊为海军蓝,标题简短,表格排列紧密。 | | 分析 | 采用调查问卷风格的封面、模块化图表版式及等宽字体图示。 | | 技术 | 采用带横线的登记表、编号参考栏和精确的对比表。 | | 概述 | 采用全景式封面设计,留白充裕,并突出显示摘要图表。 | | 阅读系列 | 采用分栏布局,并将“调查结果”、“范围”、“变更”和“观察日志”等章节分组呈现。 | | 账本与保证金 | 章节采用编号形式,留有宽边距,图表和表格需完全准确,并单独列出消息记录。 | | 资料概览 | 关键数据、观察到的资料,以及可搜索并链接到聊天记录的章节。 | 设计方案按工作区保存,并记录在已签名的导出清单中。 HTML 支持离线使用,支持浅色和深色主题,并可适应窄屏 及从右到左的语言。原生 PDF 使用捆绑字体;“编辑”设计 包含 Noto Serif 字体,该字体遵循其捆绑的 SIL 开放字体许可证。阅读系列以及 “账本”与“页边距”功能也适用于账户概览、账户聊天和共享副本。 中文、日文和韩文的 PDF 文件还需在服务器上安装合适的字体, 例如 Noto Sans CJK,该字体需在系统范围内部署或放置在 `TGWITNESS_FONT_DIR` 目录中。 若无法使用该字体,ZIP 文件将保留 HTML 和 JSON 格式的报告。 这两种设计均包含无需 JavaScript 即可阅读的日志。对于大型 导出文件,此视图在 8 MiB 的输入配额内最多可显示 500 条完整记录; 报告中会标注该限制,并提供完整查看器及源记录的链接。 账户目录和关系索引描述的是同一阅读样本, 而非所有参与者。完整日志图表保留其单独说明的范围。 ### 选择内容 | 目录预设 | 默认包含 | | --- | --- | | 案例档案(推荐) | 活动、观察时间、参与者、聊天记录及对话记录。 | | 简报 | 活动概览中不包含参与者排名或对话记录。 | | 活动回顾 | 活动、观察时间、参与者、聊天记录及其构成,需附来源出处和确切数据。 | | 自定义报告 | 请自行组合图表、文字记录和预览内容。 | 更改预设时,您的设计、案件详情和书面分析将得以保留。完整性检查、覆盖范围、阅读说明和验证说明在每个设计中均予以保留。隐藏图表或笔录时,ZIP 文件中的源记录保持不变。 可选的**“检查笔记**”包含报告作者撰写的提问、方法、发现结果和 结论。在发现结果中需引用源文件和记录编号。 签名将这些作者陈述与 报告一并保存;源观察结果和作者的解读仍可被识别。 简化版交接文件将省略这些私人笔记和完整的病历图表。图表和 检查选项同样适用于病历报告。 可按时间范围筛选活动,查看 UTC 工作日/小时热力图、参与者排名、聊天 排名及记录构成。可选择 5 至 30 个排名组,并使用中立的参与者 别名或账号 ID。未知发件人及其余参与者将显示在单独的 行中。别名仅影响图表显示;源记录中仍保留其真实身份信息。 设计预览基于未保存的草稿进行更新,使用正式版封面、审查和 图表组件,仅限于前 50,000 条源记录中的匹配项。下方的数据预览 计算完整的选定内容。该预览明确 未签名,且不会保留编辑内容。“封面”和“图表”按钮可切换其显示部分。 这并非完整的 PDF 预览。**“保存报告设置**”会将选项应用到 未来的导出中;现有的已签名文件不可更改。PDF 采用所选的封面、 排版、章节布局以及与 HTML 和已签名 JSON 相同的汇总数据。 信任评估、覆盖范围和验证说明始终保留。隐藏图表或可读笔录不会从 ZIP 文件中删除权威来源行。已禁用的图表系列不会写入分析 JSON;如需限制来源记录的披露,请使用最小化导出。 数据选择筛选器适用于日志报告;账户导出和共享导出保留各自的采集与披露范围。选择可以指定整个聊天、作者、UTC 日期、记录类型和单条消息。在聊天中用**选择**选中的消息会进入**已选消息**;报告随后涵盖这些消息以及整体选中的聊天的消息记录,并在**选定数据**下列出所选消息编号。缺失的消息编号及其相邻记录仅针对整体选中的聊天报告。聊天列表下方的**添加消息编号**无需打开聊天即可添加消息:每个聊天一行,写聊天 ID、冒号和消息编号,或填写指向单条消息的 `t.me/c/…` 链接。 共享的设计/图表偏好设置已固定到新的聊天/账户导出文件及账户 共享预览中。账户/共享的语言和隐私设置保持独立; 私人案件和审查笔记不会被复制到这些导出文件中。账户和 共享报告仍以 HTML 格式存在,并由其签名的归档清单提供保护。 日志、 精简版日志移交以及单聊天工具包也提供带签名的PDF文件。 ### 图表统计内容 日志活动和热力图统计新消息、历史消息、恢复消息、编辑消息、已删除消息以及 复查时缺失**的消息**,统计依据为采集器记录观察时间(UTC)。心跳 和附件回执不计入统计。 参与者排名仅统计新、历史 及恢复的消息观测:发送者不被视为编辑者或 删除者。重复的观测可能描述同一条 Telegram 消息。 日志分析保留按类型统计的计数、首/末条记录引用以及源文件 `events.jsonl` 的 SHA-256 值。HTML 和 PDF 中的数据均包含精确数值。每日数据桶 在记录超过 366 天后将切换为按月统计;图表将这些数据合并为最多 36 个 等宽区间。 当唯一标识符超过 100,000 个或累计月数达到 1,200 个月时, 相关图表将不可用,但精确的总计数仍可查阅。 快照和账户共享图表仅统计包含的非服务消息行, 并采用其记录的消息时间。共享汇总数据在脱敏 和过滤后计算得出。这些图表最多使用 90 个等宽的 UTC 日期区间,并保留 最多 10,000 个分组值;超出数量将明确声明并进行核对。 最后一个时间间隔可能较短。未知或原始日期不会进入时间图表。 空时间段表示未包含相关记录;如有缺口,请查阅覆盖范围。这些 图表描述了已保存的活动。未知发件人仍作为单独类别,且 每次检查均单独报告。 若包含 `analytics.json` 文件,该文件将受到归档文件签名哈希值的保护。 日志 `report.json` 嵌入了相同的选定聚合值。签名验证 可检测到字节变更。若要核对数据,请使用 `report_analytics.Analytics` 和 `selected` 重新计算日志聚合值,或 使用 `snapshot_analytics.collect` 和 `project` 重新计算快照聚合值。 ### 异常指标 **预览。**证据报告中新增了**异常指标**部分,该部分由 已注册的处理器计算得出(`tgwitness/metrics/`,每个指标对应一个文件)。报告会列出每个 运行过的处理器的名称及其版本,并在其表格下方显示其计算方法,因此 可通过 `events.jsonl` 结合 `tgwitness.metrics.run` 重新进行计算。 | 处理器 | 功能展示 | | --- | --- | | `first_time_posters_over_time` v1 | UTC日内的首次发帖者数量及消息数量。触发警报需满足:首次发帖者数量至少为五人,且其数量需达到中位数的3倍;消息量最多为中位数的1.5倍。基准线采用经过7天预热期后,在过去14个日历日内至少7天的观测数据。 | | `service_vs_message_ratio` v1 | 每个聊天室的已保存消息编号各不相同,且服务消息会占用部分配额。本文描述的是编号规则,并未解释特定编号缺失的原因。 | | `join_leave_per_month` v1 | 每月的新加入、离开、移除或封禁情况,按每人、每个聊天群、每次变更及每天统计一次。 | | `pinned_per_month` v1 | 按月统计:固定服务消息、取消固定通知,以及在聊天状态快照之间新增或移除的已固定消息。 | **更多工具 → 参数 → 报告指标** 可选择处理器及显示的行数, 包括在过滤后的报告中。日表和月表显示最近的行,服务份额 表按保存的消息数量对聊天进行排名。总计涵盖每一行。 从源代码检出中,用同一个虚构日志生成上面列出的全部九种设计: ``` python tools/build_report_styles.py --output test-results/report-styles ``` 打开生成的 `index.html` 文件,以对比完整的 HTML 报告、已签名的 PDF 文件和 ZIP 压缩包。每种设计均基于同一源日志。每次运行时请使用新的输出目录, 以便保留先前已签名的示例。 ![虚构的 HTML 档案](https://phishdestroy.io/tgwitness/assets/dossier-en.png?v=62db26820986) HTML 页面以案件封面和关键数据开篇。编号证据图谱链接 至每项调查结果、其支持事实、限制条件及独立审查报告。可搜索的 记录和稳定的记录引用在离线查看器中仍可访问。 该设计可适应窄屏设备,并兼容无 JavaScript 支持的主题和浏览器。 已签名的 PDF 文件包含专用的 A4 封面、报告编号和二维码、执行 摘要、证据图、编号调查结果以及文档书签。其页 首和页脚标明了报告信息。二维码用于标识材料;它并非 独立的验证结果。浏览器打印件与该 加密签名的 PDF 文件是分开的。 观察时间轴将记录的观察时段和中断 置于同一条 UTC 时间轴上。空白区域不代表推断出的覆盖范围;详细表格 保留了确切的时间间隔。ZIP 文件包含可读报告、已签名的 JSON、 源记录和验证说明。 生成一份全新的、虚构的英语/俄语/德语档案,其中已安装开发 环境: ``` python tools/build_dossier_example.py --output test-results/my-new-dossier ``` 每个语言目录包含 `report.html`、`report.pdf`、`report.json` 和 `dossier.zip`。现有示例目录绝不会被覆盖。创建过程中不使用任何 Telegram 账户、外部时间戳服务或网络连接。 ![虚构的已签名 PDF 文件的前三页](https://phishdestroy.io/tgwitness/assets/dossier-pdf.png?v=30a8d283dcc2) ## 阅读具体案例 对于一个包含 1,200 条目且第 1,000 条目具有经过验证的时间戳的日志, 报告识别出 200 条位于该时间戳边界之外的后续条目。该时间戳 确定了检查点存在的上界;每条消息都保留其来自 Telegram 的 发送时间。如果另外三个时间戳文件验证失败或无法验证, 则将其单独计数,且无法得出肯定结论。 一个可用的时间戳必须满足以下所有检查条件:其印记与 检查点匹配,其签名链在加盖时间戳时可追溯至可信的 TSA 根证书,且 检查点的签名、密钥、计数和头部与日志前缀完全一致。 仅解析时间戳或拥有 OTS 收据是不够的。阅读者 必须独立选择可信的 TSA 根证书并重复验证。OTS 需要 其自身的比特币确认检查。 | 报告状态 | 含义 | | --- | --- | | 导出时已核对 | 导出工具已执行所述检查;仍需独立重复验证。 | | 已记录;需审核 | 记录的是基础观察结果或操作员陈述;这并非独立确认。 | | 本译文未包含以下内容 | 该文本中没有支持这一说法的佐证材料。但也没有说明其他地方不存在此类材料。 | | 未经独立核查 | 该报告不提供独立的验证结果。 | | 不完整或不可用 | 某些材料或必需的核查步骤缺失、不完整或未通过。 | 请结合记录的采集覆盖范围,分别审查每一项检查。 ## 强配置必须保留的内容 1. 在依赖采集功能之前,请通过 一个独立的可信渠道保留采集器的密钥指纹。将该参考值与导出文件的签名密钥进行比对。 2. 保留带有独立时间戳的检查点,以及(如有使用)位于采集器管理控制范围之外的 见证日志。将其与 导出的日志进行比对,以核查其早期边界。 3. 记录采集范围、缺失部分、过滤条件、限制条件以及采集过程中的变更。 解释与实际申诉相关的缺失时间段,同时明确区分未被观察到的 消息 ID、删除通知和重新核查失败的情况。 4. 保留原始 ZIP 文件及其哈希值。记录每个持有者、传输情况、日期 及目的。同时保留归属的操作员陈述和案件笔记。 5. 对于机密虚拟机,需保留并独立验证引文、挑战、 Intel 证书链、测量数据、确切来源及密钥处理条件。 将证明验证结果与已审查的证据一并保存。 请参阅[验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)部分,了解各模式下对采集、 归档完整性、时间及采集覆盖范围的检查。 ## 收件人审核 请使用可信的 TgWitness 安装版本以及独立获取的指纹: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --tsa-ca tsa-root.pem python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/WITNESS_CHANNEL --require-witness python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_SHA256 --check-drand ``` 第二和第三条命令可满足证据的最低要求:经过验证的时间戳, 或 Telegram 在见证者帖子上设置的日期,可为最后一条记录提供外部时间戳。 见证人的 ZIP 文件必须来自独立可信的来源;同时应保留其密钥 和来源信息。保留命令、工具版本、输出结果、已审核的输入 哈希值以及未解决的问题。信标验证是一项独立的在线检查; 报告渲染器绝不会仅为了显示报告而联系任何服务。 针对特定消息的争议,应引用存档参考信息、权威 文件及记录参考信息,然后描述相关的时间范围、覆盖缺口、 选择标准及佐证材料。对于共享副本,还需审查记录在案的 转换过程及其与源存档的关联。私有过滤器和身份 映射不纳入公开评估范围。 对已签名的 PDF 进行验证可检测受保护字节的更改。请将原始 数字文件和验证结果与任何屏幕截图或打印的阅读副本一并保存。 --- # Telegram · 账户导出 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/ 导出该账户当前可读取的内容:范围、可恢复的任务、经签名的存档以及已缩减的共享副本。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 导出该账户当前可读取的内容:范围、可恢复的任务、经签名的存档以及已缩减的共享副本。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [证据与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) ![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) 导出账户会保留该账户的采集槽位。在归档文件被检索、下载、验证和打包期间, 实时观测仍可继续进行。 在启动另一个采集任务之前,请先暂停其他历史数据或导出任务。 暂停归档任务时,观测仍会继续运行;而暂停观测时,归档任务将保持运行状态。 不同账户的导出任务可以同时运行。仅限导出的任务在等待 审批期间会释放其账户,因此,在审批待定期间,另一个常规会话导出任务可以 开始运行。而正在进行的采集任务仍会保留该账户。 作为安装管理员,请选择**主页→导出我的账户**,或**导出→Telegram 账户→配置账户导出**。 如有需要请登录,审查权限范围,并明确启动导出。无需持续进行观测。**“已保存的观测**结果”是对现有日志的单独导出;其 ZIP 文件包含所有源数据,不受日志过滤器限制。每个工作区都有独立的任务、签名身份和存储空间。已授予的控制面板访问权限(包括无限制的普通导出权限)无法访问这些全账户范围的路径。 **“按发件人或消息文本过滤**”下可展开发件人和文本过滤器。**“账户数据与连接方式**”包含可选的账户分类以及“Takeout”与“常规会话”选项;其摘要会显示当前选中的选项,即使关闭后依然可见。关闭这些部分后,其设置将得以保留。在切换视图时,导出和报告草稿仍保留在当前面板会话中;重载浏览器后,这些草稿不会被保存。无论选择哪种导出方式,均可访问现有任务。 此工作流将导出当前已连接账户可访问的数据。默认的**“自动**”方法首先运行 [Telegram Takeout](https://core.telegram.org/api/takeout),该操作会返回当前状态下可访问的历史记录,包括已退出的频道、已保存的联系人及其他账户数据。如果 Telegram 在 Takeout 开始前设置了等待期,“自动”模式会立即转入常规会话;日志会记录 `account_export.transport` ,而签名清单会标明所用方法,并将该变更列为遗漏项。**Telegram Takeout会话仅**等待批准,而**“常规会话**”则永远不会请求Takeout。秘密聊天由“[秘密聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)”[模块](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)实时记录,编辑操作则通过实时观察记录。常规会话的覆盖范围不同,并会记录不受支持的类别。 **主页 → 导出全部**将启动导出操作,涵盖所有聊天类型、所有附件类型、个人资料、联系人、头像、动态、会话元数据及其他账户数据,并以所有格式导出:带签名的 TgWitness 归档文件,以及 Telegram Desktop 的 JSON 和 HTML 视图。**选择选择要导出的内容**将打开下方表单,其中默认设置与上述相同。 Takeout 是 Telegram Desktop 也使用的官方导出 API。TgWitness 可以 直接从其自身的采集数据中写入与 Desktop 兼容的 JSON;无需导入他人的 存档。两种传输方式均可获取聊天和消息 ID。 导出速度和 Takeout 的审批延迟取决于 Telegram 对该账户的限制, 以及聊天是否为公开或可转发。在比较速度之前,请先测量相同范围和媒体设置下的情况。 对于最多20个明确选定的聊天ID,常规API导出会在考虑该账户完整的对话列表之前 直接解析这些对等方。因此,即使该公共频道未出现在对话列表中, 也可以在无需加入该频道的情况下将其导出。 未缓存的对等方将回退到普通对话列表。 归档过滤器仍会生效:如果 Telegram 未返回某个对话,且已归档 的聊天被排除在外,则未知归档状态将被记录为遗漏。 Takeout 保留其分段范围对话列表处理流程。两种路径均不会加入聊天或 更改转发权限。 在与桌面版兼容的 JSON 中,Telegram 标记为 `left` 的频道将显示在 `left_chats` 下,包括该账户尚未加入的可读公共频道。 `FLOOD_WAIT`和`FLOOD_PREMIUM_WAIT`都会在服务器要求的整个 时段内暂停请求。该账户的截止时间在重新连接和重启后仍会保留;后续设置的 较短等待时间无法缩短该截止时间。重试次数受限,取消操作会保留已密封的页面, 且 API 凭据不会轮换以绕过速率限制。不会进行任何 Premium 购买。 ## 选择要收集的内容 | 设置 | 含义 | | --- | --- | | 目的 | 请记录此次收购的必要性。请勿在此处填写不必要的姓名或敏感的案件细节。 | | 报告语言 | 选择可读报告中标签的语言。原始消息文本保持不变;未翻译的模板标签使用英语。该语言通过已签名的任务选项固定。 | | 聊天类型 / 聊天 ID | 可选择所有类型,或仅选择列出的聊天;“已保存的消息”属于私人聊天。已归档的聊天可单独选择。 | | 日期 | UTC。面板中的“起始”和“截止”日历日期均包含在内。该 API 使用包含起始日期的 `from_utc` 和排他 `to_utc`;面板会发送“截止”日期之后的第一天。若边界为空,则该侧不受限制。 | | 发送者 ID | 仅显示所列发件人的消息;若列表为空,则包含所有发件人的消息。 | | 文本包含 | 不区分大小写的字面短语,通过“OR”进行匹配。发件人/日期/自有消息条件则通过“AND”进行组合。 | | 自己的消息 | 仅保留发送的消息。 | | 媒体类型 | 选择附件类别,或清除所有选项以避免下载消息文件。 | | 文件/媒体总量限制 | 按文件计算的 MiB 以及已下载媒体的总容量(GiB)。文本、收据、可读报告以及 ZIP 占用的空间需要额外的磁盘空间。 | | 账户分类 | 个人资料、联系人、头像、动态、会话元数据及其他 Takeout 数据均设有独立的控制选项。 | **“最小化”集合**预设会禁用文件和账户元数据。发送者/内容过滤器会在保留的消息页面和媒体下载之前生效。Telegram 仍会传输包含评估这些过滤器所需消息的 API 历史记录页面:过滤并不保证未选中的消息绝不会进入进程内存。工作区中的其他持续监控项目拥有各自的范围和保留设置。 个人资料照片历史记录、故事、会话元数据及其他账户数据默认被选中。若案件仅需消息内容,请禁用这些选项,并排除个人资料和联系人。若附件或元数据非必需,在采集过程中将其排除可避免在本次导出中保留另一份私有副本。 照片有效载荷采用其元数据和哈希清单中标识的静态图像变体,包括带有动画头像变体的照片。该动画不会替代所选的静态图像。比观察到的大小更短或更长的有效载荷将被记录为附件失败,而在文件引用更新期间发生表示形式变更的情况将被拒绝。这些失败会导致存档不完整,但会保留消息记录。 独立验证还会拒绝那些签名长度与其实际大小或表示形式不符的已保存附件,包括旧存档中的附件。 如果专用媒体连接暂时出现故障,附件读取操作将使用 标准文件连接。一分钟后,系统将在后台重试专用连接, 同时下载操作将继续进行。此恢复机制会保留已配置的 连接限制,并针对每个数据中心分别应用。Telegram 洪水 等待和授权失败仍会传播。 ## 消息编号和活动地图 每个账户存档包含 `message-gaps.json` 以及 `map.html`。频道和超级群组按聊天对消息进行编号,因此从第一条导出消息到最后一条导出消息之间缺失的每个编号,都代表该聊天中的一条消息。 私聊、机器人和基础群组在整个账户中共享一个编号序列:该处缺失的编号原本属于某个聊天。当导出的回复或置顶消息指向该编号时,即可确定其所属聊天;否则,将根据相邻消息之间活跃的聊天进行推算,剩余部分则归因于未包含在导出中的聊天。 每次运行都会包含其时间窗口、相邻消息、每个聊天群组的数据份额以及一个置信度标签。会明确限定分析范围(过滤器、未选中的聊天群组),因为若不限定范围,缺失的编号将包含选定范围之外的消息。 `map.html` 显示日历、随时间变化的聊天记录,以及按工作日和小时划分的消息和缺失号码网格,并附有每个聊天记录的表格及最长连续记录。聊天页面显示其专属日历、群组中随时间变化的参与者列表,并在聊天记录中用标记标注消息缺失的位置。 `verify.py` 重新计算 `message-gaps.json` 基于已签名的页面,并拒绝已更改的文件。 活动地图列出了最大的频道和超级群组缺口,包括其 号码范围及相邻消息的时间。打开某个范围即可跳转至分页记录中 标记的位置。这些标记记录了已保存的相邻号码之间 缺失的号码;删除事件、其时间及消息内容仅来自 已保存的记录。在小屏幕上,宽表可在其卡片内滚动。 长记录包含一个页面索引,其中列出了消息日期范围和日历。 选择一个月份,即可按捕获页面的顺序打开该月份的第一条记录。月份计数基于 记录的消息日期(UTC);未标注日期的记录仍保留在记录中。页面 导航包括首页、末页和相邻页面,并可直接打开消息 部分。该索引无需 JavaScript 即可在离线状态下使用。 ## 简历、报道范围与验证 每个任务都会锁定其选项和账户身份。清单和捕获的页面均经过签名;页面收据记录了哈希值、光标位置、时间、附件结果及其前一个收据。只有已提交的页面才会推进进度。重启/恢复操作会在继续之前检查这些记录。若账户发生变更、已签名页面发生变更或收据链不一致,则会被拒绝。在捕获过程中无法编辑选项:如需处理其他范围的内容,请启动另一个任务。 “暂停”会中止正在运行的账户操作。重新启动应用程序后,未完成的工作仍可被显式恢复。过期的 Takeout 会话需要显式恢复;更改 Telegram 分段范围可能需要重新进行数据采集。恢复操作会保留之前的观察结果,因此长时间运行的导出并非单个原子快照。在数据采集期间,其他账户切换操作和冲突的导出操作将被阻止。请等待打包完成后再删除工作区。 “恢复”选项会立即显示**正在验证已保存的导出数据……,**并在联系 Telegram 之前在后台检查已保存的内容。验证期间,该面板仍可正常使用。“暂停”选项会等待验证进程安全完成后再释放账户;即使在启动或恢复后立即点击该选项,它也能正常工作。在存储速度较慢的情况下,等待时间可能会较长。如果完整性检查失败,系统会生成一个带有说明的失败任务,并保留其文件。 如果 Telegram 在进行库存、历史记录或附件获取过程中终止了该账户的授权,任务将暂停,且不会将未完成的页面标记为已完成。请重新连接同一账户并恢复任务,以从上次保存的页面继续。不可用的消息占位符会推进历史记录光标,但不会结束阅读:系统仍会请求较早的可用消息,且占位符不会被视为已捕获的消息或已确认删除的消息。 The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed. 已完成的 ZIP 文件仍可供重复下载和 HTTP 范围下载。一个账户归档包含 `manifest.json`、`manifest.sig`、已签名的 `job.json`、`inventory.json`、`receipts/`、权威 `data/*.jsonl`、选定的 `media/`、可读 HTML 以及一个验证器。通过独立渠道固定收集器的指纹,然后使用可信安装进行验证。 控制面板将归档文件保存为 `tgwitness-account-export-EXPORT_ID.zip`;密封捕获则将其作为 `account-export.zip` 包含在其证据归档中。请使用您手头的文件名: ``` python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256 ``` 对于展开后内容超过 4 GiB 的存档,请显式设置适当的 `--max-gib`。该面板通过声明的展开大小和已发布的ZIP摘要来验证其经过认证且完整的本地存档;外部命令行界面(CLI)则保持其独立的大小限制。在打开可读的 HTML 文件之前请先进行验证。虽然存档中捆绑的验证器很方便,但使用独立获取的验证器可以避免信任随证据一起提供的可执行代码。 Ed25519 签名和 SHA-256 哈希值用于检测收集器提交相关字节后的变更。请结合记录的收集范围、采集间隔、外部时间戳收据以及所选部署可用的来源验证结果,共同审查该结果。后续观察结果将单独记录,并保留先前捕获的版本。 ## 为律师或其他收件人准备一份披露文件 下载完成的导出文件后,请保留原始的 ZIP,并从 `index.html` 解压后的副本。该报告说明了其范围、可用覆盖范围和 限制。其记录引用结合了存档引用、文档路径和 记录编号,因此收件人可以在 HTML 或打印件中找到相同的条目。 有关实际示例,请参见 [打开虚构报告](https://phishdestroy.github.io/TgWitness/demo/report/)。 在完成的账户导出中,选择**“准备共享副本**”。这将生成一个独立的、经过签名的衍生副本。源文件 ZIP 保持不变且为私有;除非收件人被授权接收其完整内容,否则请勿将其与经过简化的衍生副本一同发送。请单独选择其报告语言。更改语言或任何选择设置后,在创建前需要再次预览。 1. 输入披露目的,并选择日期、发送者 ID 以及文本内容条件。 2. 您可以选择保留真实身份、仅显示列出的参与者,或对所有人进行化名处理。在任何化名模式下,聊天 ID/标题和消息 ID 也会被替换。化名在同一份披露文件内保持不变,但在独立准备的披露文件之间会发生变化。 3. 可保留消息正文、完全省略,或添加具体名称/短语进行屏蔽。在私密模式下,该工具还会屏蔽已知的隐藏发件人名称和别名、完整令牌形式的发件人 ID、私聊昵称、链接、电子邮箱地址以及类似电话号码的字符串。已知名称匹配功能支持 Unicode 大小写转换,包括 `Straße`/`STRASSE`。通用群组/频道名称不会自动从消息文本中移除。若已知身份屏蔽限制被超过,请缩小源导出范围或省略文本;该工具不会默认跳过后续的名称。这些规则仅为尽力而为,并非普遍的匿名化处理。 4. 除非收件人需要,否则请勿包含文件。包含的原始文件将保留其像素、音频、文本和元数据。该工具**不会**对这些文件进行匿名化处理。 5. 预览计数、警告和转换后的消息示例,然后明确确认创建。示例限制为每条消息 12 条,每条文本长度不超过 2,000 个字符。这仅为示例,并非对结果的完整审查。更改设置需要再次预览。预览在 15 分钟后失效,且与该管理员会话及原始的 ZIP 严格绑定;创建后无法重复使用。新的预览将使同一任务和会话中的先前预览失效。 6. 查看生成的完整 `index.html` 并 `messages.jsonl` 在本地进行检查。若发现其中包含不必要的信息,请创建一份新的披露文件并设置更严格的排除条款。请勿直接编辑已签名的ZIP。 ### 筛选后未包含的消息 **预览。**当披露内容不完整时,其显示效果也会不完整。在每个包含至少一条已披露消息的聊天中,选定范围未包含的消息会以标记形式显示, `[withheld by selection — rule: sender]` (或 `text`, `period`)。选择**“被选定范围排除的消息”**:每组连续被排除的消息显示一个标记(默认),或每条消息显示一个标记。标记仅包含规则和计数,绝不包含文本、发件人、日期或文件。未披露任何内容的聊天将被完全排除,因此该软件包不会透露其存在。 已披露的回复会说明其回复对象:是本副本中包含的消息、被筛选排除的消息,还是源导出中不存在的消息(在导出前已被删除或从未被导出;导出数据无法区分这两种情况)。 被披露回复所回应的被屏蔽消息始终带有独立标记,因此该回复会指向一条解释其为何为空的记录。这三种状态有别于删除和数据缺失,后者属于源导出数据本身。 在 `messages.jsonl` (格式 `tgwitness-account-disclosure-v2`)中,每条消息包含 `state`: `disclosed`,或 `withheld` 带有 `rules` 和 `count`。已披露的回复包含 `reply_to` 与目标 `id` 和 `state` (`disclosed`, `withheld`, `not_in_source`)。清单统计了已公开的消息、聊天、媒体和 `withheld` 消息。 `verify.py` 会拒绝携带内容的标记,以及指向包中缺失记录的回复;版本 1 的包仍按原有方式进行验证。 精简格式省略了结构化的账户资料、联系人、头像、会话、故事、原始 Telegram 对象、转发头信息、回复引用、联系人卡片和位置元数据。它不包含原始 JSONL 文件、私有过滤器设置、化名密钥和身份映射。选中的文本、明确保留的身份信息以及包含的文件仍可能包含与这些过滤器中相同的名称、ID 或短语;这些内容需要单独审查。 隐私策略和化名密钥以加密形式保存在该任务的本地保险库中;删除任务将清除其关联的隐私披露记录。公共策略记录的是过滤器计数而非过滤器值。声明的目的在清单和 HTML 中是公开的:明确的隐私标准以及在化名模式下已知的隐藏身份也会被遮蔽,包括在省略消息文本的情况下。请确保目的陈述中不包含不必要的个人细节;未知的身份识别上下文可以保留。 其清单包含派生文件、公开政策以及原始 ZIP 文件的哈希值。通过验证可以确认文件的完整性;如果本地提供了源文件,还可以验证源文件的关联性。该面板将共享副本保存为 `tgwitness-disclosure-DISCLOSURE_ID.zip`: ``` python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip ``` 来源链接表明披露内容来自哪个存档和哪个采集器密钥。披露仅包含所选内容;请对照原始导出检查所选范围以及可识别细节的移除情况。 ## 共享与托管捕获 选择收件人所需的消息和文件,审查完整的共享副本,并将源文件单独保留。记录已发送 ZIP 文件的哈希值,以便收件人能够识别并验证该确切副本。通过假名化处理替换所选标识符;包含的文本和原始文件仍作为审查内容的一部分。 GitHub Actions 支持通过 Takeout 或常规 API 导出整个账户或选定聊天记录,还支持单个聊天的事件日志。[托管捕获指南](https://phishdestroy.io/tgwitness/docs/capture/)详细说明了设置验证及 120 分钟的时限。要验证从托管捕获生成的共享副本,请将该副本的源哈希值与原始存档进行比对,并使用[特定模式的检查](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)方法验证该存档的认证信息。 [证据格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) · [案例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/) --- # Telegram · 证据格式 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/ 签名 ZIP 文件的内容、记录类型、操作收据、用户资料、异地副本及离线验证。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) Translation coverage: this edition includes material from the English original. 签名 ZIP 文件的内容、记录类型、操作收据、用户资料、异地副本及离线验证。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) ![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness 将账户可见的 Telegram 观察结果保存在一个已签名的日志中。 接收方可使用可信的 收集器密钥验证已保存的记录、附件和报告,通过第三方核对最后一条记录的外部时间,并对比 日志与他们先前保留的检查点。 本页面描述了格式、校验方法以及移交时需保留的材料。 Windows 用户可通过 **VERIFY.cmd** 开始操作:该程序会要求提供原始 ZIP 文件和独立获取的密钥指纹,显示附有说明的结果, 并保存一份独立的验证记录。有关设置和信任限制,请参阅[验证启动程序和 便携式运行时](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md)。 **本页内容** - [什么是签名](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#what-is-signed) - [比较聊天记录导出文件](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#comparing-chat-exports) - [调查移交](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#investigation-handoff) - [交接摘要](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#handover-extract) - [易于阅读的报告](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#readable-reports) - [事件规范化](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#event-canonicalization) - [参与者语义](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#actor-semantics) - [涵盖范围:连续性、缺口及未观测到的 ID](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids) - [制作方](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#producer) - [用户资料](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#people-profiles) - [独立见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#independent-witness) - [清单和检查点](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#manifest-and-checkpoints) - [验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope) - [附件](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#attachments) - [持久的收据收集与处理(0.2)](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#durable-collection-and-process-receipts-02) - [RFC 3161 准备工作与响应验证(0.2)](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02) - [证据模式下的可选记录:drand 和 Telegram 设备](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices) ## 什么是签名 | 资料 | 保护 | 应保留的内容 | | --- | --- | --- | | 日志中的每一项记录,包括操作事件 | 每个事件均包含 SHA-256 链和一个 Ed25519 签名 | 原始 `events.jsonl`(可信密钥指纹)及保留的检查点 | | 证据 ZIP 文件内容 | `manifest.sig` 对规范清单进行签名,该清单列出了内容文件的哈希值 | 完整的 ZIP 压缩包,包含其清单和签名 | | 保留的附件 | 带签名的`media.saved`事件中包含SHA-256和字节计数;带签名的ZIP清单中包含文件哈希值 | 经过验证的 ZIP 文件中的原始字节 | | 检查点 | 对日志长度、头部哈希值、公钥及创建时间进行 Ed25519 签名 | 在发生争议性更改前保留的独立副本 | | 运行收据 | 包含采集器版本、源文件哈希值和启动设置的签名记录,该记录也包含在`process.started`中 | 所选验证模式对应的收据、相关日志及环境证据 | | 可读报告:`report.html`及其组成部分,`report.json`、`report.pdf`、`chat.pdf` | 每个文件均带有针对其内容的 Ed25519 密封;PDF 还包含一个标准的 PDF 签名(参见 [可读报告](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#readable-reports)) | 收到的文件及其可信密钥指纹;该文件所描述的 ZIP 压缩包 | | 独立版 CSV | 不包含独立的加密签名;仅凭事件哈希值是不够的 | 请使用经过验证的 ZIP 文件中的原文件进行完整性校验 | | 由浏览器生成的屏幕截图、打印件或 PDF 文件 | 衍生作品上不包含 TgWitness 的签名 | 保留原始的经过验证的软件包,并记录衍生版本的制作过程 | 采集器在生成每种导出格式之前,都会验证日志签名。 可读的 HTML 和 PDF 报告带有各自的印章;独立的 CSV 文件作为 已签名 ZIP 文件的一部分进行验证。保留 ZIP 文件以保留附件字节和清单, 并设置单独的检查点,用于将日志与较早的边界进行比对。 ## 格式与验证路径 采集模式和输出格式旨在解答不同的问题。该模式 提供采集和环境证据;每种格式均通过以下检查机制保留或呈现 该记录的一部分。 | 输出 | 验证与使用 | | --- | --- | | 证据 ZIP | 规范事件、签名清单、覆盖范围、保管条目、附件及可用的外部收据;检查归档及其选定的获取模式。 | | ASiC-E 容器 | 作为ETSI ASiC-E容器(EN 319 162-1)的证据ZIP文件,其中包含`mimetype`条目和`META-INF/ASiCManifest.xml`文件,并使用工作区自身的证书以B-B级别进行CAdES签名;若启用了时间戳功能,则以B-T级别进行签名。 EU DSS 等验证工具会检查格式和完整性,并且由于证书是自签发的,因此会报告“无信任锚点”。默认设置下的 EU DSS 6.3 会拒绝包含超过 1000 个文件的容器(“检测到文件过多”)。 `verify.py`会检查Ed25519清单及所有列出的文件,以及`META-INF/ASiCManifest.xml`中、新增的`ASiCManifestNNN.xml`或`ASiCEvidenceRecordManifest.xml`中的SHA-256值,若存在上述文件均未涵盖的`META-INF/`条目,则验证失败。该工具不检查CAdES签名,并会明确提示此情况。 | | HTML 和 JSON 报告 | 这些视图均单独封装,附有来源引用,并在 ZIP 清单中列出。其记录的计数汇总了日志事件的种类。 | | PDF 报告 | Ed25519 密封,外加一个覆盖字节范围 B-B 的 PAdES 基线 PDF 签名;若启用了时间戳功能,则为 B-T 范围,并附带签名时间戳。TgWitness 验证器使用受信任的 Ed25519 密钥;查看器中证书信任状态的显示则属于另一项独立检查。 | | CSV | 电子表格视图受 ZIP 清单保护。公式转义机制保障电子表格的使用安全;原始签名文本仍保留在日志中。 | | JSONL | 带签名的事件记录,包括附件引用。证据 ZIP 文件还包含已保留的附件字节。 | | 聊天记录导出和与桌面端兼容的视图 | 历史数据采集及可用的管理日志记录,包含所需的呈现形式和签名存档。实时监控的保存版本属于另一条采集路径。 | | 媒体和仅含哈希值的记录 | 将保存的字节与相应的 SHA-256 哈希值及消息引用进行比对。仅采集哈希值的方式会保留可用的哈希元数据,以便日后与文件字节进行比对。 | | STIX/MISP 及人员档案 | 与来源关联的提取观察结果、账户 ID 和分析匹配结果。特征签名和记录哈希值可与原始证据进行核对;头像缓存的来源信息单独标注。 | | 交接摘要 | 签名披露规则、未更改记录以及标记为最小化的记录均保留原始哈希值/签名。若需进行涉及被隐藏字段的比较,请使用保留的原始数据。 | | 见证人和时间收据 | 早期的日志边界、连续性以及各个经过验证的时间声明。这些内容与采集和归档检查相关联。 | | 密码保护的交付 | 在传输过程中保护所包含的包。`.tgwpw`使用AES-GCM认证加密,包括一条经过认证的最终记录;所包含的日志保留其签名和获取收据。 | 打印件或屏幕截图是已签名材料的呈现形式。其报告 ID、密钥指纹和二维码引用可帮助定位原始文件以供验证。 保管声明记录了提供的检查员和传输信息; 验证结果和获取收据作为单独证据予以保留。 ### 外部签名 签名也可以来自 TgWitness 从未持有的密钥,例如调查人员的 合格电子签名或组织的印章。在**导出功能**中,对未设置密码的已准备好导出文件进行**外部 签名**时,会提供待签名的字节数据:一个新的 `META-INF/ASiCManifestNNN.xml` 列表,其中列出了ASiC-E 容器中每个文件及其SHA-256值,或是该导出文件的 `manifest.json` 。签名者返回一个 CMS(CAdES) `.p7s`,该签名可以是独立的,也可以包含嵌入的内容。 TgWitness 会检查签名是否精确覆盖了这些字节,并使用 签名者的证书(RSA PKCS#1 v1.5、RSASSA-PSS、ECDSA、Ed25519、Ed448)进行验证。 该证书链 仅根据操作员提供的根证书进行验证;不检查证书吊销状态、受信任 列表及合格状态。面板为每个签名显示一种状态: 等待签名、已附加但未验证、已验证、算法不支持、 签名无效、已签名字节不匹配,或证书未与提供的 根证书建立链。在字节分发后更改 导出对象,将导致其所有签名状态变为“已签名字节不匹配”。 **带签名的下载**会将签名及其清单添加到 `META-INF` ASiC-E 容器中。对于 ZIP 文件,它会放入未更改的 ZIP 文件、 `.p7s` 文件以及 `SIGNATURES.txt` 放入外层 ZIP 中。无效的签名以及覆盖其他字节的 签名将被排除。包含一个 TgWitness 算法无法验证的签名; 面板会显示其状态, `SIGNATURES.txt` ZIP文件的情况一样。 ### 带签名的聊天图片 在图片预览中**下载带签名的 ZIP 文件**可保存 PNG 页面, `pages.sig.json` 并且 `README.txt`。每页末尾包含其显示的日志记录编号、聊天内容、 渲染时间、工作区密钥指纹以及用于验证的命令。该面板 仅发送每页的 SHA-256 值和记录编号;服务器确认这些记录 属于该聊天,对声明进行签名(`tgwitness-image-attestation-v1`)并将其记录在日志中,作为 `export.image_attested`. ``` python verify.py page-01.png page-02.png pages.sig.json python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip ``` 验证器会检查签名,将每个PNG与已签名的页面进行匹配,并报告 密钥指纹。 `--fingerprint` 将签名者与从 发件人处独立获取的指纹进行比对。 `--evidence` 读取同一工作区的已签名证据ZIP文件,并 要求所有图像记录均存在且哈希值一致。若存在像素变更、 声明变更或密钥不符,则验证失败。这些图像展示的是以 TgWitness自有布局保存的记录;它们并不显示Telegram向任何人展示的内容。 ## 比较聊天记录导出文件 使用独立保存的签名者 指纹,验证并比较两个已签名的聊天记录导出 ZIP 文件: ``` python -m tgwitness.verify first.zip --compare second.zip \ --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256 ``` `--require` 和 `--require-tier` 不能与 `--compare` 同时使用;请通过各自的验证机制检查 每个存档所需的配置文件。 当两个存档均记录了相同的数字账号和聊天 ID 时,记录将通过消息 ID 进行配对。 **未更改**指完整的保存 JSON 记录完全一致: 包括全文、作者、日期、回复对象、嵌套元数据和未知字段。 JSON 对象键的顺序无关紧要;缺失字段、空值、值类型 以及数组顺序则会影响匹配结果。300 字符的预览仅用于显示。 已更改的条目 会将差异列为顶级字段`changed_fields`,包括预览中不可见的更改。 匹配过程中,重复的消息 ID 会被拒绝,而非相互覆盖。 差异可能表现为显示名称、浏览量、集合注释或 其他观察结果元数据的变更。Telegram 的编辑操作会以独立的编辑事件形式出现,且每个 存档的验证结果会显示该存档是否完整。未解析的记录仍保留 在比较中,并根据其保存的表示形式进行比较。 对于不同或缺失的账户/聊天标识,该工具会利用发送者、完整文本、文件哈希、媒体类型以及五秒 的时间容差来查找候选 对应项,并将它们报告为**已匹配**而非**未更改**。 未解析的 记录仍保持未匹配状态。配对记录中的差异会列在`changed`中, 包括内容模式下的差异。使用`--json`选项时,`matched`统计候选配对对数, `unchanged`则统计完整保存记录完全相等的配对对数。现有的 `changed_fields`和整数型`unchanged`输出仍与 之前的比较结果保持兼容。归档格式和签名验证保持不变。 ## 调查移交 1. 请在案件笔记中记录案件编号、操作员、Telegram 账户数字 ID、选定的 来源、采集政策及采集时间段。TgWitness 会保留观察记录,并在 [“案件看板](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)”中支持与来源关联的笔记和采集内容。请将移交和保管记录与案件 材料一并保存。 通过 [实时验收程序](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md)核对预期的采集设置。 2. 在依赖 工作区导出的内容之前,请先独立保存该工作区的公钥指纹。保持证据模式开启(默认状态),以便检查点能够接收符合 RFC 3161 和 OpenTimestamps 标准的收据。在收集过程中,将已签名的检查点保存到收集器之外。 记录中断情况以及该账户可见性的限制。 3. 导出**带签名的 ZIP** 文件并保留带签名的运行收据。请在 导出日志边界处或之前设置检查点。较晚的检查点会正确地拒绝 较早的导出,因为其长度不足。导出内容包含完整的工作区日志, 不受面板过滤器影响;请在分享前仔细审查相关材料。 4. 请收件人使用可信的验证器副本、 独立提供的指纹以及单独获取的时间戳权威机构的根 证书来验证 ZIP 文件。从具有有效 Python 环境的可信代码库中: ``` python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence ``` 指纹和最后一条记录的已验证时间戳满足证据的最低要求; 否则,`--require evidence`将以代码2退出。检查点是一项 辅助验证,因为它使用收集器密钥进行了签名。当两个输入均 已提供且被接受时,成功输出将报告`key_pinned: true`和`checkpoint_checked: true`。请保留验证结果。 ``` For a handover requiring the final exported record to be witnessed, use `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`. This refuses an export with an unwitnessed tail. Add `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the witness posts as external time. See the [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary). ``` 1. 在保管记录中记录归档文件的 SHA-256 值、导出边界、传输日期、发送方和 接收方。保持原始包的完整性,并仅 使用副本进行操作。分享证据文件而非应用程序的私有数据 目录,该目录还包含账户会话和签名密钥。 传输时,请选择受密码保护的 AES-256 ZIP 文件或更安全的 `.tgwpw` 容器。 ZIP 采用 WinZip 的低成本密码派生算法;请使用较长的随机 密码短语。`.tgwpw` 采用 scrypt 和 AES-256-GCM 算法,可通过独立 验证器的 `unseal-password` 命令打开。密码不会被存储,仅用于保护 机密性;收件人解密 归档文件后,将验证其中未被篡改的已签名导出文件。 2. 要在非证据模式下为检查点添加时间戳,请遵循 [RFC 3161 中的 流程](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/),并保留请求、检查点、受信任的 CA 信息以及经过验证的权威机构响应。仅准备请求 并不能获得时间戳。 对于 `.tgwpw`,请使用独立获取的验证器,并选择一个 保留原始扩展名的新输出文件:`python verify.py unseal-password export.tgwpw --out evidence.zip`。 该命令会提示输入密码;`--password-stdin` 会读取一行内容以实现自动化。 它绝不会覆盖现有文件,且仅在所有记录 通过认证后才发布明文。随后对解密后的文件执行常规签名验证。 该容器使用 scrypt(`N=131072`、`r=8`、`p=1`、16 字节盐;约 128 MiB 内存) 以及 AES-256-GCM 算法,包含 1 MiB 的记录和一条经过身份验证的最终记录。一个加密的 元数据记录存储了内部文件名,因此下载后的容器可以重命名。 验证成功即表明相对于可信采集器 密钥和保留边界,数据完整性得到保障。请参阅[验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope),了解 信任假设以及所执行检查的[验证结果](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)。 ## 交接摘要 一个已签名的 ZIP 文件包含整个工作区日志。当法院、律师或滥用举报部门仅需 部分聊天记录、特定时间段或特定人员时,**可通过“导出 → 移交提取”功能**,根据所选披露规则生成一份精简 副本(`tgwitness-handover-v1`)。 操作员需说明目的并选择聊天记录、可选时间段(UTC)、 提取涉及的对象,以及其他人员的处理方式(显示、替换为化名 P01、 P02…或被 省略),哪些消息正文保留,哪些附件和个人头像被包含,以及 文本中的电话号码和电子邮件地址是否被屏蔽。 该目的及这些规则将记录在 已签名的清单和报告中;日志将记录`handover.exported`条目,其中包含 生成该文件的访问者信息以及文件的SHA-256值,而非文件内容。 `verify.py`通过两种方式对提取数据进行验证。对于显示为未更改的记录,将进行全面验证:将其 内容与哈希值、Ed25519签名以及与所包含的前身记录的链接进行比对。 一则 简化记录会保留原始哈希值和签名,因此签名仍可验证,但 无法据此重新计算被隐藏的字段;该记录会注明被隐藏的内容,报告 也会对此进行标记。 全账户范围的服务记录(启动和停止、覆盖缺口、连接、网络和存储通知、 范围和设置变更)仅保留其类型所列的字段:其中的聊天列表会被截断为所选的 聊天及其总数将重新统计;若选定范围外的某次聊天中存在实时探针缺口,则该聊天、其消息 编号及见证账户将被省略;在选定的探针聊天中,除非 显示所有参与者或该账户属于选定人员之一,否则见证账户将被其化名替代。 清单中列出了日志的长度和头部,并在该 头部上附有收集者的签名,同时统计了被排除的记录;`coverage.json`描述了选定的聊天。新的提取文件还 包含`proofs.jsonl`:对于每个包含的记录以及日志头部,都提供了从 记录的原始哈希值到签名清单中指定的日志根节点的默克尔路径。 `verify.py`会检查每个 路径,从而验证每条记录均属于长度与日志头相同的日志,而无需 完整的日志;无论日志大小如何,100条消息的提取文件约需一秒即可完成验证。 `--range=CHAT:FROM-TO` 选项还会额外确认该聊天中从 FROM 到 TO 的消息是否包含在提取文件中, 并报告为此检查了多少条记录。文件名中的 名称不会被检测到。分享前请仔细检查最终文件:自由文本、文件名和选定的 附件仍可能泄露个人身份。请保留完整的签名 ZIP 文件:提取文件仅用于披露信息,不能替代原始文件。 ## 通俗易懂的报告 已签名的证据、移交文件和聊天记录 ZIP 包包含可读的 HTML 和 JSON 报告,此外, 当所需字体可用时,还会包含所选报告语言的 PDF 文件。每份 报告均使用工作区的 Ed25519 密钥进行封装,并可单独验证: `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`。 - `report.html` / `chat.html`:封装语句(`tgwitness-report-seal-v1`)会关闭文件,并 对之前的每个字节的 SHA-256 进行签名。较长的日志和聊天记录会被拆分为 可配置大小的部分(报告设置,500 至 100,000 条记录;默认值为 5,000): `records/records-0001.html` 或 `messages/messages-0001.html`,每个文件均带有其编号、范围 和总数,并与其 SHA-256 一起列在已签名的清单中。收集器心跳记录的连续序列 将显示为一行,除非“报告设置”中指定逐行显示。 - `report.json`(`tgwitness-report-json-v1`,密钥 `format`、`report`、`seal`):该密封对 `report` 的规范 JSON 中的 SHA-256 进行签名,因此案件系统和脚本可以读取相关事实, 并可在保持签名文件完整性的前提下,从中进行数据保护方面的筛选。 - `report.pdf` / `chat.pdf`:一份用于打印和归档的正式文件,在同一组 字节上签名两次,整个文件(除签名值外)(`/ByteRange`)。标准PDF签名 采用PAdES基准规范(ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`:采用 SHA-256 和 ECDSA P-256 的 CMS,签名证书 v2,无 CMS 签名时间;声明的时间为 `/M`) 处于 B-B 级别,或 B-T 级别——当时间戳功能开启且 时间戳授权机构通过路由响应 Telegram 外部请求时,CMS 中包含 RFC 3161 签名时间戳。它使用 保存在工作区保险库中的自签发文档签名证书;其主体序列 号即为 Ed25519 密钥指纹。 Ed25519 印章作为 未签名属性 `2.25.240684792623320047764573196045913242332` 在CMS中传输,并以 “SHA-256”标识该证书的SHA-256值, 因此Ed25519密钥为该 `"content": "pdf-byte-range"`,因此 Ed25519 密钥为该 证书提供担保。该证书未获认证:在 PDF 阅读器中,该签名将显示为有效,但 签名者显示为未知或不可信,直到该证书被信任为止;请改以 Ed25519 指纹进行验证。中文、日文和韩文的 PDF 文件需要在服务器上(或位于 `TGWITNESS_FONT_DIR`);若无该字体,ZIP文件中仅包含HTML和JSON报告 。 - `report.en.html`、`report.en.pdf` / `chat.en.html`、`chat.en.pdf`:当报告语言不是英文时,同一报告的英文原件,以相同方式封印和签名,并在已签名清单的 `report.original` 下列出。所选语言的报告开头建议将英文原件连同经认证或宣誓的译文一并提交;参见[为法院翻译报告](https://phishdestroy.io/tgwitness/zh/docs/reference/translation/)。 在频道或超级群中,Telegram 按顺序为消息编号 1、2、3…… 聊天记录导出文件会列出 起始编号和结束编号、现有消息数量,以及所有缺失编号的连续区间(如 `message-ids.json` )、清单和 `chat.json` 头部信息,并标记每个缺口在 聊天记录中的具体位置。 `verify.py` 从`chat.json` 开始重新计数。缺失的编号是指Telegram 未返回的消息(在导出前已被删除,或该账户无法查看);在私聊和 基础群组中,编号在该账户的所有聊天中共享,且缺口不计入统计。 读取历史记录后,导出功能会再次按号码向 Telegram 请求所有缺失的号码(`channels.getMessages`,最多 10,000 个号码,包括第一条消息下方的 1,000 个号码;若缺失数量更多,则均匀分布于所有缺口处)。结果位于 `message-ids.json` 和报告中。空响应表示在重新检查时该号码对该账户不可用;具体原因未作说明。重新检查时返回的消息将被添加到导出结果中并标记为 `found_on_recheck`. 当监视工作区检测到聊天中的消息被删除、重新检查时缺失或被编辑,聊天导出文件会添加 `journal-changes.jsonl`:这些日志记录、所有已保存版本以及相关通知,每项均包含其在日志中收到的哈希值和 Ed25519 签名。 `verify.py` 系统会重新计算每条记录的哈希值,使用导出密钥验证其签名,并将计数与已签名的清单进行比对;证据导出文件包含完整的哈希链。报告将在**“已删除内容”和“早期版本**”部分列出这些消息。 每份报告均以**简而言之**开头:先有一段概述,随后说明材料显示的内容以及记录包含的内容。 当浏览器验证了印章的 签名(而非页面本身)后,页面自身的印章会变为琥珀色:浏览器不会为页面提供其自身的字节。 只有当 读者将文件拖放到页面底部的验证框中,且每个字节都匹配时,且仅当 显示的页面正是该文件时,印章才会变为绿色;否则将变为红色。 每份报告均精确标明程序名称:当收集器从代码检出运行时对应的 git 提交,或 安装程序设置的 `TGWITNESS_COMMIT`,以及其源文件的 SHA-256(`source_tree_sha256`、 路径的规范 JSON → SHA-256,适用于每个 `.py`、`.js`、`.css`、`.html` 和 `.svg` 文件在 包中),除非文件被修改,否则检出该提交即可重现上述内容。 Telegram 客户端的命名包含其库、API 层和数据中心。当观察开始以及聊天 导出开始和结束时,收集器会向 Telegram 查询其时间(`updates.getState`,整 秒),并记录 Telegram 的时间减去收集器时钟的时间,其中包含因 往返传输产生的不确定性;报告在“保管链”部分显示这些测量值。 聊天导出记录的 内容还包括读取历史记录的时间,而不仅仅是消息的日期。 ### 离线报告查看器和存档指南 在打开 `chat.html` 或 `report.html` 之前,请先解压完整的 ZIP 文件。该查看器提供搜索、 筛选、参与者、指标、记录详情以及无需服务器即可进行的 JSON/CSV 选择功能。请将 `viewer/` 和 `media/` 放在报告旁边。所选内容均为衍生文件:请使用 `verify.py SELECTION.json --evidence ARCHIVE.zip` 将其与签名存档进行比对。 验证器会检查报告 ID、签名密钥、归档边界以及每个选定项目;经过编辑、 缺失或重复的项目将导致验证失败。选择说明和创建时间仍属于未签名的元数据。 仅在完整、未经过滤且按升序排列的聊天记录流中显示消息编号缺口。隐藏 类别或未能加载数据块,绝不能将省略的行视为消息缺失的 证据。搜索高亮功能在HTML转义之前对纯文本进行操作,并保留字面标记。 该浏览器会检查清单签名、报告 ID 和密钥,以及所有列出的文件哈希值。它 会拒绝模棱两可或格式错误的 ZIP 结构、重复的文件名和不安全的路径,并将文件 大小限制在 256 MiB 以内,声明的总内容大小限制在 4 GiB 以内。对于更大的归档文件,请使用独立验证器。 此浏览器检查是对验证器对日志链和数据语义检查的补充。 `README.txt`包含一份入门指南、一份对齐的文件清单、验证说明以及 以报告语言编写的数据格式说明,随后是完整的英文指南。 `SHA256SUMS`涵盖了 其中列出的文件,但不包括该文件本身、`manifest.json`和`manifest.sig`;签名清单 还涵盖了`SHA256SUMS`。请保持原始ZIP文件不变,并将工作文件保存到 解压文件夹之外。PDF报告包含章节书签,后续页面上带有案件/报告标识。 ### 导出时的聊天记录 聊天导出记录了导出开始时 Telegram 对该聊天的描述:Telegram 自身的 标签(`scam`、`fake`、`restricted` 及其理由、`verified`)、用户名、描述、成员 和管理员数量、关联的讨论、内容保护、新成员是否能查看早期 消息,以及该账户从哪条消息开始能查看聊天记录(`available_min_id`), 消息 1 的日期 (当该消息即为聊天创建时间时),以及聊天照片的 SHA-256(保存在 `media/` 中)。 它记录了导出账户在聊天中的位置:角色、加入日期、邀请人,以及对于 管理员而言,其权限。Telegram 拒绝的请求将另行标注。 当导出账户为管理员时,导出操作会将聊天室的管理员日志(Telegram 保留约 48 小时)读取到 `admin-log.json` 中:包括删除和编辑操作,以及相关内容、 操作账户和源操作日期。这些条目补充了实时日志的 捕获版本和删除接收记录。 ### 指标 报告列表及存档中包含 `indicators.csv` 、`indicators.stix.json` (STIX 2.1 ) 以及 `indicators.misp.json` (MISP 事件),滥用处理部门可据此对记录的消息采取行动: 链接和域名(包括隐藏在文本中、按钮内及链接预览中的内容)、加密货币 地址、Telegram 用户名和邀请链接、电话号码、电子邮件地址以及保存的图片。 比特币、莱特币、狗狗币和波场地址仅在 base58 校验和通过时才会被列出, SegWit 地址在 bech32 或 bech32m 校验和通过时会被列出,而 TON 地址在 CRC 校验通过时会被列出;EVM 和 Solana 地址则被标记为未经过校验。 图片包含 SHA-256 以及一个感知 哈希(dHash,64 位),其值在重新压缩或调整大小的副本中几乎保持不变。报告会写入 标记,以防止意外打开(`hxxps[://]example[.]com` );文件保留 原始值不变。 每个指示符均被标记为未知且不适用于自动检测(STIX 、 `indicator_types: unknown` 、MISP 、`to_ids: false` ,分发至本组织):被 列出仅表示某条消息中包含该指示符,并不意味着其具有恶意。若链接的文本显示的 地址与其实际打开的地址不同,则该链接会在报告中被标记。 PDF报告末尾包含一份需由检查员亲笔签署的声明、一份供公证员或 法院专家使用的核对清单,以及一个二维码(首页亦有显示),其中包含报告ID、密钥指纹以及 权威数据的SHA-256,以便打印件可追溯至其存档。 ## 事件规范化 哈希输入必须包含以下字段: ``` seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash ``` 使用与 Python 兼容的 JSON 格式进行序列化,采用 UTF-8 编码,对象键按顺序排列,不进行 ASCII 转义,不包含无关的空白字符,且不包含 NaN/无穷大: ``` json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":"), allow_nan=False).encode("utf-8") ``` 这些字节的 SHA-256 值即为事件哈希。签名采用 Ed25519 对 32 个原始哈希字节进行计算,随后进行 Base64 编码。第一个 previous_hash 由 64 个零组成。 序列号从 1 开始,并以 1 为增量递增。所有事件(包括操作性 事件)共用一条链。系统不抑制重复交付:重复 的观测结果是独立的收据,而非对独立 Telegram 操作的声明。 Telegram 的原始日期为 ISO 字符串;二进制字段则转换为包含 bytes_base64 的对象。消息正文、实体、媒体描述符、回复元数据、点赞 以及服务操作(如有提供)均保留在原始消息元数据中。实时 消息还会保留将其发送的 Telegram 更新 `transport_update`;当 该更新携带的消息与 `raw`,其 `message` 字段为 `{"same_as": "raw"}` ,而非生成第二份副本。 `observed_at` 是收集器写入该记录时的协调世界时(UTC); `source_at` 是 该 Telegram 事件提供的日期。在处理实时更新时写入的记录会添加 `payload.received_at`,即更新到达收集器的协调世界时(UTC),以及 `payload.processing_delay_ms`。实时编辑会保留提供的编辑日期,历史 快照会保留消息日期并附带当前观测时间,而普通的 删除通知则记录接收时间,且源日期为空。管理日志 条目会单独保留其提供的操作日期。接收顺序与源 事件顺序属于不同的时间线,可通过时钟观测值和外部接收记录 进行对比。 ## 行为主体语义 归因遵循事件源。`message.new.actor_id`和 `message.edited.payload.sender_id`保留消息发送者。普通的 `message.deleted`通知包含消息ID,且actor字段为空; 可用的管理日志条目包含其提供的操作、执行者和日期。 成员服务消息保留发送者和操作类型,原始参与者更新 保留提供的`actor_id`,而反应快照保留其提供的 计数和可见身份。请结合捕获的 版本和[面板交互收据](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#own-actions)一起阅读这些记录。 私聊和普通群组的删除通知仅包含消息 ID。 这些聊天共享一个全账户范围的 ID 序列,因此一个 ID 唯一标识该 账户中的一条消息。当具有该 ID 的消息此前已保存在日志中时, 删除操作会在该聊天中以 `message.deleted` 的形式记录,其中 `payload.chat_resolution` 指定了方法名称。从未被保存过的 ID 将作为 `deletion.unscoped` 保留:这是一种 实际的删除通知,但其对应的聊天尚未被关联。 这与 `message.missing_on_recheck`(记录不可用的查询结果)以及 已保存消息 ID 中的缺口有所不同。频道和超级群组按聊天对消息进行编号, 绝不会通过这种方式进行匹配。当被删除的消息是由被观察账户发送时, payload.deleted_message_was_outgoing 为 true;但仍未提供删除者信息。 无范围的通知会保留其自身的标签,因为匹配的聊天可能位于 当前观察范围之外,或者没有唯一匹配项。在报告计数、过滤器和 标签中,重新检查缺失仍与删除通知视为 独立的观察项。后续的恢复操作会清除当前的缺失状态,同时在 签名历史记录中保留先前的检查失败记录;删除通知仍作为 独立的事件类型存在。 来自同一条通知且解析为同一聊天室的多个ID将被归类为 `deletion.batch`,无论其数量多少,其中消息ID完全按照Telegram 发送时的原样保留,并记录该账户发送了多少条。Telegram的通知中 列出了这些消息;聊天室的管理员日志会标明实际操作的管理员,该账户 可在该处查阅。 链接(`message.deletion_attributed`)的建立取决于以下两种情况中发生得较早的那一种: 如果某次轮询在删除通知记录之前就已看到管理员日志条目,则在通知 被记录时,该轮询将被匹配。 ## 覆盖范围:连续性、缺失内容及未被观察到的 ID 每个签名 ZIP 文件都包含 `coverage.json`,HTML 报告以相同的摘要开头,而 `verify.py` 会根据 `events.jsonl` 重新计算该摘要,而非直接信任该文件: - **从 X 到 Y 持续进行观察。**一个观察周期始于 `observation.started`, 并结束于暂停、停止、Telegram 连接丢失、注销、未按正常流程停止的进程启动, 或观察期间超过三分钟无任何记录 (心跳每分钟写入一次,因此无记录意味着进程已停止、卡死或 计算机进入睡眠状态)。 当在**更多工具 → 参数**中更改心跳间隔时,每次心跳 都会记录该间隔,允许的静默时间将变为三个间隔,且绝不少于三分钟。 - **“缺口”**列出了各时段之间的时间间隔及原因。若最后 一条记录处仍存在缺口,则标记为 `not_resumed_by_last_record`。 - **未观察到的消息 ID。**对于按 聊天计数消息的频道和超级群组,观察到的消息 ID 之间的缺失 ID 将以范围形式列出。这些消息会被报告为 “未*观察到*”——即已被删除、从未送达或超出保存的历史记录范围——但绝不会被标记为 “已删除”。私人聊天和普通群组共享全账户范围的序列号,因此此类聊天内部的 缺口没有任何意义,也不会在此处列出。 - 聊天层面的数据缺失通知(例如 Telegram 在某个 频道中要求恢复差异数据)被计为注释;它们不会中断全局覆盖。 - **Session records.** Windows in which Telegram's update counter grew while no update reached this session (`updates_diverted`), this session left Telegram's session list while its connection kept working (`session_revoked_externally`), or a witness probe's answer arrived only from history (`probe_ack_missed_live`) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See [accounts](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#witness-probe). While [strict chosen chats](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#strict-chosen-chats) is on (`scope.strict` in `observation.started`), the session list (except while this is the only session, or when **Telegram devices** is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it. ### 更新序列 (`pts`) Telegram 通过以下方式更新与消息相关的信息: `pts`:每个账号有一个序列 (将私人聊天和基本群组合并为一个),每个频道或超级群组则各有一个序列。该 收集器将收到的每个无缺口的序列记录为 `coverage.sequence` 一条记录:起始和结束 `pts`、每种类型的更新数量,以及它们是 实时推送的还是由 `getDifference` 或 `getChannelDifference`返回。中断被视为一个 `coverage.gap` 记录,并 `coverage.gap_closed` 指明 `pts` ,从该点起,序列 又恢复完整。 一段连续的记录表明,Telegram在该序列中编号的每一条更新,从 第一条到最后一条 `pts` 之间,Telegram按该序列编号的每次更新都已到达该收集器的Telegram客户端。这并未涉及 Telegram从未发送至该账户的内容,也未涉及首次记录 `pts`之前的时间段,也未涉及收集者未记录的连续段。任何 `pts` 任何 记录的连续段或差异均未涵盖的间隔,均显示为中断。 `GET /api/continuity` 针对一个区间(`since`, `until`, `chat_id`) 内,判断每个 序列是否连续,并列出断点及其原因。 `verify.py` 根据**“序列连续性**”下的档案记录, 打印相同的内容。 ### 缺失的消息编号(`gap_summary`) For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). **预览。** `coverage.json` → `gap_summary` 该工具统计 Telegram 分配的编号中,该 收集器从未检测到的数量。Telegram 针对每个频道或超级群组对消息进行一次编号,并针对 每个账户在私聊、机器人和普通群组中各进行一次编号。两个已观测 消息之间的编号要么已被观测到,要么缺失;连续的编号范围则表明 该范围内的所有编号消息均已被观测到。编号缺口既不指向特定行为主体,也不说明原因。 | 字段 | 含义 | | --- | --- | | `status` | `on`,或在**更多工具→参数→差距分析**中关闭时为 `off` | | `parameters` | 生成该结果的参数,以便能够重现该结果 | | `chats[]` | 每个频道或超级群对应一条记录,每条记录均单独编号 | | `account` | 整个账户中私聊、机器人和普通群组的序列 | | `status` (按序列) | `applicable`,或 `not_applicable` 使用 `reason` | | `observed_from`, `observed_to`, `span` | 首次和最后一次观察到的号码以及范围的大小 | | `observed`, `observed_without_content` | 观测数值;仅通过删除或重新检查记录得知的数值 | | `missing`, `density`, `gap_ranges`, `largest_gap` | 从未观测到的数字、其在范围中所占的比例、运行次数、最长运行时间 | | `clusters[]` | 列出的缺失内容: `low`, `high`, `missing`,以及相邻的观测数值 `after` / `before` 及其观测时间 | | `service_estimate` | 仅在启用时显示:根据观察到的占比,缺失的数字中有多少属于服务消息。该数值绝不会从 `missing` | 有效性源自日志,绝不预设: - **频道和超级群的**统计以聊天为单位进行,在所选聊天的导出文件中也是如此。 由发送方选定的记录将用于统计 `not_applicable`. - **全账户序列**仅从全账户收集功能开启期间收到的第一条消息到最后一条消息进行统计, 并包含私聊、机器人、普通 群组以及该账户自身的消息,没有任何此类聊天被排除在外(`scope.changed`)。 标有 `deletion.unscoped` “count”命名的数字均视为已观察到的消息,不包含内容。导出或 移交选定聊天记录无法测量该数值。如果全账户收集功能曾被 关闭后又开启,则会提示说明:期间使用的数字将显示为缺口。 - 服务消息是带有独立编号的日志记录,因此它们会自动填补间隙; 可选的估计时间仅作为上下文参考。 `verify.py` 重新计算 `gap_summary` 基于 `events.jsonl` 基于签名 `coverage.json` 成员中的参数(针对旧版存档使用默认值),并 在覆盖范围摘要中打印该账户范围内的行。该存档的 `get_capture_status`(MCP 和命令行)针对某次访问可能读取的聊天记录返回相同的测量结果; 而账户级序列仅适用于覆盖整个工作区的访问。 对同一服务消息的重复观测仅计为一次,且账户服务估算 仅使用测量范围内的数值。在启用全账户测量之前,应用范围必须显式保留 该账户自身的消息;测量 从携带该信息的记录开始。测量范围涵盖正在运行的 观测,且其恢复情况会被记录。实时归档查询具有时间 预算(包括其数据库扫描),并将未完成的测量标记为部分完成。 Telegram 记录了[独立的消息 ID 序列](https://core.telegram.org/api/updates#message-id-sequences)。 这些数字描述了观察结果;删除通知、重新检查以及管理日志记录 了为何在 Telegram 报告的位置上某个数字缺失。 当Telegram停止接受该账户时,结束监视的`coverage.gap`记录 包含`cause`(`account_banned`、`account_frozen`、`account_deleted`、`session_duplicated`、 `session_revoked`、`session_expired`、`session_ended`或`not_authorized`)以及Telegram 错误;`verify.py`指明了该周期结束的原因。 覆盖范围综合了记录的观察时段、中断情况和消息结果。 请结合所选的聊天记录、时间段和附件策略进行评估;重新检查 结果和记录的缺口,以了解该账户的更新被观察到的完整程度。 ## 制作人 证据 ZIP 包、聊天导出、见证日志以及 人员档案文件的声明中,其签名清单包含 `producer`:软件、版本、项目(PhishDestroy)、 主页和源代码仓库。HTML 报告和验证器会显示此签名 的 producer 记录。源文件哈希值用于标识记录的源代码树,以便 与可信的检出版本进行比对。 执行溯源信息将通过 [GitHub 获取证明或](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) [Intel TDX 测量](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/)(若已启用)进行单独验证。在 生产者字段出现之前创建的存档仍受支持,并被标识为遗留记录。 每条 `observation.started` 记录还会指明进行监视的 Telegram 客户端:其 `api_id` (绝非哈希值),无论该客户端是内置的公钥对还是运营商自有的应用程序, Telegram 连接请求中发送的客户端描述,以及连接 路由的类型及其 IP 模式(无代理地址或密钥)。 该报告和`custody.json`列出了每个 不同的客户端和路由及其记录时间,以及未列出的代理未响应的时间 和Telegram检测到服务器地址的时间。此前记录的日志中已有说明。 ## 人物简介 应请求,系统会基于日志中已有的 某次聊天的记录生成个人资料文件(`tgwitness-dossier-v1`,JSON);该文件不会从 Telegram 获取任何数据,且个人资料内容绝不会 写入日志(个人资料的启用和停用将记录为 `dossier.changed`)。 对于每位拥有已保存消息的用户,该文件会列出其姓名和用户名历史记录、Telegram标记 (机器人、诈骗、虚假、高级、已验证、受限、已删除)——以保存时显示的状态为准,以及个人资料 照片ID、来自本地头像缓存中与该头像相似的头像的SHA-256和感知哈希(pHash,与`imagehash.phash`兼容) 、活动记录(首条和末条消息、 数量、已编辑和已删除的分享、按UTC小时划分的消息)、谁回复了谁、该用户曾在此日志中参与的其他聊天 中该用户曾发帖的聊天记录,以及被提及的钱包(BTC、EVM、TRON、TON、LTC、 DOGE、XMR、SOL;Base58Check地址已通过校验和验证)、电话号码、用户名和 链接,包括隐藏在文本背后的链接。 每个事实都会列出其来源的日志记录(`seq`),而 `record_hashes` 则包含 每个被引用的记录的哈希值。该声明使用工作区密钥进行签名: ``` python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip ``` 该工具会检查签名,验证证据导出文件本身(包括签名、哈希链和文件), 并确保每个被引用的记录在同一工作区的导出文件中完整无缺且未被修改。头像哈希值会被标注为来自本地缓存 (而非日志记录)。提及内容属于模式匹配,是待核查的线索。 配置文件按聊天进行启用,可导出为带密码的 AES-256 压缩包,且 在关闭配置文件或聊天从来源中移除时被删除。 ## 独立见证者 通过 `verify.py --witness … --channel …` 命令,将见证人日志(`tgwitness-witness-v1`)及其频道帖子与 证据导出文件进行比对;参见[独立见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)。 使用公共 `https://t.me/s/…` 或 `https://telegram.me/s/…` 地址时,验证器会从 Telegram 中读取 每条帖子的日期,而导出文件开头处最早的此类日期 即为最后一条记录的外部时间。来自任何其他来源的日期均为提供的元数据。 ## 清单与检查点 manifest.json 包含格式、导出时间、公钥、指纹、日志 长度、头部哈希、作用域、生成者、限制,以及除 `manifest.json` 和 `manifest.sig` 本身之外 每个内容成员的 SHA-256 值。 manifest.sig 是规范化清单 JSON 的 Base64 Ed25519 签名。 验证器会拒绝处理意外/缺失的成员、名称重复、文件损坏、 序列/链断裂、无效签名以及与提供的检查点不匹配的情况。 它绝不会提取归档路径。它将声明的总未压缩大小限制为 4 GiB; `--max-gib N` 允许通过提高**更多工具 → 参数**中的限制来创建更大的归档文件。 大型存档由多个进程同时进行校验:成员记录会并行进行哈希计算, 在前5,000条记录之后,每个记录的内容哈希值和签名将由 工作进程进行校验,而主进程则按顺序跟踪链、覆盖范围和绑定 关系。 `--jobs N` 用于设置进程数量;默认 `auto` 是每个CPU一个进程, 最多16个,而 `--jobs 1` 将所有操作保留在一个进程中。无论采用哪种方式,结果都是一样的, 且更改请求都会因相同的错误信息而被拒绝。在该单次遍历过程中,会保留由保留的 检查点和时间戳锚点指定的位置处的哈希值,因此无需再次读取日志即可 对每个锚点进行比较。 在一台 32 线程的计算机上,一个包含 400,000 条记录、大小为 10.8 GB 的归档文件,在单个进程中耗时 58.9 秒,在 4 个进程中耗时 15.2 秒,在 16 个进程中耗时 8.4 秒;按顺序对 记录进行一次遍历后,便确定了上限。 请从您已安装的 TgWitness 版本或经过审核的代码检出中运行验证。 存档文件中包含的副本支持便携式使用;在执行该副本之前,请将其与您的 可信安装版本进行比对。 检查点会对包含公钥、日志长度、头部 哈希值及创建时间的声明进行签名。它还携带了工作区 获取的最新 drand 轮次(`drand_anchor` ):收集器在每次定期检查点生成前,会通过工作区的 外部路由向 drand 中继发起请求,因此 Hide IP、代理以及已关闭的 外部路由均适用,且生成检查点本身绝不会连接到外部。 验证器可以检查 后续归档文件是否包含相同的前缀。通过`--checkpoint` 和`--check-drand` ,它会与drand中继确认该轮次,并报告该检查点 的签名时间不早于该轮次的时间;该轮次不会改变保障等级。 将 检查点保留在收集器之外,以便后续验证时将归档文件与 单独保存的参考文件进行比对。由于收集器密钥对其进行了签名,因此 只有当接收方通过 其他渠道在获得归档文件之前就已获取该检查点时,该检查点才会将其记录与收集器绑定;仅凭该检查点本身,无法满足证据的最低要求。 ## 读取验证结果 验证器会分别报告归档完整性、签名者固定性和可信度检查结果 。有效的签名表明,自签名以来,这些字节内容未发生 变化。操作员通过单独的 通道将密钥指纹提供给接收方。如果没有 `--fingerprint`,完整的归档文件将通过其签名和格式 检查,且 `signer_pinned: false`,且最后一行以 `EVIDENCE: minimum not met · missing: confirmed signer key`. 对于需要固定签名者且证据要求最低的 自动化本地归档策略: ``` python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence ``` 使用通过接收方可信通道保留的指纹。可信 见证人还可以通过一致的见证日志对收集器进行固定;提供 `--witness`、`--witness-fingerprint`和`--require-witness`参数。`--strict`在 签名者未被固定时以状态2退出;未满足`--require-tier`或`--require evidence`条件时也 以状态2退出。`--require evidence`需要`--fingerprint`以及来自 第三方、覆盖最后一条记录的外部时间戳。 请阅读`signer_pinned`、`requirements_met`以及保证结果,而不仅仅是退出 代码。[密封获取](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence)则使用其 证明验证器和已批准的策略来验证获取摘要。 ## 验证范围 验证过程会检查存档文件及其生成所使用的采集模式。请选择 其信任边界与当前情况相匹配的模式,并保留该模式的验证输入。 | 采集模式 | 验证器检查的内容 | 验证输入与信任边界 | | --- | --- | --- | | 本地工作区 | 记录签名、哈希链、清单和附件字节 | 接收方保留的收集器指纹以及来自第三方的时间戳:经过验证的 RFC 3161 或 OpenTimestamps 收据,或从 t.me 读取的见证人帖子。保留的检查点和见证人记录作为辅助验证依据。 | | 带独立见证节点的本地工作区 | 归档校验以及与见证人保留的早期日志前缀的一致性 | 见证者指纹和记录;保管方的密钥控制记录表明见证者密钥由谁持有。使用 `--channel https://t.me/s/…` 时,Telegram 为帖子设定的日期提供外部时间 | | [GitHub Actions 捕获](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | GitHub 对存档摘要、已批准的工作流和收集器提交、托管运行器、新的会话/密钥来源以及内部存档完整性的认证 | 可信验证者策略、调用者存储库和 GitHub 证明包;数据采集在固定工作流下运行 | | [云部署](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/) | 提供商的生命周期和访问记录、防火墙和 Cloudflare 状态,以及收集器的签名运行记录 | 对服务提供商和 Cloudflare 进行只读查询;各项检查的可用性取决于服务提供商 | | [Intel TDX 机密虚拟机](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | 引用签名和平台状态,将其与收集器声明、组装及操作系统测量数据相关联 | Intel 信任链及预期部署指标;保留每次必需的 TDX 检查结果 | 在密封采集过程中,经批准的采集器通过经过身份验证的 Telegram 连接在已验证的环境内接收数据。证明将归档文件与 该执行过程绑定,因此验证既涵盖采集过程,也涵盖后续的文件完整性。 这依赖于经批准的代码以及上文列出的平台信任链。 GitHub 捕获验证要求在运行过程中创建会话,并拒绝 导入会话的捕获。 运行收据记录了收集器的版本、文件哈希值和启动设置。GitHub 来源信息和 TDX 测量结果用于环境验证; [验证记录](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/)标识了已测试的配置。 ### 消息的来源 Telegram 通过 MTProto 会话向每个客户端(包括官方应用)发送消息。该会话的授权密钥是根据 Telegram 的 固定服务器密钥协商生成的,每次更新都会使用该密钥进行加密并经过完整性校验后 发送。收集器通过账户的经过身份验证的 会话接收消息,并在每条观察记录到达时将其签名记录到日志中,其中包含聊天、 消息和发件人标识符,以及 Telegram 为每条消息设定的日期。在 GitHub Actions 捕获和 Intel TDX 部署中,认证还会将该会话和 签名密钥与已批准的收集器执行绑定。 日志记录授权密钥的来源。通过手机或二维码登录, 或从会话文件独立登录,会将 `account.authorized` 写入日志,并标注 `key_origin: "created"`;基于导入的 `.session`、TData 或 JSON 密钥进行收集时,则写入 `imported`。无论源自何处,导入的密钥均会保留。经认证的部署 拒绝使用导入的密钥。 一条记录在Telegram中的来源基于该账户的经过身份验证的连接、 日志中的连接和捕获记录、与日志条目匹配的已捕获MTProto帧 ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics))、每条 消息在Telegram中的日期,以及对于经认证的捕获,还包括经过验证的执行环境。 存档签名 可保存该记录以供日后核查。保留的检查点确定了早期日志的 边界,覆盖记录显示了采集结果,而经过验证的外部时间戳 则将已提交的字节定位在特定时间点。 对于本地工作区,接收方需提供可信收集器或见证人的输入。 对于密封采集,可信策略和证明将归档摘要与 经批准的收集器执行绑定。这些是不同的验证路径;请报告 所选路径上已完成的检查。 ## 附件 文件在 media/ 目录下通过 SHA-256 哈希值进行标识。media.saved 事件将哈希值和 字节长度与特定的消息事件相关联。原始文件名属于元数据,绝非本地 路径。 媒体数据以异步方式下载,因此立即删除可能导致 无法捕获。已禁用的采集、超大/未知大小的文件、下载失败 以及下载中断等结果均会显示。进程崩溃可能会留下 未被引用的部分文件;这些文件不会包含在导出数据中。 ZIP 导出工具会根据文件名对存储的媒体文件进行验证。JSONL、CSV 和 HTML 导出格式会验证事件签名,但不包含媒体文件数据。衍生报告 仅供参考;events.jsonl 才是权威的事件表示形式。 完整聊天导出会将工作区附件设置中的附件保存至 media/ 目录下,文件名格式为 SHA-256。 chat.json 中的每条消息记录都会标注其文件名称(`file`、 `file_sha256`)或缺失原因(`file_status`),并附带读者所看到的 文本周边内容:文本后面的链接、转发来源、机器人按钮、签名、查看次数以及 自动删除计时器。`verify.py` 会检查每个命名文件是否位于该哈希值对应的 签名清单中。 ## 持久的收集与处理收据 (0.2) 媒体任务及其消息事件提交在同一事务中完成。 该任务存储 原始 TL 消息描述符;签名的观测记录将其 SHA-256 值、账户 及大小策略进行绑定。恢复操作会在下载前验证该绑定。它绝不会获取 当前消息,也不会悄无声息地替换为更新版本的附件。中断的任务 会重试,而永久性失败则仍被视为明确的结果。 每个工作区都有自己的日志和签名身份。process.started 事件包含 运行 ID、本地时钟、依赖项版本、源文件哈希值、初始账户/作用域, 以及捕获设置。心跳消息包含运行 ID、单调时间和队列状态。 运行收据也可作为单独签名的声明下载。若要验证 执行环境,请将其与[验证范围](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)中所述的 GitHub 证明或 TDX 检查 结合使用。 自动检查点会在启动时、观察期间每五分钟 (**更多工具 → 参数 → 每隔**)以及有序停止时保存在本地。启动验证和导出操作会将日志 与最新保留的本地检查点进行比对。当检查点仍存在时,此操作可检测到数据库回滚 。独立保留机制确保该引用在 工作区之外仍可用;经过验证的外部时间戳则进一步将其锚定在特定时间点。 重启后,将恢复保存的 Telegram 更新位置(`catch_up_from` 在 `observation.started`)并请求获取遗漏的更新。保存的位置仅涵盖已处理完成的更新,因此连接关闭或进程停止时仍在等待处理的更新将重新请求。定期重新检查会记录 `message.recovered` 以检测遗漏的消息,并 `message.missing_on_recheck` 当Telegram不再返回已保存的消息时;后者并非删除通知,且未指明删除者或时间。 ### 异地备份与恢复(S3) 异地副本(**设置 → 通知和异地副本 → 异地副本**,或 **更多工具 → 扩展功能 → 证据与备份**;默认关闭)会将日志分段、保留文件、检查点 及其时间戳,以及已完成的聊天导出上传至兼容 S3 的存储中,上传前使用 AES-256-GCM 加密,密钥保存在工作区保险库中;若存储桶支持,则应用 Object Lock 保留策略。 若未下载密钥,则无法读取该副本。请使用`python -m tgwitness.replica restore --key-file KEY.json --out DIR`进行恢复和验证。 恢复操作需要一个空的普通目录。下载的文件和解密后的对象将保存在私有 临时存储中,直至整个日志及所有保留的检查点均通过验证。不安全的对象 路径、不一致的段范围以及长度短于检查点的日志将被拒绝;验证失败 时,系统不会发布任何恢复文件。 保留性检查会将返回的“对象锁定” 模式和日期与上传时发送的截止时间进行比对(允许一秒的四舍五入误差)。过期、 无效或被缩短的截止时间均不视为已验证。状态报告将显示该上传批次中 被读取保留状态的抽样对象。 缺失或损坏的本地媒体文件将作为当前迭代的错误报告,并保持媒体光标停留在 该文件之前,以便在下一次迭代中重新尝试处理该文件;其后的文件、检查点和导出内容仍将 被复制。恢复过程会 将所有已保存媒体的引用与解密后的哈希值及记录的大小进行比对。 来自中断上传的 相同重叠日志段将被去重;冲突的重叠部分将被拒绝。 上传过程中创建的检查点将推迟处理,直至其所涵盖的日志记录被 复制完毕,因此一个完成的处理阶段不会在日志之前发布检查点。 ### 流式导出快照 流式导出使用稳定的 SQLite 读取快照。当下载完成时,该快照的起始点可能早于 当前的实时日志。在此快照之后创建的检查点 可能会正确报告存档长度较短;请与位于导出前缀处或之前的检查点进行比较, 而非任意的后续检查点。 ## RFC 3161 准备与响应验证 (0.2) 证据模式仅通过工作区路径(绝不通过 MTProxy)将每个已签名检查点的 SHA-256 哈希值发送至列出的 RFC 3161 权威机构和 OpenTimestamps 日历。 在每个设置目标中,时间戳功能默认开启;**案件的证据**还会记录 drand。 响应保存在 `checkpoints/anchors/`中,并导出为 `.tsr` 以及 `.ots` 文件,位于 `anchors/`, 并由 `verify.py` (`--tsa-ca` 检查 TSA 签名;使用 验证 OpenTimestamps 证明,并 `ots upgrade` 和 `ots verify`). 连续两次失败的 RFC 3161 授权实体在下次尝试前会进行等待:先等待一个时间间隔,然后 两个、四个,以此类推,最长可达六小时,或根据其 `Retry-After` 指定的时间,最长可达一天。若通过检查时 仅发现处于等待状态的授权实体,则不生成记录;否则,`anchor.completed` 会将其列在 `deferred` 下,并附带 `retry_at`。在它们再次响应之前,面板将时间戳显示为**性能下降**。 该面板会准备一个请求存档,其中包含规范的 checkpoint.json 字节数据、 SHA-256 消息指纹以及 timestamp.tsq 中的随机非ce值、校验和及操作说明。 不会发起任何网络请求;授权方为此请求返回的令牌即为时间戳。 `python -m tgwitness.anchor verify` 无需 OpenSSL,即可根据检查点字节和原始请求核对响应。必须明确指定受信任的 CA 文件;附带的证书不会被自动信任。在 CLI 中请求检查是可选的,因此请保留请求,并传入 --request 以检查 nonce。结果会说明是否进行了检查。收集器的检查点签名和日志仍需使用受信任的收集器指纹另行验证。 验证过程会检查响应签名、检查点字节以及(若提供的话) 在指定 CA 信任下生成的原始请求。对于在证据模式下获取的时间戳, `verify.py` 还会检查存储的 OCSP 或 CRL 证据([签名证书吊销](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/#signing-certificate-revocation))。 请参阅 [流程](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/) 以及 [验证结果](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/). ## 证据模式下的可选记录:drand 和 Telegram 设备 还有两项记录可以与时间戳在同一轮处理中运行。这两项仅在 证据模式开启时才生效。**案件的证据**会开启“drand”功能;否则两者均处于关闭状态。可在 “更多工具”→“扩展功能”→“证据与备份”→“**更多证人 · 可选**”中切换它们, 或者 `"drand": true` 以及 `"devices": true` 在 `POST /api/evidence`中。其中一项出现故障不会阻止 另一项或时间戳的运行;面板会在表单下方显示每项的最新结果。 **drand** (`beacon.drand` )。每次处理都会将最新一轮的 drand quicknet(即熵联盟的公共 随机数,每 3 秒一轮)写入日志:`chain` 、 `round` 、`randomness` 、`signature` 、`round_time` 以及响应的 `relay` 。一个经过验证的 不可预测的轮次为后续哈希链接的材料提供了较低的时间参考。 后续检查点上的经过验证的时间戳则提供时间上限。这些检查 界定了关联的数据范围。收集器首先向 `drand.cloudflare.com` 发起请求,然后通过工作区路径向 Protocol Labs 的中继节点发起请求,每轮一次请求。 `verify.py` 会验证每个随机数是否为其签名的SHA-256 ,并检查轮次 时间是否正确,同时报告轮次数量、最长未生成轮次的间隔以及收集器时钟相对于 drand的延迟。 `--check-drand` 将轮次与 Cloudflare 中继、Protocol Labs 中继以及长日志中的全部轮次或随机 抽取的 100 个样本进行比对;若有任何轮次不一致,则验证失败。 **、Telegram、**(`account.devices`)设备。每次扫描都会读取该账户与 `account.getAuthorizations`的会话,即“设置”→“设备”中显示的Telegram列表,并完整记录: 若自上次处理以来发生变更,则完整记录,包含`added`和`removed`会话 哈希值;否则仅记录其数量及SHA-256。设备型号、平台、应用及版本、 创建时间和最后活动时间、国家和地区等信息将被保留;IP地址则不予保留,因为 证据导出后便不再由您掌控。 收集器自身的会话始终处于活动状态,因此 只有其他会话的活动才被视为变更。`verify.py` 报告列表 被记录的频率,以及每个新会话和已结束会话。它仅在观察运行期间读取该列表。 这些内容展示了:drand 根据公开时间对记录进行排序,而设备 列表是 Telegram 通过收集器发布的声明,与其他所有 记录一样,由收集器签名。 **Cloudflare Gateway 日志**(`cloudflare.gateway_dns`)。 对于通过 Cloudflare Gateway([Gateway DNS](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#cloudflare-as-an-outside-witness))进行解析的服务器,每次 复制都会包含自上次复制以来 Gateway 记录的内容:每个时间窗口(最长三 小时)对应一条记录,包含 `from`、`until`、`location_id`、服务器的 `address`(若已设置),以及 `queries`(作为 `[at, name, type, rcode, decision, colo]`,即使没有记录时也包含)。 请在 **下进行设置。Cloudflare Gateway日志**:账户、位置、可选地址以及一个只读令牌(账户 Analytics 读取;零信任 PII 读取,用于保留共享位置的一个地址)。控制面板会在保存前通过 一次请求验证这些信息;令牌始终保持加密状态,且绝不会进入日志。 `verify.py` 列出了时间窗口、被查询次数最多的名称以及任何未被副本覆盖的时间段;如果某条记录 的计数与其查询不匹配,则该记录将失败。 若某个时间窗口在单秒内包含超过一页的 查询,则保留该页内容,并标注其余部分缺失。该副本是 Cloudflare 通过收集器返回的响应,并由收集器签名;在 24 小时内,任何持有 只读令牌的用户均可将其与 Cloudflare 进行比对。 --- # Telegram · 为法院翻译报告 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/translation/ 哪个文件是原件、应与认证译文一同提交什么,以及译者应保留的术语。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 哪个文件是原件、应与认证译文一同提交什么,以及译者应保留的术语。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [证据与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) ![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness 提供 25 种语言的报告。英文版为原文。其他语言版本均为 机器翻译,其中部分经过术语审核;这些翻译旨在帮助操作员阅读 报告,并非经认证的翻译。 ## 应提交哪些材料 请将英文原件连同经认证或宣誓的、译为法院指定语言的译文一并提交。宣誓 翻译员熟悉当地术语以及法院文件的正式要求。 当报告语言非英语时,证据、聊天记录和交接压缩包中还包含该报告的 英语原文: `report.en.html` 以及 `report.en.pdf`,或 `chat.en.html` 以及 `chat.en.pdf` (针对聊天记录导出)。这些文件使用与所选语言版本报告相同的密钥进行加密和签名, 并在签名清单中以 SHA-256 值列出,其名称位于 `report.original`。以英语导出的报告本身即为原始文件。所选 语言的报告打开时会显示相同的建议,并注明英语文件的名称。 翻译前,请对照存档核对原文: ``` python -m tgwitness.verify report.en.html --fingerprint KEY --evidence tgwitness-evidence.zip ``` `README.txt` 每个归档文件的末尾以一个 **致译者** 该部分列出了原始文件的名称 并重复了下文中的术语。该 [叙事与专家协议](https://github.com/phishdestroy/TgWitness/blob/main/docs/NARRATIVE.md) 打印相同的 建议。 ## 哪些内容保持字面意思 - 文件名、命令、哈希值、密钥指纹、Telegram ID、消息编号和 URL。 - 时间:按原样以 ISO 8601 格式表示的 UTC 时间。请勿将其转换为本地时区。 - 截获的消息:请以原文形式引用,并将翻译单独列出, 并标注为“翻译”。 ## 术语 | 术语 | 含义 | 不应译为 | | --- | --- | --- | | 期刊 | 收集器保存的、经过签名并采用哈希链连接的记录序列 | 日记、期刊、杂志 | | 记录 | 日记中有一条带署名的条目;在全文中请统一使用一个词来指代它 | 注,文章 | | 观察 | 收藏家在记录的时间点收到的物品 | 关于内容真实性的认定 | | 收藏家 | 通过操作员自己的Telegram账户进行观察的TgWitness进程 | 物品集合 | | 数据收集 | 接收并记录来自Telegram的更新 | 合集、套装、选集 | | 删除通知 | Telegram关于消息已被删除的通知;该通知未显示是谁删除了该消息 | 经某人确认的删除 | | 复查时未发现 | 再次查看该消息时,Telegram 不再显示该消息:已被删除,或该账户已无法查看该消息 | 已删除 | | 未接来电号码 | 导出中显示的号码无相关信息:该号码此前已被删除,或该账户从未查看过该号码 | 丢失的消息、失踪的消息 | | 差距 | 一段未被观察到的时期 | 证明什么都没发生 | | 早期版本 | 编辑前的文本;两个版本均被保留 | 更正、篡改 | | 检查点 | 一份经签名的期刊摘要,篇数创下历史新高 | 物理意义上的控制点 | | 时间戳服务(TSA) | 一项基于 RFC 3161 的独立时间戳服务 | 机构、政府部门、证书颁发机构 | | 带时间戳的收据 | 时间戳服务返回的响应,或一份 OpenTimestamps 收据,表明在某个时间点存在一个检查点 | 证据,事实的证明 | | 印章 | 嵌入在报告文件中的 Ed25519 签名 | 官员的印章 | | 签名密钥指纹 | 通过单独的可信通道获取的公钥的 SHA-256 哈希值 | 生物识别指纹 | | 证人 | 负责维护或确认检查点的独立方或服务 | 在法庭上作证的人 | | 移交摘要 | 为另一方准备的期刊的一部分,其中他人的数据已进行最小化处理 | 完全导出 | | 最小化记录 | 一条记录,其中被隐藏的字段被命名并替换为其哈希值 | 已删除或已遮盖的记录 | --- # Telegram · 独立见证者 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/witness/ 运行一个带有独立密钥和机器人的 Witness 实例,将签名后的检查点发布到频道中,并据此验证导出数据。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 运行一个带有独立密钥和机器人的 Witness 实例,将签名后的检查点发布到频道中,并据此验证导出数据。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [证据与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) ![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) · [高可信度](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/) · [面板指南](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#extras) 见证者会将已签名的检查点与收集器分开保存。它会检查 收集器的签名和日志连续性,使用自己的密钥对结果进行签名,并 将其发布到 Telegram 频道。请在单独的服务器上运行该程序,并确保该服务器对 收集器的见证端点仅具有只读访问权限。 技术结果包括保留的日志前缀、质询响应、签名检查、Merkle 包含/一致性检查以及签名的连续性结果。对于由其他保管方运行的见证者,请保留保管方信息及带有其指纹的密钥控制记录。独立的密钥和独立的保管描述的是部署的不同部分。验证器会报告第二个密钥保留了日志头部以及保留到哪条记录;保管方的密钥控制记录表明该密钥由谁持有。见证者日志是辅助检查;证据的最低要求是第三方时间。频道帖子增加了外部时间:Telegram 为每条公开帖子标注日期,验证器会自行读取这些日期。 流程图 · 收集器 → 见证人 (签名检查点:记录条数 + 头部哈希值); 见证人 → Witness日志,自有密钥; 见证人 → Telegram 频道 (通过其自有机器人发布的签名帖子); 证据 ZIP → verify.py; Witness日志,自有密钥 → verify.py; Telegram 频道 → verify.py (t.me/s 页面实时阅读,或桌面版导出) · 收集器 · 见证人 · Witness日志,自有密钥 · Telegram 频道 · 证据 ZIP · verify.py · 签名检查点:记录条数 + · 头部哈希值 · 通过其自有机器人发布的签名帖 · 子 · t.me/s · 页面实时阅读,或桌面版导出 **图表转为文本** 1. 收集器 → 见证人 (签名检查点:记录条数 + 头部哈希值) 2. 见证人 → Witness日志,自有密钥 3. 见证人 → Telegram 频道 (通过其自有机器人发布的签名帖子) 4. 证据 ZIP → verify.py 5. Witness日志,自有密钥 → verify.py 6. Telegram 频道 → verify.py (t.me/s 页面实时阅读,或桌面版导出) **本页内容** - [见证者保存的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/#what-the-witness-holds) - [检查与记录的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/#what-it-checks-and-records) - [运行见证](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/#run-a-witness) - [多个工作区的公开证明页面](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/#public-proof-page-for-several-workspaces) - [验证](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/#verify) ## 见证者保存的内容 | 该工具具有 | 该工具从未 | | --- | --- | | 一个工作区的只读**见证令牌** | 采集器的 Telegram 会话或 API 凭据 | | 其专属的 Ed25519 密钥和日志 | 采集器的存储库、签名密钥或面板令牌 | | 其专属的 Telegram 机器人令牌 | 消息内容:头部包含记录数量和哈希值 | 该令牌在**更多工具→扩展功能→独立见证人**中生成,仅显示一次,且仅以 SHA-256 形式存储。它仅开放一个端点:`GET /api/witness/head`,该端点返回一个新 签名的检查点,以及经过签名的无内容收集计数器和运行状态。 该令牌无法打开控制面板、读取消息内容或更改设置,且 该处不接受控制面板令牌。可在同一页面上撤销令牌。收集器会记录 新见证密钥开始检查的时间(`witness.seen`),并显示每个令牌的最后一次检查时间; 在 2.5 个间隔内未进行检查的见证将被标记为逾期。 新见证节点在每次投票时都会发送一个随机挑战; 捕获语句会在收集器签名下方重复该挑战。计数器 与确切的检查点绑定,并包含在签名的见证帖中。旧版头部 仍被独立见证节点接受。仅日志增长本身绝不会被计为新消息。 ## 其检查和记录的内容 每隔一段时间(默认间隔为 10 分钟),该工具会: 1. 自行获取头部数据(收集器无法推送或跳过该数据); 2. 验证收集器的签名、固定的收集器密钥(`--collector-fingerprint`, 或首个出现的密钥)、一个非递减计数,以及在未改变计数条件下未被修改的头部。 默克尔包含性证明和一致性证明用于验证不断增长的日志是否延伸了 保留的检查点。一旦连续性证明被使用,则拒绝移除它们; 3. 将其签名记录追加到自身的日志中:`witness.anchor`,状态为 `ok`、 `key_changed`、`rollback`(记录数少于之前)、`fork`(长度相同,但 头部不同)或 `invalid`(响应未通过验证),或者当 收集器未响应时为 `witness.no_response`; 4. 将结果发布到频道,并附带签名,包括“无响应”的情况——只要 TgWitness 正在运行且能够访问 Bot API。发布 ID 会被记录下来(`witness.posted`), 发布失败的情况也会被记录(`witness.post_failed`)。 一条记录如下所示;最后一行包含经签名的声明: ``` TgWitness witness #42 · journal head Collector 3fa9c2d1e0b4a7f6: 18234 records Head 9b1f…c07e 2026-10-28T19:40:00.123+00:00 TGW1.eyJhdCI6…. ``` ## 运行 TgWitness 您需要一个 Telegram 机器人(可通过 @BotFather 创建),一个该机器人担任 管理员的频道,以及一个可从证人处访问的收集器地址——需通过 HTTPS 连接,且位于 私有网络之外(请参阅[部署](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/)部分中的 HTTPS 配置文件)。 在面板中打开**更多工具→扩展功能→独立见证人→配置** 。三个步骤包括 只读访问、您的频道和间隔,然后启动见证人。发布 策略、可选的 HTTP/SOCKS5 代理和自定义机器人 API 地址位于**“高级设置** ”下。该表单 将下载包含此工作区已固定收集器密钥的`witness.json` 文件。 通过“将**访问文件** 另存为”选项下载新 创建的只读令牌,文件名为`witness-token.txt` ;将其与在见证主机上生成的`bot-token.txt` 文件一同放置在该 JSON 文件旁边。收集器绝不会接收机器人令牌。 下载操作不会启动服务或发布消息。任何托管项目的见证都不会 被隐式注册。 ``` python -m tgwitness.witness run --config witness.json --check-config python -m tgwitness.witness run --config witness.json python -m tgwitness.witness fingerprint --config witness.json ``` 第一个命令在不进行网络请求或生成密钥的情况下检查配置文件和密钥文件。 JSON 中的路径相对于该文件;CLI/环境路径相对于 工作目录。 将见证指纹保留在其主机之外。收集器的 “最后轮询”指示器仅用于确认请求;发布情况由 Proof 报告,或通过 见证日志和频道进行核查。 如果控制面板位于 SSH 隧道之后,请仅通过 单独的 HTTPS 主机名(参考[此 Caddy 示例](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example))暴露范围限定后的见证端点。 此时,默认工作区使用 `https://witness.example.org`,其他工作区使用 `https://witness.example.org/profiles/ID`。仍需提供令牌;该虚拟主机不会转发控制面板及其 其他 API 路由。 选择 `all` 可获取定期发布的检查点。五分钟的间隔意味着每个工作区每天约有 288 条记录。`changes`/`problems` 会刻意不发布部分检查结果。 MTProxy 用于数据采集器的 Telegram 客户端。Witness HTTP 轮询和 Telegram 的 HTTPS Bot API 分别使用各自的直接/HTTP/SOCKS5 路由([Bot API](https://core.telegram.org/bots/api))。 **在收集器旁边,使用 Docker**(同一主机——独立进程和密钥,但 同一操作员):将值填入 `.env` 并启动配置文件。 ``` TGWITNESS_WITNESS_TOKEN=tgww_... TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC... TGWITNESS_WITNESS_CHANNEL=@your_witness_channel # another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/ docker compose --profile witness up -d docker compose logs witness # prints the witness key fingerprint ``` 如需使用已发布的图片,请使用`docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`。 **在他人服务器上**(独立托管):将代码库复制到该处,在 `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` 中设置上述三个值 并将其写入 `.env`,然后 ``` docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d ``` 或不使用 Docker: ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel ``` ### 发布到 Discord 见证人可以选择在 Discord 频道而非 Telegram 上发布内容。在 Discord 中,打开 **“编辑频道”→“集成”→“Webhook**”,创建一个 Webhook 并复制其 URL。在 配置面板中,第 2 步选择**“Discord Webhook · 您的频道**”。在见证人主机上, 将该 URL 保存为 `discord-webhook.txt` 旁边 `witness.json`;该数据绝不会到达 收集器。 ``` python -m tgwitness.witness run --collector https://your-collector.example.org \ --token-file witness-token.txt --discord-webhook-file discord-webhook.txt ``` 一个见证者仅有一个发布者:Telegram频道或Discord webhook,不能同时拥有两者。帖子 携带相同的签名声明,且无法向任何人发送通知。超过Discord 2,000 字符限制的帖子将被一行简短内容替换,并附带完整的校验文件 `witness-check.txt` 。每个帖子ID均记录为`witness.posted` 。`verify.py --channel` 仅读取Telegram频道,因此对于Discord,请保留见证者日志:其中包含所有 校验记录。Discord帖子无法为验证者提供外部时间戳。 ### 选项 | 选项 | 环境 | 默认 | 含义 | | --- | --- | --- | --- | | `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | 检查间隔时间,1–1440 | | `--timeout` | `_TIMEOUT` | 30 | 等待采集器和机器人 API 的时间:5–600 秒 | | `--post` | `_POST` | `all` | `all`:每项检查;`changes`:新进展或新问题;`problems`:只有问题和未解答的疑问 | | `--title` | `_TITLE` | `TgWitness witness` | 每个频道帖子的开头语 | | `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | 将收集器密钥固定,而非直接采信首个答案 | | `--proxy` | `_PROXY` | 直接 | `socks5://host:port` 或 `http://host:port` | | `--bot-api` | `_BOT_API` | `https://api.telegram.org` | 机器人 API 地址,例如本地机器人 API 服务器 | | `--data-dir` | `_DATA` | `witness-data` | Witness 密钥和日志 | | `--config` | `_CONFIG` | – | 包含上述任意选项的 JSON 文件 | 收集器地址、令牌和频道来自 `--collector`, `--token` 或 `--token-file`, `--bot-token` 或 `--bot-token-file`, `--discord-webhook-file` 以及 `--channel`, 或 `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` 以及 `_CHANNEL`,这可防止“secret”出现在进程列表中。 配置文件中,选项名称使用下划线分隔,并包含`texts`,该代码会替换频道帖子中的 文字: ``` {"collector": "https://your-collector.example.org", "token_file": "witness-token.txt", "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel", "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness", "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}} ``` `texts`键:`ok`、`key_changed`、`rollback`、`fork`、`invalid`、`no_response`、`collector`、 `records`、`head`。命令行优先于环境变量,环境变量优先于配置文件。 未知选项或文本键会触发见证者显示错误消息并停止运行,而非被忽略。 措辞绝不会影响验证:verify.py 会在每次 发布结束时检查签名令牌。使用 `--post changes` 或 `problems` 时,未发布的检查仍会保留在 见证日志中,且 `verify.py` 会将其列为从未发布;起始记录会标明 政策名称。每项检查仍会出现在日志中,因此发布次数减少仅意味着 Telegram 记录的日期 条目减少,而非检查次数减少。 即使没有频道,Witness 仍会保留其日志。请将见证密钥指纹 (`python -m tgwitness.witness fingerprint`) 保存在其他地方。 ## 多个工作区的公开验证页面 `python -m tgwitness.proof` 该工具最多可同时管理 32 个工作区,并提供一个只读 页面,显示每个工作区的最新签名校验结果。每个工作区在 data 文件夹下都有独立的见证密钥和 日志,以及一个固定的收集器密钥;是否向 Telegram 频道 发布内容可由各工作区自行决定。请从 [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example) 开始: | 字段 | 含义 | | --- | --- | | `title` | 页面标题,1–100 个字符 | | `data_dir` | 与文件相关的 Witness 密钥和日志;默认 `proof-data` | | `interval`, `timeout` | 检查间隔(分钟,1–1440,默认 5);等待时间(秒,5–600,默认 20) | | `workspaces[].id`, `label` | 简短的小写别名和显示名称 | | `workspaces[].collector` | 收集器地址;其他工作区以 `/profiles/` | | `workspaces[].collector_fingerprint` | 必填项,每个工作区各不相同 | | `workspaces[].token_file` | 包含该工作区只读见证令牌的文件 | | `workspaces[].channel`, `bot_token_file` | 可选操作:将每次检查结果发布到频道中 | | `workspaces[].proxy`, `bot_api` | 可选路由和机器人 API 地址 | ``` python -m tgwitness.proof --config proof.json --check-config python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790 ``` 第一个命令会在不建立连接的情况下验证文件和令牌文件。 该页面仅响应 GET 和 HEAD 请求: - `/` 显示所有工作区;若某个工作区在 2.5 个时间间隔内未被检查,则会被标记为过期。 - `/api/proof` 返回的结果与 JSON 相同。 - `/api/proof/` 下载最新的签名声明(`tgwitness-public-proof-v1`): 见证记录编号和哈希值、状态、固定的收集器密钥、检查点、收集 计数器以及频道发布是否成功,由该工作区的见证密钥签名。 - `/healthz` 当工作区的监控器停止运行时,会返回 503 错误。 为该页面设置独立的主机名,例如 [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example)。为了验证,请导出 工作区的见证日志,并 `python -m tgwitness.witness export --data-dir proof-data/ --out witness.zip` ,并按 下文所述使用它。 ## 验证 在“证人”一侧,导出其日志: ``` python -m tgwitness.witness export --out witness.zip # Docker (add -f deploy/compose/compose.witness.yaml on a witness server): docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip docker compose cp witness:/witness/witness.zip . ``` 随后,在任何地方,只需使用收集器的签名 ZIP 文件和公共频道的地址: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel ``` `--channel` 还支持 Telegram Desktop 的导出文件(*导出聊天记录*→JSON生成的 `result.json`)或页面的保存副本;这些文件会检查帖子内容,但不提供 外部时间戳。 `verify.py`会检查见证者日志(链和签名),然后验证**见证者所见到的每个 头部是否属于导出的日志**:该计数处的记录必须具有完全 相同的哈希值。 若某个头部不匹配,则验证失败——说明在 见证者看到日志后,日志被修改了。该脚本还会报告导出后观察到的头部、见证者 记录的异常、失败的响应、导出中存在匹配检查点的时段 (“从 X 到 Y 期间被见证”)以及缺口。后续检查点不会延长这些时段。 结果包含最后一个匹配的记录编号以及没有匹配检查点的 后续记录数量。 仅计入由导出本身密钥签名的响应:若导出由 见证人从未见过的密钥签名,则报告为未被见证;若未使用`--fingerprint`,其 签名者将保持未固定状态。使用`--channel`时,每个签名的帖子必须与见证人日志 逐条匹配:被修改的帖子将验证失败,缺失的帖子会被列出。匹配 令牌可验证内容真实性;日期信息不包含在签名令牌中。 通过实时的`https://t.me/s/…`或`https://telegram.me/s/…`地址,验证者会在 验证时从页面中读取每条帖子的日期。 Telegram 设定该日期; 已编辑帖子的日期不予采用。导出头中某条帖子的最早日期即为 最后一条记录的外部时间,该时间满足证据的最低要求。来自 任何其他来源的日期(例如提供的 `result.json`、已保存的页面或另一个网页 地址)均为元数据,而非独立时间;结果会注明其帖子 日期的来源(`post_date_verification`)。 ### 要求设置受见证的导出边界 若需进行必须包含经见证的最终记录的交接,请添加 `--require-witness`: ``` python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \ --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness ``` 这需要独立保留的见证者指纹、一个不同于 收集器密钥的密钥,以及位于本次导出精确末尾的匹配检查点。仅覆盖较早前缀的检查点 是不够的。暂停收集,让见证者 观察最终状态,并在进一步写入日志之前进行导出;如果日志发生变化,请保留另一个检查点并 导出该状态。仅凭较晚的检查点无法验证较短导出文件的最终哈希值。 当同时提供`--channel`时,若声明的帖子缺失或匹配集为空,将导致此 严格检查失败。若未提供该标志,普通完整性检查仍会报告未被见证的 记录,但不会因此拒绝一个除此之外完整的归档。 请将见证日志及其固定密钥分开保存。在线检查用于验证各检查点之间的连续性; 离线验证则将每个保留的检查点与 导出文件进行比对。没有连续性证明的旧版节点仍保留离线比对结果,并在 报告中不包含在线连续性验证结果。报告按时间间隔列出了见证器的停机时间及 发布失败情况。 ### 每日印章和不可用的时间戳日历 见证人将前一天(UTC)的日志边界进行封装,并将 该签名封装的哈希值提交至 OpenTimestamps。日历提交属于待确认证据; 只有经过独立核查的比特币承诺才能在验证器中获得确认。 如果所有日历均失败,签名印章和未成功的尝试将保留在 日志中。每小时的维护循环会重试该原始记录,包括 在重启或更改日期之后。它最多扫描 32 个印章,最多提交 两个缺失的提交,并且每次循环在重试上最多花费 60 秒。一个 持久光标会轮流处理较旧的印章。保留的提交遵循 现有的证明升级路径。 重试不会重写封印、更改其原始日期,也不会声称 日历系统更早收到该数据。较晚的比特币承诺仍被视为较晚的外部 确认。缺失的证明仍为`none`;待处理的证明仍为`pending`,直到 验证者独立检查它们为止。 --- # Telegram · 时间戳 Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/ 签名检查点采用 RFC 3161 时间戳:向认证机构发送的内容以及如何验证响应。 [Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/) [Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt) 签名检查点采用 RFC 3161 时间戳:向认证机构发送的内容以及如何验证响应。 [TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [证据与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) ![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c) TgWitness 会生成 RFC 3161 请求并验证时间戳授权机构(TSA)的响应。 此手动流程既不选择 TSA,也不提交数据;而证据模式会根据 预定时间表([证据格式](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02))自动完成这两项操作。生成的请求本身 **尚不**构成 **时间戳证明**。 ## 证据的约束力 流程图 · 账户观察 → SHA-256 链和 Ed25519 签名; SHA-256 链和 Ed25519 签名 → 签名检查点; 签名检查点 → 精确字节哈希和随机非ce; 精确字节哈希和随机非ce → RFC 3161 请求; RFC 3161 请求 → 独立 TSA; 独立 TSA → 经 TSA 签名的回复; 签名检查点 → 验证数据、非ce值及明确的CA信任关系; 经 TSA 签名的回复 → 验证数据、非ce值及明确的CA信任关系 · 账户观察 · SHA-256 链和 Ed25519签名 · 签名检查点 · 精确字节哈希和随机非ce · RFC 3161 请求 · 独立 TSA · 经 TSA 签名的回复 · 验证数据、非ce值及明确的CA信任关系 **图表转为文本** 1. 账户观察 → SHA-256 链和 Ed25519 签名 2. SHA-256 链和 Ed25519 签名 → 签名检查点 3. 签名检查点 → 精确字节哈希和随机非ce 4. 精确字节哈希和随机非ce → RFC 3161 请求 5. RFC 3161 请求 → 独立 TSA 6. 独立 TSA → 经 TSA 签名的回复 7. 签名检查点 → 验证数据、非ce值及明确的CA信任关系 8. 经 TSA 签名的回复 → 验证数据、非ce值及明确的CA信任关系 收集器的签名将记录与其密钥绑定。可信的 TSA 响应可 证明某个检查点在 TSA 声明的时间点确实存在。该 检查点随后可绑定日志前缀。此上界时间适用于 该已提交的前缀;单个 Telegram 操作仍保留其记录的事件时间。 ## 操作流程 日志验证器会报告`observed_at`中的倒退步骤和无法解析的值 (若存在于`chronology`中),并在其命令输出中包含警告。它 保留了签名时间戳,并仍会检查其签名。倒退步骤 可能源于时钟校正,因此请结合主机的时钟记录进行审查。 独立时间来源于经过验证的外部时间戳、从 其公开的 t.me 页面读取的见证帖以及 drand 轮次;`--strict` 控制签名者固定和 支持的格式。 记录的 drand 值会在离线状态下接受结构和哈希自一致性检查。 `--check-drand`会将选定的记录轮次与 HTTPS 中继响应进行比对; 结果会显示已比对的轮次数量以及哪些中继作出了响应,而 被比对的轮次则提供了经过认证的下限时间。 1. 通过单独的可信通道保留收集器的密钥指纹;该指纹 可独立于被检查的 ZIP 文件来识别收集器。 2. 在**“导出”→“准备时间戳请求**”中,下载所选工作区的 请求 ZIP 文件。解压 `checkpoint.json`、`timestamp.tsq`、`SHA256SUMS` 和 `README.txt`。请勿更改检查点字节。 3. 选择适合该调查的 TSA。使用其 文档中记载的方法提交 `timestamp.tsq`,若为 HTTP 服务则使用 `application/timestamp-query`。 将原始二进制响应保存为 `timestamp.tsr`,并记录端点、检索时间 及请求结果。该请求包含哈希值和随机数而非消息内容; 网络元数据仍会暴露该请求。 4. 请独立于响应内容获取受信任的根证书,以及任何 所需的中间证书。响应中包含的证书并不仅因 被包含其中而自动成为受信任证书。 5. 通过可信的 TgWitness 安装实例,验证: ``` python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem ``` 如有需要,请添加 `--intermediates tsa-intermediates.pem`。无需 OpenSSL:签名、签名证书引用和证书链都在 Python 中由 `cryptography` 库检查,与 `verify.py --tsa-ca` 使用的代码相同。`openssl ts -verify` 仍可作为专家需要时的独立第二次检查。 1. 在检查点之后导出带签名的日志 ZIP 文件,以便其中包含该前缀。 使用已知的独立指纹进行验证: ``` python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json ``` 这表明导出文件包含带时间戳的前缀。`verify.py`仅从ZIP文件中读取 时间戳收据(证据模式将其存储于此);手动 回复将在步骤5中进行验证,并涵盖截至该检查点的记录。 1. 将 ZIP 文件、检查点、请求、响应、证书链、验证 结果以及交接记录保存在收集器之外。在接收时重复验证。 从已保存的检查点准备请求: ``` python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip ``` 该准备过程会规范化 JSON 格式,并将匹配的检查点包含在归档文件中。 即使输入文件的空格格式不同,也请使用**该归档文件中的检查点字节**进行 TSA 验证。 ## 验证范围 | 检查 | 当前行为 | | --- | --- | | 数据 | 检查点字节的精确 SHA-256 值必须与响应结果一致 | | 请求 | 借助`--request`,可对原始查询和随机数进行验证 | | TSA 签名 | 签名、签名证书及其到明确指定 CA 的证书链按盖戳时间进行检查 | | 采集器签名 | 由日志验证器使用固定密钥进行独立验证 | | 撤销 | 证据模式存储 OCSP/CRL 证据,由 `verify.py` 进行验证 | | 计划提交 | 证据模式,由每个设置目标启用 | `--request` 在技术上是可选的,但省略它将无法验证原始 nonce。在这一完整流程中,结果中的 `request_checked` 必须为 true。链中的每个证书在盖戳时间都必须有效,且签名证书只能用于时间戳。 TSA响应将提交的检查点字节锚定到其声明的时间。 请结合所选模式的采集记录和环境验证结果 核对该结果。证据模式包括比利时政府认证的TSA (`http://tsa.belgium.be/connect`;RFC 3161响应已签名,因此普通HTTP不会 削弱其安全性)。将该提供商的根证书传递给`--tsa-ca`后,`verify.py`会报告一个 符合eIDAS标准的时间戳及其时间戳单位;《欧盟法规》第910/2014号, 第41条第2款,推定其时间的准确性以及关联数据的完整性。 ### 签名证书吊销 每次回复后,证据模式会立即获取 TSA 签名证书的撤销证据: 来自证书 AIA OCSP 地址的 OCSP 响应,否则则从其分发点获取 CRL (最大 4 MiB)。该证据将作为 `checkpoint-N..ocsp` 或 `.crl` 存储在回复旁边,并随回复一同导出。获取失败绝不会 延迟时间戳;`anchor.completed` 记录会将其标记为 `unavailable` 并注明原因。 `verify.py`会检查OCSP响应的签名(由签发者或由签发者为OCSP签名目的提供的响应者证书 生成)、证书ID和状态,并验证 该响应是否在genTime或之后签发,或当时仍处于有效期内(nextUpdate)。对于CRL,它 会检查签发者的签名、相同的时间窗口,并验证序列号是否未被列入。 随后,它将报告`signing certificate not revoked as of