# Telegram · 確保安全

Canonical page: https://phishdestroy.io/tgwitness/zh-Hant/docs/security/

了解會話、金鑰與證據的儲存位置、哪些資料會離開您的裝置、防護措施涵蓋的範圍，以及如何強化系統安全性。

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/zh-Hant/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；只需下載一次即可進行資料恢復 | 異地副本 | 同時取得 bucket 的人可以解密它：請將副本視為已外洩 |

## 保護範圍涵蓋哪些內容

### 已涵蓋

- 紀錄被修改、刪除或重新排序：雜湊鏈或簽名會斷裂。
- 在您將檢查點存到別處之後，日誌被截短或重建：檢查點就不再相符。
- 猜測權杖：256 位元隨機值，固定時間比較，每分鐘失敗 15 次即封鎖該位址。
- 惡意聊天內容：文字一律是文字，絕不當作 HTML；附件以檔案形式下載；面板不從其他網站載入任何內容。
- 資料目錄被竊但金庫金鑰在外部：工作階段和金鑰仍維持加密。

### 交由您決定

- 主權杖可以做任何事。請給他人限定範圍的存取權，主權杖留給自己。
- 請將指紋和檢查點存放在別處。
- 請加密磁碟，收緊權限。
- 在 localhost 以外使用一般 HTTP 會洩漏權杖。請使用 HTTPS 或 SSH 通道。
- 請檢查涵蓋範圍中的空缺，並在您自己的帳戶和來源上測試送達。

[分享案件的存取權](https://phishdestroy.io/tgwitness/zh-Hant/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 要求私人管道，不要寫漏洞利用細節。
