TgWitness / 文档

已测试的内容 →

本页面部分内容仍为英文:英文原文在翻译后发生了变更。

参考 / 收集

Telegram · 面板指南

面板的每个界面:聊天、日志、来源、导出、扩展功能、保护模式和代码检查。

TgWitness / 文档 · 入门指南

入门指南

初始设置与配置 · 账户 · 导出与验证 · 案例报告

每个界面的功能、其向签名日志写入的内容以及详细 指南的位置。面板每次仅显示一个工作区:一个拥有独立 消息源、日志和签名密钥的 Telegram 账户。顶部栏中的账户选择器用于切换 工作区。地址中包含工作区信息(?ws=…);当地址、 选择器与已加载的账户不一致时,操作将保持被阻止状态。

使用比较收集方法在实时 观察、完整历史记录、新账户/聊天记录导出以及已保存记录移交之间进行选择。 导出页面在下载控件上方包含与上述相同的比较功能。

本页内容

快速入门#

侧边栏将六个日常板块整合在一起:首页、聊天、日志、 导出、账户和设置。您无权访问的板块 将被省略。更多工具包含调查和管理工具。 打开侧边栏底部的外观以更改语言、主题、 时区或界面级别:

级别 侧边栏中的部分
简单 每日章节
标准 此外,在更多工具下还包括案例板、来源、访问和文档。
专家 此外,在更多工具下还包括系统地图、网络拓扑、扩展功能、查询存档、参数、账户、系统日志和集成。

各层级的章节名称保持不变。层级仅用于隐藏章节。隐藏功能仍会正常运行,且服务器会自行检查 每一项权限。层级、语言、主题和时区会按 操作员和工作区分别保存;请参阅设置。

使用侧边栏顶部的转到功能(Ctrl+K,Mac 上为 ⌘K)通过 #number 查找 聊天记录、参数或日志记录。方向键用于移动,Enter 键打开, Esc 键关闭。

顶部栏包含:

  • 通知:根据日志生成的故障和聊天变更信息。 “全选已读”会清零计数器,“通知规则”可打开规则设置。 在 “扩展功能” → “通知” 中可设置将通知发送至 Telegram、Discord 或电子邮件。
  • 一个包含开始/暂停控制、连接设置以及 Telegram 健康诊断、事件接收、数据源和附件队列的收集状态菜单。 在窄屏上,可通过活动图标打开该菜单。
  • 锁定:关闭当前浏览器中的面板。Collection 仍会在服务器上继续运行。

版本和保护模式位于“外观”下;请参阅保护模式。 安装程序会在登录后打开主页;显式链接会打开其请求的 屏幕。聊天范围内的审阅者会打开聊天。地址 /home, /case-board, /pseudo-secret 和 /network-topology 也会打开相应的屏幕。 未知页面地址将返回 HTTP 404 状态码,并提供附近的页面建议。

演示工作区包含虚构的消息,且绝不会连接到 Telegram。 任何可能更改真实工作区的操作都会被拒绝。

系统地图显示了该部署的账户路径、代理状态、 套接字端点、加密保险库、证据服务以及被观察到的网络请求。 选择一个账户以查看其路径。可用但已禁用的服务仍会显示。

从这里开始#

当您切换账户 或重新登录时,概览页面会清除该账户对应的图表和摘要。加载状态、读取失败以及没有保存记录的时段 各有不同的状态。重试会重复执行失败的读取操作;如果服务器要求等待, 则会显示下一次尝试的时间。刷新失败时,系统会保留同一工作区中 上次成功获取的数据,并标注其最后更新时间。

每个已连接的账户都会分别显示“收集器心跳 ”和“收到的最后一个事件 ”。前者表示收集器的活动状态;后者表示收到的最新 Telegram 更新。如果数据源处于静默状态,后者显示的时间将保持不变,而 收集器仍会继续运行。打开“收集状态”菜单,可查看连接、数据摄入、 数据源和附件的诊断信息。

选择一项任务。导出我的账户会下载该账户当前可读取的内容。 跟踪调查会记录您所选聊天中的新消息、观察到的编辑操作以及删除通知。 当观察处于暂停状态时,“聊天”、“日志”和“来源” 会显示设置卡片:连接账户、选择来源、开始观察。 当目标为案件证据,或处于“见证”、“案件准备”、 “GitHub 验证”或“最高保护”模式时,开始监视 会首先读取 Telegram 的会话列表(但当严格:仅读取选定聊天模式开启时除外)。 如果还有其他会话已登录,面板会显示 其数量,并提供仍要开始或打开该账户的会话选项。其他 目标和模式则无需此提示即可开始。 目标提示将一直显示在此页面,直到您 回答或跳过它。否则,将打开一个新工作区并进入首次设置。

聊天#

已保存的对话,默认仅限查看。

聊天行显示收集状态、待处理和失败的文件下载、初始历史记录 加载情况,以及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 响应期间查询或页面 发生变化,加载完成后会更新已保存的日志,而不会 替换较新的视图。自动加载失败时,系统会提供重试选项。 要加载所有已启用的消息源,请使用消息源→完整历史记录。
  • “导出聊天”功能将整个可见聊天记录下载为一个已签名的 chat.json 且 chat.html文件。多个关联账户可协同完成此任务:每个账户下载其对应的 消息编号范围并对其部分进行签名,而发起 导出的账户则对整个存档进行签名。参见“导出单个聊天”。
  • “人员”列表显示了该聊天中所有保存了消息的用户。人员个人资料默认处于 关闭状态,因为它们涉及第三方个人数据。当某次聊天中 启用该功能时,个人资料会显示姓名和用户名历史、Telegram标记、头像哈希值、活动记录、 谁回复了谁、其他被观察的聊天,以及被提及的钱包、手机号、用户名 和链接。 每项信息都指向其对应的记录。导出个人资料会保存一个签名文件, 可选地设置密码ZIP;关闭个人资料会删除该文件。参见 “人员个人资料”。
  • “将所有作者汇集 到同一标签页”功能会向Telegram请求获取聊天中所有已保存消息的用户的个人资料、简介、 头像、礼物和简介链接。在频道 或超级群中,其他已连接的账户可以共同参与此操作。每个选中的账户都会 被预留用于该集合,完整收录该用户信息,并通过该作者 其中一条已保存的消息联系到该作者。 正在处理其他任务的账号不会被干扰, 待其空闲后即加入。若无法联系到某位作者,则返回聊天室的自有账号。 进度条显示百分比、剩余时间及各账号的贡献份额;点击暂停 可释放账号。每条已保存的记录都会标注阅读该记录的账号,且 日志会记录每个账号的加入和退出时间。
  • “保存个人资料”功能现可记录聊天或机器人个人资料的快照:描述、 成员、邀请链接、机器人命令。

只读、发送和密钥#

消息上方有两个开关,用于保护账户和读者:

  • 打开聊天时,“只读”模式处于开启状态。 若要发送消息或点击机器人 按钮,请将其关闭。每次操作时都会提示“以 @account 身份发送?”或“以 @account 身份点击此机器人按钮?”,这表明聊天成员会看到该操作,且该操作将进入已签名的 日志。选择“在此聊天中 10 分钟内不再提示”可暂时跳过该提示。在“案件证据”目标中,无论是面板还是 API,发送功能均处于关闭状态。
  • “隐藏机密”功能可隐藏看似密码、登录码、API 密钥或 哈希值、机器人令牌、会话字符串、私钥、JWT 或支付卡号 (卡号会通过 Luhn 和校验)的内容。点击“显示”将揭示一个值;该揭示操作 会被记录在日志中。为该浏览器关闭隐藏功能的操作也会被记录下来。 仅显示内容发生变化:原始记录和所有导出文件均保留完整文本。

将选中的消息保存为图片#

在云端聊天中,选择“选择”,勾选消息,然后选择“另存为图片”。 要截取整个聊天记录,请在聊天工具菜单中选择“将聊天保存为图片”;该功能 会加载最近保存的最多 2,000 条消息,并提示哪些较早的消息未被包含。 预览界面提供“浅色”、“深色”和“经典”三种样式;对于较长的聊天记录,请使用“上一页”和“下一页” 进行截取。下载带签名的 ZIP 文件,该文件将每页保存为 PNG 格式,并附带 pages.sig.json 以及 README.txt (已签名的聊天图片)。 最多可选择 50 条消息,且所有消息必须仍位于已加载的聊天 窗口中。操作面板会提示您缩减过大选择范围,而非默认 省略消息。

每页末尾都包含一个真实性块:其中显示的日志记录编号、 聊天记录、渲染时间、工作区密钥指纹、该 verify.py 该页面的 命令,以及一个包含聊天记录、密钥和渲染时间的二维码。签名需要导出 权限,并会在日志中添加一条 export.image_attested 日志条目。

该图像包含已保存的文本、作者、消息编号、UTC时间、回复编号、 附件标签以及已保存的编辑/删除状态。它显示的是最新保存的文本 及其保留的版本数量;附件内容、内联按钮、 点赞和早期文本版本均未显示。 长消息将延续至 下一页,并显示其消息编号和分段数量。每页均标明 其内容源自已保存的消息。该 PNG 文件仅为视觉摘要;在移交签名记录及附件时, 请使用存档文件及其验证码。

渲染过程在浏览器中完成,无需向Telegram发送请求;在签名时, 仅将每页的SHA-256哈希值和记录编号发送至控制面板。现有的密文遮罩功能可保护文本、作者姓名和 附件标签。预览窗口会保留快照直至关闭,并在控制面板 锁定或切换工作区/聊天时清空。已签名的日志和报告选择保持 不变。有关完整报告导出的信息,请参阅病例报告。

转发消息#

关闭该聊天的只读状态,然后在某条消息下方选择转发,或者 选择并标记最多 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;参见 “导出与验证”部分。

来源#

该工作区会记录哪些对话,以及从中保留哪些内容。更改 仅适用于未来的活动;已保存的记录保持不变。

“刷新聊天列表”功能会读取该账户的聊天记录和文件夹,但不会下载消息内容。

范围#

  • 该账户记录的内容 :选定的聊天 (仅您添加的聊天), Telegram 文件夹 (该账户的一个文件夹,包括后续添加到其中的 聊天)或 完整账户 (所有聊天,以及每个新出现的聊天、群组、私聊或 机器人)。调查模式 适用于专用账户:它记录 该账户所见的一切内容、其自身发送的消息和按键操作,并立即保存每个新 聊天的配置文件及先前可见的消息。 专用账户指南 解释了为何绝不能使用你的主账号。
  • 严格模式:仅读取选定的聊天(仅限选定聊天,默认关闭)将停止读取 Telegram 的服务通知、会话列表以及已启用该模式的聊天中的早期消息, 同时保持敏感内容设置不变,并跳过电话通话 更新。参见严格选定聊天。
  • 源类型将文件夹模式和整个账户模式限制为频道、群组、私聊 和机器人。自有操作会添加该账户自身的消息、编辑操作以及 回复时的键盘按键记录。
  • 当出现新的聊天或机器人时:保存其资料,并保存最多(根据所选数量) 其最新的可见消息。
  • 已选聊天被标记为推荐。点击丢弃更改将表单恢复到 已保存的范围,直到您点击保存范围。

伪秘密聊天是内置的秘密聊天界面,安装其协议模块后, 只需点击一个按钮即可为每个账户启用。云端监控 和聊天记录使用各自的设置。 当 TgWitness 未 运行时,系统不会记录任何内容;重启后,它仅会补录 Telegram 仍能返回的数据,而 报告中会显示数据缺口。超出聊天列表限制(除非在 “参数”中更改,否则为 1,000 个对话)的聊天记录,将在其下次变为活跃状态时被添加进来。在 其他应用中点击的内嵌机器人按钮不会被记录;但机器人的回复会被记录下来。

涵盖的聊天#

可按状态(已启用、已暂停、优先级、已排除、未确认 访问、已忽略)和类型进行筛选,然后对选定项执行操作:启用、暂停、标记或移除 优先级、从范围中排除或删除。状态图标仅显示当前状态;操作 位于每行菜单中,并附有功能说明。 暂停和排除操作需要 确认,批量操作时同样如此。删除来源时需输入其名称,并会删除其人员 个人资料;其保存的记录仍保留在日志中。

若某来源未显示在该账户的聊天列表中,则表示该来源正在接收更新,但未出现在聊天 列表中,同时记录仍在持续到达;否则,访问状态未确认。“可用 聊天”会添加通过“添加所选”或“添加所有匹配项”操作选中的聊天。

完整历史#

将每个已启用来源的可用历史记录加载到“聊天”和日志中。 进度在重启后仍会保留;附件遵循您的媒体设置。参见 来源历史记录。

记录#

  • 选择要保留的变更:新消息、编辑、删除通知、 可见的点赞、加入和退出。预设会更改表单; “保存记录设置”会应用该预设。重新启用某类别不会恢复 已错过的事件。
  • 在可能的情况下保留媒体文件:下载单个文件大小不超过指定限值的附件,设置 每种类型的限值范围为 1 至 2,000 MiB,并限制视频时长(以秒为单位,0 表示无限制)。 每次下载尝试都会记录结果。
  • 重新检查:每隔几分钟检查一次优先级聊天,其他聊天则很少检查,因此该账户 不会触发 Telegram 的 FloodWait 限制。设置为 0 可关闭该组。在列表中用星号标记优先级聊天; 每次检查的聊天数量以及聊天之间的暂停时间可在 “参数”中设置。参见集合。
  • “保存”栏会显示这些设置是否与推荐设置一致。点击返回 推荐设置将填入推荐值;点击保存录制设置将应用这些设置 ;点击放弃更改则恢复已保存的设置。

导出功能#

“下载”用于准备文件;“构建报告”用于选择报告的显示样式。

内容 用途: 指南
账户导出 该账户当前可读取内容的最新快照 账户导出
共享副本 一个已完成的账户导出功能的精简版 披露声明
已签名 ZIP 日志、报告、附件和验证工具,均位于固定的日志边界内 导出与验证
HTML、PDF、JSON 报告 一份密封的可读报告 案例报告
JSONL、CSV 带有签名的原始记录;一个支持公式的电子表格 导出与验证
交接摘要 仅包含收件人所需的聊天记录、时间段和联系人 证据
聊天记录导出 一个已签名的聊天记录 chat.json 以及 chat.html 导出一个聊天记录
  • 使用密码对上述下载文件进行加密(12 个字符或以上)会保存一个 AES-256 ZIP,该文件可由 7-Zip 或 WinRAR 打开。其中的已签名文件保持不变。 密码不会被存储。
  • 导入此工作区的会话密钥时,账户导出和聊天 导出对话框中会有一行提示:该密钥的副本可能存在于 Telegram 的 会话列表之外。同一行还提供了创建独立授权选项, 点击后将打开登录页面并默认选中该选项。参见 账户部分。
  • 失败或被取消的聊天导出将保留其已保存的范围。捕获或导出 单个聊天后,系统将提供继续导出和重新开始选项;请参阅 导出单个聊天。
  • 虽然聊天记录导出功能显示为下载迄今已读的消息,但实际上保存的是一个 ZIP 文件,其中各页面 在写入时即被签名;其下方的行显示了已签名消息的数量。
  • 预先准备的导出包会保留最多 20 个文件(每个文件大小不超过 2 GiB),外加最新的一个文件,以便 重复下载;每个文件都附有相应的 SHA-256 校验值,供接收方进行比对。每张卡片都会注明文件的内容: 已签名存档(完整的日志及其记录数量)、报告、日志记录或交接 摘要,案件标题和ID,以及生成该文件时选定的报告内容(聊天记录、选定消息、日期)。当列表包含多种类型时, 点击显示可将列表筛选为单一类型。
  • 当浏览器拒绝显示保存对话框时,该面板将回退为普通下载。
  • 您的签名身份会显示密钥指纹。“保存检查点”和 “下载已签名的运行收据”功能可为您提供存储在收集器之外的记录。 “准备时间戳请求”会在不联系任何服务的情况下构建一个 RFC 3161 请求。

设置、账户和连接#

  • 设置:目标、连接、记录内容及界面。请参阅 首次设置和配置。
  • 账户:每个工作区及其状态、消息源、事件和附件队列。 可通过 需要关注、收集、离线或已暂停 或 未连接 进行筛选,暂停或恢复选定操作,批量导入账户文件并管理 群组。参见 账户。
  • 账户:登录及该账户的连接路径。直接连接、WireGuard 配置文件、您自己的代理、公共 MTProto 池或 WARP;准备并检查路径, 然后将其应用于该账户、一个组或所有账户。 参见 连接和代理及代理。 账户安全→此账户的会话列出了 Telegram 的会话,可结束其中 一个或所有会话,并且——对于在此工作区中创建的密钥——当 Telegram 允许时,提供将其设为 唯一会话选项,该操作将在24小时后 后自动重复该操作,并显示其设置的一次性双步验证密码。参见 账户安全。 账户安全→见证探测会使用第二个工作区来验证该 会话是否能实时接收更新;参见见证探测。

批量暂停和恢复操作会将已确认的选择保留在最初 打开该操作的会话中。在等待确认或执行期间,控件将保持禁用状态; 切换工作区或锁定面板将取消剩余的命令。 执行完成后,面板会刷新账户状态。失败的请求将 被报告为请求失败,因为服务器可能已经应用了该命令。 命令不会自动重试。

附加功能#

可选:只需一个账户和来源即可开始收集。只有您 选择的选项才会打开其设置,系统不会自动连接任何内容。顶部的“ 保护级别”卡片显示当前的保护模式。

卡片 新增功能 指南
存储与磁盘空间 备份、将旧文件移至您的云端、一份无法被删除的证据副本 存储
目标与保护级别 针对您的目标及两个量表的建议设置 下方
通知 问题、已修改的消息和每日摘要;您专属的控制机器人 下方
证据与备份 时间戳、更多见证人以及加密的异地副本 下方
服务器全天候运行 一个不支持 SSH 的云服务器,可通过控制面板进行创建和删除 高可信度
独立见证者 已签名的检查结果将发布到您的 Telegram 频道或 Discord 上 见证人
代码检查 将正在运行的程序与 GitHub 上的公开提交进行比较 下方

目标与保护级别#

四个问题:

  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 可以使用它;对话内容保存在工作区中。如果另一个应用程序已经接收其命令,请使用一个单独的 机器人。请参阅 通知和操作员机器人。

证据与备份#

  • 独立时间戳仅将每个签名检查点的 SHA-256 值发送至 RFC 3161 权威机构和 OpenTimestamps 日历,间隔为每 5 至 1,440 分钟。接收方需要 此类第三方时间戳作为证据的最低要求。Anchor 目前 正在运行一个通过。参见时间戳。
  • 更多见证记录(在被选中前均处于关闭状态):最新一轮的 drand 轮次、Telegram 的 已登录设备列表(不含 IP 地址),以及 Cloudflare Gateway 记录的服务器 DNS 查询日志。参见可选记录。
  • 加密备份会将日志、文件、检查点和聊天记录导出到 S3兼容存储(Wasabi、Amazon S3、Backblaze B2、Cloudflare R2、MinIO)。 所有内容都会先在此机器上进行加密。请下载加密密钥并将其 单独保存:没有该密钥,备份副本将无法被读取。在“治理”或“合规”模式下启用“对象锁定”功能, 可确保对象在设定的天数内不会被删除。参见异地备份。

代码检查#

检查已安装的程序是否与已发布的版本匹配。

  1. 输入一个 GitHub 仓库(官方仓库已预填)以及一个标签、分支或提交。
  2. “Check now” 通过该工作区的外部请求路由,向 GitHub API 查询 该提交的文件列表。它将每个被测程序文件的 git blob ID 与该提交进行比对。即使在 Windows 环境中检出时换行符已被转换,仍能匹配成功。
  3. 结果列表会显示已更改、新增和缺失的文件(每类最多 50 个),并保存为 一份 source.checked 日志记录。

结果仅在运行中的程序文件未发生变更时才视为有效: 更新后请重新检查。无需令牌,且仅支持公共仓库; 聊天记录和凭据不会被上传。匹配操作用于识别磁盘上的代码。这并非 硬件认证;有关硬件认证,请参阅 Phala Cloud。

保护模式#

版本号旁边的切换器显示所选模式以及 18 层 保护层中有多少层处于激活状态,例如 🟠 Witnessed 9/18。在 “扩展功能”→“保护级别”中切换模式可打开选项。每种模式描述一个目标,并列出 尚缺的内容;记录、签名和保存的设置在所有模式下均保持一致。

模式 用于 新增功能
🟢 简单 监视聊天并保留副本 “聊天”功能用于导出日志和聊天记录;签名操作在后台运行
🟡 已签名 向平台、主机或滥用处理部门提交报告 签名存档、日志检查、检查点、交接摘要
🟠 已见证 可能有人声称记录被篡改的情况 一个独立见证人发布经签名的日志头
🔴 符合法庭要求 供律师、警方或法院使用的证据 时间戳、加密的异地副本、报告中的案件详情
🟣 GitHub 认证 任何人都能验证其软件的记录 代码检查与 GitHub Actions 捕获
⚫ 最大值 针对资金雄厚的对手展开的高风险案件 一个全天候运行的密封服务器、一个隐藏的 IP 地址,以及全部 18 层防护

各层结构:每条记录均经过签名并链式连接;带签名的运行收据;通过 SHA-256保存的附件;带签名的检查点;重新检查;问题警报;只读见证访问; 按计划进行的见证检查;RFC 3161 时间戳;OpenTimestamps 证明;经过验证的 最新时间戳;加密的异地副本;报告中的案例详情;匹配代码 检查; Telegram 永远不会看到这台机器的 IP;外部请求通过代理进行;副本上的 对象锁定;一个封存的、包含提供商记录的服务器。处于关闭状态的层设有 “设置”选项,点击后会打开其表单。选择较低模式时会要求确认,且 不会删除任何内容。

更多工具#

附加功能 → 独立捕获:连接一个 独立的浏览器或AyuGram记录器,固定其签名密钥,选择捕获选项, 开始/暂停,拍摄快照并下载经过验证的签名存档。每个记录器都有 独立的手动登录、路由、日志和密钥。这两条连接初始状态均为禁用。 请参阅英文版《独立捕获指南》。

  • 查询存档:搜索已保存的观察记录,审查来源,然后决定 是否将其发送给 AI 模型。参见存档分析和 本地 OCR 及转录功能。
  • 参数:数据收集的限制与频率、复核、下载、配置文件、 通知和导出。支持按名称搜索,显示 仅显示已更改的 中的值,并使用 恢复默认值… 将 默认值保存为草稿。保存参数 会从下次使用时起应用这些值, 每次更改都会生成一条日志记录。
  • 访问权限:审阅员、分析师和操作员拥有各自独立的令牌,访问范围仅限于选定的 工作区、聊天群组及权限。详见“访问权限”部分。
  • 系统日志 :该进程自启动以来执行的操作(连接、代理变更、 登录、登录失败、设置变更),其中 IP 地址已被隐藏。“跟随新行 ”功能可将最新一行始终保持在视图中。消息仅保存在日志中。
  • 集成:AI 服务提供商、只读 MCP 连接以及 已签名的 webhook。
  • Case Board:位于证据旁边的团队私有笔记、书签和片段。参见 Case Board。
  • 文档:调查模式抽屉。当 正在记录的会话处于记录状态时,它会移至主侧边栏。
  • “导出”中的 GitHub Actions capture:从您的分支中捕获的一段聊天记录。参见 密封捕获。