TgWitness / Dokumentasi

Apa yang telah diuji →

Referensi / Pengaturan

Telegram · Penerapan

Jalankan TgWitness sebagai layanan di Windows, Linux, macOS, atau Docker, melalui HTTPS, dengan fitur pencadangan dan pembaruan.

TgWitness / Dokumentasi

Penerapan & pemulihan

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.cmd memeriksa py -3, lalu python, 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.py juga berfungsi. Paket portabel sama sekali tidak memerlukan Python.
  • Linux: start.sh mencoba python3.13, python3.12, python3.11, python3, dan python, serta menampilkan perintah instalasi untuk apt, dnf, pacman, zypper, apk, atau Homebrew jika tidak ada yang memenuhi syarat. Instalasi Debian/Ubuntu mungkin memerlukan paket python3-venv yang 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.py dari 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.