ส่วนหนึ่งของหน้านี้ยังคงเป็นภาษาอังกฤษ: เนื้อหาต้นฉบับภาษาอังกฤษได้เปลี่ยนแปลงไปหลังจากถูกแปล
อ้างอิง / Collect
Telegram · ขั้นตอนการทำงานและการดำเนินการ
การดำเนินงานประจำวันของแผงควบคุม: โหมดการทำงาน, หมวดหมู่การติดตาม, พารามิเตอร์, การแจ้งเตือน, การส่งออกข้อมูล, การสำรองข้อมูล และขีดความสามารถ
TgWitness / เอกสารประกอบ · การติดตั้งและกู้คืน
สำหรับการเชื่อมต่อครั้งแรก ให้ใช้บัญชีและรูปแบบเซสชัน เพื่อดูคำอธิบายเกี่ยวกับเวอร์ชันที่บันทึกไว้ นโยบายเหตุการณ์ และช่องว่าง โปรด ดูวิธีการทำงานของระบบการเก็บข้อมูล คู่มือนี้ครอบคลุมการดำเนินงานประจำวันและการกู้คืนข้อมูล
การติดตั้งแบบจัดการจะรวมถึงไฟล์ 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 หยุดการทำงานของทั้งแผงควบคุมและระบบเก็บข้อมูล
บนหน้านี้
ขั้นตอนการทำงานของผู้ใช้#
แผนภาพในรูปแบบข้อความ
- เลือกพื้นที่จัดเก็บและวิธีการปกป้องกุญแจ → เปิดแผงควบคุมด้วยโทเค็นของมัน
- เปิดแผงควบคุมด้วยโทเค็นของมัน → เลือกพื้นที่ทำงาน
- เลือกพื้นที่ทำงาน → กำหนดเส้นทาง Direct หรือ proxy
- กำหนดเส้นทาง Direct หรือ proxy → ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR
- ป้อนหมายเลขโทรศัพท์หรือเลือกไฟล์ / QR → ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้
- ตรวจสอบตัวตนของบัญชีและเลือกกลุ่มที่สามารถเข้าถึงได้ → กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบ แล้วเริ่มการติดตาม
- กำหนดนโยบายการบันทึกเหตุการณ์และไฟล์แนบ แล้วเริ่มการติดตาม → ติดตามข้อผิดพลาด การเข้าถึง แถวรอ และพื้นที่ดิสก์
- ติดตามข้อผิดพลาด การเข้าถึง แถวรอ และพื้นที่ดิสก์ → รักษาจุดตรวจสอบอิสระ
- รักษาจุดตรวจสอบอิสระ → ส่งออกและตรวจสอบข้อมูล
การอนุญาต การเชื่อมต่อเครือข่าย การเข้าถึงกลุ่ม และความครบถ้วนของการ ส่ง เป็นคุณสมบัติที่ต่างกัน สถานะการเชื่อมต่อสีเขียวไม่ได้หมายความว่าทุก เหตุการณ์ได้ถูกบันทึกไว้แล้ว
แบ่งปันงานโดยไม่ต้องแบ่งปันกุญแจหลัก#
เปิด More tools → Access เพื่อมอบโทเค็นส่วนตัวให้กับผู้ตรวจสอบหรือนักวิเคราะห์ เลือกบัญชี และแชทที่พวกเขาสามารถเปิดได้ จากนั้นอนุญาตให้ดู ส่งออก หรือดำเนินการ ผู้ดำเนินการที่เริ่ม/หยุดการเก็บข้อมูลจำเป็นต้องมีสิทธิ์เข้าถึงพื้นที่ทำงานทั้งหมด; ผู้ตรวจสอบ สามารถถูกจำกัดให้เข้าถึงแชทเดียวได้ ข้อจำกัดเซสชัน ระยะเวลาหมดอายุ และกฎ IP เป็นเรื่องที่แยกต่างหาก จากการอนุญาตบัญชี Telegram ดูการเข้าถึงและสิทธิ์
ใช้ "Open sessions" เพื่อปิดการเชื่อมต่อ หรือเพิกถอนสิทธิ์การเข้าถึงเพื่อปิด ทุกเซสชันของมัน คอนโซลผู้ดูแลระบบรวมกิจกรรมของกระบวนการปัจจุบันจาก ทุกพื้นที่ทำงาน การปิดเซสชันจะไม่ส่งผลต่อการทำงานของระบบการเก็บข้อมูล
โหมดการทำงาน#
| โหมด | การดำเนินการ | พฤติกรรม |
|---|---|---|
| Demo | scripts\Demo.cmd หรือ --demo |
ข้อมูลสังเคราะห์; การเชื่อมต่อกับบัญชีจริงถูกปิดใช้งาน |
| ข้อสังเกต | เริ่มการสังเกต | บันทึกการอัปเดตที่ส่งมาสำหรับแหล่งข้อมูลที่เลือกไว้ |
| ภาพรวมประวัติ | แชท → การดำเนินการในแชท → โหลดประวัติ | บันทึกข้อความล่าสุดได้สูงสุด 500 ข้อความ; ไม่มีการสร้างใหม่ของทุกการเปลี่ยนแปลงในอดีต |
| หยุดชั่วคราว | หยุดการสังเกต | หยุดการเก็บข้อมูลในขณะที่ยังคงเก็บข้อมูลและงานที่อยู่ในคิว |
| ตรวจสอบ/ส่งต่อ | การส่งออก | ZIP, JSONL/CSV/HTML, จุดตรวจสอบ, ใบรับการดำเนินการ และคำขอประทับเวลา |
| หลายบัญชี | พื้นที่ทำงาน หรือปุ่ม + ด้านบน | สามารถสร้างพื้นที่ทำงานแยกกันได้ไม่จำกัดภายในกระบวนการเดียว |
การเข้าถึงเดโมท้องถิ่นจะเปิดอัตโนมัติโดยไม่ต้องป้อนโทเค็นด้วยมือ มันใช้ ความสามารถที่มีอายุการใช้งานตามกระบวนการ (process-lifetime capability) ซึ่งใช้ได้เฉพาะสำหรับการเข้าถึงแบบลูปแบ็กโดยตรงไปยัง เดโมสังเคราะห์ที่แยกเป็นอิสระ; โทเค็นของแผงหลักไม่ถูกเปิดเผย พื้นที่ทำงานจริงและการเข้าถึงเดโมจากระยะไกล หรือผ่านพร็อกซี ยังคงต้องใช้การยืนยันตัวตนด้วยโทเค็น การเข้าสู่เดโมไม่มอบสิทธิ์การอนุญาตของ Telegram
หมวดหมู่การติดตาม#

ใน 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 และบริการอื่น ๆ ที่ได้รับการสนับสนุน คุณสามารถเพิ่มจุดหมายปลายทางหลายแห่งไปยังพื้นที่ทำงานเดียวได้
- ป้อน URL ปลายทาง Apprise หนึ่งรายการต่อบรรทัด ใช้ แคตตาล็อกบริการและรูปแบบ URL ที่เหมาะสมกับบริการของคุณ
- เปิดการแจ้งเตือนการส่ง (Send notifications) แล้วเลือกการแจ้งเตือนปัญหา การเปลี่ยนแปลงใน การสนทนาที่ติดตาม และสรุปประจำวัน การสรุปประจำวันใช้เวลามาตรฐานของเซิร์ฟเวอร์
- เปิดตัวเลือก “รวมข้อความสั้น” หากต้องการให้ข้อความที่บันทึกไว้จากข้อความที่ถูกลบและแก้ไข ปรากฏในคำเตือน
- กด "บันทึกการแจ้งเตือน" แล้วกด "ส่งทดสอบ" เพื่อตรวจสอบการส่งถึง
สำหรับตัวรับของคุณเอง ให้ใช้ JSON webhook ของ Apprise
ตัวอย่างเช่น jsons://notify.example.org/tgwitness ส่ง JSON ผ่าน HTTPS ไปยัง
จุดปลายทางนั้น นี่เป็นตัวอย่างสมมติ; ให้แทนที่ด้วยจุดปลายทางของคุณเอง
จุดหมายปลายทางและตั้งค่าเป็นส่วนหนึ่งของพื้นที่ทำงานที่เลือกไว้ การแจ้งเตือนการเปลี่ยนแปลง ครอบคลุมแหล่งข้อมูลที่ติดตามอยู่ รวมถึงการสนทนาที่เพิ่มใหม่ สัญลักษณ์รูปกระดิ่งในแถบด้านบน ยังแสดงปัญหาล่าสุดและการเปลี่ยนแปลงในการสนทนาด้วย
ในเวอร์ชันสาธิต การควบคุมการแจ้งเตือนจะปรากฏอยู่ แต่ฟังก์ชันการส่งถูกปิดใช้งานไว้ ให้ตั้งค่า การส่งในสภาพแวดล้อมการทำงานจริง การแจ้งเตือนจะใช้เส้นทาง Direct, SOCKS5 หรือ HTTP ของสภาพแวดล้อมการทำงานนั้น; MTProxy ไม่สามารถส่งการแจ้งเตือนได้ จุดหมายปลายทางที่ไม่ใช่ HTTP เช่น SMTP จำเป็นต้อง ใช้เส้นทางตรง
การจัดวางแผง#

บันทึกแสดงข้อมูลการสังเกต การค้นหา และตัวกรอง การแก้ไขจะเปิดเวอร์ชันที่ถูกบันทึกไว้; การลบจะเปิดเนื้อหาเดิมหากมีอยู่ แหล่งที่มาที่ไม่ทราบจะยังคงระบุไว้อย่างชัดเจน จำนวนข้อมูลสามารถดูได้ในส่วน "ภาพรวม" (Overview); รายละเอียดการเก็บข้อมูลจะอยู่ในคู่มือท้องถิ่น
เปิดข้อความที่ถูกแก้ไขเพื่อเปรียบเทียบเวอร์ชันด้วยมุมมอง แสดงความต่างในข้อความ หรือ แสดงเทียบกัน ส่วน ข้อมูลดิบ จะแสดงฟิลด์ที่บันทึกไว้ การเปลี่ยนแปลงลิงก์ที่ซ่อนอยู่และปุ่มบอทจะแสดงแยกต่างหาก เปิดตัวอย่างไฟล์แนบเพื่อตรวจสอบรูปภาพ เสียง หรือวิดีโอที่บันทึกไว้ โดยปุ่มดาวน์โหลดจะช่วยให้คุณนำไฟล์ต้นฉบับที่เก็บรักษาไว้ออกมาใช้งานได้
Live จะอัปเดตบันทึกเหตุการณ์และแชททันทีที่ข้อมูลเข้ามา คุณสามารถหยุดชั่วคราวขณะตรวจสอบข้อมูล หรือใช้ปุ่มเหตุการณ์ใหม่เมื่อพร้อม โดยที่การเก็บรวบรวมข้อมูลยังคงทำงานต่อไป กด Ctrl/Cmd+K เพื่อค้นหาคำสั่งในพาเนลและค้นหาข้อมูลในบันทึกเหตุการณ์
เครื่องมือเพิ่มเติม → แหล่งข้อมูล (Sources) ประกอบด้วยขอบเขตการสังเกต (การสนทนาที่เลือกไว้, โฟลเดอร์ Telegram หรือทั้ง บัญชี), การสนทนาที่เข้าถึงได้ทุกประเภท, แหล่งข้อมูลที่เลือกไว้พร้อมดาวแสดงลำดับความสำคัญ, การตั้งค่า ไฟล์แนบและการตรวจสอบซ้ำ รวมถึงภาพถ่ายประวัติ แหล่งข้อมูลส่วนตัวถูกเลือกผ่านกล่องสนทนา/ID โดยไม่มีลิงก์สาธารณะ สถานะการเข้าถึงอธิบายการตรวจสอบล่าสุด ไม่ใช่สิทธิ์การเข้าถึงถาวร
กรองแหล่งข้อมูล เลือกช่องทำเครื่องหมาย จากนั้นเปิดใช้งาน หยุดชั่วคราว หรือทำเครื่องหมายเป็นรายการสำคัญพร้อมกันได้ ในรายการแชทที่มีอยู่ ปุ่ม เพิ่มรายการที่เลือก จะใช้รายการที่คุณเลือก ส่วน เพิ่มทุกรายการที่ตรงกัน จะใช้คำค้นหาและตัวกรองประเภทในปัจจุบัน
Chats → People แสดงรายชื่อทุกคนที่มีข้อความที่บันทึกไว้; เมื่อเปิดโปรไฟล์ผู้ใช้ สำหรับแชทนั้น การคลิกจะเปิดโปรไฟล์ของบุคคลนั้นพร้อมลิงก์ไปยังบันทึกในสมุดบันทึก
เครื่องมือเพิ่มเติม → Extras → Independent witness สร้างโทเค็นผู้สังเกตการณ์แบบอ่านอย่างเดียว แสดงเวลาที่ผู้สังเกตการณ์แต่ละคนตรวจสอบครั้งสุดท้าย และ ให้คำสั่งและตัวเลือกเพื่อเรียกใช้ผู้สังเกตการณ์อิสระ (independent witness)
เครื่องมือเพิ่มเติม → ส่วน Parameters เก็บทุกขีดจำกัดและจังหวะการทำงานของพื้นที่ทำงานที่ไม่ได้ระบุในหน้าอื่น:
จำนวนการอ่านบทสนทนา, ความถี่ในการอ่านใหม่รายการสนทนา, ช่วงเวลา heartbeat และ checkpoint
บัฟเฟอร์เริ่มต้น, วิธีที่ rechecks กระจายคำขอ (ความล่าช้าครั้งแรก, จำนวนการสนทนาต่อ
ครั้ง, เวลาพักระหว่างการแชท, ข้อความที่กู้คืนและส่งคำขอใหม่), พื้นที่ดิสก์สำรอง, เวลาหมดอายุและ
การลองใหม่ของการดาวน์โหลด, สิ่งที่โปรไฟล์ผู้ใช้ค้นหา (รวมถึงนิพจน์ปกติของคุณเอง),
ขนาดและอัตราความเร็วของการแจ้งเตือน, ข้อจำกัดของ snapshot, ZIP และการดาวน์โหลดผ่านเบราว์เซอร์, และ
เวลาหมดอายุและลองใหม่ของไคลเอนต์ Telegram แต่ละฟิลด์แสดงช่วงค่าและค่าเริ่มต้น; ฟิลด์ที่เปลี่ยนแปลงแล้ว
จะถูกทำเครื่องหมายและสามารถคืนค่าได้ทีละรายการหรือทั้งหมดพร้อมกัน ทุกการเปลี่ยนแปลงจะถูกบันทึกเป็น
parameters.changed พร้อมค่าก่อนและหลังการเปลี่ยนแปลง และบันทึกการเริ่มต้นการสังเกตการณ์จะระบุ
ค่าที่มีผลอยู่ ค่าจะมีผลตั้งแต่การใช้งานครั้งถัดไป; ส่วนเวลาหมดอายุและจำนวนครั้งลองใหม่ของไคลเอนต์จะมีผลตั้งแต่
การเชื่อมต่อครั้งถัดไป ช่วงเวลาตรวจสอบซ้ำ ประเภทและขนาดไฟล์แนบ หลักฐาน และช่วงเวลาคัดลอกข้อมูลนอกเซิร์ฟเวอร์
จะอยู่ในหน้าของตัวเองและสามารถตั้งค่าได้ทุกค่าในช่วงที่กำหนด ไม่เพียงแต่ค่าที่ตั้งไว้ล่วงหน้าเท่านั้น
ไอคอนรูปกระดิ่งในแถบด้านบนแสดงปัญหาและเปลี่ยนแปลงล่าสุดในแชทที่ถูกติดตาม; ข้อความที่ยังไม่ได้อ่าน จะถูกนับจนกว่าจะถูกทำเครื่องหมายว่าอ่านแล้ว การเปลี่ยนแปลงถูกจัดกลุ่มตามแชทและชั่วโมง ("12 ข้อความถูกลบ, 1 ข้อความถูกแก้ไข, 0 ข้อความไม่พบ") และปัญหาต่างๆ เช่น การออกจากระบบหรือพื้นที่ดิสก์เต็ม จะยังคงอยู่ในรายการ ไม่ว่าแชทจะมีความเคลื่อนไหวมากเพียงใด
เครื่องมือเพิ่มเติม → บัญชี เริ่มต้นที่ช่องกรอกหมายเลขโทรศัพท์ ต่อ นำโดยตรงสู่ การป้อนโค้ด โดยจะขอข้อมูลรับรอง API เฉพาะเมื่อขาดข้อมูลเท่านั้น การนำเข้าผ่าน QR และไฟล์เป็น แท็บทางเลือก ข้อมูลรับรอง API ที่บันทึกไว้จะถูกใช้ซ้ำได้เฉพาะภายในพื้นที่ทำงานของตัวเองเท่านั้น หน้าจอเข้าสู่ระบบไม่มีแถบด้านข้าง สถิติ หรือส่วนตั้งค่า ไอคอน การตั้งค่า การตั้งค่า ไอคอนจะเปิดการควบคุม API, พร็อกซี, พื้นที่จัดเก็บ และบัญชีเพิ่มเติม พื้นที่ทำงานใหม่จะเปิด การตั้งค่าครั้งแรก; หลังจากลงชื่อเข้าใช้ พื้นที่ทำงานที่มีแหล่งข้อมูลและบันทึกที่บันทึกไว้จะเปิดขึ้น 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 และแม่แบบบริการ
พื้นที่ทำงาน (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 ที่ลงนาม
แยกต่างหากด้วยลายนิ้วมือ/จุดตรวจสอบที่เชื่อถือได้
การสำรองข้อมูล การกู้คืนข้อมูล และการหยุดทำงาน#
- หยุดการสังเกตและยุติกระบวนการอย่างเรียบร้อย
- คัดลอกไดเรกทอรีข้อมูลทั้งหมด: ฐานข้อมูล, WAL/SHM (หากมี), media,
credentials.enc,signing.enc,network.enc, vault keys/metadata, token, checkpoints และทุกไดเรกทอรีprofiles/ - สำหรับโหมดกุญแจภายนอก (external-key mode) ให้เก็บรักษากุญแจหลัก (master key) และแต่ละ
vault.external.jsonแยกกัน การสร้างกุญแจใหม่ไม่สามารถกู้คืนความลับเดิมได้ - กู้คืนข้อมูลในขณะที่ปลายทางถูกหยุดทำงาน; ตั้งค่ากุญแจต้นฉบับ, จำกัด การเข้าถึง และตรวจสอบความสมบูรณ์ก่อนที่จะดำเนินการต่อ
- บันทึกเวลาหยุดทำงานและผลการตรวจสอบ เวลาหยุดทำงานยังคงเป็นช่องว่างที่บันทึกไว้; ภาพถ่ายประวัติจะเพิ่มสถานะหลังจากนั้น
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.
Four things are protected differently:
| อะไร | การป้องกัน |
|---|---|
| ส่งออกไฟล์โดยไม่ใช้รหัสผ่าน (ค่าเริ่มต้น) | มีลายเซ็น จึงตรวจพบการเปลี่ยนแปลงได้ ตั้งรหัสผ่านเพื่อเข้ารหัสไฟล์ส่งออก |
| ส่งออกไฟล์ด้วยรหัสผ่าน | หากตั้งรหัสผ่าน ไฟล์ที่ส่งออกเสร็จสิ้นจะถูกเก็บไว้ในรูปแบบ WinZip AES-256 ZIP ที่ 7-Zip และ WinRAR สามารถเปิดได้ โดยรหัสผ่านจะไม่ถูกเก็บไว้ (การจัดการหลักฐาน) |
| ฐานข้อมูลของบันทึกและไฟล์แนบที่เก็บไว้บนดิสก์ | ดิสก์หรือโวลุ่มที่เข้ารหัสและสิทธิ์ของโฟลเดอร์ |
| เซสชัน Telegram และกุญแจลงนาม | ถูกเข้ารหัสในโฟลเดอร์ข้อมูล (credentials.enc, signing.enc, network.enc) |
การสำรองข้อมูลแบบครบวงจรคือไดเรกทอรีข้อมูลที่ถูกหยุดไว้ตามที่อธิบายข้างต้น ไม่ใช่การส่งออก
ใช้พื้นที่จัดเก็บที่ได้รับการป้องกันและกลไกการถ่ายโอนที่ได้รับการออกแบบอย่างรอบคอบสำหรับทั้งสองกรณี การส่งออกชั่วคราวบนเซิร์ฟเวอร์จะถูกเก็บไว้ใน
temporary-exports/ ของแต่ละพื้นที่ทำงาน; คำตอบที่เสร็จสมบูรณ์จะถูกล้างออก และไฟล์การส่งออกที่ถูกขัดจังหวะ
จะถูกลบออกในการเริ่มต้นระบบครั้งต่อไป ในขณะที่ล็อกอินสแตนซ์ของพื้นที่ทำงานนั้นยังคงถูกถืออยู่
หลังจากเกิดเหตุการณ์การกู้คืนการเชื่อมต่อ ผู้รวบรวมจะขอข้อมูลอัปเดตที่พลาดไปจาก ตำแหน่งอัปเดตที่บันทึกไว้ งานสื่อที่คงอยู่และตำแหน่งอัปเดตของ Telegram จะยังคงอยู่หลังการเริ่มต้นใหม่; ดู รูปแบบหลักฐาน
ความจุและการเก็บรักษา#
ขีดจำกัดเริ่มต้น ซึ่งสามารถปรับเปลี่ยนได้ทั้งหมดภายใต้ 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 ชั่วโมง (ดู ระดับการตรวจซ้ำ) การส่งออกที่ป้องกันด้วยรหัสผ่านทำงานตามที่อธิบายไว้ข้างต้น การเข้าถึงแบบจำกัดขอบเขตมีเอกสารอยู่ใน การเข้าถึงและสิทธิ์ ดู READINESS.md, LIVE_ACCEPTANCE.md และ VERIFICATION.md