Tham khảo / Thiết lập
Telegram · Các định dạng tài khoản và phiên làm việc
Đăng nhập bằng số điện thoại, mã QR hoặc khóa xác thực, nhập các phiên làm việc từ Telethon, Pyrogram hoặc Telegram Desktop, và quản lý nhiều tài khoản cùng lúc.
TgWitness / Tài liệu · Bắt đầu
TgWitness đăng nhập dưới dạng tài khoản người dùng Telegram (không phải bot) qua giao thức MTProto, sử dụng Telethon. Mỗi tài khoản tồn tại trong không gian làm việc riêng (được gọi là “workspace” trong API và các công cụ dòng lệnh) với phiên làm việc, nguồn dữ liệu, nhật ký và khóa ký riêng.
Các tệp phiên làm việc, chuỗi phiên làm việc và Khóa xác thực là các thông tin ủy quyền tài khoản: bất kỳ ai sở hữu chúng đều có thể thực hiện các thao tác như chủ tài khoản đó. Chúng không chứa lịch sử tin nhắn.
[!CẢNH BÁO] Sử dụng các tài khoản chuyên dụng. Telegram hạn chế và có thể cấm vĩnh viễn các tài khoản do khối lượng yêu cầu mà họ coi là quá mức, bất kể khách hàng hay mục đích là gì, và chỉ ghi chép một phần các giới hạn đó. Hãy kết nối các tài khoản được chuẩn bị sẵn cho mục đích quan sát thay vì các tài khoản cá nhân hoặc các tài khoản có giá trị khác, và tạo ID API / băm API trên một tài khoản chuyên dụng.
- Tổng quan
- Trước khi bắt đầu: ID API và mã băm API
- Số điện thoại · Mã QR · Khóa xác thực (Auth Key) + ID DC
- Tệp tài khoản: Telethon .session · Pyrogram .session · Cặp phiên + JSON · TData · StringSession · Khóa xác thực (Auth key) và DC trên cùng một dòng · Tệp JSON tài khoản
- Xác định những gì quý vị đang có · Các định dạng không được hỗ trợ
- Nhiều tài khoản · Bảo vệ an toàn cho các tệp tài khoản · Khắc phục sự cố
Tổng quan#
| Những gì quý vị có | Tab “Thêm tài khoản” | Quý vị cũng sẽ cần |
|---|---|---|
| Số điện thoại và quyền truy cập vào các mã đăng nhập của công cụ này | Điện thoại | Mật khẩu xác thực hai yếu tố (2FA) nếu tính năng này đã được kích hoạt |
| Telegram đang mở trên một thiết bị khác | Mã QR | Mật khẩu xác thực hai yếu tố (2FA) nếu tính năng này đã được kích hoạt |
Một tệp .session (Telethon hoặc Pyrogram) |
Tệp tin | Tệp JSON đi kèm (tùy chọn) dành cho cài đặt ứng dụng |
.session + .json cùng tên |
Tệp tin (chọn cả hai) | Thông thường không có nội dung nào khác |
Thư mục tdata trên Telegram Desktop |
Tệp tin (dạng ZIP) | Mật mã cục bộ trên máy tính để bàn (nếu đã được thiết lập) |
Một phiên StringSession của Telethon (văn bản, .txt, .tgwitness-session) |
Tệp tin | Không cần cặp API riêng biệt |
Khóa xác thực và DC được ghi trên cùng một dòng, <512 hex>:<1–5> |
Tệp (dán hoặc tệp văn bản) | Không cần cặp API riêng biệt |
Một khóa .json kèm theo phiên làm việc hoặc Khóa xác thực (Auth Key) |
Tệp tin | Không cần cặp API riêng biệt |
| Một Khóa xác thực (512 ký tự hex) và số DC tương ứng | Khóa xác thực | ID người dùng (tùy chọn) |
TgWitness nhận diện các tệp dựa trên nội dung chứ không phải tên tệp. Việc đổi tên tệp sẽ không bao giờ làm thay đổi nội dung của tệp đó.
Trước khi bắt đầu: ID API và mã băm API#
Bạn có thể đăng nhập mà không cần tạo ứng dụng API Telegram. Khi không có cặp khóa nào được nhập,
nhập từ nguồn bên ngoài hoặc đã được lưu sẵn trong không gian làm việc, TgWitness sẽ chọn một cặp từ kho dự trữ tích hợp sẵn gồm
50 cặp API công khai (tgwitness/api_pool.py), ưu tiên Telegram Desktop cho lần
đăng nhập mới và ưu tiên sử dụng cặp đã lưu trước; các cặp còn lại sẽ được xáo trộn ngẫu nhiên. Nếu Telegram từ chối một cặp
(API_ID_INVALID, API_ID_PUBLISHED_FLOOD, UPDATE_APP_TO_LOGIN), cặp tiếp theo sẽ được thử,
tối đa tám cặp cho mỗi lần đăng nhập; các cặp bị từ chối sẽ bị bỏ qua cho đến khi khởi động lại. Cặp đã dùng để đăng nhập sẽ được
lưu cùng với tài khoản và được tái sử dụng cho tài khoản đó.
Các cặp tích hợp sẵn là công khai: chúng được công bố trong mã nguồn mở của các ứng dụng khách
và thư viện Telegram. ID API và băm API dùng để xác định ứng dụng đối với Telegram
và không cấp quyền truy cập vào dữ liệu tài khoản. Quá trình đăng nhập sử dụng cơ chế xác thực riêng của tài khoản: mã đăng nhập
và mật khẩu 2FA, hoặc phiên làm việc mà tài khoản đó đã xác thực trước đó. Mỗi
observation.started bản ghi đều ghi rõ cặp thông tin được sử dụng, do đó một cặp tích hợp sẵn được ghi chép cho
tòa án theo cách tương tự như cặp của chính bạn. Thay vào đó, bạn có thể nhập cặp thông tin của riêng mình từ my.telegram.org.
Theo kinh nghiệm của dự án, việc tạo một cặp thông tin cá nhân mới thường khiến hầu hết các tài khoản bị đăng xuất, vì vậy chỉ nên sử dụng
cặp này khi vụ việc yêu cầu ứng dụng của riêng bạn: hãy tạo cặp này bằng một tài khoản chuyên dụng và
nhập nó trước khi quá trình thu thập dữ liệu bắt đầu (các bước dưới đây).
Các trường kết nối bị thiếu sẽ sử dụng cặp thiết bị/hệ điều hành xác định từ các danh mục
opentele2 2.0.0 đi kèm :
Desktop 2040, Android 6, Android X 21724, iOS 10840, macOS 2834 và Web 2496.
ID xây dựng nguồn của Android 4 cũng sử dụng danh mục Android, như được xác định trong
BuildVars của Telegram Android .
Web mặc định là A; hậu tố phiên bản ứng dụng K được nhập hoặc gói ngôn ngữ macos sẽ chọn
K, và phiên bản 0.7.0 sẽ chọn Webogram. Các ID ứng dụng không xác định sẽ giữ nguyên
các giá trị mặc định của máy chủ Telethon. Các trường được nhập vào luôn được ưu tiên, bao gồm cả phiên bản ứng dụng cũ hơn và
gói ngôn ngữ trống. Danh mục không bao giờ thay đổi ID/băm API. Ảnh chụp phiên bản của nó được
xem xét rõ ràng, không được lấy trong quá trình đăng nhập. Hồ sơ đã lưu sẽ vẫn ổn định sau khi cập nhật.
account.getAuthorizations báo cáo siêu dữ liệu ủy quyền đã lưu của Telegram; đây
không phải là bản sao của mỗi initConnection mới. So sánh nó với hồ sơ thực tế đã được gửi.
Việc kết nối một ủy quyền hiện có không xác thực băm API đi kèm:
initConnection gửi ID API, trong khi băm được sử dụng cho các yêu cầu đăng nhập.
Sau khi xác thực bằng điện thoại mới hoặc mã QR, TgWitness yêu cầu cấu hình, trung tâm dữ liệu (DC) gần nhất,
trạng thái trực tuyến, ngôn ngữ (khi gói ngôn ngữ không trống), cập nhật ứng dụng và
cập nhật điều khoản dịch vụ, với khoảng thời gian 0.3–1.5 giây giữa các yêu cầu. Việc cập nhật trạng thái
sẽ tạm thời đánh dấu tài khoản là đang trực tuyến. Chuỗi thao tác này chỉ chạy một lần khi hoàn tất đăng nhập,
không chạy khi nhập dữ liệu, kết nối lại hoặc khởi động lại. Việc xác thực được lưu trước tiên; một yêu cầu
thất bại sẽ dừng chuỗi thao tác mà không thử lại hoặc hủy bỏ quá trình đăng nhập. Kết quả được
ghi lại dưới dạng account.initialized, với tên lỗi thay vì nội dung phản hồi.
Các chính sách riêng của Telegram quyết định các hạn chế đối với tài khoản.
Đối với tdesktop
, nếu thiếu tz_offset
, hệ thống sẽ sử dụng độ lệch UTC cục bộ của máy chủ, được làm tròn
đến 900
giây bằng thuật toán
opentele2
(MIT; giấy phép tại tgwitness/client_profiles.LICENSE
). Giá trị này được cập nhật trên mỗi
lần kết nối để phản ánh các thay đổi do giờ mùa hè. tz_offset
được nhập vào sẽ được ưu tiên trên mọi nền tảng và được giữ nguyên chính xác, kể cả giá trị bằng không. Các mục
initConnection.params
khác vẫn được giữ lại.
Biểu mẫu đăng nhập HTTP chấp nhận múi giờ dạng số được trả về từ quá trình nhập tệp;
các giá trị boolean, số thập phân và độ lệch nằm ngoài phạm vi được hỗ trợ sẽ bị từ chối.
Các tuyến đường Direct, SOCKS5 và HTTP CONNECT sử dụng ConnectionTcpObfuscated
của Telethon (MTProto được rút gọn và làm mờ). HTTPS CONNECT duy trì TLS đến proxy và sử dụng
cùng một giao thức truyền tải được làm mờ bên trong đường hầm. MTProxy duy trì
giao thức truyền tải trung gian ngẫu nhiên và xử lý khóa bí mật theo yêu cầu. Việc chuyển đổi đường dẫn áp dụng
các lựa chọn tương tự. Việc làm mờ thay đổi cấu trúc gói tin; nó không che giấu tài khoản
hoặc siêu dữ liệu khách hàng của tài khoản đó khỏi Telegram cũng như không ngụ ý khả năng miễn trừ các hạn chế.
Sau khi kết nối với một máy khách được ủy quyền, TgWitness sẽ kiểm tra cấu hình, trung tâm dữ liệu (DC) gần nhất,
tình trạng ủy quyền hiện tại, cơ sở tham chiếu lớp đã được xem xét, ngôn ngữ, các bản cập nhật ứng dụng
và các bản cập nhật điều khoản dịch vụ. Các chẩn đoán này chạy một lần cho mỗi phiên bản máy khách,
trước khi thu thập dữ liệu, và được hiển thị trong chi tiết kết nối kèm theo thời gian thực hiện.
account.connection_checked ghi lại kết quả mà không bao gồm băm phiên, địa chỉ IP,
mã thông báo hoặc băm API. Chúng không bao giờ chấp nhận điều khoản hoặc cài đặt bản cập nhật. Lỗi yêu cầu
hoặc FloodWait sẽ dừng các yêu cầu tiếp theo; kết quả bị thiếu sẽ được ghi nhận là không xác định.
Các kiểm tra cục bộ vẫn có thể báo cáo kết quả trong khi các kiểm tra mạng bị bỏ qua.
Khi bật chế độ chọn lọc cuộc trò chuyện nghiêm ngặt,
thông tin ủy quyền hiện tại sẽ không được yêu cầu và kiểm tra đó sẽ được hiển thị là đã bị bỏ qua.
Sau khi đăng nhập và mỗi khi kết nối mới, TgWitness sẽ đọc cài đặt nội dung nhạy cảm
của tài khoản. Khi cài đặt này bị tắt và Telegram cho phép thay đổi, TgWitness sẽ bật nó lên
để nội dung mà Telegram đánh dấu là nhạy cảm (18+) được lưu lại, đồng thời ghi lại giá trị của `
account.content_settings`. Cài đặt này thuộc về tài khoản và áp dụng cho mọi
ứng dụng Telegram. Chế độ "Strict chosen chats" sẽ không thay đổi cài đặt này; hãy bật chế độ đó trước khi đăng nhập.
Các yêu cầu đồng thời nhằm khôi phục kết nối của một không gian làm việc sẽ chia sẻ cùng một client và chờ cho đến khi quá trình thiết lập kết nối của không gian làm việc đó hoàn tất. Nếu một lần thử bị thất bại hoặc bị hủy, hệ thống sẽ giải phóng yêu cầu tiếp theo để thử lại. Nếu thông tin đăng nhập đã lưu, client hoặc trạng thái ủy quyền thay đổi trong quá trình thiết lập, lần thử trước đó sẽ dừng lại thay vì báo cáo rằng kết nối đã sẵn sàng.
Chẩn đoán FloodWait lưu giữ phương thức TL bị lỗi, bất kỳ trình bao bọc Takeout/range nào,
thời gian chờ do máy chủ yêu cầu và thời hạn hiệu lực trong telegram.backoff.
Chi tiết kết nối hiển thị phương thức và thời hạn trong khi các yêu cầu bị tạm dừng.
Chẩn đoán bao gồm bộ đếm số lần gọi của khách hàng theo từng phương thức kể từ khi khách hàng đó
được tạo; chúng đếm việc giải quyết đối tác lồng nhau riêng biệt, nhưng không đếm gói tin
hoặc các lần thử lại nội bộ của Telethon. Các bộ đếm hiện tại cũng có sẵn dưới dạng
collector.rpc_activity trong API trạng thái. Không bao gồm đối số yêu cầu, tên người dùng,
hàm băm truy cập hoặc văn bản ngoại lệ. Chẩn đoán cuối cùng và thời hạn đầy đủ
vẫn tồn tại sau khi khởi động lại. Các lần chờ trước đó không có bản ghi phương thức không thể được gán
lại sau này. Xem giới hạn xuất để xem xét nguồn và
sự khác biệt giữa khám phá và thu thập lịch sử.
official_app=True hoặc False là cờ ủy quyền hiện tại của Telegram. Cả hai
giá trị này đều không xác định liệu tài khoản đó có bị hạn chế, đáng tin cậy hay đang được giám sát hay không.
Các bản chụp nhanh account.devices ở chế độ bằng chứng hiện có vẫn lưu giữ lịch sử của tất cả
các thiết bị đã đăng nhập; chẩn đoán kết nối chỉ lưu giữ mô tả thiết bị hiện tại.
Trước khi kết nối, các kiểm tra tư vấn so sánh nền tảng API, gói ngôn ngữ, định dạng thiết bị/hệ điều hành và phiên bản ứng dụng, vùng địa phương của hệ thống di động, cùng lớp lược đồ thực tế của Telethon với cơ sở tham chiếu danh mục đã được xem xét. Các cảnh báo xuất hiện trong nhật ký máy chủ và siêu dữ liệu trạng thái tài khoản; chúng không bao giờ thay thế các giá trị đã nhập hoặc thay đổi lớp lược đồ. Một lớp khác là tín hiệu để xem xét tính tương thích; trạng thái kết nối của chính tài khoản sẽ cho biết liệu nó có hoạt động hay không. Telegram quyết định các hạn chế từ phía mình, bất kể hồ sơ khách hàng nào được sử dụng. Trạng thái tài khoản bị ngắt kết nối sẽ sử dụng hồ sơ đã lưu thay vì tạo một mô tả thiết bị khác.
Để sử dụng ứng dụng của riêng bạn thay thế:
- Vui lòng truy cập my.telegram.org và đăng nhập bằng bất kỳ số điện thoại nào mà quý vị đang sở hữu. Mã xác minh sẽ được gửi đến ứng dụng Telegram, không phải qua tin nhắn SMS.
- Chọn các công cụ phát triển API.
- Tạo ứng dụng: bất kỳ tiêu đề và tên ngắn nào (5–32 ký tự), nền tảng Máy tính để bàn. Các trường URL và mô tả có thể để trống.
- Vui lòng sao chép App api_id (một số) và App api_hash (32 ký tự thập lục phân).
Trong bảng điều khiển, phần “API ID + Hash” nằm ngay dưới biểu mẫu đăng nhập. Quý vị có thể dán một
cặp api_id:api_hash duy nhất vào ô “API ID” và cả hai trường sẽ được điền tự động. Một cặp này có thể
được sử dụng cho tất cả các tài khoản của quý vị. Sau khi đăng nhập thành công, thông tin này sẽ được lưu trữ dưới dạng mã hóa, chỉ trong
không gian làm việc đó và tuyệt đối không bao giờ được gửi trở lại trình duyệt.
Có ba loại thông tin xác thực khác nhau liên quan đến vấn đề này:
| Bí mật | Mở | Địa chỉ trang web |
|---|---|---|
| Mã thông báo bảng điều khiển | Bảng điều khiển web TgWitness | panel-token.txt trong thư mục dữ liệu, hoặc TGWITNESS_TOKEN |
| ID API + mã băm | Không có nội dung nào riêng lẻ; chỉ xác định ứng dụng | Cặp tài khoản tích hợp sẵn, cài đặt được nhập vào hoặc ứng dụng của riêng quý vị tại my.telegram.org |
| Xác thực tài khoản | Tài khoản Telegram | Được tạo thông qua đăng nhập bằng điện thoại/mã QR hoặc được nhập dưới dạng phiên làm việc |
Nếu phải truy cập Telegram qua proxy, hãy thiết lập trước tại mục Công cụ khác → Tài khoản → Cài đặt → Cài đặt kết nối → Thay đổi đường dẫn kết nối.
Số điện thoại#
- Mở thêm công cụ → Tài khoản, tab Điện thoại, và nhập số theo định dạng quốc tế,
ví dụ:
+44 7700 900123. Khoảng trắng và dấu gạch ngang sẽ được tự động loại bỏ. - Nhấn vào “Tiếp tục”. Các trường API ID và Hash có thể để trống.
- Nhập mã mà Telegram gửi, thường là vào ứng dụng Telegram; Telegram sẽ quyết định có gửi tin nhắn SMS hay không.
- Nếu tài khoản đã bật xác thực hai bước, vui lòng nhập mật khẩu đó. Đây không phải là mã token trên bảng điều khiển và cũng không phải là mã khóa thiết bị.
- Vui lòng kiểm tra ID tài khoản hiển thị sau khi đăng nhập, sau đó chọn các nguồn.
Mã đăng nhập và mật khẩu xác thực hai yếu tố (2FA) tuyệt đối không bao giờ được lưu trữ trên đĩa cứng.
Mã QR#
Vui lòng sử dụng tính năng này khi tài khoản đã được đăng nhập sẵn trên điện thoại hoặc máy tính khác.
- Nhấp vào tab Mã QR → Hiển thị mã QR. Các trường API ID và Hash có thể để trống.
- Trên thiết bị đã đăng nhập: Cài đặt → Thiết bị → Kết nối thiết bị máy tính để bàn, quét mã và xác nhận.
- Vui lòng nhập mật khẩu xác thực hai yếu tố (2FA) vào TgWitness nếu Telegram yêu cầu.
Hình ảnh mã QR được tạo tại địa phương. Mã có thời hạn sử dụng; vui lòng nhấn vào “Tạo mã QR khác” để thử lại. Việc khóa bảng điều khiển, chuyển sang không gian làm việc khác hoặc đăng nhập bằng tài khoản khác sẽ hủy bỏ mã đang chờ xử lý.
Khóa xác thực (Auth Key) + ID DC#
Khóa xác thực (Auth Key) là khóa ủy quyền thô dài 256 byte đằng sau mỗi phiên Telegram, được biểu diễn dưới dạng 512 ký tự thập lục phân, kèm theo số trung tâm dữ liệu từ DC 1 đến DC 5.
- Tab Khóa xác thực. Vui lòng dán toàn bộ khóa; khóa rút gọn có chứa ký tự
…sẽ không hoạt động. - Vui lòng chọn ID DC được cung cấp kèm theo khóa.
- Quý vị có thể nhập ID người dùng (tùy chọn). TgWitness sẽ từ chối kết nối nếu Telegram báo cáo một tài khoản khác.
- Tài khoản Press Connect.
Khóa xác thực (512 ký tự) không phải là mã băm API (32 ký tự). Cùng một khóa này cũng có thể được nhập dưới dạng JSON; vui lòng tham khảo phần JSON tài khoản.
Tệp tài khoản#
Mở Thêm tài khoản → Tệp và chọn tối đa bốn tệp thuộc về một tài khoản, tổng dung lượng 8 MiB, nhấn Kiểm tra tệp, sau đó nhấn Kết nối tài khoản. Việc chọn tệp hoặc dán văn bản phiên làm việc sẽ không gửi đi bất kỳ dữ liệu nào; lệnh Kiểm tra tệp sẽ gửi chúng đến máy chủ TgWitness của bạn, máy chủ này sẽ đọc các tệp đó mà không cần đăng nhập và hiển thị phiên làm việc mà nó tìm thấy.
Các biểu mẫu Files, Auth key và nhập hàng loạt hiển thị cảnh báo phiên song song trước khi kết nối. Theo mặc định, các ủy quyền đã nhập sẽ được tái sử dụng. Giữ ứng dụng gốc đóng trong khi khóa của nó đang được sử dụng tại đây. Files và Auth key cũng cung cấp Tạo ủy quyền độc lập, được mô tả bên dưới. Nhập hàng loạt vẫn sử dụng chế độ trực tiếp. Đăng nhập qua điện thoại và QR tương tác sẽ tạo ra các ủy quyền riêng biệt. Tiêu đề cảnh báo vẫn hiển thị trong biểu mẫu nhập; phần giải thích đầy đủ sẽ mở ra tự động khi các tệp hoặc chuỗi khóa/phiên được cung cấp. Phần này có thể được thu gọn sau khi đọc, để trình chọn tệp và các điều khiển kết nối vẫn có thể sử dụng được trên điện thoại.
Việc triển khai đã được xác thực (Phala Cloud, Intel TDX) không thu thập dữ liệu từ khóa đã nhập. Trong trường hợp này, Tệp và Khóa xác thực chỉ kết nối khi tùy chọn Tạo ủy quyền độc lập được chọn; việc nhập hàng loạt bị từ chối. Đăng nhập bằng điện thoại và mã QR vẫn hoạt động bình thường.
- Các tệp tin được chuyển đổi trực tiếp trong bộ nhớ trên máy chủ TgWitness của quý vị. Các tệp tải lên không được lưu trữ, các tệp ZIP không được giải nén ra đĩa và không có dịch vụ bên ngoài nào được liên hệ.
- Phiên ghi chép thu được sau đó sẽ được đối chiếu với Telegram. Nếu một tệp ghi nhận ID người dùng, thì ID đó phải trùng khớp với thông tin tài khoản mà Telegram cung cấp.
- Các tệp mô tả các tài khoản khác nhau hoặc thông tin đăng nhập API khác nhau sẽ bị từ chối thay vì chỉ chọn một tài khoản duy nhất.
- Mã thông báo hoặc văn bản phiên làm việc chứa trường mã thông báo cục bộ TData, một ô để dán StringSession và đọc tệp mà không cần đăng nhập (điền biểu mẫu mà không cần kết nối với Telegram). Việc dán StringSession sẽ xóa các tệp đã chọn, và việc chọn tệp sẽ xóa văn bản đã dán, do đó quá trình kiểm tra và kết nối sẽ sử dụng lựa chọn mới nhất. Sau khi thay đổi mật khẩu, hãy nhấn Kiểm tra tệp một lần nữa.
Tạo một quy trình ủy quyền độc lập#
Chọn Tạo một ủy quyền độc lập trước khi kết nối các tệp đã nhập hoặc một Khóa ủy quyền. TgWitness kết nối tạm thời với thiết bị nguồn đã nhập, sử dụng nó để phê duyệt mã thông báo đăng nhập QR của khách hàng mới, và ngắt kết nối thiết bị nguồn ngay sau khi phê duyệt. Khách hàng mới có khóa ủy quyền riêng và một hồ sơ máy tính để bàn được chọn riêng. Thông tin đăng nhập API và hồ sơ thiết bị do người hiến tặng cung cấp chỉ được sử dụng cho kết nối với người hiến tặng. Không có ủy quyền hiện có nào bị đăng xuất hoặc thu hồi.
Trong bước này, hãy giữ cho ứng dụng khách gốc của người tặng hoàn toàn ở trạng thái đóng. Kết nối ban đầu vẫn sử dụng khóa đã sao chép, do đó chế độ này không thể loại bỏ rủi ro sử dụng song song ban đầu đó. Sau khi kết nối ủy quyền mới được thiết lập, chủ sở hữu có thể mở lại ứng dụng khách gốc và sử dụng cả hai cùng lúc. Đăng nhập tương tác qua mã QR cho phép khách hàng gốc phê duyệt việc đăng nhập mà không cần sao chép hoặc kết nối khóa của nó tại đây.
Không được đăng xuất hoặc kết thúc phiên làm việc của người tặng. Khi phiên làm việc đã phê duyệt đăng nhập qua mã QR
kết thúc, Telegram cũng sẽ kết thúc phiên làm việc mà nó đã phê duyệt; trong một lần kiểm tra thực tế, việc
xác thực mới đã bị ngừng chỉ trong vòng một giây sau khi người tặng đăng xuất. Quá trình nhập dữ liệu
sẽ ghi lại thông tin phiên làm việc của người tặng (session_origin.approved_by: thiết bị, ID API và thời gian tạo).
Danh sách phiên sẽ đánh dấu phiên đó; tùy chọn Kết thúc phiên sẽ từ chối phiên; còn các tùy chọn Kết thúc tất cả các phiên khác
và Làm cho đây là phiên duy nhất sẽ giữ cho người tặng vẫn đăng nhập.
Nếu Telegram yêu cầu xác thực hai yếu tố (2FA), chế độ này sẽ sử dụng twoFA từ tệp JSON đã chọn nếu có sẵn,
hoặc yêu cầu nhập mật khẩu. Nếu mật khẩu nhập vào bị từ chối, hệ thống sẽ quay lại biểu mẫu nhập mật khẩu.
Mật khẩu sẽ không được lưu lại. Khóa dự phòng được lưu dưới dạng mã hóa trong
independent_login.enc, bao gồm cả các thay đổi trong quá trình di chuyển trung tâm dữ liệu. Sau khi
bị gián đoạn, hãy chọn cùng một tài khoản nguồn và tùy chọn này để tiếp tục với khóa ứng viên đã lưu.
Tài khoản nguồn sẽ được kiểm tra help.getAppConfig trước khi phê duyệt; một tài khoản bị đóng băng
sẽ dừng lại tại đó. Nếu Telegram từ chối tài khoản nguồn trước khi phê duyệt đăng nhập,
khóa ứng viên chưa được phê duyệt sẽ bị loại bỏ và quá trình nhập có thể bắt đầu lại. Một tài khoản nguồn khác chỉ thay thế
khóa ứng viên đã lưu khi Telegram báo cáo rằng khóa ứng viên đó chưa đăng nhập; một
khóa ứng viên đang đăng nhập hoặc đang chờ mật khẩu 2FA sẽ được giữ lại.
Không gian làm việc vẫn được dành riêng cho tài khoản đó; việc hoàn tất không thành công sẽ không xóa
không gian làm việc mới. Giữ lại thư mục dữ liệu và khóa kho của nó. Thông tin đăng nhập cuối cùng và
account.authorized bản ghi nhật ký bao gồm phương thức nhập, định dạng đầu vào và
ID API của người hiến tặng, không bao gồm khóa hoặc mật khẩu của người hiến tặng.
Vào ngày 5 tháng 11 năm 2026, một tài khoản chuyên dụng đã vượt qua các kiểm tra trực tiếp với các nhà tài trợ Telethon, Pyrogram và TData: hoàn tất xác thực hai yếu tố (2FA), các khóa ủy quyền mới riêng biệt, truy cập đồng thời của nhà tài trợ và khách hàng mới, cũng như đọc kênh công khai. Trường hợp Telethon cũng đã khôi phục một ứng viên đã lưu sau khi bị gián đoạn ở bước nhập mật khẩu. Mỗi lần xác thực mới đều hoàn tất sáu yêu cầu khởi tạo sau khi đăng nhập, và nhật ký đã ký của nó được xác minh. Phiên làm việc ban đầu vẫn có thể sử dụng được ở cả bốn định dạng được cung cấp.
Cơ sở dữ liệu lỗi RPC của Telegram liên kết
FRESH_CHANGE_ADMINS_FORBIDDEN với việc thay đổi quản trị viên, FRESH_CHANGE_PHONE_FORBIDDEN
với việc thay đổi số điện thoại, và FRESH_RESET_AUTHORISATION_FORBIDDEN với
việc thu hồi các phiên khác, thay đổi thời hạn tồn tại của chúng hoặc đăng ký khóa truy cập.
SESSION_TOO_FRESH_* và PASSWORD_TOO_FRESH_* liên quan đến việc chuyển nhượng quyền sở hữu và
rút tiền thu nhập hoặc quà tặng. Đây không phải là các thao tác thu thập dữ liệu; việc đăng nhập mới
không đồng nghĩa với lệnh cấm đọc toàn diện trong 24 giờ. Tính năng xuất dữ liệu có thể trả về
TAKEOUT_INIT_DELAY_* riêng biệt. TgWitness giữ lại các khoảng tạm dừng do máy chủ yêu cầu và không tự động thử lại
việc chấp nhận token hoặc thu hồi phiên để vượt qua các hạn chế.
Các công cụ khác → Tài khoản → Bảo mật tài khoản → Các phiên của tài khoản này → Kết thúc tất cả các phiên khác sẽ gọi hàm `auth.resetAuthorizations` theo
yêu cầu của nhà điều hành và ghi lại `account.all_other_sessions_terminated` kèm theo số lượng phiên
trước và sau đó. Telegram chấp nhận yêu cầu này từ một phiên đã đăng nhập trong vòng 24 giờ.
Khi không gian làm việc này đăng nhập bằng mã QR từ một phiên đã nhập, phiên đã phê duyệt nó
vẫn duy trì trạng thái đăng nhập: TgWitness sẽ kết thúc các phiên còn lại lần lượt bằng hàm `account.resetAuthorization` và
ghi lại vào trường `kept_approving_session`. Khi phiên này trở thành phiên duy nhất, hệ thống sẽ dừng lại với lý do đó
và không thay đổi mật khẩu.
Hãy đảm bảo đây là phiên làm việc duy nhất thực hiện thao tác này đối với một khóa được tạo ra khi đăng nhập từ không gian làm việc này, sau đó kích hoạt tính năng xác thực hai bước nếu tài khoản chưa có. Bảng điều khiển sẽ hiển thị mật khẩu đó một lần duy nhất; TgWitness chỉ lưu trữ mật khẩu đó trong kho lưu trữ của không gian làm việc cho đến thời điểm đó. Nhật ký ghi lại session.exclusive_from. Nếu sau này Telegram liệt kê một phiên khác, nhật ký sẽ ghi lại session.exclusive_ended và bảng điều khiển sẽ hiển thị cảnh báo. Trình xác minh sẽ hiển thị cả hai thông tin này.
Đảm bảo đây là phiên duy nhất khi Telegram cho phép thực hiện cùng một hành động theo lịch trình. Tùy
chọn này xuất hiện trong phần Phiên của tài khoản này cho khóa được tạo trong không gian làm việc này và được
ghi lại dưới dạng session.exclusive_automatic. Trong quá trình quan sát, bộ thu thập kiểm tra mỗi năm
phút xem đã trôi qua 24 giờ kể từ bản ghi account.authorized của khóa đó hay chưa —
Telegram trả về FRESH_RESET_AUTHORISATION_FORBIDDEN trước thời điểm đó — và sau đó thực hiện cùng một
hoạt động một lần. Thành công được ghi lại dưới dạng session.exclusive_from, tương tự như nút bấm thủ công.
Việc từ chối được ghi lại một lần dưới dạng session.exclusive_postponed kèm theo lý do từ Telegram, và
trình thu thập dữ liệu sẽ thử lại với thời gian chờ tăng dần lên đến sáu giờ. Chế độ chỉ đọc không có tác dụng ở đây:
việc kết thúc phiên là một hành động bảo mật tài khoản, không phải hành động trong cuộc trò chuyện.
Mật khẩu hai bước được tạo ra bởi quá trình chạy tự động sẽ được lưu trữ trong kho lưu trữ của không gian làm việc, được mã hóa bằng khóa không gian làm việc, trước khi Telegram thiết lập mật khẩu này. Bảng điều khiển sẽ truy xuất mật khẩu này một lần từ POST /api/account/sessions/only/password, sau đó hệ thống sẽ xóa mật khẩu này, và hiển thị nó trong cùng một hộp thoại như quy trình thủ công khi quý vị mở mục Phiên làm việc của tài khoản này. Trang kết nối sẽ thông báo rằng có một mật khẩu đang chờ xử lý. Mật khẩu này không bao giờ được ghi vào nhật ký và vẫn tồn tại sau khi khởi động lại cho đến khi được hiển thị.
Các phiên mới cũng được báo cáo trong quá trình quan sát: khi danh sách phiên của Telegram có thêm một mục,
bản ghi account.sessions sẽ đặt tên cho mục đó dưới added và bảng điều khiển sẽ hiển thị cảnh báo kèm theo
thiết bị, ứng dụng và quốc gia từ ảnh chụp nhanh đó.
Thăm dò nhân chứng#
Các công cụ khác → Tài khoản → Bảo mật tài khoản → Kiểm tra Probe của Witness để xác minh liệu một khách hàng khác có nhận được các cập nhật từ tài khoản này hay không. Thêm một không gian làm việc thứ hai đã đăng nhập bằng tài khoản Telegram khác và có khóa phiên riêng, tạo một nhóm riêng tư với cả hai tài khoản, sau đó chọn nhóm đó làm chat Probe và không gian làm việc thứ hai làm không gian làm việc Witness, rồi bật tính năng Probe. Cả hai tài khoản phải tắt chế độ Chỉ đọc, và không gian làm việc Witness phải đang ở chế độ quan sát.
Trong quá trình quan sát, không gian làm việc này gửi probe:<n>:<token> vào nhóm mỗi 60–120 giây
và ghi lại probe.sent. Nhân chứng trả lời ack:<n>:<token> và ghi lại probe.seen cùng
probe.ack_sent. Một xác nhận (ack) đến phiên làm việc này dưới dạng cập nhật trực tiếp trong vòng 20 giây sẽ
được ghi lại là probe.acked. Nếu không, không gian làm việc sẽ đọc lịch sử gần đây của nhóm. Một tín hiệu xác nhận
được tìm thấy ở đó nhưng không được gửi trực tiếp sẽ được ghi lại dưới dạng coverage.gap với lý do
probe_ack_missed_live: bảng điều khiển sẽ phát cảnh báo và đánh dấu việc tiếp nhận sự kiện là thất bại cho đến khi một
tín hiệu xác nhận sau đó đến trực tiếp (connection.restored, lý do probe_ack_live). Không có tín hiệu xác nhận nào được ghi lại dưới dạng
probe.unanswered; sự gián đoạn kết nối trong thời gian chờ hoặc lịch sử không thể đọc được sẽ được ghi lại dưới dạng
probe.inconclusive. Các trường hợp chỉ đọc, hạn chế của Telegram và các khoảng dừng FloodWait được ghi lại một lần
dưới dạng probe.skipped.
Telethon .session#
| Đây là gì | Cơ sở dữ liệu SQLite mà các công cụ dựa trên Telethon tạo ra, ví dụ như my_account.session |
| Được công nhận bởi | Các bảng sessions (cùng với dc_id, server_address, port, auth_key) và version = 7 hoặc 8 |
| Yêu cầu | Chính xác là một hàng phiên làm việc được ủy quyền; một cơ sở dữ liệu khép kín và hoàn chỉnh |
Trước tiên, hãy đóng chương trình đã tạo ra tệp đó. Nếu tệp my_account.session-journal hoặc
my_account.session-wal vẫn tồn tại bên cạnh tệp chính, điều đó có nghĩa là cơ sở dữ liệu chưa được hoàn tất: hãy mở và
đóng ứng dụng khách gốc một cách đúng quy trình. Việc xóa các tệp phụ này có thể để lại một bản sao bị hỏng.
Pyrogram .session#
| Đây là gì | Các công cụ dựa trên Pyrogram tạo ra cơ sở dữ liệu SQLite |
| Được công nhận bởi | Bảng sessions với dc_id, auth_key, test_mode, user_id, is_bot; version = 2 hoặc 3 |
| Yêu cầu | Chỉ chấp nhận một phiên đăng nhập của người dùng được ủy quyền trên mạng sản xuất. Các phiên của bot và máy chủ thử nghiệm (test-DC) sẽ bị từ chối |
ID người dùng được lưu trữ sẽ được đối chiếu với hệ thống Telegram trong quá trình đăng nhập.
Cặp phiên + JSON#
Các tài khoản thường được phân phối dưới dạng hai tệp có cùng tên, ví dụ như
447700900123.session và 447700900123.json. Vui lòng chọn cả hai tệp cùng một lúc.
- Dựa trên dữ liệu JSON, TgWitness sử dụng các giao thức
app_id/api_idvàapp_hash/api_hash, do đó quý vị thường không cần phải nhập thông tin đăng nhập API. - Cấu hình kết nối sử dụng
device_model(biệt danhdevice),system_version(biệt danhsdk),app_version,lang_code,system_lang_code(biệt danhsystem_lang_pack),lang_packvà tùy chọntz_offset(giây so với UTC, từ -43200 đến 50400). Các trường được cung cấp có ưu tiên cao hơn các giá trị mặc định được tạo tự động và ngôn ngữ của bảng điều khiển/trình duyệt . Các tên gọi khác nhau gây xung đột sẽ bị từ chối. Hồ sơ đã được giải quyết được lưu trong thông tin đăng nhập không gian làm việc được mã hóa và được tái sử dụng sau khi khởi động lại, bao gồm cả phiên bản ứng dụng của nó. phone, cài đặt proxy và mã thông báo thiết bị được bỏ qua.twoFAchỉ ở chế độ đọc khi Tạo ủy quyền độc lập được chọn; nhập trực tiếp sẽ bỏ qua nó.- Một tệp JSON không có trường ủy quyền được hỗ trợ chỉ là siêu dữ liệu. Thêm tệp phiên làm việc của nó hoặc tiếp tục đăng nhập bằng điện thoại hoặc mã QR. Một tệp JSON chứa phiên làm việc được hỗ trợ hoặc Khóa ủy quyền (Auth Key) có thể tự thực hiện ủy quyền; xem Account JSON.
Telegram Desktop (TData)#
TData là thư mục tdata của ứng dụng Telegram Desktop (ứng dụng đa nền tảng
từ desktop.telegram.org).
| Hệ thống | Vị trí mặc định tdata |
|---|---|
| Windows | %APPDATA%\Telegram Desktop\tdata (phiên bản Telegram di động: bên cạnh Telegram.exe) |
| Linux | ~/.local/share/TelegramDesktop/tdata |
| macOS | ~/Library/Application Support/Telegram Desktop/tdata |
Để nhập dữ liệu:
Cảnh báo về phiên song song. Nhập TData trực tiếp sẽ tái sử dụng khóa ủy quyền của Telegram Desktop. Không sử dụng khóa đó đồng thời trên Desktop và TgWitness. Telegram có thể vô hiệu hóa ủy quyền với
AUTH_KEY_DUPLICATED, khiến cả hai bản sao không thể sử dụng được cho đến khi đăng nhập lại.Đóng hoàn toàn Desktop, bao gồm cả tiến trình trong khay hệ thống, và giữ bản sao đó ở trạng thái đóng trong khi TgWitness sử dụng phiên đã nhập. : Đóng ứng dụng, không đăng xuất hoặc thu hồi phiên: việc thu hồi cũng làm vô hiệu hóa bản sao đã nhập. Nếu bạn cần cả hai ứng dụng khách chạy cùng lúc, hãy chọn Tạo ủy quyền độc lập và giữ Desktop ở trạng thái đóng cho đến khi đăng nhập mới thành công, hoặc đăng nhập vào TgWitness bằng điện thoại hoặc mã QR. Nên sử dụng một tài khoản chuyên dụng, nhưng điều này không đảm bảo an toàn khi sử dụng các khóa nhân bản song song.
Quy định này cũng áp dụng cho các
.session, văn bản StringSession và mã khóa xác thực (Auth Key) dưới dạng HEX. Các ứng dụng khách khác có các phiên xác thực được tạo độc lập vẫn có thể duy trì trạng thái đã đăng nhập. Xin tham khảo tài liệu về AUTH_KEY_DUPLICATED của Telegram.
- Đóng hoàn toàn ứng dụng Telegram Desktop.
-
Vui lòng tạo một tệp ZIP chỉ chứa hai mục sau đây từ
tdata:key_datas- tệp gồm 16 ký tự kết thúc bằng
snằm ngay bên cạnh, thường làD877F783D5D3EF8Cs
Việc nén toàn bộ thư mục cùng bộ nhớ đệm phương tiện thường vượt quá giới hạn (512 mục, 32 MiB sau khi giải nén). 3. Chọn tệp ZIP trong phần Tệp. Nếu Telegram Desktop có mã thông báo cục bộ, hãy nhập mã đó vào ô Mã thông báo hoặc văn bản phiên trước tiên. Đây không phải là mật khẩu xác thực hai yếu tố (2FA).
Hỗ trợ: một tài khoản cho mỗi kho lưu trữ, công nghệ lưu trữ hiện đại key_datas/key_data0/key_data1,
mã thông báo cục bộ. Không hỗ trợ: các thư mục chứa nhiều tài khoản đã đăng nhập, các giao diện Desktop
cũ, các tệp ZIP được bảo vệ bằng mật khẩu, và ứng dụng gốc riêng biệt trên macOS có tên “Telegram for macOS”.
Telethon StringSession#
Một dòng văn bản duy nhất, thường bắt đầu bằng 1 và dài khoảng 350 ký tự. Vui lòng tải
tệp này dưới dạng tệp .txt hoặc .tgwitness-session (tối đa 4 KiB), hoặc dán vào phần
Mã thông báo hoặc văn bản phiên làm việc. Chỉ chấp nhận các chuỗi Telethon; các chuỗi Pyrogram và TDLib
sử dụng các định dạng khác.
Khóa xác thực (Auth key) và DC trên cùng một dòng#
Danh sách tài khoản thường chứa thông tin ủy quyền thô dưới dạng <512 hexadecimal characters>:<DC id>,
ví dụ: a1b2…ef:5. Dán dòng đó vào trường Passcode hoặc session text, tải nó dưới dạng
tệp văn bản, hoặc nhập vào trường session trong JSON tài khoản. TgWitness
mapping các DC từ 1 đến 5 với các địa chỉ sản xuất tương ứng như trong quá trình nhập JSON auth_key + dc_id và
báo cáo định dạng dưới dạng Auth key HEX và DC. Bất kỳ số DC hoặc độ dài khóa nào khác đều bị từ chối.
Tệp JSON tài khoản#
Một đối tượng JSON, tối đa 64 KiB, trong một tệp có phần mở rộng là .json.
| Trường (tên gọi khác) | Ý nghĩa |
|---|---|
api_id (app_id) |
ID ứng dụng, một số dương |
api_hash (app_hash) |
Băm ứng dụng, gồm 32 ký tự thập lục phân |
string_session (session_string, session_str; session cũ) |
Văn bản Telethon StringSession, hoặc <512 hexadecimal characters>:<DC id>, không phải là tên tệp |
auth_key (auth_key_hex) + dc_id |
Khóa xác thực (Auth Key) đầy đủ gồm 512 ký tự và DC 1–5 |
user_id (id) |
Tùy chọn; đã được đối chiếu với Telegram trước khi lưu thông tin ủy quyền |
device_model (device) |
Mô tả thiết bị kết nối |
system_version (sdk) |
Phiên bản hệ điều hành kết nối |
app_version |
Phiên bản ứng dụng được gửi đến Telegram |
lang_code, system_lang_code (system_lang_pack), lang_pack |
Ngôn ngữ khách hàng, ngôn ngữ hệ thống và gói ngôn ngữ khách hàng; cho phép giá trị lang_pack trống |
tz_offset |
Chênh lệch múi giờ UTC (tùy chọn) tính bằng giây, được gửi trong trường initConnection.params; chuỗi số nguyên hoặc số thập phân |
Nếu cả tên gọi tắt và tên chính đều có mặt, chúng phải trùng khớp. Các trường phiên Telethon
rõ ràng có ưu tiên cao hơn blob session chung chung ở định dạng khác. Nếu
cả hai đều chứa các phiên Telethon có thể nhận diện được, chúng phải mô tả cùng một quyền truy cập.
Nếu không có trường rõ ràng, session phải là một StringSession hợp lệ của Telethon hoặc khóa xác thực
và DC dưới dạng <512 hexadecimal characters>:<DC id>. Ví dụ:
{ "app_id": 1234567, "app_hash": "0123456789abcdef0123456789abcdef" }
{
"api_id": 1234567,
"api_hash": "0123456789abcdef0123456789abcdef",
"auth_key": "REPLACE_WITH_ALL_512_HEXADECIMAL_CHARACTERS",
"dc_id": 2,
"user_id": 123456789
}
Ví dụ đầu tiên chỉ yêu cầu điền thông tin đăng nhập API; quý vị có thể đăng nhập qua số điện thoại hoặc mã QR, hoặc thêm tệp phiên làm việc. Các danh sách hàng loạt (mảng JSON chứa danh sách tài khoản) sẽ không được chấp nhận.
Xác định những gì quý vị đang có#
| Quý vị có thể thấy | Đây là | Cách sử dụng |
|---|---|---|
*.session; khi mở tệp này trong trình soạn thảo văn bản, phần đầu sẽ hiển thị SQLite format 3 |
Telethon hoặc Pyrogram SQLite | Tệp tin (được phát hiện tự động) |
Một thư mục tdata chứa key_datas |
Telegram Desktop TData | Nén hai tệp thành định dạng ZIP, sau đó là các tệp |
Một dòng văn bản bắt đầu bằng 1, khoảng 350 ký tự |
Telethon StringSession | Tệp tin |
Một dòng văn bản 512 characters 0-9a-f, sau đó là : và một chữ số từ 1 đến 5 |
Khóa xác thực và DC | Tệp, mã PIN hộp hoặc văn bản phiên làm việc |
*.json cùng với app_id/app_hash |
Siêu dữ liệu đi kèm | Các tệp tin, cùng với phiên làm việc tương ứng |
*.json kết hợp với auth_key hoặc string_session |
Tệp JSON tài khoản | Tệp tin |
512 ký tự 0-9a-f |
Khóa xác thực | Khóa xác thực |
32 ký tự 0-9a-f |
Băm API | ID API + Băm |
td.binlog hoặc db.sqlite từ ứng dụng TDLib |
Bộ lưu trữ TDLib | Không được hỗ trợ |
123456789:AA… |
Mã thông báo bot | Không được hỗ trợ |
Các định dạng không được hỗ trợ#
| Định dạng | Lựa chọn thay thế |
|---|---|
Bộ lưu trữ TDLib (td.binlog) và các tệp xuất từ TDLib |
Đăng nhập bằng số điện thoại hoặc mã QR |
| Các chuỗi phiên làm việc của Pyrogram | Vui lòng sử dụng tệp Pyrogram .session, hoặc quét mã QR bằng điện thoại |
| TData với nhiều tài khoản đã đăng nhập | Vui lòng đăng xuất khỏi các tài khoản khác trên Telegram Desktop, hoặc sử dụng tệp phiên làm việc riêng của từng tài khoản |
| Mã thông báo bot | Không được hỗ trợ: TgWitness chỉ thực hiện quan sát với tư cách là một tài khoản người dùng |
| Danh sách CSV/JSON của nhiều tài khoản | Nhập các tệp phiên được hỗ trợ qua Tài khoản → Nhập tài khoản, hoặc đăng nhập bằng số điện thoại/mã QR trong các không gian làm việc riêng biệt |
| Các phiên thử nghiệm (Test-DC) hoặc phiên bot | Vui lòng sử dụng tài khoản người dùng chính thức |
Nhiều tài khoản#
Nhấn vào biểu tượng + bên cạnh trình chọn tài khoản, hoặc mở Công cụ khác → Tài khoản → Cài đặt → Cài đặt kết nối → Không gian làm việc, nhập nhãn và đăng nhập.
- Bất kỳ số lượng không gian làm việc nào, bao gồm cả không gian làm việc chính. Mỗi không gian làm việc đều có phiên làm việc, tuyến đường proxy , nguồn dữ liệu, chính sách ghi lại, sổ nhật ký, khóa ký, điểm kiểm tra và các tùy chọn xuất dữ liệu riêng biệt.
- Việc chuyển đổi không gian làm việc đang hiển thị sẽ không làm tạm dừng các không gian làm việc khác.
- Một sổ ghi chép luôn gắn liền với tài khoản đã tạo ra nó. Việc đăng nhập bằng một tài khoản khác yêu cầu phải có một không gian làm việc riêng, và một tài khoản không thể được gán cho hai không gian làm việc.
- Token bảng điều khiển chính quản lý tất cả các không gian làm việc. Quyền truy cập được cấp có thể giới hạn quyền của người khác đối với các tài khoản và cuộc trò chuyện đã chọn, kèm theo các quyền truy cập riêng biệt và giới hạn phiên làm việc.
- Tài khoản sẽ đổi tên một không gian làm việc và xóa một không gian làm việc đã thêm vào, cùng với phiên làm việc, nhật ký, các nguồn và khóa ký của không gian đó. Không gian làm việc chính không thể bị xóa khỏi bảng điều khiển.
Nhập hàng loạt và nhóm tài khoản#
Sử dụng Accounts → Import accounts để thêm nhiều tài khoản, ghép nối các tệp theo tên gốc và xem kết quả đăng nhập của từng tài khoản. Mỗi tài khoản sẽ có không gian làm việc riêng.
Một nhóm giúp tập hợp các tài khoản có liên quan lại với nhau mà không hợp nhất các phiên, khóa hoặc
bằng chứng của chúng. Mở nhóm trên Tài khoản dẫn đến trang của nó tại /groups/<id>:
- Tài khoản: lộ trình kết nối, thông tin quan sát và tin nhắn cuối cùng của từng thành viên, kèm theo Bắt đầu tất cả và Tạm dừng tất cả.
- Cần chú ý: các tài khoản đã đăng xuất, không khả dụng hoặc gặp vấn đề về kết nối, nhập liệu, nguồn hoặc phương tiện; mỗi tên sẽ dẫn đến thẻ thông tin tương ứng.
- Các cuộc trò chuyện trên nhiều tài khoản hiển thị: các nguồn được chia sẻ, các tài khoản đang theo dõi chúng và các gián đoạn trong khoảng thời gian quan sát không gian làm việc có sẵn (tối đa bảy ngày). Khi xuất với N tài khoản, quá trình xuất kênh hoặc siêu nhóm sẽ được chia đều giữa các tài khoản này và tạo ra một tệp lưu trữ duy nhất.
- Xuất nhóm: một ZIP chứa bản xuất đã được ký của từng tài khoản dưới
accounts/vàmanifest.jsonliệt kê các SHA-256 và dấu vân tay khóa của chúng, được ký bởi không gian làm việc chính trongmanifest.signature.json. Xác minh từng bản lưu trữ tài khoản riêng lẻ bằngpython -m tgwitness.verifyvà dấu vân tay đáng tin cậy của tài khoản đó.
Các thành viên chia sẻ cài đặt chung của nhóm; mỗi tài khoản có thể giữ nguyên các giá trị riêng của mình. Xem phần cài đặt chung, hướng dẫn nhập dữ liệu và quản lý nhóm cùng với bảng điều khiển nhóm MTProxy.
Đăng xuất#
Các công cụ khác → Tài khoản → Đăng xuất khỏi Telegram (với việc quan sát tạm dừng) yêu cầu Telegram kết thúc phiên làm việc, do đó phiên này cũng biến mất khỏi mục Cài đặt → Thiết bị của tài khoản và xóa phiên làm việc khỏi kho lưu trữ không gian làm việc. Nhật ký, nguồn, cài đặt và khóa ký vẫn được giữ lại, và nhật ký ghi lại thao tác đăng xuất. Không gian làm việc vẫn thuộc về tài khoản của nó: chỉ có tài khoản đó mới có thể kết nối lại với nó. Nếu Telegram không phản hồi, phiên vẫn bị xóa tại đây và bảng điều khiển sẽ thông báo điều đó; hãy kết thúc phiên trong Telegram tại Cài đặt → Thiết bị.
Khi Telegram kết thúc phiên làm việc#
Nếu Telegram khóa, đóng băng hoặc đăng xuất tài khoản, hoặc kết thúc phiên làm việc từ một thiết bị khác,
nhật ký sẽ ghi lại nguyên nhân, lỗi của Telegram, tuyến đường và trung tâm dữ liệu. Tình trạng
của tài khoản hiển thị “Tải xuống báo cáo mất tài khoản”: một tệp JSON đã được ký số chứa các bản ghi nhật ký
trong 24 giờ trước khi mất tài khoản, bao gồm các kết nối, tuyến đường, phiên làm việc, thông báo tài khoản và các
khoảng trống trong phạm vi phủ sóng, mỗi mục đều có băm nhật ký và chữ ký riêng. Kiểm tra bằng
python verify.py tgwitness-account-loss.json --fingerprint COLLECTOR_FP; tệp xuất bằng chứng
chứa chuỗi băm hoàn chỉnh. Tài khoản bị đóng băng cũng được phát hiện khi nó kết nối và trong quá trình theo dõi, đồng thời các
hành động gửi và tham gia của tài khoản đó sẽ bị tắt.
Bảo vệ an toàn cho các tệp tài khoản#
- Hãy coi mọi
.session, TData ZIP, StringSession, Auth Key và tệp JSON tài khoản như một mật khẩu. TgWitness lưu trữ thông tin ủy quyền đã nhập vào kho lưu trữ được mã hóa của mình; quý vị có thể xóa các tệp gốc sau đó. - Không được thực hiện cùng một quy trình ủy quyền trên hai chương trình cùng lúc. Telegram có thể thu hồi ủy quyền đó
(
AUTH_KEY_DUPLICATED), và cả hai bản sao sẽ ngừng hoạt động. - Một phiên làm việc đã hết hạn hoặc bị thu hồi không thể được khôi phục thông qua quá trình chuyển đổi. Vui lòng đăng nhập lại.
Khắc phục sự cố#
| Tin nhắn hoặc triệu chứng | Hướng dẫn thực hiện |
|---|---|
| Không thể đọc phiên làm việc này. Vui lòng đóng ứng dụng gốc… | Tệp SQLite hiện đang mở hoặc chưa hoàn tất (tệp phụ -journal/-wal). Vui lòng đóng chương trình gốc một cách đúng quy trình và sao chép lại tệp. |
| Các lược đồ SQLite của Telethon được hỗ trợ: 7 và 8 / Pyrogram … 2 và 3 | Tệp này được tạo ra bởi một phiên bản thư viện rất cũ hoặc không xác định. Vui lòng đăng nhập bằng số điện thoại hoặc mã QR thay thế. |
| Chỉ hỗ trợ các phiên làm việc của người dùng được ủy quyền | Tệp Pyrogram này thuộc về một bot hoặc mạng thử nghiệm. |
| Kho lưu trữ TData đã vượt quá 512 mục hoặc 32 MiB | Chỉ bao gồm các tệp ZIP key_datas và D877F783D5D3EF8Cs, không bao gồm toàn bộ thư mục. |
| Không thể giải mã TData. Vui lòng kiểm tra mật mã cục bộ trên máy tính để bàn | Vui lòng nhập mã mật khẩu cục bộ của Telegram Desktop vào ô “Mật khẩu” hoặc “Văn bản phiên làm việc”. |
| Nhập từng tài khoản TData một | Telegram Desktop hỗ trợ nhiều tài khoản; vui lòng tham khảo phần “Các định dạng không được hỗ trợ”. |
| Các tệp được chọn mô tả các tài khoản hoặc thông tin đăng nhập API khác nhau | Chỉ chọn các tệp tin từ một tài khoản duy nhất. |
| Tệp JSON không chứa thông tin xác thực hoặc ủy quyền API nào được hỗ trợ | Vui lòng kiểm tra các tên trường trong tệp JSON Tài khoản. |
| Chỉ bao gồm siêu dữ liệu API | Tệp JSON không có phiên làm việc. Vui lòng thêm tệp .session hoặc sử dụng số điện thoại/mã QR. |
| Mã khóa xác thực (Auth Key) dưới dạng HEX phải chứa đầy đủ 512 ký tự thập lục phân | Khóa đã bị cắt ngắn hoặc chứa chuỗi ký tự "…". |
| ID tài khoản không khớp với tài khoản đã nhập | ID người dùng trong tệp này khác với thông tin mà Telegram báo cáo; tệp này thuộc về một tài khoản khác. |
| Tài khoản này hiện đã thuộc về một không gian làm việc khác | Vui lòng mở không gian làm việc đó thay vì thêm tài khoản hai lần. |
| Đã kết nối, nhưng thiếu một nhóm riêng tư trong danh sách trò chuyện tại Công cụ khác → Nguồn | Kiểm tra tư cách thành viên. Trình chọn sẽ kiểm tra 1,000 cuộc đối thoại đầu tiên; tăng giới hạn tại mục Công cụ khác → Tham số. |
| Kết nối proxy không thành công | Kiểm tra chế độ định tuyến và IP. Tự động MTProxy sẽ thử một mục nhập khác đang hoạt động. Chế độ ẩn địa chỉ sẽ chờ; chế độ Trực tiếp (Direct) là phương án cuối cùng, có thể kết nối trực tiếp sau thời gian trễ đã cấu hình. Xem các chế độ định tuyến. |
Xem thêm: các vấn đề về kết nối và bảo mật liên quan đến máy chủ proxy và mã hóa, cũng như cách thức thu thập dữ liệu đối với những nội dung được ghi lại sau khi đăng nhập.