TgWitness / 文件說明

已測試的內容 →

文件說明 / 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;只需下載一次即可進行資料恢復異地副本同時取得 bucket 的人可以解密它:請將副本視為已外洩

保護範圍涵蓋哪些內容

已涵蓋

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

交由您決定

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

分享案件的存取權,可設定權限、到期時間和工作階段限制。

強化安裝安全性

  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 要求私人管道,不要寫漏洞利用細節。