อ้างอิง / การตั้งค่า
Telegram · การติดตั้ง
เรียกใช้ TgWitness ในรูปแบบบริการบน Windows, Linux, macOS หรือ Docker ผ่าน HTTPS พร้อมด้วยระบบสำรองข้อมูลและการอัปเดต
ภาษาอังกฤษ · Русский · ภาษายูเครน · Español · Português (Brasil) · ภาษาตุรกี · العربية · فارسی · اردو · हिन्दी · ภาษาอินโดนีเซีย · Tiếng Việt · ภาษาจีนตัวย่อ
เลือกวิธีการติดตั้ง#
สำหรับแพ็กเกจแบบพกพา ให้สกัดไฟล์TgWitness-<version>-windows-amd64-portable.zipจาก
GitHub Releases สำหรับวิธีอื่น ๆ ให้ดาวน์โหลดและสกัดไฟล์ ZIP แหล่งที่มา หรือคัดลอก
repository แล้วเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีของโครงการ:
| การติดตั้ง | เริ่ม | ทำงานในพื้นหลังหรือไม่? |
|---|---|---|
| แพ็กเกจแบบพกพาสำหรับ Windows | TgWitness.cmd |
ไม่; ให้หน้าต่างเปิดไว้ |
| Windows ฉบับดั้งเดิม | Start.cmd |
ไม่; ใช้任务การลงชื่อเข้าระบบแบบเลือกใช้สำหรับการทำงานในพื้นหลัง |
| รองรับ Linux/macOS โดยตรง | sh start.sh |
ไม่; ใช้ systemd/launchd สำหรับการทำงานในพื้นหลัง |
| Docker บนโฮสต์ใดก็ตามที่ได้รับการสนับสนุน | docker compose up -d --build --wait |
ใช่ครับ ในขณะที่ Docker daemon กำลังทำงานอยู่ |
| เครื่องมือช่วยเหลือ Docker บน Windows | scripts\Docker.cmd |
ใช่; โปรแกรมช่วยจะรอตรวจสอบสถานะความพร้อมของเว็บเซิร์ฟเวอร์ |
| เครื่องมือช่วยเหลือ Docker บน Linux/macOS | sh scripts/docker-start.sh |
ใช่; โปรแกรมช่วยจะรอตรวจสอบสถานะความพร้อมของเว็บเซิร์ฟเวอร์ |
สำหรับเซิร์ฟเวอร์คลาวด์ที่ฝ่ายที่สามสามารถตรวจสอบได้ — ซึ่งสร้างขึ้นผ่าน API ของผู้ให้บริการ โดยไม่ใช้ SSH และเข้าถึงได้เฉพาะผ่าน Cloudflare Tunnel — ดู การปรับใช้ระดับความมั่นใจสูง
เมื่อเริ่มต้นระบบจะสร้าง.venvส่วนตัวและติดตั้งส่วนประกอบที่จำเป็น
Docker จะสร้างส่วนประกอบเหล่านี้ภายในภาพ (image) โดยไม่จำเป็นต้องใช้ Python ของเครื่องโฮสต์ การตั้งค่าครั้งแรก
จำเป็นต้องมีการเชื่อมต่ออินเทอร์เน็ต เมื่อไม่พบ Python 3.11+ ระบบStart.cmd จะขอความยินยอมก่อน
ติดตั้ง Python 3.12 สำหรับผู้ใช้ Windows ปัจจุบัน (ผ่าน winget หรือตัวติดตั้งจาก python.org
หลังจากตรวจสอบลายเซ็นของ Python Software Foundation); ระบบจะไม่ขอ
สิทธิ์ผู้ดูแลระบบ Docker และบริการระบบปฏิบัติการยังคงเป็นข้อกำหนดเบื้องต้น
การติดตั้งแบบเนทีฟและแบบพกพาใช้ data/live ภายในโฟลเดอร์ของตัวเอง Docker ใช้โวลุ่มที่ตั้งชื่อว่า tgwitness-data
ที่ /data การติดตั้งเหล่านี้เป็นระบบที่แยกกันจนกว่าคุณจะย้าย
ไดเรกทอรีข้อมูลทั้งหมดอย่างตั้งใจ อย่าคาดหวังว่าคอนเทนเนอร์ Docker ใหม่จะค้นพบบัญชีแบบเนทีฟ
ได้โดยอัตโนมัติ
ข้อกำหนดการติดตั้ง#
การติดตั้งแบบเนทีฟต้องการ Python 3.11 หรือเวอร์ชันใหม่กว่า พร้อมด้วย venv และ ensurepip, การเข้าถึงอินเทอร์เน็ต
สำหรับการติดตั้งความพึ่งพาแรก และไดเรกทอรีโครงการที่สามารถเขียนได้สำหรับ
.venv แผงควบคุมที่มาพร้อมชุดไม่ต้องการ Node.js หรือการสร้างส่วนหน้า (frontend) ให้เรียกใช้โปรแกรมเริ่มต้นจาก
บัญชีระบบปฏิบัติการปกติของคุณ; TgWitness ไม่ต้องการสิทธิ์ผู้ดูแลระบบ/root
- Windows:
Start.cmdตรวจสอบpy -3ก่อน แล้วpythonต่อ ตามด้วยโฟลเดอร์ติดตั้งตามค่าเริ่มต้นของผู้ใช้แต่ละคนและ โฟลเดอร์ Program Files และต้องการเวอร์ชัน 3.11 หรือใหม่กว่า หากไม่มีอันใดทำงานได้ มัน จะเสนอการติดตั้งอัตโนมัติตามผู้ใช้แต่ละคนตามที่อธิบายไว้ข้างต้นpy -3 start.pyก็ทำงานได้เช่นกัน แพ็กเกจแบบพกพาไม่ต้องการ Python เลย - Linux:
start.shจะลองpython3.13,python3.12,python3.11,python3และpythonแล้วแสดงคำสั่งติดตั้งสำหรับ apt, dnf, pacman, zypper, apk หรือ Homebrew เมื่อไม่มีตัวเลือกใดที่ตรงกัน การติดตั้งบน Debian/Ubuntu อาจจำเป็นต้องใช้แพ็กเกจpython3-venvที่ตรงกับตัวแปลภาษาที่เลือก Python ค่าเริ่มต้นที่เก่าของระบบปฏิบัติการต้องถูกแทนที่หรือเสริมด้วย Python 3.11+ - macOS: ติดตั้ง Python 3.11+ เวอร์ชันล่าสุด; อย่าสมมติว่า
ตัวแปลภาษาที่ระบบปฏิบัติการจัดให้ตรงตามข้อกำหนด ใช้
python3 start.pyจากไดเรกทอรีของโครงการ - Docker: ใช้ Docker Engine/Desktop พร้อม Compose v2.20 หรือเวอร์ชันใหม่กว่า Docker Desktop ต้องใช้คอนเทนเนอร์ Linux บน Windows คอนเทนเนอร์จะติดตั้ง ไลบรารี Python ที่จำเป็นด้วยตัวเอง; ระบบโฮสต์ไม่จำเป็นต้องติดตั้ง Python แยกต่างหาก
คอมพิวเตอร์ท้องถิ่น#
ใช้ Start.cmd บน Windows หรือ sh start.sh บน Linux/macOS. scripts\Setup.cmd หรือ
sh start.sh --setup-only จะเตรียม
สภาพแวดล้อมให้พร้อมใช้งาน โปรแกรมเปิดตัวจะติดตั้งส่วนประกอบที่จำเป็นเมื่อใช้ครั้งแรก; การเปิดใช้งาน
ครั้งต่อไปจะใช้สภาพแวดล้อมเดิม การเข้าถึงอินเทอร์เน็ตจำเป็นสำหรับการตั้งค่าและการเก็บรวบรวมข้อมูล Telegram,
แต่การดูบันทึกที่มีอยู่และการสร้างไฟล์ส่งออกสามารถทำได้แบบออฟไลน์
เรียกใช้ python start.py --check หลังจากติดตั้งเพื่อตรวจสอบการพึ่งพาในระบบท้องถิ่น Ed25519,
พื้นที่จัดเก็บข้อมูล การตั้งค่ากุญแจ และที่อยู่รับฟัง โดยไม่ต้องเริ่มทำงานของตัวเก็บข้อมูล
ใช้ --json เพื่อรับผลลัพธ์ที่มีโครงสร้าง ส่งค่า --data-dir, --host และ
--port ที่ต้องการ การตรวจสอบนี้ไม่ติดตั้งแพ็กเกจ ไม่สร้างบันทึก และไม่เชื่อมต่อ Telegram;
นี่ไม่ใช่การตรวจสอบความสมบูรณ์หรือความครอบคลุม ระบบจะตรวจสอบ
บันทึกที่มีอยู่แยกต่างหาก python start.py --help ยังหลีกเลี่ยงการติดตั้งด้วย
หลังจากใช้ start.py แล้ว ให้เรียกใช้คำสั่งเสริมด้วย .venv\Scripts\python.exe บน
Windows หรือ .venv/bin/python บน Linux/macOS หรือเปิดใช้งานสภาพแวดล้อมนั้นก่อน
ตัวอย่าง python -m ... ด้านล่างนี้สมมติว่าสภาพแวดล้อมดังกล่าวได้เปิดใช้งานแล้ว
python -m tgwitness --data-dir /path/to/private/data --host 127.0.0.1 --port 8787
ตัวแปรสภาพแวดล้อม: TGWITNESS_DATA, TGWITNESS_HOST, TGWITNESS_PORT, TGWITNESS_TOKEN. TGWITNESS_VAULT_KEY_FILE เลือกโหมดกุญแจภายนอกสำหรับการติดตั้งใหม่; ดู กุญแจหลักภายนอก. TGWITNESS_TOKEN หากกำหนดไว้ ต้องมีอย่างน้อย24 ตัวอักษร; ใช้ค่าสุ่ม ทางเข้ารหัส หากไม่กำหนด แอปจะสร้างโทเค็นสุ่ม256 บิตในไฟล์ panel-token.txt การกำหนดค่าทับในสภาพแวดล้อมจะไม่เขียนทับไฟล์ดังกล่าว ให้รีสตาร์ทเพื่อหมุนเวียนข้อมูลรับรอง
มีเพียงกระบวนการเดียวเท่านั้นที่สามารถเป็นเจ้าของไดเรกทอรีข้อมูลได้ ระบบล็อกไฟล์ข้ามแพลตฟอร์มของระบบปฏิบัติการจะป้องกัน การเขียนข้อมูลพร้อมกันโดยไม่ได้ตั้งใจ ให้ใช้ Uvicorn worker เพียงหนึ่งตัว แผงควบคุมสามารถจัดการพื้นที่ทำงานได้ไม่จำกัด โดยมีไดเรกทอรีพื้นที่ทำงานเพิ่มเติมอยู่ภายใต้ profiles/<id>/. สำหรับอินสแตนซ์บริการที่แยกกัน ให้ใช้ไดเรกทอรีและพอร์ตที่ต่างกัน ไฟล์ WAL ของ SQLite ต้องเก็บไว้ในพื้นที่จัดเก็บข้อมูลถาวร แบบท้องถิ่น ไม่ใช่ในระบบไฟล์เครือข่าย อย่าใช้โวลุ่มเดียวกันระหว่างรีพลิกา
แพ็กเกจแบบพกพาสำหรับ Windows#
ทุกเวอร์ชันที่เผยแพร่บน GitHub จะประกอบด้วย TgWitness-<version>-windows-amd64-portable.zip และ
.sha256 ซึ่งประกอบด้วย Python 3.12 เวอร์ชันรันไทม์อย่างเป็นทางการที่สามารถฝังได้จาก python.org
(ค่า checksum ถูกตรึงไว้ใน tools/build_portable.py), TgWitness และไลบรารีที่จำเป็นซึ่งถูกตรึงไว้,
รวมถึงตัวเปิดใช้งานสามตัว:
| ไฟล์ | วัตถุประสงค์ |
|---|---|
TgWitness.cmd |
เปิดแผงควบคุม; ตัวเลือกเพิ่มเติมจะถูกส่งผ่าน เช่น TgWitness.cmd --port 8790 |
TgWitness-Demo.cmd |
เริ่มการสาธิตจำลองที่ data\demo |
TgWitness-Check.cmd |
ดำเนินการตรวจสอบความพร้อมโดยไม่เริ่มระบบ |
พจนานุกรมรูปคำภาษารัสเซียที่ถูกตรึงไว้และโปรไฟล์สี PDF ถูกรวมไว้เพื่อ
ใช้งานแบบออฟไลน์ การแพ็กเกจอนุญาตให้ใช้เฉพาะเส้นทางไฟล์ที่ทราบอยู่ภายในไดเรกทอรี
data ของ dependency เท่านั้น; ไฟล์ที่ไม่คาดคิดในไดเรกทอรีเหล่านั้นจะทำให้การสร้างล้มเหลว
แตกไฟล์อาร์ไคฟ์ทั้งหมดไปยังโฟลเดอร์ที่สามารถเขียนได้ เช่น Documents\TgWitness; อย่า
เรียกใช้จากภายในไฟล์ ZIP หรือจากโฟลเดอร์ Program Files เนื่องจากระบบรันไทม์ใช้เส้นทางโมดูลที่แยกออกมา
ดังนั้นการติดตั้ง Python อื่น ๆ และ PYTHONPATH จึงไม่ส่งผลต่อมัน ข้อมูลจะเก็บอยู่ใน
โฟลเดอร์ data ของแพ็กเกจ เพื่ออัปเดต ให้หยุด TgWitness ก่อน จากนั้นแตกไฟล์เวอร์ชันใหม่ไปยัง
โฟลเดอร์ใหม่ และคัดลอกโฟลเดอร์ data ไปยังโฟลเดอร์เดิม
ติดตั้งด้วยตัวเองบน Windows 64-bit ด้วย Python 3.12:
python tools/build_portable.py
Container#
docker compose up -d --build --wait
สิ่งนี้สร้าง volume ที่คงที่และมีชื่อสำหรับ /data
พอร์ตเว็บถูกแมปไปยัง 127.0.0.1:8787 กระบวนการทำงานด้วย UID 10001 พร้อมความสามารถที่ถูกตัดทอน
ระบบไฟล์รูทแบบอ่านอย่างเดียว และ /data กับ /tmp ที่สามารถเขียนได้
--wait ตรวจสอบสภาพความพร้อมของเว็บเซิร์ฟเวอร์ก่อนที่จะส่งคืน; การอนุญาตและการส่งข้อความของ Telegram
จะปรากฏในแผงควบคุม ตัวช่วยที่จัดเตรียมไว้ใช้ระยะเวลาหมดเวลาความพร้อม 180 วินาที
หลังการสร้าง การดาวน์โหลดความพึ่งพาเบื้องต้นอาจใช้เวลานานกว่านั้น
ไฟล์ Compose ฐานทั้งสองใช้ชื่อโครงการ tgwitness ดังนั้นการสกัดเวอร์ชันใหม่
ไปยังไดเรกทอรีอื่นจะไม่เลือกโวลุ่มข้อมูลใหม่โดยอัตโนมัติ ให้รักษาการปรับใช้
เพียงหนึ่งเดียวที่ทำงานอยู่สำหรับโครงการนั้น สำหรับการติดตั้งแบบอิสระ ให้ใช้
docker compose -p NAME ... ที่ไม่ซ้ำกันและพอร์ตโฮสต์ที่ต่างกัน และรักษาทั้งสองไว้เมื่อมีการอัปเดต
สำหรับการปรับใช้เวอร์ชันเก่าที่ใช้ชื่อโครงการต่างออกไป ให้ใช้ชื่อเดิม
ร่วมกับ -p; docker compose ls จะแสดงรายการโครงการที่มีอยู่
คัดลอก deploy/env.example ไปยัง .env และเปลี่ยน TGWITNESS_PORT เพื่อใช้พอร์ต loopback
ที่ต่างกัน ตัวอย่างเช่น TGWITNESS_PORT=8788 เปิดแผงควบคุมที่
http://127.0.0.1:8788; คอนเทนเนอร์ยังคงรับฟังที่พอร์ต 8787 .env ถูก Git-ignored
รับโทเค็นเริ่มต้น:
docker compose exec tgwitness cat /data/panel-token.txt
คำสั่งที่มีประโยชน์:
docker compose ps
docker compose logs --tail 100 -f
docker compose stop
docker compose up -d --wait
restart: unless-stopped จะรีสตาร์ทตัวเก็บข้อมูลหลังจากเกิดข้อผิดพลาดหรือเมื่อ Docker daemon
รีสตาร์ท บนเซิร์ฟเวอร์ Linux ให้เปิดใช้งาน Docker เมื่อบูตระบบโดยใช้ผู้จัดการบริการ
ของระบบปฏิบัติการของคุณ ซึ่งโดยทั่วไปคือ sudo systemctl enable --now docker บน Windows/macOS ให้เปิดใช้งาน
การตั้งค่า "เริ่มเมื่อลงชื่อเข้าใช้" ของ Docker Desktop การออกจากระบบเดสก์ท็อป การเข้าสู่โหมดสลีป หรือ Docker daemon ที่ถูกหยุด
สามารถขัดขวางการเก็บข้อมูลได้ คอนเทนเนอร์ที่ถูกหยุดอย่างชัดเจนจะยังคง
อยู่ในสถานะหยุดจนกว่าคุณจะเริ่มมันขึ้นใหม่
ในตัวอย่างการกำหนดค่านี้ ปริมาณพื้นที่ของ /tmp ถูกจำกัดไว้ที่ 512 MiB การสร้างการส่งออก
จะใช้โฟลเดอร์ temporary-exports/ ของแต่ละพื้นที่ทำงานบน /data ที่คงอยู่แทน ดังนั้นควรจัดสรรพื้นที่
ไว้ที่นั่นสำหรับการส่งออกพร้อมกัน การขยายตัวของ journal/WAL สื่อข้อมูล และการสำรองข้อมูล
โปรแกรมเปิดตัวใช้ไฟล์ deploy/constraints.txt เพื่อกำหนดเวอร์ชันที่ผ่านการรับรองของส่วนที่พึ่งพาในเวลาทำงาน
Docker และเซิร์ฟเวอร์ที่มีความปลอดภัยสูงจะติดตั้งจาก deploy/requirements.lock และ
deploy/build.lock โดยใช้ pip --require-hashes: ทุกไฟล์แพ็กเกจต้องตรงกับ SHA-256
ที่บันทึกไว้ใน commit ดังนั้นไฟล์ที่ถูกแทนที่บน PyPI หรือมิเรอร์จะถูกปฏิเสธ แพ็กเกจที่
จัดส่งเฉพาะซอร์สโค้ด (jieba, pyaes) จะถูกสร้างขึ้นโดยใช้ setuptools ที่ถูกกำหนดไว้ใน deploy/build.lock
(--no-build-isolation) โดยตัวเปิดตัว (launcher), Windows portable builder และ Dockerfile,
ดังนั้น pip จึงไม่สร้างสภาพแวดล้อมการสร้างที่แยกต่างหากและไม่ถูกกำหนดไว้ ภาพพื้นฐานของ Python
และแพ็กเกจระบบปฏิบัติการยังคงต้องผ่านการรับรองการปล่อยเวอร์ชันอย่างอิสระ
อย่าใช้คำสั่ง `docker compose down -v` เว้นแต่คุณมีเจตนาที่จะทำลายบันทึกและกุญแจ รายงานสภาพคอนเทนเนอร์แสดงถึงความพร้อมใช้งานของเว็บเซิร์ฟเวอร์ ไม่ใช่การจับข้อมูล Telegram ที่สำเร็จ ตรวจสอบสถานะของตัวเก็บข้อมูลบนแผงควบคุม สัญญาณชีพ ความผิดพลาด และเหตุการณ์การครอบคลุม
โปรไฟล์ผู้เป็นพยานอิสระ#
บริการ witness (ตัวเลือก) จะทำงานเป็นพยานอิสระใน
คอนเทนเนอร์ของตัวเอง พร้อมด้วยกุญแจและบันทึกของตัวเองในโวลุ่ม witness-data และใช้โทเค็นพยานแบบอ่านอย่างเดียว
สำหรับตัวเก็บรวบรวมเท่านั้น สร้างโทเค็นในแผงควบคุมภายใต้ More tools → Extras → Independent witness, เพิ่มมัน
พร้อมกับโทเค็นบอทและช่องไปยัง .env แล้วเริ่มโปรไฟล์:
docker compose --profile witness up -d # deploy/compose/compose.image.yaml: same flag
docker compose logs witness # witness key fingerprint
บริการนี้ติดต่อกับผู้เก็บข้อมูลภายในเครือข่าย Compose ที่ http://tgwitness:8787
(TGWITNESS_WITNESS_COLLECTOR
จะแทนที่มัน เช่น /profiles/<workspace ID>
สำหรับ
พื้นที่ทำงานอื่น) สำหรับ witness บนเซิร์ฟเวอร์แยกต่างหาก ที่ดำเนินการโดยบุคคลอื่น ให้ใช้
deploy/compose/compose.witness.yaml
ที่นั่น โดยตั้งค่า TGWITNESS_WITNESS_COLLECTOR
เป็นที่อยู่ HTTPS
ของผู้เก็บข้อมูล; ไฟล์ดังกล่าวมีเพียง witness เท่านั้น
ติดตั้งภาพระบบที่เผยแพร่แล้ว#
คัดลอก deploy/env.example ไปยัง .env ตั้งค่า TGWITNESS_IMAGE เป็นเวอร์ชันที่เผยแพร่ โดยใช้
เส้นทางรีโพสิตอรีแบบตัวพิมพ์เล็ก เช่น:
TGWITNESS_IMAGE=ghcr.io/your-owner/your-repository:0.9.3
TGWITNESS_PORT=8787
รันไฟล์นี้ด้วยตัวเอง แทนที่จะใช้compose.yaml:
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
docker compose --project-directory . -f deploy/compose/compose.image.yaml exec tgwitness cat /data/panel-token.txt
ไม่จำเป็นต้องติดตั้งแหล่งโค้ดต้นฉบับ Python หรือคอมไพเลอร์บนเครื่องโฮสต์ กระบวนการปล่อยเวอร์ชัน
มุ่งเป้าไปที่คอนเทนเนอร์ Linux AMD64 และ ARM64 รวมถึงเครื่องเสมือน Linux ของ Docker Desktop
ใช้แท็กเวอร์ชันหรือ ghcr.io/owner/repository@sha256:... จากสรุปขั้นตอนการทำงาน
ไม่มีการกำหนดค่าแท็ก latest ที่เคลื่อนย้ายได้ หรือการอัปเกรดแอปพลิเคชันแบบอัตโนมัติ ตัว
ภาพและตัวแปรแหล่งที่มาใช้ปริมาณข้อมูลเดียวกันเมื่อชื่อโครงการตรงกัน
HTTPS อัตโนมัติบนเซิร์ฟเวอร์#
ใช้เซิร์ฟเวอร์ที่มี Docker, โดเมนที่คุณควบคุมได้ และพื้นที่จัดเก็บข้อมูลท้องถิ่นแบบถาวร กำหนดให้บันทึก A/AAAA ของโดเมนชี้ไปยังเซิร์ฟเวอร์; เผยแพร่ AAAA เฉพาะเมื่อ IPv6 สามารถเข้าถึง เซิร์ฟเวอร์ได้เท่านั้น เปิดพอร์ต TCP 80 และ 443 สำหรับการรับข้อมูลเข้า และเปิด DNS/HTTPS สำหรับการส่งข้อมูลออกเพื่อการออกใบรับรอง บริการอื่น ๆ ต้องไม่ใช้พอร์ตเหล่านี้อยู่แล้ว
คัดลอก deploy/env.example ไปยัง .env และกำหนดชื่อโฮสต์ โดยไม่รวมสคีมาหรือเส้นทาง:
TGWITNESS_DOMAIN=watch.your-domain.org
เริ่มสร้างจากแหล่งต้นแบบด้วย HTTPS overlay:
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml up -d --build --wait
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml exec tgwitness cat /data/panel-token.txt
docker compose --project-directory . -f deploy/compose/compose.image.yaml -f deploy/compose/compose.https.yaml up -d --wait
สำหรับภาพที่เผยแพร่ ให้ใช้ deploy/compose/compose.image.yaml เป็นไฟล์แรกแทน ให้เก็บ
อาร์กิวเมนต์ -f ทั้งสองไว้สำหรับคำสั่ง status, logs, update และ stop ในภายหลัง
Caddy รับและต่ออายุใบรับรอง, เปลี่ยนเส้นทาง HTTP เป็น HTTPS, และส่งต่อ คำขอไปยังตัวเก็บข้อมูลบนเครือข่าย Compose ส่วนตัว สถานะของใบรับรองมี โวลุ่มถาวรเป็นของตัวเอง พอร์ตโฮสต์โดยตรงของตัวเก็บข้อมูลยังคงเป็น loopback เท่านั้น การตั้งค่า Caddy ที่ให้มาไม่เปิดใช้งานการบันทึกการเข้าถึง
เปิด https://watch.your-domain.org และป้อนโทเค็นของแผงควบคุม การเตรียมความพร้อม
ครอบคลุมคอนเทนเนอร์; การออกใบรับรองและความสามารถในการเข้าถึงจากภายนอกขึ้นอยู่กับ DNS
และไฟร์วอลล์ หาก HTTPS ยังไม่พร้อม ให้ตรวจสอบ DNS กฎไฟร์วอลล์ และ:
docker compose -f compose.yaml -f deploy/compose/compose.https.yaml logs --tail 100 caddy
ภาพ Caddy ที่ให้มาจะตามแท็ก 2-alpine ของมัน การดึงข้อมูลจะอัปเดตภาพนั้น;
หากต้องการเวอร์ชันโครงสร้างพื้นฐานที่คงที่ ให้ปักหมุด digest ที่ผ่านการทดสอบแล้วในระบบของคุณ
การอัปเดตและการสำรองข้อมูล#
รักษาชื่อโครงการ Compose และปริมาณข้อมูลให้คงเดิมระหว่างการอัปเดต ก่อนอื่นให้หยุด ตัวเก็บข้อมูล (collector) และสร้างสำเนาสำรองอย่างครบถ้วน สำหรับการติดตั้งแบบอิงแหล่งที่มา (source-based deployment) ตามค่าเริ่มต้น:
docker compose stop
docker compose cp tgwitness:/data ../tgwitness-backup-before-update
ใช้จุดหมายปลายทางสำรองข้อมูลใหม่ทุกครั้ง ซึ่งอยู่นอกรีโพสิตอรี และปกป้องมันในฐานะ ข้อมูลที่เข้าถึงได้เฉพาะบัญชีเท่านั้น เส้นทางตัวอย่างนี้ใช้เพื่ออธิบายเท่านั้น; ให้ใช้ ตำแหน่งสำรองข้อมูลส่วนตัวของคุณเอง คัดลอกไดเรกทอรีทั้งหมด รวมถึงไฟล์ที่ซ่อนอยู่ พื้นที่ทำงานทั้งหมด กุญแจ บันทึก และสื่อข้อมูล สำรองข้อมูลกุญแจหลักของ vault ภายนอกแยกต่างหาก หากมีการกำหนดค่าไว้ ไฟล์ ZIP ของหลักฐานไม่ใช่การสำรองข้อมูลแอปพลิเคชันที่สามารถกู้คืนได้ สำหรับ HTTPS ให้เก็บรักษา โวลุ่มของ Caddy ด้วย หากต้องการรักษาสถานะใบรับรอง/บัญชีไว้
สำหรับการติดตั้งจากแหล่งต้นทาง ให้ดาวน์โหลดไฟล์เวอร์ชันใหม่และรันคำสั่งต่อไปนี้:
docker compose up -d --build --wait
สำหรับการติดตั้งแบบภาพ ให้เปลี่ยน TGWITNESS_IMAGE เป็นเวอร์ชันที่ต้องการ แล้วรันคำสั่ง:
docker compose --project-directory . -f deploy/compose/compose.image.yaml pull
docker compose --project-directory . -f deploy/compose/compose.image.yaml up -d --wait
ใช้ไฟล์ Compose ของการติดตั้งของคุณสำหรับคำสั่ง stop/copy ข้างต้นด้วย
รักษา .env, การตั้งค่าแบบกำหนดเอง และชื่อโครงการให้เหมือนเดิม down เก็บ
volumes ที่มีชื่อไว้; down -v ลบพวกมันออก อย่าคัดลอก .venv ระหว่างระบบปฏิบัติการ
หรือเวอร์ชัน Python สำหรับการอัปเดตแบบเนทีฟ ให้หยุด TgWitness สำรองข้อมูล
ไดเรกทอรีข้อมูลทั้งหมด เปลี่ยนไฟล์ต้นฉบับ และรัน python start.py --setup-only ก่อนเปิดใช้งาน
ตรวจสอบการเข้าถึงแผงควบคุม, ตัวตนบัญชี, สถานะการสังเกตการณ์ และขอบเขตการครอบคลุมหลังการ อัปเดต หลังจากรีสตาร์ท TgWitness จะกลับมาที่ตำแหน่งการอัปเดต Telegram ที่บันทึกไว้และ ขอรับการอัปเดตที่พลาดไประหว่างการอัปเดต การย้อนกลับอาจ ต้องการข้อมูลสำรองก่อนการอัปเดต หากเวอร์ชันในอนาคตเปลี่ยนแปลงรูปแบบการจัดเก็บข้อมูล
เซิร์ฟเวอร์ระยะไกล#
ให้บริการนี้ผูกกับ loopback และใช้ SSH tunnel หรือยุติ HTTPS ที่
proxy กลับด้าน ไฟล์ Compose พื้นฐานใช้ได้เฉพาะในเครื่องท้องถิ่นเท่านั้น; ส่วน overlay
deploy/compose/compose.https.yaml ที่เป็นตัวเลือกจะจัดหา Caddy สำหรับโดเมนที่ตั้งค่าไว้
อย่าให้โทเค็น bearer ปรากฏใน URL และบันทึกพร็อกซี พร็อกซีแบบย้อนกลับควรจำกัด
ขนาดคำขอและอัตราการเชื่อมต่อ อย่าเปิดเผย HTTP แบบธรรมดาต่ออินเทอร์เน็ต
ตัวอย่างสำหรับ systemd, งานล็อกอิน Windows, ตัวแทนผู้ใช้ macOS และ Caddy มีให้ ในโฟลเดอร์ deploy/. โปรดตรวจสอบ/ปรับเปลี่ยนเส้นทางของพวกมันก่อนการติดตั้ง พวกมันเป็นแม่แบบที่จัดเตรียมไว้ ไม่ใช่คุณสมบัติของแพลตฟอร์มที่ทำงานในเครื่องท้องถิ่น ไม่มี บริการพื้นหลังหรืองานใดที่ถูกลงทะเบียนโดยตัวเปิดใช้งานปกติ
บน Windows การเปิดpythonw.exe แบบไม่มีหน้าต่างจะเก็บข้อมูลวินิจฉัยการเริ่มต้นระบบ/เซิร์ฟเวอร์ไว้ใน
logs/server.log ภายในไดเรกทอรีข้อมูล (5 MiB ต่อไฟล์, สำรองข้อมูลแบบหมุนเวียนสองชุด)
การเปิดผ่านคอนโซลจะเก็บบันทึกคอนโซลไว้ การบันทึกการเข้าถึง HTTP ถูกปิดใช้งานในทั้งสอง
โหมด ปกป้องบันทึกข้อมูลด้วยไดเรกทอรีข้อมูลและตรวจสอบก่อนที่จะแบ่งปัน
การเริ่มต้นใหม่และช่องว่าง#
สถานะการสังเกตการณ์ที่ขอไว้ล่าสุดจะถูกเก็บรักษาไว้ หากการสังเกตการณ์กำลังทำงานอยู่ ระบบจะพยายามเชื่อมต่อใหม่และดำเนินการต่อกับแหล่งข้อมูลที่เลือกไว้เมื่อเริ่มต้นระบบ การหยุดชั่วคราวด้วยมือจะยกเลิก ความตั้งใจนั้น การเริ่มต้นใหม่ที่ล้มเหลวจะถูกบันทึกและแสดงในแผงควบคุม
TgWitness เก็บตำแหน่งการอัปเดตของ Telegram สำหรับบัญชีและสำหรับแต่ละช่อง (pts, qts, seq และ date) ใน vault ของพื้นที่ทำงาน และกู้คืนมันเมื่อเริ่มต้นครั้งต่อไป จากนั้นไคลเอนต์จะขอการอัปเดตที่พลาดไประหว่างที่กระบวนการถูกหยุด และ การตรวจสอบซ้ำเป็นระยะจะกู้คืนข้อความที่พลาดไปและบันทึกข้อความที่ Telegram ไม่ส่งคืนอีกต่อไป บทสนทนาจะถูกโหลดใหม่เมื่อเริ่มต้น ทุกครั้งที่เริ่มต้นระบบจะบันทึก หัวบันทึกก่อนหน้า ขอบเขตออฟไลน์ และตำแหน่งการอัปเดตที่ระบบกลับมาดำเนินการต่อ ตัวตรวจสอบจะตรวจสอบการเชื่อมต่อทุก10 วินาที และเพิ่มสัญญาณชีพทุกนาที (เครื่องมือเพิ่มเติม → พารามิเตอร์ → บันทึกสถานะการทำงานทุก) การตัดการเชื่อมต่อและช่วงเวลาที่ไม่มีกิจกรรมจะถูกบันทึกเป็นช่องว่างการครอบคลุมพร้อมเหตุผล ภาพรวมประวัติจะถูกเก็บเป็นข้อมูลสังเกตการณ์ปัจจุบัน-ประวัติแยกต่างหากข้างๆ กับบันทึกแบบเรียลไทม์
คิวสื่อถูกเก็บไว้ในฐานข้อมูล SQLite ของแต่ละพื้นที่ทำงาน ข้อความและงาน ของมันถูกบันทึกแบบอะตอมิก งานที่กำลังทำงานอยู่แต่ถูกขัดจังหวะจะได้รับการกู้คืนเพื่อลองใหม่เมื่อเริ่มต้น การดาวน์โหลดแต่ละครั้งมีเวลาหมดอายุพื้นฐาน120 วินาที บวกกับเวลาตามอัตรา256 KiB/s ตามขนาดไฟล์ และ 1–2,000 MiB ต่อประเภทไฟล์แนบ; เวลาหมดอายุ ความเร็ว และการลองใหม่ ตั้งค่าได้ที่ More tools → Parameters. ตัวเก็บรวบรวม จะข้ามไฟล์ที่มีขนาดไม่ทราบ การหยุดชั่วคราวจะเก็บงานในคิวไว้ การลองใหม่จะใช้ ตัวระบุไฟล์ที่สังเกตได้เดิม ไม่เคยใช้เวอร์ชันล่าสุดของข้อความที่ถูกแก้ไขในภายหลัง ความล้มเหลวชั่วคราวมีการลองใหม่ที่จำกัด; การหยุดชั่วคราวของ Media FloodWait จะคงอยู่หลังการเริ่มต้นใหม่ การกู้คืนสื่อแยกต่างหากจากการกู้คืนการอัปเดต Telegram และไม่สามารถสร้างไฟล์ที่หายไปใหม่ได้
การสำรองข้อมูล การกู้คืนข้อมูล และความจุ#
tgwitness backup FOLDER
คัดลอกไดเรกทอรีข้อมูลในขณะที่แผงควบคุมยังคงทำงานอยู่:
เริ่มจากจุดตรวจสอบ (checkpoints) ก่อน แล้วตามด้วยไฟล์ SQLite ผ่าน API สำรองข้อมูลออนไลน์ จากนั้นเป็นคีย์ สื่อ และ
โปรไฟล์ ดังนั้นจุดตรวจสอบที่คัดลอกมาจะไม่มีอันใดที่ใหม่กว่าบันทึก (journal) ที่คัดลอกมา backup-manifest.json
ระบุ SHA-256 ของทุกไฟล์และส่วนหัวของบันทึก (journal heads) เพื่อกู้คืน ให้หยุด TgWitness และแทนที่
ไดเรกทอรีข้อมูลทั้งหมดด้วยโฟลเดอร์นั้น การเริ่มต้นครั้งต่อไปจะบันทึกว่า journal ได้รับการกู้คืน
จากสำเนาที่เก่ากว่า บันทึกนั้นจะเปรียบเทียบ journal กับส่วนหัวที่เก็บไว้ใน
TGWITNESS_STATE_DIR
ซึ่งเป็นโฟลเดอร์นอกไดเรกทอรีข้อมูล: โวลุ่ม tgwitness-state
ใน
Compose, /var/lib/tgwitness-state
ในหน่วย systemd และโฟลเดอร์สถานะท้องถิ่นของผู้ใช้
ในกรณีอื่น หากไม่มีโฟลเดอร์สถานะที่สามารถเขียนได้ การกู้คืนจะไม่ถูกตรวจพบ และบันทึกจะแจ้งเตือนเพียงครั้งเดียว
หากไม่ใช้คำสั่งนี้ ให้หยุดกระบวนการก่อนที่จะคัดลอกไดเรกทอรีข้อมูลทั้งหมด รวมถึง vault.key, signing.enc, credentials.enc, ไฟล์ฐานข้อมูล SQLite/WAL, media, token, checkpoints, และโปรไฟล์/ไดเรกทอรีย่อยทั้งหมด กู้คืน สำเนาทั้งหมดในขณะที่บริการปลายทางถูกหยุดไว้ การขาดกุญแจ vault หรือ การไม่ตรงกันของกุญแจลงนามจะทำให้การเริ่มต้นล้มเหลว; อย่าสร้างกุญแจใหม่เพื่อบังคับการเข้าถึง
เก็บสำรองข้อมูลลับไว้ในรูปแบบที่เข้ารหัสและมีการควบคุมการเข้าถึง ไฟล์ ZIP ของหลักฐานสามารถพกพาได้ ตรวจสอบหลักฐานที่บันทึกไว้ ไม่ใช่การสำรองข้อมูลแอปพลิเคชันหรือการสำรองข้อมูลเซสชัน Telegram ไม่มีระบบลบข้อมูลอัตโนมัติตามระยะเวลาที่กำหนด วางแผนพื้นที่ดิสก์สำหรับข้อความทั้งหมด เมตาดาต้าดิบ สื่อข้อมูล การส่งออกชั่วคราว และการสำรองข้อมูล
การตรวจสอบเมื่อเริ่มต้นระบบและบันทึกสตรีมการส่งออกแทนการโหลดบันทึกทั้งหมด
การส่งออกจะตรึงภาพถ่ายขณะอ่าน (read snapshot) ในขณะที่การเขียน WAL ใหม่สามารถดำเนินต่อไปได้; การส่งออกที่ใช้เวลานาน
สามารถเก็บหน้า WAL ไว้ได้ ดังนั้นความจุของดิสก์จึงยังคงมีความสำคัญ ZIP มีขีดจำกัดที่4 GiB
เมื่อไม่ถูกบีบอัด เพื่อให้สอดคล้องกับค่าเริ่มต้นของผู้ตรวจสอบอิสระ; เครื่องมือเพิ่มเติม → พารามิเตอร์ → ZIP ที่มีลายเซ็นขนาดใหญ่ที่สุด
จะเพิ่มขีดจำกัด และไฟล์เก็บถาวรดังกล่าวจะถูกตรวจสอบด้วย verify.py --max-gib N รูปแบบอื่น ๆ ไม่มีขีดจำกัดจำนวนเหตุการณ์
เบราว์เซอร์ที่รองรับจะสตรีมส่วนต่าง ๆ ของการตอบสนองไปยังไฟล์ที่ผู้ใช้เลือก เบราว์เซอร์อื่น ๆ
จะบัฟเฟอร์ได้สูงสุด128 MiB และส่งการถ่ายโอนข้อมูลที่ใหญ่กว่าไปยัง CLI ที่ได้รับการยืนยันตัวตน:
python -m tgwitness.download --token-file data/live/panel-token.txt --out evidence.zip
ใช้ --profile ID จาก Exports → Workspace ID สำหรับพื้นที่ทำงานอื่น,
--format zip|jsonl|csv|html, --url https://your-server สำหรับเซิร์ฟเวอร์ระยะไกล หรือ
--max-mib เพื่อเปลี่ยนขีดจำกัดการส่งข้อมูล 5 GiB HTTP แบบธรรมดาได้รับอนุญาตเฉพาะสำหรับ
loopback เท่านั้น โทเค็นถูกส่งผ่านในส่วนหัว การเปลี่ยนเส้นทางถูกปฏิเสธ ไฟล์ที่มีอยู่
จะไม่ถูกเขียนทับ และการดาวน์โหลดที่ไม่สมบูรณ์จะไม่ถูกเผยแพร่เป็นไฟล์ที่เสร็จสมบูรณ์
หาก TGWITNESS_TOKEN เขียนทับโทเค็นที่สร้างขึ้น ให้ใช้ไฟล์ที่ได้รับการป้องกันแยกต่างหาก
ซึ่งมีค่าที่ใช้งานอยู่: panel-token.txt จะไม่ถูกเขียนทับโดยการเขียนทับนี้
SHA-256 ของคำสั่งนี้เป็นเพียงค่าตรวจสอบการถ่ายโอนเท่านั้น; โปรดตรวจสอบ ZIP ที่ลงนามอย่างอิสระ
แผงควบคุมแสดงสื่อที่อยู่ในคิว/ล้มเหลว สื่อที่รอการประมวลผลที่เก่าที่สุด พื้นที่ดิสก์ว่าง การหยุดชั่วคราวของคำขอ Telegram และแหล่งข้อมูลที่การเข้าถึงยังไม่ได้รับการยืนยัน การวินิจฉัยเหล่านี้ไม่ใช่ ระบบตรวจสอบการส่งข้อมูลแบบ end-to-end ที่สมบูรณ์ พื้นที่ทำงานใช้กระบวนการร่วมกัน; บัญชีที่มีกิจกรรมรบกวนอาจ ยังคงส่งผลกระทบต่อบัญชีอื่นได้ กระบวนการทำงานแยกกัน การเก็บรักษา/หมุนเวียนข้อมูล การกู้คืนการอัปเดต ที่ทนทาน และการรับรองการปรับใช้อย่างเต็มรูปแบบยังคงมีอยู่ การเข้าถึงแผงควบคุมที่จำกัดขอบเขตถูกบันทึก ไว้ในส่วนการเข้าถึงและสิทธิ์; จุดตรวจสอบอิสระถูกครอบคลุมในคู่มือ ผู้เป็นพยาน
ขั้นตอนรายละเอียด: การเชื่อมต่อ/ความปลอดภัย และ โหมดการทำงาน