Referans / Kurulum
Telegram · Hızlı başlangıç
TgWitness'i kurmanın ve çalıştırmanın tüm yolları: Windows paketi, Python, Docker ve ilk kontrolleri içeren sentetik demo.
İngilizce · Русский · Ukraynaca · Español · Portugizce (Brezilya) · Türkçe · العربية · فارسی · Urduca · Hintçe · Endonezyaca · Tiếng Việt · Basitleştirilmiş Çince
TgWitness, hesaplarınızın erişebildiği Telegram gruplarını ve kanallarını izlemek için kullanılan bağımsız bir uygulamadır. Kendi veri diziniyle yerel olarak çalışır.
İlk kez mi ziyaret ediyorsunuz? Bir hesap bağlamadan önce demoyu inceleyin. Proxy'ler, tanıklar, dışa aktarımlar veya sunucu kurulumu için bir kılavuz seçin. GitHub Actions yakalama (önizleme), yerel bir kurulum yerine kendi GitHub çatalınızda bir yakalama işlemi yürütür.
Yükleyin ve başlatın#
Kılavuzlu yükleyici kendi Python sürümünü içerir ve yüklemeden önce paket hash değerlerini ve sürüm imzalarını kontrol eder. Tekrar çalıştırıldığında mevcut kurulum güncellenir.
Linux / macOS:
curl -fsSL https://get.destroy.tools/install.sh | bash
Windows (PowerShell veya Komut İstemi):
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
Ubuntu sunucusunda, arka plan hizmetini kurmak için root olarak çalıştırın; masaüstü bilgisayarda ise normal kullanıcı hesabınızla çalıştırın. Ubuntu’da yükleyici, panel adresini ve erişim anahtarını görüntüler; macOS ve Windows’ta ise yerel panel tarayıcınızda açılır. Aşağıdaki Telegram’a Bağlan bölümünden devam edin. Kur, Doğrula ve Güncelle bölümü, sunucu erişim seçeneklerini, komut dosyasını çalıştırmadan önce kontrol etmeyi, güncellemeleri ve kaldırmayı kapsar.
Diğer yöntemler#
GitHub sürümleri, kaynak kodu ve Docker, yükleyicinin alternatifleridir. Taşınabilir indirmeler, bir sürüm derlemesi yayınlandıktan sonra kullanıma açılır:
| Barındırma | Yükleme gerektirmez | Kaynak: Python 3.11+ | Docker: Engine/Desktop ile Compose 2.20+ |
|---|---|---|---|
| Windows | GitHub Sürümleri'nden TgWitness-<version>-windows-amd64-portable.zip dosyasını çıkarın, TgWitness.cmd dosyasına çift tıklayın |
Start.cmd'ye çift tıklayın |
scripts\Docker.cmd'ye çift tıklayın |
| Linux / macOS | — | sh start.sh |
sh scripts/docker-start.sh |
Kaynak kodu yöntemleri için güncel main dalını indirip çıkarın veya depoyu klonlayın:
git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness
Start.cmd, uygun bir Python bulunamazsa Windows kullanıcınız için Python 3.12 kurmayı önerir (winget veya imzalı python.org yükleyicisi ile). start.sh, Python eksikse Linux dağıtımınız veya macOS için tam kurulum komutunu yazdırır. Kaynak koddan ilk başlatma, .venv ortamını oluşturur ve bağımlılıkları otomatik olarak yükler.
Docker, uygulamayı derler ve arka planda çalıştırır; Python ana bilgisayarı
gerekmez. scripts\Docker.cmd ve scripts/docker-start.sh, konteyner
çalışır durumdayken panel adresini ve jetonu yazdırır. Desteklenen her ana bilgisayarda kullanılabilecek eşdeğer Docker komutları şunlardır:
docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt
http://127.0.0.1:8787 dosyasını açın. Docker yardımcı programı veya ikinci Docker komutu tarafından yazdırılan jetonu kullanın ya da taşınabilir veya kaynak kurulum için data/live/panel-token.txt dosyasını okuyun. Aşağıdaki "Telegram'ı Bağla" bölümünden devam edin. Yerel ve Docker kurulumları ayrı depolama alanları kullanır; Docker'ı başlatmak, mevcut bir yerel günlüğü içe aktarmaz.
Sunucu için dağıtım, otomatik HTTPS, yeniden başlatma, yayınlanan görseller, güncellemeler ve yedeklemeleri kapsar.
Arayüzü keşfedin#
- Taşınabilir paketteki TgWitness-Demo.cmd
dosyasını
, Windows kaynak
klasöründeki scripts\Demo.cmd
dosyasını veya Linux/macOS'ta
sh start.sh --demokomutunu çalıştırın. Kaynak klasörden başlatıldığında önce.venvdosyası oluşturulur ve bağımlılıklar yüklenir. - http://127.0.0.1:8787 adresini açın.
- Yerel demo, örnek günlüğü otomatik olarak açar. Doğrudan yerel erişim için herhangi bir erişim kodu kopyalanmasına gerek yoktur.
Demo mesajları kurgusaldır. Demo modunda gerçek bir Telegram hesabına bağlanılamaz.
Telegram'a bağlan#
[!UYARI] Özel hesaplar kullanın. Telegram, istemci ne olursa olsun, aşırı bulduğu istek hacimleri nedeniyle hesapları kısıtlayabilir veya kalıcı olarak yasaklayabilir. Kişisel veya değerli hesaplar yerine gözlem için hazırlanmış hesapları bağlayın ve özel bir hesapta bir API kimliği / hash oluşturun.
- Yerel demo çalışıyorsa, onu durdurun ve Start.cmd veya
sh start.shdosyasını çalıştırın. Aksi takdirde, yukarıda başlatılan canlı kurulumu çalışır durumda bırakın. - Giriş yapmak için panel jetonunu kullanın. İlk kurulumda yeni bir çalışma alanı açılır. Bir vaka için Sadece indir, Sohbetleri takip et veya Kanıt seçeneklerinden birini seçin.
- Bağlantı kontrolünü gözden geçirin. Gerekirse kendi proxy'nizi yapılandırın; bağlantı ayarları kurulumdan sonra da kullanılabilir durumda kalır.
- Connect Telegram'da bir telefon numarası, bir QR kodu, hesap dosyaları (TData,
.session, StringSession, hesap JSON) veya eksiksiz bir yetkilendirme anahtarı seçin. İstenildiğinde Telegram onayını, kodu ve iki aşamalı şifreyi girin. - Görüntülenen hesabı kontrol edin, sohbetleri seçin ve ayarlarınızı gözden geçirin. Son ekrandan işlemi tamamlayın. Yalnızca indir seçeneğinde, Dışa Aktarmayı Başlat seçeneği tek seferlik bir dışa aktarma işlemini başlatır ve ilerleme durumunu göstermek için Dışa Aktarmalar sayfasını açar; sürekli gözlem özelliğini etkinleştirmez.
Kurulumdan sonra, Sohbetler → Seç seçeneği seçili sohbetleri değiştirir. Ayarlar, toplama ve dosyaları kontrol eder; Diğer araçlar → Kaynaklar, Standart veya Uzman düzeyinde ayrıntılı kaynak listesini sunar. Panel kılavuzu, altı ana bölümü ve bunlara ait bağlamsal denetimleri açıklar.
API Kimliği + Hash isteğe bağlıdır: çalışma alanı, kaydedilmiş veya içe aktarılmış çifti
ya da yerleşik havuzdan alınan bir çalışma çiftini kullanır. Kendi uygulamanızı kullanmak için, bir
API ID:API Hash çiftini API Kimliği alanına yapıştırın. Kimlik Doğrulama anahtarı için, 512 onaltılık
karakterin tamamını yapıştırın ve sağlanan DC Kimliğini seçin. Kullanıcı Kimliği isteğe bağlıdır ve girildiğinde kontrol edilir.
API kimlik bilgileri uygulamanızı tanımlar; tek başlarına bir hesaba yetki vermezler. Özel gruplar için herkese açık kullanıcı adı gerekmez, ancak hesabınızın erişim izni olmalıdır.
Mevcut hesaplar için hesap ve oturum biçimlerine bakınız: panel, Telethon StringSession, Telethon/Pyrogram SQLite, tek hesaplı TData ZIP ve desteklenen hesap JSON biçimlerini kabul eder. Bir oturumu ve ona ait JSON dosyasını birlikte seçin, Dosyaları Kontrol Et düğmesine basın, ardından Hesaba Bağlan seçeneğini tıklayın. QR ile giriş de aynı isteğe bağlı API ayarlarıyla kullanılabilir. TDLib, bot oturumları ve CSV/JSON hesap envanterleri desteklenmemektedir.
Birden fazla hesap için Hesaplar → Hesapları içe aktar yolunu kullanın ve desteklenen oturum dosyalarını seçin. Eşlik eden JSON dosyaları temel dosya adına göre eşleştirilir; içe aktarılan her hesap kendi çalışma alanını alır. Toplu içe aktarma ve hesap grupları bölümüne bakın.
Başka bir hesap eklemek için hesap seçicinin yanındaki + işaretine basın veya Hesaplar → Hesap ekle seçeneğini kullanın. Çalışma alanlarının ayrı oturumları, günlükleri, anahtarları, kaynakları ve kuyrukları vardır. Görünümler arasında geçiş yapıldığında diğer toplayıcılar çalışmaya devam eder. Bu kurulumda aynı Telegram hesabı iki çalışma alanına atanamaz. Çalışma alanlarının sabit bir sayısı yoktur; bunlar tek bir işlemi paylaşır, dolayısıyla kapasite makineye bağlıdır.
Canlı panel jetonu, Telegram yetkilendirmelerinize ve kaydedilmiş
materyallerinize erişimi korur; bu, Telegram API kimlik bilgilerinden ayrıdır. Yalnızca açıkça başlatılmış,
doğrudan erişilen yerel bir demo otomatik olarak giriş yapabilir. Uzak/proxy üzerinden erişilen bir demo ise yine de
data/demo/panel-token.txt'yi kullanır.
İnceleme ve dışa aktarma#
- Günlüğü: Gözlemleri kaynağa ve olay türüne göre arayın ve filtreleyin.
- Bir olayı seçerek orijinal kaydını, kaynağını ve kaydedilmiş sürümlerini inceleyin.
- Düzenleme ayrıntıları, mevcut "öncesi/sonrası" içeriğini gösterir. Silme ayrıntıları ise varsa en son yakalanan içeriği gösterir; kimliği bilinmeyen bir aktör ise bilinmez olarak kalır.
- Dışa aktarma formatları: imzalı ZIP, JSONL, CSV ve çevrimdışı HTML.
- Tam sohbet dışa aktarma (Sohbetler → Sohbeti dışa aktar veya Dışa Aktarmalar → Bir
sohbeti yakala veya dışa aktar): Bir sohbetin görünür
tüm geçmişini,
chat.json(Telegram dışa aktarma stili) ve okunabilir birchat.htmldosyası içeren imzalı bir paket olarak indirin. Özel sohbetler, hesap üye olduğunda çalışır. Bu, silinmiş veya daha önce düzenlenmiş mesajların yeniden oluşturulması değil, güncel bir anlık görüntüdür. Bir kopyayıpython verify.py chat-export.zip --fingerprint TRUSTED_SHA256komutuyla doğrulayın. - Kontrol noktası: İmzalı günlüğün sınırını toplayıcının dışında tutun.
- İmzalı çalıştırma makbuzunu indirin: toplayıcının program/sürüm kaydını saklayın.
- Zaman damgası isteği hazırlayın: bir zaman damgası yetkilisine yönelik çevrimdışı bir istek hazırlayın; yanıtı almak ve doğrulamak için TIMESTAMP.md dosyasını izleyin.
- Günlüğü doğrulayın: olay imzalarını ve zincir bağlantılarını kontrol edin. ZIP olarak dışa aktarma işlemi sırasında medya dosyaları da kontrol edilir.
Desteklenen tarayıcılar, büyük boyutlu dışa aktarımları doğrudan seçilen bir dosyaya kaydeder. Diğer tarayıcılar en fazla 128 MiB'lik bir önbellek kullanır. Sunucu çalışırken, akış CLI'si tüm yanıtı önbelleğe almadan daha büyük boyutlu indirmeleri destekler:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
Başka bir çalışma alanı için, Dışa Aktar → Çalışma Alanı Kimliği seçeneğini kullanarak --profile ID ekleyin.
Uzak bir sunucu için --url https://your-server ekleyin. Varsayılan aktarım sınırı
5 GiB'dir; --max-mib ile bu sınır değiştirilebilir. İmzalı ZIP içeriği, varsayılan olarak ayrı bir 4 GiB sıkıştırılmamış
doğrulama sınırına sahiptir (More tools → Parameters bu sınırı artırır; bu tür arşivleri
verify.py --max-gib N komutuyla doğrulayın). Arşivi, doğrulayıcının güvenilir bir kopyası,
bağımsız olarak saklanan anahtar parmak izi ve kanıt için asgari düzeyde zaman damgası
otoritesinin kök sertifikası (--tsa-ca) kullanılarak doğrulayın.
Kurulumu kontrol edin#
python start.py --setup-only
python start.py --check
python start.py --check --json
--check, yerel bağımlılıkları, imza desteğini, depolama alanını, anahtar yapılandırmasını ve
dinleme adresini kontrol eder. Herhangi bir şey yüklemez veya Telegram'a bağlanmaz. Meşgul bir
bağlantı noktası, başka bir örneğin çalışıyor olabileceği anlamına gelebilir. Farklı bir --port kullanın veya önce bunu durdurun.
Başlatıcı, .venv'ye yüklenir. Yardımcı python -m tgwitness... komutları,
söz konusu ortam zaten etkinleştirilmemişse, Windows'ta .venv\Scripts\python.exe'yi veya Linux/macOS'ta .venv/bin/python'yi
kullanmalıdır.
Oturumlar, koruma ve çalışma#
Kapalı, tutarlı bir Telethon SQLite .session dosyası, yerel olarak
python -m tgwitness.sessions account.session --out account.tgwitness-session komutuyla dönüştürülebilir, ardından
Daha fazla araç → Hesap → Dosyalar bölümünden yüklenebilir. Doğrudan dosya içe aktarma ve QR koduyla giriş seçenekleri de mevcuttur. Giriş formatları, SOCKS5,
HTTP CONNECT, MTProxy ve harici anahtarlar için
CONNECTION-SECURITY.md dosyasına bakınız.
Gözlemi duraklatmak, toplama işlemini durdurur. Kilitleme yalnızca tarayıcı erişimini kapatır. Sekmeyi kapatmak, toplayıcı sürecinin çalışmaya devam etmesine neden olur. Süreci durdurmak, toplama işlemini kesintiye uğratır; geçmiş anlık görüntüsü, kaçırılan tüm düzenlemeleri veya silme işlemlerini yeniden oluşturamaz. Olay ilkeleri, ek kuyrukları, hesap izolasyonu ve yeniden başlatma davranışı için toplama işleminin nasıl çalıştığını inceleyin.
Oturumlar ve gizli bilgiler şifrelenmiştir. Mesaj içeriği, medya ve dışa aktarımlar için şifrelenmiş bir disk veya birim gereklidir. Günlük imzalarını güvenilir bir anahtarla doğrulayın ve kontrol noktalarını ayrı olarak saklayın. Seçilen toplama modu için yakalama kayıtlarını, harici zaman makbuzlarını ve ortam onaylarını inceleyin.
Yedekleme/geri yükleme için OPERATIONS.md dosyasını, barındırma için DEPLOYMENT.md
dosyasını ve hizmet örnekleri için deploy/ dosyasını okuyun. Yüklenen
panel ayrıca /guide.html adresinde bir çevrimdışı kurulum kılavuzu içerir.
Gerçek doğrulama ve mevcut sınırlamalar VERIFICATION.md ve READINESS.md dosyalarında kaydedilmiştir.