חשבונות ופורמטים של הפעלות

TgWitness מתחבר כחשבון משתמש טלגרם (לא כבוט) באמצעות MTProto, תוך שימוש ב- Telethon. כל חשבון פועל בסביבת עבודה משלו (המכונה "סביבת עבודה" ב- API ובכלי שורת הפקודה) עם הפעלה, מקורות, יומן ומפתח חתימה משלו.

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

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

• במבט חטוף
• לפני שתתחילו: מזהה API ו-hash של API
• מספר טלפון · קוד QR · מפתח אימות + מזהה DC
• קובצי חשבונות: Telethon .session · Pyrogram .session · צמד של סשן + JSON · TData · StringSession · קובץ JSON של החשבון
• זהו את מה שיש ברשותכם · פורמטים שאינם נתמכים
• חשבונות מרובים · שמירה על אבטחת קבצי החשבונות · פתרון בעיות

במבט חטוף#

TgWitness מזהה קבצים לפי תוכנם, ולא לפי שמותיהם. שינוי שם של קובץ לעולם אינו מוביל להמרתו.

לפני שתתחילו: מזהה API ו-hash של API#

ניתן להתחבר ללא צורך ביצירת יישום API של טלגרם. כאשר לא הוזן זוג, לא יובא או שכבר נשמר בסביבת העבודה, TgWitness בוחר זוג ממאגר מובנה של 50 זוגות API ציבוריים (tgwitness/api_pool.py) בסדר אקראי. אם טלגרם דוחה זוג (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), נבדק הזוג הבא, עד שמונה זוגות לכל כניסה; זוגות שנדחו מדלגים עליהם עד להפעלה מחדש. הזוג שנכנס נשמר עם החשבון ומשמש אותו שוב. מזהה API והאש של ה-API מזהים את היישום מול טלגרם; הם אינם מאשרים חשבון כשלעצמם.

כדי להשתמש במקום זאת ביישום משלכם (החשבון שרושם אותו הוא זה שנמצא בסיכון; ראו " מדוע מאגר API מובנה?"):

1. פתחו את my.telegram.org והתחברו באמצעות כל מספר טלפון שבבעלותכם. הקוד יגיע לאפליקציית טלגרם, ולא באמצעות SMS.
2. בחרו כלי פיתוח API.
3. יצירת יישום: כל כותרת ושם קצר (5–32 אותיות), פלטפורמה: שולחן עבודה. ניתן להשאיר את שדה ה-URL והתיאור ריקים.
4. העתיקו את ה-api_id של האפליקציה (מספר) ואת ה-api_hash של האפליקציה (32 תווים הקסדצימליים).

בלוח הבקרה, תחת טופס הכניסה, מופיעים שדות "מזהה API" ו-"Hash". ניתן להדביק זוג api_id:api_hash יחיד בשדה "מזהה API" ושני השדות יתמלאו. ניתן להשתמש בזוג אחד לכל החשבונות שלכם. לאחר כניסה מוצלחת, הנתונים נשמרים, מוצפנים, במרחב העבודה הספציפי הזה בלבד, ואינם נשלחים חזרה לדפדפן.

מדובר בשלושה אישורים שונים:

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

מספר טלפון#

1. פתחו את החשבון, עברו לכרטיסייה "טלפון" והזינו את המספר בפורמט בינלאומי, לדוגמה +44 7700 900123. רווחים וקווים מפרידים מוסרים באופן אוטומטי.
2. לחץ על "המשך". שדות "מזהה API" ו-"Hash" יכולים להישאר ריקים.
3. הזן את הקוד ש-Telegram שולח (בדרך כלל לאפליקציית Telegram; אין ערובה לקבלת ה-SMS).
4. אם לחשבון יש אימות דו-שלבי, הזן את הסיסמה הזו. זו אינה אסימון הפאנל ואינה קוד הגישה למכשיר.
5. בדקו את מזהה החשבון המופיע לאחר הכניסה, ולאחר מכן בחרו מקורות.

קודי הכניסה והסיסמה ל-2FA לעולם אינם נשמרים בדיסק.

קוד QR#

יש להשתמש בכך כאשר החשבון כבר מחובר בטלפון או במחשב אחר.

1. לשונית "קוד QR" → הצג קוד QR. שדות "מזהה API" ו-"Hash" יכולים להישאר ריקים.
2. במכשיר שבו אתה מחובר: הגדרות → מכשירים → קישור למכשיר שולחני, סרוק את הקוד ואשר.
3. הזן את סיסמת ה-2FA ב-TgWitness אם Telegram מבקש זאת.

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

מפתח אימות + מזהה DC#

מפתח אימות (Auth Key) הוא מפתח האימות הגולמי בן 256 בתים העומד בבסיס כל הפעלה של טלגרם, הכתוב כ-512 תווים הקסדצימליים, יחד עם מספר מרכז הנתונים DC 1–5.

1. מפתח אימות Tab. הדביקו את המפתח המלא; מפתח מקוצר המכיל את … לא יפעל.
2. בחר את מזהה ה-DC שסופק עם המפתח.
3. ניתן להזין את מזהה המשתמש (User ID). במקרה כזה, TgWitness יסרב להתחבר אם Telegram מדווח על חשבון שונה.
4. חשבון Press Connect.

מפתח אימות (512 תווים) אינו חתימת API (32 תווים). ניתן גם לייבא את אותו המפתח כקובץ JSON; ראו JSON של החשבון.

קובצי חשבונות#

פתח את "הוסף חשבון" → "קבצים" ובחר עד ארבעה קבצים השייכים לחשבון אחד, בהיקף כולל של 8 MiB, ולאחר מכן לחץ על "חבר חשבון".

• הקבצים מומרים בזיכרון בשרת ה-TgWitness שלכם. הקבצים המועלים אינם נשמרים, קבצי ZIP אינם נפרקים לדיסק ואין יצירת קשר עם שירות חיצוני כלשהו.
• הפעילות שהתקבלה נבדקת לאחר מכן מול טלגרם. אם קובץ מציין מזהה משתמש, עליו להתאים לחשבון שטלגרם מדווח עליו.
• קובצים המתארים חשבונות שונים או פרטי הזדהות שונים ל-API נדחים במקום לבחור באחד מהם.
• שדה "Passcode" או "session text" מכיל את שדה הסיסמה המקומית של TData, תיבה להדבקת StringSession וקריאת קבצים ללא צורך בהתחברות (ממלא את הטופס מבלי ליצור קשר עם Telegram).

Telethon .session#

סגור תחילה את התוכנית שיצרה את הקובץ. אם my_account.session-journal או my_account.session-wal קיימים לצדו, מסד הנתונים אינו סופי: פתח ו סגור את הלקוח המקורי כהלכה. מחיקת קבצי ה-sidecar הללו עלולה להשאיר עותק פגום.

Pyrogram .session#

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

צמד של סשן + JSON#

לעתים קרובות, החשבונות מופצים כשני קבצים בעלי אותו שם, לדוגמה 447700900123.session ו-447700900123.json. יש לבחור בשניהם בבת אחת.

• מתוך קובץ ה-JSON, TgWitness משתמש ב-app_id/api_id וב-app_hash/api_hash, כך שבדרך כלל אין צורך להזין פרטי הזדהות ל-API.
• שדות אחרים כגון phone, device, sdk, app_version, lang_pack או סיסמה twoFA שמורה ייתעלמו. אם לחשבון יש אימות דו-שלבי (2FA), TgWitness יבקש אותו.
• קובץ JSON בפני עצמו הוא רק מטא-נתונים. ללא קובץ ההפעלה, המשך עם כניסה באמצעות טלפון או QR.

Telegram Desktop (TData)#

TData היא התיקייה tdata של יישום Telegram Desktop (האפליקציה הרב-פלטפורמית מ-desktop.telegram.org).

כדי לייבא אותו:

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

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

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

1. סגור את Telegram Desktop לחלוטין.

2. צרו קובץ ZIP המכיל רק את שני הפריטים הבאים מ-tdata:

   • key_datas
   • הקובץ בן 16 התווים המסתיים ב-s שלצדו, בדרך כלל D877F783D5D3EF8Cs

   דחיסת התיקייה כולה עם מטמון המדיה שלה חורגת בדרך כלל מהמגבלות (512 רשומות, 32 MiB לאחר הפריקה). 3. בחרו את קובץ ה-ZIP ב"קובצים". אם ל-Telegram Desktop יש קוד גישה מקומי, הזינו אותו תחילה בשדה "קוד גישה" או "טקסט הפעלה". זהו לא סיסמת ה-2FA.

נתמך: חשבון אחד לכל ארכיון, אחסון מודרני מסוג key_datas/key_data0/key_data1, קוד גישה מקומי. לא נתמך: תיקיות עם מספר חשבונות מחוברים, פריסות שולחן עבודה ישנות יותר, קובצי ZIP המוגנים בסיסמה, והאפליקציה המקורית הנפרדת של macOS "Telegram for macOS".

Telethon StringSession#

שורת טקסט אחת, המתחילה בדרך כלל ב-1 ואורכה כ-350 תווים. טען אותה כקובץ .txt או .tgwitness-session (בגודל של עד 4 KiB), או הדבק אותה תחת "קוד גישה" או "טקסט הפעלה". מתקבלות רק מחרוזות Telethon; מחרוזות Pyrogram ו-TDLib משתמשות בפורמטים שונים.

קובץ JSON של החשבון#

אובייקט JSON אחד, בגודל של עד 64 KiB, בקובץ שמסתיים ב-.json.

אם מופיעים גם כינוי וגם השם הראשי, עליהם להיות זהים. דוגמאות:

{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }

{
  "api_id": 1234567,
  "api_hash": "0123456789abcdef0123456789abcdef",
  "auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
  "dc_id": 2,
  "user_id": 123456789
}

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

זהו את מה שיש ברשותכם#

פורמטים שאינם נתמכים#

חשבונות מרובים#

לחץ על + ליד בורר החשבונות, או פתח חשבון → הגדרות → הגדרות חיבור → סביבות עבודה, הזן תווית ו התחבר.

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

ייבוא מרובה וקבוצות חשבונות#

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

התנתק#

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

המרת סשן טלתיאון למצב לא מקוון#

הלוח מייבא קבצי .session ישירות. להמרה לא מקוונת לקובץ StringSession, הפעל מתוך תיקיית הפרויקט:

.venv\Scripts\python.exe -m tgwitness.sessions account.session --out account.tgwitness-session   # Windows

.venv/bin/python -m tgwitness.sessions account.session --out account.tgwitness-session          # Linux/macOS

הממיר קורא רק קבצי Telethon SQLite (עד 64 MiB), לעולם אינו משנה את הקלט, אינו מבצע בקשות רשת ומסרב להחליף קובץ פלט קיים.

שמירה על אבטחת קבצי החשבונות#

• התייחסו לכל .session, TData ZIP, StringSession, מפתח אימות (Auth Key) ו-JSON של חשבון כאל סיסמה. TgWitness שומר את האישור המיובא בכספת המוצפנת שלו; תוכלו להסיר את הקבצים המקוריים לאחר מכן.
• אין להפעיל את אותה הרשאה בשתי תוכנות בו-זמנית. Telegram עלולה לבטל אותה (AUTH_KEY_DUPLICATED), ושתי הגרסאות יפסיקו לפעול.
• לא ניתן להחיות הפעלה שפג תוקפה או שבוטלה באמצעות המרה. התחבר שוב.

פתרון בעיות#

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