# Telegram · Quy trình làm việc và hoạt động

Canonical page: https://phishdestroy.io/tgwitness/vi/docs/reference/operations/

Hoạt động hàng ngày của bảng điều khiển: các chế độ, danh mục giám sát, thông số, thông báo, xuất dữ liệu, sao lưu và dung lượng.

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

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

Translation coverage: this edition includes material from the English original.

Hoạt động hàng ngày của bảng điều khiển: các chế độ, danh mục giám sát, thông số, thông báo, xuất dữ liệu, sao lưu và dung lượng.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Tài liệu](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Triển khai và khôi phục](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/)

![Triển khai & khôi phục](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

Đối với lần kết nối đầu tiên, vui lòng sử dụng [các định dạng tài khoản và phiên làm việc](https://phishdestroy.io/tgwitness/vi/docs/reference/accounts/). Để tìm hiểu về các phiên bản đã lưu, chính sách sự kiện và các khoảng trống, xin tham khảo phần [giải thích về cơ chế thu thập dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/). Hướng dẫn này bao quát các hoạt động hàng ngày và quy trình khôi phục dữ liệu.

Một bản cài đặt được quản lý bao gồm các tệp **, START-HERE.html,** và **, START-HERE.txt,** bên cạnh trình khởi chạy của nó, kèm theo liên kết kho lưu trữ và các lệnh được tùy chỉnh theo đường dẫn cài đặt của nó. Chạy tệp `tgwitness guide --print` qua SSH, hoặc tệp `tgwitness paths` để xác định vị trí thư mục dữ liệu thực tế. Một bản cài đặt systemd với quyền root lưu trữ trạng thái riêng tư trong tệp `/var/lib/tgwitness-…`; tệp `/opt/tgwitness` chứa chương trình.

Đối với đường hầm Cloudflare tạm thời được quản lý, `tgwitness tunnel off` sẽ đóng quyền truy cập công khai trong khi bảng điều khiển cục bộ và quá trình thu thập dữ liệu vẫn tiếp tục hoạt động. `tgwitness tunnel on` kích hoạt quyền truy cập này; `tgwitness tunnel restart` tạo kết nối đường hầm mới. Sử dụng `tgwitness open` để xem địa chỉ hiện tại của đường hầm. Cài đặt tắt rõ ràng sẽ được duy trì ngay cả khi dịch vụ khởi động lại. `tgwitness stop` dừng cả bảng điều khiển và quá trình thu thập dữ liệu.

**Trên trang này**

- [Quy trình làm việc của người vận hành](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#operator-workflow)
- [Chia sẻ công việc mà không cần chia sẻ khóa chính](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#share-work-without-sharing-the-main-key)
- [Chế độ chạy](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#runtime-modes)
- [Các danh mục giám sát](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#monitoring-categories)
- [Thông báo](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#notifications)
- [Bố cục bảng điều khiển](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#panel-layout)
- [Môi trường triển khai](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#deployment-environments)
- [Kiểm tra khởi động và xuất dữ liệu](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#startup-checks-and-exports)
- [Sao lưu, khôi phục và sự gián đoạn](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#backup-restore-and-interruptions)
- [Dung lượng và thời gian lưu trữ](https://phishdestroy.io/tgwitness/vi/docs/reference/operations/#capacity-and-retention)

## Quy trình làm việc của người vận hành

Sơ đồ quy trình · Chọn phương thức lưu trữ và bảo vệ khóa → Mở bảng điều khiển bằng mã thông báo của nó; Mở bảng điều khiển bằng mã thông báo của nó → Chọn không gian làm việc; Chọn không gian làm việc → Cấu hình đường dẫn trực tiếp hoặc qua proxy; Cấu hình đường dẫn trực tiếp hoặc qua proxy → Nhập số điện thoại hoặc chọn tệp / mã QR; Nhập số điện thoại hoặc chọn tệp / mã QR → Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập; Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập → Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát; Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát → Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa; Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa → Giữ lại các điểm kiểm tra độc lập; Giữ lại các điểm kiểm tra độc lập → Xuất và xác minh tài liệu · Chọn phương thức lưutrữ và bảo vệ khóa · Mở bảng điều khiểnbằng mã thông báo củanó · Chọn không gian làmviệc · Cấu hình đường dẫntrực tiếp hoặc quaproxy · Nhập số điện thoạihoặc chọn tệp / mã QR · Xác minh danh tính tàikhoản và chọn các nhómcó thể truy cập · Lưu các chính sách vềsự kiện và tệp đínhkèm, sau đó bắt đầuquá trình giám sát · Theo dõi lỗi, quyềntruy cập, hàng đợi vàdung lượng đĩa · Giữ lại các điểm kiểmtra độc lập · Xuất và xác minh tàiliệu

**Sơ đồ dưới dạng văn bản**

1. Chọn phương thức lưu trữ và bảo vệ khóa → Mở bảng điều khiển bằng mã thông báo của nó
2. Mở bảng điều khiển bằng mã thông báo của nó → Chọn không gian làm việc
3. Chọn không gian làm việc → Cấu hình đường dẫn trực tiếp hoặc qua proxy
4. Cấu hình đường dẫn trực tiếp hoặc qua proxy → Nhập số điện thoại hoặc chọn tệp / mã QR
5. Nhập số điện thoại hoặc chọn tệp / mã QR → Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập
6. Xác minh danh tính tài khoản và chọn các nhóm có thể truy cập → Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát
7. Lưu các chính sách về sự kiện và tệp đính kèm, sau đó bắt đầu quá trình giám sát → Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa
8. Theo dõi lỗi, quyền truy cập, hàng đợi và dung lượng đĩa → Giữ lại các điểm kiểm tra độc lập
9. Giữ lại các điểm kiểm tra độc lập → Xuất và xác minh tài liệu

Quyền truy cập, kết nối truyền tải, quyền tham gia nhóm và tính đầy đủ của việc gửi tin nhắn là các thuộc tính khác nhau. Trạng thái kết nối màu xanh lá cây không có nghĩa là tất cả các sự kiện đã được ghi lại.

## Chia sẻ công việc mà không cần chia sẻ khóa chính

Mở **thêm công cụ → Truy cập** để cấp mã thông báo riêng cho người đánh giá hoặc nhà phân tích. Chọn các tài khoản và cuộc trò chuyện mà họ có thể truy cập, sau đó cho phép xem, xuất hoặc thực hiện các hành động vận hành. Người vận hành khởi động/dừng quá trình thu thập cần quyền truy cập toàn bộ không gian làm việc; người đánh giá có thể bị giới hạn trong một cuộc trò chuyện duy nhất. Giới hạn phiên, thời hạn hết hiệu lực và quy tắc IP là riêng biệt so với ủy quyền tài khoản Telegram. Xem [quyền truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/).

Sử dụng **tính năng “Open sessions”** để ngắt kết nối hoặc thu hồi quyền truy cập nhằm chấm dứt tất cả các phiên làm việc của người dùng đó. Bảng điều khiển quản trị tổng hợp hoạt động của các quy trình hiện tại trên các không gian làm việc. Việc đóng phiên làm việc sẽ không ảnh hưởng đến quá trình thu thập dữ liệu.

## Các chế độ hoạt động

| Chế độ | Hành động | Hành vi |
| --- | --- | --- |
| Bản demo | scripts\Demo.cmd hoặc `--demo` | Dữ liệu tổng hợp; tính năng kết nối với tài khoản thực đã bị vô hiệu hóa |
| Quan sát | Bắt đầu quan sát | Ghi lại các bản cập nhật đã được gửi cho các nguồn được chọn |
| Bản chụp lịch sử | Cuộc trò chuyện → Hành động trong cuộc trò chuyện → Tải lịch sử | Lưu trữ tối đa 500 tin nhắn hiện tại; không tái tạo lại tất cả các thay đổi trong quá khứ |
| Tạm dừng | Tạm dừng quan sát | Tạm dừng thu thập dữ liệu trong khi vẫn lưu giữ dữ liệu và các tác vụ đang chờ xử lý |
| Xem xét/Chuyển giao | Xuất dữ liệu | ZIP, JSONL/CSV/HTML, điểm kiểm tra, biên nhận quá trình và yêu cầu dấu thời gian |
| Nhiều tài khoản | Các không gian làm việc hoặc nút **+** ở trên cùng | Có thể tạo bất kỳ số lượng không gian làm việc riêng biệt nào trong cùng một quy trình |

Quyền truy cập bản demo tại địa phương sẽ tự động mở mà không cần nhập mã thông báo thủ công. Tính năng này sử dụng khả năng tồn tại trong suốt quá trình xử lý, chỉ có hiệu lực đối với quyền truy cập vòng lặp trực tiếp vào một bản demo tổng hợp được cách ly; mã thông báo của bảng điều khiển chính không được tiết lộ. Các không gian làm việc thực tế cũng như quyền truy cập bản demo từ xa hoặc qua máy chủ proxy vẫn duy trì xác thực bằng mã thông báo. Việc truy cập bản demo không cấp bất kỳ quyền ủy quyền nào trên Telegram.

## Các danh mục giám sát

![Cài đặt giám sát theo từng tài khoản với dữ liệu nguồn tổng hợp](https://phishdestroy.io/tgwitness/assets/sources.png?v=761b8bfa296c)

Trong **mục Công cụ khác → Nguồn → Ghi lại → Chọn những thay đổi cần giữ lại**, hãy chọn riêng biệt các tin nhắn mới, chỉnh sửa, thông báo xóa, cập nhật phản hồi và sự kiện thành viên. Cài đặt mặc định giữ lại tất cả các danh mục. Tùy chọn **Tin nhắn, chỉnh sửa & xóa** giữ nguyên bối cảnh ban đầu trong khi vô hiệu hóa các cập nhật riêng biệt về phản hồi/thành viên. Tùy chọn **Tất cả hoạt động hiển thị** khôi phục cả năm danh mục. Các cài đặt sẵn thay đổi định dạng; nhấn **Lưu cài đặt ghi lại** để áp dụng.

Chính sách đã lưu sẽ áp dụng cho tất cả các nguồn được chọn trong không gian làm việc đó. Các không gian làm việc khác vẫn giữ nguyên cài đặt riêng của mình. Mỗi thay đổi thực tế đều được ghi lại kèm theo các giá trị trước và sau đã được ký xác thực; chính sách hiện tại cũng được bao gồm trong biên nhận quá trình và bản ghi bắt đầu quan sát. Việc vô hiệu hóa một danh mục sẽ không xóa các quan sát trước đó. Việc kích hoạt lại sẽ không khôi phục các thay đổi đã bỏ lỡ. Trong phiên bản này, không có tính năng ghi đè danh mục theo từng nhóm.

Vui lòng duy trì tính năng ghi lại tin nhắn mới khi nội dung trước đó vẫn còn quan trọng: thông báo xóa tin nhắn không thể khôi phục lại văn bản chưa từng được ghi lại. Các bản ghi hoạt động/phạm vi phủ sóng cùng các sự kiện dịch vụ nhóm khác luôn được lưu giữ. Các bản chụp lịch sử rõ ràng là riêng biệt so với việc lựa chọn danh mục thời gian thực và có thể bao gồm các tin nhắn dịch vụ. Các tùy chọn này không che giấu siêu dữ liệu về phản ứng/thành viên được nhúng trong một đối tượng Telegram đã được ghi lại.

Một bản chụp lịch sử có thể xếp các tệp đính kèm vào hàng đợi khi đang tạm dừng. Hãy bắt đầu quá trình quan sát để xử lý chúng. Việc được xếp vào hàng đợi không có nghĩa là đã được tải xuống. Một tệp gốc không khả dụng sẽ không bị thay thế bằng phiên bản đã chỉnh sửa mới hơn; các kết quả sẽ được ghi lại riêng biệt.

**Nút “Lock”** sẽ xóa quyền truy cập trình duyệt và các trường bí mật nhưng vẫn duy trì quá trình thu thập dữ liệu. Việc đóng tab cũng không làm dừng quá trình thu thập dữ liệu. Việc dừng tiến trình Python hoặc dịch vụ sẽ ngừng quá trình thu thập dữ liệu bất kể trạng thái của trình duyệt.

Một không gian làm việc bổ sung có thể bị xóa sau khi tệp ZIP hoặc tệp ASiC-E đã được ký điện tử, bao gồm nhật ký và các ghi chú trên Bảng trường hợp của nó, đã được tải xuống đầy đủ. Việc chuẩn bị tệp lưu trữ là chưa đủ: nếu có bản ghi nằm ngoài các sự kiện thiết lập hoặc ghi chú được thêm vào sau khi tải xuống, thì tùy **chọn Xóa** sẽ không khả dụng.

Khi bảng điều khiển nhận được chính tệp đó, nó chỉ tính việc xuất sau khi đã nhận đủ mọi byte, rồi báo cáo kích thước lên `POST /api/exports/{id}/received`; một quá trình tải xuống bị gián đoạn sẽ không được tính. Với trình chọn lưu của trình duyệt (Truy cập Hệ thống Tệp), bảng điều khiển sẽ báo cáo sau khi tệp được ghi và đóng lại. Nếu không có trình chọn này, bảng điều khiển sẽ chuyển tệp đã nhận sang danh sách tải xuống của trình duyệt và không thể biết liệu trình duyệt có lưu tệp đó hay không, ví dụ như khi hộp thoại lưu tệp bị hủy; khi đó, bảng điều khiển sẽ báo rằng quá trình tải xuống đã bắt đầu, chứ không phải tệp đã được lưu. Một tệp mà trình duyệt tự tải xuống (một bản xuất có kích thước lớn hơn bộ đệm trình duyệt của bảng điều khiển) và một lần tải xuống bởi một khách hàng HTTP khác sẽ được tính khi máy chủ đã gửi toàn bộ phản hồi. Hệ điều hành và bộ đệm proxy ngược lưu trữ vài megabyte của phản hồi, do đó đối với các lần tải xuống này, máy chủ không thể phát hiện sự gián đoạn gần cuối. Trừ khi bảng điều khiển thông báo tệp đã được lưu, hãy kiểm tra tệp đã tải xuống trước khi xóa. Một tệp xuất theo nhóm sẽ được tính vào số lượng tài khoản khi nó được tải xuống ngay sau khi được chuẩn bị; việc tải lại tệp từ **mục Tệp xuất đã chuẩn bị** sẽ không được tính.

Trước khi xóa, bảng điều khiển sẽ hiển thị định dạng, kích thước, thời gian chuẩn bị và giá trị SHA-256 của tệp lưu trữ đã ký được tải xuống gần nhất và yêu cầu xác nhận rằng tệp lưu trữ này đã được lưu trữ bên ngoài không gian làm việc. Máy chủ sẽ từ chối lệnh `DELETE /api/profiles/{id}` nếu tham số `kept_copy` không được đặt thành giá trị SHA-256 đó (hoặc thành `confirmed` đối với tệp lưu trữ được tải xuống trước khi dấu vân tay được ghi lại).

Việc xóa một không gian làm việc bổ sung sẽ dừng trình thu thập dữ liệu của không gian đó và xóa dữ liệu cục bộ của nó. Nếu một tệp bị khóa hoặc lỗi hệ thống tệp làm gián đoạn quá trình xóa, bảng điều khiển sẽ báo cáo sự cố và giữ không gian làm việc đó trong danh sách là không khả dụng (`DeletionPending`). Vui lòng đóng các chương trình đang giữ các tệp của không gian làm việc đó và thử lại **lệnh Xóa**. Việc khởi động lại TgWitness sẽ khiến không gian làm việc đó vẫn ở trạng thái dừng và không khôi phục lại nhật ký hoặc các khóa đã bị xóa một phần. Việc xóa thành công chỉ được ghi lại sau khi thư mục đã được xóa; các bản sao được xuất hoặc sao lưu riêng biệt vẫn tuân theo chính sách lưu trữ riêng của chúng.

## Thông báo

Mở **Cài đặt → Thông báo và bản sao ngoài trang web → Địa chỉ nhận thông báo**, hoặc **Công cụ khác → Tiện ích → Thông báo → Cấu hình**. TgWitness sử dụng Apprise để gửi cảnh báo đến Matrix, Telegram, Discord, Slack, ntfy, email và các dịch vụ được hỗ trợ khác. Bạn có thể thêm nhiều địa chỉ nhận thông báo vào một không gian làm việc.

1. Vui lòng nhập một URL đích Apprise trên mỗi dòng. Hãy sử dụng danh mục dịch vụ ( [danh mục dịch vụ và các định dạng URL](https://appriseit.com/services/)) phù hợp với dịch vụ của quý vị.
2. Vui lòng bật tùy chọn **“Gửi thông báo”**, sau đó chọn các cảnh báo sự cố, thay đổi trong các cuộc trò chuyện được theo dõi và bản tóm tắt hàng ngày. Giờ trong bản tóm tắt sử dụng múi giờ của máy chủ.
3. Vui lòng bật tùy chọn **“Bao gồm các đoạn trích ngắn”** nếu quý vị muốn văn bản được lưu trữ từ các tin nhắn đã bị xóa và đã chỉnh sửa xuất hiện trong các thông báo.
4. Nhấn vào **“Lưu thông báo”**, sau đó nhấn **“Gửi thử nghiệm”** để kiểm tra việc gửi đi.

Đối với máy chủ nhận của riêng quý vị, vui lòng sử dụng [webhook JSON](https://appriseit.com/services/json/) của Apprise. Ví dụ: `jsons://notify.example.org/tgwitness` gửi JSON qua HTTPS đến điểm cuối đó. Đây là một ví dụ hư cấu; quý vị hãy thay thế bằng điểm đến của riêng mình.

Các đích đến và cài đặt thuộc về không gian làm việc đã chọn. Thông báo thay đổi bao gồm các nguồn được theo dõi, bao gồm cả các cuộc trò chuyện mới được thêm vào. Biểu tượng chuông trên thanh trên cùng cũng liệt kê các sự cố gần đây và những thay đổi trong cuộc trò chuyện.

Trong bản demo, các điều khiển thông báo hiển thị nhưng chức năng gửi đã bị vô hiệu hóa. Vui lòng cấu hình việc gửi thông báo trong một không gian làm việc thực tế. Các thông báo sẽ sử dụng đường dẫn Direct, SOCKS5 hoặc HTTP của không gian làm việc đó; MTProxy không thể truyền tải chúng. Các điểm đến không phải HTTP như SMTP yêu cầu một đường dẫn trực tiếp.

## Bố cục bảng điều khiển

![Kết nối không gian làm việc bằng dữ liệu tổng hợp](https://phishdestroy.io/tgwitness/assets/connection.png?v=c8781089fe29)

**Tạp chí này** hiển thị các quan sát, chức năng tìm kiếm và bộ lọc. Khi có thao tác chỉnh sửa, các phiên bản đã được ghi lại sẽ được mở ra; khi có thao tác xóa, nội dung trước đó (nếu có) sẽ được hiển thị. Nguồn gốc không xác định vẫn được nêu rõ ràng. Số liệu thống kê có sẵn trong **phần Tổng quan**; chi tiết về quá trình thu thập được lưu giữ trong hướng dẫn cục bộ.

Mở một tin nhắn đã chỉnh sửa để so sánh các phiên bản của nó bằng **Thay đổi trong văn bản** hoặc **Đặt cạnh nhau**; **Dữ liệu thô** hiển thị các trường đã lưu. Các thay đổi đối với liên kết ẩn và nút bot xuất hiện riêng biệt. Mở bản xem trước tệp đính kèm để kiểm tra hình ảnh, âm thanh hoặc video đã lưu; nút tải xuống giúp giữ cho bản gốc đã lưu trữ luôn sẵn có.

**Live** cập nhật nhật ký và các cuộc trò chuyện ngay khi có bản ghi mới. Tạm dừng tính năng này khi đang xem xét, hoặc sử dụng nút sự kiện mới khi đã sẵn sàng; quá trình thu thập vẫn tiếp tục chạy. **Ctrl/Cmd+K** tìm các thao tác trên bảng điều khiển và tìm kiếm trong nhật ký.

**Các công cụ khác → Nguồn** chứa phạm vi quan sát (các cuộc trò chuyện đã chọn, một thư mục Telegram hoặc toàn bộ tài khoản), các cuộc trò chuyện có thể truy cập thuộc mọi loại, các nguồn đã chọn có sao ưu tiên, cài đặt tệp đính kèm và kiểm tra lại, cùng các bản chụp lịch sử. Các nguồn riêng tư được chọn theo hộp thoại/ID mà không có liên kết công khai. Trạng thái truy cập mô tả lần kiểm tra gần nhất, không phải quyền truy cập vĩnh viễn.

Lọc các nguồn, đánh dấu vào ô chọn của chúng, sau đó bật, tạm dừng hoặc đánh dấu ưu tiên cho chúng cùng lúc. Trong danh sách cuộc trò chuyện khả dụng, **Thêm mục đã chọn** sẽ sử dụng lựa chọn của bạn; **Thêm tất cả kết quả phù hợp** sẽ sử dụng bộ lọc tìm kiếm và loại hiện tại.

**Phần “Trò chuyện” → “Người dùng”** liệt kê tất cả những người có tin nhắn được lưu trữ; khi tính năng hồ sơ người dùng được bật cho cuộc trò chuyện đó, chỉ cần nhấp chuột là hồ sơ của người đó sẽ mở ra kèm theo các liên kết đến các bản ghi trong sổ chứng cứ.

**Các công cụ khác → Tiện ích → Independent witness** tạo các token chứng kiến chỉ đọc, hiển thị thời điểm lần cuối mỗi chứng kiến kiểm tra và cung cấp các lệnh và tùy chọn để chạy một [chứng kiến độc lập](https://phishdestroy.io/tgwitness/vi/docs/reference/witness/).

**Các công cụ khác → Phần Tham số** chứa mọi giới hạn và tốc độ của không gian làm việc không được liệt kê trên các trang khác: số lượng cuộc trò chuyện được đọc, tần suất làm mới danh sách trò chuyện, khoảng thời gian kiểm tra nhịp tim và điểm kiểm tra, bộ đệm khởi động, cách các yêu cầu kiểm tra lại được phân bổ (thời gian trễ ban đầu, số cuộc trò chuyện mỗi lần, thời gian tạm dừng giữa các cuộc trò chuyện, tin nhắn được khôi phục và yêu cầu lại), dung lượng đĩa dự phòng, thời gian chờ và số lần thử lại khi tải xuống, các tiêu chí tìm kiếm trong hồ sơ người dùng (bao gồm cả biểu thức chính quy của riêng bạn), kích thước và tần suất thông báo, giới hạn bản chụp nhanh, ZIP và tải xuống qua trình duyệt, cũng như thời gian chờ và số lần thử lại của ứng dụng Telegram. Mỗi trường hiển thị phạm vi và giá trị mặc định; các trường đã thay đổi được đánh dấu và có thể khôi phục từng trường một hoặc tất cả cùng lúc. Mọi thay đổi đều được ghi lại dưới dạng ``parameters.changed`` kèm theo các giá trị trước và sau, và các bản ghi bắt đầu theo dõi sẽ ghi lại các giá trị hiện hành. Các giá trị có hiệu lực từ lần sử dụng tiếp theo; thời gian chờ và số lần thử lại của ứng dụng sẽ áp dụng từ lần kết nối tiếp theo. Khoảng thời gian kiểm tra lại, loại và kích thước tệp đính kèm, bằng chứng và khoảng thời gian sao lưu ngoài trang web vẫn nằm trên các trang riêng biệt và có thể nhận bất kỳ giá trị nào trong phạm vi cho phép, không chỉ giới hạn ở các cài đặt sẵn.

Biểu tượng chuông ở thanh trên cùng liệt kê các sự cố và thay đổi gần đây trong các cuộc trò chuyện được theo dõi; các tin nhắn chưa đọc sẽ được tính cho đến khi được đánh dấu là đã đọc. Các thay đổi được nhóm theo từng cuộc trò chuyện và theo giờ (“12 tin nhắn đã bị xóa, 1 tin nhắn đã được chỉnh sửa, 0 tin nhắn không tìm thấy”), và các sự cố như đăng xuất hoặc ổ đĩa đầy vẫn được giữ lại trong danh sách bất kể các cuộc trò chuyện có bận rộn đến mức nào.

**Các công cụ khác → Tài khoản** bắt đầu từ trường số điện thoại. **Tiếp tục** sẽ dẫn trực tiếp đến mục nhập mã, chỉ yêu cầu thông tin đăng nhập API khi chưa có. Nhập qua QR và tệp là các tab thay thế. Thông tin đăng nhập API đã lưu chỉ được tái sử dụng trong chính không gian làm việc của chúng. Màn hình nhập liệu không có thanh bên, thống kê hoặc các phần cài đặt. Biểu tượng **Cài đặt** mở các tùy chọn điều khiển API, proxy, lưu trữ và tài khoản bổ sung. Một không gian làm việc mới sẽ mở [màn hình thiết lập ban đầu](https://phishdestroy.io/tgwitness/vi/docs/reference/settings/) ; sau khi đăng nhập, một không gian làm việc có các nguồn và bản ghi đã lưu sẽ mở **phần Trò chuyện** . Việc thay đổi lộ trình yêu cầu tạm dừng quan sát và hủy bỏ quá trình đăng nhập chưa hoàn tất. Một nhật ký hiện có không thể được liên kết lại một cách im lặng với một tài khoản Telegram khác.

**Tính năng xuất** kiểm tra tính toàn vẹn của nhật ký và tạo ra các tệp có thể di chuyển. ID không gian làm việc của nó có thể được truyền vào CLI tải xuống. Mỗi lần xuất đều cố định một tiền tố nhật ký đầy đủ; các sự kiện sau đó sẽ được đưa vào lần xuất tiếp theo. Các bộ lọc tìm kiếm không thay đổi phạm vi gói. Thông tin chi tiết về việc ký và phạm vi bao phủ nằm trong **phần Xác minh và bằng chứng**.

Bảng điều khiển hiển thị trạng thái bộ thu thập, các tệp phương tiện đang xếp hàng/bị lỗi, tệp phương tiện đang chờ xử lý lâu nhất, dung lượng đĩa trống, các yêu cầu tạm dừng và các nguồn chưa được xác nhận quyền truy cập trong **phần Tình trạng bộ thu thập**. Các chi tiết này ban đầu được thu gọn và ẩn đi trên trang Tài khoản. Một thẻ hướng dẫn thiết lập sẽ hiển thị bước tiếp theo: kết nối tài khoản, chọn nguồn hoặc bắt đầu theo dõi. Danh sách tài khoản là bản chụp nhanh tại thời điểm tải; không gian làm việc đã chọn sẽ được làm mới định kỳ. Đây không phải là công cụ giám sát SLA đa quy trình.

Giao diện dùng tài nguyên cục bộ và hiển thị dạng văn bản cho nội dung nguồn. Bố cục máy tính và bố cục hẹp trên Chromium đã được kiểm thử.

## Môi trường triển khai

| Môi trường | Cài đặt | Tình trạng xác minh |
| --- | --- | --- |
| Máy tính cá nhân/máy chủ Windows | Python 3.11 trở lên, scripts\Setup.cmd/Start.cmd, thư mục dữ liệu riêng tư | Đã được kiểm tra tại địa phương trên hệ điều hành Windows/Python 3.12 |
| Máy chủ Linux/VPS | Môi trường ảo Python (venv), người dùng dịch vụ chuyên dụng, HTTPS/SSH | Cung cấp mã nguồn, CI và ví dụ về systemd; không được thực thi trên máy chủ này |
| macOS | Môi trường ảo Python (venv), tiến trình nền trước hoặc trình duyệt | Ví dụ về launchd được cung cấp; cần thực hiện kiểm tra cài đặt riêng biệt |
| Docker/Compose | Khối lượng dữ liệu ổn định, một nhân viên | Cung cấp định nghĩa và tính năng kiểm tra thời gian chạy CI; Docker không khả dụng tại địa phương |
| Trình duyệt trên điện thoại | Kết nối với bảng điều khiển được bảo vệ trên máy chủ đang hoạt động | Đã thử nghiệm với bố cục Chromium thu gọn; trình thu thập dữ liệu không hoạt động trên iOS/Android |

Khả năng di động có nghĩa là không bắt buộc phải sử dụng dịch vụ đám mây hay xây dựng giao diện người dùng. Mỗi hệ thống đích vẫn cần có các phụ thuộc Python/mã hóa tương thích, ổ đĩa cục bộ và quyền truy cập mạng. Vui lòng tham khảo [tệp DEPLOYMENT.md](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/) và [các mẫu dịch vụ](https://github.com/phishdestroy/TgWitness/blob/main/deploy/README.md).

Các không gian làm việc chia sẻ CPU, bộ nhớ và vòng lặp sự kiện. Để cách ly các tiến trình, hãy sử dụng các phiên bản, cổng, thư mục dữ liệu và quyền truy cập tài khoản riêng biệt. Không có bảng điều khiển thống nhất giữa các phiên bản riêng biệt. Tuyệt đối không được chỉ định nhiều tiến trình làm việc truy cập cùng một cơ sở dữ liệu.

## Kiểm tra và xuất dữ liệu ban đầu

Chạy lệnh `python start.py --check` trước khi khởi động môi trường đã chuẩn bị. Thêm tham số `--json` để thực hiện kiểm tra dưới dạng dữ liệu máy đọc được hoặc truyền các tham số `--data-dir`, `--host` và `--port` theo ý định. Lệnh này kiểm tra các điều kiện tiên quyết mà không cần đăng nhập Telegram hoặc tạo nhật ký. Quá trình xác minh nhật ký diễn ra trong quá trình khởi động ứng dụng, và trạng thái sẵn sàng ghi nhận sẽ hiển thị trên bảng điều khiển. Cổng bị chiếm dụng có thể chỉ là một phiên bản hiện có.

Các trình duyệt hỗ trợ API Truy cập Hệ thống Tệp sẽ lưu các tệp xuất thông qua một luồng dữ liệu có thể ghi . Các trình duyệt khác chỉ lưu trữ tạm thời tối đa 128 MiB. Vui lòng sử dụng CLI truyền luồng cho các tệp xuất có dung lượng lớn hơn hoặc đối với các trình duyệt không hỗ trợ truyền tệp:

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

Thêm mã `--profile ID` từ mục Xuất để tạo không gian làm việc con. Sử dụng mã `--url https://server` để truy cập từ xa. Giao thức HTTP thuần túy chỉ được chấp nhận đối với các đích loopback. Mã thông báo được đọc từ tệp và gửi trong tiêu đề, không được hiển thị trên màn hình hay đưa vào URL. Các yêu cầu chuyển hướng sẽ bị từ chối. Các đích hiện có sẽ không bị ghi đè. Các lần truyền dữ liệu thất bại sẽ xóa tệp tạm thời tương ứng. Giá trị SHA-256 được báo cáo là tổng kiểm tra của quá trình truyền; quý vị cần xác minh tệp ZIP đã ký một cách riêng biệt bằng dấu vân tay/điểm kiểm tra đáng tin cậy.

## Sao lưu, khôi phục và các sự cố gián đoạn

1. Tạm dừng quá trình quan sát và dừng quy trình một cách triệt để.
2. Sao chép toàn bộ thư mục dữ liệu: cơ sở dữ liệu, WAL/SHM (nếu có), tệp phương tiện, `credentials.enc`, `signing.enc`, `network.enc`, khóa kho lưu trữ/siêu dữ liệu, mã thông báo, các điểm kiểm tra và mọi thư mục `profiles/`.
3. Đối với chế độ khóa bên ngoài, hãy bảo quản riêng biệt khóa chính và lưu giữ từng khóa `vault.external.json`. Việc tạo khóa mới sẽ không thể khôi phục các thông tin bí mật cũ.
4. Khôi phục dữ liệu trong khi đích đang bị tạm dừng; cấu hình khóa gốc, hạn chế quyền truy cập và xác minh tính toàn vẹn trước khi tiếp tục.
5. Ghi lại thời gian ngừng hoạt động và kết quả xác minh. Thời gian ngừng hoạt động vẫn là khoảng trống đã được ghi lại; một bản chụp lịch sử sẽ bổ sung trạng thái sau khoảng trống đó.

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](https://phishdestroy.io/tgwitness/vi/docs/reference/deployment/#updates-and-backups). Four things are protected differently:

| Nội dung | Bảo vệ |
| --- | --- |
| Tệp xuất không có mật khẩu (mặc định) | Đã được ký số, nên mọi thay đổi đều phát hiện được; đặt mật khẩu để mã hóa bản xuất |
| Tệp xuất có mật khẩu | Nếu quý vị đặt mật khẩu, tệp xuất hoàn chỉnh sẽ được lưu nguyên vẹn dưới dạng tệp ZIP được mã hóa bằng AES-256 của WinZip mà 7-Zip và WinRAR đều có thể mở được; mật khẩu sẽ không được lưu trữ ([quy trình xử lý bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/)) |
| Cơ sở dữ liệu nhật ký và các tệp đính kèm được lưu trữ trên đĩa | Ổ đĩa hoặc phân vùng được mã hóa và quyền truy cập thư mục |
| Các phiên Telegram và khóa ký | Được mã hóa trong thư mục dữ liệu (`credentials.enc`, `signing.enc`, `network.enc`) |

Sao lưu toàn bộ dịch vụ là thư mục dữ liệu đã được lưu trữ như mô tả ở trên, chứ không phải là tệp xuất. Vui lòng sử dụng bộ nhớ được bảo vệ và cơ chế truyền tải có chủ đích cho cả hai trường hợp. Các tệp xuất tạm thời trên máy chủ được lưu trữ trong thư mục `temporary-exports/` của từng không gian làm việc; các phản hồi đã hoàn tất sẽ được xóa, còn các tệp xuất bị gián đoạn sẽ bị loại bỏ vào lần khởi động tiếp theo trong khi khóa phiên bản của không gian làm việc đó vẫn còn hiệu lực.

Sau sự kiện khôi phục kết nối, bộ thu thập yêu cầu các bản cập nhật bị bỏ lỡ từ vị trí cập nhật đã lưu. Các tác vụ phương tiện bền vững và vị trí cập nhật Telegram vẫn tồn tại sau khi khởi động lại; xem [định dạng bằng chứng](https://phishdestroy.io/tgwitness/vi/docs/reference/evidence/#durable-collection-and-process-receipts-02).

## Dung lượng và thời gian lưu trữ

Giới hạn mặc định, tất cả đều có thể thay đổi trong **Công cụ khác → Tham số**: 1,000 cuộc đối thoại đầu tiên, 500 tin nhắn cho mỗi bản chụp nhanh, 4 GiB nội dung ZIP đã ký không nén (các tệp lưu trữ lớn hơn cần `verify.py --max-gib N`) và 128 MiB dự phòng trình duyệt. Tệp đính kèm chiếm 1–2,000 MiB cho mỗi loại trong **Công cụ khác → Nguồn → Ghi lại → Tệp đính kèm**. Giao diện dòng lệnh (CLI) tải xuống mặc định là 5 GiB dữ liệu được chuyển. Dung lượng đĩa khả dụng có thể là giới hạn thấp hơn. Dành dung lượng cho nhật ký, phương tiện, WAL, các tệp xuất tạm thời và bản sao lưu. Các tệp xuất sử dụng khối lượng dữ liệu thay vì thư mục 512 MiB `/tmp` của Compose.

Đo lường số sự kiện/giây, tuổi hàng đợi, số byte phương tiện và độ trễ đĩa thay vì chỉ đếm các nhóm. Việc phân phối trực tiếp được đo lường trên bộ thu đang chạy. Không có cơ chế xóa tự động khi hết thời hạn lưu trữ. Việc xóa phần cuối của nhật ký sẽ làm mất hiệu lực mối quan hệ của nó với các điểm kiểm tra được lưu trữ.

Kiểm tra lại ưu tiên đã có sẵn: các nguồn gắn sao mặc định được kiểm tra lại mỗi 15 phút, các nguồn khác mỗi 6 giờ (xem [các cấp kiểm tra lại](https://phishdestroy.io/tgwitness/vi/docs/reference/collection/#recheck-tiers)). Xuất dữ liệu có mật khẩu hoạt động như mô tả ở trên. Quyền truy cập giới hạn được mô tả trong [truy cập và quyền hạn](https://phishdestroy.io/tgwitness/vi/docs/reference/access/). Xem [READINESS.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/READINESS.md), [LIVE_ACCEPTANCE.md](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md) và [VERIFICATION.md](https://phishdestroy.io/tgwitness/vi/docs/reference/verification/).
