TgWitness / Dokumentasi

Apa yang telah diuji →

Rujukan / Pemasangan

Telegram · Permulaan pantas

Setiap cara untuk memasang dan melancarkan TgWitness: pakej Windows, Python, Docker dan demo sintetik, dengan pemeriksaan awal.

TgWitness / Dokumentasi

Memulakan

Inggeris · Bahasa Rusia · Bahasa Ukraine · Sepanyol · Portugis (Brazil) · Bahasa Turki · Bahasa Arab · Bahasa Parsi · Urdu · Hindi · Bahasa Indonesia · Bahasa Vietnam · Teks ringkas Cina

TgWitness adalah aplikasi berdiri sendiri untuk memerhati kumpulan dan saluran Telegram yang boleh diakses oleh akaun anda. Ia berjalan secara tempatan dengan direktori data tersendiri.

Lawatan pertama kali? Terokai demo sebelum menyambungkan akaun. Pilih panduan untuk proksi, saksi, eksport atau penyediaan pelayan. GitHub Actions capture (pratinjau) menjalankan tangkapan dalam GitHub fork anda sendiri bukannya pemasangan tempatan.

Pasang dan mulakan#

Pemasang berpandu merangkumi Python tersendiri dan menyemak has ratus pakej serta tandatangan keluaran sebelum memasang. Menjalankannya semula mengemas kini pemasangan sedia 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"

Pada pelayan Ubuntu, jalankan sebagai root untuk memasang perkhidmatan latar belakang; pada desktop, jalankan sebagai pengguna biasa anda. Pada Ubuntu, pemasang mencetak alamat panel dan kunci capaian; pada macOS dan Windows, panel tempatan dibuka dalam pelayar anda. Sambung di Sambungkan Telegram di bawah. Pasang, sahkan dan kemas kini merangkumi pilihan capaian pelayan, memeriksa skrip sebelum menjalankannya, kemas kini dan penyingkiran.

Kaedah lain#

Pelepasan GitHub, sumber dan Docker adalah alternatif kepada pemasang. Muat turun boleh dibawa menjadi tersedia selepas binaan pelepasan diterbitkan:

Penyedia hos Tiada pemasangan Daripada sumber: Python 3.11+ Docker: Engine/Desktop dengan Compose 2.20+
Windows Ekstrak TgWitness-<version>-windows-amd64-portable.zip daripada 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 kaedah kod sumber, muat turun dan ekstrak main semasa atau klon repositori:

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

Start.cmd menawarkan pemasangan Python 3.12 untuk pengguna Windows anda jika tiada Python yang sesuai ditemui (winget, atau pemasang python.org yang ditandatangani). start.sh mencetak arahan pemasangan yang tepat untuk edaran Linux atau macOS anda jika Python tiada. Pelancaran sumber pertama akan mencipta .venv dan memasang kebergantungan secara automatik.

Docker membina aplikasi dan memulakannya di latar belakang; Python hos tidak diperlukan. scripts\Docker.cmd dan scripts/docker-start.sh mencetak alamat panel dan token apabila kontena sihat. Perintah Docker yang setara pada setiap hos yang disokong ialah:

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 pembantu Docker atau arahan Docker kedua, atau baca data/live/panel-token.txt untuk pemasangan mudah alih atau sumber. Teruskan di Sambungkan Telegram di bawah. Pemasangan asli dan Docker menggunakan storan berasingan; memulakan Docker tidak mengimport jurnal asli sedia ada.

Untuk pelayan, penyebaran merangkumi HTTPS automatik, permulaan semula, imej yang diterbitkan, kemas kini, dan sandaran.

Terokai antaramuka#

  1. Jalankan TgWitness-Demo.cmd dalam pakej mudah alih, scripts\Demo.cmd dalam folder sumber Windows, atau sh start.sh --demo pada Linux/macOS. Pelancaran sumber pertama kali mencipta .venv dan memasang kebergantungan.
  2. Buka http://127.0.0.1:8787.
  3. Demo tempatan membuka jurnal sampel secara automatik. Tiada salinan token diperlukan untuk akses tempatan secara langsung.

Mesej demo adalah rekaan. Mod demo tidak dapat menyambungkan akaun Telegram sebenar.

Sambungkan Telegram#

[!AMARAN] Gunakan akaun khusus. Telegram boleh mengehadkan atau mengharamkan akaun secara kekal untuk jumlah permintaan yang dianggap berlebihan, tidak kira klien apa pun. Sambungkan akaun yang disediakan untuk pemerhatian dan bukannya akaun peribadi atau berharga, dan cipta ID/hash API pada akaun khusus.

  1. Jika demo asli sedang berjalan, hentikannya dan jalankan Start.cmd atau sh start.sh. Jika tidak, biarkan pemasangan langsung yang sedang berjalan di atas terus berjalan.
  2. Gunakan token panel untuk log masuk. Ruang kerja baharu dibuka; tetapkan pertama kali. Pilih Muat turun sahaja, Ikut sembang atau Bukti untuk kes.
  3. Semak semula pemeriksaan sambungan. Konfigurasikan proksi anda sendiri jika perlu; tetapan sambungan kekal tersedia selepas penyediaan.
  4. Pada Connect Telegram, pilih nombor telefon, kod QR, fail akaun (TData, .session, StringSession, JSON akaun) atau kunci kebenaran lengkap. Lengkapkan pengesahan Telegram, kod dan kata laluan dua langkah apabila diminta.
  5. Semak akaun yang dipaparkan, pilih sembang dan semak tetapan anda. Selesai daripada skrin akhir. Untuk Just download, Start export memulakan eksport sekali sahaja dan membuka Eksport untuk memaparkan kemajuannya; ia tidak membolehkan pemerhatian berterusan.

Selepas penyediaan, Chats → Choose menukar sembang yang dipilih. Settings mengawal pengumpulan dan fail; More tools → Sources menyediakan senarai sumber terperinci pada tahap Standard atau Pakar. Panduan panel menerangkan enam bahagian utama dan kawalan kontekstual mereka.

ID API + Hash adalah pilihan: ruang kerja menggunakan pasangan yang disimpan atau diimport, atau pasangan kerja daripada kolam terbina dalam. Untuk menggunakan aplikasi anda sendiri, tampal satu pasangan API ID:API Hash ke dalam ID API. Untuk kunci Auth, tampal semua 512 aksara heksadesimal dan pilih ID DC yang disediakan. ID Pengguna adalah pilihan dan akan disemak jika dimasukkan.

Kredensial API mengenal pasti aplikasi anda; ia tidak memberi kebenaran kepada akaun secara sendirinya. Kumpulan peribadi tidak memerlukan nama pengguna awam, tetapi akaun anda mesti mempunyai akses.

Untuk akaun sedia ada, lihat format akaun dan sesi: panel menerima Telethon StringSession, Telethon/Pyrogram SQLite, ZIP TData akaun tunggal, dan JSON akaun yang disokong. Pilih sesi dan JSON pendampingnya sekaligus, tekan Semak fail, kemudian Sambungkan akaun. Log masuk QR juga tersedia dengan tetapan API pilihan yang sama. TDLib, sesi bot dan inventori akaun CSV/JSON tidak disokong.

Untuk beberapa akaun, gunakan Akaun → Import akaun dan pilih fail sesi yang disokong. Fail JSON pengiring dipadankan mengikut nama asas; setiap akaun yang diimport mendapat ruang kerjanya sendiri. Lihat import pukal dan kumpulan akaun.

Untuk menambah akaun lain, tekan + di sebelah pemilih akaun atau gunakan Akaun → Tambah akaun. Ruang kerja mempunyai sesi, jurnal, kunci, sumber dan barisan menunggu yang berasingan. Menukar paparan membiarkan pengumpul lain terus berjalan. Akaun Telegram yang sama tidak boleh diberikan kepada dua ruang kerja dalam pemasangan ini. Tiada bilangan ruang kerja yang tetap; mereka berkongsi satu proses, jadi kapasiti bergantung pada mesin.

Token panel langsung melindungi akses ke kebenaran Telegram dan bahan yang disimpan; ia berasingan daripada kelayakan API Telegram. Hanya demo tempatan yang dimulakan secara eksplisit dan diakses secara langsung mendapat kemasukan automatik. Demo jauh/proksi masih menggunakan data/demo/panel-token.txt.

Semak dan eksport#

  • Jurnal: cari dan tapis pemerhatian mengikut sumber dan jenis peristiwa.
  • Pilih satu acara untuk menyemak rekod asal, atribusi dan versi yang disimpan.
  • Butiran suntingan menunjukkan kandungan sebelum/selepas yang tersedia. Butiran pemadaman menunjukkan kandungan terakhir yang dirakam, jika ada; pelaku yang tidak diketahui kekal tidak diketahui.
  • Eksport: ZIP ber tandatangan, JSONL, CSV dan HTML luar talian.
  • Eksport sembang penuh (Sembang → Eksport sembang, atau Eksport → Rakam atau eksport satu sembang): muat turun keseluruhan sejarah yang boleh dilihat bagi satu sembang sebagai bundel yang disahkan dengan chat.json (gaya eksport Telegram) dan chat.html yang boleh dibaca. Sembang peribadi berfungsi apabila akaun adalah ahli. Ia adalah snapshot semasa, bukan pembinaan semula mesej yang telah dipadam atau disunting sebelum ini. Sahkan salinan dengan python verify.py chat-export.zip --fingerprint TRUSTED_SHA256.
  • Simpan titik pemeriksaan: letakkan sempadan jurnal yang ditandatangani di luar pengumpul.
  • Muat turun resit larian yang disahkan: memelihara rekod program/versi pengumpul.
  • Sediakan permintaan cap masa: sediakan permintaan luar talian kepada pihak berkuasa cap masa; ikuti TIMESTAMP.md untuk mendapatkan dan mengesahkan respons.
  • Sahkan jurnal: periksa tandatangan peristiwa dan pautan rantaian. Eksport ZIP juga memeriksa media.

Pelayar yang disokong menyimpan eksport besar terus ke fail pilihan. Pelayar lain menyimpan dalam tompokan sehingga 128 MiB. Semasa pelayan sedang berjalan, CLI penstriman menyokong muat turun yang lebih besar tanpa menyimpan keseluruhan respons dalam tompokan:

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

Untuk ruang kerja lain, tambahkan --profile ID menggunakan Eksport → ID Ruang Kerja. Untuk pelayan jauh, tambahkan --url https://your-server. Had pemindahan lalai ialah 5 GiB; --max-mib mengubahnya. Kandungan ZIP yang ditandatangani mempunyai had pengesahan berasingan sebanyak 4 GiB secara lalai (Lebih banyak alat → Parameter meningkatkannya; sahkan arkib seperti ini dengan verify.py --max-gib N). Sahkan arkib tersebut menggunakan salinan verifier yang dipercayai, cap jari kunci yang disimpan secara bebas dan, untuk minimum bukti, sijil akar pihak berkuasa cop masa (--tsa-ca).

Semak pemasangan#

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

--check memeriksa kebergantungan tempatan, sokongan penandatanganan, storan, konfigurasi kunci dan alamat pendengar. Ia tidak memasang apa-apa atau menyambung ke Telegram. Pelabuhan yang sibuk mungkin bermakna instans lain sedang berjalan. Gunakan --port yang berbeza atau hentikannya terlebih dahulu.

Pelancar memasang ke dalam .venv. Perintah tambahan python -m tgwitness... mesti menggunakan .venv\Scripts\python.exe pada Windows atau .venv/bin/python pada Linux/macOS, melainkan persekitaran tersebut sudah diaktifkan.

Sesi, perlindungan dan operasi#

.session Telethon SQLite yang tertutup dan konsisten boleh ditukar secara tempatan dengan python -m tgwitness.sessions account.session --out account.tgwitness-session, kemudian dimuatkan dalam More tools → Account → Files. Import fail terus dan log masuk QR juga tersedia. Lihat CONNECTION-SECURITY.md untuk format log masuk, SOCKS5, HTTP CONNECT, MTProxy dan kunci induk luaran.

Pause pemerhatian menghentikan pengumpulan. Mengunci hanya menutup akses pelayar. Menutup tab membiarkan proses pengumpul terus berjalan. Menghentikan proses mengganggu pengumpulan; snapshot sejarah tidak dapat membina semula semua suntingan atau pemadaman yang terlepas. Lihat bagaimana pengumpulan berfungsi untuk dasar acara, barisan lampiran, penasingan akaun, dan tingkah laku permulaan semula.

Sesi dan rahsia disulitkan. Kandungan mesej, media dan eksport memerlukan cakera atau volum yang disulitkan. Sahkan tandatangan jurnal dengan kunci yang dipercayai dan simpan titik pemeriksaan secara berasingan. Semak rekod tangkapan, resit masa luaran dan pengesahan persekitaran untuk mod pengumpulan yang dipilih.

Baca OPERATIONS.md untuk sandaran/pemulihan, DEPLOYMENT.md untuk hosting, dan deploy/ untuk contoh perkhidmatan. Panel yang dipasang juga merangkumi panduan persediaan luar talian di /guide.html

Pengesahan sebenar dan had yang masih ada direkodkan dalam VERIFICATION.md dan READINESS.md.