TgWitness / เอกสาร

สิ่งที่ได้รับการทดสอบแล้ว →

อ้างอิง / การตั้งค่า

Telegram · เริ่มต้นอย่างรวดเร็ว

ทุกวิธีในการติดตั้งและเปิดใช้งาน TgWitness: แพ็กเกจ Windows, Python, Docker และเดโมจำลอง พร้อมขั้นตอนตรวจสอบเบื้องต้น

TgWitness / เอกสารประกอบ

เริ่มต้นใช้งาน

ภาษาอังกฤษ · Русский · ภาษายูเครน · Español · Português (Brasil) · ภาษาตุรกี · العربية · فارسی · اردو · हिन्दी · ภาษาอินโดนีเซีย · Tiếng Việt · ภาษาจีนตัวย่อ

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

มาครั้งแรก? ลองดูเดโมก่อนที่จะเชื่อมต่อบัญชี เลือกคู่มือสำหรับพร็อกซี, พยาน, การส่งออก หรือการตั้งค่าเซิร์ฟเวอร์ GitHub Actions capture (preview) ดำเนินการจับภาพใน GitHub fork ของคุณเอง แทนที่จะติดตั้งในเครื่องท้องถิ่น

ติดตั้งและเริ่มใช้งาน#

โปรแกรมติดตั้งแบบมีคู่มือมาพร้อมกับ Python ของตัวเอง และจะตรวจสอบแฮชของแพ็กเกจและลายเซ็นการปล่อย ก่อนการติดตั้ง การเรียกใช้โปรแกรมนี้อีกครั้งจะอัปเดตการติดตั้งที่มีอยู่

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"

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

วิธีอื่น ๆ#

การปล่อยเวอร์ชันบน GitHub, โค้ดต้นฉบับ และ Docker เป็นทางเลือกแทนโปรแกรมติดตั้ง ไฟล์ดาวน์โหลดแบบพกพา จะพร้อมใช้งานหลังจากที่เวอร์ชันที่ปล่อยออกมาถูกเผยแพร่:

ผู้ดูแล ไม่ต้องติดตั้งอะไรทั้งสิ้น จากแหล่งที่มา: Python 3.11+ Docker: Engine/Desktop พร้อม Compose 2.20+
Windows คัดลอก TgWitness-<version>-windows-amd64-portable.zip จาก GitHub Releases แล้วคลิกสองครั้งที่ TgWitness.cmd คลิกสองครั้งที่ Start.cmd คลิกสองครั้งที่ scripts\Docker.cmd
Linux / macOS — sh start.sh sh scripts/docker-start.sh

สำหรับวิธีรันจากซอร์สโค้ด ให้ดาวน์โหลดและแตกไฟล์จากกิ่ง main ปัจจุบัน หรือโคลนรีพอสิทอรี:

git clone https://github.com/phishdestroy/TgWitness.git
cd TgWitness

Start.cmd จะเสนอให้ติดตั้ง Python 3.12 สำหรับผู้ใช้ Windows ของคุณหากไม่พบ Python ที่เหมาะสม (ผ่าน winget หรือตัวติดตั้งที่ลงนามรับรองจาก python.org) ส่วน start.sh จะแสดงคำสั่งติดตั้งที่ตรงกับดิสทริบิวชัน Linux หรือ macOS ของคุณหากยังไม่มี Python การเปิดใช้งานจากซอร์สโค้ดครั้งแรกจะสร้าง .venv และติดตั้งไลบรารีที่จำเป็นโดยอัตโนมัติ

Docker สร้างแอปพลิเคชันและเริ่มทำงานในพื้นหลัง; ไม่จำเป็นต้องใช้ Python บนเครื่องโฮสต์ scripts\Docker.cmd และ scripts/docker-start.sh จะแสดงที่อยู่ของแผงควบคุมและโทเค็นเมื่อ คอนเทนเนอร์ทำงานปกติ คำสั่ง Docker ที่เทียบเท่ากันบนทุกเครื่องโฮสต์ที่รองรับคือ:

docker compose up -d --build --wait
docker compose exec tgwitness cat /data/panel-token.txt

เปิด http://127.0.0.1:8787 ใช้โทเค็นที่พิมพ์โดย Docker helper หรือคำสั่ง Docker ที่สอง หรืออ่านไฟล์ data/live/panel-token.txt สำหรับการติดตั้งแบบพกพาหรือจากซอร์สโค้ด ต่อที่ Connect Telegram ด้านล่าง การติดตั้งแบบเนทีฟและ Docker ใช้พื้นที่จัดเก็บข้อมูลแยกกัน; การเริ่มต้น Docker จะไม่นำเข้าบันทึกแบบเนทีฟที่มีอยู่

สำหรับเซิร์ฟเวอร์ การติดตั้งรวมถึง HTTPS อัตโนมัติ การรีสตาร์ท การเผยแพร่ภาพ การอัปเดต และการสำรองข้อมูล

สำรวจอินเทอร์เฟซ#

  1. เรียกใช้ TgWitness-Demo.cmd ในแพ็กเกจแบบพกพา, scripts\Demo.cmd ในโฟลเดอร์แหล่งที่มาของ Windows หรือ sh start.sh --demo บน Linux/macOS การเรียกใช้จากแหล่งที่มาจะสร้าง .venv ก่อนและติดตั้งส่วนที่จำเป็น
  2. เปิด http://127.0.0.1:8787.
  3. การสาธิตในเครื่องจะเปิดสมุดบันทึกตัวอย่างโดยอัตโนมัติ ไม่จำเป็นต้องคัดลอกโทเค็นเพื่อเข้าถึงโดยตรงในเครื่อง

ข้อความตัวอย่างเป็นข้อความสมมติ โหมดสาธิตไม่สามารถเชื่อมต่อกับบัญชี Telegram ที่จริงได้

เชื่อมต่อ Telegram#

[!WARNING] ใช้บัญชีที่จัดไว้เฉพาะ Telegram อาจจำกัดหรือแบนบัญชีอย่างถาวรสำหรับปริมาณคำขอ ที่ถือว่าเกินขีดจำกัด ไม่ว่าใช้ไคลเอนต์ใดก็ตาม เชื่อมต่อบัญชีที่เตรียมไว้สำหรับ การสังเกตการณ์แทนที่จะใช้บัญชีส่วนตัวหรือบัญชีที่มีค่า และสร้าง API ID / hash บน บัญชีที่จัดไว้เฉพาะ

  1. หากเดโมในระบบกำลังทำงานอยู่ ให้หยุดมันลงและเรียกใช้ Start.cmd หรือ sh start.sh หากไม่เช่นนั้น ให้ปล่อยให้การติดตั้งแบบสดที่เปิดไว้ข้างต้นทำงานต่อไป
  2. ใช้โทเค็นแผงควบคุมเพื่อลงชื่อเข้าใช้ พื้นที่ทำงานใหม่จะเปิดขึ้นพร้อมขั้นตอนการตั้งค่าเริ่มต้น เลือก ดาวน์โหลดเท่านั้น, ติดตามการสนทนา หรือ หลักฐาน สำหรับกรณีหนึ่ง
  3. ตรวจสอบการตรวจสอบการเชื่อมต่อ ตั้งค่าพร็อกซีของคุณเองหากจำเป็น; การตั้งค่าการเชื่อมต่อ ยังคงใช้งานได้หลังการตั้งค่า
  4. ใน Connect Telegram ให้เลือกหมายเลขโทรศัพท์ รหัส QR ไฟล์บัญชี (TData, .session, StringSession, JSON ของบัญชี) หรือกุญแจการอนุญาตแบบครบถ้วน ให้ทำตามขั้นตอนการยืนยัน Telegram รหัส และรหัสผ่านสองขั้นตอนเมื่อได้รับการร้องขอ
  5. ตรวจสอบบัญชีที่แสดงอยู่ เลือกการสนทนา และตรวจสอบการตั้งค่าของคุณ เสร็จสิ้น จากหน้าจอสุดท้าย สำหรับตัวเลือก ดาวน์โหลดเท่านั้น (Just download) การคลิก เริ่มส่งออก (Start export) จะเริ่มการส่งออกครั้งเดียว และเปิดหน้า การส่งออก (Exports) เพื่อแสดงความคืบหน้า; การนี้ไม่เปิดใช้งานการสังเกตการณ์อย่างต่อเนื่อง

หลังการตั้งค่าเสร็จสิ้น การเลือก Chats → Choose จะเปลี่ยนการเลือกแชทที่เลือกไว้ การตั้งค่าควบคุม การเก็บรวบรวมและไฟล์; More tools → Sources ให้รายชื่อแหล่งที่มาอย่างละเอียด ในระดับ Standard หรือ Expert คู่มือบนแผงควบคุมอธิบายส่วนหลักทั้งหก และตัวควบคุมตามบริบทของแต่ละส่วน

API ID + Hash เป็นตัวเลือก: พื้นที่ทำงานจะใช้คู่ที่บันทึกหรือนำเข้าไว้ หรือคู่ที่ใช้งานได้จากกลุ่มที่มีอยู่ภายในระบบ หากต้องการใช้แอปของคุณเอง ให้วางคู่ API ID:API Hash ลงในช่อง API ID สำหรับ Auth key ให้วางตัวอักษรฐานสิบหกทั้งหมด512 ตัว และเลือก DC ID ที่ให้มา User ID เป็นตัวเลือกและจะได้รับการตรวจสอบหากมีการป้อนข้อมูล

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

สำหรับบัญชีที่มีอยู่แล้ว ให้ดูรูปแบบบัญชีและเซสชัน: แผงควบคุมนี้รองรับ Telethon StringSession, Telethon/Pyrogram SQLite, TData ZIP สำหรับบัญชีเดียว และ JSON ของบัญชีที่ได้รับการสนับสนุน ให้เลือกเซสชันและไฟล์ JSON ที่เกี่ยวข้องพร้อมกัน กด Check files แล้วกด Connect account การเข้าสู่ระบบด้วย QR Code ก็ใช้งานได้เช่นกัน พร้อมกับการตั้งค่า API ที่เลือกได้เช่นเดียวกัน TDLib, เซสชันบอท และรายการบัญชี CSV/JSON ไม่ได้รับการสนับสนุน

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

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

โทเค็นแผงสด (live panel token) ปกป้องการเข้าถึงสิทธิ์ Telegram ของคุณและ ข้อมูลที่บันทึกไว้; โทเค็นนี้แยกต่างหากจากข้อมูลรับรอง API ของ Telegram มีเพียงการสาธิตท้องถิ่นที่ ถูกเริ่มต้นอย่างชัดเจนและเข้าถึงโดยตรงเท่านั้นที่จะได้รับการเข้าถึงอัตโนมัติ ส่วนการสาธิตจากระยะไกลหรือผ่านพร็อกซีจะยังคงใช้ data/demo/panel-token.txt

ตรวจสอบและส่งออก#

  • บันทึก: ค้นหาและกรองข้อมูลการสังเกตตามแหล่งที่มาและประเภทเหตุการณ์
  • เลือกเหตุการณ์เพื่อตรวจสอบบันทึกต้นฉบับ แหล่งที่มา และเวอร์ชันที่เก็บไว้
  • รายละเอียดการแก้ไขแสดงเนื้อหาที่มีอยู่ก่อนและหลังการแก้ไข ส่วนรายละเอียดการลบแสดง เนื้อหาที่ถูกบันทึกไว้ครั้งสุดท้าย (หากมี); ส่วนผู้กระทำที่ไม่ทราบตัวตนจะยังคงไม่ทราบตัวตน
  • รูปแบบการส่งออก: ZIP ที่มีลายเซ็น, JSONL, CSV และ HTML สำหรับใช้งานแบบออฟไลน์
  • การส่งออกแชทแบบเต็ม (Chats → Export chat หรือ Exports → Capture or export one chat): ดาวน์โหลดประวัติการสนทนาที่มองเห็นได้ทั้งหมด ของแชทหนึ่งเป็นแพ็กเกจที่ลงนามแล้ว พร้อมด้วย chat.json (สไตล์ Telegram-export) และ chat.html ที่อ่านได้ แชทส่วนตัวจะทำงานได้เมื่อบัญชีเป็นสมาชิก นี่คือ ภาพถ่ายปัจจุบัน ไม่ใช่การสร้างใหม่ของข้อความที่ถูกลบหรือแก้ไขไปแล้ว ตรวจสอบ สำเนาด้วย python verify.py chat-export.zip --fingerprint TRUSTED_SHA256
  • จุดตรวจสอบ: รักษาขอบเขตของบันทึกที่มีลายเซ็นให้อยู่นอกตัวเก็บข้อมูล
  • ดาวน์โหลดใบยืนยันการดำเนินการที่ลงนาม: เพื่อเก็บรักษาบันทึกโปรแกรม/เวอร์ชันของผู้เก็บข้อมูล
  • เตรียมคำขอเวลาประทับ: เตรียมคำขอแบบออฟไลน์ไปยังหน่วยงานออกเวลาประทับ; ทำตาม TIMESTAMP.md เพื่อรับและตรวจสอบคำตอบ
  • ตรวจสอบบันทึก: ตรวจสอบลายเซ็นของเหตุการณ์และลิงก์ในห่วงโซ่ ZIP export ยังตรวจสอบสื่อด้วย

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

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

สำหรับพื้นที่ทำงานอื่น ให้เพิ่ม --profile ID โดยใช้ Exports → Workspace ID สำหรับเซิร์ฟเวอร์ระยะไกล ให้เพิ่ม --url https://your-server ขีดจำกัดการถ่ายโอนข้อมูลตามค่าเริ่มต้นคือ 5 GiB; --max-mib สามารถปรับเปลี่ยนค่านี้ได้ เนื้อหา ZIP ที่ลงนามมีขีดจำกัดการตรวจสอบแบบไม่บีบอัด4 GiB แยกต่างหากตามค่าเริ่มต้น (More tools → Parameters สามารถเพิ่มขีดจำกัดนี้ได้; ตรวจสอบไฟล์เก็บถาวรดังกล่าวด้วย verify.py --max-gib N) ตรวจสอบไฟล์เก็บถาวรโดยใช้สำเนาที่เชื่อถือได้ของตัวตรวจสอบ, ลายนิ้วมือกุญแจที่เก็บรักษาไว้อย่างอิสระ และเพื่อหลักฐานขั้นต่ำ ให้ใช้ใบรับรองรากของหน่วยงาน ประทับเวลา (--tsa-ca)

ตรวจสอบการติดตั้ง#

python start.py --setup-only
python start.py --check
python start.py --check --json

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

โปรแกรมติดตั้งจะติดตั้งลงใน .venv คำสั่งเสริม python -m tgwitness... ต้อง ใช้ .venv\Scripts\python.exe บน Windows หรือ .venv/bin/python บน Linux/macOS, เว้นแต่สภาพแวดล้อมนั้นได้ถูกเปิดใช้งานแล้ว

เซสชัน การป้องกัน และการดำเนินงาน#

ไฟล์ Telethon SQLite .session ที่ปิดและสอดคล้องกันสามารถแปลงได้บนเครื่องท้องถิ่นด้วย python -m tgwitness.sessions account.session --out account.tgwitness-session แล้ว โหลดใน More tools → Account → Files การนำเข้าไฟล์โดยตรงและการเข้าสู่ระบบด้วย QR Code ก็มีให้ใช้เช่นกัน ดู CONNECTION-SECURITY.md สำหรับรูปแบบการเข้าสู่ระบบ SOCKS5, HTTP CONNECT, MTProxy และกุญแจหลักภายนอก

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

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

อ่าน OPERATIONS.md สำหรับการสำรอง/กู้คืนข้อมูล, DEPLOYMENT.md สำหรับการโฮสต์, และ deploy/ สำหรับตัวอย่างการใช้งานบริการ แผงควบคุมที่ติดตั้ง ยังรวมถึงคู่มือการตั้งค่าแบบออฟไลน์ที่ /guide.html

การตรวจสอบจริงและข้อจำกัดที่ยังเหลืออยู่ ถูกบันทึกไว้ในไฟล์ VERIFICATION.md และ READINESS.md.