TgWitness / 文档

已测试的内容 →

参考 / 设置

Telegram · 初始设置与配置

设置向导、目标、界面层级、连接路径以及账户组共享的设置。

TgWitness / 文档 · 入门指南

入门指南

账户 · 连接 · 访问

将打开一个新的工作区 /first-run。第一个屏幕会询问您想做什么:“仅下载”、“关注聊天”或“案件取证”。选择将确定目标和界面级别:“仅下载”为“简易”模式,其余两项为“标准”模式。级别决定了每个表单显示的字段数量;所有页面均保留在菜单中。 同一屏幕上的更多选项可明确设置级别、主题和时区;语言列表位于向导标题栏中。后续屏幕涵盖连接、Telegram 和聊天内容。在自动检查运行期间,连接路径保持折叠状态,检查失败时则展开。 五阶段进度条会返回已完成的阶段。每个选项一经更改即刻保存至服务器,因此刷新页面后将从同一步骤继续。最后一个屏幕列出了所有选项,并允许您返回其中的任意一个。

语言、IANA 时区、主题和级别均按操作员和工作区分别存储。 默认设置为浏览器语言、设备时区、系统主题以及 “简约”界面。更改语言后,面板会话设置将保持不变。已签名 日志中的时间永远不会改变。

/settings 编辑的记录与向导相同。搜索涵盖主要字段、参数和扩展表单;无需更改级别即可打开隐藏字段。级别只改变显示内容:权限由服务器自行检查。如果某个分区的设置全部高于所选级别,它仍会显示这些设置。采集设置和首次连接由工作区管理员负责。

设置页面是一个列表。顶部的账户卡片打开Telegram 账号。下面每一行列出一个分区及其当前值:账户下有哪些聊天?和连接;记录下有目标、记录和文件、记录保护和通知和异地副本;面板下有语言、时间和外观;专家页面在更多工具下。列表旁的卡片显示推荐值是否已启用,并给出主要值和撤销上一次更改,最近的更改列出最近的编辑。

该部分会在列表上方的新窗口中打开,并拥有独立的地址,例如 /settings/connection。点击后退箭头、关闭按钮、按 Esc 键、点击窗口外部 或点击浏览器的“后退”按钮均可返回列表。选择哪些聊天?后,系统会通过 保存聊天选择功能保留该设置;若关闭窗口时有未保存的更改,系统会先进行确认。 保存操作会保留更多工具 → 来源 → 范围中的来源 类型、被排除的聊天、自定义操作以及新建聊天设置;在此处选中的聊天将从被排除的聊天中移除,并被记录为手动选择的 来源。 每次更改后 ,撤销选项会在 20 秒内显示,且最近更改中的每项记录都可在稍后撤销。 撤销操作仅恢复该条目所更改的设置,包括自定义文件限制。 当后续更改涉及相同的设置时,系统将拒绝撤销请求,且不会 发生任何变化。每次撤销操作都会在日志中生成一条新的settings.changed记录。

级别 字段 侧边栏
简单 仅保留必需功能 首页、聊天、日志、导出、账户和设置
标准 常用设置及说明 在更多工具下新增案例板、来源、访问和文档
专家 所有字段、限制及技术细节 此外,在更多工具下新增了系统地图、网络拓扑、扩展功能、查询存档、参数、账户、系统日志和集成等选项。

各层级的章节名称保持一致。在 侧边栏底部打开外观以更改层级。面板指南对每个章节进行了说明。

目标#

目标 收藏集 文件 外部服务 服务器地址
仅下载 一次性导出从最终设置界面开始;持续收集功能保持关闭状态 照片大小上限为 20 MB 时间戳 自动
关注聊天室 持续 照片和视频最长 60 秒 / 20 MB 时间戳和问题通知 自动
案件的证据 持续 所有文件大小均不超过 1 GB 时间戳、drand、通知 不,隐藏它

建议使用异地备份、Witness 机器人和代码检查作为证据。 存储和通知地址需要先指定目标。与外部服务交互的功能 会要求允许向 Telegram 外部发送请求;若关闭该功能, 系统将同时建议关闭时间戳、通知以及异地备份功能。

修改目标会首先显示差异,且手动修改内容可以保留。与目标 不一致的字段会标记为“由您修改”,并可恢复。 设置修订功能可防止已审核的差异覆盖在另一个标签页中 所做的修改。

连接#

在此处选择路径之前,新工作区将使用 自动 MTProxy · 公开列表 与 隐藏地址 (连接安全性). 该 自动 以下选项是一个单独的设置步骤。

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/<id> 会显示成员列表、待处理事项以及 多个账户共同关注的聊天记录。参见“账户组”。

现有工作区#

包含会话或先前已完成设置的工作区不会显示向导。 页面加载时,其值不会被目标替换。隐藏字段不会 禁用该功能,也不会删除其值。在“设置”中打开首次设置会再次显示 相同的界面;完成这些设置不会启动新的导出或观察,并会明确提示这一点, 且更改后的聊天选项仅在点击保存聊天选项后才会生效。

大小和时间估算基于最多三个选定的聊天,以及每个聊天中最多 20 条消息。 这仅为估算值:它无法预测 Telegram 的限制、特定 服务器的速度,也无法预测每个聊天中的文件内容。