参考 / 设置
安装、验证和更新
只需一条命令即可完成安装、验证签名和哈希值,以及更新和卸载该工具。
只需一条命令即可安装#
该项目的官方下载服务 get.destroy.tools 提供带向导的
安装程序及其签名的发布文件。该服务包含一个私有 Python 运行时环境,
并在安装前会检查包哈希值和发布签名。每次发布
都会同步更新入口脚本、哈希值、签名和构建信息;
每次构建还拥有一个不可变的发布 URL。
选择引导式安装程序可快速完成设置,或使用 GitHub 发布版本、源代码或 Docker 。这些是该开源项目支持的 安装路径。对于需要在执行前对 特定构建版本进行审批的部署,请使用运行前验证功能 ,该功能需配合独立保存的发布密钥指纹和构建版本的不可变 URL。更新下载服务不会自动更新已安装的面板。
Linux / macOS (Bash):
curl -fsSL https://get.destroy.tools/install.sh | bash
在 Ubuntu 服务器上,请以 root 身份运行以安装后台服务。在桌面电脑上, 请以普通用户身份运行。
Windows(PowerShell 或命令提示符):
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
在 Windows 系统上无需管理员权限。子 PowerShell 进程会将您的 终端保持打开状态并显示结果。Python 及其依赖项均保留在安装目录中。
在 Ubuntu 上,请选择“本机”、“临时 HTTPS 链接”或“自有域名”。
安装程序会显示控制面板地址和访问密钥。若需临时链接,请在浏览器中打开
该 HTTPS 地址并输入密钥。若需通过远程
服务器进行本地访问,请从您的计算机(ssh -L 8787:127.0.0.1:8787 user@server)
并打开 http://127.0.0.1:8787。在 macOS 和 Windows 上,本地面板会在您的
浏览器中打开;请保持其终端运行。
在面板中登录 Telegram,并选择要收集的内容。仅安装 并不会自动开始收集 Telegram 数据。
一切运行于此#
get.destroy.tools 是一个用于提供静态文件下载服务的 Cloudflare Worker。它不包含
TgWitness 面板、Telegram 会话或用户证据数据库。它不会被路由到
项目 VPS 上。该应用程序在您执行命令的机器上运行。
| 安装 | 程序 | 数据 |
|---|---|---|
| 以 root 身份使用 Ubuntu | /opt/tgwitness |
系统服务: /var/lib/tgwitness-<installation ID>;请使用 tgwitness paths 以获取确切路径。 |
| Linux / macOS 用户 | ~/.local/share/tgwitness |
data/live 在该安装环境下。 |
| Windows 用户 | %LOCALAPPDATA%\TgWitness |
data\live 在该安装环境下。 |
设置 TGWITNESS_INSTALL_DIR 以选择另一个文件夹。已安装的版本和数据
是分离的。安装程序不会将您的账户、消息或密钥上传至
下载站点。选择 Cloudflare 隧道会将面板流量通过
Cloudflare 传输;使用您自己的域名则会指向您自己的服务器。
当设置 TGWITNESS_TRUSTED_PROXIES 时,控制面板接受来自可信代理的单个 X-Forwarded-Proto: https 请求,以设置安全下载 Cookie。
每次安装都包含 START-HERE.html 和 START-HERE.txt 文件,其中包含本地
路径、命令以及代码库的链接。运行 tgwitness guide 以打开指南。
在 Windows 上,请使用 & "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide 在 PowerShell 中运行。
全文搜索设置#
全文搜索(预览版)无需任何配置。其索引会在更新后在 后台自动构建。
| 变量或命令 | 效果 |
|---|---|
TGWITNESS_FULLTEXT=disk |
默认:索引保存在 search/fulltext.sqlite3 每个工作区的 |
TGWITNESS_FULLTEXT=memory |
无索引文件;每次启动时都会重建索引 |
TGWITNESS_FULLTEXT=off |
不建立索引;仅支持精确文本搜索 |
tgwitness index status |
索引每个工作区的状态 |
tgwitness stop, tgwitness index rebuild, tgwitness start |
从签名日志中重建所有索引 |
管理员在“日志”→“过滤器”→“搜索索引”中的选择将覆盖
该工作区的变量。命令会查找运行它们的安装
的数据目录;在其他地方,请添加 --data-dir 并使用来自 tgwitness paths。
如需完整的乌克兰语词典(GPL-3.0 数据),请在 pymorphy3-dicts-uk 在
该安装的 Python 环境中。
命令行访问#
该命令行(预览版)用于读取存档文件中的脚本和代理程序。
| 变量 | 效果 |
|---|---|
TGWITNESS_URL |
面板地址为 tgwitness search, context, messages, stats 和 export;默认 http://127.0.0.1:8787 当设置令牌时 |
TGWITNESS_MCP_TOKEN |
从更多工具→集成→MCP获取存档连接令牌,该令牌与 MCP 客户端共享;--token-file 则从文件中读取该令牌 |
TGWITNESS_DATA |
当未提供 --data-dir、URL 或令牌时,将直接读取数据目录 |
运行前请先验证#
安装程序会嵌入项目的发布公钥,并在安装应用程序包和依赖项锁定文件之前,检查其 SHA-256 和 RSA 签名。 当必备检查失败时,Bash 和 PowerShell 都会停止执行。初始脚本通过 HTTPS 传输,并带有独立的脱离式签名;下方的命令还 允许您在执行该脚本之前对其进行验证。
公钥为 release-signing.pub。 其 SHA-256 为:
039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d
请保留来自您信任的代码库版本的此指纹。来自 同一下载服务器的校验和可检测到不匹配;独立受信任的公钥 则是验证发布签名所依据的。
请为下文中的验证下载内容准备一个新的、空的目录。
Linux / macOS — 在一个新的、空的下载目录中运行(需要 curl 和 OpenSSL):
curl -fSLO https://get.destroy.tools/install.sh &&
curl -fSLO https://get.destroy.tools/install.sh.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
'039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh &&
bash install.sh
如果 && 如果下载、密钥指纹或签名
验证失败,链条将在执行前停止。如果脚本下载与签名验证之间
发生了发布更新,则需重新下载两者。旧版安装程序会保留其不可变的包 URL。
Windows — 运行前请检查SHA-256:
Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing
Get-FileHash .\install.ps1 -Algorithm SHA256
Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt
将哈希值与 install.ps1 行进行比较。若要进行独立的签名验证,
请使用 OpenSSL(例如在 Git Bash 中)并采用上述相同的公钥指纹:
curl -fSLO https://get.destroy.tools/install.ps1 &&
curl -fSLO https://get.destroy.tools/install.ps1.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
'039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 &&
powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1
Windows 安装程序会通过 .NET 自行验证软件包签名,无需
OpenSSL。这些是独立的 RSA-3072 / SHA-256 签名,而非 Authenticode 签名。
清单文件记录了软件版本、
精确的 Git 提交、不可变的发布 ID 以及每个构建产物的 SHA-256。该页面提供了
指向相应源代码的链接。清单文件和校验和列表也带有独立的
签名(manifest.json.sig 和 SHA256SUMS.txt.sig).
更新现有安装#
新版本发布后,下载站点会相应更新;当您
再次运行安装程序时,已安装的程序将自动更新。该工具不提供无人值守更新程序,也不会自动重启
正在运行的集合。当前安装程序通道处于预览阶段;它遵循
来自 main发布的、经过验证的构建版本,其提交时间可能晚于
GitHub 上最近的编号版本。该页面的版本号来源于 pyproject.toml;其提交
和构建 ID 可区分同一预览版本内的更新。
当该特定提交通过应用程序和
安全检查,且签名包在
Ubuntu 和 Windows 系统上完成身份验证、安装和验证后,系统将自动发布。修改安装程序的拉取请求也会针对站点的本地副本分别运行两次 install.sh
和 install.ps1。在检查运行期间,
或检查失败时,这些命令将继续安装之前已通过验证的构建版本。
构建清单显示当前可用的提交;在预览版更新之间,
版本号本身可能保持不变。
请使用与之前相同的安装文件夹和操作系统用户。在停止数据收集后,备份完整的数据
目录; tgwitness paths 用于标识该数据。已签名的导出文件
并非完整的安装备份。
Ubuntu 根目录安装位于 /opt/tgwitness:
curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start
安装成功后:
/opt/tgwitness/bin/tgwitness restart
/opt/tgwitness/bin/tgwitness status
/opt/tgwitness/bin/tgwitness open
对于 Linux/macOS 用户,请使用其原始 TGWITNESS_INSTALL_DIR 或
默认配置,并再次运行第一个安装命令。更新前请关闭前台
面板,更新后重新启动该面板。对于已配置的 Linux 用户
服务,请运行其 tgwitness restart 命令。
Windows:关闭正在运行的面板,重新运行 Windows 安装命令,
然后在 bin\tgwitness.cmd 同一安装环境。安装程序会保留数据、
会话、访问设置和签名密钥。只有当
新环境通过检查后,它才会切换启动器;安装失败时,
原启动器将保留不变。请保留升级前的备份,以应对存储格式的变更。
Ubuntu 上的常用命令#
| 命令 | 结果 |
|---|---|
tgwitness open |
当前面板 URL 和访问密钥。 |
tgwitness paths |
精确的程序、数据和指南路径。 |
tgwitness guide --print |
离线操作指南。 |
tgwitness status / tgwitness logs |
可用性/服务日志。 |
tgwitness stop / tgwitness start |
停止/恢复服务;保留数据。 |
tgwitness token rotate |
替换管理员密钥并结束浏览器会话。 |
tgwitness tunnel off |
禁用公共快速隧道;保留本地面板。 |
tgwitness tunnel on / tgwitness tunnel restart |
创建快速隧道链接 / 替换其地址。 |
请参阅“访问权限 ”了解同事令牌、会话和 IP 限制,以及 “安装程序发布 ”了解从 GitHub 到 Cloudflare 的发布工作流。
删除 TgWitness#
本工具不提供卸载程序:只需停止面板并删除其文件夹即可。删除 data 文件夹将永久销毁日志、签名密钥、Telegram 会话以及已保存的文件。 在此之前:
- 导出所需内容(导出 → 下载已签名的 ZIP),并将签名密钥 的指纹和检查点保存在本机之外。若要保留工作区本身,请在停止数据收集后复制 整个数据文件夹。
- 请从您的服务器中删除在更多工具→扩展功能→“24/7 服务器”下创建的服务器,或使用
python -m tgwitness.cloud destroy命令删除;服务商将持续对这些服务器进行计费,直至其被删除。 - 请在 Telegram 的“设置”→“设备”中结束每个账户的会话。删除 文件并不会在 Telegram 端注销该会话。
Ubuntu 根目录安装。请注意数据文件夹,停止服务,然后删除 该服务、相关文件夹及快捷方式:
/opt/tgwitness/bin/tgwitness paths
/opt/tgwitness/bin/tgwitness stop
systemctl list-unit-files 'tgwitness-*'
systemctl disable tgwitness-<ID>
rm /etc/systemd/system/tgwitness-<ID>.service
systemctl daemon-reload
rm -rf /opt/tgwitness /var/lib/tgwitness-<ID> /usr/local/bin/tgwitness
Linux 或 macOS 用户安装。关闭面板。已配置的 Linux 用户服务
可通过 systemctl --user disable --now tgwitness-<ID>;其单位为
~/.config/systemd/user/。随后删除 ~/.local/share/tgwitness (或您的
TGWITNESS_INSTALL_DIR) 以及 ~/.local/bin/tgwitness 快捷方式。
Windows。关闭面板并删除 %LOCALAPPDATA%\TgWitness (或您的
TGWITNESS_INSTALL_DIR)。安装程序不会添加任何服务、计划任务或快捷方式。