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

Canonical page: https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/

ลงชื่อเข้าใช้ผ่านโทรศัพท์มือถือ รหัส QR หรือกุญแจการยืนยันตัวตน นำเข้าเซสชันจาก Telethon Pyrogram หรือ Telegram Desktop และจัดการหลายบัญชีได้

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

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

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

- [สรุปโดยย่อ](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#at-a-glance)
- [ก่อนเริ่ม: API ID และ API hash](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#before-you-start-api-id-and-api-hash)
- [หมายเลขโทรศัพท์](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#phone-number) · [รหัส QR](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#qr-code) · [Auth Key + DC ID](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#auth-key--dc-id)
- [ไฟล์บัญชี](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#account-files): [Telethon .session](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#telethon-session) · [Pyrogram .session](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#pyrogram-session) · [คู่ Session + JSON](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#session--json-pair) · [TData](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#telegram-desktop-tdata) · [StringSession](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#telethon-stringsession) · [JSON ของบัญชี](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#account-json)
- [ระบุสิ่งที่คุณมี](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#identify-what-you-have) · [รูปแบบที่ไม่รองรับ](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#unsupported-formats)
- [หลายบัญชี](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#multiple-accounts) · [การรักษาความปลอดภัยของไฟล์บัญชี](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#keeping-account-files-safe) · [การแก้ไขปัญหา](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#troubleshooting)

## สรุปโดยย่อ

| สิ่งที่คุณมี | แท็บในส่วน "**เพิ่มบัญชี"** | คุณยังจำเป็นต้อง |
| --- | --- | --- |
| หมายเลขโทรศัพท์และสิทธิ์การเข้าถึงรหัสเข้าสู่ระบบ | **โทรศัพท์** | รหัสผ่าน 2FA หากเปิดใช้งาน |
| Telegram เปิดอยู่บนอุปกรณ์อื่น | **QR code** | รหัสผ่าน 2FA หากเปิดใช้งาน |
| ไฟล์`.session` (Telethon หรือ Pyrogram) | **ไฟล์** | ไฟล์ JSON เสริม (ไม่บังคับ) สำหรับการตั้งค่าแอปพลิเคชัน |
| `.session` + `.json` ที่มีชื่อเดียวกัน | **ไฟล์** (เลือกทั้งสอง) | โดยทั่วไปไม่มีเนื้อหาอื่นใด |
| โฟลเดอร์`tdata` บน Telegram Desktop | **ไฟล์** (ในรูปแบบ ZIP) | รหัสผ่านท้องถิ่นบนเดสก์ท็อป หากมีการตั้งไว้ |
| Telethon StringSession (text, `.txt`, `.tgwitness-session`) | **ไฟล์** | ไม่จำเป็นต้องใช้คู่ API แยกต่างหาก |
| `.json` พร้อมด้วยเซสชันหรือกุญแจการยืนยันตัวตน (Auth Key) | **ไฟล์** | ไม่จำเป็นต้องใช้คู่ API แยกต่างหาก |
| กุญแจการยืนยันตัวตน (512 ตัวอักษรเฮกซ์) และหมายเลข DC ของมัน | **กุญแจการรับรอง** | ID ผู้ใช้ (ไม่บังคับ) |

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?](https://github.com/phishdestroy/TgWitness/blob/main/docs/PROJECT-GUIDE.md#connect-a-telegram-account)):

1. เปิด [my.telegram.org](https://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** และทั้งสองช่องจะถูกกรอกอัตโนมัติ คู่หนึ่งสามารถ ใช้ได้กับบัญชีทั้งหมดของคุณ หลังจากลงชื่อเข้าใช้สำเร็จ ข้อมูลจะถูกบันทึกและเข้ารหัสไว้ ในพื้นที่ทำงานนั้นเท่านั้น และจะไม่ถูกส่งกลับไปยังเบราว์เซอร์เลย

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

| ลับ | เปิด | ที่อยู่ |
| --- | --- | --- |
| โทเค็นของแผง | แผงควบคุมเว็บของ TgWitness | `panel-token.txt` ในไดเรกทอรีข้อมูล หรือ `TGWITNESS_TOKEN` |
| API ID + hash | ไม่มีเนื้อหาอื่นใดเพิ่มเติม; ใช้เพื่อระบุชื่อแอป | ใช้คู่เครื่องมือที่ติดตั้งมาพร้อมระบบ ตั้งค่าที่นำเข้า หรือสร้างแอปของคุณเองได้ที่ my.telegram.org |
| การอนุญาตบัญชี | บัญชี Telegram | สร้างขึ้นผ่านการเข้าสู่ระบบด้วยโทรศัพท์/QR หรือนำเข้ามาเป็นเซสชัน |

หากต้องเข้าถึง 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](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#account-json)

## ไฟล์บัญชี

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

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

### 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
- สนามอื่น ๆ เช่น `phone`, `device`, `sdk`, `app_version`, `lang_pack` หรือรหัสผ่าน `twoFA` ที่เก็บไว้ จะ**ถูกละเว้น** หากบัญชีมีระบบยืนยันตัวตนสองขั้นตอน (2FA) TgWitness จะขอข้อมูลดังกล่าว
- ไฟล์ JSON เองเป็นเพียงข้อมูลเมตาดาต้าเท่านั้น หากไม่มีไฟล์เซสชัน ให้ดำเนินการต่อด้วยการเข้าสู่ระบบผ่านโทรศัพท์ หรือ QR Code

### 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 กำลังใช้เซสชันที่นำเข้า **ปิดโปรแกรม (Quit) แต่ไม่ต้องออกจากระบบ (log out) หรือยกเลิกเซสชัน:** การยกเลิกเซสชันจะทำให้สำเนาที่นำเข้ามาไม่ถูกต้องด้วย หากต้องการให้ทั้งสองไคลเอนต์ทำงานพร้อมกัน ให้เข้าสู่ระบบ TgWitness ผ่านโทรศัพท์หรือ QR เพื่อสร้างการอนุญาตของตัวเอง แนะนำให้ใช้ บัญชีเฉพาะ แต่การใช้กุญแจที่คัดลอกมาพร้อมกันจะไม่ปลอดภัย
>
>
>
> สิ่งนี้ยังใช้กับไฟล์`.session` ที่นำเข้า ข้อความ StringSession และ Auth Key HEX ลูกค้าอื่น ๆ ที่มีระบบการอนุญาตที่สร้างขึ้นอย่างอิสระสามารถยังคงลงชื่อเข้าใช้ได้ ดู[เอกสาร AUTH_KEY_DUPLICATED ของ Telegram](https://core.telegram.org/api/errors#406-not-acceptable)

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`**

| Field (ชื่อเรียกอื่น) | ความหมาย |
| --- | --- |
| `api_id` (`app_id`) | ID แอปพลิเคชัน, เป็นจำนวนบวก |
| `api_hash` (`app_hash`) | แฮชของแอปพลิเคชัน, 32 ตัวอักษรฐานสิบหก |
| `string_session` (`session_string`, `session`) | ข้อความ Telethon StringSession ไม่ใช่ชื่อไฟล์ |
| `auth_key` (`auth_key_hex`) + `dc_id` | กรอก Auth Key ครบ 512 ตัวอักษร และ DC 1–5 |
| `user_id` (`id`) | เป็นตัวเลือก; ตรวจสอบกับ Telegram ก่อนที่จะบันทึกการอนุญาต |

หากมีทั้งชื่อแฝงและชื่อหลัก ทั้งสองชื่อต้องตรงกัน ตัวอย่าง:

```
{ "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 | **ไฟล์** |
| `*.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) อีกหนึ่ง และบัญชีหนึ่งไม่สามารถถูกกำหนดให้ใช้กับ พื้นที่ทำงานสองแห่งได้
- โทเคนบนแผงหลักควบคุมพื้นที่ทำงานทั้งหมด [สิทธิ์การเข้าถึงที่มอบให้](https://phishdestroy.github.io/TgWitness/th/docs/reference/access/)สามารถจำกัดการเข้าถึงของผู้ใช้อื่นให้เฉพาะบัญชีและแชทที่เลือกไว้ พร้อมด้วยสิทธิ์การเข้าถึงและขีดจำกัดเซสชันที่แยกกัน
- **บัญชี**จะเปลี่ยนชื่อพื้นที่ทำงานและลบพื้นที่ทำงานที่เพิ่มเข้ามา พร้อมทั้งเซสชัน บันทึก แหล่งข้อมูล และกุญแจลงนาม พื้นที่ทำงานหลักไม่สามารถลบได้จากแผงควบคุม

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

ใช้ **บัญชี → นำเข้าบัญชี** เพื่อเพิ่มหลายบัญชี จับคู่ไฟล์ตามชื่อหลัก และดูผลการเข้าสู่ระบบแต่ละครั้ง แต่ละบัญชีมีพื้นที่ทำงานของตนเอง กลุ่มสามารถคัดลอกการตั้งค่าที่เลือกจากต้นแบบได้โดยไม่รวมเซสชัน คีย์ หรือหลักฐานเข้าด้วยกัน ดู[คู่มือการนำเข้าและกลุ่ม](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Accounts.md#import-accounts-and-share-settings)และ[แดชบอร์ดพูล MTProxy](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md#pool-dashboard-and-custom-sources)

## ออกจากระบบ

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

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

| ข้อความหรืออาการ | ขั้นตอนการดำเนินการ |
| --- | --- |
| *ไม่สามารถอ่านเซสชันนี้ได้ ปิดไคลเอนต์ต้นฉบับ…* | ไฟล์ 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 มีบัญชีหลายบัญชี; ดูส่วน [“รูปแบบที่ไม่รองรับ](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#unsupported-formats)” |
| *ไฟล์ที่เลือกมาอธิบายเกี่ยวกับบัญชีต่าง ๆ หรือข้อมูลรับรอง API* | เลือกไฟล์จากบัญชีเดียวเท่านั้น |
| *JSON ไม่รวมข้อมูลรับรอง API หรือการอนุญาตที่ได้รับการสนับสนุน* | ตรวจสอบชื่อฟิลด์ในไฟล์ [JSON ของบัญชี](https://phishdestroy.github.io/TgWitness/th/docs/reference/accounts/#account-json) |
| *เฉพาะข้อมูลเมตาดาต้าของ API เท่านั้น* | ไฟล์ JSON ไม่มีเซสชัน โปรดเพิ่มไฟล์ `.session` หรือใช้หมายเลขโทรศัพท์/QR |
| *รหัส Auth Key HEX ต้องประกอบด้วยตัวอักษรฐานสิบหกทั้ง 512 ตัว* | กุญแจถูกตัดสั้นหรือมีตัวอักษร`…` |
| ID บัญชีไม่ตรงกับบัญชีที่นำเข้า | ID ผู้ใช้ของไฟล์นี้แตกต่างจากที่ Telegram รายงาน; ไฟล์นี้ใช้สำหรับบัญชีอื่น |
| บัญชีนี้อยู่ในพื้นที่ทำงานอื่นแล้ว | เปิดพื้นที่ทำงานนั้นแทนที่จะเพิ่มบัญชีสองครั้ง |
| มีการเชื่อมต่อ แต่กลุ่มส่วนตัวหนึ่งขาดหายไปจากรายชื่อแชทใน**ส่วนแหล่งข้อมูล** | ตรวจสอบสมาชิกภาพ ตัวเลือกจะตรวจสอบการสนทนา 1,000 ครั้งแรก; เพิ่มขีดจำกัดในส่วน **Parameters** |
| การเชื่อมต่อผ่านพร็อกซีล้มเหลว | ตรวจสอบโหมดการกำหนดเส้นทางและโหมด IP โหมด MTProxy อัตโนมัติจะลองใช้ทางเข้าอื่นที่ทำงานได้ โหมดซ่อน IP จะรอ; โหมดสำรองที่เลือกไว้อย่างชัดเจนสามารถเชื่อมต่อโดยตรงหลังจากช่วงเวลาหน่วงที่กำหนดไว้ [ดูโหมดการกำหนดเส้นทาง](https://phishdestroy.github.io/TgWitness/th/docs/reference/connection/#ip-modes) |

ดูเพิ่มเติม: [การเชื่อมต่อและความปลอดภัย](https://phishdestroy.github.io/TgWitness/th/docs/reference/connection/)สำหรับพร็อกซีและการเข้ารหัส, [และวิธีการทำงานของการเก็บ](https://phishdestroy.github.io/TgWitness/th/docs/reference/collection/)ข้อมูลสำหรับเนื้อหาที่ถูกบันทึกหลังการลงชื่อเข้าใช้