TgWitness / Belgeler

Neler test edildi →

Bu sayfanın bazı bölümleri hâlâ İngilizce'dir: İngilizce orijinal metin, çevrildikten sonra değiştirilmiştir.

Referans / Kurulum

Telegram · Bağlantı, proxy'ler ve veri koruma

Kimlik doğrulama, otomatik proxy havuzları, IP modları, yedekleme politikası, harici istekler ve gizli depolama.

TgWitness / Belgeler · Dağıtım ve kurtarma

Dağıtım ve kurtarma

Bu belge, TgWitness0.9.3'nin davranışını ve sınırlarını açıklamaktadır. Kimlik doğrulama, kaynak erişimi, ağ bağlantısı ve yakalama eksiksizliği ayrı durumlardır. Oturum açma adımları, dosya biçimleri ve birden fazla hesap için hesaplar ve oturum biçimleri bölümünden başlayın. Olay ilkeleri ve yeniden başlatma davranışı için, toplama işleminin nasıl çalıştığına bakın.

Kılavuzlu bağlantı kurulumu#

İçinde Diğer araçlar → Hesap → Bağlantı yolu, yönetici şunlardan birini seçebilir: Bu hesap, Bir hesap grubu veya Tüm hesaplar, ardından bir rota seçin. İnceleme seçimi etkilenen hesapları listeler. Hazırlayın ve kontrol edin kaydedilmiş rotayı değiştirmeden önerilen rotayı test eder. İşaretli bağlantıyı uygula önizlemeyi doğrular, gerekirse gözlemi duraklatır, rotayı kaydeder ve halihazırda devam etmekte olan gözlemi yeniden başlatır. Daha önce etkin olmayan bir hesapta veri toplamayı asla başlatmaz. Geçmiş indirmeleri duraklatılmış halde kalır ve ayrı olarak yeniden başlatılabilir. Geçiş yapmadan önce aktif dışa aktarmaları duraklatın.

Grup değişiklikleri, varsayılan olarak hesapların kendi rotalarını korur. Bu seçeneği yalnızca önizleme, istediğiniz değişiklikleri listelediğinde kaldırın. Uygulama, her bir hesabın sonucunu raporlar; bu, veritabanları arasında "ya hep ya hiç" türünde bir işlem değildir. Başarısız bir geçiş, o hesabın önceki ayarlarını geri yükler. Devam ettirilememesi durumu açıkça gösterilir. Önizlemeler on dakika sonra geçerliliğini yitirir ve bağlantı ayarlarında veya grup üyeliğinde yapılan değişiklikler yeni bir kontrol gerektirir.

Apply, rota, mod ve ilke değişmediği sürece başarılı bir ön kontrol sonucunu en fazla 90 saniye boyunca yeniden kullanır. Yönetilen bir tünelin yine de aynı çalışan işlemine sahip olması gerekir. Daha eski sonuçlar, değiştirilmiş tünel işlemleri ve otomatik MTProxy havuzu rotaları yeniden kontrol edilir. İmzalı uygulama kaydı, orijinal kontrol zamanını korur ve yeniden kullanımı ile bunun süresini kaydeder. Her ön kontrol, geçici ve kimliği doğrulanmamış istemcisini kapatır; toplayıcı ise kendi yetkilendirilmiş oturumunu kullanarak bağlanır.

Yol TgWitness'nin yönettiği şeyler
Doğrudan Ana bilgisayardan gelen bağlantılar; harici bir ana bilgisayar VPN'i algılanmıyor veya uygulanmıyor.
VPN Hesap başına bir tam tünel WireGuard profili, yerel kullanıcı alanı SOCKS5 süreci tarafından yürütülür. Hiçbir ana bilgisayar arayüzü veya sürücüsü yüklenmez.
Proxy'im SOCKS5, HTTP CONNECT veya MTProxy kimlik bilgileri. SOCKS5/HTTP alanları bir URL ile doldurulabilir. Birden fazla hesap seçildiğinde, girilen bu proxy paylaşılır.
Halka Açık MTProto Mevcut havuz, Telegram rotalarını atar. Gelişmiş ayarlarda ayrı bir uygun proxy yapılandırılana kadar harici istekler devre dışı bırakılır.
WARP Seçilen her hesap için ayrı bir yerel tünel; WARP kaydı ve WireGuard profili, ilgili hesabın kasasında saklanmalıdır.

Mevcut rota kontrolü, hesabın oturumunu değil, yeni ve kimlik doğrulaması yapılmamış bir Telegram aktarımını kullanır. Rota üzerinden hesabın veri merkezine bir aktarım bağlantısı açar ve kimlik doğrulaması yapılmamış bir MTProto gidiş-dönüş işlemi gerçekleştirir (req_pq_multi); herhangi bir yetkilendirme anahtarı oluşturmaz ve hesap kullanmaz. Bildirilen gecikme süresi, bağlantı süresi artı gidiş-dönüş süresidir ve kontrol her iki kısmı da ayrı ayrı kaydeder. HTTP destekleyen rotalar için ayrıca Cloudflare'in HTTPS izlemesini talep eder ve rapor edilen çıkış IP'sini, ülkeyi, WARP durumunu ve kontrol zamanını görüntüler. İzleme, WARP'ın aktif olduğunu bildirmedikçe WARP hazırlığı başarısız olur. Bu ön kontrol denetimleri, rota bağlantısını ve gözlemlenen çıkış noktasını raporlar. Arşivin toplama ve doğrulama sonuçları aracılığıyla yakalanan kayıtları inceleyin. Yalnızca çalışan bir yerel işlem, başarılı bir çıkış kontrolü anlamına gelmez.

Panel, son beş kontrolün hareketli ortalamasını tutar. Bir rota, ortalama 5 saniyeyi aştığında veya arka arkaya üç kontrol bu süreyi aştığında yavaş olarak değerlendirilir ve arka arkaya iki başarısız kontrolün ardından kullanılamaz hale gelir; network.slow_route ve network.route_recovered değişiklikleri kaydeder. Yavaş bir WARP rotası durumunda, WARP’ı Yeniden Çalıştır seçeneği hesabın diğer Cloudflare WARP uç noktalarına yönelik tünelini yeniden başlatır, en hızlı olanı seçer ve network.warp_rerolled öncesi ve sonrasındaki zamanlarla birlikte kaydeder; New WARP identity, yeni bir WARP cihazı kaydeder ve yalnızca daha hızlı olduğunda bunu korur. Yerel proxy adresi, Telegram hesabı ve oturumu aynı kalır; Telegram bağlantıları yeniden başlatılan tünel üzerinden yeniden bağlanır. Yavaş bir WARP rotası en fazla 30 dakikada bir otomatik olarak yeniden yuvarlanır; bu işe yaramadığında, sonraki yeniden yuvarlamalar operatörün müdahalesini bekler.

Taşınabilir WARP ve WireGuard#

Bu, resmi olmayan bir WARP entegrasyonudur; , wgcf 2.3.1, ve wireproxy 1.1.3, kullanılır. Yönetici, ilk indirme veya WARP kayıt işleminden önce kurulumu açıkça kabul eder. Bu kurulum bağlantıları doğrudan GitHub ve Cloudflare’e gider ve makinenin IP adresini ortaya çıkarır. Sıradan hesap trafiği, uygulamaya kadar mevcut rotasını korur. Cloudflare çıkış adresini ve ülkeyi seçer; ayrı tüneller bir çıkış adresini paylaşabilir. Ülke seçimi, periyodik IP rotasyonu ve ana bilgisayar genelinde VPN kill switch bu özellik tarafından sağlanmaz.

Desteklenen yardımcı program indirmeleri: Linux ve macOS x86-64/ARM64 ile Windows x86-64. Yapıtlar, incelenen kaynakta bulunan SHA-256 hash değerleriyle karşılaştırılarak kontrol edilir ve önbelleğe alınmış yürütülebilir dosyalar çalıştırılmadan önce tekrar kontrol edilir. Hiçbir yardımcı program PATH'e eklenmez, sistem hizmeti olarak yüklenmez veya halka açık bir dinleyici atanmaz. Tüm dosyalar, çalışma alanının portable-routes/ dizininde ve şifrelenmiş kasa girişlerinde bulunur. SOCKS5 döngü geri dinleyicisi, bağımsız olarak oluşturulan kimlik bilgilerini gerektirir.

Özel profiller ve WARP hesap kimlik bilgileri, mevcut çalışma alanı kasası ile şifrelenir. Çalışırken, yardımcı programın yalnızca sahibine ait düz metin bir yapılandırmaya ihtiyacı vardır; bu, normal bir durdurma işleminde kaldırılır. Bir ana bilgisayar çökmesi, bu dosyayı yalnızca sahibine ait veri klasöründe bırakabilir. Bu, diski şifrelemez veya yöneticiye karşı koruma sağlamaz. Panelin üst düzeydeki borusu ortadan kalkarsa, denetleyici tüneli kapatır. Başarısız bir tünel asla doğrudan yedeklemeyi etkinleştirmez. Panel yeniden başlatıldığında seçilen tünel geri yüklenir; başarısız başlangıçlar, sınırlı bir gecikmeyle yeniden denenir. Tüneli durdur ayrıca gözlemi duraklatır ve durdurulmuş durumu korur. Tüneli başlat tüneli başlatır; hazır olduğunda gözlemi ayrı olarak devam ettirin.

Yüklenen WireGuard profilleri bir Arayüz ve bir Eş, tam IPv4 ve IPv6 rotaları içermeli; kanca, dahil etme, ortam değiştirme veya fazladan dinleyici içermemelidir. Genel uç nokta adresleri, başlatma öncesinde çözümlenir ve sabitlenir. OpenVPN/IPsec ve özel uç noktalar için harici bir VPN veya SOCKS5 ağ geçidi kullanın.

Kimlik doğrulama yöntemleri#

API Kimliği ve API hash'i bir uygulamayı tanımlar; hesap girişinin yerini almazlar. TgWitness'te bunlar isteğe bağlıdır. Öncelik sırası: forma girilen bir çift, ardından içe aktarılan hesap JSON'undan bir çift, sonra çalışma alanında kaydedilen çift ve son olarak da Telegram'ın birini reddetmesi durumunda otomatik rotasyonla rastgele sırayla denen genel çift havuzundan gelenler denir; Telegram bir çifti reddettiğinde otomatik rotasyonla rastgele sırayla denenir. Yalnızca Telegram Desktop çifti (2040), eşleşen Telegram Desktop istemci açıklamasıyla birlikte gönderilir. my.telegram.org adresindeki API Geliştirme Araçları'ndan aldığınız kendi çiftiniz tüm hesaplarınızla kullanılabilir; her hesabın yine de kendi yetkilendirme bilgisi vardır.

Yöntem Gereksinimler TgWitness desteği
Telefon, kod, isteğe bağlı 2FA Hesap erişimi; API çifti isteğe bağlı Panel girişi
Oturum Açma Anahtarı HEX + DC Kimliği Tam 512 karakterlik anahtar ve DC 1–5 Doğrudan Otorizasyon anahtarı sekmesi; yetkilendirme kaydedilmeden önce isteğe bağlı Kullanıcı Kimliği kontrol edilir
Telethon StringSession Geçerli bir oturum dizesi Panel girişi
Telethon SQLite .session Kapalı, tutarlı metin Şemaların doğrudan panelden içe aktarılması 7/8; isteğe bağlı çevrimdışı CLI
Pyrogram SQLite .session Kapalı üretim kullanıcı oturumu Şemaların doğrudan panelden içe aktarılması 2/3
Telegram Masaüstü TData ZIP Tek bir modern hesap; koruma varsa yerel şifre Sağlama toplamı/şifre çözme kontrolleriyle bellek içi dönüştürme
Hesap JSON'u Desteklenen API/oturum/anahtar alanları Meta veriler tek başına API kimlik bilgilerini doldurur; yine de bir oturum/anahtar veya telefon/QR koduyla oturum açma gereklidir
QR ile giriş Yetkili bir Telegram uygulamasından onay Yerel QR kodu oluşturma, süre dolumu/yeniden deneme, isteğe bağlı 2FA
TDLib / Pyrogram StringSession Diğer kütüphaneye özgü formatlar Desteklenmiyor
Bot jetonu Kendi erişim/güncelleme modeline sahip bir bot Bu veri toplayıcı tarafından kullanılmamaktadır

Telegram, SMS gönderilip gönderilmeyeceği de dahil olmak üzere kod teslimatını seçer. Bir API hash'i, iptal edilmiş bir oturumu onaramaz veya unutulmuş bir 2FA şifresinin yerine geçemez. TgWitness, giriş kodlarını veya Telegram 2FA şifresini diske kaydetmez.

Özel bir kaynak için, hesabın zaten erişim iznine sahip olması gerekir. Grup kullanıcı adı gerekmez. Bir proxy veya oturum içe aktarımı, ne üyelik ne de yönetici hakları verir. Üyelerin katılmadan önceki geçmişi görüp görmeyeceği, sohbetin ayarlarına bağlıdır.

Bir Telethon oturum dosyasını içe aktarın#

Telethon SQLite, Pyrogram SQLite, and Telegram Desktop TData use different formats. The panel detects and converts the supported structures; renaming a file is not conversion. Select one session and its companion JSON under Files, press Check files, then Connect account. Up to four matching files and 8 MiB total are accepted. See format limits for TData/JSON details. There is no passcode recovery. Phone/2FA or QR login creates a separate authorization.

İsteğe bağlı, yalnızca Telethon için geçerli olan komut satırı yolu hâlâ kullanılabilir durumdadır:

  1. Müşterinin orijinal oturumu kullanmasını durdurun ve tutarlı bir kopya oluşturun. Dönüştürücü, tamamlanmamış WAL/günlüğü olan dosyaları reddeder. Kontrolü atlatmak için bu dosyaları silmek yerine, orijinal müşteriyi düzgün bir şekilde kapatın.
  2. TgWitness ortamından şu komutu çalıştırın:
python -m tgwitness.sessions account.session --out account.tgwitness-session
  1. Hesap ekle → Dosyalar bölümünden sonucu yükleyin veya dizesini yapıştırın ve devam edin.
  2. Ekranda görüntülenen sayısal hesap kimliğini kontrol edin, kaynakları seçin ve gözlemi başlatın.

Dönüştürülen dosya, şifrelenmemiş bir hesap erişim şifresidir. Bunu güvenli bir depolama alanında saklayın ve asla bir üçüncü taraf dönüştürme hizmetine aktarmayın veya göndermeyin. TgWitness, yetkilendirilmiş oturumu şifreli kasasında saklar. Bir oturumu kopyalamak, ayrı bir yetkilendirme oluşturmaz: klonlanmış yetkilendirme anahtarlarıyla eşzamanlı istemciler çalıştırmayın ve bağımsız güncelleme teslimi olduğunu varsaymayın.

Dönüştürme işlemi, orijinal mesajları, varlık önbelleğini veya kalıcı bir güncelleme imlecini değil, yetkilendirmeyi aktarır. İşlem yeniden başlatmaları arasında güncelleme kurtarmasını düzeltmez.

MTProto, Telethon ve proxy'ler#

MTProto, Telegram'ın protokolüdür. Telethon, TgWitness'in kullandığı Python istemci kütüphanesidir. MTProxy, bir Telegram aktarım proxy'sidir; SOCKS5 ve HTTP CONNECT genel tüneller sağlar. Hiçbiri hesap kimlik doğrulamasının yerini almaz.

Her çalışma alanı için rotayı Diğer araçlar → Hesap → Ayarlar → Bağlantı ayarları → Bağlantı yolunu değiştir giriş yapmadan önce Yeni çalışma alanları varsayılan olarak Otomatik MTProxy · genel listeler ile Adresi gizle. Direct seçeneğini açıkça kullanan mevcut çalışma alanları, bunu izin veren modu korur.

Dosyalar, resmi uygulamaların yaptığı gibi, mesajları okuyan bağlantıdan ayrı bağlantılar üzerinden okunur. Hesabın kendi veri merkezinde, hesabın yetkilendirme anahtarı yeni bir MTProto oturumu ile yeniden kullanılır; başka bir veri merkezi için ise hesap bağlıyken tek bir anahtar oluşturulur ve yetkilendirilir; bu anahtar yalnızca bellekte tutulur. Her dosya bağlantısı, hesapla aynı yolu kullanır. Veri merkezi başına sayıları, Parametreler → Performans → Telegram veri merkezi başına dosya bağlantıları seçeneğiyle sınırlandırılır; 0 değeri, dosyaların yalnızca hesabın ana bağlantısı üzerinden okunmasını sağlar. Bir kurulumdaki tüm hesaplar için aynı anda en fazla beş Telegram bağlantısı kurulabilir.

IP modları#

Yol, bağlantıyı seçer. Panelin Hesap bölümündeki IP modu ve IP koruması, sunucunun adresinin ne zaman açığa çıkabileceğini belirler. Bu denetimler bir VPN kurmaz veya tüm makine trafiğini yönlendirmez.

Mod Telegram Dış talepler
Adresi gizle (hide) Bir proxy kullanın; hiçbiri çalışmazsa bekleyin. Doğrudan yedek çözüm yoktur. SOCKS5/HTTP gerektirir; uygun bir proxy içermeyen istekleri reddeder.
Son çare olarak Direct (fallback) Otomatik MTProxy, yapılandırılan gecikme süresinin ardından Direct'i kullanabilir, ardından çalışan bir proxy'ye geri dönebilir. Önceden yapılandırılmış bir harici proxy veya hesabın SOCKS5/HTTP yolunu tercih edin; aksi takdirde Direct kullanımına izin verilir.
Tünel veya VPN arkasında bulunan sunucu (tunnel) Doğrudan yollar ve anında otomatik havuz yedeklemesi izin verilir. Uygulanabilir bir proxy yapılandırılmamışsa doğrudan erişim izin verilir.

Tünel veya VPN modu, bu ağı ayrı olarak yönettiğinizi varsayar. Çalışır durumda bir tünel olmadan, hedefler sunucunun kendi adresini görebilir. Modu, seçeneğin adına göre değil, gerçek ağınıza göre seçin.

Bir yol seçin#

Yol Ayarlar Sınır
Otomatik MTProxy Yerleşik listeler veya bir operatör kataloğu Çalışır durumda bir Telegram rotası sağlar; doğrudan yedekleme, IP moduna bağlıdır
Doğrudan Tünel veya VPN modu Telethon, sunucunun ağ yolunu kullanır
SOCKS5 Sunucu, bağlantı noktası, isteğe bağlı kullanıcı adı/şifre python-socks, uzaktaki hedef DNS etkinleştirildi
HTTP CONNECT Sunucu, bağlantı noktası, isteğe bağlı kullanıcı adı/şifre Düz HTTP CONNECT; proxy sunucusuna yönelik TLS desteği uygulanmamıştır
MTProxy Sunucu, bağlantı noktası, gizli anahtar Deneysel Telethon aktarım biçimi; 32 onaltılık basamak veya dd + 32 onaltılık basamak

Sahte TLS ee gizli anahtarları reddedilir. Telethon 1.45'in normalleştirme işlevi, önek ve etki alanını kaldırabilir, ancak bu, Sahte TLS'yi uygulamaz. tg://proxy?server=…&port=…&secret=… veya https://t.me/proxy?server=…&port=…&secret=…'yi yapıştırın ve "Bağlantıdan alanları doldur" seçeneğini seçin. Bu işlem, bağlantı kurmadan veya kaydetmeden alanları doğrular ve doldurur; yolu ayrı olarak inceleyin ve kaydedin. Manuel alanlar kullanılabilir durumda kalır. Telegram proxy bağlantılarına bakın.

Kurulumunuz tarafından sağlanan genel proxy'ler#

Yerleşik liste yedi kaynağı bir araya getirir: SoliSpirit/mtproto, zakky8/mtproto-proxy-pro, kort0881/telegram-proxy-collector, 3yed-61/MTP-Collector, Therealwh/MTPproxyLIST, KhodeJav/telegram-proxy-collector ve tgmtproxy/telegram-mtproto-proxy-list. Paket içindeki anlık görüntü, uç nokta bilgileri, kaynak atıfları ve indirme tarihlerini içerir. Listeler girdi niteliğindedir; hangi proxy'lerin kullanılacağına aşağıdaki bağlantı denetimleri karar verir.

Otomatik MTProxy, Telegram aktarım bağlantısını kontrol eder, çalışan bir proxy'yi korur ve arıza durumunda başka bir proxy'ye geçer. Çalışma alanları, yeterli sayıda çalışan giriş mevcut olduğunda farklı proxy'leri tercih eder; proxy'ler bir çıkış adresini paylaşabilir. Arızalı proxy'ler bir sonraki denemeye kadar beklemeye alınır. Hiçbiri çalışmazsa, IP modu, toplama işleminin beklemesi mi yoksa doğrudan bağlantı kullanması mı gerektiğini belirler. Proxy'lerin değiştirilmesi, hesabı değiştirmez veya günlüğünü silmez. Rota seçimleri ve değişiklikleri, imzalı günlüğe kaydedilir.

Otomatik rotalar etkinken, listeler saat başı yenilenir ve aktarım kontrolleri varsayılan olarak her on dakikada bir çalıştırılır. Bu aralıklar yapılandırılabilir. Genel listeleri güncellemek bir yenileme gerektirir; listeyi yalnızca görüntülemek, kaydedilmiş bir manuel rotayı değiştirmez.

Telegram trafiği ve HTTPS istekleri farklı yollar kullanır. Liste indirmeleri, ayrı bir HTTPS bağlantısı ve sağlanan harici istek yolunu kullanır. TGWITNESS_PROXY_FEED_PROXY, bu yolu bir HTTP/SOCKS5 proxy ile açıkça geçersiz kılar; her iki Compose toplayıcı varyantı da bunu iletir. Arka plan havuzu, ana çalışma alanını takip eder. Feed sağlayıcılara hiçbir Telegram oturumu, API kimlik bilgileri, panel jetonu veya bot jetonu gönderilmez. Sağlayıcı adları, anlık görüntü tarihleri ve indirme yolu, “Listenin kaynağı” bölümünde görünür.

MTProxy, yalnızca Telegram trafiğini taşır. Zaman damgaları, bildirimler, site dışı kopyalar ve kaynak kontrolleri gibi çalışma alanı HTTP işlemleri, yapılandırıldığında ayrı bir SOCKS5/HTTP proxy'si kullanır, ardından hesabın SOCKS5/HTTP rotasını kullanır. Her ikisi de yoksa, "Adresi Gizle" seçeneği isteği reddeder; diğer modlar "Doğrudan" seçeneğine izin verir. Harici istekler devre dışı bırakılabilir. Açıkça yapılandırılmış bir besleme indirme proxy'si, ayrı bir operatör geçersiz kılma seçeneği olarak kalır. Bağımsız tanık hizmeti kendi yolunu korur.

Operatör tarafından yönetilen özel hizmetler için, mevcut sunucu ortamı ayarı TGWITNESS_ALLOW_PRIVATE_DESTINATIONS=1, özel hedefleri izin verir ve proxy tarafında ana bilgisayar adı çözümlemesini korur. Bu ayar panelden etkinleştirilemez. Yalnızca genel mod, genel çözümleyicisine sorgu göndermeden önce .onion hedeflerini reddeder; Tor onion hizmetleri, bu açık özel hedef ayarını ve uygun bir proxy gerektirir. Bu DNS davranışı, Telegram'ın aktarım protokolü için değil, harici HTTP işlemleri için geçerlidir. Cloudflare, JSON DNS uç noktasını belgelemektedir.

Otomatik havuz parametreleri

Diğer araçlar → Parametreler → Otomatik MTProxy altında, hata eşiğini, bekleme süresini, planlı rotasyonu, proxy paylaşımını ve izin verilen yedekleme gecikmesini yapılandırın.

Kontrol Varsayılan
Değiştirilmeden önce bağlantı kesilir 3, 10 dakika içinde
Her bağlantı denemesi için denenmiş proxy'ler 3
İlk / arıza sonrası maksimum dinlenme süresi 10 dakika / 6 saat
Planlanan rotasyon Devre dışı; arıza durumunda etkinleştirin
Proxy başına hesap sayısı 0: ayrı girdileri tercih edin, gerektiğinde birleştirin. 1'i, özel bir girdi gelene kadar bekleyecek şekilde ayarlayın.
İzin verilen doğrudan yedekleme öncesi gecikme süresi 10. dakika; Adres gizleme özelliği hâlâ Direct'i reddediyor
Besleme yenileme / aktarım kontrolleri 60 / 10 dakikaları; ana çalışma alanı değerleri paylaşılan havuz için geçerlidir

Farklı proxy'ler bir çıkış adresini paylaşabilir. Telegram'ın sınırlamaları her rotada geçerlidir.

Genel listeyi kendi operatör kataloğunuzla değiştirmek için aşağıdaki geçersiz kılma ayarını yapılandırın. Bu ayar, proxies dizisi boş olduğunda da dahil olmak üzere harici abonelikleri tamamen devre dışı bırakır.

Boş kataloğu proxy-config/proxies.json adresine kopyalayın ve devreye alınmış genel uç noktalarınızı ekleyin:

{"format": "tgwitness-proxy-catalog-v1", "proxies": [
  {"id": "project-eu", "label": "Project EU",
   "link": "tg://proxy?server=REPLACE_HOST&port=443&secret=REPLACE_SECRET"}
]}

Örnek değerler değiştirilmelidir. En fazla 32 farklı giriş kabul edilir. Kimlik doğrulaması yapılmış liste, paylaşılan gizli anahtarlar olmadan etiketleri/ana bilgisayarları/bağlantı noktalarını döndürür; bir tanesi seçildiğinde kimlik bilgileri çalışma alanı kasasına kaydedilir. Açık bir aktarım testi yapılana kadar kullanılabilirlik test edilmemiştir. Hatalı biçimlendirilmiş bir katalog, manuel yapılandırmaya olanak tanır.

Yerel başlatma: TGWITNESS_PROXY_CATALOG değerini yerel JSON yoluna ayarlayın. Docker:

docker compose -f compose.yaml -f deploy/compose/compose.proxies.yaml up -d --build

Overlay, proxy-config dizinini salt okunur olarak bağlar; dosyalar, 10001 numaralı konteyner UID'si tarafından okunabilir olmalıdır. Bu dizin, Git, Docker derleme bağlamı ve kaynak arşivlerinden hariç tutulur. Bu katalog, veri toplama hesaplarını yapılandırır; tanık botu, MTProxy yerine kendi HTTP/SOCKS5 yolunu kullanır.

Doğrudan yedekleme, yukarıdaki IP moduna tabidir. Rotayı değiştirmeden önce gözlemi duraklatın. Kaydetme işlemi eski istemcilerin bağlantısını keser ve tamamlanmamış oturum açma işlemlerini iptal eder; yeni istemci kaydedilen rotayı kullanır. Hesabın günlük/oturum bağı korunur. Ayarlar önceki rotanın yerini alır: düzenlerken proxy kimlik bilgilerini yeniden girin.

Kimlik bilgileri network.enc ile şifrelenir. API, kullanıcı adını, şifreyi veya gizli anahtarı döndürmez. İmzalı kayıtlar, uç noktayı ve gizli anahtarları hariç tutarak, yol türünü ve kimlik bilgilerinin mevcut olup olmadığını içerir. Operatör, uç noktayı panelden görebilir. Gizli alanlar, çalışma alanları kaydedildikten, kilitlendikten veya değiştirildikten sonra silinir.

Telegram bağlantısını test etme özelliği, oturum açmadan önce de kullanılabilir; bu özellik, rota üzerinden geçici ve yetkisiz bir Telegram bağlantısı açar ve kapatır. IP kontrolü yapan bir web sitesiyle iletişim kurmaz. Başarılı sonuç, grup erişimi, tam teslimat veya anonimlik değil, yalnızca aktarım bağlantısının kurulduğunu gösterir.

Proxy, Telegram DC medya indirmeleri de dahil olmak üzere Telegram istemcisinin bağlantılarına uygulanır. Tarayıcı, pip, SSH ve manuel olarak çalıştırılan TSA araçları için ayrı rotalar mevcuttur. Proxy ana bilgisayar adı yerel olarak çözümlenebilir. rdns, hedef ana bilgisayar adlarını etkiler; Telegram genellikle sayısal DC IP'leri sağlar.

SOCKS5 ve düz HTTP CONNECT, proxy kimlik bilgilerini veya istemci-proxy tünelini kendileri şifrelemez. MTProto, Telegram trafiğini ayrı olarak korur. Güvenilmeyen bir ağda proxy’ye uygun bir güvenli kanal kullanın. Özel gruplar, aktarım sırasında MTProto ile korunan bulut sohbetleridir; uçtan uca Gizli Sohbetler ise Gizli Sohbet modülü tarafından kaydedilen ayrı bir sohbet türüdür.

Şifreleme ve imzalar#

Katman Uygulandı Operatörün sorumluluğu
Telegram trafiği Telethon MTProto Platform güveni, erişim yolu ve kullanılabilirlik
Web paneli Taşıyıcı jetonu, varsayılan geri döngü, istek sınırları Uzaktan erişim için HTTPS veya SSH tüneli
Sırlar API kimlik bilgileri, oturum, proxy kimlik bilgileri ve özel anahtar imzalaması için Fernet Şifre çözme anahtarını ve çalışan sunucuyu koruyun
Kasa anahtarı Yeni bir kurulum için yerel anahtar veya harici ana anahtar Ayrı korumalı depolama alanı ve anahtar yedekleme
Mesajlar ve ekler Düz metin uygulama depolama Şifrelenmiş disk/birim
ZIP/JSONL/CSV/HTML Bütünlük kontrolleri, içerik şifreleme yok Dışa aktarılan kopyaları ve aktarımları koruyun
Kaynak ve zaman İmzalı günlük, işlem makbuzu, RFC 3161 araçları Güvenilir anahtar, bağımsız kontrol noktaları/TSA ve saklama prosedürü

Hesap bölümündeki depolama koruması bu durumları gösterir. Panel jetonu bir erişim gizli anahtarıdır, şifreleme parolası değildir. Yönetici erişimi sağlar; düzenlenen jetonların kapsamı hesaplar ve sohbetlerle sınırlandırılabilir. Çalışma alanları ana süreci paylaşır ve izole edilmiş kiracılar değildir.

BitLocker, LUKS, FileVault veya yönetilen şifreli bir birim, kendi tehdit modelleri kapsamında depolama alanını koruyabilir. Kilidi açılmış ve çalışır durumdaki bir makinenin yöneticisi yine de verileri okuyabilir. Depolama planlamasına SQLite WAL/SHM, medya, geçici dışa aktarımlar, takas alanı, yedeklemeler ve tarayıcı indirmelerini dahil edin. Bir Docker birimi, sırf birim olduğu için şifrelenmez.

Harici ana anahtar#

Yeni bir kurulum için, ana anahtarı veri dizininin dışına yerleştirin. Bu işlem, mevcut bir yerel anahtar kasasını otomatik olarak taşırmaz. Yalnızca hizmet kimliğinin erişebileceği bir anahtar dizini hazırlayın, ardından şunu çalıştırın:

python -m tgwitness.security create-master-key /private/keys/tgwitness-master.key
export TGWITNESS_VAULT_KEY_FILE=/private/keys/tgwitness-master.key
python -m tgwitness --data-dir /private/observations/new-case

PowerShell, kurulu proje ortamını kullanarak:

python -m tgwitness.security create-master-key E:\PrivateKeys\tgwitness-master.key
$env:TGWITNESS_VAULT_KEY_FILE = 'E:\PrivateKeys\tgwitness-master.key'
python -m tgwitness --data-dir E:\PrivateData\new-case

Docker'da, dosyayı /data dışında, örneğin /run/secrets/tgwitness-master.key konumunda salt okunur olarak bağlayın ve ortam değişkenini bu yola ayarlayın. Hizmet UID'sinin dosyayı okuyabilmesi gerekir. Anahtar baytlarını değil, yolu ortam/yapılandırma dosyaları aracılığıyla aktarın.

Her çalışma alanı, rastgele bir genel tuz değeri ve HKDF-SHA256 aracılığıyla türetilen kendine ait bir Fernet anahtarı alır. vault.external.json, ana anahtarı değil, türetme meta verilerini depolar. Anahtarın eksik veya yanlış olması durumunda, sistem sessizce anahtarı değiştirmeden başlatma işlemi başarısız olur. Kurtarma amacıyla hem tuz meta verilerini hem de ana anahtarı saklayın.

Tüm çalışma alanları aynı ana anahtardan türetilir; bu anahtarın güvenliğinin ihlali tüm kurulumu etkiler. Çalışan işlem, gizli bilgileri şifresini çözebilir. Bu bir HSM veya parola KDF değildir. Rastgele bir anahtarın yerine keyfi insan parolaları kabul edilmez.

Kasıtlı bir geçiş gerçekleştirilip doğrulanana kadar mevcut kurulumlar için mevcut anahtarı kullanmaya devam edin. vault.key'yi silmek veya ana anahtarı değiştirmek, oturumlara/imza anahtarlarına erişimi engelleyebilir. Şifrelenmiş yedekleri ve anahtarları ayrı tutun ve kurtarma işlemini izole bir ortamda test edin.