参考文献 / セットアップ
Telegram · クイックスタート
TgWitnessのインストールおよび起動方法のすべて:Windowsパッケージ、Python、Docker、および初期チェックを含む統合デモ。
英語 · Русский · ウクライナ語 · Español · ポルトガル語(ブラジル) · Türkçe · アラビア語 · فارسی · ウルドゥー語 · ヒンディー語 · インドネシア語 · Tiếng Việt · 簡体字中国語
TgWitnessは、ご自身のアカウントがアクセス可能なTelegramのグループやチャンネルを監視するためのスタンドアロン型アプリケーションです。 独自のデータディレクトリを使用して、ローカル上で動作します。
初めてのご利用ですか?アカウントを連携する前に、デモをご覧ください。 プロキシ、ウィットネス、エクスポート、またはサーバー設定に関するガイドをお選びください。 GitHub Actions キャプチャ(プレビュー)は、ローカルインストールではなく、ご自身の GitHub フォーク上でキャプチャを実行します。
インストールと起動#
ガイド付きインストーラーには独自のPythonが含まれており、インストール前にパッケージのハッシュ値とリリース 署名を検証します。再度実行すると、既存のインストールが更新されます。
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
Windows(PowerShell または コマンドプロンプト):
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
Ubuntuサーバーでは、root権限で実行してバックグラウンドサービスをインストールしてください。デスクトップでは、 通常のユーザーとして実行してください。Ubuntuでは、インストーラーがパネルのアドレスとアクセスキーを表示します。 macOSおよびWindowsでは、ブラウザでローカルパネルが開きます。以下の「Telegramに接続」の項目に進んでください。 「インストール、検証、および更新」では、サーバーへのアクセス方法、 実行前のスクリプトの確認、更新、および削除について説明しています。
その他のメソッド#
GitHubのリリース、ソースコード、およびDockerは、インストーラーの代替手段となります。ポータブル 版は、リリースビルドが公開された後にダウンロード可能になります:
| ホスト | インストールは不要です | 出典:Python 3.11 以上 | Docker:Engine/Desktop(Compose 2.20 以降) |
|---|---|---|---|
| Windows | GitHub Releases から「TgWitness-<version>-windows-amd64-portable.zip」を抽出し、「TgWitness.cmd」をダブルクリックしてください。 |
Start.cmd をダブルクリックしてください |
scripts\Docker.cmd をダブルクリックしてください |
| Linux / macOS | — | sh start.sh |
sh scripts/docker-start.sh |
ソースコードからの実行方法については、現在の main をダウンロードして展開するか、リポジトリをクローンしてください:
git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness
Start.cmd は、適切な Python が見つからない場合、現在の Windows ユーザー向けに Python 3.12 のインストール(winget、または署名済みの python.org インストーラー経由)を提案します。start.sh は、Python が不足している場合、お使いの Linux ディストリビューションまたは macOS 向けの正確なインストールコマンドを表示します。ソースからの初回起動時には、.venv が作成され、依存関係が自動的にインストールされます。
Dockerがアプリケーションをビルドし、バックグラウンドで起動します。ホスト側のPythonは
不要です。scripts\Docker.cmdおよびscripts/docker-start.shは、
コンテナが正常に動作している際に、パネルアドレスとトークンを表示します。サポートされているすべてのホストにおける対応するDockerコマンドは以下の通りです:
docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt
http://127.0.0.1:8787 を開いてください。Docker ヘルパーまたは 2 番目の Docker コマンドによって出力されたトークンを使用するか、ポータブル版またはソースからのインストールの場合は data/live/panel-token.txt を参照してください。以下の 「Telegram を接続」に進んでください。 ネイティブインストールとDockerインストールでは、それぞれ別々のストレージを使用します。 Dockerを起動しても、既存のネイティブジャーナルはインポートされません。
サーバーのデプロイメントには、HTTPSの自動設定、再起動、 公開画像、アップデート、およびバックアップが含まれます。
インターフェースをご覧ください#
- ポータブルパッケージ内の「TgWitness-Demo.cmd
」、Windowsのソース
フォルダ内の「scripts\Demo.cmd
」、またはLinux/macOS上の「
sh start.sh --demo」を実行してください。ソースから起動すると、まず「.venv」が作成され、依存関係がインストールされます。 - http://127.0.0.1:8787 を開いてください。
- ローカルデモでは、サンプルジャーナルが自動的に開かれます。ローカルから直接アクセスする場合、トークンのコピーは必要ありません。
デモ用のメッセージは架空のものです。デモモードでは、実際のTelegramアカウントに接続することはできません。
Telegramに接続する#
[!警告] 専用のアカウントを使用してください。Telegramは、クライアントの種類にかかわらず、 過剰と判断したリクエスト量に対してアカウントを制限または永久停止する可能性があります。個人用や重要なアカウントではなく、 観測用に用意したアカウントを接続し、専用のアカウント上でAPI ID / ハッシュを 作成してください。
- ネイティブのデモが実行中の場合は、それを停止し、Start.cmd または
sh start.shを実行してください。 そうでない場合は、上記で起動したライブインストールをそのまま実行し続けてください。 - パネルトークンを使用してサインインしてください。初回セットアップ時に新しいワークスペースが開きます。 「ダウンロードのみ」、「チャットをフォロー」、または「事件の証拠」のいずれかを選択してください。
- 接続チェックを確認してください。必要に応じて独自のプロキシを設定してください。接続 設定はセットアップ後も利用可能です。
- Connect Telegram で、電話番号、QR コード、アカウントファイル(TData、
.session、StringSession、アカウントJSON)または完全な認証キーを選択してください。要求されたら、Telegramの確認、コード、および2段階認証のパスワードを入力してください。 - 表示されたアカウントを確認し、チャットを選択して設定内容を確認してください。最終画面から 操作を完了してください。「Just download」の場合、「Start export」を選択すると、1回限りの エクスポートが開始され、進行状況を確認するために「Exports」画面が開きます。継続的な監視機能は有効になりません。
セットアップ後、「Chats → Choose」で選択中のチャットを変更できます。「Settings」では コレクションとファイルを管理します。「More tools → Sources」では、詳細なソースリストを 「Standard」または「Expert」レベルで表示します。パネルガイドでは、6つの主要な セクションとそのコンテキストに応じた操作方法について説明しています。
API ID + ハッシュは任意です。ワークスペースは、保存またはインポートされたペア、
あるいは組み込みプール内の有効なペアを使用します。独自のアプリを使用する場合は、
API ID:API Hash ペアを貼り付けてください。「Authキー」には、512文字の16進数
文字列をすべて貼り付け、提供されたDC IDを選択してください。「ユーザーID」は任意であり、入力された場合はチェックされます。
API認証情報はアプリケーションを識別するものであり、それ自体ではアカウントへのアクセス権を付与するものではありません。 非公開グループでは公開ユーザー名は必要ありませんが、アカウントにはアクセス権が必要です。
既存のアカウントについては、「アカウントとセッション形式」を参照してください。 このパネルでは、Telethon StringSession、Telethon/Pyrogram SQLite、単一アカウントの TData ZIP、およびサポートされているアカウント JSON に対応しています。セッションとその対応する JSON を一緒に選択し、 「ファイルを確認」を押してから、「アカウントに接続」を押してください。QR ログインも、 同じオプションの API 設定で利用可能です。 TDLib、ボットセッション、およびCSV/JSON形式の アカウント一覧はサポートされていません。
複数のアカウントを扱う場合は、アカウント → アカウントのインポートを使用し、サポートされているセッションファイルを選択してください。付随する JSON ファイルはベース名(拡張子を除いたファイル名)でペアリングされ、インポートされた各アカウントには専用のワークスペースが割り当てられます。一括インポートとアカウントグループを参照してください。
別のアカウントを追加するには、アカウント選択ボタンの横にある「+」を押すか、 [アカウント] → [アカウントを追加] を使用してください。ワークスペースごとに、 セッション、ジャーナル、キー、ソース、キューが個別に管理されます。ビューを切り替えても、他のコレクターは実行されたままになります。 このインストール環境では、同じ Telegram アカウントを 2 つのワークスペースに割り当てることはできません。 ワークスペースの数に制限はありません。ワークスペースは 1 つのプロセスを共有するため、収容能力はマシンの性能に依存します。
ライブパネルトークンは、Telegramの認証情報および保存された
データへのアクセスを保護するものであり、Telegram APIの認証情報とは別物です。明示的に起動され、
直接アクセスされたローカルデモのみが自動的に登録されます。リモートまたはプロキシ経由のデモでは、引き続き
data/demo/panel-token.txtが使用されます。
確認とエクスポート#
- ジャーナル:情報源やイベントの種類ごとに記録を検索・フィルタリングできます。
- イベントを選択すると、その元の記録、出典、および保存されたバージョンを確認できます。
- 編集の詳細には、変更前後の利用可能なコンテンツが表示されます。削除の詳細には、 最後にキャプチャされたコンテンツ(存在する場合)が表示されます。身元不明の行為者は、引き続き不明のままとなります。
- エクスポート形式:署名付きZIP、JSONL、CSV、およびオフライン用HTML。
- チャットの完全エクスポート(「チャット」→「チャットをエクスポート」、または「エクスポート」→「1つのチャットをキャプチャまたはエクスポート」
):1つのチャットの表示可能な
履歴全体を、
chat.json(Telegramエクスポート形式)と読み取り可能なchat.htmlを含む署名付きバンドルとしてダウンロードします。プライベートチャットは、そのアカウントがメンバーである場合に機能します。これは現在の スナップショットであり、削除されたメッセージや以前に編集されたメッセージの再構築ではありません。python verify.py chat-export.zip --fingerprint TRUSTED_SHA256を使用してコピーを検証してください。 - チェックポイントの保存:署名付きジャーナルの境界をコレクターの外側に保持してください。
- 署名付き実行レシートをダウンロード:コレクターのプログラムおよびバージョンの記録を保存します。
- タイムスタンプのリクエストの準備:タイムスタンプ認証機関へのオフラインリクエストを準備します。 TIMESTAMP.mdの手順に従って、応答を取得し、検証してください。
- ジャーナルの検証:イベントの署名とチェーンリンクを確認してください。ZIP形式でのエクスポートでは、メディアファイルもチェックされます。
対応しているブラウザでは、大容量のエクスポートデータを指定したファイルに直接保存できます。その他のブラウザでは、 最大 128 MiB までバッファリングされます。サーバーが稼働している間、ストリーミング CLI を使用すれば、 レスポンス全体をバッファリングすることなく、より大容量のダウンロードが可能です:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
別のワークスペースを使用する場合は、「Exports」→「Workspace ID」から--profile IDを追加してください。
リモートサーバーを使用する場合は、--url https://your-serverを追加してください。デフォルトの転送制限は
5 GiBです。--max-mibで変更できます。 署名付きZIPコンテンツには、デフォルトで4 GiBの
非圧縮検証制限が別途設定されています(「その他のツール」→「パラメータ」で上限を引き上げることができます。このようなアーカイブの検証には
verify.py --max-gib N を使用してください)。検証には、信頼できる検証ツールのコピー、
独立して保持されている鍵のフィンガープリント、および証拠としての最低限の要件として、タイムスタンプ
認証機関のルート証明書(--tsa-ca)を使用してください。
インストール方法をご確認ください#
python start.py --setup-only
python start.py --check
python start.py --check --json
--checkは、ローカルの依存関係、署名機能のサポート状況、ストレージ、鍵の設定、および
リスニングアドレスを調査します。何もインストールせず、Telegramにも接続しません。ポートが
使用中の場合は、別のインスタンスが実行されている可能性があります。別の--portを使用するか、まずそれを停止してください。
ランチャーは.venvにインストールされます。補助的なpython -m tgwitness...コマンドは、
その環境がすでに有効化されていない限り、Windowsでは.venv\Scripts\python.exeを、Linux/macOSでは.venv/bin/pythonを
使用する必要があります。
セッション、保護、および運用#
閉じた一貫性のあるTelethon SQLite .sessionは、
python -m tgwitness.sessions account.session --out account.tgwitness-session を使用してローカルで変換し、その後
「その他のツール」→「アカウント」→「ファイル」で読み込むことができます。ファイルの直接インポートやQRコードによるログインも利用可能です。ログイン形式、SOCKS5、
HTTP CONNECT、MTProxy、および外部マスターキーについては
、CONNECTION-SECURITY.mdを参照してください。
「一時停止」を選択すると、収集が停止します。「ロック」を選択しても、ブラウザへのアクセスが遮断されるだけです。 タブを閉じても、収集プロセスは実行されたままになります。プロセスを停止すると収集が中断されますが、 履歴のスナップショットでは、見逃された編集や削除のすべてを復元することはできません。 イベントポリシー、添付ファイルのキュー、 アカウントの隔離、および再起動時の動作について、収集の仕組みをご確認ください。
セッションとシークレットは暗号化されています。メッセージの内容、メディア、およびエクスポートには、 暗号化されたディスクまたはボリュームが必要です。信頼できる鍵を用いてジャーナルの署名を検証し、チェックポイントを別途保持してください。 選択した収集モードについて、キャプチャ記録、外部タイムレシート、および環境認証情報を 確認してください。
バックアップ/復元については OPERATIONS.md、ホスティングについては DEPLOYMENT.md、
サービスの例については deploy/ をご参照ください。インストールされた
パネルには、/guide.html にオフライン設定ガイドも含まれています。
実際の検証状況および残された課題については、 VERIFICATION.md および READINESS.md に記載されています。