TgWitness / תיעוד

מה נבדק ←

הפניה / הגדרה

Telegram · התחלה מהירה

כל הדרכים להתקנה והפעלה של TgWitness: חבילת Windows, Python, Docker והדגמה סינתטית, כולל בדיקות ראשוניות.

TgWitness / תיעוד

התחלת עבודה

אנגלית · Русский · אוקראינית · Español · פורטוגזית (ברזיל) · Türkçe · العربية · فارسی · אורדו · हिन्दी · באסהה אינדונזיה · Tiếng Việt · סינית פשוטה

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

ביקור ראשון? התנסו בהדגמה לפני שתחברו חשבון. בחרו מדריך לפרוקסי, עדים, ייצוא או הגדרת שרת. GitHub Actions capture (תצוגה מקדימה) מריץ לכידה ב- GitHub fork משלכם במקום בהתקנה מקומית.

התקנה והפעלה#

מתקין מונחה כולל ספריית Python משלו ובודק את חתימות החבילות והחתימות של הגרסה לפני ההתקנה. הפעלה חוזרת שלו מעדכנת התקנה קיימת.

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"

בשרת אובונטו, הפעל כמשתמש root כדי להתקין שירות ברקע; במחשב שולחני, הפעל כמשתמש רגיל. באובונטו, תוכנית ההתקנה מדפיסה את כתובת הלוח ומפתח הגישה; ב-macOS וב-Windows, הלוח המקומי נפתח בדפדפן שלך. המשך ב"חיבור ל-Telegram" להלן. "התקנה, אימות ועדכון" מכסה את אפשרויות הגישה לשרת, בדיקת הסקריפט לפני הפעלתו, עדכונים והסרה.

שיטות אחרות#

מהדורות GitHub, הקוד המקור ו-Docker מהווים חלופות למתקין. הורדות ניידות הופכות לזמינות לאחר פרסום גרסת המהדורה:

מארח אין צורך בהתקנה מהמקור: Python 3.11+ Docker: Engine/Desktop עם Compose 2.20+
Windows חלץ את TgWitness-<version>-windows-amd64-portable.zip מ-GitHub Releases, לחץ פעמיים על TgWitness.cmd לחץ פעמיים על Start.cmd לחץ פעמיים על scripts\Docker.cmd
Linux / macOS — sh start.sh sh scripts/docker-start.sh

לשיטות ההרצה מקוד המקור, הורידו וחלצו את ענף ה-main הנוכחי או שכפלו (clone) את המאגר:

git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness

הקובץ Start.cmd מציע להתקין את Python 3.12 עבור משתמש ה-Windows שלכם אם לא נמצאה התקנת Python מתאימה (באמצעות winget, או תוכנית ההתקנה החתומה מ-python.org). הקובץ start.sh מדפיס את פקודת ההתקנה המדויקת עבור הפצת ה-Linux או ה-macOS שלכם אם Python חסר. ההפעלה הראשונה מקוד המקור יוצרת סביבת .venv ומתקינה את התלויות באופן אוטומטי.

Docker בונה את היישום ומפעיל אותו ברקע; אין צורך ב-Python במחשב המארח. הפקודות scripts\Docker.cmd ו-scripts/docker-start.sh מדפיסות את כתובת הפאנל ואת האסימון כאשר הקונטיינר פועל כראוי. פקודות ה-Docker המקבילות בכל מחשב מארח נתמך הן:

docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt

פתחו את http://127.0.0.1:8787. השתמשו באסימון שהודפס על ידי עוזר ה-Docker או בפקודת ה-Docker השנייה, או קראו את הקובץ data/live/panel-token.txt להתקנה ניידת או מהמקור. המשיכו ב" חבר את Telegram" להלן. התקנות מקוריות והתקנות Docker משתמשות באחסון נפרד; הפעלת Docker אינה מייבאת יומן מקורי קיים.

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

גלו את הממשק#

  1. הפעל את הקובץ TgWitness-Demo.cmd בחבילה הניידת, את הקובץ scripts\Demo.cmd בתיקיית המקור של Windows, או את הפקודה sh start.sh --demo ב-Linux/macOS. הפעלה מהמקור יוצרת תחילה את הקובץ .venv ומתקינה את התלויות.
  2. http://127.0.0.1:8787 פתוח.
  3. הדגמה המקומית פותחת את יומן הדוגמה באופן אוטומטי. אין צורך בהעתקת אסימון (token) לצורך גישה מקומית ישירה.

ההודעות בהדגמה הן פיקטיביות. מצב ההדגמה אינו מאפשר חיבור לחשבון Telegram אמיתי.

התחבר ל-Telegram#

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

  1. אם ההדגמה המקורית פועלת, עצרו אותה והפעילו את Start.cmd או sh start.sh. אחרת, המשיכו להפעיל את ההתקנה החיה שהושקה לעיל.
  2. השתמש באסימון הלוח כדי להתחבר. סביבת עבודה חדשה נפתחת בהגדרה הראשונית. בחר 'רק הורדה', 'עקוב אחר צ'אטים' או 'ראיות' עבור תיק.
  3. בדקו את בדיקת החיבור. קבעו תצורה לפרוקסי משלכם במידת הצורך; הגדרות החיבור נשארות זמינות לאחר ההתקנה.
  4. ב-Connect Telegram, בחרו מספר טלפון, קוד QR, קבצי חשבון (TData, .session, StringSession, JSON של החשבון) או מפתח אישור מלא. השלם את אישור Telegram, את הקוד ואת הסיסמה הדו-שלבית כאשר תתבקש לכך.
  5. בדקו את החשבון המוצג, בחרו את הצ'אטים ובדקו את ההגדרות שלכם. סיימו מהמסך האחרון. עבור רק הורדה, האפשרות התחל ייצוא מפעילה ייצוא חד-פעמי ופותחת את ייצואים כדי להציג את התקדמותו; היא אינה מאפשרת תצפית רציפה.

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

מזהה API + Hash הוא אופציונלי: סביבת העבודה משתמשת בזוג השמור או המיובא שלה, או בזוג פעיל מהמאגר המובנה. כדי להשתמש באפליקציה משלך, הדבק זוג אחד API ID:API Hash בשדה מזהה API. עבור מפתח אימות, הדבק את כל 512 התווים ההקסדצימליים ובחר את מזהה DC שסופק. מזהה המשתמש הוא אופציונלי ונבדק אם הוזן.

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

לגבי חשבונות קיימים, ראו פורמטים של חשבונות ושל הפעלות: הלוח תומך ב-Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP לחשבון בודד, ובקובצי JSON של חשבונות נתמכים. בחרו הפעלה ואת קובץ ה-JSON הנלווה אליה יחד, לחצו על בדוק קבצים ולאחר מכן על חבר חשבון. כניסה באמצעות QR זמינה גם היא עם אותן הגדרות API אופציונליות. TDLib, הפעלות בוטים ורשימות חשבונות בפורמט CSV/JSON אינן נתמכות.

עבור מספר חשבונות, השתמשו ב-חשבונות → ייבוא חשבונות ובחרו את קובצי הסשן הנתמכים שלהם. קובצי JSON נלווים משויכים לפי שם הקובץ הבסיסי (basename); כל חשבון מיובא מקבל סביבת עבודה משלו. עיינו בייבוא מרוכז וקבוצות חשבונות.

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

אסימון הפאנל החי מגן על הגישה לאישורי ה-Telegram ולחומר השמור שלכם; הוא נפרד מפרטי הזיהוי של ה-API של Telegram. רק הדגמה מקומית שהופעלה במפורש, והגישה אליה היא ישירה, זוכה לרישום אוטומטי. הדגמה מרחוק או באמצעות פרוקסי עדיין משתמשת ב- data/demo/panel-token.txt.

סקירה וייצוא#

  • יומן: חיפוש וסינון תצפיות לפי מקור וסוג אירוע.
  • בחר אירוע כדי לבחון את התיעוד המקורי שלו, את מקורו ואת הגרסאות השמורות.
  • פרטי העריכה מציגים את התוכן הזמין לפני ואחרי העריכה. פרטי המחיקה מציגים את התוכן האחרון שנלכד, אם קיים; גורם לא ידוע נותר לא ידוע.
  • ייצוא: ZIP חתום, JSONL, CSV ו-HTML לא מקוון.
  • ייצוא צ'אט מלא (צ'אטים → ייצוא צ'אט, או ייצוא → לכידה או ייצוא של צ'אט אחד): הורדת כל ההיסטוריה הגלויה של צ'אט אחד כחבילה חתומה עם chat.json (בסגנון ייצוא טלגרם) ו- chat.html קריא. צ'אטים פרטיים פועלים כאשר החשבון הוא חבר. זוהי תמונת מצב עדכנית, ולא שחזור של הודעות שנמחקו או נערכו בעבר. אמתו עותק באמצעות python verify.py chat-export.zip --fingerprint TRUSTED_SHA256.
  • נקודת ביקורת: יש לשמור על גבולות היומן החתום מחוץ לאספן.
  • הורדת קבלה חתומה על הפעלה: שמירת תיעוד התוכנית/הגרסה של האספן.
  • הכנת בקשה לחותמת זמן: הכן בקשה לא מקוונת לרשות חותמת זמן; פעל לפי ההוראות ב-TIMESTAMP.md כדי לקבל את התשובה ולאמת אותה.
  • אימות היומן: בדקו את חתימות האירועים וקישורי השרשרת. ייצוא בפורמט ZIP בודק גם קבצי מדיה.

דפדפנים נתמכים שומרים ייצוא בנפח גדול ישירות לקובץ נבחר. דפדפנים אחרים מאחסנים במאגר זמני לכל היותר 128 MiB. בזמן שהשרת פועל, ממשק ה-CLI הזורם תומך בהורדות גדולות יותר ללא אחסון כל התגובה במאגר הזמני:

python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip

לסביבת עבודה אחרת, הוסף --profile ID באמצעות 'ייצוא' → 'מזהה סביבת עבודה'. לשרת מרוחק, הוסף --url https://your-server. מגבלת ההעברה המוגדרת כברירת מחדל היא 5 GiB; --max-mib משנה אותה. לתוכן ZIP חתום יש מגבלת אימות נפרדת של 4 GiB ללא דחיסה כברירת מחדל (More tools → Parameters מעלה אותה; אמת ארכיונים כאלה באמצעות verify.py --max-gib N). אמת את הארכיון באמצעות עותק מהימן של תוכנת האימות, טביעת אצבע של מפתח שנשמרה באופן עצמאי, ולצורך ראיות מינימליות, תעודת השורש של רשות חותמת הזמן (--tsa-ca).

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

python start.py --setup-only
python start.py --check
python start.py --check --json

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

תוכנת ההפעלה מותקנת ב-.venv. פקודות עזר של python -m tgwitness... חייבות להשתמש ב-.venv\Scripts\python.exe ב-Windows או ב-.venv/bin/python ב-Linux/macOS, אלא אם כן סביבה זו כבר מופעלת.

פעילויות, הגנה ותפעול#

ניתן להמיר באופן מקומי .session סגור ועקבי של Telethon SQLite באמצעות python -m tgwitness.sessions account.session --out account.tgwitness-session, ולאחר מכן לטעון אותו ב"כלים נוספים" → "חשבון" → "קבצים". ייבוא קבצים ישיר וכניסה באמצעות QR זמינים גם הם. ראו CONNECTION-SECURITY.md לקבלת פורמטי כניסה, SOCKS5, HTTP CONNECT, MTProxy ומפתחות ראשיים חיצוניים.

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

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

קראו את הקובץ OPERATIONS.md בנושא גיבוי/שחזור, את הקובץ DEPLOYMENT.md בנושא אירוח, ואת deploy/ לדוגמאות לשימוש בשירות. הלוח המותקן כולל גם מדריך התקנה במצב לא מקוון בכתובת /guide.html.

האימות בפועל והמגבלות הקיימות מתועדים בקבצים VERIFICATION.md ו-READINESS.md.