TgWitness / תיעוד

מה נבדק ←

הפניה / הגדרה

Telegram · פריסה

הפעל את TgWitness כשירות ב-Windows, Linux, macOS או Docker, מאחורי HTTPS, עם גיבויים ועדכונים.

TgWitness / תיעוד

פריסה ושחזור

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

בחר התקנה#

עבור החבילה הניידת, חלצו את הקובץ TgWitness-<version>-windows-amd64-portable.zip מ- GitHub Releases. עבור השיטות האחרות, הורידו וחילצו את קובץ ה-ZIP של הקוד המקור או שיבטו את המאגר, ולאחר מכן הריצו את הפקודה הבאה מתוך ספריית הפרויקט:

התקנה התחל פועל ברקע?
חבילת תוכנה ניידת ל-Windows TgWitness.cmd לא; השאר את החלון פתוח.
יליד Windows Start.cmd לא; השתמש במשימת הכניסה האופציונלית לשימוש ברקע.
תואם באופן מובנה ל-Linux/macOS sh start.sh לא; יש להשתמש ב-systemd/launchd להפעלה ברקע.
Docker על כל מארח נתמך docker compose up -d --build --wait כן, כל עוד הדמון של Docker פועל.
עוזר Docker ב-Windows scripts\Docker.cmd כן; התוכנה ממתינה לבדיקת תקינות שרת האינטרנט.
עוזר Docker ב-Linux/macOS sh scripts/docker-start.sh כן; התוכנה ממתינה לבדיקת תקינות שרת האינטרנט.

לגבי שרת ענן שצד שלישי אמור להיות מסוגל לבדוק — שנוצר באמצעות ה-API של הספק, ללא SSH, ונגיש רק דרך Cloudflare Tunnel — ראו פריסה ברמת אבטחה גבוהה.

הפעלה מקורית יוצרת קובץ .venv פרטי ומתקינה את התלויות המוצמדות. Docker בונה אותן בתוך התמונה, ללא צורך ב-Python במארח. ההתקנה הראשונית דורשת גישה לאינטרנט. כאשר לא נמצא Python 3.11 ומעלה, ה-Start.cmd מבקש אישור לפני התקנת Python 3.12 עבור המשתמש הנוכחי ב-Windows (באמצעות winget, או לחלופין באמצעות מתקין python.org לאחר בדיקת החתימה של Python Software Foundation); הוא לעולם אינו מבקש הרשאות מנהל. Docker ושירותי מערכת ההפעלה נותרים תנאים מוקדמים.

התקנות מקוריות וניידות משתמשות ב-data/live בתוך התיקייה שלהן. Docker משתמש בנפח בשם tgwitness-data ב-/data. אלה הן התקנות נפרדות עד שתעביר בכוונה את ספריית הנתונים המלאה. אל תצפה שמכולה חדשה של Docker תזהה חשבונות מקוריים באופן אוטומטי.

דרישות התקנה#

התקנה מקומית דורשת Python 3.11 או גרסה מאוחרת יותר עם venv ו-ensurepip, גישה לאינטרנט להתקנת התלות הראשונה, וספריית פרויקט הניתנת לכתיבה עבור .venv. הפאנל המצורף אינו דורש Node.js או בניית ממשק משתמש. הפעל את תוכנת ההפעלה מחשבון מערכת ההפעלה הרגיל שלך; TgWitness אינו דורש הרשאות מנהל/root.

  • Windows: Start.cmd בודק את py -3, לאחר מכן את python, ולאחר מכן את תיקיות ההתקנה המוגדרות כברירת מחדל לכל משתמש ו- "Program Files", ודורש גרסה 3.11 או מאוחרת יותר. אם אף אחת מהן לא עובדת, הוא מציע את ההתקנה האוטומטית לכל משתמש שתוארה לעיל. py -3 start.py גם עובד. החבילה הניידת אינה דורשת Python כלל.
  • לינוקס: start.sh מנסה את python3.13, python3.12, python3.11, python3 ו- python, ומדפיס את פקודת ההתקנה עבור apt, dnf, pacman, zypper, apk או Homebrew כאשר אף אחת מהן אינה מתאימה. התקנות של Debian/Ubuntu עשויות לדרוש את חבילת python3-venv המתאימה למתורגמן הנבחר. גרסת Python המוגדרת כברירת מחדל הישנה יותר בהפצה חייבת להיות מוחלפת או משלימה ב-Python 3.11+.
  • macOS: התקן הפצה עדכנית של Python 3.11 ומעלה; אל תניח שהמתורגמן המסופק על ידי מערכת ההפעלה עומד בדרישות. השתמש ב-python3 start.py מתוך ספריית הפרויקט.
  • Docker: יש להשתמש ב-Docker Engine/Desktop עם Compose v2.20 או גרסה חדשה יותר. Docker Desktop חייב להשתמש במכולות לינוקס ב-Windows. המכולה מתקינה את תלותי ה-Python שלה; המארח אינו זקוק להתקנה נפרדת של Python.

מחשב מקומי#

השתמש ב-Start.cmd ב-Windows או ב-sh start.sh ב-Linux/macOS. scripts\Setup.cmd או sh start.sh --setup-only מכינים את הסביבה. תוכנת ההפעלה מתקינה את התלויות הנדרשות בשימוש הראשון; בהפעלות הבאות היא עושה שימוש חוזר בסביבה. נדרשת גישה לאינטרנט לצורך ההתקנה ואיסוף הנתונים מ-Telegram, אך עיון ברשומות קיימות ויצירת ייצוא פועלים במצב לא מקוון.

הפעל את python start.py --check לאחר ההתקנה כדי לבדוק תלות מקומיות, Ed25519, אחסון, תצורת מפתחות וכתובת ההאזנה מבלי להפעיל את האספן. השתמשו ב---json לקבלת פלט מובנה. העבירו את הפקודות המיועדות --data-dir, --host ו- --port. הבדיקה אינה מתקינה חבילות, אינה יוצרת יומן ואינה מתחברת ל-Telegram; היא אינה מהווה אימות של תקינות או כיסוי. בעת ההפעלה מתבצעת אימות נפרד של יומנים קיימים. גם python start.py --help נמנע מהתקנה.

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

python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787

משתני סביבה: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE בוחר במצב מפתח חיצוני להתקנה חדשה; ראו מפתח ראשי חיצוני. TGWITNESS_TOKEN, אם צוין, חייב להכיל לפחות 24 תווים; יש להשתמש בערך אקראי קריפטוגרפי. ללא ערך זה, האפליקציה מייצרת אסימון אקראי בן 256 סיביות בקובץ panel-token.txt. הגדרת הסביבה אינה כותבת מחדש את הקובץ הזה. יש להפעיל מחדש כדי להחליף את פרטי ההזדהות.

רק תהליך אחד בדיוק יכול להיות הבעלים של ספריית נתונים. נעילת קבצים חוצת-פלטפורמות של מערכת ההפעלה מונעת כתיבה מקבילה בשוגג. השתמש בעובד Uvicorn אחד. הלוח יכול לנהל מספר בלתי מוגבל של סביבות עבודה, עם ספריות סביבת עבודה נוספות תחת profiles/<id>/. עבור מופעי שירות נפרדים, יש להשתמש בספריות ויציאות נפרדות. קבצי WAL של SQLite צריכים להיות מאוחסנים באחסון מקומי קבוע, ולא במערכת קבצים ברשת. אין לשתף אמצעי אחסון אחד בין עותקים.

חבילת תוכנה ניידת ל-Windows#

כל גרסה ב-GitHub כוללת את TgWitness-<version>-windows-amd64-portable.zip ואת .sha256. היא מכילה את סביבת ההרצה הרשמית של Python 3.12 הניתנת להטמעה מ-python.org (סכום הבדיקה מוצמד ב-tools/build_portable.py), את TgWitness ואת התלויות המוצמדות שלו, ושלושה משגרים:

קובץ מטרה
TgWitness.cmd הפעל את הפאנל; אפשרויות נוספות מועברות, לדוגמה: TgWitness.cmd --port 8790
TgWitness-Demo.cmd הפעל את ההדגמה הסינתטית ב-data\demo
TgWitness-Check.cmd הפעל את בדיקת המוכנות מבלי להפעיל את התוכנה

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

חלץ את הארכיון כולו לתיקייה הניתנת לכתיבה, כגון Documents\TgWitness; אל תפעיל אותו מתוך קובץ ה-ZIP או מתוך תיקיית Program Files. סביבת ההרצה משתמשת בנתיב מודול מבודד, כך שהתקנות Python אחרות ו-PYTHONPATH אינן משפיעות עליה. הנתונים נשמרים בתיקיית data של החבילה. כדי לעדכן, עצרו את TgWitness, חלצו את הגרסה החדשה לתיקייה חדשה והעתיקו את תיקיית data אליה.

הקימו אותו בעצמכם ב-Windows 64 סיביות עם Python 3.12:

python tools/build_portable.py

קונטיינר#

docker compose up -d --build --wait

פעולה זו יוצרת אמצעי אחסון קבוע בעל שם עבור /data. יציאת האינטרנט ממופה ל-127.0.0.1:8787. התהליך פועל תחת UID 10001 עם יכולות מוגבלות, מערכת קבצים שורשית לקריאה בלבד, ו- /data ו- /tmp הניתנים לכתיבה. --wait בודק את תקינות שרת האינטרנט לפני החזרה; אימות טלגרם ו משלוח מופיעים בלוח הבקרה. העוזרים המסופקים משתמשים בזמן המתנה של 180 שניות לאחר הבנייה. הורדות התלות הראשוניות עשויות לארוך זמן רב יותר מכך.

שני קבצי ה-Compose הבסיסיים משתמשים בשם הפרויקט tgwitness, ולכן חילוץ גרסה חדשה לספרייה אחרת אינו בוחר באופן אוטומטי נפח נתונים חדש. שמרו על פריסה אחת בלבד פעילה עבור פרויקט זה. עבור התקנות עצמאיות, השתמשו ב- docker compose -p NAME ... ייחודי וביציאת מארח שונה, ושמרו על שניהם בעת עדכונים. עבור פריסה ישנה יותר המשתמשת בשם פרויקט שונה, המשיכו להשתמש בשמה המקורי יחד עם -p; docker compose ls מציג רשימה של פרויקטים קיימים.

העתיקו את deploy/env.example ל-.env ושנו את TGWITNESS_PORT כדי להשתמש ביציאת לולבק שונה. לדוגמה, TGWITNESS_PORT=8788 חושף את הלוח ב- http://127.0.0.1:8788; הקונטיינר עדיין מאזין על 8787. .env מתעלם מ-Git.

אחזור האסימון הראשוני:

docker compose exec tgwitness cat /data/panel-token.txt

פקודות שימושיות:

docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait

restart: unless-stopped מפעיל מחדש את האספן לאחר קריסה או הפעלה מחדש של הדמון של Docker . בשרת לינוקס, הפעל את Docker בעת האתחול באמצעות מנהל השירותים של ההפצה שלך , בדרך כלל sudo systemctl enable --now docker. ב-Windows/macOS, הפעל את ההגדרה "התחל בעת כניסה" ב-Docker Desktop. יציאה מהמחשב, מצב שינה או עצירה של של Docker עלולים להפריע לאיסוף. מכולה שהופסקה במפורש תישאר מופסקת עד שתפעיל אותה שוב.

נפח /tmp מוגבל ל-512 MiB בתצורה המוצגת בדוגמה. תהליך הייצוא משתמש במקום זאת בתיקיית `temporary-exports/` של כל סביבת עבודה, הנמצאת במחיצה הקבועה /data. יש להקצות שם שטח לייצוא בו-זמני, לצמיחת יומן/WAL, למדיה ולגיבויים. תוכנת ההפעלה משתמשת בקובץ `deploy/constraints.txt` כדי לקבע גרסאות תלויות ריצה עומדות בדרישות. Docker ושרתים בעלי אבטחה גבוהה מתקינים מתוך deploy/requirements.lock ו- deploy/build.lock באמצעות pip --require-hashes: כל קובץ חבילה חייב להתאים ל-SHA-256 שנרשם ב-commit, ולכן קובץ שהוחלף ב-PyPI או במראה נדחה. חבילות שמסופקות רק כקוד מקור (jieba, pyaes) נבנות באמצעות ה-setuptools שנקבעו ב-deploy/build.lock (--no-build-isolation) על ידי המשגר, ה-Windows portable builder וה-Dockerfile, כך ש-pip אינו מגדיר סביבת בנייה נפרדת ולא קבועה. תמונת הבסיס של Python וחבילות מערכת ההפעלה עדיין דורשות אישור שחרור עצמאי.

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

פרופיל עד עצמאי#

שירות ה-witness האופציונלי מפעיל עד עצמאי במכל משלו, עם מפתח ויומן משלו בנפח ה-witness-data, ורק אסימון עד לקריאה בלבד עבור האספן. צרו את האסימון בלוח הבקרה תחת כלים נוספים → תוספות → עד עצמאי, הוסיפו אותו יחד עם אסימון בוט וערוץ לקובץ .env, ולאחר מכן הפעילו את הפרופיל:

docker compose --profile witness up -d          # deploy/compose/compose.image.yaml: same flag
docker compose logs witness                     # witness key fingerprint

השירות מגיע לאספן בתוך רשת Compose בכתובת http://tgwitness:8787 (TGWITNESS_WITNESS_COLLECTOR מבטל את ההגדרה הזו; לדוגמה, /profiles/<workspace ID> עבור סביבת עבודה אחרת). עבור עד בשרת נפרד, המנוהל על ידי אדם אחר, יש להשתמש ב-deploy/compose/compose.witness.yaml שם, כאשר TGWITNESS_WITNESS_COLLECTOR מוגדר לכתובת ה-HTTPS של האספן; קובץ זה מכיל רק את העד.

התקן תמונה שפורסמה#

העתיקו את deploy/env.example ל-.env. הגדירו את TGWITNESS_IMAGE לגרסה שפורסמה, תוך שימוש בנתיב המאגר באותיות קטנות, לדוגמה:

TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787

הפעל קובץ זה בנפרד, במקום compose.yaml:

docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt

אין צורך בבניית קוד מקור, ב-Python או במהדר על השרת המארח. תהליך העבודה של המהדורה מיועד למכולות Linux AMD64 ו-ARM64, כולל מכונת הווירטואלית של Docker Desktop ב-Linux. יש להשתמש בתגית גרסה או ב-ghcr.io/owner/repository@sha256:... מתוך סיכום תהליך העבודה. לא הוגדרה תגית latest נעה או שדרוג יישום ללא השגחה. התמונות וגרסאות המקור משתמשות באותו נפח נתונים כאשר שם הפרויקט שלהן תואם.

HTTPS אוטומטי בשרת#

השתמש בשרת עם Docker, דומיין שבשליטתך ואחסון מקומי קבוע. כוונו את רשומות ה-A/AAAA של הדומיין אל השרת; פרסמו AAAA רק אם ה-IPv6 מגיע אליו. אפשרו כניסת TCP 80 ו-443 ויציאת DNS/HTTPS לצורך הנפקת תעודות. שירותים אחרים אינם רשאים להשתמש ביציאות אלה.

העתיקו את deploy/env.example ל-.env והגדירו שם מארח, ללא סכמה או נתיב:

TGWITNESS_DOMAIN=watch.your-domain.org

התחל את בניית הקוד המקור עם שכבת-על HTTPS:

docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait

עבור תמונה שפורסמה, השתמש ב-deploy/compose/compose.image.yaml כקובץ הראשון במקום זאת. שמור את שני הארגומנטים -f לשימוש מאוחר יותר בפקודות סטטוס, יומנים, עדכון והפסקת פעולה.

Caddy משיג ומחדש תעודה, מפנה HTTP ל-HTTPS ומעביר בקשות לאספן ברשת Compose הפרטית. למצב התעודה יש נפח קבוע משלו. יציאת המארח הישירה של האספן נשארת בלולבק בלבד. תצורת Caddy המסופקת אינה מאפשרת רישום גישה.

פתחו את https://watch.your-domain.org והזינו את אסימון הפאנל. הכנת המערכת מכסה את המכלים; הנפקת תעודות ונגישות חיצונית תלויות ב-DNS ובחומת האש. אם HTTPS אינו מוכן, בדקו את ה-DNS, את כללי חומת האש, וכן:

docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy

תמונת ה-Caddy המסופקת נושאת את התגית 2-alpine. ביצוע פקודת pull מרענן את התמונה; הצמיד תקציר שנבדק לפריסה שלך אם אתה זקוק לגרסאות תשתית קבועות.

עדכונים וגיבויים#

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

docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update

השתמשו בכל פעם ביעד גיבוי חדש, מחוץ למאגר, והגנו עליו כעל חומר הדורש גישה לחשבון. הנתיב המופיע בדוגמה הוא להמחשה בלבד; השתמשו במיקום הגיבוי הפרטי שלכם. העתיקו את הספרייה כולה, כולל קבצים מוסתרים, כל סביבות העבודה, המפתחות, יומני הראיות והמדיה. גבו בנפרד את מפתח המאסטר של הכספת החיצונית, אם הוגדר. קובץ ZIP של ראיות אינו גיבוי יישום שניתן לשחזר. עבור HTTPS, שמרו גם את כרכי Caddy אם אתם צריכים לשמור על מצב האישור/החשבון שלו.

לצורך פריסה מהמקור, יש להוריד את קבצי הגרסה החדשה ולהריץ:

docker compose up -d --build --wait

לצורך פריסת תמונה, יש לשנות את TGWITNESS_IMAGE לגרסה הרצויה, ולאחר מכן להריץ:

docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait

השתמשו בקובצי ה-Compose של ההתקנה שלכם גם עבור פקודות ה-stop/copy שלעיל. שמרו על .env, על התצורה המותאמת אישית ועל אותו שם פרויקט. down שומר על כרכים שמותיים; down -v מוחק אותם. אין להעתיק את .venv בין מערכות הפעלה או גרסאות Python. לעדכונים מקוריים, עצרו את TgWitness, גבו את ספריית הנתונים המלאה שלו, החליפו את קבצי המקור והפעילו את python start.py --setup-only לפני ההפעלה.

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

שרת מרוחק#

יש להגביל את השירות ל-loopback ולהשתמש במנהרת SSH, או לסיים את HTTPS ב- פרוקסי הפוך. קובץ ה-Compose הבסיסי מיועד לשימוש מקומי בלבד; שכבת-העל האופציונלית deploy/compose/compose.https.yaml מספקת את Caddy עבור דומיין שהוגדר. הקפידו שלא לכלול את אסימון ה-bearer בכתובות URL וביומני הפרוקסי. פרוקסי הפוך צריך להגביל את גודל הבקשות ואת קצב החיבורים. אל תחשפו HTTP רגיל לאינטרנט.

דוגמאות ל-systemd, למשימת כניסה ל-Windows, לסוכן משתמש ב-macOS ול-Caddy מסופקות בתיקיית deploy/. יש לבדוק/להתאים את הנתיבים שלהן לפני ההתקנה. מדובר בתבניות מסופקות, ולא בהגדרות פלטפורמה המבוצעות באופן מקומי. אין שירות או משימה ברקע הרשומים על ידי המשגר הרגיל.

ב-Windows, הפעלה של pythonw.exe ללא חלון מאחסנת אבחון אתחול/שרת ב- logs/server.log תחת ספריית הנתונים (5 MiB לכל קובץ, שתי גיבויים מתחלפים). הפעלות קונסולה שומרות את יומני הקונסולה. רישום גישה ל-HTTP מושבת בשני המצבים. יש להגן על היומנים באמצעות ספריית הנתונים ולבדוק אותם לפני השיתוף.

הפעלה מחדש ופערים#

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

TgWitness מאחסן את מיקום העדכון של Telegram עבור החשבון ועבור כל ערוץ (pts, qts, seq ו-date) בכספת סביבת העבודה ומשחזר אותו בהפעלה הבאה. לאחר מכן, הלקוח מבקש את העדכונים שהוחמצו בזמן שהתהליך היה מושעה, וה בדיקה מחודשת תקופתית משחזרת הודעות שהוחמצו ומתעדת הודעות שנשמרו ש-Telegram כבר לא מחזירה. דיאלוגים נטענים מחדש בעת ההפעלה. כל הפעלה מתעדת את ראש היומן הקודם, את גבול המצב הלא מקוון ואת מיקום העדכון שממנו היא חזרה לפעול. הצג בודק את החיבור כל 10 שניות ומוסיף אות חיים כל דקה (כלים נוספים → פרמטרים → תיעוד פעילות כל). ניתוקים ותקופות שקטות נרשמים כפערים בכיסוי עם הסיבה להם. תמונות מצב של ההיסטוריה מאוחסנות כתצפיות נפרדות של ההיסטוריה הנוכחית לצד הרשומות החיות.

תור המדיה מאוחסן במסד הנתונים SQLite של כל סביבת עבודה. הודעה והמשימה שלה נשמרים באופן אטומי. משימות שהריצה שלהן הופרעה משוחזרות לצורך ניסיון חוזר בעת ההפעלה. לכל הורדה יש זמן המתנה בסיסי של 120 שניות בתוספת זמן לפי קצב של 256 KiB/s בהתאם לגודלה, וכן 1–2,000 MiB לכל סוג קובץ מצורף; זמן ההמתנה, המהירות והניסיונות החוזרים נמצאים תחת כלים נוספים → פרמטרים. האספן מדלג על קבצים שגודלם אינו ידוע. השהיה שומרת על העבודה בתור. הניסיון החוזר משתמש במתאר הקובץ המקורי שנצפה, לעולם לא בגרסה האחרונה של הודעה שעברה עריכה לאחר מכן. לכשלים זמניים יש מספר מוגבל של ניסיונות חוזרים; השהיות של FloodWait במדיה נשמרות גם לאחר הפעלה מחדש. שחזור המדיה נפרד משחזור העדכונים של Telegram ואינו יכול לשחזר קבצים שנעלמו.

גיבוי, שחזור וקיבולת#

tgwitness backup FOLDER מעתיק את ספריית הנתונים בזמן שהלוח ממשיך לפעול: ראשית נקודות הבדיקה, לאחר מכן קבצי SQLite באמצעות ממשק ה-API לגיבוי מקוון, ולאחר מכן מפתחות, מדיה ו פרופילים, כך שאף נקודת בדיקה שהועתקה אינה חדשה יותר מהיומן שהועתק. הקובץ backup-manifest.json מפרט את ה-SHA-256 של כל קובץ ואת ראשי היומנים. כדי לשחזר, עצרו את TgWitness והחליפו את ספריית הנתונים כולה בתיקייה זו. בהפעלה הבאה נרשם כי היומן שוחזר מעתק ישן יותר. רישום זה משווה את היומן עם הראש השמור ב- TGWITNESS_STATE_DIR , תיקייה מחוץ לספריית הנתונים: אמצעי האחסון tgwitness-state ב- ב-Compose, ב-/var/lib/tgwitness-state ביחידות systemd, ובתיקיית המצב המקומית של המשתמש בכל מקרה אחר. ללא תיקיית מצב הניתנת לכתיבה, השחזור אינו מזוהה והיומן מציין זאת פעם אחת.

ללא הפקודה, יש לעצור את התהליך לפני העתקת ספריית הנתונים כולה, כולל הקובץ vault.key, signing.enc, credentials.enc, קבצי מסד הנתונים/WAL של SQLite, מדיה, אסימון, נקודות ביקורת, וכל הפרופילים/תתי-הספריות. שחזר את העותק המלא בזמן שהשירות היעד מושבת. מפתחות vault חסרים או אי-התאמה במפתחות החתימה יגרמו לכישלון ההפעלה; אין ליצור מחדש מפתחות כדי לכפות גישה.

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

התחל אימות וייצא רשומות זרם במקום לטעון את היומן כולו. ייצוא מקבע תמונת מצב של קריאה בעוד כתיבות WAL חדשות יכולות להמשיך; ייצוא ארוך-טווח יכול לשמור דפי WAL, ולכן נפח הדיסק עדיין חשוב. קובצי ZIP מוגבלים ל-4 GiB במצב לא דחוס, כדי להתאים לברירת המחדל של המאמת העצמאי; כלים נוספים → פרמטרים → ZIP חתום הגדול ביותר מעלה את המגבלה, וארכיונים כאלה מאומתים באמצעות verify.py --max-gib N. בפורמטים אחרים אין מגבלה על מספר האירועים. דפדפנים נתמכים מזרימים קטעי תגובה לקובץ שנבחר על ידי המשתמש. דפדפנים אחרים מאחסנים במאגר זמני לכל היותר 128 MiB ומפנים העברות גדולות יותר ל-CLI המאושר:

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

השתמש ב---profile ID מתוך 'ייצוא' → 'מזהה סביבת עבודה' עבור סביבת עבודה אחרת, --format zip|jsonl|csv|html, --url https://your-server עבור שרת מרוחק, או --max-mib כדי לשנות את מגבלת ההעברה של 5 GiB. HTTP רגיל מותר רק עבור loopback. האסימונים מועברים בכותרות, הפניות נדחות, קבצים קיימים אינם נמחקים, והורדות לא שלמות אינן מתפרסמות כקבצים מוגמרים. אם TGWITNESS_TOKEN מבטל את האסימון שנוצר, השתמש בקובץ מוגן בנפרד המכיל את הערך הפעיל: panel-token.txt אינו נכתב מחדש על ידי הביטול. ה-SHA-256 של הפקודה הוא רק בדיקת סיכום העברה; אמת באופן עצמאי את קובץ ה-ZIP החתום.

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

נהלים מפורטים: חיבור/אבטחה ו מצבי הפעלה.