Referensi / Pengaturan
Telegram · Penerapan
Jalankan TgWitness sebagai layanan di Windows, Linux, macOS, atau Docker, melalui HTTPS, dengan fitur pencadangan dan pembaruan.
Bahasa Inggris · Русский · Ukraina · Español · Português (Brasil) · Bahasa Turki · العربية · فارسی · Urdu · Hindi · Bahasa Indonesia · Bahasa Vietnam · Bahasa Mandarin (Sederhana)
Pilih metode instalasi#
Untuk paket portabel, ekstrak TgWitness-<version>-windows-amd64-portable.zip dari
GitHub Releases. Untuk metode lainnya, unduh dan ekstrak berkas ZIP sumber atau kloning
repositori, lalu jalankan perintah berikut dari direktori proyek:
| Instalasi | Mulai | Berjalan di latar belakang? |
|---|---|---|
| Paket portabel untuk Windows | TgWitness.cmd |
Tidak; biarkan jendela tetap terbuka. |
| Aplikasi asli Windows | Start.cmd |
Tidak; gunakan tugas masuk opsional untuk penggunaan di latar belakang. |
| Dukungan asli untuk Linux/macOS | sh start.sh |
Tidak; gunakan systemd/launchd untuk penggunaan di latar belakang. |
| Docker di host apa pun yang didukung | docker compose up -d --build --wait |
Ya, selama daemon Docker sedang berjalan. |
| Pembantu Docker di Windows | scripts\Docker.cmd |
Ya; program bantu tersebut menunggu status kesehatan server web. |
| Pembantu Docker di Linux/macOS | sh scripts/docker-start.sh |
Ya; program bantu tersebut menunggu status kesehatan server web. |
Untuk server cloud yang dapat diperiksa oleh pihak ketiga — dibuat melalui API penyedia layanan, tanpa SSH, dan hanya dapat diakses melalui Cloudflare Tunnel — lihat penerapan dengan jaminan tinggi.
Proses startup asli membuat .venv pribadi dan menginstal dependensi yang disematkan.
Docker membangunnya di dalam gambar, tanpa memerlukan Python host. Pengaturan pertama kali
memerlukan akses internet. Jika Python 3.11+ tidak ditemukan, Start.cmd akan meminta izin sebelum
menginstal Python 3.12 untuk pengguna Windows saat ini (menggunakan winget, atau jika tidak, penginstal python.org
setelah memeriksa tanda tangan Python Software Foundation-nya); alat ini tidak pernah meminta
hak akses administrator. Docker dan layanan sistem operasi tetap menjadi prasyarat.
Instalasi native dan portabel menggunakan data/live di dalam foldernya. Docker menggunakan volume bernama tgwitness-data
di /data. Ini adalah instalasi terpisah hingga Anda secara sengaja memigrasikan
direktori data secara keseluruhan. Jangan berharap kontainer Docker baru akan mendeteksi akun native
secara otomatis.
Persyaratan instalasi#
Instalasi asli memerlukan Python 3.11 atau yang lebih baru dengan venv dan ensurepip, akses
internet untuk instalasi dependensi pertama, serta direktori proyek yang dapat ditulis untuk
.venv. Panel yang disertakan tidak memerlukan Node.js atau build frontend. Jalankan peluncur dari
akun OS biasa Anda; TgWitness tidak memerlukan hak akses administrator/root.
- Windows:
Start.cmdmemeriksapy -3, lalupython, kemudian folder instalasi default per-pengguna dan Program Files, serta memerlukan versi 3.11 atau yang lebih baru. Jika tidak ada yang berhasil, maka akan ditawarkan instalasi otomatis per-pengguna seperti yang dijelaskan di atas.py -3 start.pyjuga berfungsi. Paket portabel sama sekali tidak memerlukan Python. - Linux:
start.shmencobapython3.13,python3.12,python3.11,python3, danpython, serta menampilkan perintah instalasi untuk apt, dnf, pacman, zypper, apk, atau Homebrew jika tidak ada yang memenuhi syarat. Instalasi Debian/Ubuntu mungkin memerlukan paketpython3-venvyang sesuai dengan interpreter yang dipilih. Python bawaan versi lama pada suatu distribusi harus diganti atau dilengkapi dengan Python 3.11+. - macOS: instal distribusi Python 3.11+ terbaru; jangan berasumsi bahwa
interpreter yang disediakan sistem operasi sudah memenuhi persyaratan. Gunakan
python3 start.pydari direktori proyek. - Docker: gunakan Docker Engine/Desktop dengan Compose v2.20 atau yang lebih baru. Docker Desktop harus menggunakan kontainer Linux di Windows. Kontainer tersebut menginstal ketergantungan Python-nya sendiri; host tidak memerlukan instalasi Python terpisah.
Komputer lokal#
Gunakan Start.cmd di Windows atau sh start.sh di Linux/macOS. scripts\Setup.cmd atau
sh start.sh --setup-only mempersiapkan
lingkungan. Peluncur akan menginstal dependensi pada penggunaan pertama; peluncuran selanjutnya
akan menggunakan kembali lingkungan tersebut. Akses internet diperlukan untuk pengaturan dan pengumpulan pesan Telegram,
namun penelusuran catatan yang ada dan pembuatan ekspor dapat dilakukan secara offline.
Jalankan python start.py --check setelah pengaturan untuk memeriksa dependensi lokal, Ed25519,
penyimpanan, konfigurasi kunci, dan alamat pendengar tanpa memulai pengumpul.
Gunakan --json untuk keluaran terstruktur. Jalankan --data-dir, --host, dan
--port sesuai kebutuhan. Pemeriksaan ini tidak menginstal paket, membuat jurnal, atau menghubungkan Telegram;
ini bukan penilaian integritas atau cakupan. Proses startup memverifikasi secara terpisah
jurnal yang sudah ada. python start.py --help juga menghindari instalasi.
Setelah menjalankan start.py, jalankan perintah tambahan dengan .venv\Scripts\python.exe di
Windows atau .venv/bin/python di Linux/macOS, atau aktifkan lingkungan tersebut terlebih dahulu.
Contoh python -m ... di bawah ini mengasumsikan bahwa lingkungan tersebut sudah aktif.
python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787
Variabel lingkungan: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE memilih mode kunci eksternal untuk instalasi baru; lihat Kunci utama eksternal. TGWITNESS_TOKEN, jika disediakan, harus berisi setidaknya 24 karakter; gunakan nilai acak yang dihasilkan secara kriptografis. Tanpa variabel tersebut, aplikasi akan menghasilkan token acak 256-bit di file panel-token.txt. Penggantian variabel lingkungan tidak akan menimpa file tersebut. Mulai ulang untuk merotasi kredensial.
Tepat satu proses saja yang boleh mengelola direktori data. Kunci file lintas platform OS mencegah penulisan bersamaan yang tidak disengaja. Gunakan satu pekerja Uvicorn. Panel dapat mengelola sejumlah ruang kerja, dengan direktori ruang kerja tambahan di bawah profiles/<id>/. Untuk instance layanan yang terpisah, gunakan direktori dan port yang terpisah. File WAL SQLite harus disimpan di penyimpanan lokal yang persisten, bukan di sistem berkas jaringan. Jangan berbagi satu volume di antara replika.
Paket portabel untuk Windows#
Setiap Rilis GitHub menyertakan TgWitness-<version>-windows-amd64-portable.zip dan
.sha256-nya. Rilis tersebut berisi runtime Python 3.12 resmi yang dapat disematkan dari python.org
(checksum yang disematkan dalam tools/build_portable.py), TgWitness beserta dependensinya yang disematkan,
serta tiga peluncur:
| Berkas | Tujuan |
|---|---|
TgWitness.cmd |
Jalankan panel; opsi tambahan diteruskan, misalnya TgWitness.cmd --port 8790 |
TgWitness-Demo.cmd |
Jalankan demo sintetis di data\demo |
TgWitness-Check.cmd |
Jalankan pemeriksaan kesiapan tanpa memulai |
Kamus morfologi bahasa Rusia yang disematkan dan profil warna PDF disertakan untuk
penggunaan offline. Pengemasan hanya mengizinkan jalur file yang diketahui di dalam direktori dependensi
data; file yang tidak terduga di direktori tersebut akan menyebabkan proses build gagal.
Ekstrak seluruh arsip ke folder yang dapat ditulis seperti Documents\TgWitness; jangan jalankan
dari dalam ZIP atau dari Program Files. Runtime menggunakan jalur modul yang terisolasi,
sehingga instalasi Python lain dan PYTHONPATH tidak memengaruhinya. Data tetap berada di
folder data dalam paket tersebut. Untuk memperbarui, hentikan TgWitness, ekstrak versi baru ke
folder baru, lalu salin folder data ke sana.
Buat sendiri di Windows 64-bit dengan Python 3.12:
python tools/build_portable.py
Kontainer#
docker compose up -d --build --wait
Ini membuat volume persisten bernama untuk /data.
Port web dipetakan ke 127.0.0.1:8787. Proses berjalan sebagai UID 10001 dengan
kemampuan yang dihapus, sistem berkas root hanya-baca, serta /data dan /tmp yang dapat ditulis.
--wait memeriksa kesehatan server web sebelum mengembalikan hasil; otorisasi dan
pengiriman Telegram muncul di panel. Pembantu yang disediakan menggunakan batas waktu kesiapan 180 detik
setelah proses pembangunan. Pengunduhan dependensi awal mungkin memakan waktu lebih lama dari itu.
Kedua berkas Compose dasar menggunakan nama proyek tgwitness, sehingga mengekstrak rilis baru
ke direktori lain tidak secara otomatis memilih volume data baru. Pertahankan hanya satu
penyebaran yang aktif untuk proyek tersebut. Untuk instalasi independen, gunakan
docker compose -p NAME ... yang unik dan port host yang berbeda, serta pertahankan keduanya saat pembaruan.
Untuk penyebaran yang lebih lama yang menggunakan nama proyek berbeda, lanjutkan menggunakan
nama aslinya dengan -p; docker compose ls mencantumkan proyek-proyek yang ada.
Salin deploy/env.example ke .env dan ubah TGWITNESS_PORT agar menggunakan
port loopback yang berbeda. Misalnya, TGWITNESS_PORT=8788 menampilkan panel di
http://127.0.0.1:8788; kontainer tersebut tetap mendengarkan di port 8787. .env diabaikan oleh Git.
Ambil token awal:
docker compose exec tgwitness cat /data/panel-token.txt
Perintah yang berguna:
docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait
restart: unless-stopped akan memulai ulang pengumpul setelah terjadi crash atau daemon Docker
dimulai ulang. Pada server Linux, aktifkan Docker saat boot menggunakan pengelola layanan
distribusi Anda, umumnya sudo systemctl enable --now docker. Pada Windows/macOS, aktifkan
pengaturan "start-at-sign-in" di Docker Desktop. Keluar dari desktop, mode tidur, atau
Docker daemon yang dihentikan dapat mengganggu proses pengumpulan data. Kontainer yang dihentikan secara eksplisit akan tetap
dihentikan hingga Anda menjalankannya kembali.
Volume /tmp dibatasi hingga 512 MiB dalam konfigurasi contoh ini. Proses ekspor
sebaliknya menggunakan direktori `temporary-exports/` di setiap ruang kerja pada partisi permanen /data. Sediakan ruang
di sana untuk ekspor simultan, pertumbuhan jurnal/WAL, media, dan cadangan.
Launcher menggunakan berkas `deploy/constraints.txt` untuk mengunci versi dependensi runtime yang memenuhi syarat.
Server Docker dan server dengan jaminan tinggi melakukan instalasi berdasarkan deploy/requirements.lock dan
deploy/build.lock dengan perintah pip --require-hashes: setiap berkas paket harus sesuai dengan nilai SHA-256
yang tercatat dalam commit, sehingga berkas yang diganti di PyPI atau cermin akan ditolak. Paket yang
hanya menyediakan kode sumber (jieba, pyaes) dibangun dengan setuptools yang ditetapkan dalam deploy/build.lock
(`--no-build-isolation`) oleh peluncur, pembangun portabel Windows, dan Dockerfile,
sehingga pip tidak menyelesaikan lingkungan pembangunan terpisah yang tidak ditetapkan. Gambar dasar Python
dan paket sistem operasi masih memerlukan kualifikasi rilis yang independen.
Jangan gunakan perintah `docker compose down -v` kecuali Anda bermaksud menghancurkan jurnal dan kunci tersebut. Laporan kesehatan kontainer menunjukkan ketersediaan server web, bukan keberhasilan penangkapan pesan Telegram. Periksa status pengumpul, detak jantung, kesalahan, dan peristiwa cakupan pada panel.
Profil saksi independen#
Layanan opsional witness menjalankan saksi independen di
kontainernya sendiri, dengan kunci dan jurnal tersendiri di volume witness-data serta hanya memiliki
token saksi yang hanya dapat dibaca untuk pengumpul. Buat token tersebut di panel di bawah More tools → Extras → Independent witness, tambahkan
dengan token bot dan saluran ke .env, lalu jalankan profil:
docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag
docker compose logs witness # witness key fingerprint
Layanan ini terhubung ke pengumpul di dalam jaringan Compose di http://tgwitness:8787
(TGWITNESS_WITNESS_COLLECTOR
menggantikannya, misalnya /profiles/<workspace ID>
untuk
ruang kerja lain). Untuk saksi di server terpisah yang dijalankan oleh pihak lain, gunakan
deploy/compose/compose.witness.yaml
di sana dengan TGWITNESS_WITNESS_COLLECTOR
disetel ke alamat HTTPS
pengumpul; berkas tersebut hanya berisi saksi.
Instal gambar yang telah dipublikasikan#
Salin deploy/env.example ke .env. Atur TGWITNESS_IMAGE ke versi yang telah dipublikasikan, dengan menggunakan
jalur repositori huruf kecil, misalnya:
TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787
Jalankan berkas ini secara mandiri, bukan 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
Tidak diperlukan build sumber, Python, atau kompiler di host. Alur kerja rilis
ditujukan untuk kontainer Linux AMD64 dan ARM64, termasuk VM Linux di Docker Desktop.
Gunakan tag versi atau ghcr.io/owner/repository@sha256:... dari ringkasan alur kerja.
Tidak ada konfigurasi untuk pemindahan tag latest atau pembaruan aplikasi tanpa pengawasan.
Variasi gambar dan sumber menggunakan volume data yang sama jika nama proyeknya sama.
HTTPS otomatis di server#
Gunakan server dengan Docker, domain yang Anda kendalikan, dan penyimpanan lokal yang persisten. Arahkan catatan A/AAAA domain ke server; publikasikan AAAA hanya jika IPv6 menjangkau server tersebut. Izinkan lalu lintas masuk TCP 80 dan 443 serta lalu lintas keluar DNS/HTTPS untuk penerbitan sertifikat. Layanan lain tidak boleh sudah menggunakan port-port ini.
Salin deploy/env.example ke .env dan tetapkan nama host, tanpa skema atau jalur:
TGWITNESS_DOMAIN=watch.your-domain.org
Mulai proses kompilasi sumber dengan overlay 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
Untuk gambar yang dipublikasikan, gunakan deploy/compose/compose.image.yaml sebagai file pertama. Pertahankan
kedua argumen -f untuk perintah status, log, pembaruan, dan hentikan di kemudian hari.
Caddy memperoleh dan memperbarui sertifikat, mengalihkan HTTP ke HTTPS, serta meneruskan permintaan ke pengumpul di jaringan Compose pribadi. Status sertifikat memiliki volume persisten tersendiri. Port host langsung pengumpul tetap hanya untuk loopback. Konfigurasi Caddy yang disediakan tidak mengaktifkan pencatatan akses.
Buka https://watch.your-domain.org dan masukkan token panel. Persiapan
mencakup kontainer; penerbitan sertifikat dan jangkauan eksternal bergantung pada DNS
dan firewall. Jika HTTPS belum siap, periksa DNS, aturan firewall, dan:
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy
Gambar Caddy yang disediakan mengikuti tag 2-alpine-nya. Melakukan pull akan memperbarui gambar tersebut;
sematkan ringkasan yang telah diuji dalam deployment Anda jika Anda memerlukan versi infrastruktur yang tetap.
Pembaruan dan pencadangan#
Pertahankan nama proyek Compose dan volume data di seluruh pembaruan. Pertama, hentikan pengumpul dan buat cadangan lengkap. Untuk penyebaran berbasis sumber default:
docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update
Gunakan tujuan cadangan baru setiap kali, di luar repositori, dan lindungi sebagai materi yang memerlukan akses akun. Jalur contoh hanya sebagai ilustrasi; gunakan lokasi cadangan pribadi Anda. Salin seluruh direktori, termasuk file tersembunyi, semua ruang kerja, kunci, jurnal, dan media. Cadangkan kunci utama brankas eksternal secara terpisah jika telah dikonfigurasi. File ZIP bukti bukanlah cadangan aplikasi yang dapat dipulihkan. Untuk HTTPS, simpan juga volume Caddy jika Anda perlu mempertahankan status sertifikat/akunnya.
Untuk penerapan sumber, unduh berkas rilis terbaru dan jalankan:
docker compose up -d --build --wait
Untuk penerapan gambar, ubah TGWITNESS_IMAGE menjadi versi yang diinginkan, lalu jalankan:
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
Gunakan berkas Compose pada instalasi Anda untuk perintah stop/copy di atas juga.
Pertahankan .env, konfigurasi khusus, dan nama proyek yang sama. down mempertahankan
volume yang diberi nama; down -v menghapusnya. Jangan menyalin .venv antar sistem operasi
atau versi Python. Untuk pembaruan asli, hentikan TgWitness, buat cadangan direktori data lengkapnya
, ganti berkas sumber, dan jalankan python start.py --setup-only sebelum meluncurkan.
Periksa akses panel, identitas akun, status pengamatan, dan cakupan setelah pembaruan. Setelah dimulai ulang, TgWitness melanjutkan posisi pembaruan Telegram yang disimpan dan meminta pembaruan yang terlewatkan selama proses pembaruan. Pengembalian ke versi sebelumnya mungkin memerlukan cadangan sebelum pembaruan jika versi mendatang mengubah format penyimpanan.
Server jarak jauh#
Jaga agar layanan tetap terikat pada loopback dan gunakan terowongan SSH, atau hentikan HTTPS di
proksi terbalik. Berkas Compose dasar hanya berlaku secara lokal; overlay
deploy/compose/compose.https.yaml opsional menyediakan Caddy untuk domain yang telah dikonfigurasi.
Jaga agar token bearer tidak muncul di URL dan log proxy. Proksi terbalik harus membatasi
ukuran permintaan dan laju koneksi. Jangan mengekspos HTTP biasa ke Internet.
Contoh untuk systemd, tugas masuk Windows, agen pengguna macOS, dan Caddy disediakan di folder deploy/. Periksa/sesuaikan jalurnya sebelum instalasi. Ini adalah templat yang disediakan, bukan konfigurasi platform yang dijalankan secara lokal. Tidak ada layanan latar belakang atau tugas yang didaftarkan oleh peluncur standar.
Di Windows, peluncuran pythonw.exe tanpa jendela menyimpan diagnostik startup/server di
logs/server.log di bawah direktori data (5 MiB per file, dua cadangan yang digilir).
Peluncuran konsol tetap menyimpan log konsol. Pencatatan akses HTTP dinonaktifkan di kedua
mode tersebut. Lindungi log dengan direktori data dan tinjau terlebih dahulu sebelum membagikannya.
Mulai ulang dan celah#
Status pengamatan terakhir yang diminta akan disimpan. Jika pengamatan sedang aktif, saat startup akan mencoba terhubung kembali dan melanjutkan sumber-sumber yang dipilih. Penundaan manual akan menghapus niat tersebut. Kegagalan restart akan dicatat dan ditampilkan di panel.
TgWitness menyimpan posisi pembaruan Telegram untuk akun dan setiap saluran (pts, qts, seq, dan tanggal) di brankas ruang kerja dan memulihkannya saat dimulai kembali. Klien kemudian meminta pembaruan yang terlewat saat proses dihentikan, dan pemeriksaan berkala memulihkan pesan yang terlewat serta mencatat pesan yang telah disimpan yang tidak lagi dikembalikan oleh Telegram. Dialog dimuat ulang saat dimulai. Setiap kali dimulai, sistem mencatat kepala jurnal sebelumnya, batas offline, dan posisi pembaruan tempat proses dilanjutkan. Monitor memeriksa konektivitas setiap 10 detik dan menambahkan sinyal detak jantung setiap menit (Alat Lainnya → Parameter → Catat Keaktifan setiap). Pemutusan koneksi dan periode tanpa aktivitas dicatat sebagai celah cakupan beserta alasannya. Cuplikan riwayat disimpan sebagai pengamatan riwayat terkini terpisah di samping catatan langsung.
Antrian media disimpan dalam basis data SQLite masing-masing ruang kerja. Sebuah pesan dan tugasnya dikomitmen secara atomik. Tugas yang sedang berjalan dan terputus akan dipulihkan untuk dicoba ulang saat dimulai. Setiap unduhan memiliki batas waktu dasar 120 detik ditambah waktu sesuai kecepatan 256 KiB/s berdasarkan ukurannya, serta 1–2,000 MiB per jenis lampiran; batas waktu, kecepatan, dan upaya ulang dapat diatur di Alat Lainnya → Parameter. Pengumpul akan melewati berkas yang ukurannya tidak diketahui. Menjeda akan mempertahankan pekerjaan yang sedang dalam antrian. Upaya ulang menggunakan deskriptor berkas asli yang teramati, bukan versi terbaru dari pesan yang telah diedit setelahnya. Kegagalan sementara memiliki batasan upaya ulang; jeda FloodWait media akan tetap berlaku setelah dimulainya ulang. Pemulihan media terpisah dari pemulihan pembaruan Telegram dan tidak dapat memulihkan berkas yang telah hilang.
Pencadangan, pemulihan, dan kapasitas#
tgwitness backup FOLDER
menyalin direktori data sementara panel tetap berjalan:
pertama-tama checkpoint, lalu berkas SQLite melalui API pencadangan daring, kemudian kunci, media, dan
profil, sehingga tidak ada checkpoint yang disalin yang lebih baru daripada jurnal yang disalin. backup-manifest.json
mencantumkan nilai SHA-256 setiap berkas dan header jurnal. Untuk memulihkan, hentikan TgWitness dan ganti
seluruh direktori data dengan folder tersebut. Saat dimulai kembali, sistem akan mencatat bahwa jurnal dipulihkan
dari salinan yang lebih lama. Catatan tersebut membandingkan jurnal dengan header yang disimpan di
TGWITNESS_STATE_DIR
, sebuah folder di luar direktori data: volume tgwitness-state
di
Compose, /var/lib/tgwitness-state
di unit systemd, dan folder status lokal pengguna
jika tidak. Tanpa folder status yang dapat ditulis, pemulihan tidak akan terdeteksi dan log akan menampilkannya sekali.
Tanpa perintah tersebut, hentikan proses sebelum menyalin seluruh direktori data, termasuk vault.key, signing.enc, credentials.enc, file basis data SQLite/WAL, media, token, titik pemeriksaan, dan semua subdirektori profiles/. Pulihkan salinan lengkap tersebut saat layanan tujuan dalam keadaan berhenti. Kunci vault yang hilang atau ketidaksesuaian kunci penandatanganan akan menyebabkan kegagalan saat memulai; jangan membuat ulang kunci untuk memaksa akses.
Simpan cadangan rahasia dalam bentuk terenkripsi dan dengan kontrol akses. Berkas ZIP bukti bersifat portabel; tinjau artefak, bukan cadangan aplikasi atau cadangan sesi Telegram. Tidak ada penghapusan otomatis berdasarkan masa retensi. Rencanakan ruang disk untuk semua pesan, metadata mentah, media, ekspor sementara, dan cadangan.
Lakukan verifikasi saat startup dan ekspor catatan aliran alih-alih memuat seluruh jurnal.
Ekspor mengunci snapshot yang dibaca sementara penulisan WAL baru dapat berlanjut; ekspor yang berlangsung lama
dapat mempertahankan halaman WAL, sehingga kapasitas disk tetap menjadi pertimbangan. Ukuran ZIP dibatasi hingga 4 GiB
dalam bentuk tidak terkompresi agar sesuai dengan pengaturan default verifikator independen; Alat Lainnya → Parameter → ZIP Bertanda Terbesar
meningkatkan batas tersebut, dan arsip semacam itu diverifikasi dengan verify.py --max-gib N. Format lain tidak memiliki batasan jumlah peristiwa.
Browser yang didukung mengalirkan potongan respons ke berkas yang dipilih pengguna. Browser lain
menyimpan dalam buffer maksimal 128 MiB dan mengalihkan transfer yang lebih besar ke CLI yang terotentikasi:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
Gunakan --profile ID dari Ekspor → ID Ruang Kerja untuk ruang kerja lain,
--format zip|jsonl|csv|html, --url https://your-server untuk server jarak jauh, atau
--max-mib untuk mengubah batas transfer 5 GiB. HTTP biasa hanya diizinkan untuk
loopback. Token dikirim melalui header, pengalihan ditolak, file yang sudah ada
tidak ditimpa, dan unduhan yang belum selesai tidak dipublikasikan sebagai file yang sudah selesai.
Jika TGWITNESS_TOKEN menggantikan token yang dihasilkan, gunakan berkas yang dilindungi secara terpisah
yang berisi nilai aktif tersebut: panel-token.txt tidak akan ditimpa oleh penggantian tersebut.
SHA-256 perintah ini hanyalah checksum transfer; verifikasi ZIP yang ditandatangani secara independen.
Panel menampilkan media yang sedang dalam antrian/gagal, media tertunda tertua, ruang disk kosong, jeda permintaan Telegram, dan sumber yang aksesnya belum dikonfirmasi. Diagnostik ini bukanlah pemantau pengiriman end-to-end yang lengkap. Ruang kerja berbagi proses; akun yang aktif masih dapat memengaruhi yang lain. Proses pekerja terpisah, retensi/rotasi, pemulihan pembaruan yang tahan lama, serta kualifikasi penerapan penuh tetap berlaku. Akses panel yang dibatasi didokumentasikan dalam bagian akses dan izin; titik pemeriksaan independen dijelaskan dalam panduan saksi.
Prosedur terperinci: koneksi/keamanan dan mode operasi.