TgWitness / Dokumentasi

Apa yang telah diuji →

Referensi / Pengaturan

Telegram · Panduan cepat

Semua cara untuk menginstal dan menjalankan TgWitness: paket Windows, Python, Docker, dan demo sintetis, beserta pemeriksaan awal.

TgWitness / Dokumentasi

Memulai

Bahasa Inggris · Русский · Ukraina · Español · Português (Brasil) · Bahasa Turki · العربية · فارسی · Urdu · Hindi · Bahasa Indonesia · Bahasa Vietnam · Bahasa Mandarin (Sederhana)

TgWitness adalah aplikasi mandiri untuk memantau grup dan saluran Telegram yang dapat diakses oleh akun Anda. Aplikasi ini berjalan secara lokal dengan direktori data tersendiri.

Pertama kali berkunjung? Jelajahi demo sebelum menghubungkan akun. Pilih panduan untuk proxy, saksi, ekspor, atau pengaturan server. GitHub Actions capture (pratinjau) menjalankan proses penangkapan di fork GitHub Anda sendiri, bukan di instalasi lokal.

Instal dan mulai#

Penginstal terpandu ini menyertakan Python-nya sendiri dan memeriksa hash paket serta tanda tangan rilis sebelum menginstal. Menjalankannya kembali akan memperbarui instalasi yang sudah ada.

Linux / macOS:

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows (PowerShell atau Command Prompt):

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

Di server Ubuntu, jalankan sebagai root untuk menginstal layanan latar belakang; di desktop, jalankan sebagai pengguna biasa. Di Ubuntu, penginstal menampilkan alamat panel dan kunci akses; di macOS dan Windows, panel lokal terbuka di browser Anda. Lanjutkan ke bagian Hubungkan Telegram di bawah ini. Bagian Instal, verifikasi, dan perbarui mencakup pilihan akses server, pemeriksaan skrip sebelum dijalankan, pembaruan, dan penghapusan.

Metode lain#

Rilis GitHub, kode sumber, dan Docker merupakan alternatif dari penginstal. Unduhan portabel tersedia setelah build rilis diterbitkan:

Host Tidak ada yang diinstal Dari sumber: Python 3.11+ Docker: Engine/Desktop dengan Compose 2.20+
Windows Ekstrak TgWitness-<version>-windows-amd64-portable.zip dari GitHub Releases, klik dua kali TgWitness.cmd Klik dua kali Start.cmd Klik dua kali scripts\Docker.cmd
Linux / macOS — sh start.sh sh scripts/docker-start.sh

Untuk metode kode sumber, unduh dan ekstrak main saat ini atau kloning repositori:

git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness

Start.cmd menawarkan untuk menginstal Python 3.12 bagi pengguna Windows Anda jika tidak ditemukan Python yang sesuai (winget, atau penginstal python.org bertanda tangan). start.sh mencetak perintah instalasi yang tepat untuk distribusi Linux atau macOS Anda jika Python belum ada. Peluncuran kode sumber pertama akan membuat .venv dan menginstal dependensi secara otomatis.

Docker membangun aplikasi dan menjalankannya di latar belakang; Python di host tidak diperlukan. scripts\Docker.cmd dan scripts/docker-start.sh menampilkan alamat panel dan token saat kontainer dalam kondisi baik. Perintah Docker yang setara di setiap host yang didukung adalah:

docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt

Buka http://127.0.0.1:8787. Gunakan token yang dicetak oleh Docker helper atau perintah Docker kedua, atau baca berkas data/live/panel-token.txt untuk instalasi portabel atau dari sumber. Lanjutkan ke bagian "Connect Telegram" di bawah ini. Instalasi native dan Docker menggunakan penyimpanan terpisah; menjalankan Docker tidak akan mengimpor jurnal native yang sudah ada.

Untuk server, proses penerapan mencakup HTTPS otomatis, restart, publikasi gambar, pembaruan, dan pencadangan.

Jelajahi antarmuka#

  1. Jalankan TgWitness-Demo.cmd dalam paket portabel, scripts\Demo.cmd di folder sumber Windows, atau sh start.sh --demo di Linux/macOS. Peluncuran dari folder sumber akan terlebih dahulu membuat .venv dan menginstal dependensi.
  2. Buka http://127.0.0.1:8787.
  3. Demo lokal akan membuka jurnal contoh secara otomatis. Tidak diperlukan salinan token untuk akses lokal langsung.

Pesan demo bersifat fiktif. Mode demo tidak dapat terhubung ke akun Telegram yang sebenarnya.

Hubungkan Telegram#

[!PERINGATAN] Gunakan akun khusus. Telegram dapat membatasi atau memblokir akun secara permanen karena volume permintaan yang dianggap berlebihan, apa pun kliennya. Hubungkan akun yang disiapkan untuk pengamatan, bukan akun pribadi atau yang berharga, dan buat ID API / hash pada akun khusus.

  1. Jika demo bawaan sedang berjalan, hentikan dan jalankan Start.cmd atau sh start.sh. Jika tidak, biarkan instalasi langsung yang telah dijalankan di atas tetap berjalan.
  2. Gunakan token panel untuk masuk. Ruang kerja baru akan terbuka pada pengaturan awal. Pilih Hanya unduh, Ikuti obrolan, atau Bukti untuk suatu kasus.
  3. Periksa pengaturan koneksi. Konfigurasikan proxy Anda sendiri jika diperlukan; pengaturan koneksi tetap tersedia setelah penyiapan.
  4. Di Connect Telegram, pilih nomor telepon, kode QR, berkas akun (TData, .session, StringSession, JSON akun), atau kunci otorisasi lengkap. Lengkapi konfirmasi Telegram, kode, dan kata sandi dua langkah saat diminta.
  5. Periksa akun yang ditampilkan, pilih obrolan, dan tinjau pengaturan Anda. Selesaikan dari layar terakhir. Untuk opsi Hanya unduh, Mulai ekspor akan memulai proses ekspor satu kali dan membuka halaman Ekspor untuk menampilkan kemajuannya; opsi ini tidak mengaktifkan pemantauan berkelanjutan.

Setelah pengaturan, Chats → Choose mengubah obrolan yang dipilih. Pengaturan mengontrol pengumpulan dan berkas; More tools → Sources menyediakan daftar sumber terperinci pada tingkat Standard atau Expert. Panduan panel menjelaskan enam bagian utama dan kontrol kontekstualnya.

API ID + Hash bersifat opsional: ruang kerja menggunakan pasangan yang disimpan atau diimpor, atau pasangan yang aktif dari kumpulan bawaan. Untuk menggunakan aplikasi Anda sendiri, tempelkan satu pasangan API ID:API Hash ke kolom API ID. Untuk Kunci Otentikasi, tempelkan seluruh 512 karakter heksadesimal dan pilih DC ID yang disediakan. ID Pengguna bersifat opsional dan akan diverifikasi jika dimasukkan.

Kredensial API mengidentifikasi aplikasi Anda; kredensial tersebut tidak secara otomatis memberikan otorisasi atas akun. Grup pribadi tidak memerlukan nama pengguna publik, tetapi akun Anda harus memiliki akses.

Untuk akun yang sudah ada, lihat format akun dan sesi: panel ini mendukung Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP akun tunggal, dan file JSON akun yang didukung. Pilih sesi beserta file JSON-nya secara bersamaan, tekan Periksa file, lalu Hubungkan akun. Masuk melalui QR juga tersedia dengan pengaturan API opsional yang sama. TDLib, sesi bot, dan inventaris akun CSV/JSON tidak didukung.

Untuk beberapa akun, gunakan Akun → Impor akun dan pilih file sesi yang didukung. File JSON pendamping dipasangkan berdasarkan nama dasar (basename); setiap akun yang diimpor mendapatkan ruang kerjanya sendiri. Lihat impor massal dan grup akun.

Untuk menambahkan akun lain, tekan + di samping pemilih akun atau gunakan Akun → Tambahkan akun. Ruang kerja memiliki sesi, jurnal, kunci, sumber, dan antrian yang terpisah. Beralih antar tampilan tidak menghentikan pengumpul lainnya. Akun Telegram yang sama tidak dapat ditugaskan ke dua ruang kerja dalam instalasi ini. Tidak ada batasan jumlah ruang kerja; mereka berbagi satu proses, sehingga kapasitas bergantung pada mesin.

Token panel langsung melindungi akses ke otorisasi Telegram dan materi yang disimpan Anda; token ini terpisah dari kredensial API Telegram. Hanya demo lokal yang secara eksplisit dijalankan dan diakses secara langsung yang mendapatkan akses otomatis. Demo jarak jauh/proksi tetap menggunakan data/demo/panel-token.txt.

Tinjau dan ekspor#

  • Jurnal: cari dan saring pengamatan berdasarkan sumber dan jenis peristiwa.
  • Pilih suatu peristiwa untuk memeriksa catatan aslinya, atribusi, dan versi yang disimpan.
  • Rincian pengeditan menampilkan konten sebelum dan sesudah yang tersedia. Rincian penghapusan menampilkan konten terakhir yang terekam, jika ada; pelaku yang tidak dikenal tetap tidak diketahui.
  • Format ekspor: ZIP yang ditandatangani, JSONL, CSV, dan HTML offline.
  • Ekspor obrolan lengkap (Obrolan → Ekspor obrolan, atau Ekspor → Tangkap atau ekspor satu obrolan): unduh seluruh riwayat yang terlihat dari satu obrolan sebagai bundel yang ditandatangani dengan chat.json (gaya ekspor Telegram) dan berkas chat.html yang dapat dibaca. Obrolan pribadi berfungsi jika akun tersebut merupakan anggota. Ini adalah cuplikan saat ini, bukan rekonstruksi pesan yang dihapus atau diedit sebelumnya. Verifikasi salinan dengan python verify.py chat-export.zip --fingerprint TRUSTED_SHA256.
  • Simpan titik pemeriksaan: jaga agar batas jurnal yang ditandatangani tetap berada di luar pengumpul.
  • Unduh tanda terima eksekusi yang ditandatangani: simpan catatan program/versi pengumpul.
  • Siapkan permintaan cap waktu: siapkan permintaan offline kepada otoritas cap waktu; ikuti panduan di TIMESTAMP.md untuk memperoleh dan memverifikasi respons.
  • Verifikasi jurnal: periksa tanda tangan peristiwa dan tautan rantai. Ekspor ZIP juga memeriksa media.

Browser yang didukung dapat menyimpan ekspor berukuran besar langsung ke file yang dipilih. Browser lain hanya dapat menyimpan dalam buffer maksimal 128 MiB. Selama server berjalan, CLI streaming mendukung unduhan berukuran lebih besar tanpa perlu menyimpan seluruh respons dalam buffer:

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

Untuk ruang kerja lain, tambahkan --profile ID menggunakan Ekspor → ID Ruang Kerja. Untuk server jarak jauh, tambahkan --url https://your-server. Batas transfer default adalah 5 GiB; --max-mib mengubahnya. Konten ZIP yang ditandatangani memiliki batas verifikasi terkompresi terpisah sebesar 4 GiB secara default (More tools → Parameters menaikkannya; verifikasi arsip semacam itu dengan verify.py --max-gib N). Verifikasi arsip menggunakan salinan verifier yang tepercaya, sidik jari kunci yang disimpan secara independen, dan, sebagai bukti minimal, sertifikat akar otoritas cap waktu (--tsa-ca).

Periksa proses instalasi#

python start.py --setup-only
python start.py --check
python start.py --check --json

--check memeriksa dependensi lokal, dukungan penandatanganan, penyimpanan, konfigurasi kunci, dan alamat pendengar. Alat ini tidak menginstal apa pun atau terhubung ke Telegram. Port yang sedang digunakan mungkin menandakan adanya instance lain yang sedang berjalan. Gunakan --port yang berbeda atau hentikan instance tersebut terlebih dahulu.

Launcher diinstal ke .venv. Perintah tambahan python -m tgwitness... harus menggunakan .venv\Scripts\python.exe di Windows atau .venv/bin/python di Linux/macOS, kecuali jika lingkungan tersebut sudah diaktifkan.

Sesi, perlindungan, dan pengoperasian#

Sebuah .session Telethon SQLite yang tertutup dan konsisten dapat dikonversi secara lokal dengan python -m tgwitness.sessions account.session --out account.tgwitness-session, kemudian dimuat di More tools → Account → Files. Impor berkas langsung dan login QR juga tersedia. Lihat CONNECTION-SECURITY.md untuk format login, SOCKS5, HTTP CONNECT, MTProxy, dan kunci utama eksternal.

Menjeda pengamatan akan menghentikan pengumpulan data. Mengunci hanya menutup akses browser. Menutup tab tidak menghentikan proses pengumpul data. Menghentikan proses akan menghentikan pengumpulan data; cuplikan riwayat tidak dapat merekonstruksi semua pengeditan atau penghapusan yang terlewatkan. Lihat cara kerja pengumpulan data terkait kebijakan peristiwa, antrian lampiran, isolasi akun, dan perilaku saat dimulai ulang.

Sesi dan rahasia dienkripsi. Isi pesan, media, dan ekspor memerlukan disk atau volume terenkripsi. Verifikasi tanda tangan jurnal terhadap kunci tepercaya dan simpan titik pemeriksaan secara terpisah. Tinjau catatan penangkapan, bukti waktu eksternal, dan pernyataan lingkungan untuk mode pengumpulan yang dipilih.

Baca OPERATIONS.md untuk pencadangan/pemulihan, DEPLOYMENT.md untuk hosting, dan deploy/ untuk contoh layanan. Panel yang telah diinstal juga menyertakan panduan pengaturan offline di /guide.html.

Verifikasi aktual dan batasan yang masih ada dicatat dalam berkas VERIFICATION.md dan READINESS.md.