# Telegram · ขั้นตอนการทำงานและการดำเนินการ

Canonical page: https://phishdestroy.io/tgwitness/th/docs/reference/operations/

การดำเนินงานประจำวันของแผงควบคุม: โหมดการทำงาน, หมวดหมู่การติดตาม, พารามิเตอร์, การแจ้งเตือน, การส่งออกข้อมูล, การสำรองข้อมูล และขีดความสามารถ

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/th/llms.txt)

Translation coverage: this edition includes material from the English original.

การดำเนินงานประจำวันของแผงควบคุม: โหมดการทำงาน, หมวดหมู่การติดตาม, พารามิเตอร์, การแจ้งเตือน, การส่งออกข้อมูล, การสำรองข้อมูล และขีดความสามารถ

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [เอกสารประกอบ](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [การติดตั้งและกู้คืน](https://phishdestroy.io/tgwitness/th/docs/reference/deployment/)

![การติดตั้งและกู้คืน](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

สำหรับการเชื่อมต่อครั้งแรก ให้[ใช้บัญชีและรูปแบบเซสชัน](https://phishdestroy.io/tgwitness/th/docs/reference/accounts/) เพื่อดูคำอธิบายเกี่ยวกับเวอร์ชันที่บันทึกไว้ นโยบายเหตุการณ์ และช่องว่าง โปรด [ดูวิธีการทำงานของระบบการเก็บข้อมูล](https://phishdestroy.io/tgwitness/th/docs/reference/collection/) คู่มือนี้ครอบคลุมการดำเนินงานประจำวันและการกู้คืนข้อมูล

การติดตั้งแบบจัดการจะรวมถึงไฟล์ **START-HERE.html** และ **START-HERE.txt** ไว้ข้าง โปรแกรมเปิดตัว (launcher) พร้อมด้วยลิงก์ repositori และคำสั่งที่ปรับให้เหมาะสมกับ เส้นทางติดตั้ง (installation path) ของมัน 実行 `tgwitness guide --print` ผ่าน SSH หรือ `tgwitness paths` เพื่อค้นหา ไดเรกทอรีข้อมูลจริง (actual data directory) การติดตั้ง systemd แบบ root จะเก็บสถานะส่วนตัวไว้ภายใต้ `/var/lib/tgwitness-…`; ส่วน `/opt/tgwitness` จะเก็บโปรแกรมไว้

สำหรับอุโมงค์ Cloudflare ชั่วคราวที่ได้รับการจัดการ `tgwitness tunnel off` จะปิดการเข้าถึงสาธารณะ ในขณะที่แผงควบคุมและระบบเก็บข้อมูลท้องถิ่นยังคงทำงานต่อไป `tgwitness tunnel on` เปิดใช้งานอุโมงค์; `tgwitness tunnel restart` สร้างการเชื่อมต่ออุโมงค์ใหม่ ใช้ `tgwitness open` เพื่อดูที่อยู่ปัจจุบันของอุโมงค์ การตั้งค่าปิดอย่างชัดเจนจะคงอยู่ แม้หลังการรีสตาร์ทบริการ `tgwitness stop` หยุดการทำงานของทั้งแผงควบคุมและระบบเก็บข้อมูล

**บนหน้านี้**

- [ขั้นตอนการทำงานของผู้ดำเนินการ](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#operator-workflow)
- [แบ่งปันงานโดยไม่แบ่งปันกุญแจหลัก](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#share-work-without-sharing-the-main-key)
- [โหมดการทำงาน](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#runtime-modes)
- [หมวดหมู่การติดตาม](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#monitoring-categories)
- [การแจ้งเตือน](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#notifications)
- [การจัดวางแผง](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#panel-layout)
- [สภาพแวดล้อมการติดตั้ง](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#deployment-environments)
- [การตรวจสอบเมื่อเริ่มต้นระบบและการส่งออกข้อมูล](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#startup-checks-and-exports)
- [การสำรองข้อมูล การกู้คืนข้อมูล และการหยุดชะงัก](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#backup-restore-and-interruptions)
- [ความจุและการเก็บรักษา](https://phishdestroy.io/tgwitness/th/docs/reference/operations/#capacity-and-retention)

## ขั้นตอนการทำงานของผู้ใช้

แผนผังกระบวนการ · เลือกพื้นที่จัดเก็บและวิธีการปกป้องกุญแจ → เปิดแผงควบคุมด้วยโทเค็นของมัน; เปิดแผงควบคุมด้วยโทเค็นของมัน → เลือกพื้นที่ทำงาน; เลือกพื้นที่ทำงาน → กำหนดเส้นทาง Direct หรือ proxy; กำหนดเส้นทาง Direct หรือ proxy → ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR; ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR → ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้; ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้ → กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบ แล้วเริ่มการติดตาม; กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบ แล้วเริ่มการติดตาม → ติดตามข้อผิดพลาด การเข้าถึง แถวรอ และพื้นที่ดิสก์; ติดตามข้อผิดพลาด การเข้าถึง แถวรอ และพื้นที่ดิสก์ → รักษาจุดตรวจสอบอิสระ; รักษาจุดตรวจสอบอิสระ → ส่งออกและตรวจสอบข้อมูล · เลือกพื้นที่จัดเก็บและวิธีการปกป้องกุญแจ · เปิดแผงควบคุมด้วยโทเค็นของมัน · เลือกพื้นที่ทำงาน · กำหนดเส้นทาง Directหรือ proxy · ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR · ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้ · กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบแล้วเริ่มการติดตาม · ติดตามข้อผิดพลาดการเข้าถึง แถวรอและพื้นที่ดิสก์ · รักษาจุดตรวจสอบอิสระ · ส่งออกและตรวจสอบข้อมูล

**แผนภาพในรูปแบบข้อความ**

1. เลือกพื้นที่จัดเก็บและวิธีการปกป้องกุญแจ → เปิดแผงควบคุมด้วยโทเค็นของมัน
2. เปิดแผงควบคุมด้วยโทเค็นของมัน → เลือกพื้นที่ทำงาน
3. เลือกพื้นที่ทำงาน → กำหนดเส้นทาง Direct หรือ proxy
4. กำหนดเส้นทาง Direct หรือ proxy → ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR
5. ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR → ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้
6. ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้ → กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบ แล้วเริ่มการติดตาม
7. กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบ แล้วเริ่มการติดตาม → ติดตามข้อผิดพลาด การเข้าถึง แถวรอ และพื้นที่ดิสก์
8. ติดตามข้อผิดพลาด การเข้าถึง แถวรอ และพื้นที่ดิสก์ → รักษาจุดตรวจสอบอิสระ
9. รักษาจุดตรวจสอบอิสระ → ส่งออกและตรวจสอบข้อมูล

การอนุญาต การเชื่อมต่อเครือข่าย การเข้าถึงกลุ่ม และความครบถ้วนของการ ส่ง เป็นคุณสมบัติที่ต่างกัน สถานะการเชื่อมต่อสีเขียวไม่ได้หมายความว่าทุก เหตุการณ์ได้ถูกบันทึกไว้แล้ว

## แบ่งปันงานโดยไม่ต้องแบ่งปันกุญแจหลัก

เปิด **More tools → Access** เพื่อมอบโทเค็นส่วนตัวให้กับผู้ตรวจสอบหรือนักวิเคราะห์ เลือกบัญชี และแชทที่พวกเขาสามารถเปิดได้ จากนั้นอนุญาตให้ดู ส่งออก หรือดำเนินการ ผู้ดำเนินการที่เริ่ม/หยุดการเก็บข้อมูลจำเป็นต้องมีสิทธิ์เข้าถึงพื้นที่ทำงานทั้งหมด; ผู้ตรวจสอบ สามารถถูกจำกัดให้เข้าถึงแชทเดียวได้ ข้อจำกัดเซสชัน ระยะเวลาหมดอายุ และกฎ IP เป็นเรื่องที่แยกต่างหาก จากการอนุญาตบัญชี Telegram ดู[การเข้าถึงและสิทธิ์](https://phishdestroy.io/tgwitness/th/docs/reference/access/)

ใช้ "**Open sessions"** เพื่อปิดการเชื่อมต่อ หรือเพิกถอนสิทธิ์การเข้าถึงเพื่อปิด ทุกเซสชันของมัน คอนโซลผู้ดูแลระบบรวมกิจกรรมของกระบวนการปัจจุบันจาก ทุกพื้นที่ทำงาน การปิดเซสชันจะไม่ส่งผลต่อการทำงานของระบบการเก็บข้อมูล

## โหมดการทำงาน

| โหมด | การดำเนินการ | พฤติกรรม |
| --- | --- | --- |
| Demo | scripts\Demo.cmd หรือ `--demo` | ข้อมูลสังเคราะห์; การเชื่อมต่อกับบัญชีจริงถูกปิดใช้งาน |
| ข้อสังเกต | เริ่มการสังเกต | บันทึกการอัปเดตที่ส่งมาสำหรับแหล่งข้อมูลที่เลือกไว้ |
| ภาพรวมประวัติ | แชท → การดำเนินการในแชท → โหลดประวัติ | บันทึกข้อความล่าสุดได้สูงสุด 500 ข้อความ; ไม่มีการสร้างใหม่ของทุกการเปลี่ยนแปลงในอดีต |
| หยุดชั่วคราว | หยุดการสังเกต | หยุดการเก็บข้อมูลในขณะที่ยังคงเก็บข้อมูลและงานที่อยู่ในคิว |
| ตรวจสอบ/ส่งต่อ | การส่งออก | ZIP, JSONL/CSV/HTML, จุดตรวจสอบ, ใบรับการดำเนินการ และคำขอประทับเวลา |
| หลายบัญชี | พื้นที่ทำงาน หรือปุ่ม **+** ด้านบน | สามารถสร้างพื้นที่ทำงานแยกกันได้ไม่จำกัดภายในกระบวนการเดียว |

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

## หมวดหมู่การติดตาม

![การตั้งค่าการติดตามสำหรับแต่ละบัญชีด้วยข้อมูลแหล่งที่มาสังเคราะห์](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c)

ใน **More tools → Sources → Recording → Choose which changes to preserve**, ให้เลือกข้อความใหม่ การแก้ไข การแจ้งเตือนการลบ การอัปเดตปฏิกิริยา และเหตุการณ์สมาชิกอย่างอิสระ ค่าเริ่มต้น จะเก็บรักษาทุกหมวดหมู่ **ข้อความ การแก้ไข และการลบจะ**รักษาบริบทเดิม ในขณะที่ปิดการอัปเดตปฏิกิริยา/สมาชิกแยกกัน **กิจกรรมที่มองเห็นได้ทั้งหมด**จะกู้คืน ทั้งห้าอย่าง การตั้งค่าล่วงหน้าจะเปลี่ยนรูปแบบ; กด **Save recording settings** เพื่อนำไปใช้

นโยบายที่บันทึกไว้จะใช้กับแหล่งข้อมูลทั้งหมดที่เลือกไว้ในพื้นที่ทำงานนั้น ส่วน พื้นที่ทำงานอื่น ๆ จะรักษาการตั้งค่าของตนเองไว้ การเปลี่ยนแปลงแต่ละครั้งจะบันทึกค่าก่อน/หลัง ที่ลงนามไว้; นโยบายปัจจุบันยังถูกรวมไว้ในใบยืนยันกระบวนการและบันทึก การเริ่มต้นการสังเกตการณ์ด้วย การปิดใช้งานหมวดหมู่จะไม่ลบการสังเกตการณ์ก่อนหน้านี้ การเปิดใช้งาน ใหม่จะไม่กู้คืนการเปลี่ยนแปลงที่พลาดไป ในเวอร์ชันนี้ ไม่มีฟังก์ชันการแทนที่หมวดหมู่ตามกลุ่ม

ให้เปิดใช้งานการบันทึกข้อความใหม่เมื่อเนื้อหาเดิมมีความสำคัญ: การแจ้งเตือนการลบไม่สามารถ กู้คืนข้อความที่ไม่เคยถูกบันทึกไว้ได้ บันทึกการดำเนินงาน/การครอบคลุม และเหตุการณ์บริการกลุ่ม อื่นๆ จะถูกเก็บรักษาไว้เสมอ ภาพถ่ายประวัติที่ชัดเจนจะแยกต่างหากจาก การเลือกหมวดหมู่แบบเรียลไทม์ และอาจรวมถึงข้อความบริการด้วย สวิตช์เหล่านี้ไม่ ลบข้อมูลเมตาดาต้าของปฏิกิริยา/สมาชิกที่ฝังอยู่ในวัตถุ Telegram ที่ถูกบันทึกไว้แล้ว

ภาพถ่ายประวัติอาจจัดไฟล์แนบเข้าคิวระหว่างที่ระบบถูกหยุดชั่วคราว ให้เริ่มการสังเกตเพื่อประมวลผล ไฟล์เหล่านั้น การจัดเข้าคิวไม่หมายความว่าไฟล์ได้ถูกดาวน์โหลดแล้ว ไฟล์ต้นฉบับที่ไม่มีอยู่จะไม่ถูกแทนที่ ด้วยเวอร์ชันที่แก้ไขใหม่กว่า; ผลลัพธ์จะถูกบันทึกแยกกัน

การล็อกจะล้างการเข้าถึงเบราว์เซอร์และฟิลด์ลับ แต่ยังคงให้กระบวนการเก็บข้อมูลทำงานต่อไป การปิดแท็บก็ยังคงให้กระบวนการทำงานต่อไปเช่นกัน การหยุดกระบวนการ Python หรือบริการ จะหยุดการเก็บข้อมูลโดยไม่ขึ้นกับสถานะของเบราว์เซอร์

พื้นที่ทำงานเพิ่มเติมสามารถถูกลบได้หลังจากที่ไฟล์ ZIP หรือคอนเทนเนอร์ ASiC-E ที่ได้รับการลงนามแล้ว ซึ่งครอบคลุม บันทึกในสมุดบันทึกและบันทึกใน Case Board ของพื้นที่ทำงานนั้น ได้ถูกดาวน์โหลดมาอย่างครบถ้วนแล้ว การเตรียมไฟล์เก็บถาวรเพียงอย่างเดียว ยังไม่เพียงพอ: หากมีบันทึกที่อยู่นอกเหตุการณ์การตั้งค่า หรือบันทึกที่เพิ่มเข้ามาหลังจากกระบวนการดาวน์โหลดเสร็จสิ้น จะทำให้**ตัวเลือก ลบ** ไม่สามารถใช้งานได้

เมื่อแผงควบคุมรับไฟล์มาเอง มันจะนับการส่งออกก็ต่อเมื่อรับทุก ไบต์แล้ว และจากนั้นจะรายงานขนาดไปยัง `POST /api/exports/{id}/received`; การดาวน์โหลดที่ถูกตัดขาด จะไม่ถูกนับ ด้วยตัวเลือกการบันทึกของเบราว์เซอร์ (File System Access) แผงควบคุมจะรายงานหลังจาก ไฟล์ถูกเขียนและปิดแล้ว หากไม่มีตัวเลือกนี้ แผงควบคุมจะส่งไฟล์ที่รับมาไปยัง ส่วนดาวน์โหลดของเบราว์เซอร์ และไม่สามารถตรวจสอบได้ว่าเบราว์เซอร์เก็บไฟล์นั้นไว้หรือไม่ เช่น เมื่อหน้าต่าง เลือกตำแหน่งบันทึกถูกยกเลิก; แผงควบคุมจะรายงานว่ากระบวนการดาวน์โหลดได้เริ่มต้นแล้ว แต่ไม่ได้รายงานว่าไฟล์ได้ถูกบันทึกแล้ว ไฟล์ ที่เบราว์เซอร์ดาวน์โหลดด้วยตัวเอง (การส่งออกที่มีขนาดใหญ่กว่าบัฟเฟอร์เบราว์เซอร์ของแผงควบคุม) และการ ดาวน์โหลดโดยไคลเอนต์ HTTP อื่น จะถูกนับเมื่อเซิร์ฟเวอร์ส่งการตอบกลับทั้งหมดแล้ว ระบบ ปฏิบัติการและรีเวิร์สพร็อกซีจะบัฟเฟอร์การตอบกลับหลายเมกะไบต์ ดังนั้นสำหรับการ ดาวน์โหลดเหล่านี้ เซิร์ฟเวอร์จึงไม่สามารถตรวจพบการหยุดชะงักใกล้ส่วนท้ายได้ เว้นแต่แผงจะระบุว่าไฟล์ได้ถูกบันทึกแล้ว ให้ตรวจสอบไฟล์ที่ดาวน์โหลดมาก่อนที่จะลบ การส่งออกกลุ่มจะถูกนับสำหรับบัญชีต่าง ๆ เมื่อ ดาวน์โหลดทันทีหลังจากที่เตรียมเสร็จ; การดาวน์โหลดอีกครั้งจาก **Prepared exports** จะไม่นับ

ก่อนการลบ แผงควบคุมจะแสดงรูปแบบ ขนาด เวลาเตรียมการ และ SHA-256 ของไฟล์อาร์ไคฟ์ที่ลงนามและดาวน์โหลดล่าสุด และขอให้ยืนยันว่าไฟล์อาร์ไคฟ์นี้ถูกเก็บไว้นอกพื้นที่ทำงาน เซิร์ฟเวอร์จะปฏิเสธคำสั่ง `DELETE /api/profiles/{id}` หากค่า `kept_copy` ไม่ได้ถูกตั้งค่าให้ตรงกับ SHA-256 ดังกล่าว (หรือตั้งค่าเป็น `confirmed` สำหรับไฟล์ที่ ดาวน์โหลดมาก่อนที่จะบันทึกลายนิ้วมือ)

การลบพื้นที่ทำงานเพิ่มเติมจะหยุดตัวเก็บข้อมูลและลบข้อมูลท้องถิ่นของมัน หาก ไฟล์ถูกล็อกหรือเกิดข้อผิดพลาดในระบบไฟล์จนทำให้การลบถูกขัดจังหวะ แผงควบคุมจะรายงานความล้มเหลวและ ยังคงแสดงพื้นที่ทำงานนั้นว่าไม่สามารถใช้งานได้ (`DeletionPending`) ปิดโปรแกรมที่ถือ ไฟล์ดังกล่าวและลอง**ลบ**อีกครั้ง การเริ่มต้น TgWitness ใหม่จะทำให้พื้นที่ทำงานนั้นยังคงหยุดทำงานอยู่ และ ไม่สร้างบันทึกหรือกุญแจที่ถูกลบไปบางส่วนขึ้นใหม่ การลบที่สำเร็จจะถูกบันทึก เพียงหลังจากที่ไดเรกทอรีถูกลบไปแล้วเท่านั้น; สำเนาที่ส่งออกหรือสำรองข้อมูลไว้แยกต่างหากจะยังคงอยู่ ภายใต้นโยบายการเก็บรักษาข้อมูลของตนเอง

## การแจ้งเตือน

เปิด **Settings → Notifications and off-site copy → Notification destinations** หรือ **More tools → Extras → Notifications → Configure**. TgWitness ใช้ Apprise เพื่อส่งการแจ้งเตือนไปยัง Matrix, Telegram, Discord, Slack, ntfy, email และบริการอื่น ๆ ที่ได้รับการสนับสนุน คุณสามารถเพิ่มจุดหมายปลายทางหลายแห่งไปยังพื้นที่ทำงานเดียวได้

1. ป้อน URL ปลายทาง Apprise หนึ่งรายการต่อบรรทัด ใช้ [แคตตาล็อกบริการและรูปแบบ URL](https://appriseit.com/services/) ที่เหมาะสมกับบริการของคุณ
2. เปิดการแจ้งเตือนการส่ง (**Send notifications**) แล้วเลือกการแจ้งเตือนปัญหา การเปลี่ยนแปลงใน การสนทนาที่ติดตาม และสรุปประจำวัน การสรุปประจำวันใช้เวลามาตรฐานของเซิร์ฟเวอร์
3. เปิดตัวเลือก **“รวมข้อความสั้น”** หากต้องการให้ข้อความที่บันทึกไว้จากข้อความที่ถูกลบและแก้ไข ปรากฏในคำเตือน
4. กด "**บันทึกการแจ้งเตือน**" แล้วกด "**ส่งทดสอบ"** เพื่อตรวจสอบการส่งถึง

สำหรับตัวรับของคุณเอง ให้ใช้ [JSON webhook](https://appriseit.com/services/json/) ของ Apprise ตัวอย่างเช่น `jsons://notify.example.org/tgwitness` ส่ง JSON ผ่าน HTTPS ไปยัง จุดปลายทางนั้น นี่เป็นตัวอย่างสมมติ; ให้แทนที่ด้วยจุดปลายทางของคุณเอง

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

ในเวอร์ชันสาธิต การควบคุมการแจ้งเตือนจะปรากฏอยู่ แต่ฟังก์ชันการส่งถูกปิดใช้งานไว้ ให้ตั้งค่า การส่งในสภาพแวดล้อมการทำงานจริง การแจ้งเตือนจะใช้เส้นทาง Direct, SOCKS5 หรือ HTTP ของสภาพแวดล้อมการทำงานนั้น; MTProxy ไม่สามารถส่งการแจ้งเตือนได้ จุดหมายปลายทางที่ไม่ใช่ HTTP เช่น SMTP จำเป็นต้อง ใช้เส้นทางตรง

## การจัดวางแผง

![พื้นที่ทำงานเชื่อมต่อโดยใช้ข้อมูลสังเคราะห์](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29)

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

เปิดข้อความที่ถูกแก้ไขเพื่อเปรียบเทียบเวอร์ชันด้วยมุมมอง **แสดงความต่างในข้อความ** หรือ **แสดงเทียบกัน** ส่วน **ข้อมูลดิบ** จะแสดงฟิลด์ที่บันทึกไว้ การเปลี่ยนแปลงลิงก์ที่ซ่อนอยู่และปุ่มบอทจะแสดงแยกต่างหาก เปิดตัวอย่างไฟล์แนบเพื่อตรวจสอบรูปภาพ เสียง หรือวิดีโอที่บันทึกไว้ โดยปุ่มดาวน์โหลดจะช่วยให้คุณนำไฟล์ต้นฉบับที่เก็บรักษาไว้ออกมาใช้งานได้

**Live** จะอัปเดตบันทึกเหตุการณ์และแชททันทีที่ข้อมูลเข้ามา คุณสามารถหยุดชั่วคราวขณะตรวจสอบข้อมูล หรือใช้ปุ่มเหตุการณ์ใหม่เมื่อพร้อม โดยที่การเก็บรวบรวมข้อมูลยังคงทำงานต่อไป กด **Ctrl/Cmd+K** เพื่อค้นหาคำสั่งในพาเนลและค้นหาข้อมูลในบันทึกเหตุการณ์

**เครื่องมือเพิ่มเติม → แหล่งข้อมูล (Sources)** ประกอบด้วยขอบเขตการสังเกต (การสนทนาที่เลือกไว้, โฟลเดอร์ Telegram หรือทั้ง บัญชี), การสนทนาที่เข้าถึงได้ทุกประเภท, แหล่งข้อมูลที่เลือกไว้พร้อมดาวแสดงลำดับความสำคัญ, การตั้งค่า ไฟล์แนบและการตรวจสอบซ้ำ รวมถึงภาพถ่ายประวัติ แหล่งข้อมูลส่วนตัวถูกเลือกผ่านกล่องสนทนา/ID โดยไม่มีลิงก์สาธารณะ สถานะการเข้าถึงอธิบายการตรวจสอบล่าสุด ไม่ใช่สิทธิ์การเข้าถึงถาวร

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

**Chats → People** แสดงรายชื่อทุกคนที่มีข้อความที่บันทึกไว้; เมื่อเปิดโปรไฟล์ผู้ใช้ สำหรับแชทนั้น การคลิกจะเปิดโปรไฟล์ของบุคคลนั้นพร้อมลิงก์ไปยังบันทึกในสมุดบันทึก

**เครื่องมือเพิ่มเติม → Extras → Independent witness** สร้างโทเค็นผู้สังเกตการณ์แบบอ่านอย่างเดียว แสดงเวลาที่ผู้สังเกตการณ์แต่ละคนตรวจสอบครั้งสุดท้าย และ ให้คำสั่งและตัวเลือกเพื่อเรียกใช้ผู้สังเกตการณ์อิสระ ([independent witness](https://phishdestroy.io/tgwitness/th/docs/reference/witness/))

**เครื่องมือเพิ่มเติม → ส่วน Parameters** เก็บทุกขีดจำกัดและจังหวะการทำงานของพื้นที่ทำงานที่ไม่ได้ระบุในหน้าอื่น: จำนวนการอ่านบทสนทนา, ความถี่ในการอ่านใหม่รายการสนทนา, ช่วงเวลา heartbeat และ checkpoint บัฟเฟอร์เริ่มต้น, วิธีที่ rechecks กระจายคำขอ (ความล่าช้าครั้งแรก, จำนวนการสนทนาต่อ ครั้ง, เวลาพักระหว่างการแชท, ข้อความที่กู้คืนและส่งคำขอใหม่), พื้นที่ดิสก์สำรอง, เวลาหมดอายุและ การลองใหม่ของการดาวน์โหลด, สิ่งที่โปรไฟล์ผู้ใช้ค้นหา (รวมถึงนิพจน์ปกติของคุณเอง), ขนาดและอัตราความเร็วของการแจ้งเตือน, ข้อจำกัดของ snapshot, ZIP และการดาวน์โหลดผ่านเบราว์เซอร์, และ เวลาหมดอายุและลองใหม่ของไคลเอนต์ Telegram แต่ละฟิลด์แสดงช่วงค่าและค่าเริ่มต้น; ฟิลด์ที่เปลี่ยนแปลงแล้ว จะถูกทำเครื่องหมายและสามารถคืนค่าได้ทีละรายการหรือทั้งหมดพร้อมกัน ทุกการเปลี่ยนแปลงจะถูกบันทึกเป็น `parameters.changed` พร้อมค่าก่อนและหลังการเปลี่ยนแปลง และบันทึกการเริ่มต้นการสังเกตการณ์จะระบุ ค่าที่มีผลอยู่ ค่าจะมีผลตั้งแต่การใช้งานครั้งถัดไป; ส่วนเวลาหมดอายุและจำนวนครั้งลองใหม่ของไคลเอนต์จะมีผลตั้งแต่ การเชื่อมต่อครั้งถัดไป ช่วงเวลาตรวจสอบซ้ำ ประเภทและขนาดไฟล์แนบ หลักฐาน และช่วงเวลาคัดลอกข้อมูลนอกเซิร์ฟเวอร์ จะอยู่ในหน้าของตัวเองและสามารถตั้งค่าได้ทุกค่าในช่วงที่กำหนด ไม่เพียงแต่ค่าที่ตั้งไว้ล่วงหน้าเท่านั้น

ไอคอนรูปกระดิ่งในแถบด้านบนแสดงปัญหาและเปลี่ยนแปลงล่าสุดในแชทที่ถูกติดตาม; ข้อความที่ยังไม่ได้อ่าน จะถูกนับจนกว่าจะถูกทำเครื่องหมายว่าอ่านแล้ว การเปลี่ยนแปลงถูกจัดกลุ่มตามแชทและชั่วโมง ("12 ข้อความถูกลบ, 1 ข้อความถูกแก้ไข, 0 ข้อความไม่พบ") และปัญหาต่างๆ เช่น การออกจากระบบหรือพื้นที่ดิสก์เต็ม จะยังคงอยู่ในรายการ ไม่ว่าแชทจะมีความเคลื่อนไหวมากเพียงใด

**เครื่องมือเพิ่มเติม → บัญชี** เริ่มต้นที่ช่องกรอกหมายเลขโทรศัพท์ **ต่อ** นำโดยตรงสู่ การป้อนโค้ด โดยจะขอข้อมูลรับรอง API เฉพาะเมื่อขาดข้อมูลเท่านั้น การนำเข้าผ่าน QR และไฟล์เป็น แท็บทางเลือก ข้อมูลรับรอง API ที่บันทึกไว้จะถูกใช้ซ้ำได้เฉพาะภายในพื้นที่ทำงานของตัวเองเท่านั้น หน้าจอเข้าสู่ระบบไม่มีแถบด้านข้าง สถิติ หรือส่วนตั้งค่า ไอคอน การตั้งค่า **การตั้งค่า** ไอคอนจะเปิดการควบคุม API, พร็อกซี, พื้นที่จัดเก็บ และบัญชีเพิ่มเติม พื้นที่ทำงานใหม่จะเปิด [การตั้งค่าครั้งแรก](https://phishdestroy.io/tgwitness/th/docs/reference/settings/); หลังจากลงชื่อเข้าใช้ พื้นที่ทำงานที่มีแหล่งข้อมูลและบันทึกที่บันทึกไว้จะเปิดขึ้น **Chats**. การเปลี่ยนเส้นทางต้องหยุดการสังเกตชั่วคราวและยกเลิกการเข้าสู่ระบบที่ยังไม่เสร็จสิ้น บันทึก ที่มีอยู่ไม่สามารถผูกใหม่กับบัญชี Telegram อื่นได้โดยอัตโนมัติ

**การส่งออกจะ**ตรวจสอบความสมบูรณ์ของบันทึกและสร้างไฟล์ที่สามารถถ่ายโอนได้ ID ของพื้นที่ทำงาน สามารถส่งต่อไปยัง CLI สำหรับการดาวน์โหลดได้ การส่งออกแต่ละครั้งจะตรึงคำนำหน้าบันทึกเต็มรูปแบบ; เหตุการณ์ ที่เกิดขึ้นในภายหลังจะถูกบันทึกในการส่งออกครั้งถัดไป ตัวกรองการค้นหาไม่เปลี่ยนแปลงขอบเขตของแพ็กเกจ ข้อมูลรายละเอียดเกี่ยวกับการลงนามและขอบเขตการครอบคลุมอยู่ภายใต้ส่วน **การตรวจสอบและหลักฐาน**

แผงควบคุมจะแสดงสถานะของ Collector, สื่อที่อยู่ในคิว/ล้มเหลว, สื่อที่รอการประมวลผลที่เก่าที่สุด, พื้นที่ว่าง บนดิสก์, การหยุดชั่วคราวของคำขอ และแหล่งข้อมูลที่การเข้าถึงยังไม่ได้รับการยืนยัน ภายใต้ส่วน **Collector health** รายละเอียดเหล่านี้จะถูกพับเก็บไว้โดยเริ่มต้นและซ่อนไว้บนหน้า Account บัตรตั้งค่า จะแสดงขั้นตอนต่อไป: เชื่อมต่อบัญชี, เลือกแหล่งข้อมูล หรือเริ่มการสังเกตการณ์ รายชื่อบัญชีเป็นภาพถ่ายขณะโหลด; พื้นที่ทำงานที่เลือกจะอัปเดตเป็นระยะๆ นี่ไม่ใช่เครื่องมือติดตาม SLA แบบหลายกระบวนการ

UI ใช้ทรัพยากรภายในเครื่องและการแสดงผลแบบข้อความสำหรับเนื้อหาต้นทาง ทดสอบเลย์เอาต์เดสก์ท็อปและแบบแคบใน Chromium แล้ว

## สภาพแวดล้อมการติดตั้ง

| สภาพแวดล้อม | การติดตั้ง | สถานะการตรวจสอบ |
| --- | --- | --- |
| Windows PC/server | Python 3.11+, สคริปต์\Setup.cmd/Start.cmd, ไดเรกทอรีข้อมูลส่วนตัว | ได้ตรวจสอบในระบบ Windows/Python 3.12 แล้ว |
| เซิร์ฟเวอร์ Linux/VPS | Python venv, ผู้ใช้บริการเฉพาะ, HTTPS/SSH | มีตัวอย่างโค้ด CI และ systemd; ไม่ได้ถูกดำเนินการบนโฮสต์นี้ |
| macOS | Python venv, กระบวนการทำงานในพื้นหน้า หรือ ตัวแทนผู้ใช้ | มีตัวอย่าง launchd ให้ดู; ต้องตรวจสอบการติดตั้งแยกต่างหาก |
| Docker/Compose | ปริมาณคงที่, หนึ่งคนทำงาน | มีคำอธิบายและฟังก์ชันตรวจสอบการทำงานของ CI; Docker ไม่สามารถใช้งานได้ในระบบท้องถิ่น |
| เบราว์เซอร์บนโทรศัพท์ | เชื่อมต่อกับแผงควบคุมที่ได้รับการป้องกันบนเซิร์ฟเวอร์ที่กำลังทำงาน | ได้ทดสอบกับรูปแบบ Chromium ที่แคบแล้ว; ตัวเก็บข้อมูลไม่ทำงานบน iOS/Android |

ความสามารถในการพกพาได้หมายความว่าไม่จำเป็นต้องใช้บริการคลาวด์หรือสร้างส่วนหน้า (frontend) แต่ละเป้าหมายยังคง ต้องมีความเข้ากันได้กับไลบรารี Python/crypto ที่จำเป็น รวมถึงการเข้าถึงดิสก์ท้องถิ่นและเครือข่าย ดู [DEPLOYMENT.md](https://phishdestroy.io/tgwitness/th/docs/reference/deployment/) และ[แม่แบบบริการ](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md)

พื้นที่ทำงาน (Workspaces) ใช้ CPU, หน่วยความจำ และวงจรเหตุการณ์ (event loop) ร่วมกัน เพื่อแยกกระบวนการ (process isolation) ให้ใช้ อินสแตนซ์ พอร์ต ไดเรกทอรีข้อมูล และการอนุญาตบัญชีที่ต่างกัน ไม่มี แผงควบคุม (panel) ที่รวมกันสำหรับอินสแตนซ์ที่แยกกัน อย่ากำหนดให้หลายตัวทำงาน (workers) เชื่อมต่อกับฐานข้อมูลเดียวกัน

## การตรวจสอบและส่งออกข้อมูล

รัน `python start.py --check` ก่อนเริ่มสภาพแวดล้อมที่เตรียมไว้ เพิ่ม `--json` สำหรับการตรวจสอบที่เครื่องอ่านได้ หรือส่งพารามิเตอร์ `--data-dir` `--host` และ `--port` ที่ต้องการ คำสั่งนี้จะตรวจสอบเงื่อนไขเบื้องต้นโดยไม่ต้องเข้าสู่ระบบ Telegram หรือสร้างบันทึก การตรวจสอบบันทึกจะทำงานระหว่างการเริ่มต้นแอปพลิเคชัน และสถานะความพร้อมในการจับข้อมูลจะแสดง ในแผงควบคุม พอร์ตที่ถูกใช้งานอยู่อาจเป็นเพียงอินสแตนซ์ที่มีอยู่เดิม

เบราว์เซอร์ที่สนับสนุน File System Access API จะบันทึกการส่งออกผ่านสตรีมที่เขียนได้ ส่วนเบราว์เซอร์อื่น ๆ จะบัฟเฟอร์ได้สูงสุด 128 MiB ให้ใช้ CLI แบบสตรีมมิ่งสำหรับการส่งออกที่มีขนาดใหญ่ หรือเบราว์เซอร์ที่ไม่มีฟังก์ชันสตรีมมิ่งไฟล์:

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

เพิ่ม `--profile ID` จาก Exports เพื่อสร้างพื้นที่ทำงานลูก ใช้ `--url https://server` สำหรับการเข้าถึงจากระยะไกล HTTP แบบธรรมดาจะได้รับการยอมรับเฉพาะสำหรับปลายทาง loopback เท่านั้น โทเค็น จะถูกอ่านจากไฟล์และส่งในส่วนหัว (header) ไม่ถูกพิมพ์หรือใส่ใน URL การเปลี่ยนเส้นทาง จะถูกปฏิเสธ ปลายทางที่มีอยู่จะไม่ถูกเขียนทับ การถ่ายโอนที่ล้มเหลวจะลบ ไฟล์ส่วนชั่วคราวที่เกี่ยวข้อง SHA-256 ที่รายงานเป็นค่าตรวจสอบการถ่ายโอน; โปรดตรวจสอบไฟล์ ZIP ที่ลงนาม แยกต่างหากด้วยลายนิ้วมือ/จุดตรวจสอบที่เชื่อถือได้

## การสำรองข้อมูล การกู้คืนข้อมูล และการหยุดทำงาน

1. หยุดการสังเกตและยุติกระบวนการอย่างเรียบร้อย
2. คัดลอกไดเรกทอรีข้อมูลทั้งหมด: ฐานข้อมูล, WAL/SHM (หากมี), media, `credentials.enc`, `signing.enc`, `network.enc`, vault keys/metadata, token, checkpoints และทุกไดเรกทอรี `profiles/`
3. สำหรับโหมดกุญแจภายนอก (external-key mode) ให้เก็บรักษากุญแจหลัก (master key) และแต่ละ `vault.external.json` แยกกัน การสร้างกุญแจใหม่ไม่สามารถกู้คืนความลับเดิมได้
4. กู้คืนข้อมูลในขณะที่ปลายทางถูกหยุดทำงาน; ตั้งค่ากุญแจต้นฉบับ, จำกัด การเข้าถึง และตรวจสอบความสมบูรณ์ก่อนที่จะดำเนินการต่อ
5. บันทึกเวลาหยุดทำงานและผลการตรวจสอบ เวลาหยุดทำงานยังคงเป็นช่องว่างที่บันทึกไว้; ภาพถ่ายประวัติจะเพิ่มสถานะหลังจากนั้น

Evidence ZIPs exclude sessions/private keys and are not full service backups. `tgwitness backup FOLDER` makes the same copy while the panel keeps running and leaves out the search index, which rebuilds itself; see [Updates and backups](https://phishdestroy.io/tgwitness/th/docs/reference/deployment/#updates-and-backups). Four things are protected differently:

| อะไร | การป้องกัน |
| --- | --- |
| ส่งออกไฟล์โดยไม่ใช้รหัสผ่าน (ค่าเริ่มต้น) | มีลายเซ็น จึงตรวจพบการเปลี่ยนแปลงได้ ตั้งรหัสผ่านเพื่อเข้ารหัสไฟล์ส่งออก |
| ส่งออกไฟล์ด้วยรหัสผ่าน | หากตั้งรหัสผ่าน ไฟล์ที่ส่งออกเสร็จสิ้นจะถูกเก็บไว้ในรูปแบบ WinZip AES-256 ZIP ที่ 7-Zip และ WinRAR สามารถเปิดได้ โดยรหัสผ่านจะไม่ถูกเก็บไว้ ([การจัดการหลักฐาน](https://phishdestroy.io/tgwitness/th/docs/reference/evidence/)) |
| ฐานข้อมูลของบันทึกและไฟล์แนบที่เก็บไว้บนดิสก์ | ดิสก์หรือโวลุ่มที่เข้ารหัสและสิทธิ์ของโฟลเดอร์ |
| เซสชัน Telegram และกุญแจลงนาม | ถูกเข้ารหัสในโฟลเดอร์ข้อมูล (`credentials.enc`, `signing.enc`, `network.enc`) |

การสำรองข้อมูลแบบครบวงจรคือไดเรกทอรีข้อมูลที่ถูกหยุดไว้ตามที่อธิบายข้างต้น ไม่ใช่การส่งออก ใช้พื้นที่จัดเก็บที่ได้รับการป้องกันและกลไกการถ่ายโอนที่ได้รับการออกแบบอย่างรอบคอบสำหรับทั้งสองกรณี การส่งออกชั่วคราวบนเซิร์ฟเวอร์จะถูกเก็บไว้ใน `temporary-exports/` ของแต่ละพื้นที่ทำงาน; คำตอบที่เสร็จสมบูรณ์จะถูกล้างออก และไฟล์การส่งออกที่ถูกขัดจังหวะ จะถูกลบออกในการเริ่มต้นระบบครั้งต่อไป ในขณะที่ล็อกอินสแตนซ์ของพื้นที่ทำงานนั้นยังคงถูกถืออยู่

หลังจากเกิดเหตุการณ์การกู้คืนการเชื่อมต่อ ผู้รวบรวมจะขอข้อมูลอัปเดตที่พลาดไปจาก ตำแหน่งอัปเดตที่บันทึกไว้ งานสื่อที่คงอยู่และตำแหน่งอัปเดตของ Telegram จะยังคงอยู่หลังการเริ่มต้นใหม่; ดู [รูปแบบหลักฐาน](https://phishdestroy.io/tgwitness/th/docs/reference/evidence/#durable-collection-and-process-receipts-02)

## ความจุและการเก็บรักษา

ขีดจำกัดเริ่มต้น ซึ่งสามารถปรับเปลี่ยนได้ทั้งหมดภายใต้ **More tools → Parameters**: 1,000 กล่องสนทนาแรก, 500 ข้อความ ต่อ snapshot, 4 GiB เนื้อหา ZIP ที่ลงนามและไม่ถูกบีบอัด (ไฟล์เก็บถาวรที่ใหญ่กว่าต้องใช้ `verify.py --max-gib N`) และพื้นที่สำรองสำหรับเบราว์เซอร์ 128 MiB ไฟล์แนบใช้พื้นที่ 1–2,000 MiB ต่อ ประเภทภายใต้ **More tools → Sources → Recording → Attachments** CLI สำหรับดาวน์โหลดตั้งค่าเริ่มต้นที่ 5 GiB ที่ถูกถ่ายโอน พื้นที่ดิสก์ที่มีอยู่สามารถเป็น ขีดจำกัดขั้นต่ำได้ จัดพื้นที่ไว้สำหรับบันทึกประจำวัน (journals), สื่อ (media), WAL, การส่งออกชั่วคราว และการสำรองข้อมูล การส่งออกจะใช้พื้นที่เก็บข้อมูล (data volume) แทนที่จะใช้พื้นที่ 512 MiB ของ Compose ใน `/tmp`

วัดเหตุการณ์ต่อวินาที (events/second), อายุคิว (queue age), ไบต์สื่อ (media bytes) และความล่าช้าของดิสก์ (disk latency) แทนที่จะนับ กลุ่ม (groups) เพียงอย่างเดียว การส่งข้อมูลแบบเรียลไทม์ (Live delivery) ถูกวัดบนตัวเก็บข้อมูล (collector) ที่กำลังทำงาน ไม่มีการลบข้อมูลที่เก็บรักษาไว้โดยอัตโนมัติ การลบส่วนท้ายของบันทึก (journal tail) จะทำให้ ความสัมพันธ์กับจุดตรวจสอบที่เก็บรักษาไว้ (checkpoints) กลายเป็นไม่ถูกต้อง

การตรวจซ้ำตามลำดับความสำคัญมีอยู่แล้ว: แหล่งที่ติดดาวจะถูกตรวจซ้ำทุก 15 นาทีโดยค่าเริ่มต้น ส่วนแหล่งอื่นทุก 6 ชั่วโมง (ดู [ระดับการตรวจซ้ำ](https://phishdestroy.io/tgwitness/th/docs/reference/collection/#recheck-tiers)) การส่งออกที่ป้องกันด้วยรหัสผ่านทำงานตามที่อธิบายไว้ข้างต้น การเข้าถึงแบบจำกัดขอบเขตมีเอกสารอยู่ใน [การเข้าถึงและสิทธิ์](https://phishdestroy.io/tgwitness/th/docs/reference/access/) ดู [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) และ [VERIFICATION.md](https://phishdestroy.io/tgwitness/th/docs/reference/verification/)
