TgWitness / Dokumentasi

Apa yang telah diuji →

Rujukan / Pemasangan

Telegram · Penyebaran

Jalankan TgWitness sebagai perkhidmatan pada Windows, Linux, macOS atau Docker, di sebalik HTTPS, dengan sandaran dan kemas kini.

TgWitness / Dokumentasi

Penyebaran & pemulihan

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

Pilih pemasangan#

Untuk pakej mudah alih, ekstrak TgWitness-<version>-windows-amd64-portable.zip daripada GitHub Releases. Untuk kaedah lain, muat turun dan ekstrak fail ZIP sumber atau klon repositori, kemudian jalankan arahan berikut dari direktori projek:

Pemasangan Mula Berjalan di latar belakang?
Pakej mudah alih Windows TgWitness.cmd Tidak; biarkan tetingkap terbuka.
Windows asli Start.cmd Tidak; gunakan tugas logon pilihan untuk penggunaan latar belakang.
Bawaan Linux/macOS sh start.sh Tidak; gunakan systemd/launchd untuk kegunaan latar belakang.
Docker pada mana-mana hos yang disokong docker compose up -d --build --wait Ya, selagi daemon Docker berjalan.
Pembantu Docker di Windows scripts\Docker.cmd Ya; pembantu menunggu kesihatan pelayan web.
Pembantu Docker pada Linux/macOS sh scripts/docker-start.sh Ya; pembantu menunggu kesihatan pelayan web.

Untuk pelayan awan yang boleh disemak oleh pihak ketiga — dicipta melalui API penyedia, tanpa SSH, hanya boleh diakses melalui Terowong Cloudflare — lihat penyebaran jaminan tinggi.

Perisian asli mencipta .venv peribadi dan memasang kebergantungan yang dilampirkan. Docker membinanya di dalam imej, tanpa memerlukan Python hos. Persediaan kali pertama perlu akses Internet. Apabila tiada Python 3.11+ ditemui, Start.cmd akan bertanya sebelum memasang Python 3.12 untuk pengguna Windows semasa (winget, jika tidak, pemuat turun python.org selepas memeriksa tandatangan Python Software Foundation); ia tidak pernah meminta keistimewaan pentadbir. Docker dan perkhidmatan OS kekal sebagai prasyarat.

Pemasangan asli dan mudah alih menggunakan data/live di dalam folder mereka. Docker menggunakan volum bernama tgwitness-data di /data. Ini adalah pemasangan berasingan sehingga anda secara sengaja memindahkan direktori data lengkap. Jangan jangkakan kontena Docker baru akan menemui akaun asli secara automatik.

Keperluan pemasangan#

Pemasangan asli memerlukan Python 3.11 atau yang lebih baru dengan venv dan ensurepip, capaian Internet untuk pemasangan kebergantungan pertama, dan direktori projek yang boleh ditulis untuk .venv. Panel terbungkus tidak memerlukan Node.js atau pembinaan frontend. Jalankan pelancar dari akaun OS biasa anda; keistimewaan pentadbir/root tidak diperlukan oleh TgWitness.

  • Windows: Start.cmd memeriksa py -3, kemudian python, kemudian folder pemasangan lalai bagi setiap pengguna dan Program Files, dan memerlukan versi 3.11 atau lebih baru. Jika tiada satu pun berfungsi, ia menawarkan pemasangan automatik bagi setiap pengguna seperti yang diterangkan di atas. py -3 start.py juga berfungsi. Pakej mudah alih tidak memerlukan Python langsung.
  • Linux: start.sh mencuba python3.13, python3.12, python3.11, python3 dan python, dan mencetak arahan pemasangan untuk apt, dnf, pacman, zypper, apk atau Homebrew apabila tiada yang sesuai. Pemasangan Debian/Ubuntu mungkin memerlukan pakej python3-venv yang sepadan dengan penafsir yang dipilih. Python lalai yang lebih lama pada sesuatu pengedaran perlu digantikan atau dilengkapi dengan Python 3.11+.
  • macOS: pasang pengedaran Python 3.11+ terkini; jangan anggap penyahkod yang disediakan oleh OS memenuhi keperluan. Gunakan python3 start.py daripada direktori projek.
  • Docker: gunakan Docker Engine/Desktop dengan Compose v2.20 atau lebih baru. Docker Desktop mesti menggunakan kontena Linux pada Windows. Kontena ini memasang kebergantungan Pythonnya sendiri; hos tidak memerlukan pemasangan Python berasingan.

Komputer tempatan#

Gunakan Start.cmd pada Windows atau sh start.sh pada Linux/macOS. scripts\Setup.cmd atau sh start.sh --setup-only menyediakan persekitaran. Pelancar memasang kebergantungan pada penggunaan pertama; pelancaran kemudian menggunakan semula persekitaran tersebut. Akses internet diperlukan untuk penyediaan dan pengumpulan Telegram, tetapi melayari rekod sedia ada dan mencipta eksport berfungsi secara luar talian.

Jalankan python start.py --check selepas pemasangan untuk memeriksa kebergantungan tempatan, Ed25519, penyimpanan, konfigurasi kunci dan alamat pendengar tanpa memulakan pengumpul. Gunakan --json untuk keluaran berstruktur. Jalankan --data-dir, --host dan --port yang dimaksudkan. Semakan ini tidak memasang pakej, mencipta jurnal atau menyambung ke Telegram; ia bukan kelayakan integriti atau liputan. Permulaan secara berasingan mengesahkan jurnal sedia ada. python start.py --help juga mengelakkan pemasangan.

Selepas menggunakan start.py, jalankan arahan sampingan dengan .venv\Scripts\python.exe pada Windows atau .venv/bin/python pada Linux/macOS, atau aktifkan persekitaran tersebut terlebih dahulu. Contoh python -m ... di bawah menganggap persekitaran tersebut sudah aktif.

python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787

Pembolehubah persekitaran: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE memilih mod kunci luaran untuk pemasangan baru; lihat Kunci induk luaran. TGWITNESS_TOKEN, jika disediakan, mesti mengandungi sekurang-kurangnya 24 aksara; gunakan nilai rawak kriptografi. Tanpa ia, aplikasi menjana token rawak 256-bit dalam panel-token.txt. Penimpaan persekitaran tidak menulis semula fail tersebut. Mulakan semula untuk menukar kelayakan.

Persis satu proses sahaja boleh memiliki direktori data. Kunci fail sistem operasi rentas platform menghalang penulis serentak secara tidak sengaja. Gunakan satu pekerja Uvicorn. Panel boleh mengurus sebarang bilangan ruang kerja, dengan direktori ruang kerja tambahan di bawah profiles/<id>/. Untuk instans perkhidmatan berasingan, gunakan direktori dan port berasingan. Fail WAL SQLite harus disimpan pada storan kekal tempatan, bukan pada sistem fail rangkaian. Jangan kongsi satu volum antara replika.

Pakej mudah alih Windows#

Setiap Pelepasan GitHub mengandungi TgWitness-<version>-windows-amd64-portable.zip dan .sha256. Ia mengandungi runtime Python 3.12 rasmi yang boleh disematkan daripada python.org (checksum dipaku dalam tools/build_portable.py), TgWitness dan kebergantungannya yang dipaku, dan tiga pelancar:

Fail Tujuan
TgWitness.cmd Mulakan panel; pilihan tambahan dihantar, contohnya TgWitness.cmd --port 8790
TgWitness-Demo.cmd Mulakan demo sintetik di data\demo
TgWitness-Check.cmd Jalankan pemeriksaan kesiapsiagaan tanpa memulakan

Kamus morfologi Rusia yang dipin dan profil warna PDF disertakan untuk kegunaan luar talian. Pembungkusan hanya membenarkan laluan fail yang diketahui di dalam direktori kebergantungan data; fail yang tidak dijangka dalam direktori tersebut akan menyebabkan pembinaan gagal.

Ekstrak keseluruhan arkib ke dalam folder yang boleh ditulis seperti Documents\TgWitness; jangan jalankan ia dari dalam ZIP atau dari Program Files. Runtime menggunakan laluan modul terasing, jadi pemasangan Python lain dan PYTHONPATH tidak menjejaskannya. Data kekal dalam folder data pada pakej ini. Untuk mengemas kini, hentikan TgWitness, ekstrak versi baru ke dalam folder baru dan salin folder data.

Bina sendiri pada Windows 64-bit dengan Python 3.12:

python tools/build_portable.py

Kontena#

docker compose up -d --build --wait

Ini mencipta volum berterusan bernama untuk /data. Ports web dipetakan ke 127.0.0.1:8787. Proses ini dijalankan sebagai UID 10001 dengan keupayaan yang dikurangkan, sistem fail root hanya-baca, dan /data serta /tmp yang boleh ditulis. --wait menyemak kesihatan pelayan web sebelum memulangkan; kebenaran dan penghantaran Telegram akan muncul di panel. Pembantu yang disediakan menggunakan had masa kesiapsiagaan 180 saat selepas pembinaan. Muat turun kebergantungan awal mungkin mengambil masa lebih lama daripada itu.

Kedua-dua fail asas Compose menggunakan nama projek tgwitness, jadi mengekstrak keluaran baru ke direktori lain tidak akan secara senyap memilih volum data baru. Pastikan hanya satu penyebaran aktif untuk projek tersebut. Untuk pemasangan bebas, gunakan docker compose -p NAME ... yang unik dan port hos yang berbeza, serta kekalkan kedua-duanya semasa kemas kini. Untuk penyebaran lama yang menggunakan nama projek berbeza, teruskan menggunakan nama asal nya dengan -p; docker compose ls menyenaraikan projek sedia ada.

Salin deploy/env.example ke .env dan ubah TGWITNESS_PORT untuk menggunakan port loopback yang berbeza. Sebagai contoh, TGWITNESS_PORT=8788 mendedahkan panel di http://127.0.0.1:8788; kontena masih mendengar di 8787. .env diabaikan oleh Git.

Dapatkan token awal:

docker compose exec tgwitness cat /data/panel-token.txt

Perintah berguna:

docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait

restart: unless-stopped memulakan semula pengumpul selepas kerosakan atau permulaan semula Docker daemon. Pada pelayan Linux, aktifkan Docker semasa but menggunakan pengurus perkhidmatan pengedaran anda, biasanya sudo systemctl enable --now docker. Pada Windows/macOS, aktifkan tetapan mulakan-semasa-log-masuk Docker Desktop. Log keluar desktop, tidur, atau pemberhentian daemon Docker boleh mengganggu pengumpulan. Kontena yang dihentikan secara eksplisit kekal berhenti sehingga anda memulakannya semula.

Volum /tmp dihadkan pada 512 MiB dalam konfigurasi contoh. Pembinaan eksport sebaliknya menggunakan temporary-exports/ setiap ruang kerja pada /data yang kekal. Tempah ruang di sana untuk eksport serentak, pertumbuhan jurnal/WAL, media dan sandaran. Pelancar menggunakan deploy/constraints.txt untuk menetapkan versi kebergantungan runtime yang layak. Docker dan pelayan jaminan tinggi memasang daripada deploy/requirements.lock dan deploy/build.lock dengan pip --require-hashes: setiap fail pakej mesti sepadan dengan rekod SHA-256 yang direkodkan dalam komit, jadi mana-mana fail yang digantikan di PyPI atau cerminan akan ditolak. Pakej yang hanya disertakan dengan sumber (jieba, pyaes) dibina dengan setuptools yang dikunci dalam deploy/build.lock (--no-build-isolation) oleh pelancar, pembina mudah alih Windows dan Dockerfile, jadi pip tidak menyelesaikan persekitaran pembinaan berasingan yang tidak dikunci. Imej asas Python dan pek sistem pengendalian masih memerlukan kelayakan pelepasan bebas.

Jangan gunakan docker compose down -v melainkan anda berniat memusnahkan jurnal dan kunci. Laporan kesihatan kontena melaporkan ketersediaan pelayan web, bukan perekodan Telegram yang berjaya. Periksa status pengumpul panel, degupan jantung, ralat, dan peristiwa liputan.

Profil saksi bebas#

Perkhidmatan pilihan witness menjalankan saksi bebas dalam bekasnya sendiri, dengan kunci dan jurnalnya sendiri dalam volum witness-data dan hanya token saksi baca sahaja untuk pengumpul. Buat token dalam panel di bawah More tools → Extras → Independent witness, tambahkan ia dengan token bot dan saluran ke .env, kemudian mulakan profil:

docker compose --profile witness up -d          # deploy/compose/compose.image.yaml: same flag
docker compose logs witness                     # witness key fingerprint

Perkhidmatan ini mencapai pengumpul di dalam rangkaian Compose di http://tgwitness:8787 (TGWITNESS_WITNESS_COLLECTOR mengutamakannya, contohnya /profiles/<workspace ID> untuk ruang kerja lain). Untuk saksi di pelayan berasingan yang diuruskan oleh orang lain, gunakan deploy/compose/compose.witness.yaml di sana dengan TGWITNESS_WITNESS_COLLECTOR ditetapkan kepada alamat HTTPS pengumpul; fail itu mengandungi saksi sahaja.

Pasang imej yang diterbitkan#

Salin deploy/env.example ke .env. Tetapkan TGWITNESS_IMAGE ke versi terbitan, menggunakan laluan repositori huruf kecil, contohnya:

TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787

Jalankan fail ini sendiri, bukannya 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

Tiada pembinaan sumber, Python, atau penyusun diperlukan pada hos. Aliran kerja pelepasan menyasarkan kontena Linux AMD64 dan ARM64, termasuk VM Linux Docker Desktop. Gunakan tag versi atau ghcr.io/owner/repository@sha256:... daripada ringkasan aliran kerja. Tiada tag latest yang bergerak atau peningkatan aplikasi tanpa pengawasan yang dikonfigurasikan. Imej dan varian sumber menggunakan volum data yang sama apabila nama projek mereka sepadan.

HTTPS automatik pada pelayan#

Gunakan pelayan dengan Docker, domain yang anda kawal, dan storan tempatan berterusan. Arahkan rekod A/AAAA domain ke pelayan; terbitkan AAAA hanya jika IPv6 sampai kepadanya. Benarkan masuk TCP 80 dan 443 serta keluar DNS/HTTPS untuk penerbitan sijil. Perkhidmatan lain tidak boleh sudah menggunakan port ini.

Salin deploy/env.example ke .env dan tetapkan nama hos, tanpa skema atau laluan:

TGWITNESS_DOMAIN=watch.your-domain.org

Mulakan pembinaan sumber dengan lapisan 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 imej yang diterbitkan, gunakan deploy/compose/compose.image.yaml sebagai fail pertama sebaliknya. Simpan kedua-dua argumen -f untuk status, log, kemas kini, dan arahan henti kemudian.

Caddy memperoleh dan memperbaharui sijil, mengalihkan HTTP ke HTTPS, dan meneruskan permintaan kepada pengumpul di rangkaian Compose persendirian. Status sijil mempunyai volum kekal tersendiri. Port hos langsung pengumpul kekal hanya untuk loopback. Konfigurasi Caddy yang disediakan tidak mengaktifkan log akses.

Buka https://watch.your-domain.org dan masukkan token panel. Penyediaan kesediaan merangkumi bekas; penerbitan sijil dan kebolehcapaian luaran bergantung pada DNS dan tembok api. Jika HTTPS tidak bersedia, periksa DNS, peraturan tembok api, dan:

docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy

Imej Caddy yang disediakan mengikuti tag 2-alpine. Tarikan akan menyegarkan semula imej tersebut; pasangkan digest yang telah diuji dalam penyebaran anda jika anda memerlukan versi infrastruktur tetap.

Kemas kini dan sandaran#

Memelihara nama projek Compose dan volum data merentas kemas kini. Pertama, hentikan pengumpul dan buat sandaran lengkap. Untuk penyebaran berasaskan sumber lalai:

docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update

Gunakan destinasi sandaran baharu setiap kali, di luar repositori, dan lindungi ia sebagai bahan capaian akaun. Laluan contoh adalah untuk ilustrasi; gunakan lokasi sandaran peribadi anda. Salin keseluruhan direktori, termasuk fail tersembunyi, semua ruang kerja, kunci, jurnal, dan media. Sandarkan kunci induk peti keselamatan luaran secara berasingan jika dikonfigurasikan. Fail ZIP bukti bukan sandaran aplikasi yang boleh dipulihkan. Untuk HTTPS, juga pelihara jumlah Caddy jika anda perlu mengekalkan status sijil/akaunnya.

Untuk penyebaran sumber, peroleh fail keluaran baru dan jalankan:

docker compose up -d --build --wait

Untuk penyebaran imej, ubah TGWITNESS_IMAGE kepada versi yang diingini, kemudian 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 fail Compose pemasangan anda juga untuk arahan stop/copy sebelumnya. Pastikan .env, konfigurasi tersuai, dan nama projek yang sama. down mengekalkan volum bernama; down -v memadamkannya. Jangan salin .venv antara sistem operasi atau versi Python. Untuk kemas kini asli, hentikan TgWitness, buat sandaran direktori data penuhnya, gantikan fail sumber, dan jalankan python start.py --setup-only sebelum pelancaran.

Semak akses panel, identiti akaun, status pemerhatian, dan liputan selepas kemas kini. Selepas dihidupkan semula, TgWitness akan menyambung semula kedudukan kemas kini Telegram yang disimpan dan meminta kemas kini yang terlepas semasa proses kemas kini. Rollback mungkin memerlukan sandaran pra-kemas kini jika versi akan datang menukar format storan.

Pelayan jauh#

Pastikan perkhidmatan terikat pada loopback dan gunakan terowong SSH, atau akhiri HTTPS pada proksi songsang. Fail Compose asas hanya untuk tempatan; lapisan tambahan pilihan deploy/compose/compose.https.yaml menyediakan Caddy untuk domain yang dikonfigurasikan. Pastikan token pembawa tidak termasuk dalam URL dan log proksi. Proksi songsang harus mengehadkan saiz permintaan dan kadar sambungan. Jangan dedahkan HTTP biasa kepada Internet.

Contoh untuk systemd, tugas logon Windows, ejen pengguna macOS dan Caddy disediakan dalam deploy/. Semak/sesuaikan laluan mereka sebelum pemasangan. Mereka adalah templat yang disediakan, bukan kualifikasi platform yang dijalankan secara tempatan. Tiada perkhidmatan atau tugas latar belakang didaftarkan oleh pelancar biasa.

Pada Windows, pelancaran pythonw.exe tanpa tetingkap menyimpan diagnostik permulaan/pelayan dalam logs/server.log di bawah direktori data (5 MiB setiap fail, dua sandaran berputar). Pelancaran konsol mengekalkan log konsol. Log akses HTTP dilumpuhkan dalam kedua-dua mod. Lindungi log dengan direktori data dan semak mereka sebelum dikongsi.

Mula semula dan jurang#

Negeri pemerhatian terakhir yang diminta dikekalkan. Jika pemerhatian aktif, permulaan cuba menyambung semula dan meneruskan sumber terpilih. Menangguhkan secara manual membatalkan niat tersebut. Permulaan semula yang gagal direkodkan dan dipaparkan di panel.

TgWitness menyimpan kedudukan kemas kini Telegram untuk akaun dan untuk setiap saluran (pts, qts, seq dan tarikh) dalam peti besi ruang kerja dan memulihkannya pada permulaan seterusnya. Klien kemudiannya meminta kemas kini yang terlepas semasa proses dihentikan, dan semakan semula berkala memulihkan mesej yang terlepas serta merekod mesej yang disimpan yang tidak lagi dikembalikan oleh Telegram. Dialog dimuat semula pada permulaan. Setiap permulaan merekodkan kepala jurnal sebelumnya, sempadan luar talian dan kedudukan kemas kini yang disambung semula. Pemantau memeriksa sambungan setiap 10 saat dan menambah denyutan jantung setiap minit (Alat → Parameter → Rakaman Kehidupan → setiap). Pemutusan sambungan dan tempoh senyap direkodkan sebagai jurang liputan dengan sebabnya. Snek sejarah disimpan sebagai pemerhatian sejarah semasa berasingan di sebelah rekod langsung.

Barisan media disimpan dalam pangkalan data SQLite setiap ruang kerja. Satu mesej dan tugasnya disimpan secara atomik. Tugas yang sedang berjalan yang terhenti akan dipulihkan untuk dicuba semula semasa permulaan. Setiap muat turun mempunyai had masa asas selama 120 saat ditambah masa pada kadar 256 KiB/s untuk saiznya, dan Had 1–2,000 MiB bagi setiap jenis lampiran; had masa, kelajuan dan percubaan semula berada di bawah Alat lain → Parameter. Pengumpul akan melangkau fail yang saiznya tidak diketahui. Menangguhkan mengekalkan kerja yang beratur. Percubaan semula menggunakan penerang fail asal yang diperhatikan, bukan versi terkini bagi mesej yang disunting kemudian. Kegagalan sementara mempunyai percubaan semula yang terhad; jeda FloodWait media akan terus wujud walaupun dimulakan semula. Pemulihan media berasingan daripada pemulihan kemas kini Telegram dan tidak dapat mencipta semula fail yang hilang.

Sandaran, pemulihan, dan kapasiti#

tgwitness backup FOLDER menyalin direktori data sementara panel terus berjalan: checkpoint terlebih dahulu, kemudian fail SQLite melalui API sandaran dalam talian, kemudian kunci, media dan profil, jadi tiada checkpoint yang disalin lebih baru daripada jurnal yang disalin. backup-manifest.json menyenaraikan SHA-256 setiap fail dan kepala jurnal. Untuk memulihkan, hentikan TgWitness dan gantikan keseluruhan direktori data dengan folder tersebut. Permulaan seterusnya merekodkan bahawa jurnal telah dipulihkan daripada salinan yang lebih lama. Rekod tersebut membandingkan jurnal dengan kepala yang disimpan dalam TGWITNESS_STATE_DIR , sebuah folder di luar direktori data: volum tgwitness-state dalam Compose, /var/lib/tgwitness-state dalam unit systemd, dan folder status tempatan pengguna sebaliknya. Tanpa folder status yang boleh ditulis, pemulihan tidak dikesan dan log akan memberitahu demikian sekali sahaja.

Tanpa arahan, hentikan proses sebelum menyalin keseluruhan direktori data, termasuk vault.key, signing.enc, credentials.enc, pangkalan data SQLite/fail WAL, media, token, titik pemeriksaan, dan semua profil/subdirektori. Pulihkan salinan lengkap sambil perkhidmatan destinasi dihentikan. Ketiadaan kunci vault atau ketidakpadanan kunci tandatangan menyebabkan permulaan gagal; jangan menjana semula kunci untuk memaksa akses.

Simpan sandaran rahsia yang disulitkan dan dikawal capaian. Fail ZIP bukti adalah mudah alih semak artifak, bukan sandaran aplikasi atau sandaran sesi Telegram. Tiada pemadaman pengekalan automatik. Rancang ruang cakera untuk semua mesej, metadata mentah, media, eksport sementara, dan sandaran.

Pengesahan permulaan dan rekod aliran eksport, bukannya memuatkan keseluruhan jurnal. Eksport menetapkannya pada tangkapan baca sementara penulisan WAL baru boleh diteruskan; eksport jangka panjang boleh mengekalkan halaman WAL, jadi kapasiti cakera masih penting. ZIP dihadkan kepada 4 GiB tanpa pemampatan untuk menyamai lalai pemeriksa bebas; Lebih banyak alat → Parameter → ZIP terbesar yang ditandatangani meningkatkan had, dan arkib seperti itu disahkan dengan verify.py --max-gib N. Format lain tidak mempunyai had bilangan acara. Pelayar yang disokong menstrim ketulan respons ke fail pilihan pengguna. Pelayar lain menampung sekurang-kurangnya 128 MiB dan mengarahkan pemindahan yang lebih besar ke CLI yang disahkan:

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

Gunakan --profile ID daripada Eksport → ID Ruang Kerja untuk ruang kerja lain, --format zip|jsonl|csv|html, --url https://your-server untuk pelayan jauh, atau --max-mib untuk menukar had pemindahan 5 GiB. HTTP Biasa dibenarkan hanya untuk loopback. Token dihantar dalam pengepala, penalaan semula ditolak, fail sedia ada tidak ditimpa, dan muat turun yang tidak lengkap tidak diterbitkan sebagai fail siap. Jika TGWITNESS_TOKEN menimpa token yang dijana, gunakan fail yang dilindungi berasingan yang mengandungi nilai aktif tersebut: panel-token.txt tidak diubah semula oleh penimpaan. SHA-256 arahan hanyalah checksum pemindahan; sahkan sendiri ZIP yang ditandatangani.

Panel memaparkan media yang sedang menunggu/gagal, media tertua yang menunggu, ruang cakera kosong, jeda permintaan Telegram, dan sumber yang aksesnya belum disahkan. Diagnostik ini bukan pemantau penghantaran hujung-ke-hujung yang lengkap. Ruang kerja berkongsi proses; akaun yang bising masih boleh menjejaskan yang lain. Proses pekerja berasingan, pengekalan/pusingan, pemulihan kemas kini tahan lama dan kelayakan penyebaran penuh kekal. Akses panel terhad didokumenkan dalam akses dan kebenaran; checkpoint bebas dilindungi oleh panduan saksi.

Prosedur terperinci: sambungan/keselamatan dan mod operasi.