รูปแบบบัญชีและเซสชัน

TgWitness ลงชื่อเข้าใช้ในฐานะบัญชีผู้ใช้ Telegram (ไม่ใช่บอต) ผ่าน MTProto โดยใช้ Telethon แต่ละบัญชีจะอยู่ในพื้นที่ทำงานของตัวเอง (เรียกว่า workspace ใน API และเครื่องมือบรรทัดคำสั่ง) พร้อมด้วยเซสชัน แหล่งข้อมูล บันทึก และกุญแจลงนามของตัวเอง

ไฟล์เซสชัน, สตริงเซสชัน และ Auth Keys เป็นข้อมูลการอนุญาตของบัญชี: ผู้ใดก็ตาม ที่ถือข้อมูลเหล่านี้สามารถดำเนินการในนามบัญชีนั้นได้ แต่ข้อมูลเหล่านี้ไม่รวมประวัติข้อความ

[!WARNING] อย่าใช้ข้อมูลใดที่คุณไม่สามารถรับความสูญเสียได้ เราขอแนะนำอย่างแรงว่าอย่าเชื่อมต่อ บัญชีส่วนตัวหรือบัญชีที่มีค่าอื่นใด และอย่าสร้าง API ID / API hash บน บัญชีที่คุณให้ความสำคัญ นี่ไม่ใช่เรื่องที่ TgWitness ยังไม่ผ่านการทดสอบ: Telegram จำกัดและ ห้ามบัญชีอย่างถาวรแบบคาดเดาไม่ได้ — สำหรับปริมาณคำขอที่ Telegram ถือว่า เกินขีดจำกัด โดยไม่คำนึงถึงผู้ใช้หรือวัตถุประสงค์ และไม่มีเอกสารประกอบที่เพียงพอ การห้ามบัญชี หลายกรณีไม่สามารถย้อนกลับได้ ใช้บัญชีที่จัดไว้เฉพาะสำหรับการทดสอบ การทดสอบที่ราบรื่นขึ้นอยู่กับ Telegram ไม่ใช่ ซอฟต์แวร์ และไม่รับประกันอะไรสำหรับอนาคต

• สรุปโดยย่อ
• ก่อนเริ่ม: API ID และ API hash
• หมายเลขโทรศัพท์ · รหัส QR · Auth Key + DC ID
• ไฟล์บัญชี: Telethon .session · Pyrogram .session · คู่ Session + JSON · TData · StringSession · JSON ของบัญชี
• ระบุสิ่งที่คุณมี · รูปแบบที่ไม่รองรับ
• หลายบัญชี · การรักษาความปลอดภัยของไฟล์บัญชี · การแก้ไขปัญหา

สรุปโดยย่อ#

TgWitness ระบุไฟล์จากเนื้อหา ไม่ใช่จากชื่อไฟล์ การเปลี่ยนชื่อไฟล์ จะไม่ทำให้ไฟล์นั้นถูกแปลงรูปแบบ

ก่อนเริ่ม: API ID และ API hash#

คุณสามารถเข้าสู่ระบบได้โดยไม่ต้องสร้างแอปพลิเคชัน API ของ Telegram เมื่อไม่มีการป้อนคู่ นำเข้า หรือคู่ที่บันทึกไว้แล้วในพื้นที่ทำงาน TgWitness จะเลือกคู่จากกลุ่มคู่ API สาธารณะ 50 คู่ (tgwitness/api_pool.py) ที่ติดตั้งมาพร้อมระบบ ตามลำดับแบบสุ่ม หาก Telegram ปฏิเสธคู่ (API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), ระบบจะลองคู่ถัดไป, สูงสุด 8 คู่ต่อครั้งการลงชื่อเข้าใช้; คู่ที่ถูกปฏิเสธจะถูกข้ามไปจนกว่าจะเริ่มต้นใหม่ คู่ที่ใช้ลงชื่อเข้าใช้จะถูก บันทึกไว้กับบัญชีและใช้ซ้ำสำหรับบัญชีนั้น API ID และ API hash ใช้เพื่อระบุแอปพลิเคชันต่อ Telegram; แต่ ทั้งสองอย่างนี้ไม่ทำการอนุญาตบัญชีด้วยตัวเอง

หากต้องการใช้แอปพลิเคชันของคุณเองแทน (บัญชีที่ลงทะเบียนแอปพลิเคชันนั้นคือบัญชีที่เสี่ยง; ดู Why a built-in API pool?):

1. เปิด my.telegram.org และลงชื่อเข้าใช้ด้วยหมายเลขโทรศัพท์ใดก็ได้ ที่คุณเป็นเจ้าของ รหัสยืนยันจะส่งมาในแอป Telegram ไม่ใช่ผ่าน SMS.
2. เลือกเครื่องมือพัฒนา API
3. สร้างแอปพลิเคชัน: ชื่อและชื่อสั้น (5–32 ตัวอักษร) ตามต้องการ, แพลตฟอร์ม Desktop. URL และคำอธิบายสามารถทิ้งว่างไว้ได้
4. คัดลอก App api_id (ตัวเลข) และ App api_hash (32 ตัวอักษรฐานสิบหก)

ในส่วนแผงควบคุม ให้ใส่ Open API ID + Hash ใต้แบบฟอร์มลงชื่อเข้าใช้ คุณสามารถวางคู่ api_id:api_hash เดียวลงในช่อง API ID และทั้งสองช่องจะถูกกรอกอัตโนมัติ คู่หนึ่งสามารถ ใช้ได้กับบัญชีทั้งหมดของคุณ หลังจากลงชื่อเข้าใช้สำเร็จ ข้อมูลจะถูกบันทึกและเข้ารหัสไว้ ในพื้นที่ทำงานนั้นเท่านั้น และจะไม่ถูกส่งกลับไปยังเบราว์เซอร์เลย

มีข้อมูลรับรองสามประเภทที่เกี่ยวข้อง:

หากต้องเข้าถึง Telegram ผ่านพร็อกซี ให้ตั้งค่าก่อนที่ บัญชี → การตั้งค่า → การตั้งค่าการเชื่อมต่อ → เปลี่ยนเส้นทางเชื่อมต่อ

หมายเลขโทรศัพท์#

1. เปิดบัญชี, คลิกแท็บ "โทรศัพท์" และป้อนหมายเลขในรูปแบบสากล, เช่น +44 7700 900123. ช่องว่างและเครื่องหมายขีดจะถูกตัดออกโดยอัตโนมัติ.
2. กด "Continue" (ต่อ). API ID + Hash สามารถทิ้งว่างไว้ได้
3. ป้อนรหัสที่ Telegram ส่งมา (โดยทั่วไปจะส่งไปยังแอป Telegram; ไม่รับประกันว่าจะส่งผ่าน SMS)
4. หากบัญชีมีการยืนยันสองขั้นตอน ให้ป้อนรหัสผ่านนั้น ไม่ใช่ โทเค็นของแผงควบคุม และไม่ใช่รหัสผ่านของอุปกรณ์
5. ตรวจสอบ ID บัญชีที่แสดงขึ้นหลังการเข้าสู่ระบบ แล้วเลือกแหล่งข้อมูล

รหัสเข้าสู่ระบบและรหัสผ่าน 2FA ไม่ถูกบันทึกลงบนดิสก์เลย

รหัส QR#

ใช้ตัวเลือกนี้เมื่อบัญชีได้เข้าสู่ระบบแล้วบนโทรศัพท์หรือคอมพิวเตอร์เครื่องอื่น

1. คลิกที่ QR code → แสดง QR code. API ID + Hash สามารถทิ้งว่างไว้ได้
2. บนอุปกรณ์ที่ลงชื่อเข้าใช้แล้ว: การตั้งค่า → อุปกรณ์ → เชื่อมต่ออุปกรณ์เดสก์ท็อป, สแกนรหัส และยืนยัน
3. กรุณาป้อนรหัสผ่าน 2FA ใน TgWitness หาก Telegram ขอให้ป้อน

ภาพ QR ถูกสร้างขึ้นในเครื่องท้องถิ่น รหัสมีอายุการใช้งานจำกัด; คลิก "สร้างรหัส QR อีกครั้ง" เพื่อลองใหม่ การล็อกหน้าต่าง การเปลี่ยนพื้นที่ทำงาน หรือการเข้าสู่ระบบด้วยบัญชีอื่น จะทำให้ รหัสที่ยังไม่ถูกใช้ถูกยกเลิก

Auth Key + DC ID#

Auth Key คือรหัสอนุญาตดิบขนาด 256 ไบต์ที่อยู่เบื้องหลังทุกเซสชัน Telegram ซึ่งเขียน เป็นตัวเลขฐานสิบหก 512 ตัว พร้อมด้วยหมายเลขศูนย์ข้อมูล DC 1–5

1. แท็บ "Auth key" (กุญแจการยืนยันตัวตน). วางกุญแจทั้งหมดลงไป; กุญแจที่ถูกตัดสั้นลงซึ่งมีตัวอักษร … จะไม่สามารถใช้งานได้
2. เลือก DC ID ที่มาพร้อมกับกุญแจ
3. สามารถป้อน ID ผู้ใช้ได้ (ไม่บังคับ) TgWitness จะปฏิเสธการเชื่อมต่อหาก Telegram รายงาน บัญชีที่ต่างออกไป
4. บัญชี Press Connect.

Auth Key (512 ตัวอักษร) ไม่ใช่ API hash (32 ตัวอักษร) กุญแจเดียวกันนี้ยังสามารถ นำเข้าในรูปแบบ JSON ได้ ดู Account JSON

ไฟล์บัญชี#

คลิก “เพิ่มบัญชี” → “ไฟล์” และเลือกไฟล์สูงสุด 4 ไฟล์จากบัญชีเดียว (รวมทั้งหมด 8 MiB) แล้วคลิก “เชื่อมต่อบัญชี”

• ไฟล์จะถูกแปลงในหน่วยความจำบนเซิร์ฟเวอร์ TgWitness ของคุณ การอัปโหลดจะไม่ถูกเก็บไว้ ไฟล์ ZIP จะไม่ถูกแตกออกสู่ดิสก์ และไม่มีการติดต่อกับบริการภายนอกใดๆ
• เซสชันที่ได้มาจะถูกตรวจสอบกับ Telegram หากไฟล์ระบุ ID ผู้ใช้ มันต้องตรงกับบัญชีที่ Telegram รายงาน
• ไฟล์ที่อธิบายบัญชีต่าง ๆ หรือข้อมูลรับรอง API ต่าง ๆ จะถูกปฏิเสธ แทนที่จะเลือกเพียงหนึ่งรายการ
• ช่องรหัสผ่านหรือข้อความเซสชัน (Passcode or session text) เป็นช่องสำหรับกรอกรหัสผ่านท้องถิ่น TData ซึ่งเป็นช่องสำหรับวาง StringSession และไฟล์ Read โดยไม่ต้องลงชื่อเข้าใช้ (กรอกแบบฟอร์มโดยไม่ต้อง ติดต่อกับ Telegram)

Telethon .session#

ปิดโปรแกรมที่สร้างไฟล์นั้นก่อน หากมีไฟล์ my_account.session-journal หรือ my_account.session-wal อยู่ข้างๆ หมายความว่าฐานข้อมูลยังไม่เสร็จสมบูรณ์: เปิดและ ปิดโปรแกรมไคลเอนต์ต้นฉบับอย่างถูกต้อง การลบไฟล์ sidecar เหล่านั้นอาจทำให้เหลือสำเนาที่เสียหาย

Pyrogram .session#

ID ผู้ใช้ที่เก็บไว้จะถูกตรวจสอบกับ Telegram ระหว่างการเข้าสู่ระบบ

คู่ 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 Code

Telegram Desktop (TData)#

TData คือโฟลเดอร์tdata ของแอปพลิเคชัน Telegram Desktop (แอปข้ามแพลตฟอร์ม จาก desktop.telegram.org)

เพื่อนำเข้า:

คำเตือนเกี่ยวกับการใช้งานแบบคู่ขนาน การนำเข้า TData จะใช้กุญแจการอนุญาตของ Telegram Desktop ซ้ำ; มันไม่สร้างการเข้าสู่ระบบที่แยกต่างหาก อย่าใช้กุญแจนั้นใน Desktop และ TgWitness พร้อมกัน Telegram อาจทำให้การอนุญาตเป็นโมฆะด้วย AUTH_KEY_DUPLICATED ซึ่งทำให้ทั้งสองสำเนาไม่สามารถใช้งานได้จนกว่าจะมีการเข้าสู่ระบบใหม่

ปิด Desktop อย่างสมบูรณ์ รวมถึงกระบวนการในถาดระบบ และรักษาให้สำเนานั้นปิดอยู่ตลอดเวลา ที่ TgWitness กำลังใช้เซสชันที่นำเข้า ปิดโปรแกรม (Quit) แต่ไม่ต้องออกจากระบบ (log out) หรือยกเลิกเซสชัน: การยกเลิกเซสชันจะทำให้สำเนาที่นำเข้ามาไม่ถูกต้องด้วย หากต้องการให้ทั้งสองไคลเอนต์ทำงานพร้อมกัน ให้เข้าสู่ระบบ TgWitness ผ่านโทรศัพท์หรือ QR เพื่อสร้างการอนุญาตของตัวเอง แนะนำให้ใช้ บัญชีเฉพาะ แต่การใช้กุญแจที่คัดลอกมาพร้อมกันจะไม่ปลอดภัย

สิ่งนี้ยังใช้กับไฟล์.session ที่นำเข้า ข้อความ StringSession และ Auth Key HEX ลูกค้าอื่น ๆ ที่มีระบบการอนุญาตที่สร้างขึ้นอย่างอิสระสามารถยังคงลงชื่อเข้าใช้ได้ ดูเอกสาร AUTH_KEY_DUPLICATED ของ Telegram

1. ปิด Telegram Desktop อย่างสมบูรณ์

2. สร้างไฟล์ ZIP ที่ประกอบด้วยเพียงสองรายการต่อไปนี้จาก tdata:

   • key_datas
   • ไฟล์ 16 ตัวอักษรที่ลงท้ายด้วย s ที่อยู่ข้างๆ โดยทั่วไปคือ D877F783D5D3EF8Cs

   การบีบอัดทั้งโฟลเดอร์พร้อมแคชสื่อมักเกินขีดจำกัด (512 รายการ, 32 MiB เมื่อคลายการบีบอัด). 3. เลือกไฟล์ ZIP ในส่วน Files หาก Telegram Desktop มีรหัสผ่านท้องถิ่น ให้ป้อนรหัสผ่านนั้น ในส่วน Passcode หรือข้อความเซสชันก่อน นี่ไม่ใช่รหัสผ่าน 2FA

รองรับ: บัญชีเดียวต่อไฟล์เก็บถาวร, ระบบจัดเก็บข้อมูลสมัยใหม่แบบ key_datas/key_data0/key_data1, รหัสผ่านท้องถิ่น ไม่รองรับ: โฟลเดอร์ที่มีหลายบัญชีที่เข้าสู่ระบบ, รูปแบบเดสก์ท็อป รุ่นเก่า, ไฟล์ ZIP ที่ป้องกันด้วยรหัสผ่าน และแอป macOS ดั้งเดิมที่แยกต่างหาก "Telegram for macOS"

Telethon StringSession#

ข้อความหนึ่งบรรทัด โดยทั่วไปเริ่มต้นด้วย 1 และมีความยาวประมาณ 350 ตัวอักษร โหลด มันเป็นไฟล์ .txt หรือ .tgwitness-session (สูงสุด 4 KiB) หรือวางมันลงใน ส่วน Passcode หรือ session text รับเฉพาะสตริง 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 ของบัญชี)

ระบุสิ่งที่คุณมี#

รูปแบบที่ไม่รองรับ#

หลายบัญชี#

กด + ข้างตัวเลือกรายชื่อบัญชี หรือเปิด บัญชี → การตั้งค่า → การตั้งค่าการเชื่อมต่อ → พื้นที่ทำงาน, ป้อนชื่อและ ลงชื่อเข้าใช้

• สามารถสร้างพื้นที่ทำงานได้ไม่จำกัด รวมถึงพื้นที่ทำงานหลัก แต่ละพื้นที่ทำงานมีเซสชัน โปรกซี เส้นทาง แหล่งข้อมูล นโยบายการบันทึก บันทึกหลักฐาน กุญแจลงนาม จุดตรวจสอบ และการส่งออกเป็นของตัวเอง
• การเปลี่ยนพื้นที่ทำงานที่แสดงอยู่จะไม่ทำให้พื้นที่ทำงานอื่น ๆ หยุดทำงาน
• บันทึกจะผูกติดกับบัญชีที่สร้างมันขึ้น การลงชื่อเข้าใช้ด้วย บัญชีอื่นจำเป็นต้องใช้พื้นที่ทำงาน (workspace) อีกหนึ่ง และบัญชีหนึ่งไม่สามารถถูกกำหนดให้ใช้กับ พื้นที่ทำงานสองแห่งได้
• โทเคนบนแผงหลักควบคุมพื้นที่ทำงานทั้งหมด สิทธิ์การเข้าถึงที่มอบให้สามารถจำกัดการเข้าถึงของผู้ใช้อื่นให้เฉพาะบัญชีและแชทที่เลือกไว้ พร้อมด้วยสิทธิ์การเข้าถึงและขีดจำกัดเซสชันที่แยกกัน
• บัญชีจะเปลี่ยนชื่อพื้นที่ทำงานและลบพื้นที่ทำงานที่เพิ่มเข้ามา พร้อมทั้งเซสชัน บันทึก แหล่งข้อมูล และกุญแจลงนาม พื้นที่ทำงานหลักไม่สามารถลบได้จากแผงควบคุม

การนำเข้าแบบกลุ่มและกลุ่มบัญชี#

ใช้ บัญชี → นำเข้าบัญชี เพื่อเพิ่มหลายบัญชี จับคู่ไฟล์ตามชื่อหลัก และดูผลการเข้าสู่ระบบแต่ละครั้ง แต่ละบัญชีมีพื้นที่ทำงานของตนเอง กลุ่มสามารถคัดลอกการตั้งค่าที่เลือกจากต้นแบบได้โดยไม่รวมเซสชัน คีย์ หรือหลักฐานเข้าด้วยกัน ดูคู่มือการนำเข้าและกลุ่มและแดชบอร์ดพูล MTProxy

ออกจากระบบ#

บัญชี → ออกจาก Telegram (พร้อมการหยุดการสังเกต) จะขอให้ Telegram ยุติ เซสชัน ดังนั้นเซสชันดังกล่าวจะหายไปจากเมนู ตั้งค่า → อุปกรณ์ ของบัญชี และลบ เซสชันออกจากคลังพื้นที่ทำงาน ส่วนบันทึก แหล่งข้อมูล การตั้งค่า และกุญแจลงนามจะยังคงอยู่ และ บันทึกจะบันทึกการออกจากระบบ พื้นที่ทำงานยังคงเป็นของบัญชีนั้น: มีเพียง บัญชีนั้นเท่านั้นที่สามารถเชื่อมต่อกับมันได้อีกครั้ง หาก Telegram ไม่ตอบสนอง เซสชันจะยังคงถูกลบ ที่นี่ และแผงควบคุมจะแจ้งให้ทราบ; ให้สิ้นสุดเซสชันใน Telegram ที่ การตั้งค่า → อุปกรณ์

แปลงเซสชัน Telethon เป็นโหมดออฟไลน์#

แผงควบคุมนี้สามารถนำเข้าไฟล์ .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) และทั้งสองโปรแกรมจะหยุดทำงาน
• เซสชันที่หมดอายุหรือถูกยกเลิกไม่สามารถฟื้นคืนได้ด้วยการแปลงข้อมูล โปรดเข้าสู่ระบบใหม่

การแก้ไขปัญหา#

ดูเพิ่มเติม: การเชื่อมต่อและความปลอดภัยสำหรับพร็อกซีและการเข้ารหัส, และวิธีการทำงานของการเก็บข้อมูลสำหรับเนื้อหาที่ถูกบันทึกหลังการลงชื่อเข้าใช้