# Telegram · Penerapan

Canonical page: https://phishdestroy.io/tgwitness/id/docs/reference/deployment/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/id/llms.txt)

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

![Penerapan & pemulihan](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

**Bahasa Inggris** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/DEPLOYMENT.md) · [Ukraina](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/DEPLOYMENT.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/DEPLOYMENT.md) · [Português (Brasil)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/DEPLOYMENT.md) · [Bahasa Turki](https://github.com/phishdestroy/TgWitness/blob/main/docs/tr/DEPLOYMENT.md) · [العربية](https://github.com/phishdestroy/TgWitness/blob/main/docs/ar/DEPLOYMENT.md) · [فارسی](https://github.com/phishdestroy/TgWitness/blob/main/docs/fa/DEPLOYMENT.md) · [Urdu](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/DEPLOYMENT.md) · [Hindi](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/DEPLOYMENT.md) · [Bahasa Indonesia](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/DEPLOYMENT.md) · [Bahasa Vietnam](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/DEPLOYMENT.md) · [Bahasa Mandarin (Sederhana)](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/DEPLOYMENT.md)

## 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](https://phishdestroy.io/tgwitness/id/docs/reference/high-assurance/).

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](https://phishdestroy.io/tgwitness/id/docs/reference/security/#external-master-key). 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](https://phishdestroy.io/tgwitness/id/docs/reference/witness/) 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/.](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) 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](https://phishdestroy.io/tgwitness/id/docs/reference/access/); titik pemeriksaan independen dijelaskan dalam [panduan saksi](https://phishdestroy.io/tgwitness/id/docs/reference/witness/).

Prosedur terperinci: [koneksi/keamanan](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) dan [mode operasi](https://phishdestroy.io/tgwitness/id/docs/reference/operations/).
