文档 / 14
Telegram · 确保安全
什么会离开您的机器,每个密钥能打开什么,哪些由保护措施覆盖、哪些由您负责。
127.0.0.1默认面板地址
256 位随机面板令牌
0内容分发网络(CDN)、分析工具或远程字体
Ed25519每条记录均附有签名
所有内容的归宿
采集器、面板和每条记录都留在您的机器上。默认只连接 Telegram;其他一切都是单独的开关。
06 / 机器留下的痕迹您的安装
您的计算机或服务器
面板127.0.0.1:8787 · 承载令牌
收集器每个工作区仅限一个 Telegram 客户端
数据目录
日志SQLite · 哈希链 · 签名
媒体文件名采用 SHA-256 哈希值命名
VaultFernet · 会话、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 隧道。
- 请检查覆盖范围中的空缺,并在您自己的账户和来源上测试送达。
共享案件的访问权限,可设置权限、有效期和会话限制。
强化安装安全性
已完成 0/8
- 请使用专用的 Telegram 账号,绝不要用主账号。
- 请将控制面板保留在 127.0.0.1 上。远程访问只通过 HTTPS(内置 Caddy)或 SSH 隧道。
- 请加密存放数据目录的磁盘。
- 将数据目录限制为仅服务账户可访问(Unix 上为 0700,Windows 上为文件夹权限)。
- 在服务器上将保险库密钥保存在别处:首次启动前设置
TGWITNESS_VAULT_KEY_FILE。 - 将指纹和检查点保存在另一个系统上,在另一台主机上运行见证人。
- 切勿将
data/、会话密钥、panel-token.txt或保险库密钥上传至 GitHub 或聊天群组。 - 请勿在反向代理服务器上记录
Authorization标头或请求正文。
我可以更改面板令牌而不丢失数据吗?
可以,它只能打开面板。停止 TgWitness,删除 panel-token.txt,重新启动。日志、会话和密钥都会保留。如果设置了 TGWITNESS_TOKEN,则以该值为准,而不是文件。
报告漏洞
在 GitHub 上使用 Security → Report a vulnerability。提供版本、影响以及使用虚构数据的最小复现。切勿发送凭据、账户文件夹或真实证据。如果私密报告已关闭,请开一个 issue 申请私密渠道,不要写漏洞利用细节。