Referensi / Pengaturan
Instal, verifikasi, dan perbarui
Instal dengan satu perintah, periksa tanda tangan dan hash, perbarui, dan hapus instalasi.
TgWitness / Dokumentasi · Memulai
Proyek · Panduan cepat · Penerapan
Di halaman ini
Instal dengan satu perintah#
Layanan unduhan resmi proyek ini, get.destroy.tools, menyediakan
penginstal berpanduan dan berkas rilisnya yang telah ditandatangani. Layanan ini mencakup runtime Python pribadi dan
memverifikasi hash paket serta tanda tangan rilis sebelum instalasi. Setiap publikasi
memperbarui skrip entri, hash, tanda tangan, dan informasi build secara bersamaan;
setiap build juga memiliki URL rilis yang tidak dapat diubah.
Pilih penginstal terpandu untuk pengaturan singkat, atau gunakan rilis GitHub, kode sumber, atau Docker . Ini adalah jalur instalasi yang didukung untuk proyek sumber terbuka yang sama. Untuk penerapan yang memerlukan persetujuan build yang tepat sebelum eksekusi, gunakan Verifikasi sebelum menjalankan dengan sidik jari kunci rilis yang disimpan secara independen dan URL build yang tidak dapat diubah . Memperbarui layanan unduhan tidak akan memperbarui panel yang telah terinstal secara otomatis.
Linux / macOS (Bash):
curl -fsSL https://get.destroy.tools/install.sh | bash
Di server Ubuntu, jalankan sebagai root untuk menginstal layanan latar belakang. Di desktop, jalankan sebagai pengguna biasa.
Windows (PowerShell atau Command Prompt):
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
Tidak diperlukan administrator di Windows. Proses PowerShell anak akan membiarkan terminal Anda tetap terbuka dengan hasilnya. Python dan dependensinya tetap berada di dalam instalasi.
Di Ubuntu, pilih "Komputer ini", "Tautan HTTPS sementara", atau "Domain sendiri".
Penginstal akan menampilkan alamat panel dan kunci akses. Untuk tautan sementara, buka
alamat HTTPS tersebut di browser Anda dan masukkan kuncinya. Untuk akses lokal pada server jarak jauh,
gunakan pengalihan SSH dari komputer Anda (ssh -L 8787:127.0.0.1:8787 user@server)
dan buka http://127.0.0.1:8787. Di macOS dan Windows, panel lokal akan terbuka di
browser Anda; biarkan terminalnya tetap berjalan.
Masuk ke Telegram di panel dan pilih apa yang ingin dikumpulkan. Instalasi saja tidak akan memulai pengumpulan data Telegram.
Tempat semuanya berjalan#
get.destroy.tools adalah Cloudflare Worker yang melayani unduhan statis. Alat ini tidak memiliki panel
TgWitness, sesi Telegram, atau basis data bukti pengguna. Alat ini tidak diarahkan ke
VPS proyek. Aplikasi ini berjalan di mesin tempat Anda menjalankan perintah tersebut.
| Instalasi | Program | Data |
|---|---|---|
| Ubuntu sebagai root | /opt/tgwitness |
Layanan sistem: /var/lib/tgwitness-<installation ID>; gunakan tgwitness paths untuk jalur yang tepat. |
| Pengguna Linux / macOS | ~/.local/share/tgwitness |
data/live di bawah instalasi tersebut. |
| Pengguna Windows | %LOCALAPPDATA%\TgWitness |
data\live di bawah instalasi tersebut. |
Pilih TGWITNESS_INSTALL_DIR untuk memilih folder lain. Versi yang terinstal dan datanya
terpisah. Penginstal tidak mengunggah akun, pesan, atau kunci Anda ke
situs unduhan. Memilih terowongan Cloudflare akan mengarahkan lalu lintas panel melalui
Cloudflare; menggunakan domain Anda sendiri akan mengarahkannya ke server Anda sendiri.
Dengan TGWITNESS_TRUSTED_PROXIES, panel menerima satu X-Forwarded-Proto: https dari proxy tepercaya untuk mengatur cookie unduhan aman.
Setiap instalasi mencakup berkas START-HERE.html dan START-HERE.txt, yang berisi
jalur lokal, perintah, dan tautan ke repositori. Jalankan tgwitness guide untuk membuka panduan.
Di Windows, gunakan & "$env:LOCALAPPDATA\TgWitness\bin\tgwitness.cmd" guide di PowerShell.
Pengaturan pencarian teks lengkap#
Pencarian teks lengkap (pratinjau) tidak memerlukan pengaturan. Indeksnya dibangun di latar belakang setelah pembaruan.
| Variabel atau perintah | Efek |
|---|---|
TGWITNESS_FULLTEXT=disk |
Secara default: indeks disimpan di search/fulltext.sqlite3 setiap ruang kerja |
TGWITNESS_FULLTEXT=memory |
Tidak ada berkas indeks; indeks dibangun ulang setiap kali aplikasi dimulai |
TGWITNESS_FULLTEXT=off |
Tanpa indeks; hanya pencarian teks persis |
tgwitness index status |
Indeks status setiap ruang kerja |
tgwitness stop, tgwitness index rebuild, tgwitness start |
Bangun ulang setiap indeks dari jurnal yang ditandatangani |
Pilihan administrator di Jurnal → Filter → Indeks Pencarian akan menggantikan
variabel untuk ruang kerja tersebut. Perintah akan mencari direktori data dari instalasi
yang menjalankannya; di tempat lain, tambahkan --data-dir dengan jalur dari tgwitness paths.
Untuk kamus bahasa Ukraina lengkap (data GPL-3.0), instal pymorphy3-dicts-uk di
lingkungan Python instalasi tersebut.
Akses baris perintah#
Baris perintah (pratinjau) membaca arsip untuk skrip dan agen.
| Variabel | Efek |
|---|---|
TGWITNESS_URL |
Alamat panel untuk tgwitness search, context, messages, stats dan export; default http://127.0.0.1:8787 ketika token telah ditetapkan |
TGWITNESS_MCP_TOKEN |
Simpan token koneksi dari More tools → Integrations → MCP, yang dibagikan dengan klien MCP; --token-file membacanya dari berkas sebagai gantinya |
TGWITNESS_DATA |
Direktori data dibaca secara langsung jika tidak --data-dir, URL, atau token yang diberikan |
Verifikasi sebelum dijalankan#
Penginstal menyematkan kunci publik rilis proyek dan memeriksa tanda tangan SHA-256 dan RSA pada paket aplikasi serta kunci dependensi sebelum menginstalnya. Baik Bash maupun PowerShell akan berhenti jika pemeriksaan yang diperlukan gagal. Skrip awal dikirim melalui HTTPS dan memiliki tanda tangan terpisah; perintah di bawah ini juga memungkinkan Anda memverifikasi skrip tersebut sebelum menjalankannya.
Kunci rilis publiknya adalah release-signing.pub. SHA-256-nya adalah:
039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d
Simpan sidik jari ini dari revisi repositori yang Anda percayai. Checksum dari server unduhan yang sama akan mendeteksi ketidaksesuaian; kunci publik yang tepercaya secara independen adalah yang mengautentikasi tanda tangan rilis.
Gunakan direktori baru yang kosong untuk mengunduh berkas verifikasi di bawah ini.
Linux / macOS — jalankan di direktori unduhan baru yang kosong (memerlukan curl dan OpenSSL):
curl -fSLO https://get.destroy.tools/install.sh &&
curl -fSLO https://get.destroy.tools/install.sh.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
'039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.sh.sig install.sh &&
bash install.sh
Rantai && rantai akan berhenti sebelum eksekusi jika unduhan, sidik jari kunci, atau pemeriksaan tanda tangan
gagal. Jika terjadi publikasi baru antara saat mengunduh skrip dan
tanda tangannya, unduh keduanya kembali. Penginstal lama tetap mempertahankan URL paketnya yang tidak dapat diubah.
Windows — periksa SHA-256 sebelum menjalankannya:
Invoke-WebRequest https://get.destroy.tools/install.ps1 -OutFile install.ps1 -UseBasicParsing
Get-FileHash .\install.ps1 -Algorithm SHA256
Invoke-RestMethod https://get.destroy.tools/SHA256SUMS.txt
Bandingkan hash tersebut dengan install.ps1 baris tersebut. Untuk pemeriksaan tanda tangan secara independen,
gunakan OpenSSL (misalnya, dari Git Bash) dan sidik jari kunci publik yang sama di atas:
curl -fSLO https://get.destroy.tools/install.ps1 &&
curl -fSLO https://get.destroy.tools/install.ps1.sig &&
curl -fSLO https://get.destroy.tools/release-signing.pub &&
test "$(openssl dgst -sha256 release-signing.pub | awk '{print $NF}')" = \
'039d98a658ccda14253e45a00335b4a68d840976d8ec18b8d4355cc7c458447d' &&
openssl dgst -sha256 -verify release-signing.pub -signature install.ps1.sig install.ps1 &&
powershell.exe -NoProfile -ExecutionPolicy Bypass -File install.ps1
Instalasi Windows sendiri memverifikasi tanda tangan paket dengan .NET dan tidak
memerlukan OpenSSL. Ini adalah tanda tangan RSA-3072 / SHA-256 yang terpisah, bukan Authenticode.
Manifest mencatat versi perangkat lunak,
komit Git yang tepat, ID rilis yang tidak dapat diubah, dan SHA-256 setiap artefak. Halaman tersebut menautkan
ke sumber yang sesuai. Manifest dan daftar checksum juga memiliki tanda tangan
yang terpisah (manifest.json.sig dan SHA256SUMS.txt.sig).
Perbarui instalasi yang sudah ada#
Publikasi baru memperbarui situs unduhan; program yang sudah terinstal akan diperbarui saat Anda
menjalankan penginstal lagi. Tidak ada pembaruan tanpa pengawasan atau restart otomatis pada
koleksi yang sedang berjalan. Saluran penginstal saat ini adalah pratinjau; saluran ini mengikuti
build yang telah diterbitkan dan diperiksa dari main, yang commit-nya bisa lebih baru daripada
rilis GitHub bernomor terakhir. Versi halaman ini berasal dari pyproject.toml; commit
dan ID build-nya membedakan pembaruan dalam versi pratinjau yang sama.
Publikasi dilakukan secara otomatis setelah commit tersebut lulus pemeriksaan aplikasi dan
keamanan, serta paket yang ditandatangani telah diautentikasi, diinstal, dan diperiksa di
Ubuntu dan Windows. Permintaan pull yang mengubah penginstal juga menjalankan install.sh
dan install.ps1 dua kali terhadap salinan lokal situs. Selama pemeriksaan berlangsung,
atau jika gagal, perintah yang sama akan terus menginstal build yang telah diperiksa sebelumnya.
Manifest build menunjukkan commit mana yang saat ini tersedia; nomor versi
sendiri mungkin tetap sama di antara pembaruan pratinjau.
Gunakan folder instalasi dan pengguna OS yang sama seperti sebelumnya. Cadangkan seluruh direktori data
dengan menghentikan pengumpulan data; tgwitness paths mengidentifikasinya. Ekspor yang ditandatangani
bukanlah cadangan instalasi yang lengkap.
Instalasi root Ubuntu di /opt/tgwitness:
curl -fsSL https://get.destroy.tools/install.sh | TGWITNESS_INSTALL_DIR=/opt/tgwitness bash -s -- --no-start
Setelah instalasi berhasil:
/opt/tgwitness/bin/tgwitness restart
/opt/tgwitness/bin/tgwitness status
/opt/tgwitness/bin/tgwitness open
Untuk instalasi pengguna Linux/macOS, gunakan TGWITNESS_INSTALL_DIR atau
pengaturan default, lalu jalankan perintah instalasi pertama sekali lagi. Tutup panel yang sedang aktif
sebelum melakukan pembaruan, lalu buka kembali setelahnya. Untuk layanan pengguna Linux yang telah dikonfigurasi
, jalankan perintah tgwitness restart perintahnya.
Windows: tutup panel yang sedang berjalan, jalankan perintah instalasi Windows lagi,
lalu buka bin\tgwitness.cmd di instalasi yang sama. Penginstal menyimpan data,
sesi, pengaturan akses, dan kunci penandatanganan. Penginstal hanya akan mengganti peluncur setelah
lingkungan baru lulus pemeriksaan; jika instalasi gagal,
peluncur sebelumnya akan tetap ada. Simpan cadangan sebelum peningkatan untuk perubahan format penyimpanan.
Perintah sehari-hari di Ubuntu#
| Perintah | Hasil |
|---|---|
tgwitness open |
URL panel saat ini dan kunci akses. |
tgwitness paths |
Jalur program, data, dan panduan yang tepat. |
tgwitness guide --print |
Petunjuk penggunaan dalam mode offline. |
tgwitness status / tgwitness logs |
Ketersediaan / log layanan. |
tgwitness stop / tgwitness start |
Hentikan / lanjutkan layanan; simpan data. |
tgwitness token rotate |
Ganti kunci administrator dan akhiri sesi browser. |
tgwitness tunnel off |
Nonaktifkan terowongan cepat publik; pertahankan panel lokal. |
tgwitness tunnel on / tgwitness tunnel restart |
Buat tautan terowongan cepat / ganti alamatnya. |
Lihat bagian Akses untuk token rekan kerja, sesi, dan pembatasan IP, serta publikasi penginstal untuk alur kerja rilis dari GitHub ke Cloudflare.
Hapus TgWitness#
Tidak ada program penghapus instalasi: Anda cukup menghentikan panel dan menghapus foldernya. Menghapus folder data akan menghapus jurnal, kunci penandatanganan, sesi Telegram, dan file yang disimpan secara permanen. Sebelum itu:
- Ekspor apa yang Anda butuhkan (Ekspor → Unduh ZIP yang telah ditandatangani) dan simpan sidik jari kunci penandatanganan serta titik pemeriksaan di luar mesin ini. Untuk menyimpan ruang kerja itu sendiri, salin seluruh folder data setelah pengumpulan data dihentikan.
- Hapus server yang dibuat di bawah More tools → Extras → Server 24/7 dari bagian Your servers atau dengan perintah
python -m tgwitness.cloud destroy; penyedia layanan akan terus menagih biaya untuk server tersebut hingga dihapus. - Akhiri sesi setiap akun di Telegram melalui Pengaturan → Perangkat. Menghapus file-file tersebut tidak akan membuat sesi tersebut keluar di sisi Telegram.
Instalasi root di Ubuntu. Perhatikan folder data, hentikan layanan, lalu hapus layanan, folder, dan pintasan:
/opt/tgwitness/bin/tgwitness paths
/opt/tgwitness/bin/tgwitness stop
systemctl list-unit-files 'tgwitness-*'
systemctl disable tgwitness-<ID>
rm /etc/systemd/system/tgwitness-<ID>.service
systemctl daemon-reload
rm -rf /opt/tgwitness /var/lib/tgwitness-<ID> /usr/local/bin/tgwitness
Instalasi untuk pengguna Linux atau macOS. Tutup panel. Layanan pengguna Linux yang telah dikonfigurasi
dihentikan dengan systemctl --user disable --now tgwitness-<ID>; unitnya berada di
~/.config/systemd/user/. Kemudian hapus ~/.local/share/tgwitness (atau
TGWITNESS_INSTALL_DIR) serta ~/.local/bin/tgwitness pintasan.
Windows. Tutup panel dan hapus %LOCALAPPDATA%\TgWitness (atau
TGWITNESS_INSTALL_DIR). Penginstal tidak menambahkan layanan, tugas terjadwal, atau pintasan apa pun.