# Telegram · Hızlı başlangıç

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

TgWitness'i kurmanın ve çalıştırmanın tüm yolları: Windows paketi, Python, Docker ve ilk kontrolleri içeren sentetik demo.

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

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

TgWitness'i kurmanın ve çalıştırmanın tüm yolları: Windows paketi, Python, Docker ve ilk kontrolleri içeren sentetik demo.

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

![Başlangıç](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

**İngilizce** · [Русский](https://github.com/phishdestroy/TgWitness/blob/main/docs/ru/QUICKSTART.md) · [Ukraynaca](https://github.com/phishdestroy/TgWitness/blob/main/docs/uk/QUICKSTART.md) · [Español](https://github.com/phishdestroy/TgWitness/blob/main/docs/es/QUICKSTART.md) · [Portugizce (Brezilya)](https://github.com/phishdestroy/TgWitness/blob/main/docs/pt/QUICKSTART.md) · [Türkçe](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) · [Urduca](https://github.com/phishdestroy/TgWitness/blob/main/docs/ur/QUICKSTART.md) · [Hintçe](https://github.com/phishdestroy/TgWitness/blob/main/docs/hi/QUICKSTART.md) · [Endonezyaca](https://github.com/phishdestroy/TgWitness/blob/main/docs/id/QUICKSTART.md) · [Tiếng Việt](https://github.com/phishdestroy/TgWitness/blob/main/docs/vi/QUICKSTART.md) · [Basitleştirilmiş Çince](https://github.com/phishdestroy/TgWitness/blob/main/docs/zh/QUICKSTART.md)

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](https://phishdestroy.io/tgwitness/tr/docs/reference/quickstart/#explore-the-interface). Proxy'ler, tanıklar, dışa aktarımlar veya sunucu kurulumu için [bir kılavuz seçin](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md). [GitHub Actions yakalama](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) (ö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ü](https://phishdestroy.io/tgwitness/tr/docs/reference/installation/), 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](https://github.com/phishdestroy/TgWitness/archive/refs/heads/main.zip) 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](https://phishdestroy.io/tgwitness/tr/docs/reference/deployment/), otomatik HTTPS, yeniden başlatma, yayınlanan görseller, güncellemeler ve yedeklemeleri kapsar.

## Arayüzü keşfedin

1. 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 --demo` komutunu çalıştırın. Kaynak klasörden başlatıldığında önce `.venv` dosyası oluşturulur ve bağımlılıklar yüklenir.
2. **http://127.0.0.1:8787 adresini** açın.
3. 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.

1. Yerel demo çalışıyorsa, onu durdurun ve **Start.cmd** veya `sh start.sh` dosyasını çalıştırın. Aksi takdirde, yukarıda başlatılan canlı kurulumu çalışır durumda bırakın.
2. Giriş yapmak için panel jetonunu kullanın. [İlk kurulumda](https://phishdestroy.io/tgwitness/tr/docs/reference/settings/) yeni bir çalışma alanı açılır. **Bir vaka için Sadece indir**, **Sohbetleri takip et** veya **Kanıt seçenek**lerinden birini seçin.
3. 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.
4. **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.
5. 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,](https://phishdestroy.io/tgwitness/tr/docs/reference/panel/) 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](https://phishdestroy.io/tgwitness/tr/docs/reference/accounts/) 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ı](https://phishdestroy.io/tgwitness/tr/docs/reference/accounts/#bulk-import-and-account-groups) bölümüne bakın.

Başka bir hesap eklemek için hesap seçicinin yanındaki **+ işaret**ine 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 bir `chat.html` dosyası 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_SHA256` komutuyla 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ı](https://phishdestroy.io/tgwitness/tr/docs/reference/timestamp/) 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](https://phishdestroy.io/tgwitness/tr/docs/reference/connection/) 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ı](https://phishdestroy.io/tgwitness/tr/docs/reference/collection/) 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ı](https://phishdestroy.io/tgwitness/tr/docs/reference/operations/), barındırma için [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/tr/docs/reference/deployment/) dosyasını ve hizmet örnekleri için [deploy/](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md) 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](https://phishdestroy.io/tgwitness/tr/docs/reference/verification/) ve [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md) dosyalarında kaydedilmiştir.
