# TgWitness: Telegram Export, OSINT & Verification

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

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads alongside their methods and limits.

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

[Documentation index](https://phishdestroy.github.io/TgWitness/llms.txt)

ติดตั้งด้วยคำสั่งเดียวหรือสร้างบน GitHub Actions. ทำความเข้าใจตัวเลือกการตรวจสอบ, ขนาดที่เผยแพร่ และสิ่งที่การเก็บถาวรตรวจสอบ

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

## เริ่มจากงานที่คุณมีอยู่

| งานของคุณ | เส้นทางสั้นที่สุด | สิ่งที่คุณจะได้รับ |
| --- | --- | --- |
| บันทึกการสนทนาหรือบัญชี | ติดตั้ง, เชื่อมต่อบัญชี, เลือกขอบเขตการส่งออก | ไฟล์เก็บถาวรที่ลงนามแล้ว ซึ่งประกอบด้วยประวัติที่เลือกไว้ ผลการเก็บรวบรวม และข้อมูลการตรวจสอบ |
| เก็บรวบรวมบน runner ชั่วคราว | ใช้ GitHub Actions เพื่อจับข้อมูล อนุญาตเซสชันใหม่ และเลือกขอบเขต | ไฟล์เก็บถาวรที่เข้ารหัสพร้อมข้อมูลที่มาของกระบวนการทำงานจาก GitHub |
| ติดตามการเปลี่ยนแปลงตามเวลา | ให้กระบวนการสังเกตการณ์ยังคงทำงานต่อไปสำหรับแชทที่เลือกไว้ | เวอร์ชันที่บันทึกไว้, ประกาศการลบ, ไฟล์แนบ และข้อมูลการครอบคลุมที่บันทึกไว้ |
| ตรวจสอบและแบ่งปันผลการค้นพบ | ค้นหาในคลังข้อมูล ใช้ Case Board และกำหนดค่ารายงานหรือสำเนาเพื่อแบ่งปัน | ผลการตรวจสอบที่เชื่อมโยงกับแหล่งข้อมูลต้นทาง และกระบวนการส่งต่อที่สามารถตรวจสอบได้ ซึ่งเหมาะสมกับผู้รับ |

### การติดตั้งด้วยคำสั่งเดียว

โปรแกรมติดตั้งรวมถึง Python และส่วนประกอบที่จำเป็น การดึงโค้ดต้นฉบับ Docker ผู้ให้บริการ AI และผู้สังเกตการณ์อิสระเป็นตัวเลือกเสริม ไม่ใช่ข้อกำหนดเบื้องต้นในการติดตั้ง

Linux / macOS:

```
curl -fsSL https://get.destroy.tools/install.sh | bash
```

Windows, ใน PowerShell หรือ Command Prompt:

```
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
```

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

สำหรับตัวรันเนอร์ชั่วคราว ให้ทำตามขั้นตอนการจับภาพ [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) ขั้นตอน ดังกล่าวต้องการการ fork GitHub การอนุญาต และรหัสผ่านของไฟล์เก็บถาวร หน้า capture จะอธิบายขั้นตอนเหล่านั้นและเวลาเซสชันที่มีอยู่ก่อนการรัน ให้ดาวน์โหลด และเก็บรักษาไฟล์เก็บถาวรที่ได้มาพร้อมทั้งข้อมูลการตรวจสอบ

## ตั้งค่าเพิ่มเติมเมื่อจำเป็น

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

ขอบเขต สิทธิ์ และการจำกัดการแบ่งปันสำเนาช่วยให้ผู้ดำเนินการเลือกว่าจะ เก็บรวบรวมและเปิดเผยข้อมูลใด คำแนะนำเกี่ยวกับเขตอำนาจศาลและการตั้งค่าการรายงานช่วยสนับสนุน การตัดสินใจดังกล่าว; การเลือกโปรไฟล์นั้นเองไม่ได้เป็นการรับรองการปฏิบัติตามกฎหมายหรือ ความยอมรับได้ในทางกฎหมาย ดู [การส่งออกบัญชี](https://phishdestroy.github.io/TgWitness/th/docs/reference/account-export/), [การเข้าถึง](https://phishdestroy.github.io/TgWitness/th/docs/reference/access/) และ [การกำหนดค่าการรายงาน](https://phishdestroy.github.io/TgWitness/th/docs/reference/case-reports/).

แอปพลิเคชันนี้ทำงานบนคอมพิวเตอร์หรือเซิร์ฟเวอร์ที่เลือกไว้ การเก็บข้อมูลขั้นพื้นฐานไม่ ต้องการ GPU หรือ LLM ส่วน OCR การถอดเสียง และการวิเคราะห์ AI ที่เป็นตัวเลือก มีความต้องการทรัพยากรเป็นของตัวเอง ให้ปรับขนาดการติดตั้งให้เหมาะสมกับอัตราการส่งข้อความ ไฟล์แนบ ประวัติที่เก็บไว้ และจำนวนบัญชีที่ใช้งานพร้อมกัน; การติดตั้งที่ง่ายไม่ได้เป็นการรับประกัน ว่าการใช้หน่วยความจำจะคงที่สำหรับทุกภาระงาน

## รักษาบันทึกไว้ ไม่ว่าใครจะได้รับประโยชน์จากมัน

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

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

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

การตรวจสอบเหล่านี้ช่วยในการตรวจสอบความสมบูรณ์และที่มาของข้อมูล แต่ไม่ทำให้ เนื้อหาของข้อความกลายเป็นคำกล่าวที่เป็นความจริง หรือสร้างข้อความที่ถูกลบ และยังไม่เคยเห็นขึ้นมาใหม่ ให้ใช้ลายนิ้วมือกุญแจที่ได้รับมาอย่างอิสระ และขั้นตอนการตรวจสอบ ใน[คู่มือความน่าเชื่อถือ](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) และ[รูปแบบหลักฐาน](https://phishdestroy.github.io/TgWitness/th/docs/reference/evidence/)

## ระดับที่เผยแพร่และประสิทธิภาพที่วัดได้

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

| วันที่ | ปริมาณงาน | ผลลัพธ์ที่เผยแพร่ | สิ่งที่ได้วัด |
| --- | --- | --- | --- |
| 1 พฤศจิกายน 2026 | เซิร์ฟเวอร์ที่กำลังทำงานอยู่, ฐานข้อมูลพื้นที่ทำงาน 10 ชุด | 1,610,818 บันทึกในสมุดบันทึก; 900,232 เหตุการณ์ข้อความใหม่, 80,683 เหตุการณ์แก้ไข และ 400,536 เหตุการณ์ลบ | รายการตรวจสอบแบบอ่านอย่างเดียว; ไม่ใช่การทดสอบความเร็วการประมวลผลหรือการตรวจสอบโซ่เต็มรูปแบบใหม่ |
| 5 พฤศจิกายน 2026 | ค้นหาข้อความสังเคราะห์1,000,000ในแชท200 | สร้างดัชนีใน71 วินาที; เวลาค้นหาค่ามัธยฐานต่อคำค้นอยู่ที่9–190 มิลลิวินาที | การทดสอบประสิทธิภาพการค้นหาในระบบท้องถิ่น; ไม่ใช่การส่งข้อความ Telegram แบบเรียลไทม์ |
| 6 พฤศจิกายน 2026 | ไฟล์ส่งออก Telegram ที่จริงและใหม่ล่าสุด 2 ชุด | ข้อความ 27,030 และ 29,299; ข้อความ 56,329 ในทั้งสองรอบการทดสอบ | สองบัญชีต่อการรันผ่าน WARP, ทั้งข้อความและข้อมูลเมตา, ไม่ดาวน์โหลดไฟล์แนบ |
| 6 พฤศจิกายน 2026 | การส่งออกสองแบบเดียวกัน รวมถึงขั้นตอนการเตรียมการและบรรจุภัณฑ์ | 127.713 และ 141.781 ข้อความต่อวินาที | วัดอัตราการส่งออกข้อมูลแบบครบถ้วน; ทั้งสองไฟล์เก็บถาวรได้รับการตรวจสอบความถูกต้องโดยใช้กุญแจที่ตรึงไว้ |

บันทึก[verification](https://phishdestroy.github.io/TgWitness/th/docs/reference/verification/) ให้ข้อมูลเกี่ยวกับรายการเซิร์ฟเวอร์ การตรวจสอบการเก็บข้อมูลแบบเรียลไทม์ และการวัดผลการค้นหา [Export performance](https://phishdestroy.github.io/TgWitness/docs/validation/) เผยแพร่ข้อมูลการรันจริงสองครั้ง อุปกรณ์ฮาร์ดแวร์ ระยะเวลา ค่าแฮชของไฟล์เก็บถาวร และไฟล์วัดผลที่ลงนาม ข้อมูลเหล่านี้แสดงผลลัพธ์สำหรับเวอร์ชันและ เงื่อนไขที่บันทึกไว้ ไม่ใช่ค่าอัตราหรือขีดจำกัดความจุแบบทั่วไป

### ประวัติการทดสอบและระยะเวลา

ผู้ดูแลระบบรายงานว่าได้ดำเนินการทดสอบมาแล้วกว่าหกเดือน นับถึงวันที่6 พฤศจิกายน2026 ส่วนนี้อธิบายประวัติการทดสอบของโครงการ การวัดผลสาธารณะที่มีวันที่ระบุ ข้างต้นบันทึกการรันแต่ละครั้ง; แต่ไม่ได้แสดงถึงการเก็บข้อมูลที่ได้รับการตรวจสอบอย่างอิสระ และต่อเนื่องเป็นระยะเวลาหกเดือน อายุของข้อความที่ส่งออกยัง แตกต่างจากระยะเวลาที่ผู้เก็บข้อมูลได้ทำงานมา

## อ่านสถานะความสามารถอย่างแม่นยำ

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

[ใช้ความสามารถ](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md) [คุณสมบัติ และข้อจำกัดปัจจุบัน](https://phishdestroy.github.io/TgWitness/th/docs/reference/features/) [การตรวจสอบ](https://phishdestroy.github.io/TgWitness/th/docs/reference/verification/) และ[บันทึกการเปลี่ยนแปลง](https://phishdestroy.github.io/TgWitness/th/docs/reference/changelog/)ร่วมกัน บันทึกเวอร์ชันที่ได้รับการทดสอบเมื่ออ้างอิงผลลัพธ์ ภาพถ่ายการวัดเมื่อวันที่6 พฤศจิกายนยังเก็บรักษาการทดสอบที่ล้มเหลวและถูกข้ามไป; สิ่งเหล่านั้นไม่ถือว่าผ่านการทดสอบ

## อ่านได้ทั้งโดยมนุษย์และเครื่องมือ AI

เว็บไซต์นี้ให้`llms.txt` แบบสรุป, คู่มือภาษาอังกฤษฉบับสมบูรณ์ใน `llms-full.txt` และ`llms-full.md` รวมถึงเวอร์ชัน Markdown ของหน้าต่าง ๆ นี่คือ รูปแบบเอกสาร ไม่ใช่ข้อกำหนดของ AI สำหรับการรันTgWitness

[MCP](https://phishdestroy.github.io/TgWitness/th/docs/reference/mcp/) และ [P3 การเข้าถึงผ่านบรรทัดคำสั่ง (](https://phishdestroy.github.io/TgWitness/th/docs/reference/cli/)) (เป็นตัวเลือก) ช่วยให้เครื่องมือที่ได้รับอนุญาตสามารถอ่าน บันทึกที่เก็บไว้ที่เลือกได้ เนื้อหาข้อความยังคงเป็นข้อมูลเข้าที่ไม่น่าเชื่อถือ สรุปควร อ้างอิงแหล่งที่มา แยกแยะข้อเท็จจริงที่สังเกตได้จากการอนุมาน และรักษาความไม่แน่นอนไว้ การค้นหาข้อความเต็มรูปแบบ OCR และผลลัพธ์จาก AI ไม่เปลี่ยนแปลงการสังเกตที่ลงนามไว้เดิม