# 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)

התקן באמצעות פקודה אחת או בצע לכידה ב-GitHub Actions. הבן את אפשרויות החקירה, את היקף הפרסום ואת מה שהארכיון מאמת.

TgWitness הוא כלי יצוא וסביבת עבודה לחקירות ב-Telegram בקוד פתוח. התקן אותו בפקודה אחת, חבר חשבון, בחר את הצ'אטים וייצא ארכיון חתום. הוא תומך גם באיסוף זמני ב-GitHub Actions ובהמשך חקירות באמצעות עריכות שמורות, תצפיות מחיקה, חיפוש ודוחות.

## התחל עם המשימה שבידך

| המשימה שלך | המסלול הקצר ביותר | מה תקבלו |
| --- | --- | --- |
| שמור שיחה או חשבון | התקן, חבר חשבון, בחר את היקף הייצוא | ארכיון חתום הכולל את ההיסטוריה הנבחרת, תוצאות האיסוף וחומר האימות |
| יש לאסוף את הנתונים על רץ זמני | יש להשתמש ב-GitHub Actions כדי לבצע לכידה, לאשר הפעלה חדשה ולבחור את ההיקף | ארכיון מוצפן עם מקור זרימת העבודה ב-GitHub |
| עקבו אחר השינויים לאורך זמן | יש להמשיך את התצפית בצ'אטים שנבחרו | גרסאות שמורות, הודעות מחיקה, קבצים מצורפים וכיסוי מתועד |
| חקרו ושתפו את הממצאים | חפשו בארכיון, השתמשו בלוח המקרים (Case Board) והגדירו דוח או עותק לשיתוף | ממצאים המקושרים למקורות והעברה הניתנת לאימות המתאימה למקבל |

### התקנה בפקודה אחת

מתקין התוכנה כולל את Python ותלויות. הורדת קוד המקור, Docker, ספק בינה מלאכותית ועד עצמאי הם אפשרויות בחירה, ולא תנאים מוקדמים להתקנה.

Linux / macOS:

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

ב-Windows, ב-PowerShell או בשורת הפקודה:

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

פתחו את הלוח, חברו את חשבון ה-Telegram שלכם ובחרו את היקף האיסוף. ההתקנה אינה מתחילה את האיסוף מעצמה. מדריך ההתקנה  מסביר על גישה מקומית, שרתים, עדכונים ובדיקת הגרסה שהורדה.

לצורך הפעלה זמנית, עקבו אחר [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). זרימת העבודה הזו דורשת פורק ב-GitHub, אישור וסיסמת ארכיון. דף ה-capture מסביר את השלבים הללו ואת משך הזמן המוקצב להפעלה לפני ההרצה. הורידו ושמרו את הארכיון שהתקבל ואת חומר האימות שלו.

## הגדרות נוספות כאשר המשימה דורשת זאת

ייצוא של צ'אט בודד מצריך חשבון והיקף נבחר. תצפית מתמשכת, חשבונות מרובים, פרוקסי, מדיניות קבצים מצורפים, עיצוב דוחות, גישה לבוחנים, חותמות זמן חיצוניות ואחסון מחוץ לאתר משרתים דרישות חקירה ו העברה שונות. יש להגדיר תכונות אלה כאשר הן רלוונטיות.

היקף, הרשאות ועותקי שיתוף מצומצמים מסייעים למפעילים לבחור מה לאסוף ולחשוף. הנחיות בנושא סמכות שיפוט והגדרות דוחות תומכות בהחלטה זו; בחירת פרופיל כשלעצמה אינה מבטיחה עמידה בדרישות החוק או קבילות. ראו [ייצוא חשבון](https://phishdestroy.github.io/TgWitness/he/docs/reference/account-export/), [גישה](https://phishdestroy.github.io/TgWitness/he/docs/reference/access/) ו- [תצורת דוח](https://phishdestroy.github.io/TgWitness/he/docs/reference/case-reports/).

היישום פועל על המחשב או השרת הנבחר. איסוף בסיסי אינו מצריך מעבד גרפי (GPU) או מודל שפה גדול (LLM). ל-OCR, תמלול וניתוח בינה מלאכותית אופציונליים יש דרישות משאבים משלהם. יש להתאים את הפריסה לקצב ההודעות, לקבצים המצורפים, להיסטוריית ההודעות הנשמרת ולמספר החשבונות המקבילים; התקנה קלה אינה מבטיחה צריכת זיכרון קבועה עבור כל עומס עבודה.

## יש לשמור על התיעוד, למי שזה לא יהיה מועיל

המטרה היא לשמר את החומר שנצפה, את ההקשר ואת השינויים, ללא תלות במי שעמדתו הם תומכים. הראיות עשויות לערער על התיאור של האספן עצמו לגבי האירועים. יש לשמור על זיהוי תצפיות המקור, כיסוי חסר ומסקנות אנליטיות , כך שאדם אחר יוכל להעריך את אותו החומר.

הלוגיקה היא: תצפית הנראית בחשבון → יומן חתום → ייצוא → אימות המקבל. עריכות שנשמרו מוסיפות גרסאות. תצפיות שנמחקו שומרות על התוכן שנלכד בעבר. רשומות כיסוי חושפות הפרעות ידועות. דוחות וניתוחי בינה מלאכותית מתייחסים למקורות שנשמרו; פרשנות אינה הופכת לתצפית מקורית רק משום שהיא מופיעה בדוח חתום.

| בדיקת אימות | מה יכול הנמען לקבוע |
| --- | --- |
| חשישי קבצים, חתימות ושרשרת יומנים | הרשומות והקבצים שסופקו תואמים למפתח הצפוי ולגבולות היומן |
| נקודת ביקורת או עד שנשמרו בנפרד | הארכיון תואם למצב יומן שנשמר בעבר |
| חותמת זמן חיצונית מאומתת | הבייטים המוזכרים היו קיימים לפי חותמת הזמן, בהתאם להנחות האמון המוצהרות |
| אישור לכידת GitHub | הארכיון תואם את זרימת העבודה המאושרת, גרסת האספן ותמצית הנתונים המתועדת |

בדיקות אלה תומכות בבדיקת תקינות ומקור. הן אינן הופכות את תוכן ההודעה לאמירה נכונה ואינן משחזרות הודעות שנמחקו ולא נראו מעולם. יש להשתמש בטביעת אצבע של מפתח שהושגה באופן עצמאי ובשלבי האימות המופיעים ב-[מדריך האמון](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) וב-[פורמט הראיות](https://phishdestroy.github.io/TgWitness/he/docs/reference/evidence/).

## היקף פרסום וביצועים שנמדדו

התוצאות הבאות מתארות עומסי עבודה ותאריכים שונים. המספרים אינם ניתנים להחלפה: אירוע ביומן אינו בהכרח הודעת Telegram ייחודית.

| תאריך | נפח העבודה | תוצאה שפורסמה | מה נמדד |
| --- | --- | --- | --- |
| 1 בנובמבר 2026 | שרת פועל, עשר מסדי נתונים של סביבות עבודה | רשומות יומן 1,610,818; אירועי הודעות חדשות 900,232, אירועי עריכה 80,683 ואירועי מחיקה 400,536 | מלאי לקריאה בלבד; לא מדובר במבחן תפוקה או באימות חדש של השרשרת כולה |
| 5 בנובמבר 2026 | חיפוש ב-1,000,000 הודעות סינתטיות בצ'אטים מסוג 200 | האינדקס נבנה תוך 71 שניות; זמן החיפוש החציוני לכל שאילתה הוא 9–190 מילי-שניות | מדד ביצועים לחיפוש מקומי; לא משלוח Telegram בזמן אמת |
| 6 בנובמבר 2026 | שתי ייצואות טלגרם אמיתיות ועדכניות | הודעות 27,030 ו-29,299; 56,329 בשני מחזורי הבדיקה | שני חשבונות בכל ריצה דרך WARP, טקסט ומטא-נתונים, ללא הורדת קבצים מצורפים |
| 6 בנובמבר 2026 | אותן שתי ייצואות, כולל הכנה ואריזה | 127.713 ו-141.781 הודעות בשנייה | נמדדו שיעורי הייצוא המלאים; שני הארכיונים אומתו מול מפתחות מוצמדים |

הרשומה [verification](https://phishdestroy.github.io/TgWitness/he/docs/reference/verification/) מציגה את מלאי השרת, בדיקות איסוף בזמן אמת ומדידות חיפוש. [Export performance](https://phishdestroy.github.io/TgWitness/docs/validation/) מפרסמת את שני הריצות בפועל, החומרה, משכי הזמן, חתימות הארכיון וקבצי המדידה החתומים. הן קובעות תוצאות עבור הגרסאות והתנאים שנרשמו, ולא קצב או תקרת קיבולת אוניברסליים.

### היסטוריית הבדיקות ומשך הזמן

המנהל מדווח על יותר משישה חודשי בדיקה נכון ל-6 בנובמבר 2026. זה מתאר את היסטוריית הבדיקות של הפרויקט. המדידות הציבוריות המתוארכות לעיל מתעדות ריצות בודדות; הן אינן מהוות ריצת איסוף של שישה חודשים רצופה שנבדקה באופן עצמאי. גיל ההודעות שיוצאו שונה גם הוא מהזמן שבו האספן פועל.

## קרא את מצב היכולת במדויק

יש להעריך כל זרימת עבודה ביחס ליישומה, לגרסה שפורסמה ולבדיקות שהוקלטו. המקור מסומן כרגע כ"תצוגה מקדימה". תווית שחרור זו מתקיימת במקביל לאוסף פעיל, ייצוא, אימות עצמאי ומדידות קנה מידה שפורסמו. תכונה בתצוגה מקדימה וזרימת עבודה מאומתת יכולות להתקיים באותה יישום; יש לתאר את התכונה הספציפית ואת הראיות העומדות בבסיס ההערכה.

השתמשו [יכולות נוכחיות](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [תכונות ומגבלות](https://phishdestroy.github.io/TgWitness/he/docs/reference/features/), [אימות](https://phishdestroy.github.io/TgWitness/he/docs/reference/verification/) ו- [יומן השינויים](https://phishdestroy.github.io/TgWitness/he/docs/reference/changelog/) יחד. רשמו את הגרסה שנבדקה בעת ציטוט תוצאה. ה- 6 תמונת המצב של המדידה מ-נובמבר שומרת גם את הבדיקות שנכשלו או שהוחמצו; אלה אינן בדיקות שעברו בהצלחה.

## קריא על ידי בני אדם וכלי בינה מלאכותית

האתר מספק מסמך תמצית ב-`llms.txt`, מדריך מלא באנגלית ב- `llms-full.txt` וב-`llms-full.md`, וכן גרסאות Markdown של דפיו. אלה הם פורמטים של תיעוד, ולא דרישה של ה-AI להפעלת TgWitness.

גישה אופציונלית לשורת הפקודה [MCP](https://phishdestroy.github.io/TgWitness/he/docs/reference/mcp/) ו- מאפשרת לכלים מורשים לקרוא רשומות נבחרות שנשמרו. תוכן ההודעות נותר קלט שאינו מהימן. בסיכומים יש לציין מקורות, להבחין בין עובדות שנצפו למסקנות ולשמור על אי-ודאות. חיפוש בטקסט מלא, זיהוי תווים אופטי (OCR) ותפוקת בינה מלאכותית (AI) אינם משנים את התצפיות המקוריות החתומות.