# 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 申请私密渠道，不要写漏洞利用细节。
