Xử lý sự cố
Máy chủ mất kết nối
Xác định worker có còn hoạt động, kiểm tra Hetzner hoặc Windows và tránh tự chuyển phiên giữa các máy.
Triệu chứng
Trang Máy chủ báo máy mất kết nối. Việc của các tài khoản trên máy không tiến triển, đăng nhập chưa có QR hoặc tin mới không đồng bộ về app.
Máy mất kết nối nghĩa là server không còn đủ bằng chứng worker đang sẵn sàng. Nó không tự chứng minh máy đã bị xoá, Telegram đã đăng xuất hay proxy của mọi tài khoản đều hỏng.
Nguyên nhân thường gặp
- Máy Hetzner bị tắt hoặc có vấn đề từ nhà cung cấp.
- Máy Windows ngủ, khởi động lại hoặc mất mạng.
- Worker không còn chạy hoặc không kết nối được về server.
- Cập nhật worker chưa hoàn tất.
- Worker còn sống nhưng quá cũ để nhận loại việc mới.
- Trạng thái hiển thị chưa được đối chiếu với nhà cung cấp.
Một heartbeat chỉ chứng minh máy còn liên lạc. Nó không tự phục hồi phiên Telegram hoặc xoá trạng thái an toàn. Ngược lại, mất heartbeat cũng không tự biến phiên hợp lệ thành phiên đã bị thu hồi.
Cách xử lý
- Mở Máy chủ.
- Xác định đúng máy đang giữ tài khoản bị ảnh hưởng.
- Kiểm tra lần liên lạc gần nhất và phiên bản worker.
- Với Hetzner, kiểm tra máy còn tồn tại và đang bật trong tài khoản Hetzner của bạn.
- Với Windows, kiểm tra máy đang bật, không ngủ và có mạng.
- Kiểm tra worker còn chạy trên máy.
- Kiểm tra kết quả cập nhật hoặc khởi động lại worker.
- Chờ máy báo kết nối lại.
- Kiểm tra một việc đang chờ để xác nhận máy đã nhận việc trở lại.

Không khởi động nhiều bản worker cùng giữ một phiên. Một phiên Telegram chỉ được một worker giữ tại một thời điểm.
Nếu máy vẫn online nhưng không nhận việc, đọc lý do giữ việc. Tài khoản có thể bị chặn bởi proxy, trạng thái an toàn, giờ chạy hoặc yêu cầu phiên bản; khởi động máy lại không xoá những điều kiện đó.
Khi cần chuyển tài khoản
Bạn có thể yêu cầu thay đổi máy qua app, nhưng server quyết định quyền giữ phiên và thời điểm giao việc. Không chép thư mục phiên sang máy mới để tự chuyển.
Đổi máy có thể yêu cầu đăng nhập lại và ảnh hưởng lịch làm ấm. Hãy kiểm tra các tin chưa rõ trước khi tiếp tục công việc trên máy mới.
Nếu vẫn lỗi
Ghi lại mã máy, loại máy, phiên bản worker, thời điểm liên lạc cuối và mã việc chưa được nhận. Với Hetzner, bổ sung trạng thái máy từ bảng điều khiển; với Windows, bổ sung trạng thái tiến trình worker và lỗi mạng đã che bí mật.
Nếu máy kết nối lại nhưng tài khoản vẫn lỗi, chuyển sang kiểm tra proxy hoặc đăng nhập Telegram.
Đọc thêm Máy chạy tài khoản. Agent có thể dùng danh sách hạ tầng, MCP infra_list, để báo tình trạng; không tự xoá hay chuyển máy khi chưa có quyết định phù hợp.