# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.github.io/TgWitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads alongside their methods and limits.

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

[Documentation index](https://phishdestroy.github.io/TgWitness/llms.txt)

Tek bir komutla yükleyin veya GitHub Actions'da yakalayın. Araştırma seçeneklerini, yayınlanan ölçeği ve bir arşivin neyi doğruladığını anlayın.

TgWitness, açık kaynaklı bir Telegram veri aktarım aracı ve soruşturma çalışma alanıdır. Tek bir komutla yükleyin, bir hesap bağlayın, sohbetleri seçin ve imzalanmış bir arşivi dışa aktarın. Ayrıca GitHub Actions üzerinde geçici veri toplama ve kaydedilmiş düzenlemeler, silme gözlemleri, arama ve raporlar ile soruşturmalara devam etme özelliklerini de destekler.

## Elinizdeki görevle başlayın

| Göreviniz | En kısa yol | Alacağınız şeyler |
| --- | --- | --- |
| Bir sohbeti veya hesabı kaydedin | Yükleyin, bir hesap bağlayın, dışa aktarma kapsamını seçin | Seçilen geçmiş, toplama sonuçları ve doğrulama materyallerini içeren imzalı bir arşiv |
| Geçici bir çalıştırıcıda toplayın | GitHub Actions'ı kullanarak verileri yakalayın, yeni bir oturum açın ve kapsamı seçin | GitHub iş akışı köken bilgisi içeren şifreli bir arşiv |
| Zaman içindeki değişiklikleri takip edin | Seçilen sohbetler için gözlem işlemini devam ettirin | Kaydedilmiş sürümler, silme bildirimleri, ekler ve kaydedilmiş kapsam |
| Araştırın ve bulgularınızı paylaşın | Arşivi arayın, Case Board'u kullanın ve bir rapor veya paylaşım kopyası oluşturun | Kaynağa bağlı bulgular ve alıcıya uygun, doğrulanabilir bir aktarım |

### Tek komutla kurulum

Yükleyici, Python ve bağımlılıkları içerir. Kaynak kodun indirilmesi, Docker, bir AI sağlayıcısı ve bağımsız bir tanık, kurulum için ön koşul değil, isteğe bağlı seçeneklerdir.

Linux / macOS:

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

Windows'ta, PowerShell veya Komut İstemi'nde:

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

Paneli açın, Telegram hesabınızı bağlayın ve veri toplama kapsamını seçin. Kurulum, veri toplamayı kendiliğinden başlatmaz. [kurulum kılavuzu](https://phishdestroy.github.io/TgWitness/tr/docs/reference/installation/) 'da yerel erişim, sunucular, güncellemeler ve indirilen sürümün kontrol edilmesi konuları açıklanmaktadır.

Geçici bir çalıştırıcı için [GitHub Actions yakalama](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) adımlarını izleyin. Bu iş akışı için bir GitHub çatalı, yetkilendirme ve bir arşiv şifresi gereklidir. Yakalama sayfasında, bu adımlar ve çalıştırma öncesindeki oturum süresi sınırı açıklanmaktadır. Ortaya çıkan arşivi ve doğrulama materyallerini indirin ve saklayın.

## Görev gerektirdiğinde daha fazla ayar

Tek bir sohbetin dışa aktarımı için bir hesap ve seçilen bir kapsam gereklidir. Sürekli gözlem, birden fazla hesap, proxy'ler, ek dosyalarıyla ilgili politikalar, rapor tasarımı, gözden geçirenlerin erişimi, harici zaman damgaları ve site dışı depolama, farklı soruşturma ve devir gerekliliklerine hizmet eder. Bu özellikleri, uygun oldukları durumlarda yapılandırın.

Kapsam, izinler ve paylaşımı en aza indiren kopyalar, operatörlerin neyi toplayacaklarını ve ifşa edeceklerini seçmelerine yardımcı olur. Yargı yetkisi kılavuzu ve rapor ayarları bu kararı destekler; bir profilin seçilmesi tek başına yasal uyumluluğu veya delil kabul edilebilirliğini sağlamaz. Bkz. [hesap dışa aktarma](https://phishdestroy.github.io/TgWitness/tr/docs/reference/account-export/), [erişim](https://phishdestroy.github.io/TgWitness/tr/docs/reference/access/) ve [rapor yapılandırması](https://phishdestroy.github.io/TgWitness/tr/docs/reference/case-reports/).

Uygulama, seçilen bilgisayar veya sunucuda çalışır. Temel veri toplama işlemi için GPU veya LLM gerekmez. İsteğe bağlı OCR, transkripsiyon ve AI analizi için kendi kaynak gereksinimleri vardır. Dağıtımı mesaj hızı, ekler, saklanan geçmiş ve eşzamanlı hesaplara göre boyutlandırın; kolay kurulum, her iş yükü için sabit bir bellek ayak izi garantisi anlamına gelmez.

## Kime fayda sağlarsa sağlasın, kaydı koruyun

Amaç, gözlemlenen materyali, bağlamı ve değişiklikleri, hangi tarafın pozisyonunu desteklediklerine bakılmaksızın korumaktır. Kanıtlar, toplayıcının olaylara ilişkin kendi anlatımına meydan okuyabilir. Kaynak gözlemleri, eksik kapsam ve analitik sonuçların tanımlanabilir olmasını sağlayın, böylece başka bir kişi aynı materyali değerlendirebilsin.

İşleyiş şöyledir: hesap tarafından görülebilen gözlem → imzalı günlük → dışa aktarma → alıcı doğrulaması. Kaydedilen düzenlemeler yeni sürümler oluşturur. Silinen gözlemler, daha önce yakalanan içeriği korur. Kapsam kayıtları, bilinen kesintileri ortaya çıkarır. Raporlar ve yapay zeka analizleri, kaydedilmiş kaynaklara atıfta bulunur; bir yorum, yalnızca imzalı bir raporda yer aldığı için bir kaynak gözlemi haline gelmez.

| Doğrulama kontrolü | Alıcının neyi tespit edebileceği |
| --- | --- |
| Dosya hash değerleri, imzalar ve günlük zinciri | Sağlanan kayıtlar ve dosyalar, beklenen anahtar ve günlük sınırlarıyla uyumludur. |
| Ayrı olarak saklanan bir kontrol noktası veya tanık | Arşiv, daha önce saklanan günlük durumuyla uyumludur. |
| Doğrulanmış harici zaman damgası | Bahsedilen baytlar, belirtilen güven varsayımları kapsamında zaman damgası ile mevcut durumdaydı. |
| GitHub yakalama tasdiki | Arşiv, onaylanmış iş akışına, toplayıcı revizyonuna ve kaydedilmiş özet bilgisine uygundur. |

Bu kontroller, bütünlük ve kaynak doğrulamasını destekler. Ancak bunlar, mesajın içeriğini doğru bir ifadeye dönüştürmez veya silinmiş ve görülmemiş mesajları yeniden oluşturmaz. Bağımsız olarak elde edilmiş bir anahtar parmak izi ile [güven kılavuzu](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) ve [kanıt formatı](https://phishdestroy.github.io/TgWitness/tr/docs/reference/evidence/)'daki doğrulama adımlarını kullanın.

## Yayınlanmış ölçek ve ölçülen performans

Aşağıdaki sonuçlar farklı iş yüklerini ve tarihleri açıklamaktadır. Sayılar birbirinin yerine kullanılamaz: bir günlük olayı, mutlaka benzersiz bir Telegram mesajı anlamına gelmez.

| Tarih | İş yükü | Yayınlanan sonuç | Neler ölçüldü? |
| --- | --- | --- | --- |
| 1 Kasım 2026 | Çalışan sunucu, on çalışma alanı veritabanı | 1,610,818 günlük kayıtları; 900,232 yeni mesaj olayları, 80,683 düzenleme olayları ve 400,536 silme olayları | Salt okunur envanter; bir verim testi veya yeni bir tam zincir doğrulama değildir. |
| 5 Kasım 2026 | 200 sohbetlerindeki 1,000,000 sentetik mesajda arama yapın | 71 saniyede oluşturulan dizin; sorgu başına medyan arama süreleri 9–190 ms | Yerel arama karşılaştırması; canlı Telegram iletimi değildir |
| 6 Kasım 2026 | İki yeni gerçek Telegram dışa aktarma dosyası | 27,030 ve 29,299 mesajları; her iki çalıştırmada da 56,329 | WARP üzerinden her çalıştırmada iki hesap, metin ve meta veriler; ek indirmeleri yoktur |
| 6 Kasım 2026 | Hazırlık ve paketleme dahil olmak üzere aynı iki dışa aktarım | 127.713 ve 141.781 mesaj/saniye | Ölçülen tam dışa aktarım oranları; her iki arşiv de sabitlenmiş anahtarlara göre doğrulanmıştır |

[Doğrulama kaydı](https://phishdestroy.github.io/TgWitness/tr/docs/reference/verification/) , sunucu envanterini, canlı toplama kontrollerini ve arama ölçümlerini içerir. [Dışa aktarma performansı](https://phishdestroy.github.io/TgWitness/docs/validation/) , iki gerçek çalıştırma, donanım, süreler, arşiv hash'leri ve imzalı ölçüm dosyalarını yayınlar. Bunlar, evrensel bir oran veya kapasite sınırı değil, kaydedilen revizyonlar ve koşullar için sonuçlar ortaya koyar.

### Test geçmişi ve süresi

Proje sorumlusu, 6 Kasım 2026 itibarıyla altı aydan fazla süren testler hakkında bilgi vermektedir. Bu metin, projenin test geçmişini açıklamaktadır. Yukarıdaki tarihli kamuya açık ölçümler tek tek çalıştırmaları belgelemektedir; bunlar, bağımsız olarak doğrulanmış, kesintisiz altı aylık bir toplama çalışmasını kanıtlamaz. Dışa aktarılan mesajların yaşı da toplayıcının çalışmaya başladığı zamandan farklıdır.

## Yetenek durumunu doğru bir şekilde okuyun

Her iş akışını, uygulamasına, yayınlanmış derlemesine ve kaydedilmiş testlere göre değerlendirin. Kaynak şu anda önizleme olarak etiketlenmiştir. Bu sürüm etiketi, çalışan koleksiyon, dışa aktarmalar, bağımsız doğrulama ve yayınlanmış ölçek ölçümleriyle bir arada bulunmaktadır. Aynı uygulamada hem bir önizleme özelliği hem de doğrulanmış bir iş akışı bulunabilir; bir değerlendirmenin ardındaki belirli özelliği ve kanıtları açıklayın.

[Mevcut yetenekleri](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [özellikleri ve sınırlamaları](https://phishdestroy.github.io/TgWitness/tr/docs/reference/features/), [doğrulamayı](https://phishdestroy.github.io/TgWitness/tr/docs/reference/verification/) ve [değişiklik günlüğünü](https://phishdestroy.github.io/TgWitness/tr/docs/reference/changelog/) birlikte kullanın. Bir sonucu alıntılarken test edilen revizyonu kaydedin. 6 Kasım ölçüm anlık görüntüsü, başarısız ve atlanan testleri de içerir; bunlar başarılı sayılmaz.

## İnsanlar ve yapay zeka araçları tarafından okunabilir

Web sitesi, özet bir `llms.txt`, `llms-full.txt` ve `llms-full.md`'de eksiksiz bir İngilizce el kitabı ve sayfalarının Markdown sürümlerini sunmaktadır. Bunlar dokümantasyon formatlarıdır, TgWitness'ü çalıştırmak için bir AI gerekliliği değildir.

İsteğe bağlı [MCP](https://phishdestroy.github.io/TgWitness/tr/docs/reference/mcp/) ve [komut satırı erişimi](https://phishdestroy.github.io/TgWitness/tr/docs/reference/cli/), yetkili araçların seçilen kaydedilmiş kayıtları okumasına izin verir. Mesaj içeriği güvenilmez girdi olarak kalır. Özetlerde kaynaklara atıfta bulunulmalı, gözlemlenen gerçekler çıkarımlardan ayrılmalı ve belirsizlik korunmalıdır. Tam metin arama, OCR ve yapay zeka çıktıları, orijinal imzalı gözlemleri değiştirmez.