# Telegram · 導入

Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/deployment/

TgWitnessは、Windows、Linux、macOS、またはDocker上で、HTTPS経由でサービスとして実行でき、バックアップや更新機能も備えています。

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

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

TgWitnessは、Windows、Linux、macOS、またはDocker上で、HTTPS経由でサービスとして実行でき、バックアップや更新機能も備えています。

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![展開と復旧](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

**英語** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [ウクライナ語](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [ポルトガル語（ブラジル）](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Türkçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [アラビア語](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [ウルドゥー語](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [ヒンディー語](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [インドネシア語](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [簡体字中国語](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md)

## インストール方法を選択してください

ポータブルパッケージをご利用の場合は、GitHub Releasesから`TgWitness-<version>-windows-amd64-portable.zip`を解凍してください。 その他の方法をご利用の場合は、ソースのZIPファイルをダウンロードして解凍するか、リポジトリをクローンし、 プロジェクトディレクトリから以下のコマンドを実行してください：

| インストール | はじめに | バックグラウンドで動作しますか？ |
| --- | --- | --- |
| Windows用ポータブルパッケージ | `TgWitness.cmd` | いいえ、ウィンドウは開いたままにしておいてください。 |
| Windowsネイティブ版 | `Start.cmd` | いいえ。バックグラウンドでの使用には、オプションのログオンタスクをご利用ください。 |
| Linux/macOSネイティブ | `sh start.sh` | いいえ。バックグラウンドでの実行には、systemd または launchd を使用してください。 |
| サポートされているあらゆるホストでのDocker | `docker compose up -d --build --wait` | はい、Dockerデーモンが実行されている間は可能です。 |
| Windows 版 Docker ヘルパー | `scripts\Docker.cmd` | はい。このヘルパーは、Webサーバーの稼働状態を確認します。 |
| Linux/macOS 用の Docker ヘルパー | `sh scripts/docker-start.sh` | はい。このヘルパーは、Webサーバーの稼働状態を確認します。 |

第三者が確認可能なクラウドサーバーについては（ プロバイダーのAPIを通じて作成され、SSHを使用せず、Cloudflare Tunnel経由でのみアクセス可能なもの）、 [高保証デプロイメント](https://phishdestroy.io/tgwitness/ja/docs/reference/high-assurance/)をご覧ください。

ネイティブ起動時には、プライベートな`.venv`が生成され、ピン留めされた依存関係がインストールされます。 Dockerは、ホスト側のPythonを必要とせずに、イメージ内でこれらをビルドします。初回 セットアップにはインターネット接続が必要です。 Python 3.11 以降が見つからない場合、`Start.cmd` は、 現在の Windows ユーザー向けに Python 3.12 をインストールする前に確認を行います（winget を使用、それ以外の場合は Python Software Foundation の署名を確認した上で python.org の インストーラーを使用）。管理者権限を要求することは 一切ありません。Docker および OS サービスは引き続き前提条件となります。

ネイティブおよびポータブルインストールでは、フォルダ内の`data/live`を使用します。Dockerでは、`tgwitness-data`という名前のボリュームを `/data`で使用します。これらは、データディレクトリ全体を意図的に移行するまでは、 別々のインストールとして扱われます。新しいDockerコンテナがネイティブの アカウントを自動的に検出することは期待しないでください。

## インストール要件

ネイティブインストールには、`venv`および`ensurepip`を含むPython 3.11以降、 最初の依存関係のインストールに必要なインターネット接続、および `.venv`用の書き込み可能なプロジェクトディレクトリが必要です。同梱のパネルには、Node.jsやフロントエンドのビルドは不要です。ランチャーは 通常のOSアカウントから実行してください。TgWitnessでは管理者/root権限は必要ありません。

- **Windows：**`Start.cmd`は、まず`py -3`、次に`python`、さらにユーザーごとのデフォルトのインストールフォルダおよび 「Program Files」フォルダを順に確認し、バージョン3.11以降が必要です。いずれも見つからない場合は、 前述のユーザーごとの自動インストールが提案されます。`py -3 start.py`も動作します。 ポータブル版パッケージは、Pythonを一切必要としません。
- **Linux：**`start.sh`が`python3.13`、`python3.12`、`python3.11`、`python3`、および `python`を試行し、該当するものがない場合は、apt、dnf、pacman、zypper、apk、またはHomebrew用の インストールコマンドを表示します。Debian/Ubuntuでのインストールでは、選択したインタプリタに対応する `python3-venv`パッケージが必要になる場合があります。 ディストリビューションの古い デフォルトのPythonは、Python 3.11以降に置き換えるか、それを補完する必要があります。
- **macOS：**最新の Python 3.11 以上のディストリビューションをインストールしてください。OS に付属の インタプリタが要件を満たしているとは想定しないでください。プロジェクトディレクトリ内の `python3 start.py` を使用してください。
- **Docker：**Compose v2.20 以降を搭載した Docker Engine/Desktop をご利用ください。Windows 上で Docker Desktop を使用する場合は、Linux コンテナを使用する必要があります。コンテナは 独自の Python 依存関係をインストールするため、ホスト側で別途 Python をインストールする必要はありません。

## ローカルコンピュータ

Windowsでは「`Start.cmd`」、Linux/macOSでは「`sh start.sh`」をご使用ください。「`scripts\Setup.cmd`」または 「`sh start.sh --setup-only`」を実行すると、 環境が準備されます。ランチャーは初回使用時に依存関係をインストールし、その後の起動時には その環境を再利用します。セットアップおよびTelegramのデータ収集にはインターネット接続が必要ですが、 既存の記録の閲覧やエクスポートの作成はオフラインでも可能です。

セットアップ後に`python start.py --check`を実行すると、コレクターを起動せずに、ローカルの依存関係、Ed25519、 ストレージ、鍵の設定、およびリスニングアドレスを確認できます。 構造化された出力を得るには、`--json` を使用してください。`--data-dir`、`--host`、および `--port` を実行してください。このチェックでは、パッケージのインストール、ジャーナルの作成、Telegram への接続は行われません。 また、完全性やカバレッジの検証を行うものでもありません。起動時には、既存のジャーナルが別途検証されます。 `python start.py --help` もインストールを回避します。

start.py を実行した後、Windows では `.venv\Scripts\python.exe`、Linux/macOS では `.venv/bin/python` を使用して補助コマンドを実行するか、まずその環境を有効にしてください。 以下の `python -m ...` の例では、環境が有効になっていることを前提としています。

```
python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787
```

環境変数：TGWITNESS_DATA、TGWITNESS_HOST、TGWITNESS_PORT、TGWITNESS_TOKEN。 TGWITNESS_VAULT_KEY_FILE は、新規インストール時に外部キーモードを選択します。「[外部マスターキー」](https://phishdestroy.io/tgwitness/ja/docs/reference/security/#external-master-key)を参照してください。 TGWITNESS_TOKEN を指定する場合は、24文字以上でなければなりません。暗号学的に ランダムな値を使用してください。指定しない場合、アプリは panel-token.txt に 256 ビットのランダムなトークンを生成します。 環境変数による上書きでは、そのファイルは上書きされません。資格情報をローテーションするには、再起動してください。

データディレクトリを所有できるプロセスは、正確に1つだけです。クロスプラットフォームのOSファイルロックにより、 意図しない同時書き込みが防止されます。Uvicornワーカーは1つ使用してください。パネルでは、任意の数の ワークスペースを管理でき、追加のワークスペースディレクトリは profiles/<id>/ 配下に配置されます。 別々のサービスインスタンスについては、別々のディレクトリとポートを使用してください。SQLiteのWALファイルは、ネットワークファイルシステムではなく、 ローカルの永続ストレージに保存してください。レプリカ間で1つのボリュームを共有しないでください。

## Windows用ポータブルパッケージ

各GitHubリリースには、`TgWitness-<version>-windows-amd64-portable.zip`およびその `.sha256`が含まれています。これには、python.orgからの公式の埋め込み可能なPython 3.12ランタイム （`tools/build_portable.py`でチェックサムが固定されています）、TgWitnessおよびその固定された依存関係、 ならびに3つのランチャーが含まれています：

| ファイル | 目的 |
| --- | --- |
| `TgWitness.cmd` | パネルを起動します。追加のオプションはそのまま渡されます（例：`TgWitness.cmd --port 8790`）。 |
| `TgWitness-Demo.cmd` | `data\demo`で合成デモを開始してください |
| `TgWitness-Check.cmd` | 起動せずに準備状況チェックを実行してください |

固定されたロシア語形態素辞書とPDFカラープロファイルは、 オフラインで使用できるようバンドルされています。パッケージングでは、依存関係の `data`ディレクトリ内にある既知のファイルパスのみが許可されており、これらのディレクトリに予期しないファイルが存在するとビルドに失敗します。

アーカイブ全体を、`Documents\TgWitness` などの書き込み可能なフォルダに解凍してください。ZIP ファイル内や Program Files フォルダ内から 実行しないでください。ランタイムは隔離されたモジュールパスを使用するため、 他の Python インストールや `PYTHONPATH` が影響を与えることはありません。 データは パッケージ内の`data`フォルダに保存されます。更新するには、TgWitnessを停止し、新しいバージョンを新しい フォルダに解凍してから、`data`フォルダをコピーしてください。

Python 3.12 を使用して、64 ビット版 Windows 上でご自身でビルドするには：

```
python tools/build_portable.py
```

## コンテナ

```
docker compose up -d --build --wait
```

これにより、/data 用の名前付き永続ボリュームが作成されます。 Web ポートは 127.0.0.1:8787 にマッピングされます。プロセスは UID 10001 として実行され、 権限が制限され、読み取り専用のルートファイルシステム、および書き込み可能な /data と /tmp を持ちます。 `--wait` は、戻り値を返す前に Web サーバーの正常性を確認します。Telegram の認証および 配信状況はパネルに表示されます。提供されているヘルパーは、ビルド後に 180 秒の 準備完了タイムアウトを使用します。初期の依存関係のダウンロードには、それ以上の時間がかかる場合があります。

両方のベース Compose ファイルはプロジェクト名「`tgwitness`」を使用しているため、新しいリリースを 別のディレクトリに展開しても、自動的に新しいデータボリュームが選択されることはありません。そのプロジェクトについては、 1つのデプロイメントのみをアクティブにしておいてください。独立したインストールを行う場合は、一意の「 `docker compose -p NAME ...`」と異なるホストポートを使用し、更新時にも両方を維持してください。 異なるプロジェクト名を使用している古いデプロイメントについては、元の 名前を`-p`と組み合わせて引き続き使用してください。`docker compose ls`には既存のプロジェクトが一覧表示されます。

`deploy/env.example`を`.env`にコピーし、`TGWITNESS_PORT`を変更して別のループバック ポートを使用するようにしてください。例えば、`TGWITNESS_PORT=8788`ではパネルが `http://127.0.0.1:8788`で公開されますが、コンテナは引き続き8787番ポートでリスニングします。`.env`はGitで無視されています。

初期トークンを取得する：

```
docker compose exec tgwitness cat /data/panel-token.txt
```

便利なコマンド：

```
docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait
```

`restart: unless-stopped`は、クラッシュやDockerデーモンの 再起動後にコレクターを再起動します。Linuxサーバーでは、お使いのディストリビューションのサービス マネージャー（通常は`sudo systemctl enable --now docker`）を使用して、起動時にDockerを有効にしてください。Windows/macOSでは、 Docker Desktopの「サインイン時に起動」設定を有効にしてください。デスクトップのサインアウト、スリープ、または停止された Dockerデーモンの停止は、データ収集を中断させる可能性があります。明示的に停止されたコンテナは、 再度起動するまで停止したままとなります。

この設定例では、/tmp ボリュームの上限は 512 MiB に設定されています。エクスポートの構築では、 代わりに、永続的な /data 上の各ワークスペースの `temporary-exports/` ディレクトリを使用します。そこでは、 同時エクスポート、ジャーナル/WAL の増加、メディア、およびバックアップ用にスペースを確保してください。 ランチャーは deploy/constraints.txt を使用して、条件を満たすランタイム依存関係のバージョンを固定します。 Docker および高信頼性サーバーは、deploy/requirements.lock および deploy/build.lock に基づき、pip --require-hashes オプションを使用してインストールされます。すべてのパッケージファイルは、コミットに記録された SHA-256 と 一致する必要があります。そのため、PyPI やミラーサイトで置き換えられたファイルは拒否されます。 ソースのみを 提供するパッケージ（jieba、pyaes）は、ランチャー、Windows ポータブルビルダー、および Dockerfile によって、 deploy/build.lock に固定された setuptools を使用して（`--no-build-isolation`）ビルドされるため、 pip は別途の、固定されていないビルド環境を解決することはありません。 Pythonベース イメージおよびオペレーティングシステムパッケージについては、引き続き個別のリリース認定が必要です。

ジャーナルと鍵を破棄する意図がない限り、`docker compose down -v` を使用しないでください。 コンテナのヘルスレポートは、Webサーバーの稼働状況を報告するものであり、Telegramのキャプチャが成功したかどうかを示すものではありません。 パネルのコレクターの状態、ハートビート、エラー、およびカバレッジイベントを確認してください。

### 独立した証人プロフィール

オプションの`witness`サービスは、独自の コンテナ内で[独立したウィットネス](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)を実行し、`witness-data`ボリューム内に独自のキーとジャーナルを持ち、コレクターに対しては読み取り専用の ウィットネストークンのみを付与します。パネル内の「**その他のツール」→「エクストラ」→「独立したウィットネス**」でトークンを作成し、 ボットトークンとチャンネルを`.env`に追加してから、プロファイルを起動してください：

```
docker compose --profile witness up -d          # deploy/compose/compose.image.yaml: same flag
docker compose logs witness                     # witness key fingerprint
```

本サービスは、Composeネットワーク内のコレクター（`http://tgwitness:8787` ）にアクセスします（`TGWITNESS_WITNESS_COLLECTOR` で上書きされます。例えば、`/profiles/<workspace ID>` は 別のワークスペース用です）。他者が運営する別のサーバー上のウィットネスをご利用の場合は、 そこで`deploy/compose/compose.witness.yaml` を使用し、`TGWITNESS_WITNESS_COLLECTOR` をコレクターのHTTPS アドレスに設定してください。そのファイルにはウィットネスのみが含まれています。

## 公開されているイメージをインストールする

`deploy/env.example`を`.env`にコピーしてください。`TGWITNESS_IMAGE`には、公開版を指定してください。その際、 リポジトリパスは**小文字で**指定してください。例：

```
TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787
```

`compose.yaml`の代わりに、このファイルを単独で実行してください：

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt
```

ホスト側でソースからのビルド、Python、またはコンパイラは必要ありません。リリースワークフローは、 Docker DesktopのLinux VMを含む、Linux AMD64およびARM64コンテナを対象としています。 ワークフローの概要にあるバージョンタグ、または「`ghcr.io/owner/repository@sha256:...`」をご利用ください。 「`latest`」タグの移動や、無人でのアプリケーションアップグレードは設定されていません。 プロジェクト名が一致する場合、イメージとソースのバリアントは同じデータボリュームを使用します。

## サーバーでのHTTPSの自動設定

Dockerが動作するサーバー、ご自身が管理するドメイン、および永続的なローカルストレージをご用意ください。 ドメインのA/AAAAレコードをサーバーに向けるように設定してください。IPv6がサーバーに到達する場合にのみ、AAAAレコードを公開してください。 証明書の発行のために、着信TCP 80および443、ならびに発信DNS/HTTPSを許可してください。 これらのポートは、他のサービスによって既に使用されていない必要があります。

`deploy/env.example`を`.env`にコピーし、スキームやパスを含めないホスト名を設定してください：

```
TGWITNESS_DOMAIN=watch.your-domain.org
```

HTTPSオーバーレイを使用してソースのビルドを開始します：

```
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
```

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait
```

公開用画像の場合は、代わりに最初のファイルとして「`deploy/compose/compose.image.yaml`」を使用してください。 後のステータス、ログ、更新、および停止コマンド用に、「`-f`」の引数は両方とも保持しておいてください。

Caddyは証明書の取得と更新を行い、HTTPをHTTPSにリダイレクトし、 プライベートなComposeネットワーク上のコレクターへリクエストを転送します。証明書の状態は 専用の永続ボリュームに保存されます。コレクターの直接ホストポートは、ループバック専用に保たれます。 提供されているCaddyの設定では、アクセスログの記録は有効になっていません。

`https://watch.your-domain.org` を開き、パネルトークンを入力してください。準備状況の確認 はコンテナを対象とします。証明書の発行および外部からの到達可能性は、DNS およびファイアウォールに依存します。HTTPSが利用できない場合は、DNS、ファイアウォールルール、および以下を確認してください：

```
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy
```

提供されているCaddyイメージは、`2-alpine`タグに従っています。pullコマンドを実行すると、そのイメージが更新されます。 インフラのバージョンを固定する必要がある場合は、テスト済みのダイジェストをデプロイメントにピン留めしてください。

## 更新とバックアップ

アップデート後も「Compose」プロジェクト名とデータ量を維持します。まず、 コレクターを停止し、完全なバックアップを作成してください。デフォルトのソースベースのデプロイメントの場合：

```
docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update
```

リポジトリ外で、毎回新しいバックアップ先を使用し、それを アカウントへのアクセス権限が必要な資料として保護してください。例示されているパスはあくまで参考です。ご自身のプライベートなバックアップ 場所をご利用ください。隠しファイル、すべてのワークスペース、鍵、 ジャーナル、メディアを含め、ディレクトリ全体をコピーしてください。設定されている場合は、外部ボールトのマスターキーも別途バックアップしてください。 証拠用ZIPファイルは、復元可能なアプリケーションのバックアップではありません。HTTPSの場合、 証明書やアカウントの状態を保持する必要がある場合は、Caddyのボリュームも保存してください。

ソースからのデプロイを行うには、新しいリリースファイルを入手し、以下のコマンドを実行してください：

```
docker compose up -d --build --wait
```

イメージを展開する場合は、`TGWITNESS_IMAGE` を希望のバージョンに変更し、以下のコマンドを実行してください：

```
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
```

前述の停止／コピーコマンドについても、インストール先の Compose ファイルをご利用ください。 `.env`、カスタム設定、および同じプロジェクト名はそのまま維持してください。`down`は名前付き ボリュームを保持し、**`down -v`**は**それらを削除します**。`.venv`を異なるオペレーティングシステム間 またはPythonバージョン間でコピーしないでください。ネイティブアップデートを行う場合は、TgWitnessを停止し、データ ディレクトリ全体をバックアップした後、ソースファイルを置き換え、起動前に`python start.py --setup-only`を実行してください。

更新後に、パネルのアクセス権、アカウントの識別情報、観測状態、およびカバレッジを確認してください。 再起動後、TgWitnessは保存されたTelegramの更新位置から再開し、 更新中に見逃した更新をリクエストします。将来のバージョンでストレージ形式が変更された場合、 ロールバックには更新前のバックアップが必要になる可能性があります。

## リモートサーバー

サービスをループバックに限定し、SSHトンネルを使用するか、HTTPSを リバースプロキシで終端させてください。基本のComposeファイルはローカルのみに対応しています。オプションの `deploy/compose/compose.https.yaml`オーバーレイは、設定されたドメイン向けにCaddyを提供します。 ベアラートークンは、URLやプロキシログに含めないでください。リバースプロキシでは、 リクエストサイズと接続レートを制限する必要があります。プレーンなHTTPをインターネットに公開しないでください。

[deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) ディレクトリには、systemd、Windows ログオンタスク、macOS ユーザーエージェント、および Caddy の例が 用意されています。インストール前に、それらのパスを確認・調整してください。 これらはテンプレートであり、ローカルで実行されるプラットフォーム固有の設定ではありません。通常のランチャーでは、 バックグラウンドサービスやタスクは登録されません。

Windowsでは、ウィンドウなしの`pythonw.exe`起動時、起動時およびサーバーの診断情報は データディレクトリ内の`logs/server.log`に保存されます（1ファイルあたり5 MiB、ローテーションされたバックアップが2つ）。 コンソール起動時には、コンソールログが保持されます。どちらの モードでも、HTTPアクセスログの記録は無効になっています。ログはデータディレクトリと共に保護し、共有する前に内容を確認してください。

## 再起動とデータ欠落

最後に要求された監視状態は保持されます。監視がアクティブだった場合、 起動時に再接続を試み、選択された情報源の監視を再開します。手動で一時停止すると、 その設定は解除されます。再起動に失敗した場合は記録され、パネルに表示されます。

TgWitnessは、アカウントおよび各チャンネルに対するTelegramの更新位置 （pts、qts、seq、date）をワークスペースのボールトに保存し、次回の起動時に復元します。 その後、クライアントはプロセスが停止していた間に見逃した更新をリクエストし、 定期的な再チェックによって見逃したメッセージを回復するとともに、Telegramが もはや返さない保存済みのメッセージを記録します。ダイアログは起動時に再読み込みされます。 起動のたびに、前回の ジャーナルヘッド、オフライン境界、および再開時の更新位置が記録されます。 モニターは10秒ごとに接続状態を確認し、1分ごとにハートビートを追加します （**[その他のツール] → [パラメータ] → [Liveness record every]**）。 接続切断や通信のない期間は、その理由とともにカバレッジのギャップとして記録されます。 履歴のスナップショットは、ライブレコードの隣に個別の「現在の履歴」観測値として保存されます。

メディアクイーは各ワークスペースのSQLiteデータベースに格納されます。メッセージとそのジョブは アトミックにコミットされます。実行中に中断されたジョブは、起動時にリトライできるよう復旧されます。 各ダウンロードには、120秒の基本タイムアウトに加え、そのサイズに応じた256 KiB/sでの処理時間が加算され、 添付ファイルの種類ごとに1～2,000 MiBの上限があります。タイムアウト、速度、再試行回数は**「その他のツール」→「パラメータ」**で設定可能です。コレクターは サイズが不明なファイルをスキップします。一時停止しても、キューに格納された作業は保持されます。再試行では、元の 観測されたファイル記述子が使用され、その後編集されたメッセージの最新バージョンは決して使用されません。 一時的な障害に対する再試行回数には上限があります。メディアのFloodWaitによる一時停止は、再起動後も維持されます。 メディアの復旧はTelegramの更新復旧とは別であり、消失したファイルを復元することはできません。

## バックアップ、復元、および容量

`tgwitness backup FOLDER` は、パネルの稼働を継続したままデータディレクトリをコピーします。 まずチェックポイントをコピーし、次にオンラインバックアップAPIを介してSQLiteファイルをコピーし、その後キー、メディア、 プロファイルをコピーするため、コピーされたチェックポイントがコピーされたジャーナルよりも新しいということはありません。`backup-manifest.json` には、各ファイルのSHA-256とジャーナルのヘッダーが一覧表示されます。 復元するには、TgWitnessを停止し、 データディレクトリ全体をそのフォルダと置き換えます。次回の起動時に、ジャーナルが古いコピーから復元されたことが 記録されます。この記録では、ジャーナルがデータディレクトリ外のフォルダであるTGWITNESS_STATE_DIR（ `TGWITNESS_STATE_DIR` ）に保存されているヘッダーと比較されます。具体的には、 Compose内の`tgwitness-state` ボリューム、systemdユニット内の`/var/lib/tgwitness-state` 、それ以外の場合はユーザーのローカル状態フォルダ です。書き込み可能な状態フォルダがない場合、復元は検出されず、ログに一度その旨が記録されます。

このコマンドを実行しない場合は、vault.key、 signing.enc、credentials.enc、SQLiteデータベース/WALファイル、メディア、トークン、チェックポイント、 およびすべてのprofiles/サブディレクトリを含む**データディレクトリ全体を**コピーする前に、プロセスを停止してください。 復元 は、宛先サービスが停止している間に完全なコピーを復元してください。Vaultキーの欠落や 署名キーの不一致があると起動に失敗します。アクセスを強制するためにキーを再生成しないでください。

秘密のバックアップは暗号化し、アクセス制御を行ってください。証拠用ZIPファイルはポータブルであり、 アプリケーションのバックアップやTelegramセッションのバックアップではなく、証拠資料そのものを確認してください。 自動的な保存期間満了による削除機能はありません。すべてのメッセージ、生 メタデータ、メディア、一時的なエクスポートデータ、およびバックアップを保存するためのディスク容量を確保してください。

ジャーナル全体を読み込む代わりに、起動時の検証とストリームレコードのエクスポートを実行します。 エクスポートは読み取り用スナップショットを固定しますが、新しいWALへの書き込みは継続可能です。長時間実行されるエクスポートでは WALページが保持されるため、ディスク容量は依然として重要です。 ZIPファイルは、独立した検証ツールのデフォルト設定に合わせて、非圧縮時4 GiB に制限されています。**「More tools」→「Parameters」→「Largest signed ZIP」** で上限を引き上げることができ、そのようなアーカイブは`verify.py --max-gib N`で検証されます。他のフォーマットにはイベント数の制限はありません。 対応しているブラウザは、ユーザーが選択したファイルにレスポンスのチャンクをストリーム配信します。その他のブラウザは 最大128 MiBまでバッファリングし、それ以上の転送は認証済みのCLIに転送されます：

```
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
```

別のワークスペースの場合は**「Exports → Workspace ID」**から `--profile ID` を、 リモートサーバーの場合は `--format zip|jsonl|csv|html`、`--url https://your-server` を、 5 GiB の転送制限を変更する場合は `--max-mib` を使用してください。プレーン HTTP は ループバックの場合にのみ許可されます。トークンはヘッダーで送信され、リダイレクトは拒否され、既存のファイルは 上書きされず、ダウンロードが未完了のファイルは完了したファイルとして公開されません。 TGWITNESS_TOKENが生成されたトークンを上書きする場合、その有効な値を含む、別途保護されたファイルを使用してください。 panel-token.txtは、上書きによって書き換えられることはありません。 コマンドのSHA-256は転送チェックサムに過ぎません。署名付きZIPファイルについては、別途検証を行ってください。

このパネルには、キューに入れられている／失敗したメディア、最も古い保留中のメディア、空きディスク容量、Telegram へのリクエストの一時停止、およびアクセスが未確認のソースが表示されます。これらの診断情報は、 完全なエンドツーエンドの配信モニターではありません。ワークスペースはプロセスを共有しているため、ノイズの多いアカウントが 他のワークスペースに影響を与える可能性があります。 個別のワーカープロセス、保存期間／ローテーション、耐久性のある更新 復旧、および完全な導入認定については、引き続き対応が必要です。パネルへのアクセス範囲については、 「[アクセスと権限](https://phishdestroy.io/tgwitness/ja/docs/reference/access/)」に文書化されています。独立したチェックポイントについては、 [ウィットネスガイド](https://phishdestroy.io/tgwitness/ja/docs/reference/witness/)で説明されています。

詳細な手順：[接続・セキュリティ](https://phishdestroy.io/tgwitness/ja/docs/reference/connection/)および [動作モード](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/)。
