# Telegram · พยานอิสระ

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

เรียกใช้ witness ด้วยกุญแจและบอทของตัวเอง เผยแพร่จุดตรวจสอบที่ลงนามแล้วไปยังช่อง และตรวจสอบการส่งออกข้อมูลกับจุดตรวจสอบดังกล่าว

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

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

เรียกใช้ witness ด้วยกุญแจและบอทของตัวเอง เผยแพร่จุดตรวจสอบที่ลงนามแล้วไปยังช่อง และตรวจสอบการส่งออกข้อมูลกับจุดตรวจสอบดังกล่าว

[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/evidence/)

![หลักฐานและการตรวจสอบ](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

[ส่งออกและตรวจสอบ](https://phishdestroy.io/tgwitness/th/docs/reference/evidence/) · [ความมั่นใจสูง](https://phishdestroy.io/tgwitness/th/docs/reference/high-assurance/) · [คู่มือการใช้งานแผงควบคุม](https://phishdestroy.io/tgwitness/th/docs/reference/panel/#extras)

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

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

แผนผังกระบวนการ · Collector → Witness (จุดตรวจสอบที่ลงนาม: จำนวนบันทึก + ค่าแฮชส่วนหัว); Witness → สมุดบันทึกพยาน, กุญแจส่วนตัว; Witness → ช่อง Telegram (โพสต์ที่ลงนามผ่านบอทของระบบเอง); ไฟล์ ZIP ของหลักฐาน → verify.py; สมุดบันทึกพยาน, กุญแจส่วนตัว → verify.py; ช่อง Telegram → verify.py (t.me/s: อ่านหน้าแบบสด หรือ ส่งออกสู่เดสก์ท็อป) · Collector · Witness · สมุดบันทึกพยาน,กุญแจส่วนตัว · ช่อง Telegram · ไฟล์ ZIP ของหลักฐาน · verify.py · จุดตรวจสอบที่ลงนาม: · จำนวนบันทึก + ค่าแฮชส่วนหัว · โพสต์ที่ลงนามผ่านบอทของระบบเ · อง · t.me/s: อ่านหน้าแบบสด หรือ · ส่งออกสู่เดสก์ท็อป

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

1. Collector → Witness (จุดตรวจสอบที่ลงนาม: จำนวนบันทึก + ค่าแฮชส่วนหัว)
2. Witness → สมุดบันทึกพยาน, กุญแจส่วนตัว
3. Witness → ช่อง Telegram (โพสต์ที่ลงนามผ่านบอทของระบบเอง)
4. ไฟล์ ZIP ของหลักฐาน → verify.py
5. สมุดบันทึกพยาน, กุญแจส่วนตัว → verify.py
6. ช่อง Telegram → verify.py (t.me/s: อ่านหน้าแบบสด หรือ ส่งออกสู่เดสก์ท็อป)

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

- [สิ่งที่ผู้สังเกตการณ์เก็บรักษาไว้](https://phishdestroy.io/tgwitness/th/docs/reference/witness/#what-the-witness-holds)
- [สิ่งที่เครื่องมือนี้ตรวจสอบและบันทึก](https://phishdestroy.io/tgwitness/th/docs/reference/witness/#what-it-checks-and-records)
- [เรียกใช้พยาน](https://phishdestroy.io/tgwitness/th/docs/reference/witness/#run-a-witness)
- [หน้าหลักฐานสาธารณะสำหรับพื้นที่ทำงานหลายแห่ง](https://phishdestroy.io/tgwitness/th/docs/reference/witness/#public-proof-page-for-several-workspaces)
- [ตรวจสอบ](https://phishdestroy.io/tgwitness/th/docs/reference/witness/#verify)

## สิ่งที่ผู้สังเกตการณ์เก็บรักษาไว้

| TgWitness มี | พยานไม่เคย |
| --- | --- |
| **โทเค็นพยาน**แบบอ่านอย่างเดียวสำหรับพื้นที่ทำงานหนึ่งแห่ง | เซสชัน Telegram หรือข้อมูลรับรอง API ของผู้เก็บข้อมูล |
| กุญแจ Ed25519 และบันทึกของตัวเอง | ห้องเก็บรักษาข้อมูลของระบบเก็บรวบรวม, กุญแจลงนาม หรือ โทเค็นแผงควบคุม |
| โทเค็นบอท Telegram ของตัวเอง | เนื้อหาข้อความ: ส่วนหัวประกอบด้วยจำนวนบันทึกและค่าแฮช |

โทเค็นถูกสร้างขึ้นใน **More tools → Extras → Independent witness**, แสดงขึ้นเพียงครั้งเดียวและเก็บไว้เพียงในรูปแบบ SHA256 เท่านั้น มันเปิดจุดปลายทางเพียงหนึ่งจุดเท่านั้น คือ `GET /api/witness/head` ซึ่งคืนค่าจุดตรวจสอบที่เพิ่ง ลงนามใหม่ พร้อมทั้งตัวนับการเก็บรวบรวมที่ลงนามแล้วแต่ไม่มีเนื้อหา และสถานะความพร้อมในการทำงาน มันไม่สามารถเปิดแผงควบคุม อ่านเนื้อหาข้อความ หรือเปลี่ยนการตั้งค่าได้ และ โทเค็นของแผงควบคุมไม่ได้รับการยอมรับที่นั่น สามารถเพิกถอนโทเค็นได้บนหน้าเดียวกัน ผู้รวบรวมจะบันทึก เมื่อกุญแจพยานใหม่เริ่มตรวจสอบ (`witness.seen`) และแสดงการตรวจสอบครั้งสุดท้ายต่อโทเค็น; พยานที่ยังไม่ตรวจสอบภายในช่วงเวลา2.5 จะถูกทำเครื่องหมายว่าเกินกำหนด

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

## สิ่งที่ระบบตรวจสอบและบันทึก

ทุกช่วงเวลา (ค่าเริ่มต้นคือ 10 นาที) TgWitness จะ:

1. ดึงส่วนหัวมาเอง (ผู้รวบรวมข้อมูลไม่สามารถส่งหรือข้ามส่วนหัวนี้ได้);
2. ตรวจสอบลายมือของผู้เก็บข้อมูล, กุญแจผู้เก็บข้อมูลที่ถูกตรึง (`--collector-fingerprint`, หรือกุญแจแรกที่พบ), จำนวนที่ไม่ลดลง และส่วนหัวที่ไม่เปลี่ยนแปลงที่จำนวนที่ไม่เปลี่ยนแปลง การพิสูจน์การรวมและการสอดคล้องของ Merkle ตรวจสอบว่าบันทึกที่เพิ่มขึ้นขยาย จุดตรวจสอบที่เก็บไว้ เมื่อการพิสูจน์ความต่อเนื่องถูกใช้แล้ว การลบมันจะถูกปฏิเสธ;
3. เพิ่มบันทึกที่ลงนามแล้วลงในบันทึกของตนเอง: `witness.anchor` ด้วยสถานะ `ok`, `key_changed`, `rollback` (จำนวนบันทึกน้อยกว่าเดิม), `fork` (ความยาวเท่ากัน แต่ส่วนหัวต่างกัน ) หรือ `invalid` (คำตอบไม่ผ่านการตรวจสอบ), หรือ `witness.no_response` เมื่อ ผู้รวบรวมข้อมูลไม่ตอบกลับ;
4. ส่งผลลัพธ์ไปยังช่อง (channel) พร้อมลายเซ็น รวมถึงข้อความ "no answer" ในขณะที่ TgWitness กำลังทำงานและสามารถเข้าถึง Bot API ได้ ID ของการโพสต์ถูกบันทึกไว้ (`witness.posted`), รวมถึงการโพสต์ที่ล้มเหลวด้วย (`witness.post_failed`).

โพสต์มีลักษณะดังนี้; บรรทัดสุดท้ายมีข้อความที่ลงนาม:

```
TgWitness witness #42 · journal head
Collector 3fa9c2d1e0b4a7f6: 18234 records
Head 9b1f…c07e
2026-10-28T19:40:00.123+00:00
TGW1.eyJhdCI6…<statement>.<signature>
```

## เรียกใช้พยาน

คุณจำเป็นต้องมีบอต Telegram (สร้างบอตด้วย @BotFather), ช่องที่บอตดังกล่าวเป็น ผู้ดูแลระบบ และที่อยู่ของผู้เก็บข้อมูลที่สามารถเข้าถึงได้จากผู้ให้คำพยาน — ผ่าน HTTPS นอก เครือข่ายส่วนตัว (ดูโปรไฟล์ HTTPS ใน[ส่วนการติดตั้ง](https://phishdestroy.io/tgwitness/th/docs/reference/deployment/))

เปิด **More tools → Extras → Independent witness → Configure** ในแผงควบคุม ขั้นตอนสามขั้น ได้แก่ การเข้าถึงแบบอ่านอย่างเดียว ช่องของคุณ และช่วงเวลา จากนั้นจึงเริ่มทำงานของพยาน นโยบายการเผยแพร่ พร็อกซี HTTP/SOCKS5 (เลือกได้) และที่อยู่ Bot API ที่กำหนดเอง อยู่ในส่วน **Advanced settings** แบบฟอร์ม จะดาวน์โหลดไฟล์ `witness.json` พร้อมด้วยคีย์ผู้รวบรวม (collector key) ของพื้นที่ทำงานนี้ที่ถูกตรึงไว้ ดาวน์โหลดโทเค็นอ่านอย่างเดียวที่ สร้างขึ้นใหม่โดยใช้ตัวเลือก "**บันทึกไฟล์การเข้าถึง** เป็น" `witness-token.txt` ; วางไฟล์นี้และไฟล์ `bot-token.txt` ที่สร้างขึ้นบนโฮสต์ของพยานไว้ข้างไฟล์ JSON ดังกล่าว คอลเลกเตอร์จะไม่ได้รับโทเค็นบอต การดาวน์โหลดจะไม่เริ่มบริการหรือเผยแพร่ข้อความ ไม่มีพยานโครงการที่โฮสต์อยู่ ถูกลงทะเบียนโดยอัตโนมัติ

```
python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json
python -m tgwitness.witness fingerprint --config witness.json
```

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

หากแผงควบคุมอยู่เบื้องหลังอุโมงค์ SSH ให้เปิดเผยเฉพาะจุดสิ้นสุดของ witness ที่กำหนดขอบเขตไว้บน ชื่อโฮสต์ HTTPS แยกต่างหาก โดยใช้[ตัวอย่าง Caddy นี้](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.witness.example) พื้นที่ทำงานเริ่มต้นจะใช้ `https://witness.example.org` ส่วนพื้นที่ทำงานอื่น ๆ จะใช้ `https://witness.example.org/profiles/ID` โทเค็นยังคงจำเป็น; แผงควบคุมและ เส้นทาง API อื่น ๆ ของมันจะไม่ถูกส่งต่อโดยโฮสต์เสมือนนั้น

เลือก `all` สำหรับจุดตรวจสอบที่เผยแพร่เป็นประจำ ช่วงเวลา 5 นาที หมายถึงประมาณ 288 โพสต์ต่อพื้นที่ทำงานต่อวัน `changes`/`problems` ปล่อยให้จุดตรวจสอบบางส่วนไม่เผยแพร่โดยเจตนา MTProxy ใช้สำหรับไคลเอนต์ Telegram ของผู้รวบรวมข้อมูล การตรวจสอบ HTTP ของ Witness และ HTTPS Bot API ของ Telegram ใช้เส้นทางตรง/HTTP/SOCKS5 ของตนเอง ([Bot API](https://core.telegram.org/bots/api))

**ข้างๆ ตัวเก็บข้อมูล (collector) โดยใช้ Docker** (บนโฮสต์เดียวกัน — กระบวนการและกุญแจอิสระ แต่ ผู้ดำเนินการเดียวกัน): ใส่ค่าลงใน `.env` และเริ่มโปรไฟล์

```
TGWITNESS_WITNESS_TOKEN=tgww_...
TGWITNESS_WITNESS_BOT_TOKEN=123456:ABC...
TGWITNESS_WITNESS_CHANNEL=@your_witness_channel
# another workspace: TGWITNESS_WITNESS_COLLECTOR=http://tgwitness:8787/profiles/<workspace ID>

docker compose --profile witness up -d
docker compose logs witness     # prints the witness key fingerprint
```

หากใช้ภาพที่เผยแพร่แล้ว ให้ใช้`docker compose --project-directory . -f deploy/compose/compose.image.yaml --profile witness up -d`

**บนเซิร์ฟเวอร์ของผู้อื่น** (การเก็บรักษาแบบแยกต่างหาก): คัดลอกรีโพสิตอรีไปยังที่นั่น ตั้งค่า `TGWITNESS_WITNESS_COLLECTOR=https://your-collector.example.org` พร้อมทั้งค่าสามค่าข้างต้น ใน `.env` แล้ว

```
docker compose --project-directory . -f deploy/compose/compose.witness.yaml up -d
```

หรือโดยไม่ต้องใช้ Docker:

```
python -m tgwitness.witness run --collector https://your-collector.example.org \
    --token-file witness-token.txt --bot-token-file bot-token.txt --channel @your_witness_channel
```

### เผยแพร่ไปยัง Discord

ผู้เป็นพยานสามารถโพสต์ไปยังช่อง Discord แทน Telegram ได้ ใน Discord ให้เปิด **Edit Channel → Integrations → Webhooks** สร้าง webhook และคัดลอก URL ของมัน ใน แผงควบคุม ให้เลือก **Discord webhook · ช่องของคุณ** ในขั้นตอนที่ 2 บนเซิร์ฟเวอร์ของผู้เป็นพยาน ให้บันทึก URL ไว้เป็น `discord-webhook.txt` ข้างๆ `witness.json`; มันจะไม่ถึง collector เลย

```
python -m tgwitness.witness run --collector https://your-collector.example.org \
    --token-file witness-token.txt --discord-webhook-file discord-webhook.txt
```

พยานมีผู้เผยแพร่เพียงหนึ่งราย: ช่อง Telegram หรือ webhook ของ Discord (ไม่ใช่ทั้งสองอย่าง) โพสต์ มีข้อความที่ลงนามเดียวกันและไม่สามารถ ping ผู้ใช้ใดได้ โพสต์ที่ยาวกว่า 2,000 ตัวอักษรของ Discord จะถูกแทนที่ด้วยบรรทัดสั้นๆ พร้อมแนบการตรวจสอบเต็มรูปแบบเป็น `witness-check.txt` ID ของแต่ละโพสต์จะถูกบันทึกเป็น `witness.posted` `verify.py --channel` อ่านเฉพาะช่อง Telegram เท่านั้น ดังนั้นสำหรับ Discord ให้เก็บสมุดบันทึกของพยานไว้: มันเก็บการตรวจสอบทุกครั้ง ไว้ โพสต์ของ Discord ไม่ให้เวลาภายนอกแก่ผู้ตรวจสอบ

### ตัวเลือก

| ตัวเลือก | สภาพแวดล้อม | ค่าเริ่มต้น | ความหมาย |
| --- | --- | --- | --- |
| `--interval` | `TGWITNESS_WITNESS_INTERVAL` | 10 | ระยะเวลาระหว่างการตรวจสอบ: 1–1440 นาที |
| `--timeout` | `_TIMEOUT` | 30 | เวลาที่ต้องรอตัวเก็บข้อมูลและ API ของ Bot: 5–600 วินาที |
| `--post` | `_POST` | `all` | `all`: ทุกการตรวจสอบ; `changes`: ปัญหาใหม่หรือหัวข้อใหม่; `problems`: มีแต่ปัญหาและคำตอบที่ขาดหายไป |
| `--title` | `_TITLE` | `TgWitness witness` | คำแรกๆ ของทุกโพสต์ในช่อง |
| `--collector-fingerprint` | `_COLLECTOR_FINGERPRINT` | – | ให้ปักคีย์ผู้เก็บข้อมูลไว้แทนที่จะเชื่อถือคำตอบแรก |
| `--proxy` | `_PROXY` | direct | `socks5://host:port` หรือ `http://host:port` |
| `--bot-api` | `_BOT_API` | `https://api.telegram.org` | ที่อยู่ API ของบอท เช่น เซิร์ฟเวอร์ API ของบอทในท้องถิ่น |
| `--data-dir` | `_DATA` | `witness-data` | กุญแจ Witness และบันทึก |
| `--config` | `_CONFIG` | – | ไฟล์ JSON พร้อมตัวเลือกใดก็ตามข้างต้น |

ที่อยู่ของตัวเก็บข้อมูล โทเค็น และช่องมาจาก `--collector`, `--token` หรือ `--token-file`, `--bot-token` หรือ `--bot-token-file`, `--discord-webhook-file` และ `--channel`, หรือ `_COLLECTOR`, `_TOKEN`, `_TOKEN_FILE`, `_BOT_TOKEN`, `_BOT_TOKEN_FILE`, `_DISCORD_WEBHOOK_FILE` และ `_CHANNEL`, ซึ่งช่วยไม่ให้ข้อมูลลับปรากฏในรายการกระบวนการ

ไฟล์การตั้งค่าใช้ชื่อตัวเลือกที่มีขีดล่าง (underscore) พร้อมด้วย `texts` ซึ่งใช้แทนคำ ในโพสต์ของช่อง:

```
{"collector": "https://your-collector.example.org", "token_file": "witness-token.txt",
 "bot_token_file": "bot-token.txt", "channel": "@your_witness_channel",
 "interval": 5, "timeout": 30, "post": "changes", "title": "Partner witness",
 "texts": {"ok": "journal head", "no_response": "no answer from the collector", "records": "records"}}
```

`texts`: `ok`, `key_changed`, `rollback`, `fork`, `invalid`, `no_response`, `collector`, `records`, `head`, คำที่ใช้ไม่เคยส่งผลต่อการตรวจสอบ: verify.py ตรวจสอบโทเค็นที่ลงนามไว้ที่ท้ายของทุก โพสต์ ด้วย `--post changes` หรือ `problems` การตรวจสอบที่ยังไม่ถูกโพสต์ยังคงอยู่ใน วารสารพยาน และ `verify.py` จะแสดงรายการเหล่านั้นว่ายังไม่เคยถูกโพสต์; บันทึกเริ่มต้นจะระบุ นโยบาย ทุกการตรวจสอบยังคงปรากฏในวารสาร ดังนั้นการโพสต์น้อยลงหมายถึงจำนวนครั้งที่ Telegram กำหนดวันที่ น้อยลง ไม่ใช่การตรวจสอบน้อยลง

แม้ไม่มีช่อง (channel) TgWitness ก็ยังคงเก็บบันทึกไว้ได้ เก็บลายนิ้วมือของกุญแจ TgWitness (`python -m tgwitness.witness fingerprint`) ไว้ที่อื่น

## หน้าหลักฐานสาธารณะสำหรับพื้นที่ทำงานหลายแห่ง

`python -m tgwitness.proof` witnesses สามารถจัดการพื้นที่ทำงานได้สูงสุด 32 พื้นที่พร้อมกัน และให้บริการหน้าแบบอ่านอย่างเดียว ที่มีผลการตรวจสอบล่าสุดที่ลงนามแล้วของแต่ละพื้นที่ทำงาน ทุกพื้นที่ทำงานจะได้รับกุญแจ witness และ journal ของตัวเองในโฟลเดอร์ data พร้อมด้วยกุญแจ collector ที่ถูกตรึงไว้; การโพสต์ไปยังช่อง Telegram เป็นตัวเลือกที่แต่ละพื้นที่ทำงานสามารถกำหนดได้เอง เริ่มจาก [proof.config.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/proof.config.example):

| Field | ความหมาย |
| --- | --- |
| `title` | ชื่อหน้า, 1–100 ตัวอักษร |
| `data_dir` | กุญแจและบันทึกของ Witness ที่เกี่ยวข้องกับไฟล์; ค่าเริ่มต้น `proof-data` |
| `interval`, `timeout` | จำนวนนาทีระหว่างการตรวจสอบ (1–1440, ค่าเริ่มต้น 5); จำนวนวินาทีที่ต้องรอ (5–600, ค่าเริ่มต้น 20) |
| `workspaces[].id`, `label` | ชื่อย่อตัวพิมพ์เล็กสั้นๆ และชื่อที่แสดง |
| `workspaces[].collector` | ที่อยู่ Collector; พื้นที่ทำงานอื่น ๆ จะลงท้ายด้วย `/profiles/<workspace ID>` |
| `workspaces[].collector_fingerprint` | จำเป็น, แตกต่างกันสำหรับแต่ละพื้นที่ทำงาน |
| `workspaces[].token_file` | ไฟล์ที่มีโทเค็นพยานแบบอ่านอย่างเดียวของพื้นที่ทำงานนั้น |
| `workspaces[].channel`, `bot_token_file` | ตัวเลือกเพิ่มเติม: โพสต์การตรวจสอบแต่ละครั้งไปยังช่อง |
| `workspaces[].proxy`, `bot_api` | ที่อยู่ API ของ Bot และเส้นทาง (Optional route) |

```
python -m tgwitness.proof --config proof.json --check-config
python -m tgwitness.proof --config proof.json --host 127.0.0.1 --port 8790
```

คำสั่งแรกจะตรวจสอบความถูกต้องของไฟล์และไฟล์โทเค็นโดยไม่เปิดการเชื่อมต่อ หน้านี้รับเฉพาะคำขอ GET และ HEAD:

- `/` แสดงทุกพื้นที่ทำงาน; พื้นที่ทำงานที่ยังไม่ได้รับการตรวจสอบเป็นเวลา 2.5 ช่วงจะได้รับการทำเครื่องหมายว่าล้าสมัย
- `/api/proof` ให้ผลลัพธ์เหมือนกับ JSON.
- `/api/proof/<id>` ดาวน์โหลดคำแถลงที่ลงนามล่าสุด (`tgwitness-public-proof-v1`): หมายเลขบันทึกพยานและแฮช, สถานะ, กุญแจผู้เก็บข้อมูลที่ตรึงไว้, จุดตรวจสอบ, ตัวนับการเก็บข้อมูล และว่าโพสต์ในช่องสำเร็จหรือไม่, ลงนามด้วยกุญแจพยานของพื้นที่ทำงานนั้น
- `/healthz` แสดงรหัสข้อผิดพลาด 503 เมื่อตัวติดตามของพื้นที่ทำงานหยุดทำงาน

ตั้งชื่อโฮสต์เฉพาะสำหรับหน้าดังกล่าว เช่น [Caddyfile.proof.example](https://github.com/phishdestroy/TgWitness/blob/main/deploy/Caddyfile.proof.example) เพื่อตรวจสอบ ให้ส่งออก หนังสือบันทึกพยานของพื้นที่ทำงานด้วย `python -m tgwitness.witness export --data-dir proof-data/<id> --out witness.zip` และใช้มัน ตามคำอธิบายด้านล่าง

## ตรวจสอบ

สำหรับผู้ใช้ TgWitness สามารถส่งออกบันทึกได้ดังนี้:

```
python -m tgwitness.witness export --out witness.zip
# Docker (add -f deploy/compose/compose.witness.yaml on a witness server):
docker compose exec witness python -m tgwitness.witness export --out /witness/witness.zip
docker compose cp witness:/witness/witness.zip .
```

จากนั้น ที่ใดก็ได้ ด้วยไฟล์ ZIP ที่ลงนามโดยผู้รวบรวม (collector) และที่อยู่ของช่องสาธารณะ:

```
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
    --witness witness.zip --witness-fingerprint WITNESS_SHA256 --channel https://t.me/s/your_witness_channel
```

`--channel` ยังรับไฟล์ส่งออกจาก Telegram Desktop (*ส่งออกประวัติการสนทนา* → JSON จะให้ `result.json`) หรือสำเนาที่บันทึกไว้ของหน้าเว็บ; สิ่งเหล่านี้ตรวจสอบเนื้อหาของโพสต์แต่ไม่ให้ เวลาภายนอก

`verify.py` ตรวจสอบบันทึกของพยาน (โซ่และลายเซ็น) จากนั้นตรวจสอบ**ว่าทุกหัวบันทึกที่ พยานเห็นเป็นส่วนหนึ่งของบันทึกที่ส่งออก**: บันทึกที่ตำแหน่งนับนั้นต้องมี แฮชที่ตรงกันพอดี หัวบันทึกที่ไม่ตรงกันจะล้มเหลวในการตรวจสอบ — บันทึกถูกเปลี่ยนแปลงหลังจาก ผู้เป็นพยานได้เห็นมันแล้ว นอกจากนี้ยังรายงานหัวบันทึกที่เห็นหลังการส่งออก ความผิดปกติที่ผู้เป็นพยาน บันทึกไว้ คำตอบที่ล้มเหลว ช่วงเวลามีจุดตรวจสอบที่ตรงกันอยู่ใน การส่งออกนี้ ("Witnessed from X to Y") และช่องว่าง จุดตรวจสอบที่ตามมาไม่ขยายช่วงเวลานั้น ผลลัพธ์รวมถึงหมายเลขบันทึกที่ตรงกันล่าสุดและจำนวนบันทึกที่ตามมา ที่ไม่มีจุดตรวจสอบที่ตรงกัน มีเพียงคำตอบที่ลงนามด้วยกุญแจของไฟล์ส่งออกเองเท่านั้นที่นับ: ไฟล์ส่งออกที่ลงนาม ด้วยกุญแจที่ผู้เป็นพยานไม่เคยเห็นจะถูกรายงานว่าไม่ได้รับการเป็นพยาน และหากไม่มี `--fingerprint` ผู้ ลงนามจะยังคงไม่ถูกตรึงไว้ ด้วย `--channel` ทุกโพสต์ที่ลงนามต้องตรงกับบันทึกในสมุดบันทึกของผู้เป็นพยาน บันทึกต่อบันทึก: โพสต์ที่ถูกเปลี่ยนแปลงจะล้มเหลวในการตรวจสอบ โพสต์ที่ขาดหายไปจะถูกรายการไว้ การตรงกันของ โทเค็นจะยืนยันความถูกต้องของเนื้อหา; วันที่อยู่นอกโทเค็นที่ลงนาม

ด้วยที่อยู่แบบสด `https://t.me/s/…` หรือ `https://telegram.me/s/…` ผู้ตรวจสอบจะอ่าน วันที่ของแต่ละโพสต์จากหน้าเว็บ ณ เวลาตรวจสอบ Telegram กำหนดวันที่นั้น; วันที่ของ โพสต์ที่แก้ไขแล้วไม่ถูกใช้ วันที่ที่เก่าที่สุดของโพสต์ที่ส่วนหัวการส่งออกคือเวลา ภายนอกสำหรับบันทึกสุดท้าย ซึ่งตรงกับเงื่อนไขขั้นต่ำของหลักฐาน วันที่ จากแหล่งอื่นใด เช่น `result.json` ที่ถูกส่งมา หน้าเว็บที่บันทึกไว้ หรือที่อยู่เว็บ อื่น ๆ เป็นข้อมูลเมตาดาต้าที่ส่งมา ไม่ใช่เวลาอิสระ; ผลลัพธ์จะระบุแหล่งที่มาของวันที่ โพสต์ (`post_date_verification`)

### จำเป็นต้องมีขอบเขตการส่งออกที่มีผู้เป็นพยาน

สำหรับการส่งต่อข้อมูลที่ต้องรวมถึงบันทึกสุดท้ายที่มีพยานรับรอง ให้เพิ่ม `--require-witness`:

```
python verify.py tgwitness-evidence.zip --fingerprint COLLECTOR_SHA256 \
    --witness witness.zip --witness-fingerprint WITNESS_SHA256 --require-witness
```

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

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

### ตราประทับรายวันและปฏิทินเวลาประทับที่ไม่สามารถใช้งานได้

ผู้เป็นพยานจะปิดผนึกขอบเขตบันทึกของวัน UTC ก่อนหน้า และส่งค่าแฮชของ ผนึกที่ลงนามนั้นไปยัง OpenTimestamps การส่งข้อมูลปฏิทินถือเป็นหลักฐานที่รอการยืนยัน; เพียงคำมั่นสัญญา Bitcoin ที่ได้รับการตรวจสอบอย่างอิสระเท่านั้นที่จะได้รับการยืนยันในตัวตรวจสอบ

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

การลองใหม่จะไม่เขียนทับตราประทับใหม่ ไม่เปลี่ยนวันที่เดิม หรืออ้างว่า ปฏิทินได้รับมันมาก่อน การยืนยัน Bitcoin ที่เกิดขึ้นภายหลังยังคงเป็นการยืนยันจากภายนอก ที่เกิดขึ้นภายหลัง หลักฐานที่ขาดหายไปยังคงเป็น `none`; หลักฐานที่รอการยืนยันยังคงเป็น `pending` จนกว่า ผู้ตรวจสอบจะตรวจสอบมันอย่างอิสระ
