# 安装、验证和更新

Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/installation/

只需一条命令即可完成安装、验证签名和哈希值，以及更新和卸载该工具。

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

[Documentation index](https://phishdestroy.io/tgwitness/zh/llms.txt)

只需一条命令即可完成安装、验证签名和哈希值，以及更新和卸载该工具。

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文档](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [入门指南](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/)

![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

[项目](https://github.com/phishdestroy/TgWitness/blob/main/README.md) · [快速入门](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) · [部署](https://phishdestroy.io/tgwitness/zh/docs/reference/deployment/)

**本页内容**

- [仅需一条命令即可安装](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#install-with-one-command)
- [万物运行之处](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#where-everything-runs)
- [全文搜索设置](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#full-text-search-settings)
- [命令行访问](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#command-line-access)
- [运行前请先验证](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#verify-before-running)
- [更新现有安装](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#update-an-existing-installation)
- [Ubuntu 上的常用命令](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#everyday-commands-on-ubuntu)
- [删除 TgWitness](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#remove-tgwitness)

## 只需一条命令即可安装

该项目的官方下载服务 `get.destroy.tools` 提供带向导的 安装程序及其签名的发布文件。该服务包含一个私有 Python 运行时环境， 并在安装前会检查包哈希值和发布签名。每次发布 都会同步更新入口脚本、哈希值、签名和构建信息； 每次构建还拥有一个不可变的发布 URL。

选择引导式安装程序可快速完成设置，或使用 [GitHub 发布版本、源代码或 Docker](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/) 。这些是该开源项目支持的 安装路径。对于需要在执行前对 特定构建版本进行审批的部署，请使用[运行前验证功能](https://phishdestroy.io/tgwitness/zh/docs/reference/installation/#verify-before-running) ，该功能需配合独立保存的发布密钥指纹和构建版本的不可变 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 中运行。

## 全文搜索设置

[全文搜索](https://phishdestroy.io/tgwitness/zh/docs/reference/search/)（预览版）无需任何配置。其索引会在更新后在 后台自动构建。

| 变量或命令 | 效果 |
| --- | --- |
| `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 环境中。

## 命令行访问

该[命令行](https://phishdestroy.io/tgwitness/zh/docs/reference/cli/)（预览版）用于读取存档文件中的脚本和代理程序。

| 变量 | 效果 |
| --- | --- |
| `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](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/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 签名。 [清单](https://get.destroy.tools/manifest.json)文件记录了软件版本、 精确的 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` | 创建快速隧道链接 / 替换其地址。 |

请参阅[“访问权限](https://phishdestroy.io/tgwitness/zh/docs/reference/access/) ”了解同事令牌、会话和 IP 限制，以及 [“安装程序发布](https://github.com/phishdestroy/TgWitness/blob/main/deploy/installer/README.md#automatic-publication-from-github) ”了解从 GitHub 到 Cloudflare 的发布工作流。

## 删除 TgWitness

本工具不提供卸载程序：只需停止面板并删除其文件夹即可。删除 data 文件夹将永久销毁日志、签名密钥、Telegram 会话以及已保存的文件。 在此之前：

1. 导出所需内容（**导出 → 下载已签名的 ZIP**），并将签名密钥 的指纹和检查点保存在本机之外。若要保留工作区本身，请在停止数据收集后复制 整个数据文件夹。
2. 请从**您的服务器**中删除在**更多工具→扩展功能→“24/7 服务器**”下创建的服务器，或使用 `python -m tgwitness.cloud destroy` 命令删除；服务商将持续对这些服务器进行计费，直至其被删除。
3. 请在 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`）。安装程序不会添加任何服务、计划任务或快捷方式。
