ส่วนหนึ่งของหน้านี้ยังคงเป็นภาษาอังกฤษ: เนื้อหาต้นฉบับภาษาอังกฤษได้เปลี่ยนแปลงไปหลังจากถูกแปล
อ้างอิง / การตั้งค่า
Telegram · รูปแบบบัญชีและเซสชัน
ลงชื่อเข้าใช้ผ่านโทรศัพท์มือถือ รหัส QR หรือกุญแจการยืนยันตัวตน นำเข้าเซสชันจาก Telethon Pyrogram หรือ Telegram Desktop และจัดการหลายบัญชีได้
TgWitness / เอกสารประกอบ · เริ่มต้นใช้งาน
TgWitness ลงชื่อเข้าใช้ในฐานะบัญชีผู้ใช้ Telegram (ไม่ใช่บอต) ผ่าน MTProto โดยใช้ Telethon แต่ละบัญชีจะอยู่ในพื้นที่ทำงานของตัวเอง (เรียกว่า workspace ใน API และเครื่องมือบรรทัดคำสั่ง) พร้อมด้วยเซสชัน แหล่งข้อมูล บันทึก และกุญแจลงนามของตัวเอง
ไฟล์เซสชัน, สตริงเซสชัน และ Auth Keys เป็นข้อมูลการอนุญาตของบัญชี: ผู้ใดก็ตาม ที่ถือข้อมูลเหล่านี้สามารถดำเนินการในนามบัญชีนั้นได้ แต่ข้อมูลเหล่านี้ไม่รวมประวัติข้อความ
[!WARNING] ใช้บัญชีเฉพาะทาง Telegram จะจำกัดและอาจแบนบัญชีอย่างถาวรสำหรับ ปริมาณคำขอที่พิจารณาว่าเกินขีดจำกัด ไม่ว่าลูกค้าหรือวัตถุประสงค์จะเป็นอย่างไร และบันทึก ขีดจำกัดเหล่านั้นเพียงบางส่วนเท่านั้น เชื่อมต่อบัญชีที่เตรียมไว้สำหรับการสังเกตการณ์แทนที่จะ ใช้บัญชีส่วนตัวหรือบัญชีที่มีค่าอื่น ๆ และสร้าง API ID / API hash บนบัญชีเฉพาะทาง นั้น
- สรุปโดยย่อ
- ก่อนเริ่ม: API ID และ API hash
- หมายเลขโทรศัพท์ · รหัส QR · Auth Key + DC ID
- ไฟล์บัญชี: Telethon .session · Pyrogram .session · คู่ Session + JSON · TData · StringSession · กุญแจ Auth และ DC ในบรรทัดเดียว · JSON ของบัญชี
- ระบุสิ่งที่คุณมี · รูปแบบที่ไม่รองรับ
- หลายบัญชี · การรักษาความปลอดภัยของไฟล์บัญชี · การแก้ไขปัญหา
สรุปโดยย่อ#
| สิ่งที่คุณมี | แท็บในส่วน "เพิ่มบัญชี" | คุณยังจำเป็นต้อง |
|---|---|---|
| หมายเลขโทรศัพท์และสิทธิ์การเข้าถึงรหัสเข้าสู่ระบบ | โทรศัพท์ | รหัสผ่าน 2FA หากเปิดใช้งาน |
| Telegram เปิดอยู่บนอุปกรณ์อื่น | QR code | รหัสผ่าน 2FA หากเปิดใช้งาน |
ไฟล์.session (Telethon หรือ Pyrogram) |
ไฟล์ | ไฟล์ JSON เสริม (ไม่บังคับ) สำหรับการตั้งค่าแอปพลิเคชัน |
.session + .json ที่มีชื่อเดียวกัน |
ไฟล์ (เลือกทั้งสอง) | โดยทั่วไปไม่มีเนื้อหาอื่นใด |
โฟลเดอร์tdata บน Telegram Desktop |
ไฟล์ (ในรูปแบบ ZIP) | รหัสผ่านท้องถิ่นบนเดสก์ท็อป หากมีการตั้งไว้ |
Telethon StringSession (text, .txt, .tgwitness-session) |
ไฟล์ | ไม่จำเป็นต้องใช้คู่ API แยกต่างหาก |
กุญแจการยืนยันตัวตน (auth key) และ DC ในบรรทัดเดียว, <512 hex>:<1–5> |
ไฟล์ (วางหรือไฟล์ข้อความ) | ไม่จำเป็นต้องใช้คู่ API แยกต่างหาก |
.json พร้อมด้วยเซสชันหรือกุญแจการยืนยันตัวตน (Auth Key) |
ไฟล์ | ไม่จำเป็นต้องใช้คู่ API แยกต่างหาก |
| กุญแจการยืนยันตัวตน (512 ตัวอักษรเฮกซ์) และหมายเลข DC ของมัน | กุญแจการรับรอง | ID ผู้ใช้ (ไม่บังคับ) |
TgWitness ระบุไฟล์จากเนื้อหา ไม่ใช่จากชื่อไฟล์ การเปลี่ยนชื่อไฟล์ จะไม่ทำให้ไฟล์นั้นถูกแปลงรูปแบบ
ก่อนเริ่ม: API ID และ API hash#
คุณสามารถเข้าสู่ระบบได้โดยไม่ต้องสร้างแอปพลิเคชัน API ของ Telegram หากไม่มีการป้อนคู่กุญแจ
นำเข้า หรือคู่กุญแจที่บันทึกไว้แล้วในพื้นที่ทำงาน TgWitness จะเลือกคู่กุญแจจากกลุ่มคู่กุญแจ API สาธารณะ
50 คู่ที่ติดตั้งมาพร้อมระบบ (tgwitness/api_pool.py), โดยจะให้優先 Telegram Desktop สำหรับการ
เข้าสู่ระบบใหม่ และเก็บคู่ที่บันทึกไว้ก่อน; คู่ที่เหลือจะถูกจัดเรียงแบบสุ่ม หาก Telegram ปฏิเสธคู่
(API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), จะลองคู่ถัดไป,
สูงสุด 8 คู่ต่อครั้งการลงชื่อเข้าใช้; คู่ที่ถูกปฏิเสธจะถูกข้ามไปจนกว่าจะเริ่มต้นใหม่ คู่ที่ใช้ลงชื่อเข้าใช้แล้วจะ
ถูกบันทึกไว้กับบัญชีและใช้ซ้ำสำหรับบัญชีนั้น
คู่ข้อมูลที่สร้างไว้ล่วงหน้าเป็นข้อมูลสาธารณะ: ข้อมูลเหล่านี้ถูกเผยแพร่ในโค้ดโอเพนซอร์สของ Telegram
ทั้งในไคลเอนต์และไลบรารี การใช้ API ID และ API hash เพื่อระบุตัวตนของแอปพลิเคชันต่อ Telegram
และไม่ให้สิทธิ์เข้าถึงข้อมูลบัญชี การลงชื่อเข้าใช้ใช้ระบบการอนุญาตของบัญชีเอง: รหัส
ลงชื่อเข้าใช้และรหัสผ่าน 2FA หรือเซสชันที่บัญชีนั้นได้อนุญาตไว้แล้ว แต่ละ
observation.started บันทึกแต่ละรายการจะระบุคู่ที่ใช้ ดังนั้นคู่ที่สร้างไว้ล่วงหน้าจะถูกบันทึกไว้
สำหรับศาลในลักษณะเดียวกับคู่ของคุณเอง คุณสามารถป้อนคู่ของคุณเองจาก my.telegram.org ได้แทน
จากประสบการณ์ของโครงการ คู่ส่วนตัวใหม่มักทำให้บัญชีส่วนใหญ่ถูกออกจากระบบ ดังนั้นควรใช้คู่ดังกล่าว
เฉพาะเมื่อคดีต้องการแอปพลิเคชันของคุณเอง: สร้างคู่ด้วยบัญชีเฉพาะและ
ป้อนคู่ดังกล่าวก่อนเริ่มการเก็บข้อมูล (ขั้นตอนด้านล่าง)
สำหรับช่องข้อมูลการเชื่อมต่อที่ขาดหายไป ให้ใช้คู่เครื่อง/ระบบปฏิบัติการแบบกำหนดค่าแน่นอนจาก
แคตตาล็อก opentele2 2.0.0 ที่มาพร้อมกับแพ็กเกจ:
Desktop 2040, Android 6, Android X 21724, iOS 10840, macOS 2834, และ Web 2496.
ID การสร้างจากแหล่งต้นของ Android 4 ก็ใช้แคตตาล็อก Android เช่นกัน ตามที่ระบุใน
BuildVars ของ Telegram Android.
Web ตั้งค่าเริ่มต้นเป็น A; หากมีคำต่อท้ายเวอร์ชันแอป K ที่นำเข้ามา หรือแพ็กเกจภาษา macos จะเลือก
K และเวอร์ชัน 0.7.0 จะเลือก Webogram ID แอปพลิเคชันที่ไม่รู้จักจะคงค่าเริ่มต้นของโฮสต์ Telethon
ไว้เสมอ ฟิลด์ที่นำเข้ามาจะมีผลเหนือกว่าเสมอ รวมถึงเวอร์ชันแอปที่เก่ากว่าและแพ็กเกจภาษาที่ว่าง
แคตตาล็อกจะไม่เปลี่ยนแปลง API ID/hash เลย ภาพรวมเวอร์ชันของมันจะ
ได้รับการตรวจสอบอย่างชัดเจน ไม่ใช่การดึงข้อมูลระหว่างการเข้าสู่ระบบ โปรไฟล์ที่บันทึกไว้จะคงความเสถียรหลังการอัปเดต
account.getAuthorizations รายงานข้อมูลเมตาดาต้าการอนุญาตที่ Telegram เก็บไว้; มัน
ไม่ใช่การสะท้อนของ initConnection ใหม่แต่ละครั้ง ให้เปรียบเทียบกับโปรไฟล์ที่ส่งไปจริง
การเชื่อมต่อกับการอนุญาตที่มีอยู่จะไม่ตรวจสอบความถูกต้องของแฮช API ที่เกี่ยวข้อง:
initConnection ส่ง API ID ในขณะที่แฮชถูกใช้ในคำขอเข้าสู่ระบบ
หลังการยืนยันตัวตนด้วยโทรศัพท์ใหม่หรือ QR Code, TgWitness จะขอข้อมูลการตั้งค่า, ศูนย์ข้อมูล (DC) ที่ใกล้ที่สุด,
สถานะออนไลน์, ภาษา (เมื่อแพ็กเกจภาษาไม่ว่าง), การอัปเดตแอป และ
การอัปเดตเงื่อนไขการให้บริการ โดยเว้นระยะเวลาระหว่างคำขอ 0.3–1.5 วินาที การอัปเดตสถานะ
จะหมายเหตุบัญชีว่าออนไลน์ชั่วคราว ลำดับขั้นตอนนี้ทำงานครั้งเดียวเมื่อการเข้าสู่ระบบเสร็จสิ้น
ไม่ใช่เมื่อนำเข้าข้อมูล การเชื่อมต่อใหม่ หรือการเริ่มต้นใหม่ การยืนยันตัวตนจะถูกบันทึกก่อน; การร้องขอที่ล้มเหลว
จะหยุดลำดับขั้นตอนนี้โดยไม่ลองใหม่หรือยกเลิกการเข้าสู่ระบบ ผลลัพธ์จะถูก
บันทึกเป็น account.initialized พร้อมชื่อข้อผิดพลาดแทนเนื้อหาการตอบกลับ
นโยบายของ Telegram เองจะเป็นตัวกำหนดข้อจำกัดของบัญชี
สำหรับ tdesktop
, หาก tz_offset
ขาดหายไป จะใช้ค่า UTC offset ท้องถิ่นของเซิร์ฟเวอร์ ซึ่งถูกปัดเศษ
เป็น 900
วินาที โดยใช้อัลกอริทึม
opentele2
(MIT; ใบอนุญาตใน tgwitness/client_profiles.LICENSE
) ค่านี้จะถูกอัปเดตทุกครั้ง
ที่มีการเชื่อมต่อ เพื่อให้การเปลี่ยนแปลงเวลาออมแสงถูกสะท้อนอย่างถูกต้อง tz_offset
ที่นำเข้ามามีความสำคัญเหนือกว่าบนทุกแพลตฟอร์มและถูกรักษาไว้อย่างแม่นยำ รวมถึงค่าศูนย์ด้วย ส่วนรายการ
initConnection.params
อื่น ๆ จะถูกรักษาไว้
แบบฟอร์มการลงชื่อเข้าใช้ HTTP รับค่าเขตเวลาแบบตัวเลขที่ส่งคืนจากการนำเข้าไฟล์;
ค่าบูลีน ค่าเศษส่วน และค่าออฟเซ็ตที่อยู่นอกช่วงที่รองรับจะถูกปฏิเสธ
เส้นทาง Direct, SOCKS5 และ HTTP CONNECT ใช้ Telethon's ConnectionTcpObfuscated
(MTProto ที่ถูกทำให้ซับซ้อนและย่อ) HTTPS CONNECT ยังคงใช้ TLS ไปยังพร็อกซี และใช้
การขนส่งที่ถูกทำให้ซับซ้อนแบบเดียวกันภายในอุโมงค์ MTProxy ยังคงรักษา
การขนส่งขั้นกลางแบบสุ่มที่จำเป็นและการจัดการข้อมูลลับไว้ การเปลี่ยนเส้นทางใช้
ตัวเลือกเดียวกัน การทำให้ซับซ้อนจะเปลี่ยนการจัดกรอบแพ็กเก็ต แต่ไม่ซ่อนบัญชี
หรือข้อมูลเมตาของไคลเอนต์จาก Telegram และไม่หมายความว่ามีความคุ้มกันต่อข้อจำกัด
After connecting an authorized client, TgWitness checks config, nearest DC,
the current authorization, the reviewed layer baseline, languages, app updates
and terms-of-service updates. These diagnostics run once per client instance,
before collection, and are shown under the connection details with their time.
account.connection_checked records the result without session hashes, IPs,
tokens or API hashes. They never accept terms or install updates. A request
failure or FloodWait stops subsequent requests; a missing result stays unknown.
Local checks can still report their results while network checks are skipped.
With strict chosen chats on, the current
authorization is not requested and that check is shown as skipped.
หลังจากเข้าสู่ระบบและทุกครั้งที่มีการเชื่อมต่อใหม่ TgWitness จะอ่าน
การตั้งค่าเนื้อหาที่ละเอียดอ่อนของบัญชี เมื่อการตั้งค่านี้ถูกปิด และ Telegram อนุญาตให้เปลี่ยนแปลง TgWitness จะเปิดการตั้งค่านี้
เพื่อให้เนื้อหาที่ Telegram ระบุว่ามีความละเอียดอ่อน (18+) ถูกบันทึกไว้ และบันทึกค่า
account.content_settings การตั้งค่านี้เป็นของบัญชีและใช้กับทุก
แอป Telegram การตั้งค่า "Strict chosen chats" จะไม่เปลี่ยนแปลงการตั้งค่านี้; โปรดเปิดการตั้งค่านี้ก่อนเข้าสู่ระบบ
คำขอที่ส่งพร้อมกันเพื่อกู้คืนการเชื่อมต่อของพื้นที่ทำงานหนึ่งจะใช้ไคลเอนต์เดียวกันและ รอจนกว่าการตั้งค่าการเชื่อมต่อจะเสร็จสิ้น หากการตั้งค่าล้มเหลวหรือถูกยกเลิก คำขอถัดไป จะได้รับการปล่อยให้ลองใหม่ หากข้อมูลการรับรองความถูกต้องที่บันทึกไว้ ไคลเอนต์ หรือสถานะการอนุญาต เปลี่ยนแปลงระหว่างการตั้งค่า การตั้งค่าครั้งก่อนจะหยุดลงแทนที่จะรายงานว่าการเชื่อมต่อพร้อมใช้งานแล้ว
การวินิจฉัย FloodWait เก็บรักษาวิธีการ TL ที่ล้มเหลว, ตัวห่อ Takeout/range ใดๆ,
การรอที่เซิร์ฟเวอร์ร้องขอ และเส้นตายที่มีผลในtelegram.backoff
รายละเอียดการเชื่อมต่อแสดงวิธีการและเส้นตายในขณะที่คำขอถูกหยุดชั่วคราว
การวินิจฉัยนี้รวมถึงตัวนับการเรียกจากฝั่งลูกค้าต่อแต่ละวิธีตั้งแต่ลูกค้าดังกล่าว
ถูกสร้างขึ้น; ตัวนับเหล่านี้จะนับการแก้ไขที่อยู่ของ peer ที่ซ้อนกันแยกต่างหาก แต่ไม่นับแพ็กเก็ต
หรือการลองใหม่ภายในของ Telethon ตัวนับปัจจุบันยังมีให้ใช้ได้ในฐานะ
collector.rpc_activity ใน API สถานะ ไม่รวมอาร์กิวเมนต์ของคำขอ ชื่อผู้ใช้
แฮชการเข้าถึง หรือข้อความข้อยกเว้น การวินิจฉัยครั้งสุดท้ายและกำหนดเวลาเต็ม
จะคงอยู่หลังการรีสตาร์ท การรอที่ผ่านมาก่อนหน้าโดยไม่มีบันทึกวิธีการไม่สามารถระบุ
ย้อนหลังได้ ดูข้อจำกัดการส่งออก สำหรับการตรวจสอบแหล่งที่มาและ
ความแตกต่างระหว่างการค้นพบและการเก็บข้อมูลประวัติ
official_app=True หรือ False เป็นตัวบ่งชี้การอนุญาตปัจจุบันของ Telegram ทั้งสอง
ค่านี้ไม่ได้กำหนดว่าบัญชีนั้นถูกจำกัด ถูกเชื่อถือ หรืออยู่ภายใต้การสังเกต
ภาพถ่ายโหมดหลักฐาน account.devices ที่มีอยู่ยังคงเป็นประวัติของทุก
อุปกรณ์ที่ลงชื่อเข้าใช้; ส่วนการวินิจฉัยการเชื่อมต่อเก็บไว้เพียงคำอธิบายของอุปกรณ์ปัจจุบันเท่านั้น
ก่อนการเชื่อมต่อ การตรวจสอบเชิงแนะนำจะเปรียบเทียบแพลตฟอร์ม API แพ็กเกจภาษา รูปแบบของอุปกรณ์/ระบบปฏิบัติการและเวอร์ชันแอป ภาษาท้องถิ่นของระบบมือถือ และชั้นสคีมาจริงของ Telethon กับฐานข้อมูลแคตตาล็อกที่ได้รับการตรวจสอบแล้ว คำเตือนจะปรากฏในบันทึกเซิร์ฟเวอร์ และข้อมูลเมตาดาต้าสถานะบัญชี; คำเตือนเหล่านี้จะไม่แทนที่ค่าที่นำเข้าหรือเปลี่ยนแปลง ชั้นสคีมา ชั้นที่แตกต่างเป็นสัญญาณให้ตรวจสอบความเข้ากันได้; สถานะการเชื่อมต่อของบัญชี เองจะแสดงว่ามันทำงานได้หรือไม่ Telegram กำหนดข้อจำกัดจาก ด้านของตนเอง ไม่ว่าโปรไฟล์ลูกค้าใดจะถูกใช้ สถานะบัญชีที่ ถูกตัดการเชื่อมต่อจะใช้โปรไฟล์ที่บันทึกไว้แทนที่จะสร้างคำอธิบายอุปกรณ์ใหม่
หากต้องการใช้แอปพลิเคชันของคุณเองแทน:
- เปิด my.telegram.org และลงชื่อเข้าใช้ด้วยหมายเลขโทรศัพท์ใดก็ได้ ที่คุณเป็นเจ้าของ รหัสยืนยันจะส่งมาในแอป Telegram ไม่ใช่ผ่าน SMS.
- เลือกเครื่องมือพัฒนา API
- สร้างแอปพลิเคชัน: ชื่อและชื่อสั้น (5–32 ตัวอักษร) ตามต้องการ, แพลตฟอร์ม Desktop. URL และคำอธิบายสามารถทิ้งว่างไว้ได้
- คัดลอก App api_id (ตัวเลข) และ App api_hash (32 ตัวอักษรฐานสิบหก)
ในส่วนแผงควบคุม ให้ใส่ Open API ID + Hash ใต้แบบฟอร์มลงชื่อเข้าใช้ คุณสามารถวางคู่
api_id:api_hash เดียวลงในช่อง API ID และทั้งสองช่องจะถูกกรอกอัตโนมัติ คู่หนึ่งสามารถ
ใช้ได้กับบัญชีทั้งหมดของคุณ หลังจากลงชื่อเข้าใช้สำเร็จ ข้อมูลจะถูกบันทึกและเข้ารหัสไว้
ในพื้นที่ทำงานนั้นเท่านั้น และจะไม่ถูกส่งกลับไปยังเบราว์เซอร์เลย
มีข้อมูลรับรองสามประเภทที่เกี่ยวข้อง:
| ลับ | เปิด | ที่อยู่ |
|---|---|---|
| โทเค็นของแผง | แผงควบคุมเว็บของ TgWitness | panel-token.txt ในไดเรกทอรีข้อมูล หรือ TGWITNESS_TOKEN |
| API ID + hash | ไม่มีเนื้อหาอื่นใดเพิ่มเติม; ใช้เพื่อระบุชื่อแอป | ใช้คู่เครื่องมือที่ติดตั้งมาพร้อมระบบ ตั้งค่าที่นำเข้า หรือสร้างแอปของคุณเองได้ที่ my.telegram.org |
| การอนุญาตบัญชี | บัญชี Telegram | สร้างขึ้นผ่านการเข้าสู่ระบบด้วยโทรศัพท์/QR หรือนำเข้ามาเป็นเซสชัน |
หากต้องเข้าถึง Telegram ผ่านพร็อกซี ให้ตั้งค่าก่อนที่ More tools → Account → Settings → Connection settings → Change connection route
หมายเลขโทรศัพท์#
- เปิด More tools → Account, แท็บ Phone, และป้อนหมายเลขในรูปแบบสากล,
เช่น
+44 7700 900123. ช่องว่างและเครื่องหมายขีดจะถูกตัดออกโดยอัตโนมัติ. - กด "Continue" (ต่อ). API ID + Hash สามารถทิ้งว่างไว้ได้
- ป้อนรหัสที่ Telegram ส่งมา ซึ่งโดยทั่วไปจะส่งไปยังแอป Telegram; Telegram จะตัดสินใจว่าจะส่ง SMS หรือไม่
- หากบัญชีมีการยืนยันสองขั้นตอน ให้ป้อนรหัสผ่านนั้น ไม่ใช่ โทเค็นของแผงควบคุม และไม่ใช่รหัสผ่านของอุปกรณ์
- ตรวจสอบ ID บัญชีที่แสดงขึ้นหลังการเข้าสู่ระบบ แล้วเลือกแหล่งข้อมูล
รหัสเข้าสู่ระบบและรหัสผ่าน 2FA ไม่ถูกบันทึกลงบนดิสก์เลย
รหัส QR#
ใช้ตัวเลือกนี้เมื่อบัญชีได้เข้าสู่ระบบแล้วบนโทรศัพท์หรือคอมพิวเตอร์เครื่องอื่น
- คลิกที่ QR code → แสดง QR code. API ID + Hash สามารถทิ้งว่างไว้ได้
- บนอุปกรณ์ที่ลงชื่อเข้าใช้แล้ว: การตั้งค่า → อุปกรณ์ → เชื่อมต่ออุปกรณ์เดสก์ท็อป, สแกนรหัส และยืนยัน
- กรุณาป้อนรหัสผ่าน 2FA ใน TgWitness หาก Telegram ขอให้ป้อน
ภาพ QR ถูกสร้างขึ้นในเครื่องท้องถิ่น รหัสมีอายุการใช้งานจำกัด; คลิก "สร้างรหัส QR อีกครั้ง" เพื่อลองใหม่ การล็อกหน้าต่าง การเปลี่ยนพื้นที่ทำงาน หรือการเข้าสู่ระบบด้วยบัญชีอื่น จะทำให้ รหัสที่ยังไม่ถูกใช้ถูกยกเลิก
Auth Key + DC ID#
Auth Key คือรหัสอนุญาตดิบขนาด 256 ไบต์ที่อยู่เบื้องหลังทุกเซสชัน Telegram ซึ่งเขียน เป็นตัวเลขฐานสิบหก 512 ตัว พร้อมด้วยหมายเลขศูนย์ข้อมูล DC 1–5
- แท็บ "Auth key" (กุญแจการยืนยันตัวตน). วางกุญแจทั้งหมดลงไป; กุญแจที่ถูกตัดสั้นลงซึ่งมีตัวอักษร
…จะไม่สามารถใช้งานได้ - เลือก DC ID ที่มาพร้อมกับกุญแจ
- สามารถป้อน ID ผู้ใช้ได้ (ไม่บังคับ) TgWitness จะปฏิเสธการเชื่อมต่อหาก Telegram รายงาน บัญชีที่ต่างออกไป
- บัญชี Press Connect.
Auth Key (512 ตัวอักษร) ไม่ใช่ API hash (32 ตัวอักษร) กุญแจเดียวกันนี้ยังสามารถ นำเข้าในรูปแบบ JSON ได้ ดู Account JSON
ไฟล์บัญชี#
เปิด เพิ่มบัญชี → ไฟล์ และเลือกไฟล์ได้สูงสุด 4 ไฟล์จากบัญชีเดียว รวมขนาด 8 MiB กด ตรวจสอบไฟล์ แล้วกด เชื่อมต่อบัญชี การเลือกไฟล์หรือ การวางข้อความเซสชันจะไม่ส่งข้อมูลใดๆ; การกด ตรวจสอบไฟล์ จะส่งไฟล์เหล่านั้นไปยังเซิร์ฟเวอร์ TgWitness ของคุณ ซึ่งจะอ่านไฟล์เหล่านั้นโดยไม่ต้องลงชื่อเข้าใช้ และแสดงเซสชันที่พบ
The ไฟล์, กุญแจการรับรอง และแบบฟอร์มการนำเข้าแบบกลุ่มจะแสดงคำเตือนเกี่ยวกับเซสชันคู่ขนาน ก่อนการเชื่อมต่อ โดยค่าเริ่มต้น การอนุญาตที่นำเข้าจะถูกใช้ซ้ำ ให้ปิด ไคลเอนต์ต้นฉบับไว้ขณะที่คีย์ของมันกำลังถูกใช้ที่นี่ ไฟล์ และ กุญแจการรับรอง ยังเสนอ สร้างการอนุญาตแบบอิสระ, ซึ่งอธิบายไว้ด้านล่าง การนำเข้าแบบกลุ่มยังคงใช้ โหมดโดยตรง การเข้าสู่ระบบผ่านโทรศัพท์และ QR แบบโต้ตอบจะสร้างการอนุญาตแยกต่างหาก หัวข้อคำเตือนจะยังคงแสดงอยู่ในแบบฟอร์มการนำเข้า; คำอธิบายเต็มจะเปิด อัตโนมัติเมื่อมีการส่งไฟล์หรือคีย์/สตริงเซสชัน สามารถพับได้ หลังจากอ่านแล้ว เพื่อให้ตัวเลือกไฟล์และตัวควบคุมการเชื่อมต่อยังคงใช้งานได้บนโทรศัพท์
An attested deployment (Phala Cloud, Intel TDX) does not collect on an imported key. There, Files and Auth key connect only with Create an independent authorization selected; bulk import is refused. Phone and QR login work as usual.
- ไฟล์จะถูกแปลงในหน่วยความจำบนเซิร์ฟเวอร์ TgWitness ของคุณ การอัปโหลดจะไม่ถูกเก็บไว้ ไฟล์ ZIP จะไม่ถูกแตกออกสู่ดิสก์ และไม่มีการติดต่อกับบริการภายนอกใดๆ
- เซสชันที่ได้มาจะถูกตรวจสอบกับ Telegram หากไฟล์ระบุ ID ผู้ใช้ มันต้องตรงกับบัญชีที่ Telegram รายงาน
- ไฟล์ที่อธิบายบัญชีต่าง ๆ หรือข้อมูลรับรอง API ต่าง ๆ จะถูกปฏิเสธ แทนที่จะเลือกเพียงหนึ่งรายการ
- รหัสผ่านหรือข้อความเซสชันเก็บข้อมูลในช่องรหัสผ่านท้องถิ่น TData ซึ่งเป็นช่องสำหรับวาง StringSession และอ่านไฟล์โดยไม่ต้องลงชื่อเข้าใช้ (กรอกแบบฟอร์มโดยไม่ ติดต่อกับ Telegram) การวาง StringSession จะลบไฟล์ที่เลือกไว้ และการเลือก ไฟล์จะลบข้อความที่วางไว้ ดังนั้น การตรวจสอบและการเชื่อมต่อจะใช้ตัวเลือกล่าสุด หลังจากเปลี่ยนรหัสผ่าน ให้กด ตรวจสอบไฟล์ อีกครั้ง
สร้างระบบการอนุญาตที่อิสระ#
เลือก สร้างการอนุญาตอิสระ ก่อนเชื่อมต่อไฟล์ที่นำเข้า หรือ กุญแจการอนุญาต (Auth Key)TgWitness จะเชื่อมต่อกับผู้บริจาคที่นำเข้าอย่างชั่วคราว ใช้ผู้บริจาคดังกล่าวเพื่ออนุมัติ โทเค็นการเข้าสู่ระบบ QR ของลูกค้าใหม่ และตัดการเชื่อมต่อกับผู้บริจาคทันทีหลังการอนุมัติ ลูกค้าใหม่จะมีกุญแจการอนุญาตของตัวเองและโปรไฟล์ Desktop ที่เลือกแยกต่างหาก ข้อมูลรับรอง API และโปรไฟล์อุปกรณ์ที่ผู้บริจาคให้มาจะถูกใช้เฉพาะ สำหรับการเชื่อมต่อกับผู้บริจาคเท่านั้น การอนุญาตที่มีอยู่จะไม่ถูกออกจากระบบหรือถูกเพิกถอน
ในขั้นตอนนี้ ให้ปิดแอปพลิเคชันต้นฉบับของผู้บริจาคอย่างสมบูรณ์ การเชื่อมต่อ ครั้งแรกยังคงใช้กุญแจที่คัดลอกมา ดังนั้นโหมดนี้จึงไม่สามารถขจัดความเสี่ยง จากการใช้งานพร้อมกันในครั้งแรกได้ เมื่อการอนุญาตใหม่ถูกเชื่อมต่อแล้ว เจ้าของสามารถเปิด แอปพลิเคชันต้นฉบับอีกครั้งและใช้งานทั้งสองพร้อมกันได้ การเข้าสู่ระบบด้วยรหัส QR แบบโต้ตอบช่วยให้ ลูกค้าเดิมสามารถอนุมัติการเข้าสู่ระบบได้โดยไม่ต้องคัดลอกหรือเชื่อมต่อกุญแจของตนที่นี่
อย่าออกจากระบบหรือปิดเซสชันของผู้บริจาค เมื่อเซสชันที่อนุมัติการเข้าสู่ระบบด้วย QR
สิ้นสุดลง Telegram ก็จะปิดเซสชันที่มันอนุมัติไปด้วย; ในการทดสอบแบบเรียลไทม์ การ
อนุมัติใหม่จะหยุดลงภายในหนึ่งวินาทีหลังจากผู้บริจาคออกจากระบบ ระบบนำเข้าจะบันทึก
เซสชันของผู้บริจาค (session_origin.approved_by: อุปกรณ์, API ID และเวลาสร้าง)
รายการเซสชันจะหมายเหตุไว้, End session จะปฏิเสธมัน, ส่วน End all other sessions
และ Make this the only session จะทำให้ผู้บริจาคยังคงอยู่ในสถานะลงชื่อเข้าใช้
หาก Telegram ขอใช้การยืนยันสองขั้นตอน (2FA) โหมดนี้จะใช้ twoFA จากไฟล์ JSON ที่เลือกไว้ หากมี
หรือจะขอรหัสผ่าน หากรหัสผ่านที่นำเข้าถูกปฏิเสธ ระบบจะกลับไปยังแบบฟอร์มรหัสผ่าน
รหัสผ่านจะไม่ถูกบันทึกไว้ รหัสผ่านที่เสนอจะถูกบันทึกไว้ในรูปแบบเข้ารหัสใน
independent_login.enc, รวมถึงการเปลี่ยนแปลงระหว่างการย้ายศูนย์ข้อมูล หลังจาก
เกิดการหยุดชะงัก ให้เลือกผู้บริจาคเดิมและตัวเลือกนี้เพื่อต่อการใช้คีย์ผู้สมัครที่บันทึกไว้
ผู้บริจาคจะถูกตรวจสอบกับ help.getAppConfig ก่อนการอนุมัติ; บัญชีที่ถูกระงับ
จะหยุดที่นั่น หาก Telegram ปฏิเสธผู้บริจาคก่อนอนุมัติการเข้าสู่ระบบ กุญแจผู้สมัคร
ที่ยังไม่ได้รับการอนุมัติจะถูกทิ้งไป และกระบวนการนำเข้าสามารถเริ่มต้นใหม่ได้ ผู้บริจาคอื่นจะแทนที่
ผู้สมัครที่บันทึกไว้เฉพาะเมื่อ Telegram รายงานว่าผู้สมัครนั้นยังไม่ได้เข้าสู่ระบบ; ผู้สมัคร
ที่เข้าสู่ระบบแล้วหรือกำลังรอรหัสผ่าน 2FA จะถูกเก็บไว้
พื้นที่ทำงานยังคงถูกจองไว้สำหรับบัญชีนั้น; การดำเนินการที่ล้มเหลวจะไม่ลบ
พื้นที่ทำงานใหม่ ให้เก็บไดเรกทอรีข้อมูลและกุญแจ vault ของมันไว้ ข้อมูลประจำตัวสุดท้ายและ
account.authorized บันทึกใน journal จะรวมถึงวิธีการนำเข้า รูปแบบข้อมูลที่ป้อนเข้า และ
ID API ของผู้บริจาค โดยไม่รวมกุญแจหรือรหัสผ่านของผู้บริจาค
เมื่อวันที่5 พฤศจิกายน2026 บัญชีเฉพาะได้ผ่านการตรวจสอบแบบเรียลไทม์กับผู้บริจาค Telethon, Pyrogram และ TData: การเสร็จสิ้นการยืนยันตัวตนสองขั้นตอน (2FA), กุญแจการอนุญาตใหม่ที่ไม่ซ้ำกัน, การเข้าถึงพร้อมกัน โดยผู้บริจาคและลูกค้าใหม่, และการอ่านช่องสาธารณะ กรณี Telethon ยัง ได้ดำเนินการต่อจากผู้สมัครที่บันทึกไว้หลังจากเกิดการขัดจังหวะในขั้นตอนการป้อนรหัสผ่าน การอนุญาตใหม่แต่ละครั้ง ได้เสร็จสิ้นคำขอการเริ่มต้นระบบหกขั้นตอนหลังการเข้าสู่ระบบ และบันทึก ที่ลงนามแล้วได้รับการตรวจสอบแล้ว เซสชันเดิมยังคงใช้งานได้ในทั้งสี่รูปแบบที่จัดเตรียมไว้
ฐานข้อมูลข้อผิดพลาด RPC ของ Telegram เชื่อมโยง
FRESH_CHANGE_ADMINS_FORBIDDEN กับการเปลี่ยนผู้ดูแลระบบ, FRESH_CHANGE_PHONE_FORBIDDEN
กับการเปลี่ยนหมายเลขโทรศัพท์, และ FRESH_RESET_AUTHORISATION_FORBIDDEN กับ
การเพิกถอนเซสชันอื่น ๆ, การเปลี่ยนระยะเวลาการใช้งาน หรือการลงทะเบียนรหัสผ่าน
SESSION_TOO_FRESH_* และ PASSWORD_TOO_FRESH_* เกี่ยวข้องกับการโอนสิทธิ์การเป็นเจ้าของและ
การถอนเงินรายได้หรือของขวัญ นี่ไม่ใช่การดำเนินการเก็บรวบรวมข้อมูล; การเข้าสู่ระบบใหม่
ไม่ได้หมายความว่าจะมีการห้ามอ่านข้อมูลแบบครอบคลุมเป็นเวลา 24 ชั่วโมง การส่งออกข้อมูลสามารถส่งคืน
TAKEOUT_INIT_DELAY_* แยกต่างหากได้ TgWitness เก็บข้อมูลการหยุดชั่วคราวที่เซิร์ฟเวอร์ร้องขอไว้ และไม่พยายาม
รับโทเค็นใหม่โดยอัตโนมัติหรือยกเลิกเซสชันเพื่อหลีกเลี่ยงข้อจำกัด
เครื่องมือเพิ่มเติม → บัญชี → ความปลอดภัยของบัญชี → เซสชันของบัญชีนี้ → ยุติเซสชันอื่นทั้งหมด เรียกใช้ auth.resetAuthorizations ตาม
คำขอของผู้ดำเนินการ และบันทึก account.all_other_sessions_terminated พร้อมด้วย
จำนวนเซสชันก่อนและหลัง Telegram จะยอมรับการนี้จากเซสชันที่ลงชื่อเข้าใช้มาแล้ว 24 ชั่วโมง
เมื่อพื้นที่ทำงานนี้เข้าสู่ระบบด้วย QR จากเซสชันที่นำเข้า เซสชันที่อนุมัติการเข้าสู่ระบบนั้น
จะยังคงเข้าสู่ระบบอยู่: TgWitness จะยุติเซสชันอื่น ๆ ทีละเซสชันด้วย account.resetAuthorization และ
บันทึก kept_approving_session ให้เซสชันนี้เป็นเซสชันเดียว จากนั้นยุติระบบด้วยเหตุผลนั้น
และไม่เปลี่ยนรหัสผ่าน
ตั้งค่าให้เซสชันนี้เป็นเซสชันเดียวที่ดำเนินการเช่นเดียวกันสำหรับกุญแจที่สร้างขึ้นจากการลงชื่อเข้าใช้จากพื้นที่ทำงานนี้ แล้วเปิดใช้งานรหัสผ่านสองขั้นตอนหากบัญชีนั้นยังไม่มี รหัสผ่านดังกล่าวจะแสดงขึ้นบนแผงควบคุมเพียงครั้งเดียว; TgWitness จะเก็บรักษารหัสผ่านนั้นไว้ในคลังข้อมูลของพื้นที่ทำงานเพียงจนถึงตอนนั้นเท่านั้น บันทึกจะบันทึก session.exclusive_from. หาก Telegram แสดงเซสชันอื่นในภายหลัง บันทึกในวารสารจะบันทึก session.exclusive_ended และแผงควบคุมจะแจ้งเตือน ผู้ตรวจสอบจะพิมพ์ทั้งสองอย่าง
การตั้งค่าให้เซสชันนี้เป็นเซสชันเดียวเมื่อ Telegram อนุญาต คือการดำเนินการเดียวกันตามตัวจับเวลา ตัวเลือก
นี้จะปรากฏในส่วน Sessions ของบัญชีนี้ สำหรับคีย์ที่สร้างในพื้นที่ทำงานนี้ และถูก
บันทึกเป็น session.exclusive_automatic ระหว่างการสังเกต ผู้รวบรวมจะตรวจสอบทุก 5
นาทีว่าได้ผ่าน 24 ชั่วโมงแล้วหรือไม่ นับตั้งแต่บันทึก account.authorized ของคีย์นั้น —
Telegram จะตอบกลับ FRESH_RESET_AUTHORISATION_FORBIDDEN ก่อนถึงเวลาดังกล่าว — จากนั้นจึงดำเนินการ
เดียวกันหนึ่งครั้ง ความสำเร็จจะถูกบันทึกเป็น session.exclusive_from เช่นเดียวกับปุ่มแบบแมนนวล
การปฏิเสธจะถูกบันทึกครั้งเดียวเป็น session.exclusive_postponed พร้อมเหตุผลจาก Telegram และ
ตัวเก็บข้อมูลจะลองใหม่ด้วยช่วงเวลาที่เพิ่มขึ้นจนถึงสูงสุดหกชั่วโมง โหมดอ่านอย่างเดียวไม่มีผลในกรณีนี้:
การปิดเซสชันเป็นมาตรการรักษาความปลอดภัยของบัญชี ไม่ใช่การดำเนินการในแชท
รหัสผ่านสองขั้นตอนที่สร้างขึ้นโดยระบบอัตโนมัติจะถูกเก็บไว้ใน vault ของพื้นที่ทำงาน (workspace vault) และเข้ารหัสด้วยกุญแจพื้นที่ทำงาน (workspace key) ก่อนที่ Telegram จะตั้งค่ามัน แผงควบคุมจะดึงรหัสผ่านนี้มาครั้งเดียวจาก POST /api/account/sessions/only/password, ซึ่งจะลบมันออกไป และแสดงมันในกล่องโต้ตอบเดียวกันกับขั้นตอนแบบมือเมื่อคุณเปิด Sessions ของบัญชีนี้ หน้าการเชื่อมต่อจะแจ้งว่ามีรหัสผ่านกำลังรออยู่ รหัสผ่านนี้จะไม่ถูกบันทึกลงในบันทึกและจะคงอยู่แม้หลังการรีสตาร์ท จนกว่าจะถูกแสดง
เซสชันใหม่จะถูกแจ้งเตือนขณะกำลังสังเกตการณ์ด้วย: เมื่อรายการเซสชันของ Telegram มีรายการใหม่เพิ่มเข้ามา
บันทึก account.sessions จะตั้งชื่อรายการนั้นภายใต้ added และแผงควบคุมจะแจ้งเตือนพร้อม
ข้อมูลอุปกรณ์ แอปพลิเคชัน และประเทศจากภาพถ่ายนั้น
การตรวจสอบพยาน#
เครื่องมือเพิ่มเติม → บัญชี → ความปลอดภัยของบัญชี → Witness probe ตรวจสอบว่าลูกค้าอื่นรับ การอัปเดตของบัญชีนี้หรือไม่ เพิ่มพื้นที่ทำงานที่สองที่ลงชื่อเข้าใช้ด้วยบัญชี Telegram ที่ต่างกันและ กุญแจเซสชันของตัวเอง สร้างกลุ่มส่วนตัวด้วยบัญชีทั้งสอง จากนั้นเลือกกลุ่มนั้นเป็น Probe chat และพื้นที่ทำงานที่สองเป็น Witness workspace แล้วเปิด Probe ขึ้น ทั้งสองบัญชี ต้องปิดโหมดอ่านอย่างเดียว (Read-only off) และพื้นที่ทำงานของ Witness ต้องอยู่ในสถานะสังเกตการณ์
ระหว่างการสังเกตพื้นที่ทำงานนี้จะส่ง probe:<n>:<token> เข้าสู่กลุ่มทุก 60–120 วินาที
และบันทึก probe.sent ผู้เป็นพยานจะตอบกลับด้วย ack:<n>:<token> และบันทึก probe.seen และ
probe.ack_sent การยืนยัน (ack) ที่ถึงเซสชันนี้ในฐานะการอัปเดตแบบเรียลไทม์ภายใน 20 วินาทีจะ
ถูกบันทึกเป็น probe.acked หากไม่เป็นเช่นนั้น พื้นที่ทำงานจะอ่านประวัติล่าสุดของกลุ่ม การตอบรับ (ack)
ที่พบในประวัติแต่ไม่ถูกส่งแบบสดจะถูกบันทึกเป็น coverage.gap ด้วยเหตุผล
probe_ack_missed_live: แผงควบคุมจะส่งสัญญาณเตือนและทำเครื่องหมายการรับเหตุการณ์ว่าล้มเหลวจนกว่า
การตอบรับ (ack) ในภายหลังจะมาถึงแบบสด (connection.restored, เหตุผล probe_ack_live) ไม่มีการบันทึกการตอบรับ (ack) เป็น
probe.unanswered; การขัดจังหวะการเชื่อมต่อระหว่างการรอหรือประวัติที่อ่านไม่ได้จะถูกบันทึกเป็น
probe.inconclusive การอ่านอย่างเดียว ข้อจำกัดของ Telegram และการหยุดชั่วคราวของ FloodWait จะถูกบันทึกเพียงครั้งเดียว
เป็น probe.skipped
Telethon .session#
| TgWitness คืออะไร | ฐานข้อมูล SQLite ที่เครื่องมือบน Telethon สร้างขึ้น เช่น my_account.session |
| ได้รับการยอมรับจาก | ตารางsessions (ร่วมกับdc_id, server_address, port, auth_key) และversion = 7 หรือ 8 |
| ข้อกำหนด | มีแถวเซสชันที่ได้รับอนุญาตเพียงหนึ่งแถวเท่านั้น; ฐานข้อมูลที่ปิดและสมบูรณ์ |
ปิดโปรแกรมที่สร้างไฟล์นั้นก่อน หากมีไฟล์ my_account.session-journal หรือ
my_account.session-wal อยู่ข้างๆ หมายความว่าฐานข้อมูลยังไม่เสร็จสมบูรณ์: เปิดและ
ปิดโปรแกรมไคลเอนต์ต้นฉบับอย่างถูกต้อง การลบไฟล์ sidecar เหล่านั้นอาจทำให้เหลือสำเนาที่เสียหาย
Pyrogram .session#
| TgWitness คืออะไร | เครื่องมือที่สร้างขึ้นบน Pyrogram สำหรับฐานข้อมูล SQLite |
| ได้รับการยอมรับจาก | ตารางsessions กับ dc_id, auth_key, test_mode, user_id, is_bot; version = 2 หรือ 3 |
| ข้อกำหนด | อนุญาตให้มีการใช้งานเพียงหนึ่งเซสชันของผู้ใช้ที่ได้รับอนุญาตบนเครือข่ายการผลิตเท่านั้น เซสชันของบอทและเซสชัน test-DC จะถูกปฏิเสธ |
ID ผู้ใช้ที่เก็บไว้จะถูกตรวจสอบกับ Telegram ระหว่างการเข้าสู่ระบบ
คู่ Session + JSON#
บัญชีมักถูกแจกจ่ายเป็นสองไฟล์ที่มีชื่อเดียวกัน เช่น
447700900123.session และ 447700900123.json ให้เลือกทั้งสองไฟล์พร้อมกัน
- จากไฟล์ JSON TgWitness ใช้
app_id/api_idและapp_hash/api_hashดังนั้นคุณ โดยทั่วไปไม่จำเป็นต้องป้อนข้อมูลรับรอง API - โปรไฟล์การเชื่อมต่อใช้
device_model(ชื่อเรียกอีกอย่างคือdevice),system_version(ชื่อเรียกอีกอย่างคือsdk),app_version,lang_code,system_lang_code(ชื่อเรียกอีกอย่างคือsystem_lang_pack),lang_packและtz_offset(ตัวเลือกเสริม) (วินาทีจาก UTC, -43200 ถึง 50400) ค่าที่ระบุไว้มีลำดับความสำคัญสูงกว่าค่าเริ่มต้นที่ระบบสร้างขึ้นและภาษาของ แผงควบคุม/เบราว์เซอร์ ชื่อเรียกที่ขัดแย้งกันจะถูกปฏิเสธ โปรไฟล์ที่แก้ไขแล้วจะถูกบันทึกไว้ใน ข้อมูลรับรองพื้นที่ทำงานที่เข้ารหัส และถูกนำกลับมาใช้ใหม่หลังการรีสตาร์ท รวมถึงเวอร์ชันของแอปด้วย phone, การตั้งค่าพร็อกซี และโทเค็นอุปกรณ์จะถูกเพิกเฉยtwoFAเป็นแบบอ่านอย่างเดียว เมื่อเลือก สร้างการอนุญาตแบบอิสระ; การนำเข้าโดยตรงจะเพิกเฉยมัน- JSON ที่ไม่มีสนามการอนุญาตที่ได้รับการสนับสนุนจะเป็นเพียงข้อมูลเมตาเท่านั้น ให้เพิ่มไฟล์เซสชัน หรือดำเนินการต่อด้วยการเข้าสู่ระบบผ่านโทรศัพท์หรือ QR Code JSON ที่มีเซสชันที่ได้รับการสนับสนุนหรือ Auth Key สามารถทำการอนุญาตได้ด้วยตัวเอง; ดู Account JSON.
Telegram Desktop (TData)#
TData คือโฟลเดอร์tdata ของแอปพลิเคชัน Telegram Desktop (แอปข้ามแพลตฟอร์ม
จาก desktop.telegram.org)
| ระบบ | ตำแหน่งtdata ตามค่าเริ่มต้น |
|---|---|
| Windows | %APPDATA%\Telegram Desktop\tdata (Telegram แบบพกพา: อยู่ข้าง Telegram.exe) |
| Linux | ~/.local/share/TelegramDesktop/tdata |
| macOS | ~/Library/Application Support/Telegram Desktop/tdata |
เพื่อนำเข้า:
คำเตือนเกี่ยวกับเซสชันคู่ขนาน การนำเข้า TData โดยตรงจะใช้กุญแจการอนุญาตของ Telegram Desktop ซ้ำกัน อย่าใช้กุญแจนั้นใน Desktop และ TgWitness พร้อมกัน Telegram อาจทำให้การอนุญาตเป็นโมฆะด้วย
AUTH_KEY_DUPLICATEDทำให้ทั้งสองสำเนาไม่สามารถใช้งานได้จนกว่าจะเข้าสู่ระบบใหม่ปิด Desktop อย่างสมบูรณ์ รวมถึงกระบวนการในถาดระบบ และรักษาสำเนาดังกล่าวให้ปิดอยู่ระหว่างที่ TgWitness ใช้เซสชันที่นำเข้า ปิดโปรแกรมเท่านั้น อย่าออกจากระบบหรือยกเลิกเซสชัน: การยกเลิกจะทำให้สำเนาที่นำเข้าเป็นโมฆะด้วย หากจำเป็นต้องให้ทั้งสองไคลเอนต์ทำงานพร้อมกัน ให้เลือก สร้างการอนุญาตแบบอิสระ และรักษา Desktop ให้ปิดอยู่จนกว่า การเข้าสู่ระบบใหม่จะสำเร็จ หรือเข้าสู่ระบบTgWitness ผ่านโทรศัพท์หรือ QR แนะนำให้ใช้ บัญชีเฉพาะ แต่สิ่งนี้ไม่ทำให้การใช้กุญแจที่ถูกโคลนพร้อมกันเป็นปลอดภัย
สิ่งนี้ยังใช้กับไฟล์
.sessionที่นำเข้า ข้อความ StringSession และ Auth Key HEX ลูกค้าอื่น ๆ ที่มีระบบการอนุญาตที่สร้างขึ้นอย่างอิสระสามารถยังคงลงชื่อเข้าใช้ได้ ดูเอกสาร AUTH_KEY_DUPLICATED ของ Telegram
- ปิด Telegram Desktop อย่างสมบูรณ์
-
สร้างไฟล์ 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
ใช้รูปแบบที่ต่างกัน
กุญแจ Auth และ DC ในบรรทัดเดียว#
รายชื่อบัญชีมักมีข้อมูลการอนุญาตแบบดิบในรูปแบบ <512 hexadecimal characters>:<DC id>,
เช่น a1b2…ef:5. วางบรรทัดนั้นใต้ส่วน Passcode หรือ text ของเซสชัน, โหลดมันเป็น
ไฟล์ข้อความ, หรือใส่ลงในช่อง session ของ JSON บัญชี TgWitness
จะแมป DC 1–5 ไปยังที่อยู่การผลิตเดียวกันกับการนำเข้า JSON ของ auth_key + dc_id และ
รายงานรูปแบบเป็น Auth key HEX และ DC. DC หมายเลขอื่นหรือความยาวของกุญแจที่ไม่ตรงกันจะถูกปฏิเสธ
JSON ของบัญชี#
วัตถุ JSON หนึ่งชิ้น ขนาดสูงสุด 64 KiB ในไฟล์ที่มีส่วนท้ายเป็น .json
| Field (ชื่อเรียกอื่น) | ความหมาย |
|---|---|
api_id (app_id) |
ID แอปพลิเคชัน, เป็นจำนวนบวก |
api_hash (app_hash) |
แฮชของแอปพลิเคชัน, 32 ตัวอักษรฐานสิบหก |
string_session (session_string, session_str; session แบบเก่า) |
ข้อความ Telethon StringSession หรือ <512 hexadecimal characters>:<DC id> ไม่ใช่ชื่อไฟล์ |
auth_key (auth_key_hex) + dc_id |
กรอก Auth Key ครบ 512 ตัวอักษร และ DC 1–5 |
user_id (id) |
เป็นตัวเลือก; ตรวจสอบกับ Telegram ก่อนที่จะบันทึกการอนุญาต |
device_model (device) |
คำอธิบายอุปกรณ์เชื่อมต่อ |
system_version (sdk) |
เวอร์ชันระบบปฏิบัติการของอุปกรณ์ที่เชื่อมต่อ |
app_version |
เวอร์ชันแอปพลิเคชันที่ส่งไปยัง Telegram |
lang_code, system_lang_code (system_lang_pack), lang_pack |
ภาษาของไคลเอนต์, ภาษาของระบบ และแพ็กเกจภาษาของไคลเอนต์; lang_pack ที่ว่างเปล่าได้รับอนุญาต |
tz_offset |
ค่า UTC offset (เป็นตัวเลือก) ในหน่วยวินาที ซึ่งส่งมาในinitConnection.params; เป็นสตริงแบบจำนวนเต็มหรือสตริงแบบจำนวนเต็มทศนิยม |
หากมีทั้งชื่อแฝงและชื่อหลัก ทั้งสองต้องตรงกัน สนามเซสชัน Telethon
ที่ระบุอย่างชัดเจนจะมีความสำคัญเหนือกว่า blob session แบบทั่วไปในรูปแบบอื่น หาก
ทั้งสองมีเซสชัน Telethon ที่สามารถระบุได้ ทั้งสองต้องอธิบายการอนุญาตเดียวกัน
หากไม่มีสนามที่ระบุอย่างชัดเจน session ต้องเป็น Telethon StringSession ที่ถูกต้อง หรือเป็นกุญแจการอนุญาต
และ DC ในรูปแบบ <512 hexadecimal characters>:<DC id> ตัวอย่าง:
{ "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 ของบัญชี)
ระบุสิ่งที่คุณมี#
| คุณจะเห็น | นี่คือ | การใช้งาน |
|---|---|---|
*.session; เมื่อเปิดในโปรแกรมแก้ไขข้อความ จะเห็น SQLite format 3 ปรากฏอยู่ด้านบน |
Telethon หรือ Pyrogram SQLite | ไฟล์ (ถูกตรวจพบอัตโนมัติ) |
โฟลเดอร์tdata ที่มีkey_datas |
Telegram Desktop TData | ZIP ไฟล์สองไฟล์ แล้วคลิก "ไฟล์" |
บรรทัดข้อความหนึ่งเริ่มต้นด้วย 1, ~350 ตัวอักษร |
Telethon StringSession | ไฟล์ |
หนึ่งบรรทัดข้อความ 512 characters 0-9a-f ตามด้วย : และตัวเลข 1–5 |
กุญแจ Auth และ DC | ไฟล์, รหัสผ่านกล่อง หรือข้อความเซสชัน |
*.json กับ app_id/app_hash |
ข้อมูลเมตาดาต้าที่เกี่ยวข้อง | ไฟล์ พร้อมทั้งเซสชัน |
*.json กับ auth_key หรือ string_session |
JSON ของบัญชี | ไฟล์ |
512 ตัวอักษร 0-9a-f |
กุญแจการยืนยันตัวตน | กุญแจการรับรอง |
32 ตัวอักษร 0-9a-f |
API hash | API ID + Hash |
td.binlog หรือ db.sqlite จากแอป TDLib |
พื้นที่จัดเก็บ TDLib | ไม่รองรับ |
123456789:AA… |
โทเค็นบอท | ไม่รองรับ |
รูปแบบที่ไม่รองรับ#
| รูปแบบ | ทางเลือกอื่น |
|---|---|
การเก็บข้อมูล TDLib (td.binlog) และการส่งออกข้อมูล TDLib |
ลงชื่อเข้าใช้ผ่านโทรศัพท์หรือ QR |
| สตริงเซสชันของ Pyrogram | ใช้ไฟล์ Pyrogram .session หรือโทรศัพท์/QR |
| TData พร้อมบัญชีที่เข้าสู่ระบบหลายบัญชี | ออกจากระบบบัญชีอื่น ๆ ใน Telegram Desktop หรือใช้ไฟล์เซสชันของบัญชีแต่ละบัญชี |
| โทเค็นบอท | ไม่รองรับ: TgWitness ทำงานในฐานะบัญชีผู้ใช้ |
| รายชื่อบัญชีจำนวนมากในรูปแบบ CSV/JSON | นำเข้าไฟล์เซสชันที่รองรับผ่าน บัญชี → นำเข้าบัญชี หรือลงชื่อเข้าใช้ด้วยหมายเลขโทรศัพท์/QR ในเวิร์กสเปซแยก |
| Test-DC หรือเซสชันบอท | ใช้บัญชีผู้ใช้ในสภาพแวดล้อมจริง |
หลายบัญชี#
กด + ข้างตัวเลือกรายชื่อผู้ใช้ หรือเปิด เครื่องมือเพิ่มเติม → บัญชี → การตั้งค่า → การตั้งค่าการเชื่อมต่อ → พื้นที่ทำงาน, ป้อนชื่อและ ลงชื่อเข้าใช้
- สามารถสร้างพื้นที่ทำงานได้ไม่จำกัด รวมถึงพื้นที่ทำงานหลัก แต่ละพื้นที่ทำงานมีเซสชัน โปรกซี เส้นทาง แหล่งข้อมูล นโยบายการบันทึก บันทึกหลักฐาน กุญแจลงนาม จุดตรวจสอบ และการส่งออกเป็นของตัวเอง
- การเปลี่ยนพื้นที่ทำงานที่แสดงอยู่จะไม่ทำให้พื้นที่ทำงานอื่น ๆ หยุดทำงาน
- บันทึกจะผูกติดกับบัญชีที่สร้างมันขึ้น การลงชื่อเข้าใช้ด้วย บัญชีอื่นจำเป็นต้องใช้พื้นที่ทำงาน (workspace) อีกหนึ่ง และบัญชีหนึ่งไม่สามารถถูกกำหนดให้ใช้กับ พื้นที่ทำงานสองแห่งได้
- โทเคนบนแผงหลักควบคุมพื้นที่ทำงานทั้งหมด สิทธิ์การเข้าถึงที่มอบให้สามารถจำกัดการเข้าถึงของผู้ใช้อื่นให้เฉพาะบัญชีและแชทที่เลือกไว้ พร้อมด้วยสิทธิ์การเข้าถึงและขีดจำกัดเซสชันที่แยกกัน
- บัญชีจะเปลี่ยนชื่อพื้นที่ทำงานและลบพื้นที่ทำงานที่เพิ่มเข้ามา พร้อมทั้งเซสชัน บันทึก แหล่งข้อมูล และกุญแจลงนาม พื้นที่ทำงานหลักไม่สามารถลบได้จากแผงควบคุม
การนำเข้าแบบกลุ่มและกลุ่มบัญชี#
ใช้ Accounts → Import accounts เพื่อเพิ่มบัญชีหลายบัญชี จับคู่ไฟล์ตามชื่อไฟล์ และดูผลการเข้าสู่ระบบของแต่ละบัญชี บัญชีแต่ละบัญชีจะมีพื้นที่ทำงานของตัวเอง
กลุ่มจะรวมบัญชีที่เกี่ยวข้องไว้ด้วยกันโดยไม่รวมเซสชัน กุญแจ หรือ
หลักฐานของบัญชีเหล่านั้น เปิดกลุ่ม บน บัญชี จะนำคุณไปยังหน้าของมันที่ /groups/<id>:
- บัญชี: เส้นทางการเชื่อมต่อ การสังเกตการณ์ และข้อความล่าสุดของสมาชิกแต่ละคน พร้อมด้วย เริ่มทั้งหมด และ หยุดทั้งหมด
- ต้องตรวจสอบ: บัญชีที่ออกจากระบบแล้ว, ไม่สามารถใช้งานได้ หรือมี ปัญหาด้านการเชื่อมต่อ, การรับข้อมูล, แหล่งข้อมูล หรือสื่อ; ชื่อแต่ละชื่อจะนำไปยังบัตรข้อมูลของบัญชีนั้น
- การสนทนาที่หลายบัญชีสามารถดูได้: แหล่งข้อมูลที่แชร์, บัญชีที่ติดตามการสนทนาเหล่านั้น และ การขัดจังหวะในช่วงเวลาการติดตามในพื้นที่ทำงานที่มีอยู่ (สูงสุด 7 วัน) การส่งออกด้วย N บัญชี จะแบ่งการส่งออกช่องหรือกลุ่มใหญ่ระหว่างบัญชีเหล่านั้น และลงนามในไฟล์เก็บถาวรหนึ่งไฟล์
- ส่งออกกลุ่ม:ZIP หนึ่งอัน พร้อมกับการส่งออกที่ลงนามของแต่ละบัญชีภายใต้
accounts/และmanifest.jsonแสดงรายการSHA-256 และลายนิ้วมือกุญแจ ซึ่งได้รับการลงนามโดยพื้นที่ทำงานหลัก ในmanifest.signature.json. ตรวจสอบไฟล์เก็บถาวรของแต่ละบัญชีแยกกันด้วยpython -m tgwitness.verifyและลายนิ้วมือที่เชื่อถือได้ของบัญชีนั้น
สมาชิกจะแบ่งปันการตั้งค่าของกลุ่ม; แต่บัญชีแต่ละบัญชีสามารถเก็บค่าการตั้งค่าของตัวเองได้ ดูการตั้งค่าที่แบ่งปัน คู่มือการนำเข้าและกลุ่ม และแดชบอร์ดกลุ่มMTProxy
ออกจากระบบ#
เครื่องมือเพิ่มเติม → บัญชี → ออกจาก Telegram (พร้อมหยุดการสังเกตการณ์) จะขอให้ Telegram ยุติ เซสชัน ดังนั้นมันจะหายไปจากเมนู การตั้งค่า → อุปกรณ์ ของบัญชี และลบ เซสชันออกจาก vault ของพื้นที่ทำงาน บันทึก, แหล่งข้อมูล, การตั้งค่า และกุญแจลงนามจะยังคงอยู่ และ บันทึกจะบันทึกการออกจากระบบ พื้นที่ทำงานยังคงเป็นของบัญชีนั้น: เฉพาะ บัญชีนั้นเท่านั้นที่สามารถเชื่อมต่อกับมันได้อีกครั้ง หาก Telegram ไม่ตอบกลับ เซสชันจะยังคงถูกลบ ที่นี่ และแผงควบคุมจะแจ้งให้ทราบ; ให้ปิดเซสชันใน Telegram ที่ การตั้งค่า → อุปกรณ์
เมื่อ Telegram ปิดเซสชัน#
หาก Telegram ห้ามใช้ ระงับ หรือออกจากบัญชี หรือยุติเซสชันจากอุปกรณ์อื่น บันทึก
จะบันทึกสาเหตุ ข้อผิดพลาดของ Telegram เส้นทาง และศูนย์ข้อมูล สถานะ
ของบัญชีจะแสดง ดาวน์โหลดรายงานการสูญเสียบัญชี: ไฟล์ JSON ที่ลงนามแล้ว ซึ่งประกอบด้วยบันทึก
จาก 24 ชั่วโมงก่อนการสูญเสีย ได้แก่ การเชื่อมต่อ เส้นทาง เซสชัน การแจ้งเตือนบัญชี และช่องว่าง
การครอบคลุม โดยแต่ละรายการมีแฮชและลายเซ็นของบันทึก ตรวจสอบด้วย
python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; การส่งออกหลักฐาน
เก็บรักษาโซ่แฮชที่สมบูรณ์ไว้ด้วย นอกจากนี้ ยังสามารถตรวจพบบัญชีที่ถูกระงับได้เมื่อบัญชีดังกล่าวเชื่อมต่อเข้ามาและระหว่างการเฝ้าสังเกตการณ์ โดย
การส่งข้อความและการเข้าร่วมกลุ่มของบัญชีดังกล่าวจะถูกปิดใช้งาน
การรักษาความปลอดภัยของไฟล์บัญชี#
- ให้ปฏิบัติกับทุก
.session, TData ZIP, StringSession, Auth Key และ JSON ของบัญชีเหมือน รหัสผ่าน TgWitness เก็บข้อมูลการอนุญาตที่นำเข้าไว้ในคลังข้อมูลที่เข้ารหัส; คุณสามารถ ลบไฟล์ต้นฉบับได้หลังจากนั้น - อย่าใช้การอนุญาตเดียวกันในสองโปรแกรมพร้อมกัน Telegram อาจเพิกถอนการอนุญาตนั้น
(
AUTH_KEY_DUPLICATED) และทั้งสองโปรแกรมจะหยุดทำงาน - เซสชันที่หมดอายุหรือถูกยกเลิกไม่สามารถฟื้นคืนได้ด้วยการแปลงข้อมูล โปรดเข้าสู่ระบบใหม่
การแก้ไขปัญหา#
| ข้อความหรืออาการ | ขั้นตอนการดำเนินการ |
|---|---|
| ไม่สามารถอ่านเซสชันนี้ได้ ปิดไคลเอนต์ต้นฉบับ… | ไฟล์ SQLite ยังเปิดอยู่หรือยังไม่เสร็จสมบูรณ์ (-journal/-wal sidecar) ปิดโปรแกรมต้นฉบับอย่างถูกต้อง แล้วคัดลอกไฟล์อีกครั้ง |
| สคีมา Telethon SQLite ที่รองรับ: 7 และ 8 / Pyrogram … 2 และ 3 | ไฟล์นี้ถูกสร้างขึ้นโดยเวอร์ชันไลบรารีที่เก่ามากหรือไม่เป็นที่รู้จัก โปรดเข้าสู่ระบบผ่านโทรศัพท์/QR แทน |
| รองรับเฉพาะเซสชันผู้ใช้ที่ได้รับอนุญาตในการสร้างข้อมูลเท่านั้น | ไฟล์ Pyrogram นี้ เป็นของบอทหรือเครือข่ายทดสอบ |
| คลังข้อมูล TData มีจำนวนรายการเกิน 512 รายการ หรือ 32 MiB | ZIP เฉพาะ key_datas และ D877F783D5D3EF8Cs เท่านั้น ไม่ใช่ทั้งโฟลเดอร์ |
| ไม่สามารถถอดรหัส TData ได้ โปรดตรวจสอบรหัสผ่านท้องถิ่นบนเดสก์ท็อป | ป้อนรหัสผ่านท้องถิ่นของ Telegram Desktop ในช่อง "Passcode" หรือ "session text" |
| นำเข้าบัญชี TData ได้ครั้งละหนึ่งบัญชี | Telegram Desktop มีบัญชีหลายบัญชี; ดูส่วน “รูปแบบที่ไม่รองรับ” |
| ไฟล์ที่เลือกมาอธิบายเกี่ยวกับบัญชีต่าง ๆ หรือข้อมูลรับรอง API | เลือกไฟล์จากบัญชีเดียวเท่านั้น |
| JSON ไม่รวมข้อมูลรับรอง API หรือการอนุญาตที่ได้รับการสนับสนุน | ตรวจสอบชื่อฟิลด์ในไฟล์ JSON ของบัญชี |
| เฉพาะข้อมูลเมตาดาต้าของ API เท่านั้น | ไฟล์ JSON ไม่มีเซสชัน โปรดเพิ่มไฟล์ .session หรือใช้หมายเลขโทรศัพท์/QR |
| รหัส Auth Key HEX ต้องประกอบด้วยตัวอักษรฐานสิบหกทั้ง 512 ตัว | กุญแจถูกตัดสั้นหรือมีตัวอักษร… |
| ID บัญชีไม่ตรงกับบัญชีที่นำเข้า | ID ผู้ใช้ของไฟล์นี้แตกต่างจากที่ Telegram รายงาน; ไฟล์นี้ใช้สำหรับบัญชีอื่น |
| บัญชีนี้อยู่ในพื้นที่ทำงานอื่นแล้ว | เปิดพื้นที่ทำงานนั้นแทนที่จะเพิ่มบัญชีสองครั้ง |
| เชื่อมต่อแล้ว แต่กลุ่มส่วนตัวไม่ปรากฏในรายชื่อแชทที่ More tools → Sources | ตรวจสอบสมาชิกภาพ ตัวเลือกจะตรวจสอบการสนทนา 1,000 ครั้งแรก; เพิ่มขีดจำกัดได้ที่ More tools → Parameters. |
| การเชื่อมต่อผ่านพร็อกซีล้มเหลว | ตรวจสอบโหมดเส้นทางและ IP ระบบจะลองใช้ทางเข้าอื่นที่ทำงานได้โดยอัตโนมัติ MTProxy ซ่อนการรอที่อยู่; Direct เป็นทางเลือกสุดท้ายที่สามารถเชื่อมต่อโดยตรงหลังจากช่วงเวลาหน่วงที่กำหนดไว้ ดูโหมดการกำหนดเส้นทาง |
ดูเพิ่มเติม: การเชื่อมต่อและความปลอดภัยสำหรับพร็อกซีและการเข้ารหัส, และวิธีการทำงานของการเก็บข้อมูลสำหรับเนื้อหาที่ถูกบันทึกหลังการลงชื่อเข้าใช้