# Telegram · Panduan cepat

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

Semua cara untuk menginstal dan menjalankan TgWitness: paket Windows, Python, Docker, dan demo sintetis, beserta pemeriksaan awal.

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

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

Semua cara untuk menginstal dan menjalankan TgWitness: paket Windows, Python, Docker, dan demo sintetis, beserta pemeriksaan awal.

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

![Memulai](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

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

TgWitness adalah aplikasi mandiri untuk memantau grup dan saluran Telegram yang dapat diakses oleh akun Anda. Aplikasi ini berjalan secara lokal dengan direktori data tersendiri.

**Pertama kali berkunjung?** [Jelajahi demo](https://phishdestroy.io/tgwitness/id/docs/reference/quickstart/#explore-the-interface) sebelum menghubungkan akun. [Pilih panduan](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) untuk proxy, saksi, ekspor, atau pengaturan server. [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (pratinjau) menjalankan proses penangkapan di fork GitHub Anda sendiri, bukan di instalasi lokal.

## Instal dan mulai

Penginstal terpandu ini menyertakan Python-nya sendiri dan memeriksa hash paket serta tanda tangan rilis sebelum menginstal. Menjalankannya kembali akan memperbarui instalasi yang sudah ada.

**Linux / macOS:**

```
curl -fsSL https://get.destroy.tools/install.sh | bash
```

**Windows (PowerShell atau Command Prompt):**

```
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
```

Di server Ubuntu, jalankan sebagai root untuk menginstal layanan latar belakang; di desktop, jalankan sebagai pengguna biasa. Di Ubuntu, penginstal menampilkan alamat panel dan kunci akses; di macOS dan Windows, panel lokal terbuka di browser Anda. Lanjutkan ke bagian **Hubungkan Telegram** di bawah ini. Bagian [Instal, verifikasi, dan perbarui](https://phishdestroy.io/tgwitness/id/docs/reference/installation/) mencakup pilihan akses server, pemeriksaan skrip sebelum dijalankan, pembaruan, dan penghapusan.

### Metode lain

Rilis GitHub, kode sumber, dan Docker merupakan alternatif dari penginstal. Unduhan portabel tersedia setelah build rilis diterbitkan:

| Host | Tidak ada yang diinstal | Dari sumber: Python 3.11+ | Docker: Engine/Desktop dengan Compose 2.20+ |
| --- | --- | --- | --- |
| Windows | Ekstrak `TgWitness-<version>-windows-amd64-portable.zip` dari GitHub Releases, klik dua kali `TgWitness.cmd` | Klik dua kali `Start.cmd` | Klik dua kali `scripts\Docker.cmd` |
| Linux / macOS | — | `sh start.sh` | `sh scripts/docker-start.sh` |

Untuk metode kode sumber, [unduh dan ekstrak `main` saat ini](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) atau kloning repositori:

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

`Start.cmd` menawarkan untuk menginstal Python 3.12 bagi pengguna Windows Anda jika tidak ditemukan Python yang sesuai (winget, atau penginstal python.org bertanda tangan). `start.sh` mencetak perintah instalasi yang tepat untuk distribusi Linux atau macOS Anda jika Python belum ada. Peluncuran kode sumber pertama akan membuat `.venv` dan menginstal dependensi secara otomatis.

Docker membangun aplikasi dan menjalankannya di latar belakang; Python di host tidak diperlukan. `scripts\Docker.cmd` dan `scripts/docker-start.sh` menampilkan alamat panel dan token saat kontainer dalam kondisi baik. Perintah Docker yang setara di setiap host yang didukung adalah:

```
docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt
```

Buka **http://127.0.0.1:8787**. Gunakan token yang dicetak oleh Docker helper atau perintah Docker kedua, atau baca **berkas data/live/panel-token.txt** untuk instalasi portabel atau dari sumber. Lanjutkan ke bagian "**Connect Telegram"** di bawah ini. Instalasi native dan Docker menggunakan penyimpanan terpisah; menjalankan Docker tidak akan mengimpor jurnal native yang sudah ada.

Untuk server, [proses penerapan](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) mencakup HTTPS otomatis, restart, publikasi gambar, pembaruan, dan pencadangan.

## Jelajahi antarmuka

1. Jalankan **TgWitness-Demo.cmd** dalam paket portabel, **scripts\Demo.cmd** di folder sumber Windows, atau `sh start.sh --demo` di Linux/macOS. Peluncuran dari folder sumber akan terlebih dahulu membuat `.venv` dan menginstal dependensi.
2. Buka **http://127.0.0.1:8787**.
3. Demo lokal akan membuka jurnal contoh secara otomatis. Tidak diperlukan salinan token untuk akses lokal langsung.

Pesan demo bersifat fiktif. Mode demo tidak dapat terhubung ke akun Telegram yang sebenarnya.

## Hubungkan Telegram

> [!PERINGATAN] **Gunakan akun khusus.** Telegram dapat membatasi atau memblokir akun secara permanen karena volume permintaan yang dianggap berlebihan, apa pun kliennya. Hubungkan akun yang disiapkan untuk pengamatan, bukan akun pribadi atau yang berharga, dan buat ID API / hash pada akun khusus.

1. Jika demo bawaan sedang berjalan, hentikan dan jalankan **Start.cmd** atau `sh start.sh`. Jika tidak, biarkan instalasi langsung yang telah dijalankan di atas tetap berjalan.
2. Gunakan token panel untuk masuk. Ruang kerja baru akan terbuka [pada pengaturan awal](https://phishdestroy.io/tgwitness/id/docs/reference/settings/). Pilih **Hanya unduh**, **Ikuti obrolan**, atau **Bukti untuk suatu kasus**.
3. Periksa pengaturan koneksi. Konfigurasikan proxy Anda sendiri jika diperlukan; pengaturan koneksi tetap tersedia setelah penyiapan.
4. Di **Connect Telegram**, pilih nomor telepon, kode QR, berkas akun (TData, `.session`, StringSession, JSON akun), atau kunci otorisasi lengkap. Lengkapi konfirmasi Telegram, kode, dan kata sandi dua langkah saat diminta.
5. Periksa akun yang ditampilkan, pilih obrolan, dan tinjau pengaturan Anda. Selesaikan dari layar terakhir. Untuk **opsi Hanya unduh**, **Mulai ekspor** akan memulai proses ekspor satu kali dan membuka halaman Ekspor untuk menampilkan kemajuannya; opsi ini tidak mengaktifkan pemantauan berkelanjutan.

Setelah pengaturan, **Chats → Choose** mengubah obrolan yang dipilih. **Pengaturan** mengontrol pengumpulan dan berkas; **More tools → Sources** menyediakan daftar sumber terperinci pada tingkat Standard atau Expert. [Panduan panel](https://phishdestroy.io/tgwitness/id/docs/reference/panel/) menjelaskan enam bagian utama dan kontrol kontekstualnya.

**API ID + Hash** bersifat opsional: ruang kerja menggunakan pasangan yang disimpan atau diimpor, atau pasangan yang aktif dari kumpulan bawaan. Untuk menggunakan aplikasi Anda sendiri, tempelkan satu pasangan `API ID:API Hash` ke kolom API ID. Untuk **Kunci Otentikasi**, tempelkan seluruh 512 karakter heksadesimal dan pilih DC ID yang disediakan. ID Pengguna bersifat opsional dan akan diverifikasi jika dimasukkan.

Kredensial API mengidentifikasi aplikasi Anda; kredensial tersebut tidak secara otomatis memberikan otorisasi atas akun. Grup pribadi tidak memerlukan nama pengguna publik, tetapi akun Anda harus memiliki akses.

Untuk akun yang sudah ada, lihat [format akun dan sesi](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/): panel ini mendukung Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP akun tunggal, dan file JSON akun yang didukung. Pilih sesi beserta file JSON-nya secara bersamaan, tekan **Periksa file**, lalu **Hubungkan akun**. Masuk melalui QR juga tersedia dengan pengaturan API opsional yang sama. TDLib, sesi bot, dan inventaris akun CSV/JSON tidak didukung.

Untuk beberapa akun, gunakan **Akun → Impor akun** dan pilih file sesi yang didukung. File JSON pendamping dipasangkan berdasarkan nama dasar (basename); setiap akun yang diimpor mendapatkan ruang kerjanya sendiri. Lihat [impor massal dan grup akun](https://phishdestroy.io/tgwitness/id/docs/reference/accounts/#bulk-import-and-account-groups).

Untuk menambahkan akun lain, tekan **+** di samping pemilih akun atau gunakan **Akun → Tambahkan akun**. Ruang kerja memiliki sesi, jurnal, kunci, sumber, dan antrian yang terpisah. Beralih antar tampilan tidak menghentikan pengumpul lainnya. Akun Telegram yang sama tidak dapat ditugaskan ke dua ruang kerja dalam instalasi ini. Tidak ada batasan jumlah ruang kerja; mereka berbagi satu proses, sehingga kapasitas bergantung pada mesin.

Token panel langsung melindungi akses ke otorisasi Telegram dan materi yang disimpan Anda; token ini terpisah dari kredensial API Telegram. Hanya demo lokal yang secara eksplisit dijalankan dan diakses secara langsung yang mendapatkan akses otomatis. Demo jarak jauh/proksi tetap menggunakan `data/demo/panel-token.txt`.

## Tinjau dan ekspor

- **Jurnal:** cari dan saring pengamatan berdasarkan sumber dan jenis peristiwa.
- Pilih suatu peristiwa untuk memeriksa catatan aslinya, atribusi, dan versi yang disimpan.
- Rincian pengeditan menampilkan konten sebelum dan sesudah yang tersedia. Rincian penghapusan menampilkan konten terakhir yang terekam, jika ada; pelaku yang tidak dikenal tetap tidak diketahui.
- **Format ekspor:** ZIP yang ditandatangani, JSONL, CSV, dan HTML offline.
- **Ekspor obrolan lengkap** (**Obrolan → Ekspor obrolan**, atau **Ekspor → Tangkap atau ekspor satu obrolan**): unduh seluruh riwayat yang terlihat dari satu obrolan sebagai bundel yang ditandatangani dengan `chat.json` (gaya ekspor Telegram) dan berkas `chat.html` yang dapat dibaca. Obrolan pribadi berfungsi jika akun tersebut merupakan anggota. Ini adalah cuplikan saat ini, bukan rekonstruksi pesan yang dihapus atau diedit sebelumnya. Verifikasi salinan dengan `python verify.py chat-export.zip --fingerprint TRUSTED_SHA256`.
- **Simpan titik pemeriksaan:** jaga agar batas jurnal yang ditandatangani tetap berada di luar pengumpul.
- **Unduh tanda terima eksekusi yang ditandatangani:** simpan catatan program/versi pengumpul.
- **Siapkan permintaan cap waktu:** siapkan permintaan offline kepada otoritas cap waktu; ikuti panduan di [TIMESTAMP.md](https://phishdestroy.io/tgwitness/id/docs/reference/timestamp/) untuk memperoleh dan memverifikasi respons.
- **Verifikasi jurnal:** periksa tanda tangan peristiwa dan tautan rantai. Ekspor ZIP juga memeriksa media.

Browser yang didukung dapat menyimpan ekspor berukuran besar langsung ke file yang dipilih. Browser lain hanya dapat menyimpan dalam buffer maksimal 128 MiB. Selama server berjalan, CLI streaming mendukung unduhan berukuran lebih besar tanpa perlu menyimpan seluruh respons dalam buffer:

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

Untuk ruang kerja lain, tambahkan `--profile ID` menggunakan **Ekspor → ID Ruang Kerja**. Untuk server jarak jauh, tambahkan `--url https://your-server`. Batas transfer default adalah 5 GiB; `--max-mib` mengubahnya. Konten ZIP yang ditandatangani memiliki batas verifikasi terkompresi terpisah sebesar 4 GiB secara default (**More tools → Parameters** menaikkannya; verifikasi arsip semacam itu dengan `verify.py --max-gib N`). Verifikasi arsip menggunakan salinan verifier yang tepercaya, sidik jari kunci yang disimpan secara independen, dan, sebagai bukti minimal, sertifikat akar otoritas cap waktu (`--tsa-ca`).

## Periksa proses instalasi

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

`--check` memeriksa dependensi lokal, dukungan penandatanganan, penyimpanan, konfigurasi kunci, dan alamat pendengar. Alat ini tidak menginstal apa pun atau terhubung ke Telegram. Port yang sedang digunakan mungkin menandakan adanya instance lain yang sedang berjalan. Gunakan `--port` yang berbeda atau hentikan instance tersebut terlebih dahulu.

Launcher diinstal ke `.venv`. Perintah tambahan `python -m tgwitness...` harus menggunakan `.venv\Scripts\python.exe` di Windows atau `.venv/bin/python` di Linux/macOS, kecuali jika lingkungan tersebut sudah diaktifkan.

## Sesi, perlindungan, dan pengoperasian

Sebuah `.session` Telethon SQLite yang tertutup dan konsisten dapat dikonversi secara lokal dengan `python -m tgwitness.sessions account.session --out account.tgwitness-session`, kemudian dimuat di **More tools → Account → Files**. Impor berkas langsung dan login QR juga tersedia. Lihat [CONNECTION-SECURITY.md](https://phishdestroy.io/tgwitness/id/docs/reference/connection/) untuk format login, SOCKS5, HTTP CONNECT, MTProxy, dan kunci utama eksternal.

**Menjeda pengamatan** akan menghentikan pengumpulan data. **Mengunci** hanya menutup akses browser. Menutup tab tidak menghentikan proses pengumpul data. Menghentikan proses akan menghentikan pengumpulan data; cuplikan riwayat tidak dapat merekonstruksi semua pengeditan atau penghapusan yang terlewatkan. Lihat [cara kerja pengumpulan data](https://phishdestroy.io/tgwitness/id/docs/reference/collection/) terkait kebijakan peristiwa, antrian lampiran, isolasi akun, dan perilaku saat dimulai ulang.

Sesi dan rahasia dienkripsi. Isi pesan, media, dan ekspor memerlukan disk atau volume terenkripsi. Verifikasi tanda tangan jurnal terhadap kunci tepercaya dan simpan titik pemeriksaan secara terpisah. Tinjau catatan penangkapan, bukti waktu eksternal, dan pernyataan lingkungan untuk mode pengumpulan yang dipilih.

Baca [OPERATIONS.md](https://phishdestroy.io/tgwitness/id/docs/reference/operations/) untuk pencadangan/pemulihan, [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/id/docs/reference/deployment/) untuk hosting, dan [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) untuk contoh layanan. Panel yang telah diinstal juga menyertakan panduan pengaturan offline di `/guide.html`.

Verifikasi aktual dan batasan yang masih ada dicatat dalam [berkas VERIFICATION.md](https://phishdestroy.io/tgwitness/id/docs/reference/verification/) dan [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md).
